NAME

       q_init, q_free - initialize and free queue

LIBRARY

       Librecast library (liblibrecast, -llibrecast)

SYNOPSIS

       #include <librecast/q.h>

       int q_init(q_t *q);
       int q_free(q_t *q);

       Compile and link with -llibrecast.

DESCRIPTION

       The q_init() function initializes smolq queue q.

       You  will  be  surprised  to  learn  that  q_free()  is  the  corresponding  function  to free a queue so
       initialized.

RETURN VALUE

       These functions return zero on success. On error, -1 is returned and errno is set to indicate the error.

ERRORS

       q_init() may fail when initializing the queue semaphore.  q_free() may fail  when  destroying  the  queue
       semaphore.  See sem_init(3) and sem_destroy(3) for the relevant error codes.

SEE ALSO

       q_job_seek(3), q_pool_create(3), q_pool_destroy(3), q_push(3), q_wait(3), sem_init(3), sem_destroy(3)