NAME

       q_push - push a job onto a smolq queue

LIBRARY

       Librecast library (liblibrecast, -llibrecast)

SYNOPSIS

       #include <librecast/q.h>

       int  q_push(q_t *q, void *(*f)(void *), void *restrict arg);
       int  q_trypush(q_t *q, void *(*f)(void *), void *restrict arg);

       Compile and link with -llibrecast.

DESCRIPTION

       q_push() pushes f onto the queue q with argument arg.

       q_trypush()  is  the  same  as  q_push()  except  that  if the queue writer lock cannot be
       immediately obtained, then the call returns an error (errno  set  to  EAGAIN)  instead  of
       blocking.

RETURN VALUE

       The  q_push()  function returns zero on success. On error, -1 is returned and errno is set
       to indicate the error.

ERRORS

       EAGAIN ( q_trypush()) The operation could not be performed without  blocking.  (i.e.,  the
              queue was full).

       The function can also fail with the errors for sem_post(3) or sem_wait(3).

SEE ALSO

       q_job_seek(3),   q_pool_create(3),  q_pool_destroy(3),  q_init(3),  q_free(3),  q_wait(3),
       sem_post(3), sem_wait(3)