summaryrefslogtreecommitdiff
path: root/doc/ints.txt
blob: ca4d91f9dff4d8140dae26ecc9b1766228d848bb (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
quit task is int 0x38


yield task is int 0x39
eax is cleared on yield


syscall is int 0x30
system call number in eax
args in ebx, ecx, edx, esi, edi
result in eax
modifies ecx, edx
modifies eax even if no value is returned
see table 1

file system calls have units of bytes unless otherwise specified.
functions returning handles or pointers use 0 to indicate error.
see keys.txt for the return type of the "get key" system call.
the edx register of "start task" is a pointer to a null-terminated string.
  a pointer to a readonly copy of this string is put into the new task's edx.
  the esi register of the new task contains a handle to the caller's task.
  the edi register is copied directly, and is intended to hold a task handle.
    this task handle is who stdio ipc communication should be done with.
ipc operations return 0xffffffff if the specified task doesn't exist.
  "find unread ipc" system call returns 0 if there is no unread ipc.

invalid system call numbers change eax to -1, and have no other effect.


table 1:

 function          | eax  | eax out         | ebx            | ecx            | edx          | esi          | edi
-------------------|------|-----------------|----------------|----------------|--------------|--------------|--------------
 open file         | 0x00 | handle          | drive number   | path           |              |              |
 close file        | 0x01 |                 | handle         |                |              |              |
 file read         | 0x02 | read            | handle         | file offset    | count        | buffer       |
 get file size     | 0x03 | size            | handle         |                |              |              |
 start task        | 0x04 | handle          | drive number   | path           | passed sz    |              | passed dword
 ipc send          | 0x05 | written         | task handle    | max count      | buffer       |              |
 ipc read          | 0x06 | read            | task handle    | max count      | buffer       |              |
 allocate ram      | 0x07 | start pointer   | pages          |                |              |              |
 memory info       | 0x08 | see table 2     | see table 2    |                |              |              |
 wait for task     | 0x09 |                 | handle         |                |              |              |
 enumerate dir     | 0x0a | count           | drive number   | path           | see table 3  | max          |
 system log        | 0x0b |                 | message sz     |                |              |              |
 count of dir      | 0x0c | number of files | drive number   | path           |              |              |
 new window        | 0x0d | window handle   | width          | height         | pixel buffer |              |
 delete window     | 0x0e |                 | window handle  |                |              |              |
 resize window     | 0x0f |                 | window handle  | width          | height       |              |
 reassign pixbuf   | 0x10 |                 | window handle  | pixel buffer   |              |              |
 paint window      | 0x11 |                 | window handle  |                |              |              |
 get win action    | 0x12 |                 | window handle  | action pointer |              |              |
 wait for action   | 0x13 |                 |                |                |              |              |
 wait ipc send     | 0x14 |                 | sending task   |                |              |              |
 wait any ipc send | 0x15 |                 |                |                |              |              |
 find unread ipc   | 0x16 | sending task    |                |                |              |              |
 wait ipc read     | 0x17 |                 | reading task   |                |              |              |
 is task running   | 0x18 | boolean         | task handle    |                |              |              |


table 2:
all values are in units of pages
eax -1 indicates unrecognized ebx

 ebx | eax out
-----|--------------------------
 0x0 | kernel dynamic area size
 0x1 | kernel dynamic area left
 0x2 | total userspace size
 0x3 | total userspace left
 0x4 | this process memory left


table 3:
edx of "enumerate dir" is a pointer to a buffer where an array of "directory info"s can be put.
esi is the maximum number of "directory info"s to be placed in the buffer.
the "directory info" structure is 128 bytes long. The first 100 bytes are a null-terminated string
  indicating the name of the file represented by this entry. The next four bytes are a 32-bit integer
  indicating the size of the file represented in bytes. The next byte's lowest bit is a one if this
  entry is a directory, and a zero if this entry is not. The remainder of the structure is reserved.