jsix/definitions/syscalls.def

import "objects/object.def"

import "objects/event.def"
import "objects/mailbox.def"
import "objects/process.def"
import "objects/system.def"
import "objects/thread.def"
import "objects/vma.def"

interface syscalls [syscall] {
    uid 01d9b6a948961097

    expose ref object

    expose ref event
    expose ref mailbox
    expose ref process
    expose ref system
    expose ref thread
    expose ref vma

    # Simple no-op syscall for testing
    function noop

    # Write a message to the kernel log
    function log {
        param area uint8
        param severity uint8
        param message string
    }

    # Get a list of handles owned by this process. If the
    # supplied list is not big enough, will set the size
    # needed in `size` and return j6_err_insufficient
    function handle_list {
        param handles struct handle_descriptor [list inout zero_ok] # A list of handles to be filled
    }

    # Create a clone of an existing handle, possibly with
    # some capabilities masked out.
    function handle_clone {
        param orig ref object [handle cap:clone] # The handle to clone
        param clone ref object [out]             # The new handle
        param mask uint32                        # The capability bitmask
    }

    # Close the handle to an object
    function handle_close {
        param hnd ref object [handle] # The handle to close
    }

    # Block waiting on a futex
    function futex_wait [static] {
        param address uint32*  # Address of the futex value
        param current uint32   # Current value of the futex
        param timeout uint64   # Wait timeout in nanoseconds
    }

    # Wake threads waiting on a futex
    function futex_wake [static] {
        param address uint32*  # Address of the futex value
        param count uint64     # Number of threads to wake, or 0 for all
    }

    # Testing mode only: Have the kernel finish and exit QEMU with the given exit code
    function test_finish [test] {
        param exit_code uint32
    }
}