Macros
#define	GNUNET_EXTRA_LOGGING 0
	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,...)
	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...

int	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 0

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

Definition at line 128 of file gnunet_common.h.

Referenced by encapsulate_for_dv(), handle_dv_box(), and handle_dv_learn().

◆ GNUNET_assert

#define GNUNET_assert ( cond )

Value:

do                                                            \
  {                                                             \
    if (! (cond))                                               \
    {                                                           \
      GNUNET_log (GNUNET_ERROR_TYPE_ERROR,                      \
                  _ ("Assertion failed at %s:%d. Aborting.\n"), \
                  __FILE__,                                     \
                  __LINE__);                                    \
      GNUNET_abort_ ();                                         \
    }                                                           \
  } while (0)

Use this for fatal errors that cannot be handled.

Definition at line 859 of file gnunet_common.h.

◆ GNUNET_assert_at

#define GNUNET_assert_at	(	cond,
		f,
		l
	)

Value:

do                                                            \
  {                                                             \
    if (! (cond))                                               \
    {                                                           \
      GNUNET_log (GNUNET_ERROR_TYPE_ERROR,                      \
                  _ ("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 877 of file gnunet_common.h.

Referenced by GNUNET_xfree_(), GNUNET_xgrow_(), GNUNET_xmalloc_(), GNUNET_xmemdup_(), GNUNET_xstrdup_(), and GNUNET_xstrndup_().

◆ GNUNET_assert_from

#define GNUNET_assert_from	(	cond,
		comp
	)

Value:

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

Use this for fatal errors that cannot be handled.

Parameters

cond	Condition to evaluate
comp	Component string to use for logging

Definition at line 898 of file gnunet_common.h.

◆ GNUNET_break

#define GNUNET_break ( cond )

Value:

do                                                  \
  {                                                   \
    if (! (cond))                                     \
    {                                                 \
      GNUNET_log (GNUNET_ERROR_TYPE_ERROR,            \
                  _ ("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 918 of file gnunet_common.h.

◆ GNUNET_break_op

#define GNUNET_break_op ( cond )

Value:

do                                                                      \
  {                                                                       \
    if (! (cond))                                                         \
    {                                                                     \
      GNUNET_log (GNUNET_ERROR_TYPE_WARNING | GNUNET_ERROR_TYPE_BULK,     \
                  _ ("External protocol violation detected at %s:%d.\n"), \
                  __FILE__,                                               \
                  __LINE__);                                              \
    }                                                                     \
  } while (0)

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 940 of file gnunet_common.h.

Referenced by add_revocation(), alice_or_betty(), block_plugin_dht_evaluate(), block_plugin_dns_evaluate(), block_plugin_fs_evaluate(), block_plugin_gns_evaluate(), block_plugin_gns_get_key(), block_plugin_regex_get_key(), block_plugin_revocation_evaluate(), block_plugin_revocation_get_key(), block_plugin_test_evaluate(), cadet_mq_error_handler(), cadet_reply_proc(), cb_intersection_request_alice(), check_advertisement(), check_alice_client_message(), check_alice_client_message_multipart(), check_alices_cryptodata_message(), check_backchannel_encapsulation(), check_barrier_status(), check_bob_client_message(), check_bobs_cryptodata_message(), check_connection_create(), check_dht_p2p_get(), check_dht_p2p_put(), check_dht_p2p_result(), check_dns_request(), check_dv_box(), check_dv_learn(), check_encrypted(), check_fragment_box(), check_hello(), check_icmp_back(), check_icmp_remote(), check_icmp_service(), check_incoming_msg(), check_intersection_p2p_bf(), check_local_data(), check_manage_peer_service(), check_p2p_get(), check_p2p_put(), check_peer_pull_reply(), check_reliability_ack(), check_remote_overlay_connect(), check_request(), check_tcp_back(), check_tcp_data(), check_tcp_remote(), check_tcp_service(), check_udp_back(), check_udp_remote(), check_udp_service(), check_union_p2p_demand(), check_union_p2p_elements(), check_union_p2p_full_element(), check_union_p2p_ibf(), check_union_p2p_inquiry(), check_union_p2p_offer(), compute_service_response(), conversation_value_to_string(), core_mq_error_handler(), datacache_get_iterator(), decrypted_error_cb(), dns_result_parser(), dns_value_to_string(), do_decrypt(), do_s5r_read(), enc_notify_cb(), encrypt_existing_match(), evaluate_block_regex(), evaluate_block_regex_accept(), forward_reply(), fragment_msg_proc(), GCC_create_inbound(), GCCH_handle_channel_open_ack(), GCCH_handle_channel_plaintext_data_ack(), GCT_handle_encrypted(), GCT_handle_kx(), GCT_handle_kx_auth(), get_hello_address_size(), gns_value_to_string(), GNUNET_BLOCK_is_accepting(), GNUNET_CONTAINER_meta_data_deserialize(), GNUNET_CRYPTO_paillier_encrypt(), GNUNET_CRYPTO_paillier_encrypt1(), GNUNET_CRYPTO_paillier_hom_add(), GNUNET_CRYPTO_rsa_private_key_get_public(), GNUNET_CRYPTO_rsa_public_key_decode(), GNUNET_CRYPTO_rsa_signature_decode(), GNUNET_CRYPTO_rsa_unblind(), GNUNET_CRYPTO_rsa_verify(), GNUNET_DEFRAGMENT_process_fragment(), GNUNET_DNSPARSER_parse(), GNUNET_DNSPARSER_parse_cert(), GNUNET_DNSPARSER_parse_mx(), GNUNET_DNSPARSER_parse_query(), GNUNET_DNSPARSER_parse_record(), GNUNET_DNSPARSER_parse_soa(), GNUNET_FRAGMENT_process_ack(), GNUNET_GNSRECORD_block_decrypt(), GNUNET_GNSRECORD_records_deserialize(), GNUNET_GNSRECORD_records_get_size(), GNUNET_GNSRECORD_records_serialize(), GNUNET_HELLO_extract_address(), GNUNET_HELLO_iterate_addresses(), GNUNET_MQ_extract_nested_mh_(), GNUNET_MST_from_buffer(), GNUNET_SERVER_inject(), GNUNET_SERVER_mst_receive(), GNUNET_TESTBED_extract_config_(), GSC_SESSIONS_confirm_typemap(), GSC_SESSIONS_set_typemap(), GSC_TYPEMAP_get_from_message(), GST_neighbours_handle_disconnect_message(), GST_neighbours_handle_quota_message(), GST_neighbours_handle_session_ack(), GST_neighbours_handle_session_syn(), GST_neighbours_handle_session_syn_ack(), GST_neighbours_keepalive(), GST_neighbours_keepalive_response(), GST_receive_callback(), GST_validation_handle_hello(), GST_validation_handle_ping(), GST_validation_handle_pong(), handle_add_host(), handle_add_queue_message(), handle_barrier_cancel(), handle_barrier_init(), handle_barrier_status(), handle_bobs_cryptodata_message(), handle_cadet_hangup_message(), handle_cadet_pickup_message(), handle_cadet_ring_message(), handle_cadet_suspend_message(), handle_call_resume(), handle_call_suspend(), handle_client_pickup_message(), handle_connection_broken(), handle_connection_create(), handle_connection_create_ack(), handle_connection_destroy(), handle_dht_p2p_get(), handle_dht_p2p_put(), handle_dht_p2p_result(), handle_dht_response(), handle_dns_request(), handle_dv_box(), handle_dv_learn(), handle_encrypted(), handle_ephemeral_key(), handle_fragment_box(), handle_gns2dns_result(), handle_gns_resolution_result(), handle_gns_response(), handle_gns_result(), handle_icmp_back(), handle_icmp_remote(), handle_icmp_service(), handle_inbound_channel(), handle_intersection_p2p_bf(), handle_intersection_p2p_done(), handle_intersection_p2p_element_info(), handle_link_controllers(), handle_namecache_block_response(), handle_p2p_estimate(), handle_p2p_put(), handle_p2p_revoke(), handle_peer_pull_reply(), handle_peer_pull_request(), handle_peer_push(), handle_phone_audio(), handle_phone_resume(), handle_phone_suspend(), handle_ping(), handle_pong(), handle_raw_message(), handle_reply(), handle_request_connection_reversal(), handle_revocation_union_request(), handle_revoke_message(), handle_status(), handle_tcp_data(), handle_tcp_nat_probe(), handle_tcp_remote(), handle_tcp_service(), handle_tcp_welcome(), handle_tunnel_encrypted(), handle_tunnel_kx(), handle_tunnel_kx_auth(), handle_udp_remote(), handle_union_p2p_demand(), handle_union_p2p_done(), handle_union_p2p_elements(), handle_union_p2p_full_done(), handle_union_p2p_full_element(), handle_union_p2p_ibf(), handle_union_p2p_request_full(), handle_validation_challenge(), handle_validation_response(), inflate_data(), match_full_data(), mq_init(), parse_abs_time(), parse_abs_time_nbo(), parse_boolean(), parse_fixed_data(), parse_name(), parse_object(), parse_rel_time(), parse_rsa_public_key(), parse_rsa_signature(), parse_string(), parse_u16(), parse_u32(), parse_u64(), parse_u8(), parse_variable_data(), peer_mq_error_handler(), process_bf(), process_data(), process_kblock(), process_kblock_for_unindex(), process_ksk_result(), process_sblock(), process_udp_message(), publicize_rm(), read_process_ack(), read_task(), recursive_cname_resolution(), recursive_gns2dns_resolution(), recursive_pkey_resolution(), REGEX_BLOCK_check(), REGEX_BLOCK_get_key(), REGEX_BLOCK_iterate(), reply_to_dns(), route_packet(), select_read_cb(), set_listen_cb(), set_result_cb(), sock_read(), store_ax_keys(), strata_estimator_read(), task_start_apply_round(), tcp_plugin_check_address(), try_handle_plaintext(), try_match_block(), udp_address_to_string(), udp_plugin_address_pretty_printer(), udp_plugin_check_address(), udp_plugin_get_session(), udp_select_read(), unix_plugin_do_read(), update_ax_by_kx(), validate_dv_initiator_signature(), verify_message_crypto(), verify_revoke_message(), wbarrier_status_cb(), and wlan_plugin_address_suggested().

◆ GNUNET_log_strerror

#define GNUNET_log_strerror	(	level,
		cmd
	)

Value:

do                                                         \
  {                                                          \
    GNUNET_log (level,                                       \
                _ ("`%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 959 of file gnunet_common.h.

Referenced by accept_client(), automaton_create_proofs(), bi_destroy(), child_death_task(), create_listen_socket(), database_setup(), decrementBit(), dfa_merge_nondistinguishable_states(), dht_connected(), do_accept(), do_dns_read(), do_send(), get_server_addresses(), GN_request_connection_reversal(), GN_stop_gnunet_nat_server_(), GNUNET_CONTAINER_bloomfilter_load(), GNUNET_FRIENDS_parse(), GNUNET_FS_directory_builder_finish(), GNUNET_MST_read(), GNUNET_NETWORK_test_pf(), GNUNET_NETWORK_unix_precheck(), GST_stats_init(), handle_data(), handle_stop(), iface_proc(), ifc_broadcast(), listen_cb(), load_keys(), main(), mq_send(), netint_proc(), open_dev_null(), proto_read_kx(), publicize_rm(), queue_read(), queue_read_kx(), queue_write(), read_dns4(), read_dns6(), RECLAIM_TICKETS_init(), restart_nat_server(), run(), select_read_cb(), select_write_cb(), send_response(), server_check_ipv6_support(), setup_service(), setup_sockets(), shutdown_task(), sock_read(), stop_broadcast(), stun_dns_callback(), tcp_plugin_address_to_string(), tcp_plugin_get_session(), tcp_send(), test_stun(), try_connect_using_address(), try_send_tcp(), try_send_udp(), udp_ipv4_broadcast_send(), udp_ipv6_broadcast_send(), unix_plugin_do_read(), unix_real_send(), unix_transport_server_start(), updateUsage(), and write_data().

◆ GNUNET_log_from_strerror

#define GNUNET_log_from_strerror	(	level,
		component,
		cmd
	)

Value:

do                                                              \
  {                                                               \
    GNUNET_log_from (level,                                       \
                     component,                                   \
                     _ ("`%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 977 of file gnunet_common.h.

Referenced by get_my_cnf_path(), and nat_server_read().

◆ GNUNET_log_strerror_file

#define GNUNET_log_strerror_file	(	level,
		cmd,
		filename
	)

Value:

do                                                                      \
  {                                                                       \
    GNUNET_log (level,                                                    \
                _ ("`%s' failed on file `%s' at %s:%d with error: %s\n"), \
                cmd,                                                      \
                filename,                                                 \
                __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 996 of file gnunet_common.h.

Referenced by access_handler_callback(), calculate_pow(), cleanup(), deserialize_download_file(), deserialize_file_information(), deserialize_publish_file(), deserialize_search_file(), determine_id(), discard_hosts_helper(), dump_my_hello(), full_recursive_download(), get_server_addresses(), GNUNET_ATS_TEST_logging_write_to_file(), GNUNET_DISK_file_backup(), GNUNET_DISK_file_copy(), GNUNET_DISK_fix_permissions(), GNUNET_FRIENDS_parse(), GNUNET_FS_download_stop(), GNUNET_FS_download_sync_(), GNUNET_FS_file_information_create_from_file(), GNUNET_FS_file_information_destroy(), GNUNET_FS_file_information_sync_(), GNUNET_FS_remove_sync_dir_(), GNUNET_FS_remove_sync_file_(), GNUNET_HOSTLIST_client_start(), GNUNET_NETWORK_socket_close(), GNUNET_NETWORK_unix_precheck(), GST_stats_init(), handle_create_message(), handle_delete_message(), handle_rename_message(), hostkeys_load(), LEGACY_SERVICE_get_server_addresses(), libgnunet_plugin_datastore_sqlite_done(), load(), load_keys(), main(), open_dev_null(), print_key(), process_result_with_request(), purge_cfg_dir(), read_host_file(), reconstruct_cb(), remove_garbage(), remove_sync_file_in_dir(), removecerts(), run(), save(), setup_log_file(), shutdown_task(), sync_rd(), try_match_block(), try_top_down_reconstruction(), update_hello(), updateUsage(), and write_proof().

◆ GNUNET_log_from_strerror_file

#define GNUNET_log_from_strerror_file	(	level,
		component,
		cmd,
		filename
	)

Value:

do                                                                           \
  {                                                                            \
    GNUNET_log_from (level,                                                    \
                     component,                                                \
                     _ ("`%s' failed on file `%s' at %s:%d with error: %s\n"), \
                     cmd,                                                      \
                     filename,                                                 \
                     __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 1015 of file gnunet_common.h.

Referenced by GNUNET_DATACACHE_destroy().

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

cls	closure
kind	severeity
component	what component is issuing the message?
date	when was the message logged?
message	what is the message

Definition at line 428 of file gnunet_common.h.

Enumeration Type Documentation

◆ GNUNET_ErrorType

enum 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 401 of file gnunet_common.h.

 {
   GNUNET_ERROR_TYPE_UNSPECIFIED = -1,
   GNUNET_ERROR_TYPE_NONE = 0,
   GNUNET_ERROR_TYPE_ERROR = 1,
   GNUNET_ERROR_TYPE_WARNING = 2,
   /* UX: We need a message type that is output by
    * default without looking like there is a problem.
    */
   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
 };

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 967 of file common_logging.c.

References skip_log.

 {
   return skip_log;
 }

◆ GNUNET_log_nocheck()

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

Main log function.

Parameters

kind	how serious is the error?
message	what 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

kind	how serious is the error?
comp	component responsible for generating the message
message	what is the message (format string)
...	arguments for format string

Definition at line 1123 of file common_logging.c.

References component_nopid, GNUNET_snprintf(), and mylog().

 {
   va_list va;
   char comp_w_pid[128];
 
   if (comp == NULL)
     comp = component_nopid;
 
   va_start (va, message);
   GNUNET_snprintf (comp_w_pid, sizeof (comp_w_pid), "%s-%d", comp, getpid ());
   mylog (kind, comp_w_pid, message, va);
   va_end (va);
 }

Here is the call 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

kind	log level
section	section with missing option
option	name of missing option

Definition at line 1502 of file common_logging.c.

References _, and GNUNET_log.

Referenced by database_setup(), get_bootstrap_server(), get_quota(), get_update_information_directory(), GNUNET_CONVERSATION_phone_create(), GNUNET_DATACACHE_create(), GNUNET_FRIENDS_parse(), GNUNET_FRIENDS_write_start(), GNUNET_RPS_connect(), GNUNET_TESTBED_run(), GSF_pending_request_init_(), LIBGNUNET_PLUGIN_TRANSPORT_INIT(), libgnunet_plugin_transport_tcp_init(), libgnunet_plugin_transport_unix_init(), load(), load_hostlist_file(), logger_run(), new_sub(), purge_cfg_dir(), read_index_list(), run(), save(), save_hostlist_file(), server_log(), setup_exit_helper_args(), start_arm_service(), and write_index_list().

 {
   GNUNET_log (kind,
               _ (
                 "Configuration fails to specify option `%s' in section `%s'!\n"),
               option,
               section);
 }

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

kind	log level
section	section with invalid option
option	name of invalid option
required	what is required that is invalid about the option

Definition at line 1523 of file common_logging.c.

References _, and GNUNET_log.

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

 {
   GNUNET_log (
     kind,
     _ (
       "Configuration specifies invalid value for option `%s' in section `%s': %s\n"),
     option,
     section,
     required);
 }

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 287 of file common_logging.c.

Referenced by __attribute__().

 {
 #if WINDOWS
   DebugBreak ();
 #endif
   abort ();
 }

Here is the caller graph for this function:

◆ GNUNET_log_skip()

void GNUNET_log_skip	(	int	n,
		int	check_reset
	)

Ignore the next n calls to the log function.

Parameters

n	number of log calls to ignore (could be negative)
check_reset	GNUNET_YES to assert that the log skip counter is currently zero

Ignore the next n calls to the log function.

Parameters

n	number of log calls to ignore (could be negative)
check_reset	GNUNET_YES to assert that the log skip counter is currently zero

Definition at line 943 of file common_logging.c.

References GNUNET_break, ok, and skip_log.

 {
   int ok;
 
   if (0 == n)
   {
     ok = (0 == skip_log);
     skip_log = 0;
     if (check_reset)
       GNUNET_break (ok);
   }
   else
   {
     skip_log += n;
   }
 }

◆ GNUNET_log_setup()

int GNUNET_log_setup	(	const char *	comp,
		const char *	loglevel,
		const char *	logfile
	)

Setup logging.

Parameters

comp	default component to use
loglevel	what types of messages should be logged
logfile	change logging to logfile (use NULL to keep stderr)

Returns: GNUNET_OK on success, GNUNET_SYSERR if logfile could not be opened

Parameters

comp	default component to use
loglevel	what types of messages should be logged
logfile	which file to write log messages to (can be NULL)

Returns: GNUNET_OK on success

Definition at line 715 of file common_logging.c.

References get_type(), getenv(), GNUNET_asprintf(), GNUNET_assert, GNUNET_free_non_null, GNUNET_OK, GNUNET_strdup, GNUNET_STRINGS_filename_expand(), GNUNET_SYSERR, parse_all_definitions(), setup_log_file(), and t.

Referenced by get_app(), GNUNET_PROGRAM_run2(), GNUNET_SERVICE_run_(), GNUNET_TESTING_service_run(), GNUNET_TRANSPORT_TESTING_main_(), LEGACY_SERVICE_run(), main(), run(), test_master(), and testbed_run().

 {
   const char *env_logfile;
 
   min_level = get_type (loglevel);
 #if ! defined(GNUNET_CULL_LOGGING)
   parse_all_definitions ();
 #endif
 #ifdef WINDOWS
   QueryPerformanceFrequency (&performance_frequency);
 #endif
   GNUNET_free_non_null (component);
   GNUNET_asprintf (&component, "%s-%d", comp, getpid ());
   GNUNET_free_non_null (component_nopid);
   component_nopid = GNUNET_strdup (comp);
 
   env_logfile = getenv ("GNUNET_FORCE_LOGFILE");
   if ((NULL != env_logfile) && (strlen (env_logfile) > 0))
     logfile = env_logfile;
   if (NULL == logfile)
     return GNUNET_OK;
   GNUNET_free_non_null (log_file_name);
   log_file_name = GNUNET_STRINGS_filename_expand (logfile);
   if (NULL == log_file_name)
     return GNUNET_SYSERR;
 #if TALER_WALLET_ONLY || defined(GNUNET_CULL_LOGGING)
   /* log file option not allowed for wallet logic */
   GNUNET_assert (NULL == logfile);
   return GNUNET_OK;
 #else
   {
     time_t t;
     const struct tm *tm;
 
     t = time (NULL);
     tm = gmtime (&t);
     return setup_log_file (tm);
   }
 #endif
 }

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

logger	log function
logger_cls	closure for logger

Definition at line 767 of file common_logging.c.

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

 {
   struct CustomLogger *entry;
 
   entry = GNUNET_new (struct CustomLogger);
   entry->logger = logger;
   entry->logger_cls = logger_cls;
   entry->next = loggers;
   loggers = entry;
 }

◆ GNUNET_logger_remove()

void GNUNET_logger_remove	(	GNUNET_Logger	logger,
		void *	logger_cls
	)

Remove a custom logger.

Parameters

logger	log function
logger_cls	closure for logger

Definition at line 786 of file common_logging.c.

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

 {
   struct CustomLogger *pos;
   struct CustomLogger *prev;
 
   prev = NULL;
   pos = loggers;
   while ((NULL != pos) &&
          ((pos->logger != logger) || (pos->logger_cls != logger_cls)))
   {
     prev = pos;
     pos = pos->next;
   }
   GNUNET_assert (NULL != pos);
   if (NULL == prev)
     loggers = pos->next;
   else
     prev->next = pos->next;
   GNUNET_free (pos);
 }

◆ 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

shc	the hash code

Returns: string

Definition at line 1302 of file common_logging.c.

References buf, and GNUNET_STRINGS_data_to_string().

Referenced by destroy_route(), discard_all_from_rung_tail(), dv_setup_key_state_from_km(), GCC_2s(), GCC_handle_kx(), GCC_handle_kx_auth(), handle_connection_broken(), handle_connection_create(), handle_connection_create_ack(), handle_connection_destroy(), handle_tunnel_kx(), handle_validation_challenge(), handle_validation_response(), mqm_execute(), route_message(), send_broken(), send_kx(), send_kx_auth(), start_address_validation(), start_dv_learn(), and validation_transmit_on_queue().

 {
   static char buf[64];
 
   GNUNET_STRINGS_data_to_string (shc, sizeof (*shc), buf, sizeof (buf));
   buf[6] = '\0';
   return (const char *) buf;
 }

Here is the call graph for this function:

Here is the caller 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

uuid the UUID

Returns: string

Definition at line 1322 of file common_logging.c.

References buf, and GNUNET_STRINGS_data_to_string().

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

 {
   static char buf[32];
 
   GNUNET_STRINGS_data_to_string (uuid, sizeof (*uuid), buf, sizeof (buf));
   buf[6] = '\0';
   return (const char *) buf;
 }

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

hc	the hash code

Returns: string

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

Parameters

hc	the hash code

Returns: string form; will be overwritten by next call to GNUNET_h2s.

Definition at line 1173 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash_to_enc(), and GNUNET_THREAD_LOCAL.

Referenced by add_get_request_to_pending(), advertise_dns_exit(), block_proc(), cb_channel_destruction(), cb_intersection_element_removed(), check_edge(), clean_request(), client_release_ports(), client_request_complete_alice(), client_response_handler(), create_channel_to_destination(), datacache_get_iterator(), delayed_get(), delayed_put(), derive_aes_key(), derive_auth_key(), derive_iv(), derive_pong_iv(), dht_get_string_accept_handler(), dht_get_string_handler(), diffname(), do_rekey(), dv_setup_key_state_from_km(), env_delete_notify(), execute_add(), execute_select(), expired_processor(), filter_all(), filtered_map_initialization(), forward_reply(), GCCH_2s(), GCCH_bind(), GCCH_channel_incoming_new(), GCCH_channel_local_new(), GCCH_hash_port(), GDS_CLIENTS_handle_reply(), GDS_DATACACHE_handle_get(), GDS_DATACACHE_handle_put(), GDS_NEIGHBOURS_handle_get(), GDS_NEIGHBOURS_handle_put(), GDS_NEIGHBOURS_handle_reply(), get_target_peers(), 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(), 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_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_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_p2p_result(), handle_dht_reply(), handle_encrypted(), handle_ephemeral_key(), handle_get_key(), handle_icmp_service(), handle_incoming_msg(), handle_local_result(), 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_remove(), handle_reply(), handle_request(), handle_tcp_service(), handle_udp_service(), handle_union_p2p_demand(), handle_union_p2p_elements(), handle_union_p2p_full_element(), handle_union_p2p_offer(), hash_for_index_cb(), hash_for_index_val(), initialize_map_unfiltered(), iterate_initial_edge(), iterator_bf_create(), iterator_bf_reduce(), load_state(), lookup_task(), mysql_plugin_put(), mysql_plugin_remove_key(), namecache_sqlite_cache_block(), new_element_cb(), perform_dht_put(), plan(), postgres_plugin_get_random(), 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(), 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(), requester_callback(), responder_callback(), route_packet(), run(), schedule_block_download(), select_peer(), send_full_element_iterator(), send_key(), send_offers_iterator(), send_remaining_elements(), set_result_cb(), sqlite_plugin_get(), sqlite_plugin_get_closest(), sqlite_plugin_get_random(), 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(), and write_item().

 {
   static GNUNET_THREAD_LOCAL struct GNUNET_CRYPTO_HashAsciiEncoded ret;
 
   GNUNET_CRYPTO_hash_to_enc (hc, &ret);
   ret.encoding[8] = '\0';
   return (const char *) ret.encoding;
 }

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

hc	the 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

hc	the hash code

Returns: string form; will be overwritten by next call to GNUNET_h2s.

Definition at line 1194 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, and GNUNET_CRYPTO_hash_to_enc().

Referenced by GSC_KX_encrypt_and_transmit(), and handle_encrypted().

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
 
   GNUNET_CRYPTO_hash_to_enc (hc, &ret);
   ret.encoding[8] = '\0';
   return (const char *) ret.encoding;
 }

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

hc	the 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

hc	the hash code

Returns: string form; will be overwritten by next call to GNUNET_h2s_full.

Definition at line 1341 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash_to_enc(), and ret.

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

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
 
   GNUNET_CRYPTO_hash_to_enc (hc, &ret);
   ret.encoding[sizeof (ret) - 1] = '\0';
   return (const char *) ret.encoding;
 }

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

hc	the hash code

Returns: string

Definition at line 1214 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash(), and GNUNET_CRYPTO_hash_to_enc().

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
   struct GNUNET_HashCode hc;
 
   GNUNET_CRYPTO_hash (p, sizeof (*p), &hc);
   GNUNET_CRYPTO_hash_to_enc (&hc, &ret);
   ret.encoding[6] = '\0';
   return (const char *) ret.encoding;
 }

Here is the call 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

hc	the hash code

Returns: string

Definition at line 1236 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash(), and GNUNET_CRYPTO_hash_to_enc().

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
   struct GNUNET_HashCode hc;
 
   GNUNET_CRYPTO_hash (p, sizeof (*p), &hc);
   GNUNET_CRYPTO_hash_to_enc (&hc, &ret);
   ret.encoding[6] = '\0';
   return (const char *) ret.encoding;
 }

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

hc	the hash code

Returns: string

Definition at line 1258 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash(), and GNUNET_CRYPTO_hash_to_enc().

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

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
   struct GNUNET_HashCode hc;
 
   GNUNET_CRYPTO_hash (p, sizeof (*p), &hc);
   GNUNET_CRYPTO_hash_to_enc (&hc, &ret);
   ret.encoding[6] = '\0';
   return (const char *) ret.encoding;
 }

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

hc	the hash code

Returns: string

Definition at line 1280 of file common_logging.c.

References GNUNET_CRYPTO_HashAsciiEncoded::encoding, GNUNET_CRYPTO_hash(), and GNUNET_CRYPTO_hash_to_enc().

 {
   static struct GNUNET_CRYPTO_HashAsciiEncoded ret;
   struct GNUNET_HashCode hc;
 
   GNUNET_CRYPTO_hash (p, sizeof (*p), &hc);
   GNUNET_CRYPTO_hash_to_enc (&hc, &ret);
   ret.encoding[6] = '\0';
   return (const char *) ret.encoding;
 }

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

pid	the peer identity

Returns: string form of the pid; will be overwritten by next call to GNUNET_i2s().

Parameters

pid	the peer identity

Returns: string form of the pid; will be overwritten by next call to GNUNET_i2s.

Definition at line 1359 of file common_logging.c.

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

 {
   static GNUNET_THREAD_LOCAL char buf[5];
   char *ret;
 
   if (NULL == pid)
     return "NULL";
   ret = GNUNET_CRYPTO_eddsa_public_key_to_string (&pid->public_key);
   GNUNET_strlcpy (buf, ret, sizeof (buf));
   GNUNET_free (ret);
   return buf;
 }

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

pid	the 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

pid	the peer identity

Returns: string form of the pid; will be overwritten by next call to GNUNET_i2s.

Definition at line 1384 of file common_logging.c.

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

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

 {
   static GNUNET_THREAD_LOCAL char buf[5];
   char *ret;
 
   if (NULL == pid)
     return "NULL";
   ret = GNUNET_CRYPTO_eddsa_public_key_to_string (&pid->public_key);
   GNUNET_strlcpy (buf, ret, sizeof (buf));
   GNUNET_free (ret);
   return buf;
 }

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

pid	the peer identity

Returns: string form of the pid; will be overwritten by next call to GNUNET_i2s_full().

Parameters

pid	the peer identity

Returns: string form of the pid; will be overwritten by next call to GNUNET_i2s_full.

Definition at line 1406 of file common_logging.c.

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

Referenced by channel_incoming(), client_connect(), do_round(), dump_pc(), get_host_filename(), get_idx_of_pid(), gns_value_to_string(), GNUNET_TRANSPORT_TESTING_start_peer(), GST_validation_handle_ping(), handle_ephemeral_key(), hist_update(), info_cb(), operation_timeout(), peers_callback(), print_peer_info(), profiler_reply_handle(), profiler_reply_handle_info(), read_blacklist_configuration(), reply_handle(), restore_valid_peers(), run(), server_configure_plugin(), server_parse_url(), state_machine(), store_peer_presistently_iterator(), stream_input_handle(), tunnels_callback(), and view_update_handle().

 {
   static GNUNET_THREAD_LOCAL char buf[256];
   char *ret;
 
   ret = GNUNET_CRYPTO_eddsa_public_key_to_string (&pid->public_key);
   strcpy (buf, ret);
   GNUNET_free (ret);
   return buf;
 }

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

addr	the address
addrlen	the 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

addr	the address
addrlen	the 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 1429 of file common_logging.c.

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

Referenced by accept_client(), addr_cb(), address_cb(), analyze_send_error(), boot_queue(), check_access(), connect_success_continuation(), create_listen_socket(), free_lal(), get_server_addresses(), GNUNET_CONNECTION_connect_socket(), GNUNET_CONNECTION_create_from_accept(), GNUNET_NAT_AUTO_test_start(), GNUNET_NAT_test_start(), GNUNET_NETWORK_socket_accept(), GNUNET_NT_scanner_get_type(), handle_request(), handle_response(), handle_tcp_data(), handle_tcp_nat_probe(), handle_tcp_welcome(), http_common_address_from_socket(), http_common_dns_ip_lookup_cb(), iface_proc(), interface_proc(), LEGACY_SERVICE_get_server_addresses(), libgnunet_plugin_transport_tcp_init(), nat_address_cb(), notify_client(), notify_client_external_ipv4_change(), open_listen_socket(), print_sockaddr(), process_external_ip(), process_incoming(), proto_read_kx(), queue_read_kx(), receive_ready(), reversal_cb(), run(), run_scan(), server_accept_cb(), server_get_addresses(), server_nat_port_map_callback(), service_task(), setup_sockets(), sockaddr_to_udpaddr_string(), tcp_nat_port_map_callback(), tcp_plugin_get_session(), transmit_query(), transmit_ready(), transmit_timeout(), try_connect_using_address(), try_send_tcp(), try_send_udp(), udp_ipv4_broadcast_send(), udp_ipv6_broadcast_send(), udp_nat_port_map_callback(), udp_select_read(), udp_select_send(), unix_real_send(), and upnp_addr_change_cb().

 {
 #ifndef WINDOWS
 #define LEN                           \
   GNUNET_MAX ((INET6_ADDRSTRLEN + 8), \
               (1 + sizeof (struct sockaddr_un) - sizeof (sa_family_t)))
 #else
 #define LEN (INET6_ADDRSTRLEN + 8)
 #endif
   static char buf[LEN];
 #undef LEN
   static char b2[6];
   const struct sockaddr_in *v4;
   const struct sockaddr_un *un;
   const struct sockaddr_in6 *v6;
   unsigned int off;
 
   if (addr == NULL)
     return _ ("unknown address");
   switch (addr->sa_family)
   {
   case AF_INET:
     if (addrlen != sizeof (struct sockaddr_in))
       return "<invalid v4 address>";
     v4 = (const struct sockaddr_in *) addr;
     inet_ntop (AF_INET, &v4->sin_addr, buf, INET_ADDRSTRLEN);
     if (0 == ntohs (v4->sin_port))
       return buf;
     strcat (buf, ":");
     GNUNET_snprintf (b2, sizeof (b2), "%u", ntohs (v4->sin_port));
     strcat (buf, b2);
     return buf;
   case AF_INET6:
     if (addrlen != sizeof (struct sockaddr_in6))
       return "<invalid v4 address>";
     v6 = (const struct sockaddr_in6 *) addr;
     buf[0] = '[';
     inet_ntop (AF_INET6, &v6->sin6_addr, &buf[1], INET6_ADDRSTRLEN);
     if (0 == ntohs (v6->sin6_port))
       return &buf[1];
     strcat (buf, "]:");
     GNUNET_snprintf (b2, sizeof (b2), "%u", ntohs (v6->sin6_port));
     strcat (buf, b2);
     return buf;
   case AF_UNIX:
     if (addrlen <= sizeof (sa_family_t))
       return "<unbound UNIX client>";
     un = (const struct sockaddr_un *) addr;
     off = 0;
     if ('\0' == un->sun_path[0])
       off++;
     memset (buf, 0, sizeof (buf));
     GNUNET_snprintf (buf,
                      sizeof (buf),
                      "%s%.*s",
                      (1 == off) ? "@" : "",
                      (int) (addrlen - sizeof (sa_family_t) - off),
                      &un->sun_path[off]);
     return buf;
   default:
     return _ ("invalid address");
   }
 }

Here is the call 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

kind	type to convert

Returns: string corresponding to the type

Definition at line 1148 of file common_logging.c.

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().

 {
   if ((kind & GNUNET_ERROR_TYPE_ERROR) > 0)
     return _ ("ERROR");
   if ((kind & GNUNET_ERROR_TYPE_WARNING) > 0)
     return _ ("WARNING");
   if ((kind & GNUNET_ERROR_TYPE_MESSAGE) > 0)
     return _ ("MESSAGE");
   if ((kind & GNUNET_ERROR_TYPE_INFO) > 0)
     return _ ("INFO");
   if ((kind & GNUNET_ERROR_TYPE_DEBUG) > 0)
     return _ ("DEBUG");
   if ((kind & ~GNUNET_ERROR_TYPE_BULK) == 0)
     return _ ("NONE");
   return _ ("INVALID");
 }

Here is the caller graph for this function:

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ GNUNET_EXTRA_LOGGING

◆ GNUNET_assert

◆ GNUNET_assert_at

◆ GNUNET_assert_from

◆ GNUNET_break

◆ GNUNET_break_op

◆ GNUNET_log_strerror

◆ GNUNET_log_from_strerror

◆ GNUNET_log_strerror_file

◆ GNUNET_log_from_strerror_file

Typedef Documentation

◆ GNUNET_Logger

Enumeration Type Documentation

◆ GNUNET_ErrorType

Function Documentation

◆ GNUNET_get_log_skip()

◆ GNUNET_log_nocheck()

◆ GNUNET_log_from_nocheck()

◆ GNUNET_log_config_missing()

◆ GNUNET_log_config_invalid()

◆ GNUNET_abort_()

◆ GNUNET_log_skip()

◆ GNUNET_log_setup()

◆ GNUNET_logger_add()

◆ GNUNET_logger_remove()

◆ GNUNET_sh2s()

◆ GNUNET_uuid2s()

◆ GNUNET_h2s()

◆ GNUNET_h2s2()

◆ GNUNET_h2s_full()

◆ GNUNET_p2s()

◆ GNUNET_p2s2()

◆ GNUNET_e2s()

◆ GNUNET_e2s2()

◆ GNUNET_i2s()

◆ GNUNET_i2s2()

◆ GNUNET_i2s_full()

◆ GNUNET_a2s()

◆ GNUNET_error_type_to_string()