|
@@ -0,0 +1,50 @@
|
|
|
+========================
|
|
|
+Issuing a single request
|
|
|
+========================
|
|
|
+
|
|
|
+
|
|
|
+--------
|
|
|
+SYNOPSIS
|
|
|
+--------
|
|
|
+
|
|
|
+#include <libgearman/gearman.h>
|
|
|
+
|
|
|
+.. c:function:: void *gearman_client_do(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) *client);
|
|
|
+
|
|
|
+.. c:function:: 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)
|
|
|
+
|
|
|
+.. c:function:: 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.
|
|
|
+
|
|
|
+All previous tasks created with the gearman_client_st will be released once gearman_client_do() is executed.
|
|
|
+
|
|
|
+
|
|
|
+------
|
|
|
+RETURN
|
|
|
+------
|
|
|
+
|
|
|
+
|
|
|
+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.
|
|
|
+
|
|
|
+
|
|
|
+----
|
|
|
+HOME
|
|
|
+----
|
|
|
+
|
|
|
+
|
|
|
+To find out more information please check:
|
|
|
+`https://launchpad.net/gearmand <https://launchpad.net/gearmand>`_
|
|
|
+
|
|
|
+
|
|
|
+--------
|
|
|
+SEE ALSO
|
|
|
+--------
|
|
|
+
|
|
|
+:manpage:`gearmand(8)` :manpage:`libgearman(3)` :manpage:`gearman_strerror(3)`
|