Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gearman_client_do_high_background(3) [debian man page]

GEARMAN_CLIENT_DO_HIGH_BACKGROUND(3)				     Gearmand				      GEARMAN_CLIENT_DO_HIGH_BACKGROUND(3)

NAME

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

SYNOPSIS

       #include <libgearman/gearman.h>

       gearman_priority_t

       gearman_return_t  gearman_client_do_background(gearman_client_st *client,  const char *function_name, const char *unique, const void *work-
       load, size_t workload_size, char *job_handle)

       Changed in version 0.21: GEARMAN_PAUSE will no longer be returned. A do operation will now run until it has been submitted.

       gearman_return_t  gearman_client_do_high_background(gearman_client_st *client,  const  char *function_name,   const   char *unique,   const
       void *workload, size_t workload_size, gearman_job_handle_t job_handle)

       gearman_return_t   gearman_client_do_low_background(gearman_client_st *client,	const	char *function_name,   const  char *unique,  const
       void *workload, size_t workload_size, gearman_job_handle_t job_handle)

DESCRIPTION

       gearman_client_do_background() executes a single request to the gearmand server and returns the status via gearman_return_t.

       gearman_client_add_task_high_background() and gearman_client_add_task_low_background()  are  identical  to  gearman_client_do_background(),
       only they set the gearman_priority_t to either high or low.

       If  job_handle  is not NULL, it will be populated with the name of the job_handle for the task created. The job handle needs to be the size
       of GEARMAN_JOB_HANDLE_SIZE. Please see gearman_job_handle_t for more information.

RETURN VALUE

       gearman_return_t

EXAMPLE

       #include <string.h>
       #include <stdlib.h>
       #include <stdio.h>
       #include <libgearman/gearman.h>

       int main(void)
       {
	 gearman_client_st *client= gearman_client_create(NULL);

	 gearman_return_t ret= gearman_client_add_server(client, "localhost", 0);
	 if (gearman_failed(ret))
	 {
	   return EXIT_FAILURE;
	 }

	 gearman_job_handle_t job_handle;
	 gearman_return_t rc= gearman_client_do_background(client,
							   "reverse_function",
							   "unique_value",
							   "my string to reverse", strlen("my string to reverse"),
							   job_handle);

	 if (gearman_success(rc))
	 {
	   // Make use of value
	   printf("%s
", job_handle);
	 }

	 gearman_client_free(client);

	 return 0;
       }

HOME

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

       See also

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

AUTHOR

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

COPYRIGHT

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

0.33								   May 04, 2012 			      GEARMAN_CLIENT_DO_HIGH_BACKGROUND(3)

Check Out this Related Man Page

GEARMAN_CLIENT_DO(3)						     Gearmand						      GEARMAN_CLIENT_DO(3)

NAME

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

SYNOPSIS

       #include <libgearman/gearman.h>

       void  *gearman_client_do(gearman_client_st *client,  const  char *function_name,  const	char *unique,  const  void *workload, size_t work-
       load_size, size_t *result_size, gearman_return_t *ret_ptr)

       Changed in version 0.21: GEARMAN_PAUSE will no longer be returned. A do operation will now run till completion or error.

       void *gearman_client_do_high(gearman_client_st *client, const char *function_name, const char *unique, const  void *workload,  size_t work-
       load_size, size_t *result_size, gearman_return_t *ret_ptr)

       void  *gearman_client_do_low(gearman_client_st *client,	const  char *function_name, const char *unique, const void *workload, size_t work-
       load_size, size_t *result_size, gearman_return_t *ret_ptr)

DESCRIPTION

       gearman_client_do() executes a single request to the gearmand server and waits for a reply.

       gearman_client_do_high() and gearman_client_do_low() are identical to gearman_client_do(), only they set the priority  to  either  high	or
       low.

       All of the functions will block until either a response or an error is returned.

RETURN VALUE

       gearman_client_do() returns a pointer to a value that the caller must release. If ret_ptr is provided any errors that have occurred will be
       stored in it. Since a NULL/zero value is a valid value, you will always need to check ret_ptr if you are concerned with errors.

EXAMPLE

       #include <string.h>
       #include <stdlib.h>
       #include <libgearman/gearman.h>

       int main(void)
       {
	 gearman_client_st *client= gearman_client_create(NULL);

	 gearman_return_t ret= gearman_client_add_server(client, "localhost", 0);
	 if (gearman_failed(ret))
	 {
	   return EXIT_FAILURE;
	 }

	 size_t result_size;
	 gearman_return_t rc;
	 void *value= gearman_client_do(client, "reverse_function", "unique_value",
					"my string to reverse", strlen("my string to reverse"),
					&result_size, &rc);

	 if (gearman_success(rc))
	 {
	   // Make use of value
	 }
	 free(value);

	 gearman_client_free(client);

	 return 0;
       }

HOME

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

       See also

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

AUTHOR

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

COPYRIGHT

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

0.33								   May 04, 2012 					      GEARMAN_CLIENT_DO(3)
Man Page