gearman_client_clone(3) [debian man page]

GEARMAN_CLIENT_CLONE(3) 					     Gearmand						   GEARMAN_CLIENT_CLONE(3)

NAME

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

SYNOPSIS

       #include <libgearman/gearman.h>

       gearman_client_st *gearman_client_create(gearman_client_st *client)

       gearman_client_st *gearman_client_clone(gearman_client_st *client, const gearman_client_st *from)

       void gearman_client_free(gearman_client_st *client)

       Link with -lgearman

DESCRIPTION

       gearman_client_create() is used to create a c:type:gearman_client_st  structure that will then be used by other libgearman client functions
       to communicate with the server. You should either pass a statically declared gearman_client_st  to gearman_client_create() or a NULL. If  a
       NULL passed in then a structure is allocated for you.

       gearman_client_clone()  is  similar  to	gearman_client_create()  but  it  copies  the  defaults  and list of servers from the source gear-
       man_client_st . If you pass a null as the argument for the source to clone, it is the same as a call to gearman_client_create.  If the des-
       tination argument is NULL a gearman_client_st  will be allocated for you.

       To clean up memory associated with a gearman_client_st  structure you should pass it to gearman_client_free when you are finished using it.
       gearman_client_free() is the only way to make sure all memory is deallocated when you finish using the structure.

       Warning
	      You may wish to avoid using gearman_client_create() or gearman_client_clone() with a stack based allocation, ie the first parameter.
	      The most common issues related to ABI safety involve stack allocated structures.

RETURN VALUE

       gearman_client_create  returns  a  pointer to the gearman_client_st that was created (or initialized). On an allocation failure, it returns
       NULL.

       gearman_client_clone returns a pointer to the gearman_client_st that was created (or initialized). On an  allocation  failure,  it  returns
       NULL.

HOME

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

       See also

	      gearmand(8) libgearman(3) gearman_strerror(3) gearman_client_st(3)

AUTHOR

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

COPYRIGHT

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

0.33								   May 04, 2012 					   GEARMAN_CLIENT_CLONE(3)

GEARMAN_CLIENT_DO_JOB_HANDLE(3) 				     Gearmand					   GEARMAN_CLIENT_DO_JOB_HANDLE(3)

NAME

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

SYNOPSIS

       #include <libgearman/gearman.h>

       gearman_client_st

       gearman_task_context_free_fn

       int gearman_client_timeout(gearman_client_st *client)

       void gearman_client_set_timeout(gearman_client_st *client, int timeout)

       void *gearman_client_context(const gearman_client_st *client)

       void gearman_client_set_context(gearman_client_st *client, void *context)

       void gearman_client_set_workload_malloc_fn(gearman_client_st *client, gearman_malloc_fn *function, void *context)

       Deprecated since version 0.23: Use gearman_allocator_t

       void gearman_client_set_workload_free_fn(gearman_client_st *client, gearman_free_fn *function, void *context)

       Deprecated since version 0.23: Use gearman_allocator_t

       void gearman_client_task_free_all(gearman_client_st *client)

       void gearman_client_set_task_context_free_fn(gearman_client_st *client, gearman_task_context_free_fn *function)

       Link with -lgearman

DESCRIPTION

       gearman_client_st is used for client communication with the server.

       gearman_client_context() and gearman_client_set_context() can be used to store an arbitrary object for the user.

       gearman_client_set_task_context_free_fn() sets a trigger that will be called when a gearman_task_st is released.

       gearman_client_timeout() and gearman_client_set_timeout() get and set the current timeout value, in milliseconds, for the client.

       Normally   malloc(3)   and   free(3)   are  used  for  allocation  and  releasing  workloads.  gearman_client_set_workload_malloc_fn()  and
       gearman_client_set_workload_free_fn() can be used to replace these with custom functions. (These have been  deprecated,	please	see  gear-
       man_allocator_t for the updated interface.

       gearman_client_task_free_all() is used to free all current gearman_task_st that have been created with the gearman_client_st.

       Warning
	      By  calling  gearman_client_task_free_all()  you can end up with a SEGFAULT if you try to use any gearman_task_st that you have kept
	      pointers too.

RETURN VALUE

       gearman_client_timeout() returns an integer representing the amount of time in milliseconds. A value of -1 means an infinite timeout value.
       See poll(3) for more details.

HOME

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

       See also

	      gearmand(8) libgearman(3) gearman_client_create(3)

AUTHOR

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

COPYRIGHT

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

0.33								   May 04, 2012 				   GEARMAN_CLIENT_DO_JOB_HANDLE(3)