NFG Games + GameSX

User Tools

Site Tools

Trace:
x68000:doscall

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
x68000:doscall [2017/09/10 12:28] – move v2/3 caution text to the top neko68kx68000:doscall [2020/01/26 15:54] (current) – [Detailed Descriptions] sigvec
Line 5: Line 5:
  to $FF80~$FFAF in Version 3 and later  to $FF80~$FFAF in Version 3 and later
  
- Processing address calls at $FFF5~$FFF7 and $FFFA~$FFfE can not be changed(ignored)+ Processing address calls at $FFF5~$FFF7 and $FFFA~$FFFE can not be changed(ignored)
  $FFF8,$FFFF is executed after the original processing is normally completed.  $FFF8,$FFFF is executed after the original processing is normally completed.
  $FFF8 is called every time a thread is deleted.  $FFF8 is called every time a thread is deleted.
Line 13: Line 13:
 |$FF01|[[doscall#GETCHAR|_GETCHAR]]|Get keyboard input (with echo)| |$FF01|[[doscall#GETCHAR|_GETCHAR]]|Get keyboard input (with echo)|
 |$FF02|[[doscall#PUTCHAR|_PUTCHAR]]|Put character| |$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| +|$FF05|[[doscall#prnout|_PRNOUT]]|Printer 1 character output| 
-|$FF06|_INPOUT|Character I/O|+|$FF06|[[doscall#inpout|_INPOUT]]|Character I/O|
 |$FF07|[[doscall#inkey|_INKEY]]|Get one character from the keyboard (no break check)| |$FF07|[[doscall#inkey|_INKEY]]|Get one character from the keyboard (no break check)|
 |$FF08|[[doscall#getc|_GETC]]|Get one character from the keyboard (with break check)| |$FF08|[[doscall#getc|_GETC]]|Get one character from the keyboard (with break check)|
 |$FF09|[[doscall#print|_PRINT]]|Print string| |$FF09|[[doscall#print|_PRINT]]|Print string|
 |$FF0A|[[doscall#gets|_GETS]]|Get character string (with break check)| |$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| |$FF0C|_KFLUSH|Keyboard input after buffer flush|
 |$FF0D|[[doscall#fflush|_FFLUSH]]|Disk reset| |$FF0D|[[doscall#fflush|_FFLUSH]]|Disk reset|
Line 28: Line 28:
  
 ^Code^Name^Description^ ^Code^Name^Description^
-|$FF10|_CONSNS|Screen output check| +|$FF10|[[doscall#consns|_CONSNS]]|Screen output check| 
-|$FF11|_PRNSNS|Printer output check| +|$FF11|[[doscall#prnsns|_PRNSNS]]|Printer output check| 
-|$FF12|_CINSNS|RS-232C input check| +|$FF12|[[doscall#cinsns|_CINSNS]]|RS-232C input check| 
-|$FF13|_COUTSNS|RS-232C output check|+|$FF13|[[doscall#coutsns|_COUTSNS]]|RS-232C output check|
 |$FF17|_FATCHK|File concatenation state check| |$FF17|_FATCHK|File concatenation state check|
 |$FF18|_HENDSP|Kanji conversion control| |$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| |$FF1B|[[doscall#fgetc|_FGETC]]|Get character from file|
 |$FF1C|[[doscall#fgets|_FGETS]]|Get string from file| |$FF1C|[[doscall#fgets|_FGETS]]|Get string from file|
-|$FF1D|_FPUTC|Write one character to file| +|$FF1D|[[doscall#fputc|_FPUTC]]|Write one character to file| 
-|$FF1E|_FPUTS|Write string to file| +|$FF1E|[[doscall#fputs|_FPUTS]]|Write string to file| 
-|$FF1F|_ALLCLOSE|Close all files|+|$FF1F|[[doscall#allclose|_ALLCLOSE]]|Close all files|
  
 ^Code^Name^Description^ ^Code^Name^Description^
-|$FF20|_SUPER|Supervisor/user mode setting|+|$FF20|[[doscall#super|_SUPER]]|Supervisor/user mode setting|
 |$FF21|_FNCKEY|Get/set redefinable key| |$FF21|_FNCKEY|Get/set redefinable key|
 |$FF22|_KNJCTRL|Kana-to-kanji conversion| |$FF22|_KNJCTRL|Kana-to-kanji conversion|
Line 61: Line 61:
  
 ^Code^Name^Description^ ^Code^Name^Description^
-|$FF30|_VERNUM|Get OS version|+|$FF30|[[doscall#vernum|_VERNUM]]|Get OS version|
 |$FF31|_KEEPPR|Terminate and stay resident| |$FF31|_KEEPPR|Terminate and stay resident|
 |$FF32|_GETDPB|Get drive parameter block| |$FF32|_GETDPB|Get drive parameter block|
Line 67: Line 67:
 |$FF34|_DRVXCHG|Replace drive| |$FF34|_DRVXCHG|Replace drive|
 |$FF35|_INTVCG|Get vector processing address| |$FF35|_INTVCG|Get vector processing address|
-|$FF36|_DSKFRE|Get disk space remaining|+|$FF36|[[doscall#dskfre|_DSKFRE]]|Get disk space remaining|
 |$FF37|_NAMECK|Filename expansion| |$FF37|_NAMECK|Filename expansion|
 |$FF39|[[doscall#mkdir|_MKDIR]]|Create subdirectory| |$FF39|[[doscall#mkdir|_MKDIR]]|Create subdirectory|
Line 90: Line 90:
 |$FF4A|[[doscall#setblock|_SETBLOCK]]|Change memory block| |$FF4A|[[doscall#setblock|_SETBLOCK]]|Change memory block|
 |$FF4B|_EXEC|Load/execute program| |$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| |$FF4E|_FILES|Search files|
 |$FF4F|_NFILES|Search next files| |$FF4F|_NFILES|Search next files|
Line 105: Line 105:
 |$FF87|_FILEDATE|Get/set file date| |$FF87|_FILEDATE|Get/set file date|
 |$FF88|_MALLOC2|Alloc memory| |$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| |$FF8C|_LOCK|Lock file|
 |$FF8F|_ASSIGN|Get/set/cancel virtual drive/directory assignment| |$FF8F|_ASSIGN|Get/set/cancel virtual drive/directory assignment|
Line 195: Line 195:
  move CODE,-(sp)  move CODE,-(sp)
  DOS _PUTCHAR  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
 +---
 +^$FF05^<BOOKMARK:prnout>_PRNOUT^Output 1 character to the printer^
 +|Arg|CODE.w|Single-byte character code|
 +|Return|None||
 +|Output one character specified by CODE to the printer (with break check). Because the high-order byte of CODE must be 0, kanji is output by sending two bytes in a row in the order of high byte first, then low byte.|||
 +
 +Usage:
 + move CODE,-(sp)
 + DOS _PRNOUT
 + addq.l #2,sp
 +
 +---
 +^$FF06^<BOOKMARK:INPOUT>_INPOUT^Key input/output^
 +|Arg|CODE.w|Single-byte character code|
 +|Return|CODE=0xFF,0xFE, Input key code (no input if d0.l =0) \\ CODE=other, d0.l=0||
 +|If the CODE value is 0xFF if the key is not pressed it returns 0 immediately. If CODE=0xFE the key is read and the value stays in the buffer. If CODE is any other value it is regarded as a character code and displayed.|||
 +
 +Usage:
 + move CODE,-(sp)
 + DOS _INPOUT
  addq.l #2,sp  addq.l #2,sp
 --- ---
Line 231: Line 267:
  DOS _GETS  DOS _GETS
  addq.l #4,sp  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 288:
  DOS _CHGDRV  DOS _CHGDRV
  addq.l #2,sp  addq.l #2,sp
 +---
 +^$FF10^<BOOKMARK:consns>_CONSNS^Check if screen output is possible^
 +|Arg|none||
 +|Return|Output status (0: output impossible, nonzero: output possible)||
 +|Check if screen output is possible.|||
 +---
 +^$FF11^<BOOKMARK:prnsns>_PRNSNS^Check if printer output is possible^
 +|Arg|none||
 +|Return|Output status (0: output impossible, nonzero: output possible)||
 +|Check if printer output is possible.|||
 +---
 +^$FF12^<BOOKMARK:cinsns>_CINSNS^Check if RS-232C input is possible^
 +|Arg|none||
 +|Return|Output status (0: input impossible, nonzero: input possible)||
 +|Check if RS-232C input is possible.|||
 +---
 +^$FF13^<BOOKMARK:coutsns>_COUTSNS^Check if RS-232C output is possible^
 +|Arg|none||
 +|Return|Output status (0: output impossible, nonzero: output possible)||
 +|Check if RS-232C output is possible.|||
 +---
 +^$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^ ^$FF1B^<BOOKMARK:fgetc>_FGETC^Get one byte from file^
 |Arg|FILENO.w|File handle| |Arg|FILENO.w|File handle|
Line 270: Line 348:
  DOS _FGETS  DOS _FGETS
  addq.l #6,sp  addq.l #6,sp
 +---
 +^$FF1D^<BOOKMARK:fputc>_FPUTC^Output one byte to file handle^
 +|Arg 1|CODE.w|Byte code|
 +|Arg 2|FILENO.w|File handle|
 +|Return|None||
 +|Write 1 byte from CODE to the file specified by FILENO.|||
  
 + move FILENO,-(sp)
 + move CODE,-(sp)
 + 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^
 +|Arg|None||
 +|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^ ^$FF39^<BOOKMARK:mkdir>_MKDIR^Create subdirectory^
Line 376: Line 513:
 ^$FF42^<BOOKMARK:seek>_SEEK^Move file pointer^ ^$FF42^<BOOKMARK:seek>_SEEK^Move file pointer^
 |Arg 1|FILENO.w|File handle| |Arg 1|FILENO.w|File handle|
-|Arg 2|MODE.w|Movement mode|+|Arg 2|OFFSET.l|File offset| 
 +|Arg 3|MODE.w|Movement mode|
 |Return|Offset from the beginning of the file.|| |Return|Offset from the beginning of the file.||
 |The pointer of the file specified by FILENO is moved based on the specified MODE and OFFSET. Attempts to move past the beginning or end of the file results in an error. The character device can't seek and the current position will always return 0. \\ \\ MODE = 0 - Start \\ MODE = 1 - Current position (Negative offsets will move the pointer forward) \\ MODE = 2 - EOF (offset must be less than or equal to 0.)||| |The pointer of the file specified by FILENO is moved based on the specified MODE and OFFSET. Attempts to move past the beginning or end of the file results in an error. The character device can't seek and the current position will always return 0. \\ \\ MODE = 0 - Start \\ MODE = 1 - Current position (Negative offsets will move the pointer forward) \\ MODE = 2 - EOF (offset must be less than or equal to 0.)|||
Line 431: Line 569:
  DOS _SETBLOCK  DOS _SETBLOCK
  addq.l #8,sp  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
 +
x68000/doscall.1505010512.txt.gz · Last modified: 2019/08/27 20:44 (external edit)