WebSVN – Kolibri OS – Diff – /kernel/trunk/docs/sysfuncs.txt

     * 4 = 1.44Mb, 3.5''
     * 5 = 2.88Mb, 3.5'' (such drives are not used anymore)
     For example, for the standard configuration from one 1.44-drive
     here will be 40h, and for the case 1.2Mb on A: and 1.44Mb on B:
     the value is 24h.
   First IDE controller:
   * +1: byte: information about hard disks and CD-drives, AABBCCDD,
     where AA corresponds to the controller IDE0, ..., DD - IDE3:
     * 0 = device not found
     * 1 = hard drive
     * 2 = CD-drive
     For example, in the case HD on IDE0 and CD on IDE2
     this field contains 48h.
   * +2: 4 db: number of the retrieved partitions on hard disks
     at accordingly IDE0,...,IDE3.
   Second IDE controller:
   * +6: byte: information about hard disks and CD-drives, AABBCCDD,
     where AA corresponds to the controller IDE4, ..., DD - IDE7:
     * 0 = device not found
     * 1 = hard drive
     * 1 = hard drive
     * 2 = CD-drive
     For example, in the case HD on IDE8 and CD on IDE10
     this field contains 48h.
   * +12: 4 db: number of the retrieved partitions on hard disks
     at accordingly IDE8,...,IDE11.
     If the hard disk on IDEx is absent, appropriate byte is zero,
     otherwise it shows number of the recognized partitions, which
     can be not presented (if the drive is not formatted or if
     the file system is not supported). Current version of the kernel
     supports only FAT12/16/32, NTFS, ext2/3/4 and XFS for hard disks.
 Returned value:
   * eax = number of 1/100s of second, past from the system boot time
 Remarks:
   * Counter takes modulo 2^32, that correspond to a little more
     than 497 days.
   * To get system time use function 3.
 ---------------------- Constants for registers: ----------------------
   eax - SF_SYSTEM_GET (26)
   ebx - SSF_TIME_COUNT (9)
 Parameters:
   * eax = 26 - function number
   * ebx = 10 - subfunction number
 Returned value:
   * eax = number of nanoseconds since system boot time (lower DWORD)
   * edx = number of nanoseconds since system boot time (high DWORD)
 Remarks:
   * The counter is based on HPET, if HPET is not available, resolution
     will be reduced to 10 000 000 nanoseconds.
   * eсx = slot number
 Returned value:
   * eax = if successful - pointer to a memory with data
   * eax = 1 - error
   * eax = -1 - main list area not found
 ---------------------- Constants for registers: ----------------------
   eax - SF_CLIPBOARD (54)
   ebx - SSF_READ_CB (1)
 ======================================================================
 ==================== Function 54, subfunction 2 ======================
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
 Remarks:
   Optstruct:
     dd level
     dd optionname
     dd optlength
 Returned value:
   * eax = -1 on error
   * ebx = errorcode
 Remarks:
   Optstruct:
     dd level
     dd optionname
     dd optlength
   * bh = device number
   * bl = subfunction number
 Ethernet (0)
 - Read MAC
 IPv4 (1)
 - Read # IP packets sent
 - Read # IP packets received
 - Read IP
 - Write DNS
 - Read subnet
 - Write subnet
 - Read gateway
 - Write gateway
 ICMP (2)
 - Read # ICMP packets sent
 - Read # ICMP packets received
 - enable/disable ICMP echo reply
 - Read # UDP packets sent
 - Read # UDP packets received
 TCP (4)
 - Read # TCP packets sent
 - Read # TCP packets received
 ARP (5)
 - Read # ARP packets sent
 - Read # ARP packets received
 - Read # ARP entry's
 - Read ARP entry
 - Add static ARP entry
 - Remove ARP entry (-1 = remove all)
 - Send ARP announce on specified interface
 - Read # ARP conflicts (IP address conflicts)
+---------------------- Constants for registers: ----------------------
+  eax - SF_NETWORK_PROTOCOL (76)
+======================================================================
+========== Function 77, Subfunction 0, Create futex object ===========
+======================================================================
+Parameters:
+  * eax = 77 - function number
+  * ebx = 0 - subfunction number
+  * ecx = pointer to futex dword
+Returned value:
+  * eax = futex handle, 0 on error
+Remarks:
+  * Use subfunction 1 to destroy the futex.
+    The kernel destroys the futexes automatically when the process
+    terminates.
+======================================================================
+========= Function 77, Subfunction 1, Destroy futex object ===========
+======================================================================
+Parameters:
+  * eax = 77 - function number
+  * ebx = 1 - subfunction number
+  * ecx = futex handle
+Returned value:
+  * eax = 0 - successfull, -1 on error
+Remarks:
+  * The futex handle must have been created by subfunction 0
+======================================================================
+=============== Function 77, Subfunction 2, Futex wait ===============
+======================================================================
+Parameters:
+  * eax = 77 - function number
+  * ebx = 2 - subfunction number
+  * ecx = futex handle
+  * edx = control value
+  * esi = timeout in system ticks or 0 for infinity
+Returned value:
+  * eax = 0 - successfull, -1 on timeout
+Remarks:
+  * This functionn tests that the value at the futex dword still
+    contains the expected control value, and if so, then sleeps
+    waiting for a wake operation on the futex.
+  * The futex handle must have been created by subfunction 0
+======================================================================
+=============== Function 77, Subfunction 3, Futex wake ===============
+======================================================================
+Parameters:
+  * eax = 77 - function number
+  * ebx = 3 - subfunction number
+  * ecx = futex handle
+  * edx = number of waiters to wake
+Returned value:
+  * eax = number of waiters that were woken up
+Remarks:
+  * This function wakes at most edx of the waiters that are
+    waiting (e.g., inside futex wait) on the futex dword
----------------------- Constants for registers: ----------------------
+  * The futex handle must have been created by subfunction 0
   eax - SF_NETWORK_PROTOCOL (76)
 ======================================================================
 =============== Function -1 - terminate thread/process ===============
 ======================================================================

Subversion Repositories Kolibri OS

(root)/kernel/trunk/docs/sysfuncs.txt @ 6057 – Rev 6057 → 6079