gearman_client_add_task_background3
Gearmand documentation, https://gearman.org/gearmand/
Usage
#include <libgearman/gearman.h>
- gearman_task_st *gearman_client_add_task_background(gearman_client_st *client, gearman_task_st *task, void *context, const char *function_name, const char *unique, const void *workload, size_t workload_size, gearman_return_t *ret_ptr)
- gearman_task_st *gearman_client_add_task_high_background(gearman_client_st *client, gearman_task_st *task, void *context, const char *function_name, const char *unique, const void *workload, size_t workload_size, gearman_return_t *ret_ptr)
- gearman_task_st *gearman_client_add_task_low_background(gearman_client_st *client, gearman_task_st *task, void *context, const char *function_name, const char *unique, const void *workload, size_t workload_size, gearman_return_t *ret_ptr)
Link with -lgearman
Overview
gearman_client_add_task_background() creates a background task and adds it ito the given gearman_client_st. Execution of the task does not begin until gearman_client_run_tasks() is called.
If the unique value is not set, then a unique will be assigned.
gearman_client_add_task_high_background() and gearman_client_add_task_low_background() are identical to gearman_client_do(), only they set the priority to either high or low.
Job assignment priority is global across registered functions. A high priority job for any function is assigned before normal or low priority jobs for other functions.
WARNING:
You may wish to avoid using gearman_client_add_task_background() with a stack based allocated gearman_task_st. The most common issues related to ABI safety involve stack allocated structures. If you use a stack based gearman_task_st you must free it with gearman_task_free().
Return value
The gearman_task_st is created and a pointer to it is returned. On error NULL is returned and ret_ptr is set with a gearman_return_t.
Home
To find out more information please check: https://gearman.org/gearmand/
SEE ALSO:
gearmand(8) libgearman(3) gearman_task_st
Releases
9 releases since Debian 6.0 (Squeeze); the text changed 7 times.