Syscall table

The syscall number is the SVC immediate; arguments pass in r0–r3 and the result returns in r0, with negative values meaning error (see Syscall ABI for the convention and error codes for the full list). Every kernel object -port, notification, shared-memory region, device, task- is named by a handle, a small per-process slot index; userspace never holds a raw kernel pointer.

This table reflects the Loaf freeze (kernel 1.0) plus compatible 1.x additions such as stamp. The numbers and signatures below are stable: a number is never renumbered or reused, and retired calls leave their slots permanently reserved rather than recycling them.

The table

Task lifecycle (0x00–0x0B)

Number	Name	Signature
`0x00`	`PQuit`	`(status) -> never returns`
`0x01`	`Yield`	`() -> 0`
`0x03`	`Wait`	`(pid, &status, flags) -> pid or -err`
`0x04`	`GetPid`	`() -> pid`
`0x05`	`Sleep`	`(ms) -> 0`
`0x06`	`PSpawn`	`(args*) -> {handle, pid} or -err`
`0x07`	`Kickstart`	`(args*) -> 0 or -err`
`0x08`	`PKill`	`(task_handle) -> 0 or -err`
`0x09`	`TMake`	`(entry, sp, arg) -> tid or -err`
`0x0A`	`TJoin`	`(tid) -> exit_status or -err`
`0x0B`	`TQuit`	`(status) -> never returns`

Messaging (0x10–0x17)

Number	Name	Signature
`0x10`	`MsgSend`	`(port, w1, w2, w3) -> 0 or -err`
`0x11`	`MsgRecv`	`(port, timeout_ms) -> source; r1–r3 payload`
`0x12`	`MsgCall`	`(port, w1, w2, w3) -> r0–r3 reply`
`0x13`	`MsgReply`	`(reply_handle, w1, w2, w3) -> 0 or -err`
`0x14`	`MsgLsend`	`(port, len) -> 0 or -err`
`0x15`	`MsgLcall`	`(port, len) -> {0, recv_len}`
`0x16`	`MsgLreply`	`(reply_handle, len) -> 0 or -err`
`0x17`	`Waitany`	`(handles, count, timeout_ms, result) -> 0 or -err`

Handles & capabilities (0x20–0x27)

Number	Name	Signature
`0x20`	`PortCreate`	`() -> handle or -err`
`0x21`	`NtfnCreate`	`() -> handle or -err`
`0x22`	`DeviceQuery`	`(handle, out*, buf_len) -> irq or -err`
`0x23`	`Grant`	`(handle, pid) -> slot or -err`
`0x24`	`Destroy`	`(handle) -> 0 or -err`
`0x25`	`NtfnSignal`	`(ntfn_handle, bits) -> 0 or -err`
`0x26`	`NtfnWait`	`(ntfn_handle, timeout_ms) -> bits or -err`
`0x27`	`Stamp`	`(handle, marker) -> stamped_handle or -err`
`0x28`	`SetLabel`	`(handle, marker) -> stamped_handle or -err`

Memory (0x30–0x38)

Number	Name	Signature
`0x30`	`MemMap`	`(handle \| HANDLE_ANON, size, prot, flags) -> va or -err`
`0x31`	`MemUnmap`	`(addr) -> 0 or -err`
`0x32`	`ShmemCreate`	`(size) -> handle or -err`
`0x37`	`MemProtect`	`(addr, size, prot) -> 0 or -err`
`0x38`	`AsInject`	`(args*) -> 0 or -err`

Interrupts (0x40–0x42)

Number	Name	Signature
`0x41`	`IrqBind`	`(dev_handle, ntfn_handle) -> 0 or -err`
`0x42`	`IrqDone`	`(dev_handle) -> 0 or -err`