GEARMAN_TASK_NUMERATOR(3) Gearmand GEARMAN_TASK_NUMERATOR(3)NAME
gearman_task_numerator - Gearmand Documentation, http://gearman.info/
SYNOPSIS
#include <libgearman/gearman.h>
gearman_task_st
void gearman_task_free(gearman_task_st *task)
void *gearman_task_context(const gearman_task_st *task)
void gearman_task_set_context(gearman_task_st *task, void *context)
const char *gearman_task_function_name(const gearman_task_st *task)
const char *gearman_task_unique(const gearman_task_st *task)
const char *gearman_task_job_handle(const gearman_task_st *task)
bool gearman_task_is_known(const gearman_task_st *task)
bool gearman_task_is_running(const gearman_task_st *task)
uint32_t gearman_task_numerator(const gearman_task_st *task)
uint32_t gearman_task_denominator(const gearman_task_st *task)
void gearman_task_give_workload(gearman_task_st *task, const
void *workload, size_t workload_size)
size_t gearman_task_send_workload(gearman_task_st *task, const
void *workload, size_t workload_size, gearman_return_t *ret_ptr)
const void *gearman_task_data(const gearman_task_st *task)
size_t gearman_task_data_size(const gearman_task_st *task)
void *gearman_task_take_data(gearman_task_st *task, size_t *data_size)
size_t gearman_task_recv_data(gearman_task_st *task, void *data,
size_t data_size, gearman_return_t *ret_ptr)
const char *gearman_task_error(const gearman_task_st *task)
New in version 0.21.
gearman_return_t gearman_task_return(const gearman_task_st *task)
New in version 0.21.
Link with -lgearman
DESCRIPTION
A gearman_task_st represents a task. Work that is sent by a client to
a gearman server is seen as a task (a worker receives a task in the
form of a job.
Tasks, i.e. gearman_task_st are created by calling either gearman_exe‐
cute(), gearman_client_add_task(), or gearman_client_add_task_back‐
ground().
gearman_client_add_task_status() can also create gearman_task_st, these
tasks will be used to monitor a previously created gearman_task_st.
gearman_task_free() is used to free a task. This only needs to be done
if a task was created with a preallocated structure or if you want to
clean up the memory of a specific task.
gearman_task_set_context() sets the given context of the
gearman_task_st. The context can be used to pass information to a
gearman_task_st.
gearman_task_context() returns the context that was used in the cre‐
ation of the gearman_task_st (or that was set with
gearman_task_set_context().
gearman_task_data() returns the current data that has been returned to
the task. gearman_task_data_size() will give you the size of the value.
gearman_task_take_data() is the same as gearman_task_data() but the
value that is returned must be freed by the client (free(3)).
gearman_task_recv_data() can be used with pre-allocated buffers.
gearman_task_is_known(), gearman_task_is_running(),
gearman_task_numerator(), and gearman_task_denominator(), return values
related to the last status update that was made to the gearman_task_st.
They do not cause the gearman_task_st to update itself.
gearman_task_error() return the last error message that the
gearman_task_st encountered. gearman_task_return() return the last
gearman_return_t stored. A value of GEARMAN_UNKNOWN_STATE means that
the task has not been submitted to server yet, or that no function was
available if the job has been submitted.
RETURN VALUE
Various. Values that are returned by gearman_task_take_data() must have
free(3) called on them.
HOME
To find out more information please check: http://gearman.info/
SEE ALSOgearmand(8)libgearman(3)AUTHOR
Data Differential http://www.datadifferential.com/
COPYRIGHT
2011-2013, Data Differential, http://www.datadifferential.com/
1.0.6 May 09, 2013 GEARMAN_TASK_NUMERATOR(3)