iobridge/v0.1.md

Numbers: Big Endian.
Input strings not null terminated unless explicitly stated.


Outgoing API:
    0x00 - reserved
    0x01 - read line from stdin; returns a 0x01 packet.
    0x02 [len: u32, data: u8[]] - write to stdout
    0x03 [len: u32, data: u8[]] - write to stderr
    0x04 - read a byte from stdin; returns a 0x04 packet.
    0x05 [byte: u8] - write a byte to stdout
    0x06 [byte: u8] - write a byte to stderr
    0x07 [len: u32] - read from stdin. returns a 0x07 packet.

    0x08 [len: u32] - allocate a buffer of len bytes. returns a 0x08 packet.
    0x09 [ptr: u32] - free a buffer allocated at ptr.
    0x0A [ptr: u32, off: u32, len: u32] - read len bytes from ptr + off. returns a 0x0A packet.
    0x0B [ptr: u32, off: u32, len: u32, data: u8[]] - write len bytes to ptr + off.
    0x0C [ptr: u32] - query the size of the buffer allocated at ptr. returns a 0x0C packet.
    0x0D [ptr: u32, new_len: u32] - resize the buffer allocated at ptr to new_len bytes.

    Expect null-terminated data:
    * 0x0E [len: u32, mode: u32, data: u8[]] - open a file (fopen). returns a 0x0E packet.

    0x0F [ptr: u32] - close a file (fclose).
    0x10 [ptr: u32, len: u32] - read len bytes from file. returns a 0x10 packet.
    0x11 [ptr: u32, len: u32] - write len bytes to file.
    0x12 [ptr: u32] - query the size of the file. returns a 0x12 packet.
    0x13 [ptr: u32, off: u32, whence: u8]: seek to off bytes from whence
        (0-backwards,1-forwards,2-from beginning,3-from end).
    
    Expect null-terminated data:
    * 0x14 [len: u32, len2: u32, data1: u8[], data2: u8[]] - rename.
    * 0x15 [len: u32, data: u8[]] - unlink.
    * 0x16 [len: u32, data: u8[]] - mkdir.
    * 0x17 [len: u32, data: u8[]] - rmdir.
    * 0x18 [len: u32, data: u8[]] - chdir.

    0x19 - getcwd, returns a 0x19 packet.

    0x1A - UNIX time, returns a 0x1A packet.
    0x1B - local time, returns a 0x1B packet.
    0x1C - GMT, returns a 0x1C packet.

    0x1D [time: u32] - sleep for n ms.
    0x1E - put terminal in raw mode (if platform supports that).
    0x1F - put terminal in cooked mode (if platform supports that).
    0x20 - get terminal size, returns a 0x20 packet.

    0x21 [ptr: u32] - flush file.
    0x22 - flush stdout.

    0x23 - get errno state. returns a 0x23 packet.

    Expect null-terminated data:
    * 0x24 [len: u32, data: u8[]] - file exists? returns a 0x24 packet.
    * 0x25 [len: u32, data: u8[]] - list directory entries. returns a 0x25 packet.
    
    0x26 - API version. returns a 0x26 packet.
    0x27 - Host environment. returns a 0x27 packet.
Incoming API:
    0x01 [len: u32] [data: u8[]] - line read from stdin.
    0x04 [byte: u16] - byte read from stdin.
    0x07 [len: u32] [data: u8[]] - data read from stdin.
    0x08 [ptr: u32] - buffer allocated at ptr (ptr = 0 if unable to allocate).
    0x0A [len: u32] [data: u8[]] - data read from ptr + off.
    0x0C [len: u32] - size of the buffer allocated at ptr.
    0x0E [ptr: u32] - file opened at ptr (ptr = 0 if unable to open).
    0x10 [len: u32] [data: u8[]] - data read from file.
    0x12 [len: u32] - size of the file.
    0x19 [len: u32] [data: u8[]] - current working directory (len = 0 if unable to determine).
    0x1A [time: u64] - UNIX time.
    0x1B [year: u32, month: u8, day: u8, hour: u8, minute: u8, second: u8] - local time.
    0x1C [year: u32, month: u8, day: u8, hour: u8, minute: u8, second: u8] - GMT.
    0x20 [width: u16, height: u16] - terminal size (or 0 if unknown).
    0x23 [error: u8] - error state.
    0x24 [exists: u8] - exists?
    0x25 [no: u32, (len: u32, path: u8[], size: u32, type: u8)[]] - list directory entries.
    0x26 [major: u8, minor: u8] - API version (0, 1).
    0x27 [len: u32, data: u8[]] - Host environment.