A2osX/.Docs/KERNEL.md

807 lines
11 KiB
Markdown
Raw Normal View History

2016-10-22 20:52:00 +00:00
*** Auto generated by docgen.cmd ***
2017-03-30 09:03:23 +00:00
# GetArg.A
2017-03-30 09:03:23 +00:00
## In:
+ A = argument index.
## Out:
+ CC : success
+ Y,A = CStr To Arg[A]
2017-03-30 09:03:23 +00:00
+ CS : Out Of Bound
# FileSearch
Search a file in the provided PATH list
And return, if found, the full path to it.
## In:
+ PUSHW = Ptr to Search Path (CSTR) %LIB%;/SYS/SLIB
+ PUSHW = Ptr to File Name (CSTR)
+ PUSHW = Ptr to DstBuf
+ PUSHW = Ptr to DstStat
## Out:
+ CC : success
+ DstBuf = FilePath
+ DstStat = S.STAT
+ CS : not found
# GetDevByID.A
2017-03-30 09:03:23 +00:00
## IN:
+ A = DevID
2017-03-30 09:03:23 +00:00
## OUT:
+ CC = OK, CS = ERROR
+ Y,A = DEVSLOT
+ note: X Unmodified
2017-03-30 09:03:23 +00:00
# GetDevByName.YA
2017-03-30 09:03:23 +00:00
## IN:
+ Y,A = Ptr to device name (C-String)
2017-03-30 09:03:23 +00:00
## OUT:
+ CC = OK, CS = ERROR
+ X = DEVID
+ Y,A = DEVSLOT
2017-03-30 09:03:23 +00:00
# OpenDir.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = PATH (C-String)
2017-03-30 09:03:23 +00:00
## Out:
+ CC : success
+ A = hDIR
+ CS : error
+ A = EC
2017-03-30 09:03:23 +00:00
# ReadDir.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hDIR
2017-03-30 09:03:23 +00:00
## Out:
+ CC : success
+ X = hDIRENT
+ Y,A = PTR to S.DIRENT
+ CS : error
+ A = EC
+ note : A = 0 means no more entry
2017-03-30 09:03:23 +00:00
# CloseDir.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hDIR
2017-03-30 09:03:23 +00:00
## Out:
+ none, always succeed.
2017-03-30 09:03:23 +00:00
# ExpandStr.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = PTR to String to Expand (C-String)
2017-03-30 09:03:23 +00:00
## Out:
+ X = hMem to Expanded String (C-String)
+ Y,A = PTR to Expanded String
2017-03-30 09:03:23 +00:00
# PutEnv.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = PTR to String NAME=VALUE (C-String)
2017-03-30 09:03:23 +00:00
## Out:
# SetEnv
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = PTR To Value (PSTR)
+ PUSHW = PTR To Name (PSTR)
## Out:
2017-03-30 09:03:23 +00:00
# GetEnv.YA
## In:
+ Y,A = PTR to NAME (PSTR)
## Out:
+ CC : Y,A = PTR to VALUE (PSTR)
+ CS : not found
# UnsetEnv.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = PTR To Name (PSTR)
2017-03-30 09:03:23 +00:00
## Out:
2017-03-30 09:03:23 +00:00
# LoadTxtFile.YA
Load TXT a file in memory (with ending 0)
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = File Path
2017-03-30 09:03:23 +00:00
## Out:
+ Y,A = File Length (without ending 0)
+ X = hMem of Loaded File
2017-03-30 09:03:23 +00:00
# LoadFile
Load a file in memory
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = AUXTYPE (Handled by....
+ PUSHB = TYPE ...
+ PUSHB = MODE ...
+ PUSHW = PATH ...FOpen)
2017-03-30 09:03:23 +00:00
## Out:
+ Y,A = File Length
+ X = hMem of Loaded File
# ChTyp
2017-03-30 09:03:23 +00:00
## In:
+ PUSHB = TYPE
+ PUSHW = PATH
2017-03-30 09:03:23 +00:00
# ChMod
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = UID
+ PUSHW = PATH
2017-03-30 09:03:23 +00:00
# ChOwn
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = UID
+ PUSHW = PATH
2017-03-30 09:03:23 +00:00
# ChGrp
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = GID
+ PUSHW = PATH
# FAdd,FSub,FMult,FDiv,FPwr
Return X+Y, X-Y, X*Y, X/Y, X^Y
## In:
+ PUSHW = X (*Float)
+ PUSHW = Y (*Float)
+ Y,A = Dest (*Float)
# Log,Sqr,Exp,Cos,Sin,Tan,ATan
Return Log(x), Sqr(x), E^X, Cos(x), Sin(X), Tan(x), ATan(x)
## In:
+ PUSHW = X (*Float)
+ Y,A = Dest (*Float)
# Float
Return return 'floated' long
## In:
+ PUSHW = X (*long)
+ Y,A = Dest (*float)
# LRIntF
Return Float rounded into a long
## In:
+ PUSHW = X (*Float)
+ Y,A = Dest (*long)
# GetMem
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = Size Requested
+ PUSHB = Options
+ S.MEM.F.INIT0 : init memory with 00
+ S.MEM.F.ALIGN : page aligned
2017-03-30 09:03:23 +00:00
## Out:
2017-03-30 09:03:23 +00:00
+ CC : success
+ YA = PTR to Mem
* X = hMem
+ CS :
2017-03-30 09:03:23 +00:00
+ A = EC
# GetMem0.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = Size Requested
2017-03-30 09:03:23 +00:00
## Out:
+ CC : success
+ YA = PTR to Mem (ZERO Initialised)
* X = hMem
+ CS :
+ A = EC
2017-03-30 09:03:23 +00:00
# GetMem.YA
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = Size Requested
2017-03-30 09:03:23 +00:00
## Out:
+ CC : success
+ YA = PTR to Mem (Uninitialised)
* X = hMem
+ CS :
2017-03-30 09:03:23 +00:00
+ A = EC
# FreeMem.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hMem To Free
2017-03-30 09:03:23 +00:00
## Out:
+ none.
+ (X,Y unmodified)
2017-03-30 09:03:23 +00:00
# GetMemPtr.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hMem
2017-03-30 09:03:23 +00:00
## Out:
+ Y,A = PTR to MemBlock
+ (X unmodified)
2017-03-30 09:03:23 +00:00
# GetMemByID.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hMem
2017-03-30 09:03:23 +00:00
## Out:
+ Y,A = ZPMemMgrSPtr = PTR to S.MEM
+ X unmodified
2017-03-30 09:03:23 +00:00
# NewStr.YA
Create a new copy of this C-String
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = Ptr to source C-String
## Out:
+ CC : success
+ Y,A = PTR to String
+ X = hMem (PSTR)
+ CS : error
+ A = SYS error code
# SListNew
## In:
## Out:
+ A=hMem
# SListAdd
## In:
## Out:
+ A=hMem
# SListGet
## In:
## Out:
+ A=hMem
# SListPut
## In:
## Out:
+ A=hMem
# SListFree
## In:
## Out:
+ A=hMem
# LoadStkObj.YA
## In:
## Out:
+ A=hMem
# GetStkObj.A
## In:
## Out:
+ A=hMem
# FreeStkObj.A
## In:
## Out:
+ A=hMem
# GetMemStat.YA
## In:
+ Y,A = Ptr to 24 bytes buffer
## Out:
+ Buffer filled with memory stats
# ExecPSNewEnv.YA
# ExecPS.YA (Blocking Parent PID)
# CreatePSNewEnv.YA
# CreatePS.YA (Non Blocking)
## In:
+ Y,A = PTR To Cmd Line
## Out:
+ A = Child PSID
# Stat
Return information about a file
## In :
+ PUSHW = PTR to S.STAT buffer
+ PUSHW = PTR to Filename (C-String)
## Out :
# MKDir.YA
## In:
+ Y,A = DIR name
## Out:
+ CC : success
+ CS : error
+ A = EC
# MkNod.YA
return a hFile for a given Device Name
## IN:
+ Y,A=DevName
## OUT:
+ CC = OK, CS = ERROR
+ A = hFILE
# MKFIFO
return a hFILE to a new FIFO
## IN:
2017-03-30 09:03:23 +00:00
## OUT:
+ CC = OK, CS = ERROR
+ A = hFILE
2017-03-30 09:03:23 +00:00
# FPutC.AY
Print A (char) to File
2017-03-30 09:03:23 +00:00
## In:
+ A : char to print
+ Y = hFILE
2017-03-30 09:03:23 +00:00
## Out:
+ CC = success
# PutChar.A
Print A (char) to StdOut
## In:
+ A : char to print
## Out:
+ CC = success
# GetChar
Get char from StdIn
## In:
+ none.
## Out:
+ CC = success
+ A = char
# GetC.A
Get char from File
## In:
+ A = hFILE
2017-03-30 09:03:23 +00:00
## Out:
+ CC = success
+ A = char
# FPutS
Write String to FILE
## In:
+ PUSHW : CPtr
+ PUSHB : hFILE
## Out:
+ CC = success
# PutS.YA
Write String to StdOut
## In:
+ Y,A : CPtr
## Out:
+ CC = success
# FGetS
Read String From FILE
## In:
+ PUSHW : CPtr
+ PUSHB : hFILE
## Out:
+ CC = success
# GetS.YA
Read String From StdIn
## In:
+ Y,A : CPtr
## Out:
+ CC = success
2017-03-30 09:03:23 +00:00
# FOpen
Open a file
## In :
+ PUSHW = AUXTYPE
+ PUSHB = TYPE
+ PUSHB = MODE
+ SYS.FOpen.R : if R and exists -> ERROR
+ SYS.FOpen.W : if W and exists -> CREATE
+ SYS.FOpen.A : Append
+ SYS.FOpen.T : Open/Append in Text mode
+ SYS.FOpen.X : Create if not exists
+ PUSHW = PATH (PSTR)
## Out :
+ CC : A = hFILE
+ CS : A = EC
# FClose.A
2017-03-30 09:03:23 +00:00
Close a file
## In :
+ A = hFILE
## Out :
# FRead.A
2017-03-30 09:03:23 +00:00
Read ONE byte from file
## In :
+ A = hFILE
## Out :
+ A = Byte Read
# FWrite.AY
2017-03-30 09:03:23 +00:00
## In:
+ A = hFILE
+ Y = char
# Out:
+ Y,A = Bytes Written
# FRead
Read bytes from file
## In :
+ PUSHW = Dest Ptr
+ PUSHW = Bytes To Read
+ PUSHB = hFILE
## Out :
+ Y,A = Bytes Read
# FWrite
## In:
+ PUSHW = Src Ptr
+ PUSHW = Bytes To Write
+ PUSHB = hFILE
# Out:
+ Y,A = Bytes Written
# FFlush.A
2017-03-30 09:03:23 +00:00
## In:
+ A = hFILE
# FSeek
Set the file-position indicator for hFILE
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = Ptr to Offset (DWORD)
2017-03-30 09:03:23 +00:00
+ PUSHB = From
+ PUSHB = hFILE
# FEOF.A
Test the end-of-file indicator for hFILE
2017-03-30 09:03:23 +00:00
## In:
+ A = hFILE
## Out:
+ CC :
+ A=0 EOF
+ A =0 NOT EOF
+ CS :
# FTell
Return the current value of the file-position indicator
## In:
+ PUSHW = Ptr to Offset (DWORD)
+ PUSHB = hFILE
## Out:
+ Offset = Offset
# Remove.YA
2017-03-30 09:03:23 +00:00
# Rename
Rename a file
## In :
+ PUSHW = New Name
+ PUSHW = Old Name
## Out :
# SScanF
Scan a PStr (in progress)
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW PTR to target buffer
+ PUSHW PSTR pattern (ex: "%d.%d.%d.%d")
+ %d : byte
+ PUSHW PSTR to scan (ex: "192.168.1.5")
2017-03-30 09:03:23 +00:00
## Out:
# PrintF.YA/SPrintF.YA/FPrintF.YA
Prints C-Style String
2017-03-30 09:03:23 +00:00
## In:
PrintF.YA :
+ Y,A = PTR to CStr
SPrintF.YA :
+ Y,A = PTR to CStr
+ PULLW = Ptr to Dst Buffer
FPrintF.YA :
+ Y,A = PTR to CStr
+ PULLB = hNode
2017-03-30 09:03:23 +00:00
## Out:
+ CC : success
+ CS : error code from Output
Specifiers :
+ %b : pull 1 byte to Print BIN
+ %B : pull 2 bytes to Print BIN
+ %d : pull 1 byte unsigned DEC 0..255
+ %D : pull 2 bytes unsigned DEC 0..65535
+ %u : pull 2 bytes PTR to 4 bytes long unsigned DEC 0..4294967295
+ %e : pull 2 bytes PTR to 5 Bytes float (-)1.23456789e+12
+ %f : pull 2 bytes PTR to 5 Bytes float (-)3.1415
+ %h : pull 1 byte to Print HEX
+ %H : pull 2 bytes to Print HEX
+ %i : pull 1 byte to Print signed DEC -128..127
+ %I : pull 2 bytes to Print signed DEC -32768..32767
+ %L : pull 2 bytes PTR to 4 bytes signed DEC -2147483648..2147483647
+ %n : pull 1 byte to Print low Nibble HEX
+ %N : pull 1 byte to Print high Nibble HEX
+ %s : pull 2 bytes ptr to C-Style String
+ %S : pull 2 bytes ptr to P-Style String
+ \b : Print 'BS' (08)
+ \e : Print 'ESC' ($1B,27)
+ \f : Print 'FF' ($0C,12)
+ \n : Print 'LF' ($0A,10)
+ \r : Print 'CR' ($0D,13)
+ \\\\ : Print \
+ \% : Print %
Modifiers for len and padding :
+ %d : '9' '12'
+ %2d : ' 9' '12'
+ %02d : '09' '12'
+ %11s : 'ABCDEFGH '
+ %011s : 'ABCDEFGH000'
+ %2f : '3.14'
2017-03-30 09:03:23 +00:00
# StrToF
Convert String to 40 bits Float
## In:
+ PUSHW PTR to EndPtr
+ PUSHW Source String (C-Sring)
+ PUSHW PTR to target buffer (5 bytes)
## Out:
+ Target buffer filled with a FLOAT (packed)
# AToF
Convert String to 40 bits Float
## In:
+ PUSHW Source String (C-Sring)
+ PUSHW PTR to target buffer (5 Bytes)
## Out:
# StrToL
Convert String to 32 bits int
2017-03-30 09:03:23 +00:00
## In:
+ PUSHB Base
+ PUSHW PTR to EndPtr
+ PUSHW Source String (C-Sring)
+ PUSHW PTR to target buffer DWORD
2017-03-30 09:03:23 +00:00
## Out:
# StrToUL
Convert String to 32 bits unsigned int
## In:
+ PUSHB Base
+ PUSHW PTR to EndPtr
+ PUSHW Source String (C-Sring)
+ PUSHW PTR to target buffer DWORD
## Out:
# AToL
Convert String to 32 bits int
## In:
+ PUSHW Source String (C-Sring)
+ PUSHW PTR to target buffer DWORD
## Out:
# AToI.YA
Convert String to 16 bits int
## In:
+ Y,A = Source String (C-String)
## Out:
+ Y,A = Int
2017-03-30 09:03:23 +00:00
# RealPath.YA
Return the canonicalized absolute pathname
## In :
+ Y,A = Ptr to Relative Filename (C-String)
## Out :
+ CC : success
+ Y,A = Ptr to Full Path (C-String)
+ X = hMem of Full Path
+ CS : A = Error Code
# StrLen.YA
Returns Length of C-String
2017-03-30 09:03:23 +00:00
## In:
+ Y,A = Ptr to CSTR
2017-03-30 09:03:23 +00:00
## Out:
+ Y,A = String length
2017-03-30 09:03:23 +00:00
# StrCat
Append SRC to DST
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = Ptr to SRC (CSTR)
+ PUSHW = Ptr to DST (CSTR)
2017-03-30 09:03:23 +00:00
## Out:
+ DST = DST+SRC
2017-03-30 09:03:23 +00:00
# StrCpy
Copy string
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = Ptr to SRC (CSTR)
+ PUSHW = Ptr to DST (CSTR)
2017-03-30 09:03:23 +00:00
## Out:
+ DST = SRC
2017-03-30 09:03:23 +00:00
# StrMatch
2017-03-30 09:03:23 +00:00
Compare a String against pattern
## In:
+ PUSHW = PTR to Pattern (e.g. '*test?.txt')
+ PUSHW = PTR to Src String
## Out:
+ CC : match
+ CS : no match
# StrUpr.YA/StrLwr.YA
2017-03-30 09:03:23 +00:00
Convert string to UPPERCASE/lowercase
## In:
+ Y,A = PTR to String (CSTR)
2017-03-30 09:03:23 +00:00
## Out:
+ Uppercased/lowercased String in Buffer
# Time.YA
+ Get System Time in Buffer
## In :
+ Y,A = PTR to S.TIME
## Out :
+ S.TIME filled with System date/time
# PTime2Time
+ Convert ProDOS Time To S.TIME
## In :
+ PUSHW = Dst PTR To S.TIME
+ PUSHW = Src PTR to ProDOS DATE/TIME (DWORD)
# CTime2Time
+ Convert CTIME to S.TIME
## In :
+ PUSHW = Dst PTR To S.TIME
+ PUSHW = Src CTIME DWORD
# StrFTime
Convert S.TIME struct to CSTR
2017-03-30 09:03:23 +00:00
## In:
+ PUSHW = Dst PTR To CSTR Buf
2017-03-30 09:03:23 +00:00
+ PUSHW = Src PTR To Format String
+ %a : Abbreviated weekday name : Thu
+ %A : Full weekday name : Thursday
+ %b : Abbreviated month name : Aug
+ %B : Full month name : August
+ %d : Day of the month, zero-padded (01-31)
+ %H : Hour in 24h format (00-23) 14
+ %I : Hour in 12h format (01-12) 02
+ %m : Month as a decimal number (01-12) 08
+ %M : Minute (00-59) 55
+ %p : AM or PM designation PM
+ %S : Second (00-61) 02
+ %w : Weekday as a decimal number with Sunday as 0 (0-6)
+ %y : Year, last two digits (00-99)
+ %Y : Year four digits 2001
+ PUSHW = Src PTR To S.Time
## Out:
+ none. always succeed.