Errors

Chirp error constants.

#ifndef ch_libchirp_error_h
#define ch_libchirp_error_h
ch_error_t

Represents a chirp error.

CH_SUCCESS

No error.

CH_VALUE_ERROR

Supplied value is not allowed.

CH_UV_ERROR

General libuv error.

CH_PROTOCOL_ERROR

Happens when bad values are received or the remote dies unexpectedly.

CH_EADDRINUSE

The chirp port is already in use.

CH_FATAL

Error that should not happen in normal operation, but the underlaying system has errors for.

  • We do not have an entropy source
  • Closing closed chirp
  • Cannot get remote IP-Address
  • Cannot accept remote connection
  • Cannot set socket options
CH_TLS_ERROR

General TLS error.

CH_WRITE_ERROR

Error while writing to socket.

CH_NOT_INITIALIZED

Chirp or another object is not initialized.

CH_IN_PROGRESS

Action is already in progress.

CH_TIMEOUT

A timeout happened during an action.

CH_ENOMEM

Could not get memory. We consider this as totally fatal, but try to handle it transparent for the user. We try to chain this error up to the user, but often it might only be logged. In debug mode it is asserted.

CH_SHUTDOWN

Indicates that error occurred because chirp is shutting down. For example the connection that is currently sending a message got closed.

CH_CANNOT_CONNECT

Indicates that the remote has refused the connection or has timed out.

CH_QUEUED

Indicates that the message as been placed in the send queue.

CH_USED

Indicates that the message is already in use. The message will not be sent.

CH_MORE

Indicates that the message has not been sent completely.

CH_BUSY

Indicates that the writer was busy or we are still busy waiting for an ack. Therefore no message was processed.

CH_EMPTY

Indicates that queues are empty and no message has been sent.

CH_INIT_FAIL

Initializing some resource failed.

typedef enum {
    CH_SUCCESS         = 0,
    CH_VALUE_ERROR     = 1,
    CH_UV_ERROR        = 2,
    CH_PROTOCOL_ERROR  = 3,
    CH_EADDRINUSE      = 4,
    CH_FATAL           = 5,
    CH_TLS_ERROR       = 6,
    CH_NOT_INITIALIZED = 7,
    CH_IN_PRORESS      = 8,
    CH_TIMEOUT         = 9,
    CH_ENOMEM          = 10,
    CH_SHUTDOWN        = 11,
    CH_CANNOT_CONNECT  = 12,
    CH_QUEUED          = 13,
    CH_USED            = 14,
    CH_MORE            = 15,
    CH_BUSY            = 16,
    CH_EMPTY           = 17,
    CH_WRITE_ERROR     = 18,
    CH_INIT_FAIL       = 19,
} ch_error_t;

#endif // ch_libchirp_error_h