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
Next revisionBoth sides next revision
x68000:doscall [2017/09/10 09:54] – added _SETBLOCK neko68kx68000:doscall [2017/09/10 15:38] – neko68k
Line 1: Line 1:
 ====== DOS CALL MANUAL ====== ====== DOS CALL MANUAL ======
-===DOS Call list===+===== DOS Call List ===== 
 + 
 +Caution: Calls to $FF00~$FF7F in Human68k Version 2 have been moved 
 + to $FF80~$FFAF in Version 3 and later 
 + 
 + 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 is called every time a thread is deleted.
  
 ^Code^Name^Description^ ^Code^Name^Description^
Line 6: 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|_PRNOUT|Printer 1 character output|
 |$FF06|_INPOUT|Character I/O| |$FF06|_INPOUT|Character I/O|
Line 16: Line 23:
 |$FF0B|_KEYSNS|Key input state check| |$FF0B|_KEYSNS|Key input state check|
 |$FF0C|_KFLUSH|Keyboard input after buffer flush| |$FF0C|_KFLUSH|Keyboard input after buffer flush|
-|$FF0D|_FFLUSH|Disk reset| +|$FF0D|[[doscall#fflush|_FFLUSH]]|Disk reset| 
-|$FF0E|_CHGDRV|Current drive setting|+|$FF0E|[[doscall#chgdrv|_CHGDRV]]|Current drive setting|
 |$FF0F|_DRVCTRL|Drive status check/setting| |$FF0F|_DRVCTRL|Drive status check/setting|
  
Line 27: Line 34:
 |$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|_GETSS|Get character string (no break check)|
-|$FF1B|_FGETC|Get character from file| +|$FF1B|[[doscall#fgetc|_FGETC]]|Get character from file| 
-|$FF1C|_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 54: 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 60: 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 81: Line 88:
 |$FF48|[[doscall#malloc|_MALLOC]]|Allocate memory| |$FF48|[[doscall#malloc|_MALLOC]]|Allocate memory|
 |$FF49|[[doscall#mfree|_MFREE]]|Free memory| |$FF49|[[doscall#mfree|_MFREE]]|Free memory|
-|$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 98: 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|_NEWFILE|Create new file|
 |$FF8C|_LOCK|Lock file| |$FF8C|_LOCK|Lock file|
Line 129: Line 136:
 |$FFFF|_CHANGE_PR|Execution right abandonment(?) 実行権放棄| |$FFFF|_CHANGE_PR|Execution right abandonment(?) 実行権放棄|
  
- Caution: Calls to $FF00~$FF7F in Human68k Version 2 have been moved +==============================================================================
- to $FF80~$FFAF in Version 3 and later+
  
- Processing address calls at $FFF5~$FFF7 and $FFFA~$FFfE can not be changed(ignored) +===== Error code list =====
- $FFF8,$FFFF is executed after the original processing is normally completed. +
- $FFF8 is called every time a thread is deleted. +
- +
-==============================================================================+
  
-===Error code list=== 
 ^Hex code^Byte code^Description^ ^Hex code^Byte code^Description^
 |$FFFFFFFF| -1|Invalid function code executed| |$FFFFFFFF| -1|Invalid function code executed|
Line 147: Line 148:
 |$FFFFFFFA| -6|The specified handle is not open| |$FFFFFFFA| -6|The specified handle is not open|
 |$FFFFFFF9| -7|The memory management area was destroyed| |$FFFFFFF9| -7|The memory management area was destroyed|
-|$FFFFFFF8| -8|実行に必要なメモリがない+|$FFFFFFF8| -8|Not enough memory for execution|
 |$FFFFFFF7| -9|Invalid memory management pointer specified| |$FFFFFFF7| -9|Invalid memory management pointer specified|
 |$FFFFFFF6|-10|Illegal environment specified| |$FFFFFFF6|-10|Illegal environment specified|
Line 175: Line 176:
 |$FFFFFFB0|-80|File exists| |$FFFFFFB0|-80|File exists|
  
-===Detailed Descriptions===+===== Detailed Descriptions ===== 
  
 ^$FF00^<BOOKMARK:EXIT>_EXIT^Terminate program^ ^$FF00^<BOOKMARK:EXIT>_EXIT^Terminate program^
 |End the program. Open file handles are closed.||| |End the program. Open file handles are closed.|||
 +---
 ^$FF01^<BOOKMARK:GETCHAR>_GETCHAR^Wait for keyboard input(with echo)^ ^$FF01^<BOOKMARK:GETCHAR>_GETCHAR^Wait for keyboard input(with echo)^
 |Arg|none| | |Arg|none| |
 |Return|key code|| |Return|key code||
 |Wait for key input and output the character to stdout. \\ %%^%%C - Return to the parent process \\ %%^%%P - Toggle output stdout to the printer also \\ %%^%%N - Check the printer output state||| |Wait for key input and output the character to stdout. \\ %%^%%C - Return to the parent process \\ %%^%%P - Toggle output stdout to the printer also \\ %%^%%N - Check the printer output state|||
 +---
 ^$FF02^<BOOKMARK:PUTCHAR>_PUTCHAR^Display character^ ^$FF02^<BOOKMARK:PUTCHAR>_PUTCHAR^Display character^
 |Arg|CODE.w|Single-byte character| |Arg|CODE.w|Single-byte character|
Line 194: Line 196:
  DOS _PUTCHAR  DOS _PUTCHAR
  addq.l #2,sp  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)^ ^$FF07^<BOOKMARK:inkey>_INKEY^Enter one character from the keyboard (no break check)^
 |Arg|none|| |Arg|none||
 |Return|Key code|| |Return|Key code||
 |Wait until a key is pressed and return the key code.||| |Wait until a key is pressed and return the key code.|||
 +---
 ^$FF08^<BOOKMARK:getc>_GETC^Enter one character from the keyboard (with break check)^ ^$FF08^<BOOKMARK:getc>_GETC^Enter one character from the keyboard (with break check)^
 |Arg|none|| |Arg|none||
 |Return|Key code|| |Return|Key code||
 |Wait until a key is pressed and return the key code. Checks for  %%^%%C, %%^%%S, %%^%%P, or %%^%%N.||| |Wait until a key is pressed and return the key code. Checks for  %%^%%C, %%^%%S, %%^%%P, or %%^%%N.|||
 +---
 ^$FF09^<BOOKMARK:print>_PRINT^Print string^ ^$FF09^<BOOKMARK:print>_PRINT^Print string^
 |Arg|MESPTR.l|Pointer to string| |Arg|MESPTR.l|Pointer to string|
Line 214: Line 232:
  DOS _PRINT  DOS _PRINT
  addq,l #4,sp  addq,l #4,sp
 +---
 ^$FF0A^<BOOKMARK:gets>_GETS^Input string^ ^$FF0A^<BOOKMARK:gets>_GETS^Input string^
 |Arg|BUFFER.l|Input buffer pointer| |Arg|BUFFER.l|Input buffer pointer|
Line 230: Line 248:
  addq.l #4,sp  addq.l #4,sp
  
 +---
 +^$FF0D^<BOOKMARK:fflush>_FFLUSH^Disk reset^
 +|Arg|None||
 +|Return|Always 0||
 +|Initialize the contents of the disk buffer and the line input buffer from standard input. Does not close the file. Do nothing if //fflush=off//|||
 +---
 +^$FF0E^<BOOKMARK:chgdrv>_CHGDRV^Set current drive^
 +|Arg|DRIVE.w|Drive number (0: A 1: B ... 25: Z)|
 +|Return|Number of drives available||
 +|Change the current drive. Fail if the return value is less than the specified drive number.|||
 +
 +Usage:
 + move DRIVE,-(sp)
 + 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.|||
 +
 +---
 +^$FF1B^<BOOKMARK:fgetc>_FGETC^Get one byte from file^
 +|Arg|FILENO.w|File handle|
 +|Return|One byte read from file||
 +|Wait until there is input from the file handle specified by FILENO and return the code if there is input.|||
 +---
 +^$FF1C^<BOOKMARK:fgets>_FGETS^Get string input from file handle^
 +|Arg 1|BUFFER.l|Input buffer pointer|
 +|Arg 2|FILENO.w|File handle|
 +|Return|Number of characters read||
 +|Get a character string from the file handle specified by FILENO up to the line feed and write it to the input buffer specified by BUFFER. Newline characters are replaced with null characters, no break check is done (do not break at VOID/NEWLINE). If it exceeds the maximum number of input characters it terminates early, truncating the string to the maximum number of input characters allowed. The contents of the input buffer are as follows.|||
 +
 +^Offset^Size^Description^
 +|0|1.b|Maximum input characters: n|
 +|1|1.b|Number of actually entered characters|
 +|2|n+1.b|Input string|
 +
 +Usage:
 + move FILENO,-(sp)
 + pea (BUFFER)
 + DOS _FGETS
 + 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^
 |Arg|FILE.l|Pointer to directory name| |Arg|FILE.l|Pointer to directory name|
Line 239: Line 361:
  DOS _MKDIR  DOS _MKDIR
  addq.l #4,sp  addq.l #4,sp
 +---
 ^$FF3A^<BOOKMARK:rmdir>_RMDIR^Delete subdirectory^ ^$FF3A^<BOOKMARK:rmdir>_RMDIR^Delete subdirectory^
 |Arg|FILE.l|Pointer to directory name| |Arg|FILE.l|Pointer to directory name|
Line 249: Line 371:
  DOS _RMDIR  DOS _RMDIR
  addq.l #4,sp  addq.l #4,sp
 +---
 ^$FF3B^<BOOKMARK:chdir>_CHDIR^Change current directory^ ^$FF3B^<BOOKMARK:chdir>_CHDIR^Change current directory^
 |Arg|FILE.l|Pointer to directory name| |Arg|FILE.l|Pointer to directory name|
Line 259: Line 381:
  DOS _RM==CHDIR  DOS _RM==CHDIR
  addq.l #4,sp  addq.l #4,sp
- +---
 ^$FF3C^<BOOKMARK:create>_CREATE^Create file^ ^$FF3C^<BOOKMARK:create>_CREATE^Create file^
 |Arg 1|FILE.l|Pointer to file name| |Arg 1|FILE.l|Pointer to file name|
Line 272: Line 393:
  DOS _CREATE  DOS _CREATE
  addq.l #6,sp  addq.l #6,sp
 +---
 ^$FF3D^<BOOKMARK:open>_OPEN^Open file^ ^$FF3D^<BOOKMARK:open>_OPEN^Open file^
 |Arg 1|FILE.l|Pointer to file name| |Arg 1|FILE.l|Pointer to file name|
Line 284: Line 405:
  DOS _OPEN  DOS _OPEN
  addq.l #6,sp  addq.l #6,sp
 +---
 ^$FF3E^<BOOKMARK:close>_CLOSE^Close file^ ^$FF3E^<BOOKMARK:close>_CLOSE^Close file^
 |Arg|FILENO.w|File handle| |Arg|FILENO.w|File handle|
Line 294: Line 415:
  DOS _CLOSE  DOS _CLOSE
  addq.l #2,sp  addq.l #2,sp
 +---
 ^$FF3F^<BOOKMARK:read>_READ^Read file^ ^$FF3F^<BOOKMARK:read>_READ^Read file^
 |Arg 1|FILENO.w|File handle| |Arg 1|FILENO.w|File handle|
Line 308: Line 429:
  DOS _READ  DOS _READ
  lea (10,sp),sp  lea (10,sp),sp
 +---
 ^$FF40^<BOOKMARK:write>_WRITE^Write file^ ^$FF40^<BOOKMARK:write>_WRITE^Write file^
 |Arg 1|FILENO.w|File handle| |Arg 1|FILENO.w|File handle|
Line 322: Line 443:
  DOS _WRITE  DOS _WRITE
  lea (10,sp),sp  lea (10,sp),sp
 +---
 ^$FF41^<BOOKMARK:delete>_DELETE^Delete file^ ^$FF41^<BOOKMARK:delete>_DELETE^Delete file^
 |Arg|FILE.l|Pointer to file name| |Arg|FILE.l|Pointer to file name|
Line 332: Line 453:
  DOS _DELETE  DOS _DELETE
  addq.l #4,sp  addq.l #4,sp
 +---
 ^$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|
Line 345: Line 466:
  DOS _SEEK  DOS _SEEK
  addq.l #8,sp  addq.l #8,sp
 +---
 ^$FF47^<BOOKMARK:curdir>_CURDIR^Get the current directory^ ^$FF47^<BOOKMARK:curdir>_CURDIR^Get the current directory^
 |Arg 1|DRIVE.w|Drive number (0: current 1: A 2: B ... 26: Z)| |Arg 1|DRIVE.w|Drive number (0: current 1: A 2: B ... 26: Z)|
Line 357: Line 478:
  DOS _CURDIR  DOS _CURDIR
  addq.l #6,sp  addq.l #6,sp
 +---
 ^$FF48^<BOOKMARK:malloc>_MALLOC^Reserve memory^ ^$FF48^<BOOKMARK:malloc>_MALLOC^Reserve memory^
 |Arg|LEN.l|Number of bytes to reserve| |Arg|LEN.l|Number of bytes to reserve|
Line 367: Line 488:
  DOS _MALLOC  DOS _MALLOC
  addq.l #4,sp  addq.l #4,sp
 +---
 ^$FF49^<BOOKMARK:mfree>_MFREE^Release reserved memory^ ^$FF49^<BOOKMARK:mfree>_MFREE^Release reserved memory^
 |Arg|MEMPTR.l|Pointer to memory block| |Arg|MEMPTR.l|Pointer to memory block|
Line 377: Line 498:
  DOS _MFREE  DOS _MFREE
  addq.l #4,sp  addq.l #4,sp
 +---
 ^$FF4A^<BOOKMARK:setblock>_SETBLOCK^Resize memory block^ ^$FF4A^<BOOKMARK:setblock>_SETBLOCK^Resize memory block^
 |Arg 1|MEMPTR.l|Pointer to memory block| |Arg 1|MEMPTR.l|Pointer to memory block|
Line 390: Line 511:
  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
 +
x68000/doscall.txt · Last modified: 2020/01/26 15:54 by sigvec