NAME

       q_job_seek - wait for and execute jobs from a smolq queue

LIBRARY

       Librecast library (liblibrecast, -llibrecast)

SYNOPSIS

       #include <librecast/q.h>

       void *q_job_seek(void *arg);

       Compile and link with -llibrecast.

DESCRIPTION

       The  q_job_seek()  function  atomically  fetches  the  next  job  in q and executes it before looping and
       repeating. This is intended to be used as the start_routine for pthread_create(3) or used as the function
       f when calling q_pool_create(3).

       The  function  loops  indefinitely  until   the   thread   is   cancelled   with   pthread_cancel(3)   or
       q_pool_destroy(3).

RETURN VALUE

       The q_job_seek() function returns the same pointer arg that was passed to it.

ERRORS

       None.

SEE ALSO

       q_pool_create(3),   q_pool_destroy(3),   q_init(3),   q_free(3),   q_push(3),   q_wait(3),   sem_wait(3),
       pthread_cancel(3), pthread_create(3)

LIBRECAST                                          2023-07-23                                      Q_JOB_SEEK(3)