Daku v1.0.0-alpha.1

Daku is a system interface API similar to WASI with different goals.

Since it's currently alpha, things may change but changes are somewhat unlikely. Alpha, beta and pre-release stages will not last very long (once there is an implementation it will be fully stabilized).

Goals

API

The daku api exports a single function ar():

wat (import "daku" "ar" (func $event (param $cmd_size i32) ;; List[Command].size (param $cmd_data i32) ;; List[Command].reference (param $ready_size i32) ;; List[Uint32].capacity (param $ready_data i32) ;; List[Uint32].reference (modified) (result i32) ;; List[Uint32].size ))

The function queues a number of asynchronous tasks, passed as a list (first two parameters). When any asynchronous task completes, the function returns with the number of tasks that completed and overwrites the ready list.

Command

```rust

[repr(C, packed)]

struct Command { /// Which portal to use portal: u32, /// Ready index for when command completes ready: u32, /// Command ID command: u32, /// Data buffer to memory-map data: *mut (), } ```

See portals for portal command APIs.

Types

Timestamp

```rust

[repr(transparent)]

struct Timestamp { /// The number of TAI microseconds since Jan 1 00:00:00.000000, year 0 in /// ISO 8601:2004 /// /// This gives about a range of ±292470 years since year 0. /// /// This differs from Unix time in 3 ways: /// - Epoch is 0000-01-01T00:00:00.000000 TAI instead of /// 1970-01-01T00:00:00.000000 UTC /// - Precision is microseconds instead of seconds /// - TAI not UTC, meaning that a leap second gets representation, rather /// than being represented as repeat of previous second as it would be in /// unix time. micros: i64, } ```

Time

```rust

[repr(C, packed)]

struct Time { /// Range: 0 ~ 23 (always UTC, localized only for display) hour: u8, /// Range: 0 ~ 59 minute: u8, /// Range: 0 ~ 60_999 (can represent leap seconds) millis: u16, } ```

Date

```rust

[repr(C, packed)]

struct Date { /// Range: 0 ~ 65_535 year: u16, /// Range: 1 ~ 12 month: u8, /// Range: (of week: 1 ~ 7) << 5 | (of month: 1 ~ 31) day: u8, } ```

DateTime

```rust

[repr(C, packed)]

struct DateTime { date: Date, time: Time, } ```

List

```rust

[repr(C, packed)]

struct List { size: u32, data: *mut T, } ```

Text

```rust

[repr(C, packed)]

struct Text { /// Number of bytes size: u32, /// UTF-8 String data: *mut u8, } ```

TimeZone

```rust

[repr(C, u32)]

enum TimeDesignation { Utc = 0, }

[repr(C, packed)]

struct TimeAdjustment { /// Time to replace when: DateTime, /// New time new: DateTime, }

[repr(C, packed)]

struct LeapSecond { /// Which year year: i16, /// Always the last day of the month month: u8, /// Direction: Either -1 or +1 delta: i8, }

[repr(C, packed)]

struct TimeZone { /// Name of TimeZone (abbreviated, null terminated unless size 6) designation: TimeDesignation, /// List of adjustments made in this timezone deltas: List, /// Replace UTC jan 1 00:00:00:000 year 0 with Local time adjustments /// /// This must be equivalent to all of the adjustments in deltas plus /// any daylight savings time modifications. offset: DateTime, /// List of leap seconds leapseconds: List, /// Sum of leap seconds leap: i16, /// Is daylight savings time? isdst: bool, /// Reserved for future use reserved: u8, } ```

Lang

```rust

[repr(C, u32)]

enum Language { /// English United States EnUS = u32::fromnebytes(b"enUS"), /// English Great Britain EnGB = u32::from_ne_bytes(b"enGB"), /// Esperanto EoXX = u32::fromnebytes(*b"eoXX"), }

[repr(C, packed)]

struct Lang { /// List of languages in order of user preference (0 is most preferred) list: List, } ```