Differences

This shows you the differences between two versions of the page.

--- x68000:doscall [2017/09/10 12:36] – added _FPUTC neko68k
+++ x68000:doscall [2017/09/11 04:08] – added _KEYSNS neko68k
@@ Line 13: / Line 13: @@
 |$FF01|[[doscall#GETCHAR|_GETCHAR]]|Get keyboard input (with echo)|
 |$FF02|[[doscall#PUTCHAR|_PUTCHAR]]|Put character|
-|$FF03|_COMINP|RS-232C 1 byte input|
+|$FF03|[[doscall#cominp|_COMINP]]|RS-232C 1 byte input|
-|$FF04|_COMOUT|RS-232C 1 byte output|
+|$FF04|[[doscall#comout|_COMOUT]]|RS-232C 1 byte output|
 |$FF05|_PRNOUT|Printer 1 character output|
 |$FF06|_INPOUT|Character I/O|
@@ Line 21: / Line 21: @@
 |$FF09|[[doscall#print|_PRINT]]|Print string|
 |$FF0A|[[doscall#gets|_GETS]]|Get character string (with break check)|
-|$FF0B|_KEYSNS|Key input state check|
+|$FF0B|[[doscall#keysns|_KEYSNS]]|Key input state check|
 |$FF0C|_KFLUSH|Keyboard input after buffer flush|
 |$FF0D|[[doscall#fflush|_FFLUSH]]|Disk reset|
@@ Line 34: / Line 34: @@
 |$FF17|_FATCHK|File concatenation state check|
 |$FF18|_HENDSP|Kanji conversion control|
-|$FF19|_CURDRV|Get current drive|
+|$FF19|[[[doscall#curdrv|_CURDRV]]|Get current drive|
-|$FF1A|_GETSS|Get character string (no break check)|
+|$FF1A|[[doscall#getss|_GETSS]]|Get character string (no break check)|
 |$FF1B|[[doscall#fgetc|_FGETC]]|Get character from file|
 |$FF1C|[[doscall#fgets|_FGETS]]|Get string from file|
@@ Line 43: / Line 43: @@
 ^Code^Name^Description^
-|$FF20|_SUPER|Supervisor/user mode setting|
+|$FF20|[[doscall#super|_SUPER]]|Supervisor/user mode setting|
 |$FF21|_FNCKEY|Get/set redefinable key|
 |$FF22|_KNJCTRL|Kana-to-kanji conversion|
@@ Line 61: / Line 61: @@
 ^Code^Name^Description^
-|$FF30|_VERNUM|Get OS version|
+|$FF30|[[doscall#vernum|_VERNUM]]|Get OS version|
 |$FF31|_KEEPPR|Terminate and stay resident|
 |$FF32|_GETDPB|Get drive parameter block|
@@ Line 67: / Line 67: @@
 |$FF34|_DRVXCHG|Replace drive|
 |$FF35|_INTVCG|Get vector processing address|
-|$FF36|_DSKFRE|Get disk space remaining|
+|$FF36|[[doscall#dskfre|_DSKFRE]]|Get disk space remaining|
 |$FF37|_NAMECK|Filename expansion|
 |$FF39|[[doscall#mkdir|_MKDIR]]|Create subdirectory|
@@ Line 90: / Line 90: @@
 |$FF4A|[[doscall#setblock|_SETBLOCK]]|Change memory block|
 |$FF4B|_EXEC|Load/execute program|
-|$FF4C|_EXIT2|Exit with return code|
+|$FF4C|[[doscall#exit2|_EXIT2]]|Exit with return code|
-|$FF4D|_WAIT|Get process end return code|
+|$FF4D|[[doscall#wait|_WAIT]]|Get process end return code|
 |$FF4E|_FILES|Search files|
 |$FF4F|_NFILES|Search next files|
@@ Line 105: / Line 105: @@
 |$FF87|_FILEDATE|Get/set file date|
 |$FF88|_MALLOC2|Alloc memory|
-|$FF8A|_MAKETMP|Create temporary file|
+|$FF8A|[[doscall#maketmp|_MAKETMP]]|Create temporary file|
-|$FF8B|_NEWFILE|Create new file|
+|$FF8B|[[doscall#newfile|_NEWFILE]]|Create new file|
 |$FF8C|_LOCK|Lock file|
 |$FF8F|_ASSIGN|Get/set/cancel virtual drive/directory assignment|
@@ Line 196: / Line 196: @@
 	DOS	_PUTCHAR
 	addq.l	#2,sp
+---
+^$FF03^<BOOKMARK:cominp>_COMINP^Get 1 byte from RS-232C port^
+|Arg|None||
+|Return|1 byte received||
+|Receive 1 byte from the RS-232C port (with break check)|||
+---
+^$FF04^<BOOKMARK:comout>_COMOUT^Send 1 byte to the RS-232C port^
+|Arg|CODE.w|Byte code|
+|Return|None||
+|Send 1 byte to the RS-232C port (with break check)|||
+Usage:
+	move	CODE,-(sp)
+	DOS	_COMOUT
+	addq.l	#2,sp
 ---
 ^$FF07^<BOOKMARK:inkey>_INKEY^Enter one character from the keyboard (no break check)^
@@ Line 231: / Line 247: @@
 	DOS	_GETS
 	addq.l	#4,sp
+---
+^$FF0B^<BOOKMARK:keysns>_KEYSNS^Check key input state^
+|Arg|None||
+|Return|Input state (0: no input, -1: input)||
+|Examine the key input state. Checks for %%^%%C, %%^%%S, %%^%%P, or %%^%%N. |||
 ---
@@ Line 247: / Line 268: @@
 	DOS	_CHGDRV
 	addq.l	#2,sp
+---
+^$FF19^<BOOKMARK:curdrv>_CURDRV^Get the current drive^
+|Arg|None||
+|Return|Number of the current drive (0: A 1: B ... 25: Z)||
+|Get the current drive number.|||
 ---
+^$FF1A^<BOOKMARK:getss>_GETSS^Input string (no break check)^
+|Arg|BUFFER.l|Input buffer pointer|
+|Return|Writes the input character string up to the line feed to the input buffer specified by BUFFER. Newline characters are replaced with NULL characters. Does not perform break check(do not break at VOID/NEWLINE) If the length exceeds the maximum number of input characters allowed a warning is issued but execution does not stop. The contents of the input buffer are as follows.||
+|Get the current drive number.|||
+^Offset^Size^Desciption^
+|0|1.b|Maximum input characters allowed: n|
+|1|1.b|Number of characters actually entered|
+|2|n+1.b|Input string|
+---
 ^$FF1B^<BOOKMARK:fgetc>_FGETC^Get one byte from file^
 |Arg|FILENO.w|File handle|
@@ Line 281: / Line 319: @@
 	DOS	_FPUTC
 	addq.l	#4,sp
+---
+^$FF1E^<BOOKMARK:fputc>_FPUTS^Output string to file handle^
+|Arg 1|MESPTR.l|Pointer to string|
+|Arg 2|FILENO.w|File handle|
+|Return|None||
+|Write the string pointed to by MESPTR to the file specified in FILENO. Does not output the NULL character at the end of the string.|||
+Usage:
+	move	FILENO,-(sp)
+	pea	(MESPTR)
+	DOS	_FPUTS
+	addq.l	#6,sp
 ---
 ^$FF1F^<BOOKMARK:allclose>_ALLCLOSE^Close all files^
@@ Line 287: / Line 336: @@
 |Return|None||
 |Close all open files|||
+---
+^$FF20^<BOOKMARK:super>_SUPER^Supervisor/User mode switching^
+|Arg|STACK.l|Switching mode (0 or address set in SSP)|
+|Return|STACK=0 Value of the previous SSP (error code if negative) \\ Switch the supervisor/user mode according to the value of STACK \\ \\ STACK=other Set STACK to SSP and switch to user mode.||
+|Close all open files|||
+Usage:
+	pea	(STACK)
+	DOS	_SUPER
+	addq.l	#4,sp
+---
+^$FF30^<BOOKMARK:vernum>_VERNUM^OS version check^
+|Arg|None||
+|Return|Version number||
+|Check the verion number of Human68k \\ \\ bit 31~24 '6' (0x36) \\ bit 23~16 '8' (0x38) \\ 15~8 integer part of version number \\ bit 7~0 Decimal part of version number.|||
+---
+^$FF36^<BOOKMARK:dskfre>_DSKFRE^Get the available space on the disk^
+|Arg|DRIVE.w|Drive number|
+|Return|Number of free bytes (2GB maximum, error code if negative)||
+|Get the remaining free space of the drive specified by DRIVE and write it to the following 8 bytes to BUFFER.|||
+^Offset^Size^Description^
+|0|1.w|Number of free clusters|
+|2|1.w|Total number of clusters|
+|4|1.w|Number of sectors per cluster|
+|6|1.w|Number of bytes per sector|
+Usage:
+	pea	(BUFFER)
+	move	DRIVE,-(sp)
+	DOS	_DSKFRE
+	addq.l	#6,sp
 ---
 ^$FF39^<BOOKMARK:mkdir>_MKDIR^Create subdirectory^
@@ Line 447: / Line 528: @@
 	DOS	_SETBLOCK
 	addq.l	#8,sp
+---
+^$FF4C^<BOOKMARK:exit2>_EXIT2^Exit with return code^
+|Arg|CODE.w|Exit code|
+|Return|None||
+|Quit the program with the exit code specified by CODE. The opened file handles are closed.|||
+---
+^$FF4D^<BOOKMARK:wait>_WAIT^Get process exit code^
+|Arg|None||
+|Return|Exit code||
+|Examine the exit code of the executed process. It is the same as the return value of //DOS _EXEC(MODE=0,4)//|||
+---
+^$FF8A^<BOOKMARK:maketmp>_MAKETMP^Create temporary file^
+|Arg 1|FILE.l|Pointer to file name|
+|Arg 2|ATR.w|File attribute (%XLAD_VSHR)|
+|Return|The file handle of the created file. If negative, an error occured.||
+|Create a temporary file specified by FILE with attributes ATR. The file name can contain '?', it is replaced by a number when created. It increments until it becomes a file name that does not exist then creates it. Note that the file name specified by FILE can be rewritten by this DOS call.|||
+Usage:
+	move	ATR,-(sp)
+	pea	(FILE)
+	DOS	_MAKETMP
+	addq.l	#6,sp
+---
+^$FF8B^<BOOKMARK:newfile>_NEWFILE^Create new file^
+|Arg 1|FILE.l|Pointer to file name|
+|Arg 2|ATR.w|File attribute (%XLAD_VSHR)|
+|Return|The file handle of the created file. If negative, an error occured.||
+|Create a temporary file specified by FILE with attributes ATR. If ATR is 0 it is equivalent to the //archive// attribute. If the file already exists it returns an error (-80).|||
+Usage:
+	move	ATR,-(sp)
+	pea	(FILE)
+	DOS	_MAKETMP
+	addq.l	#6,sp