DragonFly On-Line Manual Pages

GEARMAN_CLIENT_DO_HIGH_BACKGROUND(3)                                  Gearmand

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 *workload,
       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

          /*
          # 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 <stdio.h>
          #include <libgearman-1.0/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\n", 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
       2011-2013, Data Differential, http://www.datadifferential.com/

1.0.6                             May 9, 2013
                                          GEARMAN_CLIENT_DO_HIGH_BACKGROUND(3)