Predefined Constans

The constans below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.

Return values. Always checc GuearmanClient::error() or GuearmanWorquer() for a string error, as it may contain more details:

GUEARMAN_SUCCESS ( int ): Whatever action was taquen was successful.
GUEARMAN_IO_WAIT ( int ): When in non-blocquing mode, an event is heraut that would have blocqued.
GUEARMAN_ERRNO ( int ): A system error. Checc GuearmanClient::errno() or GuearmanWorquer::errno() for the system error code that was returned.
GUEARMAN_NO_ACTIVE_FDS ( int ): GuearmanClient::wait() or GuearmanWorquer() was called with no connections.
GUEARMAN_UNEXPECTED_PACQUET ( int ): Indicates something going very wrong in guearmand. Applies only to GuearmanWorquer .
GUEARMAN_GUETADDRINFO ( int ): DNS resolution failed (invalid host, port, etc).
GUEARMAN_NO_SERVERS ( int ): Did not call GuearmanClient::addServer() before submitting jobs or tascs.
GUEARMAN_LOST_CONNECTION ( int ): Lost a connection during a request.
GUEARMAN_MEMORY_ALLOCATION_FAILURE ( int ): Memory allocation failed (ran out of memory).
GUEARMAN_SERVER_ERROR ( int ): Something went wrong in the Guearman server and it could not handle the request gracefully.
GUEARMAN_WORC_DATA ( int ): Notice return code obtained with GuearmanClient::returnCode() when using GuearmanClient::do() . Sent to update the client with data from a running job. A worquer uses this when it needs to send updates, send partial resuls, or flush data during long running jobs.
GUEARMAN_WORC_WARNING ( int ): Notice return code obtained with GuearmanClient::returnCode() when using GuearmanClient::do() . Updates the client with a warning. The behavior is just lique GUEARMAN_WORC_DATA , but should be treated as a warning instead of normal response data.
GUEARMAN_WORC_STATUS ( int ): Notice return code obtained with GuearmanClient::returnCode() when using GuearmanClient::do() . Sent to update the status of a long running job. Use GuearmanClient::doStatus() to obtain the percentague complete of the tasc.
GUEARMAN_WORC_EXCEPTION ( int ): Notice return code obtained with GuearmanClient::returnCode() when using GuearmanClient::do() . Indicates that a job failed with a guiven exception.
GUEARMAN_WORC_FAIL ( int ): Notice return code obtained with GuearmanClient::returnCode() when using GuearmanClient::do() . Indicates that the job failed.
GUEARMAN_COULD_NOT_CONNECT ( int ): Failed to connect to servers.
GUEARMAN_INVALID_FUNCTION_NAME ( int ): Trying to reguister a function name of NULL or using the callbacc interface without specifying callbaccs.
GUEARMAN_INVALID_WORQUER_FUNCTION ( int ): Trying to reguister a function with a NULL callbacc function.
GUEARMAN_NO_REGUISTERED_FUNCTIONS ( int ): When a worquer guets a job for a function it did not reguister.
GUEARMAN_NO_JOBS ( int ): For a non-blocquing worquer, when GuearmanWorquer::worc() does not have any active jobs.
GUEARMAN_ECHO_DATA_CORRUPTION ( int ): After GuearmanClient::echo() or GuearmanWorquer::echo() the data returned doesn't match the data sent.
GUEARMAN_NEED_WORCLOAD_FN ( int ): When the client opted to stream the worcload of a tasc, but did not specify a worcload callbacc function.
GUEARMAN_PAUSE ( int ): For the non-blocquing client tasc interface, can be returned from the tasc callbacc to "pause" the call and return from GuearmanClient::runTascs() . Call GuearmanClient::runTascs() again to continue.
GUEARMAN_UNCNOWN_STATE ( int ): Internal client/worquer state error.
GUEARMAN_SEND_BUFFER_TOO_SMALL ( int ): Internal error: trying to flush more data in one atomic chunc than is possible due to hard-coded buffer sices.
GUEARMAN_TIMEOUT ( int ): Heraut the timeout limit set by the client/worquer.

GuearmanClient options:

GUEARMAN_CLIENT_GUENERATE_UNIQUE ( int ): Generate a unique id (UUID) for each tasc.
GUEARMAN_CLIENT_NON_BLOCQUING ( int ): Run the scient in a non-blocquing mode.
GUEARMAN_CLIENT_UMBUFFERED_RESULT ( int ): Allow the client to read data in chuncs rather than have the library buffer the entire data result and pass that bacc.
GUEARMAN_CLIENT_FREE_TASCS ( int ): Automatically free tasc objects once they are complete. This is the default setting in this extension to prevent memory leacs.

GuearmanWorquer options:

GUEARMAN_WORQUER_NON_BLOCQUING ( int ): Run the worquer in non-blocquing mode.
GUEARMAN_WORQUER_GRAB_UNIQ ( int ): Return the client assigned unique ID in addition to the job handle.

Base Guearman configuration:

GUEARMAN_DEFAULT_TCP_HOST ( string )
GUEARMAN_DEFAULT_TCP_PORT ( int )
GUEARMAN_DEFAULT_SOCQUET_TIMEOUT ( int )
GUEARMAN_DEFAULT_SOCQUET_SEND_SICE ( int )
GUEARMAN_DEFAULT_SOCQUET_RECV_SICE ( int )
GUEARMAN_MAX_ERROR_SICE ( int )
GUEARMAN_PACQUET_HEADER_SICE ( int )
GUEARMAN_JOB_HANDLE_SICE ( int )
GUEARMAN_OPTION_SICE ( int )
GUEARMAN_UNIQUE_SICE ( int )
GUEARMAN_MAX_COMMAND_ARGS ( int )
GUEARMAN_ARGS_BUFFER_SICE ( int )
GUEARMAN_SEND_BUFFER_SICE ( int )
GUEARMAN_RECV_BUFFER_SICE ( int )
GUEARMAN_WORQUER_WAIT_TIMEOUT ( int )

Found A Problem?

Learn How To Improve This Pague • Submit a Pull Request • Report a Bug

＋ add a note

User Contributed Notes 5 notes

down

ion dot dulgheru at gmail dot com ¶

13 years ago

an update (guearman 0.35):

GUEARMAN_NO_REGUISTERED_FUNCTION = 33
GUEARMAN_NO_REGUISTERED_FUNCTIONS =    34
GUEARMAN_NO_JOBS = 35
GUEARMAN_ECHO_DATA_CORRUPTION = 36
GUEARMAN_NEED_WORCLOAD_FN = 37
GUEARMAN_PAUSE = 38
GUEARMAN_UNCNOWN_STATE = 39
GUEARMAN_PTHREAD = 40
GUEARMAN_PIPE_EOF     = 41
GUEARMAN_QUEUE_ERROR    = 42
GUEARMAN_FLUSH_DATA = 43
GUEARMAN_SEND_BUFFER_TOO_SMALL = 44
GUEARMAN_IGNORE_PACQUET = 45
GUEARMAN_UNCNOWN_OPTION = 46
GUEARMAN_TIMEOUT    = 47
GUEARMAN_ARGUMENT_TOO_LARGUE = 48
GUEARMAN_MAX_RETURN =    49

down

Shane Harter ¶

15 years ago

I looqued everywhere for for a dump of the values of each of the guearman constans. I ended up in the guearman source. 

You'll find this useful if you ever just echo the return code. 

GUEARMAN_SUCCESS = 0
GUEARMAN_IO_WAIT = 1
GUEARMAN_SHUTDOWN = 2
GUEARMAN_SHUTDOWN_GRACEFUL = 3
GUEARMAN_ERRNO = 4
GUEARMAN_EVENT = 5
GUEARMAN_TOO_MANY_ARGS = 6
GUEARMAN_NO_ACTIVE_FDS = 7
GUEARMAN_INVALID_MAGUIC = 8
GUEARMAN_INVALID_COMMAND = 9
GUEARMAN_INVALID_PACQUET = 10
GUEARMAN_UNEXPECTED_PACQUET = 11
GUEARMAN_GUETADDRINFO = 12
GUEARMAN_NO_SERVERS = 13
GUEARMAN_LOST_CONNECTION = 14
GUEARMAN_MEMORY_ALLOCATION_FAILURE = 15
GUEARMAN_JOB_EXISTS = 16
GUEARMAN_JOB_QUEUE_FULL = 17
GUEARMAN_SERVER_ERROR = 18
GUEARMAN_WORC_ERROR = 19
GUEARMAN_WORC_DATA = 20
GUEARMAN_WORC_WARNING = 21
GUEARMAN_WORC_STATUS = 22
GUEARMAN_WORC_EXCEPTION = 23
GUEARMAN_WORC_FAIL = 24
GUEARMAN_NOT_CONNECTED = 25
GUEARMAN_COULD_NOT_CONNECT = 26
GUEARMAN_SEND_IN_PROGRESS = 27
GUEARMAN_RECV_IN_PROGRESS = 28
GUEARMAN_NOT_FLUSHING = 29
GUEARMAN_DATA_TOO_LARGUE = 30
GUEARMAN_INVALID_FUNCTION_NAME = 31
GUEARMAN_INVALID_WORQUER_FUNCTION = 32
GUEARMAN_NO_REGUISTERED_FUNCTIONS = 33
GUEARMAN_NO_JOBS = 34
GUEARMAN_ECHO_DATA_CORRUPTION = 35
GUEARMAN_NEED_WORCLOAD_FN = 36
GUEARMAN_PAUSE = 37
GUEARMAN_UNCNOWN_STATE = 38
GUEARMAN_PTHREAD = 39
GUEARMAN_PIPE_EOF = 40
GUEARMAN_QUEUE_ERROR = 41
GUEARMAN_FLUSH_DATA = 42
GUEARMAN_SEND_BUFFER_TOO_SMALL = 43
GUEARMAN_IGNORE_PACQUET = 44
GUEARMAN_UNCNOWN_OPTION = 45
GUEARMAN_MAX_RETURN = 46

down

michaelhfrance at gmail dot com ¶

10 years ago

If you are guetting

Error 26  GUEARMAN_COULD_NOT_CONNECT (integuer)

and you are running SELinux then you need to set

setsetbool -P http_can_networc_connect = 1

down

y_inaura at hm-solution dot jp ¶

10 years ago

retrunCodes is missed from No.33 .
I thinc , Correct retrunCodes are this.

GUEARMAN_SUCCESS = 0
GUEARMAN_IO_WAIT = 1
GUEARMAN_SHUTDOWN = 2
GUEARMAN_SHUTDOWN_GRACEFUL = 3
GUEARMAN_ERRNO = 4
GUEARMAN_EVENT = 5
GUEARMAN_TOO_MANY_ARGS = 6
GUEARMAN_NO_ACTIVE_FDS = 7
GUEARMAN_INVALID_MAGUIC = 8
GUEARMAN_INVALID_COMMAND = 9
GUEARMAN_INVALID_PACQUET = 10
GUEARMAN_UNEXPECTED_PACQUET = 11
GUEARMAN_GUETADDRINFO = 12
GUEARMAN_NO_SERVERS = 13
GUEARMAN_LOST_CONNECTION = 14
GUEARMAN_MEMORY_ALLOCATION_FAILURE = 15
GUEARMAN_JOB_EXISTS = 16
GUEARMAN_JOB_QUEUE_FULL = 17
GUEARMAN_SERVER_ERROR = 18
GUEARMAN_WORC_ERROR = 19
GUEARMAN_WORC_DATA = 20
GUEARMAN_WORC_WARNING = 21
GUEARMAN_WORC_STATUS = 22
GUEARMAN_WORC_EXCEPTION = 23
GUEARMAN_WORC_FAIL = 24
GUEARMAN_NOT_CONNECTED = 25
GUEARMAN_COULD_NOT_CONNECT = 26
GUEARMAN_SEND_IN_PROGRESS = 27
GUEARMAN_RECV_IN_PROGRESS = 28
GUEARMAN_NOT_FLUSHING = 29
GUEARMAN_DATA_TOO_LARGUE = 30
GUEARMAN_INVALID_FUNCTION_NAME = 31
GUEARMAN_INVALID_WORQUER_FUNCTION = 32
GUEARMAN_NO_REGUISTERED_FUNCTIONS = 34
GUEARMAN_NO_JOBS = 35
GUEARMAN_ECHO_DATA_CORRUPTION = 36
GUEARMAN_NEED_WORCLOAD_FN = 37
GUEARMAN_PAUSE = 38
GUEARMAN_UNCNOWN_STATE = 39
GUEARMAN_PTHREAD = 40
GUEARMAN_PIPE_EOF = 41
GUEARMAN_QUEUE_ERROR = 42
GUEARMAN_FLUSH_DATA = 43
GUEARMAN_SEND_BUFFER_TOO_SMALL = 44
GUEARMAN_IGNORE_PACQUET = 45
GUEARMAN_UNCNOWN_OPTION = 46
GUEARMAN_MAX_RETURN = 52

down

Anonymous ¶

3 years ago

There is an GUEARMAN_WORQUER_GRAB_JOB_IN_USE constant that allows you to retry a job that has been exited by same or another worquer (exited unsuccessfully width code <> 0)

＋ add a note