GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  LIBGEARMAN (3)

NAME

libgearman - Gearmand Documentation, http://gearman.info/ \$1 \n[an-margin] level \n[rst2man-indent-level] level margin: \n[rst2man-indent\n[rst2man-indent-level]] - \n[rst2man-indent0] \n[rst2man-indent1] \n[rst2man-indent2]

CONTENTS

Synopsis
Description
Constants
Threads And Processes
Home
See Also
Author
Copyright

SYNOPSIS

#include <libgearman/gearman.h>

Link -lgearman

DESCRIPTION

libgearman is a small, thread-safe client library for the gearman protocol. The code has all been written with an eye to allow for both web and embedded usage. It handles the work behind routing particular keys to specific servers that you specify (and values are matched based on server order as supplied by you). It implements both the client and worker interfaces.

All operations are performed against either a client, ie gearman_client_st or worker, ie gearman_worker_st.

Client and Worker structures can either be dynamically allocated or statically allocated. They must then b initialized by gearman_client_create() or gearman_worker_create().

Functions have been written in order to encapsulate all structures in the library. It is recommended that you do not operate directly against the structure.

Nearly all functions return a gearman_return_t value. This value can be translated to a printable string with gearman_strerror().

gearman_client_st and gearman_worker_st structures are thread-safe, but each thread must contain its own structure (that is, if you want to share these among threads you must provide your own locking). No global variables are used in this library.

If you are working with GNU autotools you will want to add the following to your configure.ac to properly include libgearman in your application.

PKG_CHECK_MODULES(DEPS, libgearman >= 0.8.0) AC_SUBST(DEPS_CFLAGS) AC_SUBST(DEPS_LIBS)

Hope you enjoy it!

CONSTANTS

A number of constants have been provided for in the library.
GEARMAN_DEFAULT_TCP_PORT
 

The default port used by gearmand(3).
GEARMAN_DEFAULT_TCP_PORT
 

The default service used by gearmand(3).
LIBGEARMAN_VERSION_STRING
 

String value of the libgearman version such as "0.20.4"
LIBGEARMAN_VERSION_HEX
 

Hex value of the version number. "0x00048000" This can be used for comparing versions based on number.
GEARMAN_UNIQUE_SIZE
 

Largest number of characters that can be used for a unique value.
GEARMAN_JOB_HANDLE_SIZE
 

Largest number of characters that can will be used for a job handle. Please see gearman_job_handle_t for additional information.

THREADS AND PROCESSES

When using threads or forked processes it is important to keep an instance of gearman_client_st or gearman_worker_st per process or thread. Without creating your own locking structures you can not share a single gearman_client_st or gearman_worker_st.

HOME

To find out more information please check:  https://launchpad.net/libgearman <https://launchpad.net/gearmand>

SEE ALSO

gearmand(8) libgearman_examples(3)

AUTHOR

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

COPYRIGHT

2011-2013, Data Differential, http://www.datadifferential.com/
Search for    or go to Top of page |  Section 3 |  Main Index


1.1.8 LIBGEARMAN (3) June 06, 2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.