Proc.h

Abstractions for process control.

License: GPL-3.0-or-later.

cbuild_proclist_t

typedef struct cbuild_proclist_t {
cbuild_proc_t* data;
size_t size;
size_t capacity;
} cbuild_proclist_t;

Dynamic array of processes.

cbuild_proclist_append

#define cbuild_proclist_append(proclist, proc)

Append new element to list of processes.

cbuild_proclist_t* proclist Dynamic array object.
cbuild_proc_t proc Process handle.

cbuild_proclist_clear

#define cbuild_proclist_clear(proclist)

Clears list of processes.

cbuild_proclist_t* proclist Dynamic array object.

cbuild_proclist_set

#define cbuild_proclist_set(proclist, idx, proc)

Set element in process list using its index.

cbuild_proclist_t* proclist List of processes.
size_t idx Element index.
cbuild_proc_t proc New element’s value.

bool False on overflow.

cbuild_proclist_get

#define cbuild_proclist_get(proclist, idx)

Get element from process list using its index.

cbuild_proclist_t* proclist List of processes.
size_t idx Slement index.

cbuild_proc_t* Pointer to an element or NULL on overflow.

cbuild_proc_wait

CBUILDDEF bool cbuild_proc_wait(cbuild_proc_t proc);

Blocking wait until specific process finishes.

bool false if process returned with an error.

cbuild_procs_wait

CBUILDDEF bool cbuild_procs_wait(cbuild_proclist_t procs);

Blocking wait until all processes from list exits.

bool false if at least one process returned with an error.

cbuild_proc_wait_code

CBUILDDEF int cbuild_proc_wait_code(cbuild_proc_t proc);

Blocking wait until specific process finishes.

int Process exit code or INT_MIN if proccbuild_proc_t is invalid or INT_MAX on ECHILD or negative signal value if process exited due to a signal.

cbuild_procs_wait_any

CBUILDDEF ssize_t cbuild_procs_wait_any(cbuild_proclist_t procs, int* code);

Blocking wait until any process from list exits.

cbuild_proclist_t procs List of processess.
int* code Return value for exit code of exited process, Could be NULL.

ssize_t Index of exited process in procscbuild_proclist_t array.

cbuild_proc_is_running

CBUILDDEF bool cbuild_proc_is_running(cbuild_proc_t proc);

Check if specific process is still running.

cbuild_proc_func_t

typedef int (*cbuild_proc_func_t)(void* args);

Function that can be used a child process entry point.

void* args Arguments passed from parent process.

int Exit code of a process.

cbuild_proc_start

CBUILDDEF cbuild_proc_t cbuild_proc_start(cbuild_proc_func_t func, void* args);

Start a new process.

cbuild_proc_func_t func Function that will be used as process’ entry point. Function should return exit code.
void* args Arguments that will be passed to that function

cbuild_proc_t Process handle of new process.

cbuild_proc_ptr_t

typedef struct cbuild_proc_ptr_t {
void*  ptr;
size_t size;
} cbuild_proc_ptr_t;

Pointer wrapper for shared memory.

void* ptr Pointer to a memory.
size_t size Length of memory region in bytes.

cbuild_proc_malloc

CBUILDDEF cbuild_proc_ptr_t cbuild_proc_malloc(size_t n);

Allocate memory that will be shared between child processes. Same as malloc.

cbuild_proc_free

CBUILDDEF void cbuild_proc_free(cbuild_proc_ptr_t ptr);

Free memory that was allocated via cbuild_proc_malloc. Same asfree.

cbuild_nproc

CBUILDDEF int cbuild_nproc(void);

Get amount of CPU cores (or threads).