NAME

       gearman_job_take_workload - Gearmand Documentation, http://gearman.info/

SYNOPSIS

       #include <libgearman/gearman.h>

       gearman_job_st

       void gearman_job_free(gearman_job_st *job)

       gearman_return_t      gearman_job_send_data(gearman_job_st *job,     const     void *data,
       size_t data_size)

       gearman_return_t   gearman_job_send_warning(gearman_job_st *job,   const    void *warning,
       size_t warning_size)

       gearman_return_t      gearman_job_send_status(gearman_job_st *job,     uint32_t numerator,
       uint32_t denominator)

       gearman_return_t   gearman_job_send_complete(gearman_job_st *job,   const    void *result,
       size_t result_size)

       gearman_return_t  gearman_job_send_exception(gearman_job_st *job,  const  void *exception,
       size_t exception_size)

       gearman_return_t gearman_job_send_fail(gearman_job_st *job)

       const char *gearman_job_handle(const gearman_job_st *job)

       const char *gearman_job_function_name(const gearman_job_st *job)

       const char *gearman_job_unique(const gearman_job_st *job)

       const void *gearman_job_workload(const gearman_job_st *job)

       size_t gearman_job_workload_size(const gearman_job_st *job)

       void *gearman_job_take_workload(gearman_job_st *job, size_t *data_size)

       gearman_job_st  *gearman_worker_grab_job(gearman_worker_st *worker,   gearman_job_st *job,
       gearman_return_t *ret_ptr)

       Link with -lgearman

DESCRIPTION

       gearman_job_st  are  passed  to  worker  functions to represent jobs that are being run by
       gearman_worker_work().

       gearman_job_free() is used to free a job. This only needs to be done if a task was created
       with a preallocated structure.

       gearman_job_handle()   returns   the   job   handle(see   gearman_job_handle_t   for  more
       information).

       gearman_job_function_name() return the name of the  function  that  the  job  was  set  to
       execute against.

       gearman_job_unique() return the unique value that was used for gearman_job_st.

       returns   the   gearman_job_st   workload.   The   size  of  it  can  be  determined  with
       gearman_job_workload_size().     gearman_job_take_workload()    is     the     same     as
       gearman_job_workload() with the exception that the result must be free(3) by the caller.

       gearman_worker_grab_job()   Takes   a  job  from  one  of  the  job  servers.  It  is  the
       responsibility of the caller to free the job once they are done. This interface is used in
       testing, and is very rarely the correct interface to program against.

RETURN VALUE

       A   value   of   gearman_return_t    is   returned.    On   success  that  value  will  be
       :c:type::GEARMAN_SUCCESS.  Use gearman_strerror() to translate this value to  a  printable
       string.

HOME

       To find out more information please check: http://gearman.info/

SEE ALSO

       gearmand(8) libgearman(3)

AUTHOR

       Data Differential http://www.datadifferential.com/

COPYRIGHT

       2011-2013, Data Differential, http://www.datadifferential.com/