GNUnet 0.21.0
Collaboration diagram for Logging:

Macros

#define GNUNET_EXTRA_LOGGING   1
 define GNUNET_EXTRA_LOGGING if using this header outside the GNUnet source tree where gnunet_config.h is unavailable More...
 
#define GNUNET_assert(cond)
 Use this for fatal errors that cannot be handled. More...
 
#define GNUNET_assert_at(cond, f, l)
 Use this for fatal errors that cannot be handled. More...
 
#define GNUNET_assert_from(cond, comp)
 Use this for fatal errors that cannot be handled. More...
 
#define GNUNET_break(cond)
 Use this for internal assertion violations that are not fatal (can be handled) but should not occur. More...
 
#define GNUNET_break_op(cond)
 Use this for assertion violations caused by other peers (i.e. More...
 
#define GNUNET_log_strerror(level, cmd)
 Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno). More...
 
#define GNUNET_log_from_strerror(level, component, cmd)
 Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno). More...
 
#define GNUNET_log_strerror_file(level, cmd, filename)
 Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno). More...
 
#define GNUNET_log_from_strerror_file(level, component, cmd, filename)
 Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno). More...
 

Typedefs

typedef void(* GNUNET_Logger) (void *cls, enum GNUNET_ErrorType kind, const char *component, const char *date, const char *message)
 User-defined handler for log messages. More...
 

Enumerations

enum  GNUNET_ErrorType {
  GNUNET_ERROR_TYPE_UNSPECIFIED = -1 , GNUNET_ERROR_TYPE_NONE = 0 , GNUNET_ERROR_TYPE_ERROR = 1 , GNUNET_ERROR_TYPE_WARNING = 2 ,
  GNUNET_ERROR_TYPE_MESSAGE = 4 , GNUNET_ERROR_TYPE_INFO = 8 , GNUNET_ERROR_TYPE_DEBUG = 16 , GNUNET_ERROR_TYPE_INVALID = 32 ,
  GNUNET_ERROR_TYPE_BULK = 64
}
 Types of errors. More...
 

Functions

int GNUNET_get_log_skip (void)
 Get the number of log calls that are going to be skipped. More...
 
void GNUNET_log_nocheck (enum GNUNET_ErrorType kind, const char *message,...) __attribute__((format(printf
 Main log function. More...
 
void GNUNET_log_from_nocheck (enum GNUNET_ErrorType kind, const char *comp, const char *message,...) __attribute__((format(printf
 Log function that specifies an alternative component. More...
 
void GNUNET_log_config_missing (enum GNUNET_ErrorType kind, const char *section, const char *option)
 Log error message about missing configuration option. More...
 
void GNUNET_log_config_invalid (enum GNUNET_ErrorType kind, const char *section, const char *option, const char *required)
 Log error message about invalid configuration option value. More...
 
void GNUNET_abort_ (void) __attribute__((noreturn))
 Abort the process, generate a core dump if possible. More...
 
void GNUNET_log_skip (int n, int check_reset)
 Ignore the next n calls to the log function. More...
 
enum GNUNET_GenericReturnValue GNUNET_log_setup (const char *comp, const char *loglevel, const char *logfile)
 Setup logging. More...
 
void GNUNET_logger_add (GNUNET_Logger logger, void *logger_cls)
 Add a custom logger. More...
 
void GNUNET_logger_remove (GNUNET_Logger logger, void *logger_cls)
 Remove a custom logger. More...
 
const char * GNUNET_sh2s (const struct GNUNET_ShortHashCode *shc)
 Convert a short hash value to a string (for printing debug messages). More...
 
const char * GNUNET_uuid2s (const struct GNUNET_Uuid *uuid)
 Convert a UUID to a string (for printing debug messages). More...
 
const char * GNUNET_h2s (const struct GNUNET_HashCode *hc)
 Convert a hash value to a string (for printing debug messages). More...
 
const char * GNUNET_h2s2 (const struct GNUNET_HashCode *hc)
 Convert a hash value to a string (for printing debug messages). More...
 
const char * GNUNET_h2s_full (const struct GNUNET_HashCode *hc)
 Convert a hash value to a string (for printing debug messages). More...
 
const char * GNUNET_p2s (const struct GNUNET_CRYPTO_EddsaPublicKey *p)
 Convert a public key value to a string (for printing debug messages). More...
 
const char * GNUNET_p2s2 (const struct GNUNET_CRYPTO_EddsaPublicKey *p)
 Convert a public key value to a string (for printing debug messages). More...
 
const char * GNUNET_e2s (const struct GNUNET_CRYPTO_EcdhePublicKey *p)
 Convert a public key value to a string (for printing debug messages). More...
 
const char * GNUNET_e2s2 (const struct GNUNET_CRYPTO_EcdhePublicKey *p)
 Convert a public key value to a string (for printing debug messages). More...
 
const char * GNUNET_i2s (const struct GNUNET_PeerIdentity *pid)
 Convert a peer identity to a string (for printing debug messages). More...
 
const char * GNUNET_i2s2 (const struct GNUNET_PeerIdentity *pid)
 Convert a peer identity to a string (for printing debug messages). More...
 
const char * GNUNET_i2s_full (const struct GNUNET_PeerIdentity *pid)
 Convert a peer identity to a string (for printing debug messages). More...
 
const char * GNUNET_a2s (const struct sockaddr *addr, socklen_t addrlen)
 Convert a "struct sockaddr*" (IPv4 or IPv6 address) to a string (for printing debug messages). More...
 
const char * GNUNET_error_type_to_string (enum GNUNET_ErrorType kind)
 Convert error type to string. More...
 

Detailed Description

See also
Documentation

Macro Definition Documentation

◆ GNUNET_EXTRA_LOGGING

#define GNUNET_EXTRA_LOGGING   1

define GNUNET_EXTRA_LOGGING if using this header outside the GNUnet source tree where gnunet_config.h is unavailable

Definition at line 154 of file gnunet_common.h.

◆ GNUNET_assert

#define GNUNET_assert (   cond)
Value:
do \
{ \
if (! (cond)) \
{ \
GNUNET_log (GNUNET_ERROR_TYPE_ERROR, \
dgettext ("gnunet", "Assertion failed at %s:%d. Aborting.\n"), \
__FILE__, \
__LINE__); \
GNUNET_abort_ (); \
} \
} while (0)
#define dgettext(Domainname, Msgid)
Definition: gettext.h:47
@ GNUNET_ERROR_TYPE_ERROR

Use this for fatal errors that cannot be handled.

Definition at line 937 of file gnunet_common.h.

◆ GNUNET_assert_at

#define GNUNET_assert_at (   cond,
  f,
 
)
Value:
do \
{ \
if (! (cond)) \
{ \
GNUNET_log (GNUNET_ERROR_TYPE_ERROR, \
dgettext ("gnunet", "Assertion failed at %s:%d. Aborting.\n"), \
f, \
l); \
GNUNET_abort_ (); \
} \
} while (0)

Use this for fatal errors that cannot be handled.

Definition at line 955 of file gnunet_common.h.

◆ GNUNET_assert_from

#define GNUNET_assert_from (   cond,
  comp 
)
Value:
do \
{ \
if (! (cond)) \
{ \
GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR, \
comp, \
dgettext ("gnunet", "Assertion failed at %s:%d. Aborting.\n"), \
__FILE__, \
__LINE__); \
GNUNET_abort_ (); \
} \
} while (0)

Use this for fatal errors that cannot be handled.

Parameters
condCondition to evaluate
compComponent string to use for logging

Definition at line 976 of file gnunet_common.h.

◆ GNUNET_break

#define GNUNET_break (   cond)
Value:
do \
{ \
if (! (cond)) \
{ \
GNUNET_log (GNUNET_ERROR_TYPE_ERROR, \
dgettext ("gnunet", "Assertion failed at %s:%d.\n"), \
__FILE__, \
__LINE__); \
} \
} while (0)

Use this for internal assertion violations that are not fatal (can be handled) but should not occur.

Definition at line 1018 of file gnunet_common.h.

◆ GNUNET_break_op

#define GNUNET_break_op (   cond)
Value:
do \
{ \
if (! (cond)) \
{ \
dgettext ("gnunet", "External protocol violation detected at %s:%d.\n"), \
__FILE__, \
__LINE__); \
} \
} while (0)
@ GNUNET_ERROR_TYPE_WARNING
@ GNUNET_ERROR_TYPE_BULK

Use this for assertion violations caused by other peers (i.e.

protocol violations). We do not want to confuse end-users (say, some other peer runs an older, broken or incompatible GNUnet version), but we still want to see these problems during development and testing. "OP == other peer".

Definition at line 1040 of file gnunet_common.h.

◆ GNUNET_log_strerror

#define GNUNET_log_strerror (   level,
  cmd 
)
Value:
do \
{ \
GNUNET_log (level, \
dgettext ("gnunet", "`%s' failed at %s:%d with error: %s\n"), \
cmd, \
__FILE__, \
__LINE__, \
strerror (errno)); \
} while (0)

Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno).

Definition at line 1059 of file gnunet_common.h.

◆ GNUNET_log_from_strerror

#define GNUNET_log_from_strerror (   level,
  component,
  cmd 
)
Value:
do \
{ \
GNUNET_log_from (level, \
dgettext ("gnunet", "`%s' failed at %s:%d with error: %s\n"), \
cmd, \
__FILE__, \
__LINE__, \
strerror (errno)); \
} while (0)
static char * component
Running component.

Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno).

Definition at line 1077 of file gnunet_common.h.

◆ GNUNET_log_strerror_file

#define GNUNET_log_strerror_file (   level,
  cmd,
  filename 
)
Value:
do \
{ \
GNUNET_log (level, \
dgettext ("gnunet", "`%s' failed on file `%s' at %s:%d with error: %s\n"), \
cmd, \
__FILE__, \
__LINE__, \
strerror (errno)); \
} while (0)
static char * filename

Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno).

Definition at line 1096 of file gnunet_common.h.

◆ GNUNET_log_from_strerror_file

#define GNUNET_log_from_strerror_file (   level,
  component,
  cmd,
  filename 
)
Value:
do \
{ \
GNUNET_log_from (level, \
dgettext ("gnunet", "`%s' failed on file `%s' at %s:%d with error: %s\n"), \
cmd, \
__FILE__, \
__LINE__, \
strerror (errno)); \
} while (0)

Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the message given by strerror(errno).

Definition at line 1115 of file gnunet_common.h.

Typedef Documentation

◆ GNUNET_Logger

typedef void(* GNUNET_Logger) (void *cls, enum GNUNET_ErrorType kind, const char *component, const char *date, const char *message)

User-defined handler for log messages.

Parameters
clsclosure
kindsevereity
componentwhat component is issuing the message?
datewhen was the message logged?
messagewhat is the message

Definition at line 454 of file gnunet_common.h.

Enumeration Type Documentation

◆ GNUNET_ErrorType

Types of errors.

Enumerator
GNUNET_ERROR_TYPE_UNSPECIFIED 
GNUNET_ERROR_TYPE_NONE 
GNUNET_ERROR_TYPE_ERROR 
GNUNET_ERROR_TYPE_WARNING 
GNUNET_ERROR_TYPE_MESSAGE 
GNUNET_ERROR_TYPE_INFO 
GNUNET_ERROR_TYPE_DEBUG 
GNUNET_ERROR_TYPE_INVALID 
GNUNET_ERROR_TYPE_BULK 

Definition at line 427 of file gnunet_common.h.

428{
433 /* UX: We need a message type that is output by
434 * default without looking like there is a problem.
435 */
441};
@ GNUNET_ERROR_TYPE_UNSPECIFIED
@ GNUNET_ERROR_TYPE_NONE
@ GNUNET_ERROR_TYPE_INVALID
@ GNUNET_ERROR_TYPE_MESSAGE
@ GNUNET_ERROR_TYPE_DEBUG
@ GNUNET_ERROR_TYPE_INFO

Function Documentation

◆ GNUNET_get_log_skip()

int GNUNET_get_log_skip ( void  )

Get the number of log calls that are going to be skipped.

Returns
number of log calls to be ignored

Definition at line 980 of file common_logging.c.

981{
982 return skip_log;
983}
static GNUNET_THREAD_LOCAL int skip_log
Number of log calls to ignore.

References skip_log.

◆ GNUNET_log_nocheck()

void GNUNET_log_nocheck ( enum GNUNET_ErrorType  kind,
const char *  message,
  ... 
)

Main log function.

Parameters
kindhow serious is the error?
messagewhat is the message (format string)
...arguments for format string

◆ GNUNET_log_from_nocheck()

void GNUNET_log_from_nocheck ( enum GNUNET_ErrorType  kind,
const char *  comp,
const char *  message,
  ... 
)

Log function that specifies an alternative component.

This function should be used by plugins.

Parameters
kindhow serious is the error?
compcomponent responsible for generating the message
messagewhat is the message (format string)
...arguments for format string

Referenced by main(), and run().

Here is the caller graph for this function:

◆ GNUNET_log_config_missing()

void GNUNET_log_config_missing ( enum GNUNET_ErrorType  kind,
const char *  section,
const char *  option 
)

Log error message about missing configuration option.

Parameters
kindlog level
sectionsection with missing option
optionname of missing option

Definition at line 1442 of file common_logging.c.

1445{
1446 GNUNET_log (kind,
1447 _ (
1448 "Configuration fails to specify option `%s' in section `%s'!\n"),
1449 option,
1450 section);
1451}
#define GNUNET_log(kind,...)
#define _(String)
GNU gettext support macro.
Definition: platform.h:178

References _, and GNUNET_log.

Referenced by database_connect(), database_setup(), DHTU_ip_init(), get_bootstrap_server(), get_update_information_directory(), GNUNET_CONFIGURATION_config_tool_run(), GNUNET_CONVERSATION_phone_create(), GNUNET_DATACACHE_create(), GNUNET_PQ_connect_with_cfg2(), GNUNET_RPS_connect(), GSF_pending_request_init_(), load(), load_hostlist_file(), mq_init(), new_sub(), purge_cfg_dir(), read_index_list(), run(), save(), save_hostlist_file(), setup_exit_helper_args(), sock_read(), start_arm_service(), and write_index_list().

Here is the caller graph for this function:

◆ GNUNET_log_config_invalid()

void GNUNET_log_config_invalid ( enum GNUNET_ErrorType  kind,
const char *  section,
const char *  option,
const char *  required 
)

Log error message about invalid configuration option value.

Parameters
kindlog level
sectionsection with invalid option
optionname of invalid option
requiredwhat is required that is invalid about the option

Definition at line 1455 of file common_logging.c.

1459{
1460 GNUNET_log (
1461 kind,
1462 _ (
1463 "Configuration specifies invalid value for option `%s' in section `%s': %s\n"),
1464 option,
1465 section,
1466 required);
1467}

References _, and GNUNET_log.

Referenced by advertise_dns_exit(), DHTU_ip_init(), GCD_init(), GNUNET_CLIENT_test(), GNUNET_CONFIGURATION_get_value_time(), GNUNET_GNS_lookup_with_tld(), GSF_push_init_(), read_service_conf(), run(), setup_exit_helper_args(), setup_service(), and test_service_configuration().

Here is the caller graph for this function:

◆ GNUNET_abort_()

void GNUNET_abort_ ( void  )

Abort the process, generate a core dump if possible.

Most code should use GNUNET_assert (0) instead to first log the location of the failure.

Definition at line 278 of file common_logging.c.

279{
280 abort ();
281}

◆ GNUNET_log_skip()

void GNUNET_log_skip ( int  n,
int  check_reset 
)

Ignore the next n calls to the log function.

Parameters
nnumber of log calls to ignore (could be negative)
check_resetGNUNET_YES to assert that the log skip counter is currently zero

Definition at line 956 of file common_logging.c.

957{
958 int ok;
959
960 if (0 == n)
961 {
962 ok = (0 == skip_log);
963 skip_log = 0;
964 if (check_reset)
965 GNUNET_break (ok);
966 }
967 else
968 {
969 skip_log += n;
970 }
971}
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.

References GNUNET_break, and skip_log.

◆ GNUNET_log_setup()

enum GNUNET_GenericReturnValue GNUNET_log_setup ( const char *  comp,
const char *  loglevel,
const char *  logfile 
)

Setup logging.

Parameters
compdefault component to use
loglevelwhat types of messages should be logged
logfilechange logging to logfile (use NULL to keep stderr)
Returns
GNUNET_OK on success, GNUNET_SYSERR if logfile could not be opened
Parameters
compdefault component to use
loglevelwhat types of messages should be logged
logfilewhich file to write log messages to (can be NULL)
Returns
GNUNET_OK on success

Definition at line 729 of file common_logging.c.

732{
733 const char *env_logfile;
734
735 min_level = get_type (loglevel);
736#if ! defined(GNUNET_CULL_LOGGING)
738#endif
741 "%s-%d",
742 comp,
743 getpid ());
746
747 env_logfile = getenv ("GNUNET_FORCE_LOGFILE");
748 if ((NULL != env_logfile) && (strlen (env_logfile) > 0))
749 logfile = env_logfile;
750 if (NULL == logfile)
751 return GNUNET_OK;
754 if (NULL == log_file_name)
755 return GNUNET_SYSERR;
756#if defined(GNUNET_CULL_LOGGING)
757 /* log file option not allowed for wallet logic */
758 GNUNET_assert (NULL == logfile);
759 return GNUNET_OK;
760#else
761 {
762 time_t t;
763 const struct tm *tm;
764
765 t = time (NULL);
766 tm = gmtime (&t);
767 return setup_log_file (tm);
768 }
769#endif
770}
static void parse_all_definitions()
Utility function - parses GNUNET_LOG and GNUNET_FORCE_LOG.
static char * log_file_name
Format string describing the name of the log file.
static char * component_nopid
Running component (without pid).
static enum GNUNET_ErrorType get_type(const char *log)
Convert a textual description of a loglevel to the respective enumeration type.
static enum GNUNET_GenericReturnValue setup_log_file(const struct tm *tm)
Setup the log file.
static enum GNUNET_ErrorType min_level
Minimum log level.
char * getenv()
static struct GNUNET_SCHEDULER_Task * t
Main task.
@ GNUNET_OK
@ GNUNET_SYSERR
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
int int GNUNET_asprintf(char **buf, const char *format,...) __attribute__((format(printf
Like asprintf, just portable.
#define GNUNET_strdup(a)
Wrapper around GNUNET_xstrdup_.
#define GNUNET_free(ptr)
Wrapper around free.
char * GNUNET_STRINGS_filename_expand(const char *fil)
Complete filename (a la shell) from abbrevition.
Definition: strings.c:495

References component, component_nopid, get_type(), getenv(), GNUNET_asprintf(), GNUNET_assert, GNUNET_free, GNUNET_OK, GNUNET_strdup, GNUNET_STRINGS_filename_expand(), GNUNET_SYSERR, log_file_name, min_level, parse_all_definitions(), setup_log_file(), and t.

Referenced by get_app(), GNUNET_PROGRAM_run2(), GNUNET_SERVICE_main(), GNUNET_SERVICE_run_(), GNUNET_TESTING_service_run(), GNUNET_TRANSPORT_TESTING_main_(), main(), and run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_logger_add()

void GNUNET_logger_add ( GNUNET_Logger  logger,
void *  logger_cls 
)

Add a custom logger.

Note that installing any custom logger will disable the standard logger. When multiple custom loggers are installed, all will be called. The standard logger will only be used if no custom loggers are present.

Parameters
loggerlog function
logger_clsclosure for logger

Definition at line 774 of file common_logging.c.

776{
777 struct CustomLogger *entry;
778
779 entry = GNUNET_new (struct CustomLogger);
780 entry->logger = logger;
781 entry->logger_cls = logger_cls;
782 entry->next = loggers;
783 loggers = entry;
784}
static struct CustomLogger * loggers
Linked list of our custom loggres.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
Linked list of active loggers.
void * logger_cls
Closure for logger.
struct CustomLogger * next
This is a linked list.
GNUNET_Logger logger
Log function.

References GNUNET_new, typescriptdomain::logger, CustomLogger::logger, CustomLogger::logger_cls, loggers, and CustomLogger::next.

◆ GNUNET_logger_remove()

void GNUNET_logger_remove ( GNUNET_Logger  logger,
void *  logger_cls 
)

Remove a custom logger.

Parameters
loggerlog function
logger_clsclosure for logger

Definition at line 788 of file common_logging.c.

790{
791 struct CustomLogger *pos;
792 struct CustomLogger *prev;
793
794 prev = NULL;
795 pos = loggers;
796 while ((NULL != pos) &&
797 ((pos->logger != logger) || (pos->logger_cls != logger_cls)))
798 {
799 prev = pos;
800 pos = pos->next;
801 }
802 GNUNET_assert (NULL != pos);
803 if (NULL == prev)
804 loggers = pos->next;
805 else
806 prev->next = pos->next;
807 GNUNET_free (pos);
808}

References GNUNET_assert, GNUNET_free, typescriptdomain::logger, CustomLogger::logger, CustomLogger::logger_cls, loggers, and CustomLogger::next.

◆ GNUNET_sh2s()

const char * GNUNET_sh2s ( const struct GNUNET_ShortHashCode shc)

Convert a short hash value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
shcthe hash code
Returns
string

Definition at line 1250 of file common_logging.c.

1251{
1252 static GNUNET_THREAD_LOCAL char buf[64];
1253
1254 GNUNET_STRINGS_data_to_string (shc, sizeof(*shc), buf, sizeof(buf));
1255 buf[6] = '\0';
1256 return (const char *) buf;
1257}
char * GNUNET_STRINGS_data_to_string(const void *data, size_t size, char *out, size_t out_size)
Convert binary data to ASCII encoding using CrockfordBase32.
Definition: strings.c:709
#define GNUNET_THREAD_LOCAL
Definition: platform.h:247

References GNUNET_STRINGS_data_to_string(), and GNUNET_THREAD_LOCAL.

Referenced by add_store_member(), change_srv_handle_member_id(), check_member_session_completion(), create_handle_member_id(), decrypt_box(), delete_srv_room_message(), destroy_route(), discard_all_from_rung_tail(), dv_setup_key_state_from_km(), find_member_session_in_room(), GCC_2s(), GCC_handle_kx(), GCC_handle_kx_auth(), get_store_peer_of(), handle_connection_broken(), handle_connection_create(), handle_connection_create_ack(), handle_connection_destroy(), handle_dv_learn(), handle_get_message(), handle_message_join(), handle_message_leave(), handle_room_entry(), handle_room_open(), handle_send_message(), handle_tunnel_kx(), handle_validation_challenge(), handle_validation_response(), iterate_load_next_member_sessions(), iterate_notify_about_members(), iterate_save_members(), iterate_save_peers(), join_room(), mqm_execute(), notify_about_members(), on_message(), pack_message(), pack_srv_room_message(), remove_room_member_session(), request_room_message_step(), route_message(), send_broken(), send_kx(), send_kx_auth(), send_message_join(), send_srv_handle_message(), sock_read(), start_address_validation(), start_dv_learn(), update_member_session_history(), update_store_peer(), validation_start_cb(), and validation_transmit_on_queue().

Here is the call graph for this function:

◆ GNUNET_uuid2s()

const char * GNUNET_uuid2s ( const struct GNUNET_Uuid uuid)

Convert a UUID to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
uuidthe UUID
Returns
string

Definition at line 1270 of file common_logging.c.

1271{
1272 static GNUNET_THREAD_LOCAL char buf[32];
1273
1274 GNUNET_STRINGS_data_to_string (uuid, sizeof(*uuid), buf, sizeof(buf));
1275 buf[6] = '\0';
1276 return (const char *) buf;
1277}

References GNUNET_STRINGS_data_to_string(), and GNUNET_THREAD_LOCAL.

Referenced by cummulative_ack(), free_pending_acknowledgement(), handle_reliability_ack(), handle_reliability_box(), and prepare_pending_acknowledgement().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_h2s()

const char * GNUNET_h2s ( const struct GNUNET_HashCode hc)

Convert a hash value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Convert a hash value to a string (for printing debug messages).

Parameters
hcthe hash code
Returns
string form; will be overwritten by next call to GNUNET_h2s.

Definition at line 1157 of file common_logging.c.

1158{
1160
1162 ret.encoding[8] = '\0';
1163 return (const char *) ret.encoding;
1164}
static int ret
Final status code.
Definition: gnunet-arm.c:94
void GNUNET_CRYPTO_hash_to_enc(const struct GNUNET_HashCode *block, struct GNUNET_CRYPTO_HashAsciiEncoded *result)
Convert hash to ASCII encoding.
Definition: crypto_hash.c:55
0-terminated ASCII encoding of a struct GNUNET_HashCode.

References GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, and ret.

Referenced by add_get_request_to_pending(), add_member_session(), advertise_dns_exit(), block_proc(), callback_found_message(), callback_room_connect(), callback_room_deletion(), callback_room_handle_message(), cancel_store_operation(), cb_channel_destruction(), cb_intersection_element_removed(), change_srv_handle_member_id(), check_edge(), clean_request(), clear_member_store(), clear_operation_store(), client_release_ports(), client_request_complete_alice(), client_response_handler(), consider_ss_ack(), create_channel_to_destination(), create_handle_member_id(), create_rekey(), datacache_get_iterator(), delayed_get(), delayed_put(), delete_srv_room_message(), derive_aes_key(), derive_auth_key(), derive_iv(), derive_pong_iv(), dht_get_string_accept_handler(), dht_get_string_handler(), do_rekey(), dv_setup_key_state_from_km(), env_delete_notify(), execute_add(), expired_processor(), filter_all(), filtered_map_initialization(), forward_reply(), forward_tunnel_message(), free_validation_state(), GCCH_2s(), GCCH_bind(), GCCH_channel_incoming_new(), GCCH_channel_local_new(), GCCH_hash_port(), GDS_CLIENTS_handle_reply(), GDS_DATACACHE_get_closest(), GDS_DATACACHE_handle_get(), GDS_DATACACHE_handle_put(), GDS_NEIGHBOURS_handle_get(), GDS_NEIGHBOURS_handle_put(), GDS_NEIGHBOURS_handle_reply(), get_any(), get_cb(), get_handle_member_session(), get_room_data_subdir(), get_store_message(), get_target_peers(), get_typed(), GNUNET_CADET_channel_create(), GNUNET_CADET_open_port(), GNUNET_DATACACHE_get(), GNUNET_DATACACHE_get_closest(), GNUNET_DATACACHE_put(), GNUNET_DATASTORE_get_key(), GNUNET_DATASTORE_put(), GNUNET_DATASTORE_remove(), GNUNET_DHT_get_start(), GNUNET_DHT_get_stop(), GNUNET_DHT_put(), GNUNET_FS_add_to_index(), GNUNET_FS_handle_on_demand_block(), GNUNET_FS_tree_encoder_next(), GNUNET_NAMECACHE_lookup_block(), GNUNET_SET_listen(), GNUNET_SET_listen_cancel(), GNUNET_SETI_listen(), GNUNET_SETI_listen_cancel(), GNUNET_SETU_listen(), GNUNET_SETU_listen_cancel(), GSC_bind(), GSC_KX_encrypt_and_transmit(), GSC_KX_init(), GSF_cadet_query(), GSF_cadet_query_cancel(), GSF_pending_request_create_(), GSF_pending_request_get_message_(), GSF_plan_add_(), handle_ack(), handle_bob_client_message(), handle_channel_create(), handle_channel_created(), handle_client_evaluate(), handle_client_join(), handle_client_listen(), handle_client_redirect_to_service(), handle_client_register_message(), handle_client_reject(), handle_client_set_add(), handle_client_start_search(), handle_client_unindex(), handle_data(), handle_datastore_reply(), handle_dht_local_get(), handle_dht_local_get_stop(), handle_dht_local_put(), handle_dht_p2p_get(), handle_dht_p2p_put(), handle_dht_reply(), handle_encrypted(), handle_ephemeral_key(), handle_get_key(), handle_get_message(), handle_icmp_service(), handle_incoming_msg(), handle_local_result(), handle_member_id(), handle_message_join(), handle_message_leave(), handle_miss_message(), handle_name_message(), handle_namecache_block_response(), handle_p2p_get(), handle_p2p_put(), handle_p2p_reply(), handle_plaintext_channel_open(), handle_port_close(), handle_port_open(), handle_put(), handle_query_message(), handle_recv_message(), handle_remove(), handle_reply(), handle_request(), handle_room_close(), handle_room_entry(), handle_room_open(), handle_room_sync(), handle_send_message(), handle_tcp_service(), handle_udp_service(), handle_union_p2p_demand(), handle_union_p2p_elements(), handle_union_p2p_full_element(), handle_union_p2p_offer(), handle_validation_response(), hash_for_index_cb(), hash_for_index_val(), heap_plugin_put(), initialize_map_unfiltered(), initiate_put_from_pipe_trigger(), iterate_initial_edge(), iterate_load_next_session(), iterate_save_messages(), iterate_save_operations(), iterate_save_session(), iterator_bf_create(), iterator_bf_reduce(), join_room(), kce_generate_cb(), load_state(), lookup_task(), merge_srv_room_last_messages(), mq_send_d(), namecache_sqlite_cache_block(), notify_srv_handle_message(), on_message(), open_srv_room(), plan(), prepare_client_end_notification(), prepare_ibf_iterator(), print_channel_destination(), print_edge(), print_indexed(), process(), process_client_result(), process_dht_put_content(), process_local_reply(), process_migration_content(), process_reply(), process_result_with_request(), put_cb(), put_continuation(), quota_processor(), recv_message_request(), regex_find_path(), REGEX_INTERNAL_iterate_all_edges(), REGEX_INTERNAL_search(), regex_iterator(), regex_next_edge(), REGEX_TEST_automaton_save_graph_step(), remove_by_unique_id(), remove_continuation(), remove_member_session(), remove_room_member_session(), remove_store_contact(), request_room_message_step(), requester_callback(), responder_callback(), revalidate_map_it(), route_packet(), run(), schedule_block_download(), secret_destroy(), select_peer(), send_close_room(), send_enter_room(), send_full_element_iterator(), send_key(), send_message_to_room_with_key(), send_offers_iterator(), send_open_room(), send_remaining_elements(), send_srv_handle_message(), send_srv_room_message(), send_sync_room(), send_tunnel_message(), set_room_sender_id(), sign_message(), sign_message_by_peer(), sqlite_plugin_get_closest(), sqlite_plugin_put(), start_intersection(), start_local_query(), start_p2p_processing(), store_service(), timeout_closed_cb(), transmit_client_response(), transmit_item(), transmit_pending(), transmit_request(), try_handle_plaintext(), update_member_session_history(), update_room_message(), update_store_contact(), validation_transmit_on_queue(), verify_member_session_as_sender(), and write_item().

Here is the call graph for this function:

◆ GNUNET_h2s2()

const char * GNUNET_h2s2 ( const struct GNUNET_HashCode hc)

Convert a hash value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant! Identical to GNUNET_h2s(), except that another buffer is used so both GNUNET_h2s() and GNUNET_h2s2() can be used within the same log statement.

Parameters
hcthe hash code
Returns
string

Convert a hash value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant! Identical to GNUNET_h2s(), except that another buffer is used so both GNUNET_h2s() and GNUNET_h2s2() can be used within the same log statement.

Parameters
hcthe hash code
Returns
string form; will be overwritten by next call to GNUNET_h2s.

Definition at line 1178 of file common_logging.c.

1179{
1181
1183 ret.encoding[8] = '\0';
1184 return (const char *) ret.encoding;
1185}

References GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, and ret.

Referenced by GSC_KX_encrypt_and_transmit(), and handle_encrypted().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_h2s_full()

const char * GNUNET_h2s_full ( const struct GNUNET_HashCode hc)

Convert a hash value to a string (for printing debug messages).

This prints all 104 characters of a hashcode! This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Convert a hash value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string form; will be overwritten by next call to GNUNET_h2s_full.

Definition at line 1289 of file common_logging.c.

1290{
1292
1294 ret.encoding[sizeof(ret) - 1] = '\0';
1295 return (const char *) ret.encoding;
1296}

References GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, and ret.

Referenced by forward_reply(), get_callback(), get_resp_callback(), handle_dht_local_get(), handle_dht_local_put(), handle_recv_message(), namecache_cache_block(), namecache_lookup_block(), namecache_sqlite_cache_block(), namecache_sqlite_lookup_block(), new_sub(), put_callback(), run(), and sign_hello().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_p2s()

const char * GNUNET_p2s ( const struct GNUNET_CRYPTO_EddsaPublicKey p)

Convert a public key value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Definition at line 1189 of file common_logging.c.

1190{
1192 struct GNUNET_HashCode hc;
1193
1194 GNUNET_CRYPTO_hash (p, sizeof(*p), &hc);
1196 ret.encoding[6] = '\0';
1197 return (const char *) ret.encoding;
1198}
static struct GNUNET_OS_Process * p
Helper process we started.
Definition: gnunet-uri.c:38
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:41
A 512-bit hashcode.

References GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, p, and ret.

Referenced by do_rekey(), and inject_rekey().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_p2s2()

const char * GNUNET_p2s2 ( const struct GNUNET_CRYPTO_EddsaPublicKey p)

Convert a public key value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Definition at line 1202 of file common_logging.c.

1203{
1205 struct GNUNET_HashCode hc;
1206
1207 GNUNET_CRYPTO_hash (p, sizeof(*p), &hc);
1209 ret.encoding[6] = '\0';
1210 return (const char *) ret.encoding;
1211}

References GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, p, and ret.

Here is the call graph for this function:

◆ GNUNET_e2s()

const char * GNUNET_e2s ( const struct GNUNET_CRYPTO_EcdhePublicKey p)

Convert a public key value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Definition at line 1215 of file common_logging.c.

1216{
1218 struct GNUNET_HashCode hc;
1219
1220 GNUNET_CRYPTO_hash (p, sizeof(*p), &hc);
1222 ret.encoding[6] = '\0';
1223 return (const char *) ret.encoding;
1224}

References GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, p, and ret.

Referenced by do_rekey(), GCC_handle_kx(), GCC_handle_kx_auth(), GCT_handle_kx(), GCT_handle_kx_auth(), handle_tunnel_kx(), inject_rekey(), mqm_execute(), send_kx(), and send_kx_auth().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_e2s2()

const char * GNUNET_e2s2 ( const struct GNUNET_CRYPTO_EcdhePublicKey p)

Convert a public key value to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
hcthe hash code
Returns
string

Definition at line 1228 of file common_logging.c.

1229{
1231 struct GNUNET_HashCode hc;
1232
1233 GNUNET_CRYPTO_hash (p, sizeof(*p), &hc);
1235 ret.encoding[6] = '\0';
1236 return (const char *) ret.encoding;
1237}

References GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_to_enc(), GNUNET_THREAD_LOCAL, p, and ret.

Here is the call graph for this function:

◆ GNUNET_i2s()

const char * GNUNET_i2s ( const struct GNUNET_PeerIdentity pid)

Convert a peer identity to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s().
Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s.

Definition at line 1307 of file common_logging.c.

1308{
1309 static GNUNET_THREAD_LOCAL char buf[5];
1310 char *ret;
1311
1312 if (NULL == pid)
1313 return "NULL";
1315 GNUNET_strlcpy (buf, ret, sizeof(buf));
1316 GNUNET_free (ret);
1317 return buf;
1318}
static struct GNUNET_PeerIdentity pid
Identity of the peer we transmit to / connect to.
char * GNUNET_CRYPTO_eddsa_public_key_to_string(const struct GNUNET_CRYPTO_EddsaPublicKey *pub)
Convert a public key to a string.
Definition: crypto_ecc.c:252
size_t GNUNET_strlcpy(char *dst, const char *src, size_t n)
Like strlcpy but portable.
Definition: strings.c:138
struct GNUNET_CRYPTO_EddsaPublicKey public_key

References GNUNET_CRYPTO_eddsa_public_key_to_string(), GNUNET_free, GNUNET_strlcpy(), GNUNET_THREAD_LOCAL, pid, GNUNET_PeerIdentity::public_key, and ret.

Referenced by activate_core_visible_dv_path(), add_known_to_bloom(), add_revocation(), add_search_string(), attempt_connect(), backtalker_monotime_cb(), cadet_mq_send_now(), cadet_timeout(), callback_room_connect(), cb_channel_destruction(), cb_channel_incoming(), cb_intersection_request_alice(), check_and_remove_pending_reversal(), check_peer_online(), check_peer_pull_reply(), check_validation_request_pending(), check_vl_transmission(), clean_peer(), client_disconnect_cb(), client_send_response(), clients_notify_stream_peer(), connect_cb(), connect_handler(), connect_notify(), connect_peers_run(), consider_for_advertising(), consider_sending_fc(), core_connect_cb(), core_disconnect_cb(), core_init(), core_mq_send_impl(), cores_send_connect_info(), cores_send_disconnect_info(), create_channel_to_destination(), cummulative_ack(), decrypt_new_element(), deliver_message(), derive_aes_key(), derive_iv(), derive_pong_iv(), destroy_peer(), destroy_route(), disconnect_notify(), do_connect(), do_decrypt(), do_encrypt(), do_flood(), do_restart_typemap_message(), do_round(), do_send(), dv_neighbour_transmission(), encapsulate_for_dv(), extract_box_cb(), finish_handling_raw_message(), forward_dv_box(), forward_dv_learn(), fragment_message(), free_backtalker(), free_queue_entry(), GCCH_2s(), GCD_search(), GCPP_2s(), GCT_2s(), GCT_handle_kx(), GDS_NEIGHBOURS_handle_get(), GDS_NEIGHBOURS_handle_put(), GDS_NEIGHBOURS_handle_reply(), GDS_try_connect(), GDS_u_connect(), GDS_u_disconnect(), GDS_u_receive(), get_cadet(), get_channel(), get_result_iterator(), GNUNET_CADET_channel_create(), GNUNET_CRYPTO_ecc_dlog(), GNUNET_CRYPTO_ecc_dlog_prepare(), GNUNET_DHT_pp2s(), GNUNET_DHT_verify_path(), GNUNET_PEERSTORE_hello_add(), GNUNET_PEERSTORE_store(), GNUNET_RPS_seed_ids(), GNUNET_TRANSPORT_application_suggest(), GNUNET_TRANSPORT_application_suggest_cancel(), GNUNET_TRANSPORT_application_validate(), GNUNET_TRANSPORT_communicator_receive(), GNUNET_TRANSPORT_TESTING_log_connect(), GNUNET_TRANSPORT_TESTING_log_disconnect(), GNUNET_TRANSPORT_TESTING_restart_peer(), GNUNET_TRANSPORT_TESTING_send(), GNUNET_TRANSPORT_TESTING_stop_peer(), got_hello(), GSC_CLIENTS_deliver_message(), GSC_CLIENTS_notify_client_about_neighbour(), GSC_CLIENTS_solicit_request(), GSC_KX_encrypt_and_transmit(), GSC_SESSIONS_confirm_typemap(), GSC_SESSIONS_create(), GSC_SESSIONS_end(), GSC_SESSIONS_set_typemap(), GSC_SESSIONS_solicit(), GSF_cadet_query(), GSF_cadet_query_cancel(), GSF_cadet_release_clients(), GSF_peer_connect_handler(), GSF_plan_add_(), GSF_push_start_(), handle_add_queue_message(), handle_backchannel_encapsulation(), handle_channel_create(), handle_client_redirect_to_service(), handle_client_seed(), handle_client_send(), handle_client_send_request(), handle_client_start(), handle_communicator_backchannel(), handle_connect(), handle_connect_notify(), handle_connection_create(), handle_core_connect(), handle_core_disconnect(), handle_del_queue_message(), handle_dht_p2p_get(), handle_dht_p2p_put(), handle_dht_p2p_result(), handle_disconnect(), handle_disconnect_notify(), handle_dv_box(), handle_dv_learn(), handle_encrypted(), handle_ephemeral_key(), handle_flow_control(), handle_fragment_box(), handle_hello(), handle_icmp_remote(), handle_icmp_service(), handle_inbound_channel(), handle_incoming_ack(), handle_incoming_msg(), handle_init_reply(), handle_iterate_start(), handle_local_ack(), handle_local_data(), handle_monitor_start(), handle_notify_inbound(), handle_p2p_estimate(), handle_p2p_get(), handle_p2p_migration_stop(), handle_p2p_put(), handle_peer_check(), handle_peer_pull_reply(), handle_peer_pull_request(), handle_peer_push(), handle_ping(), handle_pong(), handle_raw_message(), handle_recv(), handle_regex_result(), handle_reliability_ack(), handle_reliability_box(), handle_reply(), handle_revocation_union_request(), handle_room_entry(), handle_search_response(), handle_send_message_ack(), handle_send_ok(), handle_send_ready(), handle_store(), handle_suggest(), handle_tcp_data(), handle_tcp_remote(), handle_tcp_service(), handle_transport_notify_connect(), handle_transport_notify_disconnect(), handle_udp_remote(), handle_udp_service(), handle_validation_response(), handshake_ack_monotime_cb(), handshake_monotime_cb(), hello_add_iter(), hello_iter_cb(), host_processor(), hosts_directory_scan_callback(), ifc_broadcast(), init_peer_cb(), insert_in_sampler(), keygen_round1_new_element(), keygen_round2_new_element(), learn_dv_path(), main_init(), monitor_cb(), monitor_notify_connect(), monitor_notify_disconnect(), mq_error(), mq_init(), mq_online_check_successful(), mq_send_impl(), neighbour_delete(), new_channel(), new_service_channel(), notify_client_connect_info(), notify_connect(), notify_disconnect(), operation_timeout(), pass_plaintext_to_core(), path_callback(), peer_destroy(), print_channel_destination(), print_info(), print_peer_list(), print_plugin_event_info(), process_migration_content(), process_notify(), process_peer_iteration_cb(), process_peer_string(), process_peerinfo_peers(), proto_read_kx(), queue_destroy(), queue_send_msg(), receiver_destroy(), rekey_monotime_cb(), reliability_box_message(), rem_from_list(), requester_callback(), reschedule_hellos(), reset_cadet(), result_processor(), route_control_message_without_fc(), route_message(), route_packet(), route_via_neighbour(), RPS_sampler_elem_next(), run(), schedule_next_hello(), schedule_transmit_on_queue(), select_peer(), select_write_cb(), send_broken(), send_enter_room(), send_keep_alive(), send_key(), send_message(), send_msg_from_cache(), send_pull_reply(), send_pull_request(), send_push(), set_peer_online(), sock_read(), start_address_validation(), start_cb(), stop_peer_run(), suggest_to_connect(), tokenized_cb(), transmit_cummulative_ack_cb(), transmit_on_queue(), transmit_pending(), transmit_task_cb(), transmit_typemap_task(), try_transmission(), valid_peers_iterator(), and validation_transmit_on_queue().

Here is the call graph for this function:

◆ GNUNET_i2s2()

const char * GNUNET_i2s2 ( const struct GNUNET_PeerIdentity pid)

Convert a peer identity to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant! Identical to GNUNET_i2s(), except that another buffer is used so both GNUNET_i2s() and GNUNET_i2s2() can be used within the same log statement.

Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s().

Identical to GNUNET_i2s(), except that another buffer is used so both GNUNET_i2s() and GNUNET_i2s2() can be used within the same log statement.

Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s.

Definition at line 1332 of file common_logging.c.

1333{
1334 static GNUNET_THREAD_LOCAL char buf[5];
1335 char *ret;
1336
1337 if (NULL == pid)
1338 return "NULL";
1340 GNUNET_strlcpy (buf, ret, sizeof(buf));
1341 GNUNET_free (ret);
1342 return buf;
1343}

References GNUNET_CRYPTO_eddsa_public_key_to_string(), GNUNET_free, GNUNET_strlcpy(), GNUNET_THREAD_LOCAL, pid, GNUNET_PeerIdentity::public_key, and ret.

Referenced by derive_aes_key(), destroy_route(), forward_dv_learn(), handle_dv_box(), handle_ping(), send_broken(), and send_msg_from_cache().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_i2s_full()

const char * GNUNET_i2s_full ( const struct GNUNET_PeerIdentity pid)

Convert a peer identity to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s_full().
Parameters
pidthe peer identity
Returns
string form of the pid; will be overwritten by next call to GNUNET_i2s_full.

Definition at line 1354 of file common_logging.c.

1355{
1356 static GNUNET_THREAD_LOCAL char buf[256];
1357 char *ret;
1358
1360 strcpy (buf, ret);
1361 GNUNET_free (ret);
1362 return buf;
1363}

References GNUNET_CRYPTO_eddsa_public_key_to_string(), GNUNET_free, GNUNET_THREAD_LOCAL, pid, GNUNET_PeerIdentity::public_key, and ret.

Referenced by channel_incoming(), consider_ss_ack(), do_round(), enc_notify_cb(), gns_value_to_string(), GNUNET_TRANSPORT_TESTING_start_peer(), handle_ephemeral_key(), hist_update(), mq_init(), on_message(), operation_timeout(), peers_callback(), reply_handle(), restore_valid_peers(), run(), start_peer_run(), store_peer_presistently_iterator(), stream_input_handle(), tunnels_callback(), and view_update_handle().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_a2s()

const char * GNUNET_a2s ( const struct sockaddr *  addr,
socklen_t  addrlen 
)

Convert a "struct sockaddr*" (IPv4 or IPv6 address) to a string (for printing debug messages).

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
addrthe address
addrlenthe length of the addr
Returns
nicely formatted string for the address will be overwritten by next call to GNUNET_a2s().

This is one of the very few calls in the entire API that is NOT reentrant!

Parameters
addrthe address
addrlenthe length of the address in addr
Returns
nicely formatted string for the address will be overwritten by next call to GNUNET_a2s.

Definition at line 1377 of file common_logging.c.

1378{
1379#define LEN \
1380 GNUNET_MAX ((INET6_ADDRSTRLEN + 8), \
1381 (1 + sizeof(struct sockaddr_un) - sizeof(sa_family_t)))
1382 static GNUNET_THREAD_LOCAL char buf[LEN];
1383#undef LEN
1384 static GNUNET_THREAD_LOCAL char b2[6];
1385 const struct sockaddr_in *v4;
1386 const struct sockaddr_un *un;
1387 const struct sockaddr_in6 *v6;
1388 unsigned int off;
1389
1390 if (addr == NULL)
1391 return _ ("unknown address");
1392 switch (addr->sa_family)
1393 {
1394 case AF_INET:
1395 if (addrlen != sizeof(struct sockaddr_in))
1396 return "<invalid v4 address>";
1397 v4 = (const struct sockaddr_in *) addr;
1398 inet_ntop (AF_INET, &v4->sin_addr, buf, INET_ADDRSTRLEN);
1399 if (0 == ntohs (v4->sin_port))
1400 return buf;
1401 strcat (buf, ":");
1402 GNUNET_snprintf (b2, sizeof(b2), "%u", ntohs (v4->sin_port));
1403 strcat (buf, b2);
1404 return buf;
1405
1406 case AF_INET6:
1407 if (addrlen != sizeof(struct sockaddr_in6))
1408 return "<invalid v6 address>";
1409 v6 = (const struct sockaddr_in6 *) addr;
1410 buf[0] = '[';
1411 inet_ntop (AF_INET6, &v6->sin6_addr, &buf[1], INET6_ADDRSTRLEN);
1412 if (0 == ntohs (v6->sin6_port))
1413 return &buf[1];
1414 strcat (buf, "]:");
1415 GNUNET_snprintf (b2, sizeof(b2), "%u", ntohs (v6->sin6_port));
1416 strcat (buf, b2);
1417 return buf;
1418
1419 case AF_UNIX:
1420 if (addrlen <= sizeof(sa_family_t))
1421 return "<unbound UNIX client>";
1422 un = (const struct sockaddr_un *) addr;
1423 off = 0;
1424 if ('\0' == un->sun_path[0])
1425 off++;
1426 memset (buf, 0, sizeof(buf));
1427 GNUNET_snprintf (buf,
1428 sizeof(buf),
1429 "%s%.*s",
1430 (1 == off) ? "@" : "",
1431 (int) (addrlen - sizeof(sa_family_t) - off),
1432 &un->sun_path[off]);
1433 return buf;
1434
1435 default:
1436 return _ ("invalid address");
1437 }
1438}
#define LEN
int GNUNET_snprintf(char *buf, size_t size, const char *format,...) __attribute__((format(printf
Like snprintf, just aborts if the buffer is of insufficient size.

References _, GNUNET_snprintf(), GNUNET_THREAD_LOCAL, and LEN.

Referenced by accept_client(), add_addr(), addr_cb(), address_cb(), check_and_remove_pending_reversal(), create_listen_socket(), create_proto_queue(), free_lal(), get_server_addresses(), GNUNET_NAT_AUTO_test_start(), GNUNET_NAT_test_start(), GNUNET_NETWORK_socket_accept(), GNUNET_NT_scanner_get_type(), handle_request(), handle_response(), iface_proc(), ifc_broadcast(), init_socket(), interface_proc(), mq_init(), mq_send_d(), nat_address_cb(), nat_register(), notify_client(), notify_client_external_ipv4_change(), open_listen_socket(), pending_reversal_timeout(), print_sockaddr(), process_external_ip(), proto_read_kx(), queue_read_kx(), reversal_cb(), run(), run_scan(), send_msg_with_kx(), sock_read(), sockaddr_to_udpaddr_string(), transmit_query(), try_connect_using_address(), try_handle_plaintext(), try_send_tcp(), try_send_udp(), and upnp_addr_change_cb().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_error_type_to_string()

const char * GNUNET_error_type_to_string ( enum GNUNET_ErrorType  kind)

Convert error type to string.

Parameters
kindtype to convert
Returns
string corresponding to the type

Definition at line 1132 of file common_logging.c.

1133{
1134 if ((kind & GNUNET_ERROR_TYPE_ERROR) > 0)
1135 return _ ("ERROR");
1136 if ((kind & GNUNET_ERROR_TYPE_WARNING) > 0)
1137 return _ ("WARNING");
1138 if ((kind & GNUNET_ERROR_TYPE_MESSAGE) > 0)
1139 return _ ("MESSAGE");
1140 if ((kind & GNUNET_ERROR_TYPE_INFO) > 0)
1141 return _ ("INFO");
1142 if ((kind & GNUNET_ERROR_TYPE_DEBUG) > 0)
1143 return _ ("DEBUG");
1144 if ((kind & ~GNUNET_ERROR_TYPE_BULK) == 0)
1145 return _ ("NONE");
1146 return _ ("INVALID");
1147}

References _, GNUNET_ERROR_TYPE_BULK, GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_INFO, GNUNET_ERROR_TYPE_MESSAGE, and GNUNET_ERROR_TYPE_WARNING.

Referenced by output_message(), and run().

Here is the caller graph for this function: