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