carta
gearman_client_do_low_background(3)

gearman_client_do_low_background3

Gearmand documentation, https://gearman.org/gearmand/

Overview

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.

Job assignment priority is global across registered functions. A high priority job for any function is assigned before normal or low priority jobs for other functions.

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

Examples

/*
# 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: https://gearman.org/gearmand/

SEE ALSO:

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch) to Debian 8 (Jessie)
  • Debian 7 (Wheezy)
  • Debian 6.0 (Squeeze)

Author

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

From gearmand 2.2.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.