Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GEARMAN_CLIENT_DO_LOW(3)	   Gearmand	      GEARMAN_CLIENT_DO_LOW(3)

NAME
       gearman_client_do_low - Gearmand	Documentation, http://gearman.info/

SYNOPSIS
       #include	<libgearman/gearman.h>

       void  *gearman_client_do(gearman_client_st *client,  const  char	*func-
       tion_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 workload_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 workload_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
	  /*
	  # Gearman server and library
	  # Copyright (C) 2012 Data Differential, http://datadifferential.com/
	  # All	rights reserved.
	  #
	  # Use	and distribution licensed under	the BSD	license.  See
	  # the	COPYING	file in	this directory for full	text.
	  */

	  #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
       2011-2013, Data Differential, http://www.datadifferential.com/

1.1.8				 June 06, 2013	      GEARMAN_CLIENT_DO_LOW(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | HOME | AUTHOR | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gearman_client_do_low&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help