Differences

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

--- x68000:doscall [2017/09/10 13:13] – added usage for DSKFRE neko68k
+++ x68000:doscall [2017/09/10 15:51] – added _NEWFILE 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 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 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 298: / Line 314: @@
 	DOS	_FPUTS
 	addq.l	#6,sp
 ---
 ^$FF1F^<BOOKMARK:allclose>_ALLCLOSE^Close all files^
@@ Line 304: / Line 319: @@
 |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^
@@ Line 493: / Line 523: @@
 |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