gnunet_error_codes.c File Reference

#include "gnunet_error_codes.h"
#include <stddef.h>
#include <microhttpd.h>
#include <gettext.h>

Include dependency graph for gnunet_error_codes.c:

Go to the source code of this file.

Data Structures
struct	ErrorCodeAndHint
	A pair containing an error code and its hint. More...

Macros
#define	MHD_HTTP_UNINITIALIZED   0
	MHD does not define our value for 0 (client-side generated code).

Functions
const char *	GNUNET_ErrorCode_get_hint (enum GNUNET_ErrorCode ec)
	Returns a hint for a given error code.
unsigned int	GNUNET_ErrorCode_get_http_status (enum GNUNET_ErrorCode ec)
	Return HTTP status for a given error code.
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).

Variables
static const struct ErrorCodeAndHint	code_hint_pairs []
	The list of all error codes with their hints.
static const unsigned int	code_hint_pairs_length = 22
	The length of code_hint_pairs.

Macro Definition Documentation

MHD_HTTP_UNINITIALIZED

#define MHD_HTTP_UNINITIALIZED   0

MHD does not define our value for 0 (client-side generated code).

Definition at line 28 of file gnunet_error_codes.c.

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.

Referenced by add_continuation(), add_continuation(), attr_store_cont(), create_did_ego_create_cb(), create_finished(), cred_store_cont(), del_attr_finished(), del_continuation(), delegation_store_cont(), delete_finished(), DID_create_did_store_cb(), do_error(), do_error(), handle_generic_response(), handle_zone_to_name_response(), marked_deleted(), missing_zone_creation_cont(), move_attr_finished(), origin_create_cb(), remove_did_document_namestore_cb(), remove_ticket_cont(), replace_cont(), send_result_code(), and store_completed_cb().

Here is the caller graph for this function:

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 do_error(), do_error(), and 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, and GNUNET_ErrorCode_get_http_status().

Here is the call graph for this function:

Variable Documentation

code_hint_pairs

const struct ErrorCodeAndHint code_hint_pairs[]

static

The list of all error codes with their hints.

Definition at line 55 of file gnunet_error_codes.c.

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

Referenced by GNUNET_ErrorCode_get_hint(), and GNUNET_ErrorCode_get_http_status().

code_hint_pairs_length

const unsigned int code_hint_pairs_length = 22

static

The length of code_hint_pairs.

Definition at line 196 of file gnunet_error_codes.c.

Referenced by GNUNET_ErrorCode_get_hint(), and GNUNET_ErrorCode_get_http_status().