init

Sets up a mutex. It is recursive: the thread that holds it can lock it again, and has to unlock it as many times.

• desired_name: a label for the mutex. Only kept in builds with DEBUG set.
• desired_order: a rank for the mutex. Only kept in builds with DEBUG set; nothing acts on it yet. -1 for none.

init :: (m: *Mutex, desired_name := "", desired_order: Mutex_Order = -1)

init :: (cv: *Condition_Variable, desired_name := "")

init :: (s: *Semaphore, initial_value: s32 = 0)

init :: (m: *Mutex, desired_name := "", desired_order: Mutex_Order = -1)

mutex: Mutex;
init(*mutex);
defer destroy(*mutex);
lock(*mutex);
lock(*mutex); // the same thread may lock again
unlock(*mutex);
unlock(*mutex);

init :: (cv: *Condition_Variable, desired_name := "")

ready: Condition_Variable;
init(*ready);
defer destroy(*ready);

init :: (s: *Semaphore, initial_value: s32 = 0)

semaphore: Semaphore;
init(*semaphore, 1);
defer destroy(*semaphore);
assert(wait_for(*semaphore, 0) == .SUCCESS);
assert(wait_for(*semaphore, 0) == .TIMEOUT);

init :: (
    group: *Thread_Group,
    num_threads: s32,
    group_proc: Thread_Group_Proc,
    enable_work_stealing := false,
    temporary_storage_size: s32 = 16384,
    group_name := ""
)