Core service; the main API for encrypted P2P communications. More...

#include "gnunet_util_lib.h"

Include dependency graph for gnunet_core_service.h:

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

Data Structures
struct	GNUNET_CORE_ServiceVersion
	A gnunet service version for services above CORE TODO we might want to be compatible with https://semver.org. More...

struct	GNUNET_CORE_ServiceInfo
	Gnunet service info - identifying compatibility with a range of version of a service communicating over CORE. More...

struct	EphemeralKeyMessage
	Message transmitted with the signed ephemeral key of a peer. More...

struct	PingMessage
	We're sending an (encrypted) PING to the other peer to check if it can decrypt. More...

struct	PongMessage
	Response to a PING. More...

Macros
#define	GNUNET_CORE_SVC_INFO_LEN 64
	Size of the services info field in the cake handshake TODO.

#define	GNUNET_CORE_VERSION 0x00000001
	Version number of GNUnet-core API.

#define	CONG_CRYPTO_ENABLED 0
	Enable XChaCha20-Poly1305 crypto https://bugs.gnunet.org/view.php?id=8630.

Typedefs
typedef void (	GNUNET_CORE_ConnectEventHandler) (void cls, const struct GNUNET_PeerIdentity peer, struct GNUNET_MQ_Handle *mq, enum GNUNET_CORE_PeerClass class)
	Method called whenever a given peer connects.

typedef void(*	GNUNET_CORE_DisconnectEventHandler) (void cls, const struct GNUNET_PeerIdentity peer, void *peer_cls)
	Method called whenever a peer disconnects.

typedef void(*	GNUNET_CORE_StartupCallback) (void cls, const struct GNUNET_PeerIdentity my_identity)
	Function called after GNUNET_CORE_connect has succeeded (or failed for good).

typedef void(*	GNUNET_CORE_MonitorCallback) (void cls, const struct GNUNET_PeerIdentity pid, enum GNUNET_CORE_KxState state, struct GNUNET_TIME_Absolute timeout)
	Function called by the monitor callback whenever a peer's connection status changes.

Enumerations
enum	GNUNET_CORE_PeerClass { GNUNET_CORE_CLASS_UNKNOWN , GNUNET_CORE_CLASS_UNWILLING , GNUNET_CORE_CLASS_MOBILE , GNUNET_CORE_CLASS_DESKTOP , GNUNET_CORE_CLASS_ROUTER , GNUNET_CORE_CLASS_SERVER }
	The peer class gives a hint about the capabilities of a peer. More...

enum	GNUNET_CORE_Service { GNUNET_CORE_SERVICE_CADET , GNUNET_CORE_SERVICE_FS , GNUNET_CORE_SERVICE_DHT , GNUNET_CORE_SERVICE_NSE , GNUNET_CORE_SERVICE_REVOCATION , GNUNET_CORE_SERVICE_HOSTLIST , GNUNET_CORE_SERVICE_TOPOLOGY , GNUNET_CORE_SERVICE_RPS , GNUNET_CORE_SERVICE_TEST }
	Identifiers for services that communicate over CORE. More...

enum	GNUNET_CORE_KxState { GNUNET_CORE_KX_STATE_DOWN = 0 , GNUNET_CORE_KX_STATE_INITIATOR_HELLO_SENT , GNUNET_CORE_KX_STATE_AWAIT_INITIATION , GNUNET_CORE_KX_STATE_INITIATOR_HELLO_RECEIVED , GNUNET_CORE_KX_STATE_RESPONDER_HELLO_SENT , GNUNET_CORE_KX_STATE_RESPONDER_HELLO_RECEIVED , GNUNET_CORE_KX_STATE_INITIATOR_DONE_SENT , GNUNET_CORE_KX_STATE_INITIATOR_CONNECTED , GNUNET_CORE_KX_STATE_RESPONDER_CONNECTED , GNUNET_CORE_KX_STATE_REKEY_SENT , GNUNET_CORE_KX_PEER_DISCONNECT , GNUNET_CORE_KX_ITERATION_FINISHED , GNUNET_CORE_KX_CORE_DISCONNECT }
	TODO how does this harmonize with CAKE_CRYPTO_ENABLED? More...

Functions
struct GNUNET_CORE_Handle *	GNUNET_CORE_connect (const struct GNUNET_CONFIGURATION_Handle cfg, void cls, GNUNET_CORE_StartupCallback init, GNUNET_CORE_ConnectEventHandler connects, GNUNET_CORE_DisconnectEventHandler disconnects, const struct GNUNET_MQ_MessageHandler handlers, const struct GNUNET_CORE_ServiceInfo service_info)
	Connect to the core service.

void	GNUNET_CORE_disconnect (struct GNUNET_CORE_Handle *handle)
	Disconnect from the core service.

struct GNUNET_MQ_Handle *	GNUNET_CORE_get_mq (const struct GNUNET_CORE_Handle h, const struct GNUNET_PeerIdentity pid)
	Obtain the message queue for a connected peer.

struct GNUNET_CORE_MonitorHandle *	GNUNET_CORE_monitor_start (const struct GNUNET_CONFIGURATION_Handle cfg, GNUNET_CORE_MonitorCallback peer_cb, void peer_cb_cls)
	Monitor connectivity and KX status of all peers known to CORE.

void	GNUNET_CORE_monitor_stop (struct GNUNET_CORE_MonitorHandle *mh)
	Stop monitoring CORE activity.

int	GNUNET_CORE_is_peer_connected_sync (const struct GNUNET_CORE_Handle h, const struct GNUNET_PeerIdentity pid)
	Check if the given peer is currently connected.

Detailed Description

Core service; the main API for encrypted P2P communications.

Data Structures