#include <limits.h>

Include dependency graph for gnunet_error_codes.h:

This graph shows which files directly or indirectly include this file:

Enumerations
enum	GNUNET_ErrorCode { GNUNET_EC_NONE = 0 , GNUNET_EC_UNKNOWN = 1 , GNUNET_EC_SERVICE_COMMUNICATION_FAILED = 101 , GNUNET_EC_IDENTITY_NOT_FOUND = 200 , GNUNET_EC_IDENTITY_NAME_CONFLICT = 201 , GNUNET_EC_IDENTITY_INVALID = 202 , GNUNET_EC_NAMESTORE_UNKNOWN = 5000 , GNUNET_EC_NAMESTORE_ITERATION_FAILED = 5001 , GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND = 5002 , GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND = 5003 , GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED = 5004 , GNUNET_EC_NAMESTORE_ZONE_EMPTY = 5005 , GNUNET_EC_NAMESTORE_LOOKUP_ERROR = 5006 , GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN = 5007 , GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID = 5008 , GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN = 5009 , GNUNET_EC_NAMESTORE_NO_RESULTS = 5010 , GNUNET_EC_NAMESTORE_RECORD_EXISTS = 5011 , GNUNET_EC_NAMESTORE_RECORD_TOO_BIG = 5012 , GNUNET_EC_NAMESTORE_BACKEND_FAILED = 5013 , GNUNET_EC_NAMESTORE_STORE_FAILED = 5014 , GNUNET_EC_NAMESTORE_LABEL_INVALID = 5015 , GNUNET_EC_NONE = 0 , GNUNET_EC_UNKNOWN = 1 , GNUNET_EC_SERVICE_COMMUNICATION_FAILED = 101 , GNUNET_EC_IDENTITY_NOT_FOUND = 200 , GNUNET_EC_IDENTITY_NAME_CONFLICT = 201 , GNUNET_EC_IDENTITY_INVALID = 202 , GNUNET_EC_NAMESTORE_UNKNOWN = 5000 , GNUNET_EC_NAMESTORE_ITERATION_FAILED = 5001 , GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND = 5002 , GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND = 5003 , GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED = 5004 , GNUNET_EC_NAMESTORE_ZONE_EMPTY = 5005 , GNUNET_EC_NAMESTORE_LOOKUP_ERROR = 5006 , GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN = 5007 , GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID = 5008 , GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN = 5009 , GNUNET_EC_NAMESTORE_NO_RESULTS = 5010 , GNUNET_EC_NAMESTORE_RECORD_EXISTS = 5011 , GNUNET_EC_NAMESTORE_RECORD_TOO_BIG = 5012 , GNUNET_EC_NAMESTORE_BACKEND_FAILED = 5013 , GNUNET_EC_NAMESTORE_STORE_FAILED = 5014 , GNUNET_EC_NAMESTORE_LABEL_INVALID = 5015 }
	Taler error codes. More...

Functions
const char *	GNUNET_ErrorCode_get_hint (enum GNUNET_ErrorCode ec)
	Returns a hint for a given error code. More...

unsigned int	GNUNET_ErrorCode_get_http_status (enum GNUNET_ErrorCode ec)
	Return HTTP status for a given error code. More...

unsigned int	GNUNET_ErrorCode_get_http_status_safe (enum GNUNET_ErrorCode ec)
	Return HTTP status for a given error code that is guaranteed to work (no corner cases). More...

Enumeration Type Documentation

◆ GNUNET_ErrorCode

enum GNUNET_ErrorCode

Taler error codes.

Enumerator
GNUNET_EC_NONE	No error (success). Returned with an HTTP status code of MHD_HTTP_UNINITIALIZED (0).
GNUNET_EC_UNKNOWN	Unknown and unspecified error. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_SERVICE_COMMUNICATION_FAILED	Communication with service failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_IDENTITY_NOT_FOUND	Ego not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_IDENTITY_NAME_CONFLICT	Identifier already in use for another ego. Returned with an HTTP status code of MHD_HTTP_CONFLICT (409).
GNUNET_EC_IDENTITY_INVALID	The given ego is invalid or malformed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_UNKNOWN	Unknown namestore error. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ITERATION_FAILED	Zone iteration failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND	Zone not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND	Record not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED	Zone iteration failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ZONE_EMPTY	Zone does not contain any records. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_LOOKUP_ERROR	Failed to lookup record. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN	No records given. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID	Record data invalid. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN	No label given. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_NO_RESULTS	No results given. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_EXISTS	Record already exists. Returned with an HTTP status code of MHD_HTTP_CONFLICT (409).
GNUNET_EC_NAMESTORE_RECORD_TOO_BIG	Record size exceeds maximum limit. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_BACKEND_FAILED	There was an error in the database backend. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_STORE_FAILED	Failed to store the given records. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_LABEL_INVALID	Label invalid or malformed. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NONE	No error (success). Returned with an HTTP status code of MHD_HTTP_UNINITIALIZED (0).
GNUNET_EC_UNKNOWN	Unknown and unspecified error. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_SERVICE_COMMUNICATION_FAILED	Communication with service failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_IDENTITY_NOT_FOUND	Ego not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_IDENTITY_NAME_CONFLICT	Identifier already in use for another ego. Returned with an HTTP status code of MHD_HTTP_CONFLICT (409).
GNUNET_EC_IDENTITY_INVALID	The given ego is invalid or malformed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_UNKNOWN	Unknown namestore error. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ITERATION_FAILED	Zone iteration failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND	Zone not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND	Record not found. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED	Zone iteration failed. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_ZONE_EMPTY	Zone does not contain any records. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_LOOKUP_ERROR	Failed to lookup record. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN	No records given. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID	Record data invalid. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN	No label given. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).
GNUNET_EC_NAMESTORE_NO_RESULTS	No results given. Returned with an HTTP status code of MHD_HTTP_NOT_FOUND (404).
GNUNET_EC_NAMESTORE_RECORD_EXISTS	Record already exists. Returned with an HTTP status code of MHD_HTTP_CONFLICT (409).
GNUNET_EC_NAMESTORE_RECORD_TOO_BIG	Record size exceeds maximum limit. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_BACKEND_FAILED	There was an error in the database backend. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_STORE_FAILED	Failed to store the given records. Returned with an HTTP status code of MHD_HTTP_INTERNAL_SERVER_ERROR (500).
GNUNET_EC_NAMESTORE_LABEL_INVALID	Label invalid or malformed. Returned with an HTTP status code of MHD_HTTP_BAD_REQUEST (400).

Definition at line 42 of file gnunet_error_codes.h.

{
 
  GNUNET_EC_NONE = 0,
 
  GNUNET_EC_UNKNOWN = 1,
 
  GNUNET_EC_SERVICE_COMMUNICATION_FAILED = 101,
 
  GNUNET_EC_IDENTITY_NOT_FOUND = 200,
 
  GNUNET_EC_IDENTITY_NAME_CONFLICT = 201,
 
  GNUNET_EC_IDENTITY_INVALID = 202,
 
  GNUNET_EC_NAMESTORE_UNKNOWN = 5000,
 
  GNUNET_EC_NAMESTORE_ITERATION_FAILED = 5001,
 
  GNUNET_EC_NAMESTORE_ZONE_NOT_FOUND = 5002,
 
  GNUNET_EC_NAMESTORE_RECORD_NOT_FOUND = 5003,
 
  GNUNET_EC_NAMESTORE_RECORD_DELETE_FAILED = 5004,
 
  GNUNET_EC_NAMESTORE_ZONE_EMPTY = 5005,
 
  GNUNET_EC_NAMESTORE_LOOKUP_ERROR = 5006,
 
  GNUNET_EC_NAMESTORE_NO_RECORDS_GIVEN = 5007,
 
  GNUNET_EC_NAMESTORE_RECORD_DATA_INVALID = 5008,
 
  GNUNET_EC_NAMESTORE_NO_LABEL_GIVEN = 5009,
 
  GNUNET_EC_NAMESTORE_NO_RESULTS = 5010,
 
  GNUNET_EC_NAMESTORE_RECORD_EXISTS = 5011,
 
  GNUNET_EC_NAMESTORE_RECORD_TOO_BIG = 5012,
 
  GNUNET_EC_NAMESTORE_BACKEND_FAILED = 5013,
 
  GNUNET_EC_NAMESTORE_STORE_FAILED = 5014,
 
  GNUNET_EC_NAMESTORE_LABEL_INVALID = 5015,
 
};

Function Documentation

◆ GNUNET_ErrorCode_get_hint()

const char * GNUNET_ErrorCode_get_hint ( enum GNUNET_ErrorCode ec )

Returns a hint for a given error code.

Parameters

ec	the error code.

Returns: the hint if it could be found, otherwise "<no hint found>"

Definition at line 201 of file gnunet_error_codes.c.

{
  unsigned int lower = 0;
  unsigned int upper = code_hint_pairs_length - 1;
  unsigned int mid = upper / 2;
  while (lower <= upper)
  {
    mid = (upper + lower) / 2;
    if (code_hint_pairs[mid].ec < ec)
    {
      lower = mid + 1;
    }
    else if (code_hint_pairs[mid].ec > ec)
    {
      upper = mid - 1;
    }
    else
    {
      return code_hint_pairs[mid].hint;
    }
  }
  return "<no hint found>";
}

References code_hint_pairs, code_hint_pairs_length, ErrorCodeAndHint::ec, and ErrorCodeAndHint::hint.

◆ GNUNET_ErrorCode_get_http_status()

unsigned int GNUNET_ErrorCode_get_http_status ( enum GNUNET_ErrorCode ec )

Return HTTP status for a given error code.

Parameters

ec	the error code.

Returns: the HTTP status code for the given ec, UINT_MAX if not found

Definition at line 227 of file gnunet_error_codes.c.

{
  unsigned int lower = 0;
  unsigned int upper = code_hint_pairs_length - 1;
  unsigned int mid = upper / 2;
  while (lower <= upper)
  {
    mid = (upper + lower) / 2;
    if (code_hint_pairs[mid].ec < ec)
    {
      lower = mid + 1;
    }
    else if (code_hint_pairs[mid].ec > ec)
    {
      upper = mid - 1;
    }
    else
    {
      return code_hint_pairs[mid].http_code;
    }
  }
  return UINT_MAX;
}

References code_hint_pairs, code_hint_pairs_length, ErrorCodeAndHint::ec, and ErrorCodeAndHint::http_code.

Referenced by GNUNET_ErrorCode_get_http_status_safe().

Here is the caller graph for this function:

◆ GNUNET_ErrorCode_get_http_status_safe()

unsigned int GNUNET_ErrorCode_get_http_status_safe ( enum GNUNET_ErrorCode ec )

Return HTTP status for a given error code that is guaranteed to work (no corner cases).

Parameters

ec	the error code.

Returns: the HTTP status code for the given ec, 500 if the ec is not found or is a client-side code

Definition at line 253 of file gnunet_error_codes.c.

{
  unsigned int hc;
 
  hc = GNUNET_ErrorCode_get_http_status (ec);
  if ( (0 == hc) ||
       (UINT_MAX == hc) )
    return MHD_HTTP_INTERNAL_SERVER_ERROR;
  return hc;
}

References ErrorCodeAndHint::ec, GNUNET_ErrorCode_get_http_status(), and MHD_HTTP_INTERNAL_SERVER_ERROR.

Here is the call graph for this function:

Enumerations

Functions

Enumeration Type Documentation

◆ GNUNET_ErrorCode

Function Documentation

◆ GNUNET_ErrorCode_get_hint()

◆ GNUNET_ErrorCode_get_http_status()

◆ GNUNET_ErrorCode_get_http_status_safe()