GNUnet  0.10.x
Data Structures | Macros | Functions | Variables
gnunet-service-core_kx.c File Reference

code for managing the key exchange (SET_KEY, PING, PONG) with other peers More...

#include "platform.h"
#include "gnunet-service-core_kx.h"
#include "gnunet-service-core.h"
#include "gnunet-service-core_sessions.h"
#include "gnunet_statistics_service.h"
#include "gnunet_transport_service.h"
#include "gnunet_constants.h"
#include "gnunet_signatures.h"
#include "gnunet_protocols.h"
#include "core.h"
Include dependency graph for gnunet-service-core_kx.c:

Go to the source code of this file.

Data Structures

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...
 
struct  EncryptedMessage
 Encapsulation for encrypted messages exchanged between peers. More...
 
struct  GSC_KeyExchangeInfo
 Information about the status of a key exchange with another peer. More...
 

Macros

#define DEBUG_KX   0
 Enable expensive (and possibly problematic for privacy!) logging of KX. More...
 
#define INITIAL_SET_KEY_RETRY_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 10)
 How long do we wait for SET_KEY confirmation initially? More...
 
#define MIN_PING_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 5)
 What is the minimum frequency for a PING message? More...
 
#define REKEY_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_HOURS, 12)
 How often do we rekey? More...
 
#define REKEY_TOLERANCE   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_MINUTES, 5)
 What time difference do we tolerate? More...
 
#define MAX_MESSAGE_AGE   GNUNET_TIME_UNIT_DAYS
 What is the maximum age of a message for us to consider processing it? Note that this looks at the timestamp used by the other peer, so clock skew between machines does come into play here. More...
 
#define ENCRYPTED_HEADER_SIZE   (offsetof(struct EncryptedMessage, sequence_number))
 Number of bytes (at the beginning) of struct EncryptedMessage that are NOT encrypted. More...
 

Functions

static uint32_t calculate_seed (struct GSC_KeyExchangeInfo *kx)
 Calculate seed value we should use for a message. More...
 
static void monitor_notify_all (struct GSC_KeyExchangeInfo *kx)
 Inform all monitors about the KX state of the given peer. More...
 
static void derive_auth_key (struct GNUNET_CRYPTO_AuthKey *akey, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed)
 Derive an authentication key from "set key" information. More...
 
static void derive_iv (struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, const struct GNUNET_PeerIdentity *identity)
 Derive an IV from packet information. More...
 
static void derive_pong_iv (struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, uint32_t challenge, const struct GNUNET_PeerIdentity *identity)
 Derive an IV from pong packet information. More...
 
static void derive_aes_key (const struct GNUNET_PeerIdentity *sender, const struct GNUNET_PeerIdentity *receiver, const struct GNUNET_HashCode *key_material, struct GNUNET_CRYPTO_SymmetricSessionKey *skey)
 Derive an AES key from key material. More...
 
static int do_encrypt (struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
 Encrypt size bytes from in and write the result to out. More...
 
static int do_decrypt (struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
 Decrypt size bytes from in and write the result to out. More...
 
static void send_key (struct GSC_KeyExchangeInfo *kx)
 Send our key (and encrypted PING) to the other peer. More...
 
static void set_key_retry_task (void *cls)
 Task that will retry send_key() if our previous attempt failed. More...
 
static void setup_fresh_ping (struct GSC_KeyExchangeInfo *kx)
 Create a fresh PING message for transmission to the other peer. More...
 
static int deliver_message (void *cls, const struct GNUNET_MessageHeader *m)
 Deliver P2P message to interested clients. More...
 
static void * handle_transport_notify_connect (void *cls, const struct GNUNET_PeerIdentity *pid, struct GNUNET_MQ_Handle *mq)
 Function called by transport to notify us that a peer connected to us (on the network level). More...
 
static void handle_transport_notify_disconnect (void *cls, const struct GNUNET_PeerIdentity *peer, void *handler_cls)
 Function called by transport telling us that a peer disconnected. More...
 
static void send_ping (struct GSC_KeyExchangeInfo *kx)
 Send our PING to the other peer. More...
 
static void derive_session_keys (struct GSC_KeyExchangeInfo *kx)
 Derive fresh session keys from the current ephemeral keys. More...
 
static void handle_ephemeral_key (void *cls, const struct EphemeralKeyMessage *m)
 We received a GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY message. More...
 
static void handle_ping (void *cls, const struct PingMessage *m)
 We received a PING message. More...
 
static void send_keep_alive (void *cls)
 Task triggered when a neighbour entry is about to time out (and we should prevent this by sending a PING). More...
 
static void update_timeout (struct GSC_KeyExchangeInfo *kx)
 We've seen a valid message from the other peer. More...
 
static void handle_pong (void *cls, const struct PongMessage *m)
 We received a PONG message. More...
 
void GSC_KX_encrypt_and_transmit (struct GSC_KeyExchangeInfo *kx, const void *payload, size_t payload_size)
 Encrypt and transmit a message with the given payload. More...
 
static int check_encrypted (void *cls, const struct EncryptedMessage *m)
 We received an encrypted message. More...
 
static void handle_encrypted (void *cls, const struct EncryptedMessage *m)
 We received an encrypted message. More...
 
static void handle_transport_notify_excess_bw (void *cls, const struct GNUNET_PeerIdentity *pid, void *connect_cls)
 One of our neighbours has excess bandwidth, remember this. More...
 
static void sign_ephemeral_key ()
 Setup the message that links the ephemeral key to our persistent public key and generate the appropriate signature. More...
 
static void do_rekey (void *cls)
 Task run to trigger rekeying. More...
 
int GSC_KX_init (struct GNUNET_CRYPTO_EddsaPrivateKey *pk)
 Initialize KX subsystem. More...
 
void GSC_KX_done ()
 Shutdown KX subsystem. More...
 
unsigned int GSC_NEIGHBOURS_get_queue_length (const struct GSC_KeyExchangeInfo *kxinfo)
 Check how many messages are queued for the given neighbour. More...
 
int GSC_NEIGHBOURS_check_excess_bandwidth (const struct GSC_KeyExchangeInfo *kxinfo)
 Check if the given neighbour has excess bandwidth available. More...
 
void GSC_KX_handle_client_monitor_peers (struct GNUNET_MQ_Handle *mq)
 Handle GNUNET_MESSAGE_TYPE_CORE_MONITOR_PEERS request. More...
 

Variables

static struct GNUNET_TRANSPORT_CoreHandletransport
 Transport service. More...
 
static struct GNUNET_CRYPTO_EddsaPrivateKeymy_private_key
 Our private key. More...
 
static struct GNUNET_CRYPTO_EcdhePrivateKeymy_ephemeral_key
 Our ephemeral private key. More...
 
static struct EphemeralKeyMessage current_ekm
 Current message we send for a key exchange. More...
 
static struct GSC_KeyExchangeInfokx_head
 DLL head. More...
 
static struct GSC_KeyExchangeInfokx_tail
 DLL tail. More...
 
static struct GNUNET_SCHEDULER_Taskrekey_task
 Task scheduled for periodic re-generation (and thus rekeying) of our ephemeral key. More...
 
static struct GNUNET_NotificationContextnc
 Notification context for broadcasting to monitors. More...
 

Detailed Description

code for managing the key exchange (SET_KEY, PING, PONG) with other peers

Author
Christian Grothoff

Definition in file gnunet-service-core_kx.c.

Macro Definition Documentation

◆ DEBUG_KX

#define DEBUG_KX   0

Enable expensive (and possibly problematic for privacy!) logging of KX.

Definition at line 41 of file gnunet-service-core_kx.c.

◆ INITIAL_SET_KEY_RETRY_FREQUENCY

#define INITIAL_SET_KEY_RETRY_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 10)

How long do we wait for SET_KEY confirmation initially?

Definition at line 46 of file gnunet-service-core_kx.c.

Referenced by handle_transport_notify_connect().

◆ MIN_PING_FREQUENCY

#define MIN_PING_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 5)

What is the minimum frequency for a PING message?

Definition at line 52 of file gnunet-service-core_kx.c.

Referenced by send_keep_alive().

◆ REKEY_FREQUENCY

#define REKEY_FREQUENCY   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_HOURS, 12)

How often do we rekey?

Definition at line 58 of file gnunet-service-core_kx.c.

Referenced by do_rekey(), GSC_KX_init(), and sign_ephemeral_key().

◆ REKEY_TOLERANCE

#define REKEY_TOLERANCE   GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_MINUTES, 5)

What time difference do we tolerate?

Definition at line 64 of file gnunet-service-core_kx.c.

Referenced by handle_ephemeral_key(), and sign_ephemeral_key().

◆ MAX_MESSAGE_AGE

#define MAX_MESSAGE_AGE   GNUNET_TIME_UNIT_DAYS

What is the maximum age of a message for us to consider processing it? Note that this looks at the timestamp used by the other peer, so clock skew between machines does come into play here.

So this should be picked high enough so that a little bit of clock skew does not prevent peers from connecting to us.

Definition at line 74 of file gnunet-service-core_kx.c.

Referenced by handle_encrypted().

◆ ENCRYPTED_HEADER_SIZE

#define ENCRYPTED_HEADER_SIZE   (offsetof(struct EncryptedMessage, sequence_number))

Number of bytes (at the beginning) of struct EncryptedMessage that are NOT encrypted.

Definition at line 237 of file gnunet-service-core_kx.c.

Referenced by GSC_KX_encrypt_and_transmit(), and handle_encrypted().

Function Documentation

◆ calculate_seed()

static uint32_t calculate_seed ( struct GSC_KeyExchangeInfo kx)
static

Calculate seed value we should use for a message.

Parameters
kxkey exchange context

Definition at line 404 of file gnunet-service-core_kx.c.

References GNUNET_CRYPTO_QUALITY_NONCE, and GNUNET_CRYPTO_random_u32().

Referenced by GSC_KX_encrypt_and_transmit(), handle_ping(), and setup_fresh_ping().

405 {
406  /* Note: may want to make this non-random and instead
407  derive from key material to avoid having an undetectable
408  side-channel */
409  return htonl(
411 }
uint32_t GNUNET_CRYPTO_random_u32(enum GNUNET_CRYPTO_Quality mode, uint32_t i)
Produce a random value.
Randomness for IVs etc.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ monitor_notify_all()

static void monitor_notify_all ( struct GSC_KeyExchangeInfo kx)
static

Inform all monitors about the KX state of the given peer.

Parameters
kxkey exchange state to inform about

Definition at line 420 of file gnunet-service-core_kx.c.

References GNUNET_MESSAGE_TYPE_CORE_MONITOR_NOTIFY, GNUNET_NO, GNUNET_notification_context_broadcast(), GNUNET_TIME_absolute_hton(), MonitorNotifyMessage::header, GSC_KeyExchangeInfo::last_notify_timeout, GSC_KeyExchangeInfo::peer, MonitorNotifyMessage::peer, GNUNET_MessageHeader::size, MonitorNotifyMessage::state, GSC_KeyExchangeInfo::status, GSC_KeyExchangeInfo::timeout, MonitorNotifyMessage::timeout, and GNUNET_MessageHeader::type.

Referenced by do_rekey(), handle_encrypted(), handle_ephemeral_key(), handle_pong(), handle_transport_notify_connect(), handle_transport_notify_disconnect(), send_keep_alive(), and update_timeout().

421 {
422  struct MonitorNotifyMessage msg;
423 
425  msg.header.size = htons(sizeof(msg));
426  msg.state = htonl((uint32_t)kx->status);
427  msg.peer = *kx->peer;
428  msg.timeout = GNUNET_TIME_absolute_hton(kx->timeout);
430  kx->last_notify_timeout = kx->timeout;
431 }
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_NO
Definition: gnunet_common.h:78
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
struct GNUNET_TIME_Absolute last_notify_timeout
What was the last timeout we informed our monitors about?
uint16_t type
The type of the message (GNUNET_MESSAGE_TYPE_XXXX), in big-endian format.
static struct GNUNET_NotificationContext * nc
Notification context for broadcasting to monitors.
void GNUNET_notification_context_broadcast(struct GNUNET_NotificationContext *nc, const struct GNUNET_MessageHeader *msg, int can_drop)
Send a message to all subscribers of this context.
Definition: nc.c:187
struct GNUNET_TIME_Absolute timeout
When should the session time out (if there are no PONGs)?
Message sent by the service to monitor clients to notify them about a peer changing status...
Definition: core.h:294
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:655
#define GNUNET_MESSAGE_TYPE_CORE_MONITOR_NOTIFY
Reply for monitor by CORE service.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ derive_auth_key()

static void derive_auth_key ( struct GNUNET_CRYPTO_AuthKey akey,
const struct GNUNET_CRYPTO_SymmetricSessionKey skey,
uint32_t  seed 
)
static

Derive an authentication key from "set key" information.

Parameters
akeyauthentication key to derive
skeysession key to use
seedseed to use

Definition at line 442 of file gnunet-service-core_kx.c.

References ctx, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hmac_derive_key(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), and GNUNET_log.

Referenced by GSC_KX_encrypt_and_transmit(), and handle_encrypted().

445 {
446  static const char ctx[] = "authentication key";
447 
448 #if DEBUG_KX
449  struct GNUNET_HashCode sh;
450 
451  GNUNET_CRYPTO_hash(skey, sizeof(*skey), &sh);
453  "Deriving Auth key from SKEY %s and seed %u\n",
454  GNUNET_h2s(&sh),
455  (unsigned int)seed);
456 #endif
458  skey,
459  &seed,
460  sizeof(seed),
461  skey,
462  sizeof(
464  ctx,
465  sizeof(ctx),
466  NULL);
467 }
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
static struct SolverHandle * sh
A 512-bit hashcode.
#define GNUNET_log(kind,...)
void GNUNET_CRYPTO_hmac_derive_key(struct GNUNET_CRYPTO_AuthKey *key, const struct GNUNET_CRYPTO_SymmetricSessionKey *rkey, const void *salt, size_t salt_len,...)
Derive an authentication key.
Definition: crypto_hash.c:338
Here is the call graph for this function:
Here is the caller graph for this function:

◆ derive_iv()

static void derive_iv ( struct GNUNET_CRYPTO_SymmetricInitializationVector iv,
const struct GNUNET_CRYPTO_SymmetricSessionKey skey,
uint32_t  seed,
const struct GNUNET_PeerIdentity identity 
)
static

Derive an IV from packet information.

Parameters
ivinitialization vector to initialize
skeysession key to use
seedseed to use
identityidentity of the other peer to use

Definition at line 479 of file gnunet-service-core_kx.c.

References ctx, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_symmetric_derive_iv(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_i2s(), and GNUNET_log.

Referenced by GSC_KX_encrypt_and_transmit(), handle_encrypted(), handle_ping(), and setup_fresh_ping().

483 {
484  static const char ctx[] = "initialization vector";
485 
486 #if DEBUG_KX
487  struct GNUNET_HashCode sh;
488 
489  GNUNET_CRYPTO_hash(skey, sizeof(*skey), &sh);
491  "Deriving IV from SKEY %s and seed %u for peer %s\n",
492  GNUNET_h2s(&sh),
493  (unsigned int)seed,
494  GNUNET_i2s(identity));
495 #endif
497  skey,
498  &seed,
499  sizeof(seed),
500  identity,
501  sizeof(struct GNUNET_PeerIdentity),
502  ctx,
503  sizeof(ctx),
504  NULL);
505 }
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
static struct SolverHandle * sh
void GNUNET_CRYPTO_symmetric_derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, const void *salt, size_t salt_len,...)
Derive an IV.
A 512-bit hashcode.
The identity of the host (wraps the signing key of the peer).
#define GNUNET_log(kind,...)
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ derive_pong_iv()

static void derive_pong_iv ( struct GNUNET_CRYPTO_SymmetricInitializationVector iv,
const struct GNUNET_CRYPTO_SymmetricSessionKey skey,
uint32_t  seed,
uint32_t  challenge,
const struct GNUNET_PeerIdentity identity 
)
static

Derive an IV from pong packet information.

Parameters
ivinitialization vector to initialize
skeysession key to use
seedseed to use
challengenonce to use
identityidentity of the other peer to use

Definition at line 518 of file gnunet-service-core_kx.c.

References ctx, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_symmetric_derive_iv(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_i2s(), and GNUNET_log.

Referenced by handle_ping(), and handle_pong().

523 {
524  static const char ctx[] = "pong initialization vector";
525 
526 #if DEBUG_KX
527  struct GNUNET_HashCode sh;
528 
529  GNUNET_CRYPTO_hash(skey, sizeof(*skey), &sh);
531  "Deriving PONG IV from SKEY %s and seed %u/%u for %s\n",
532  GNUNET_h2s(&sh),
533  (unsigned int)seed,
534  (unsigned int)challenge,
535  GNUNET_i2s(identity));
536 #endif
538  skey,
539  &seed,
540  sizeof(seed),
541  identity,
542  sizeof(struct GNUNET_PeerIdentity),
543  &challenge,
544  sizeof(challenge),
545  ctx,
546  sizeof(ctx),
547  NULL);
548 }
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
static struct SolverHandle * sh
void GNUNET_CRYPTO_symmetric_derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, const void *salt, size_t salt_len,...)
Derive an IV.
A 512-bit hashcode.
The identity of the host (wraps the signing key of the peer).
#define GNUNET_log(kind,...)
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ derive_aes_key()

static void derive_aes_key ( const struct GNUNET_PeerIdentity sender,
const struct GNUNET_PeerIdentity receiver,
const struct GNUNET_HashCode key_material,
struct GNUNET_CRYPTO_SymmetricSessionKey skey 
)
static

Derive an AES key from key material.

Parameters
senderpeer identity of the sender
receiverpeer identity of the sender
key_materialhigh entropy key material to use
skeyset to derived session key

Definition at line 560 of file gnunet-service-core_kx.c.

References ctx, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_kdf(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_i2s(), GNUNET_i2s2(), and GNUNET_log.

Referenced by derive_session_keys().

564 {
565  static const char ctx[] = "aes key generation vector";
566 
567 #if DEBUG_KX
568  struct GNUNET_HashCode sh;
569 
570  GNUNET_CRYPTO_hash(skey, sizeof(*skey), &sh);
572  "Deriving AES Keys for %s to %s from %s\n",
573  GNUNET_i2s(sender),
574  GNUNET_i2s2(receiver),
575  GNUNET_h2s(key_material));
576 #endif
577  GNUNET_CRYPTO_kdf(skey,
578  sizeof(struct GNUNET_CRYPTO_SymmetricSessionKey),
579  ctx,
580  sizeof(ctx),
581  key_material,
582  sizeof(struct GNUNET_HashCode),
583  sender,
584  sizeof(struct GNUNET_PeerIdentity),
585  receiver,
586  sizeof(struct GNUNET_PeerIdentity),
587  NULL);
588 }
const char * GNUNET_i2s2(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
static struct SolverHandle * sh
A 512-bit hashcode.
The identity of the host (wraps the signing key of the peer).
#define GNUNET_log(kind,...)
int GNUNET_CRYPTO_kdf(void *result, size_t out_len, const void *xts, size_t xts_len, const void *skm, size_t skm_len,...)
Derive key.
Definition: crypto_kdf.c:91
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ do_encrypt()

static int do_encrypt ( struct GSC_KeyExchangeInfo kx,
const struct GNUNET_CRYPTO_SymmetricInitializationVector iv,
const void *  in,
void *  out,
size_t  size 
)
static

Encrypt size bytes from in and write the result to out.

Use the kx key for outbound traffic of the given neighbour.

Parameters
kxkey information context
ivinitialization vector to use
inciphertext
outplaintext
sizesize of in/out GNUNET_OK on success

Definition at line 603 of file gnunet-service-core_kx.c.

References GSC_KeyExchangeInfo::encrypt_key, gettext_noop, GNUNET_assert, GNUNET_break, GNUNET_CRYPTO_crc32_n(), GNUNET_CRYPTO_symmetric_encrypt(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_STATISTICS_update(), GSC_stats, and GSC_KeyExchangeInfo::peer.

Referenced by GSC_KX_encrypt_and_transmit(), handle_ping(), and setup_fresh_ping().

608 {
609  if (size != (uint16_t)size)
610  {
611  GNUNET_break(0);
612  return GNUNET_NO;
613  }
615  (uint16_t)size,
616  &kx->encrypt_key,
617  iv,
618  out));
620  gettext_noop("# bytes encrypted"),
621  size,
622  GNUNET_NO);
623  /* the following is too sensitive to write to log files by accident,
624  so we require manual intervention to get this one... */
625 #if DEBUG_KX
627  "Encrypted %u bytes for `%s' using key %u, IV %u\n",
628  (unsigned int)size,
629  GNUNET_i2s(kx->peer),
630  (unsigned int)kx->encrypt_key.crc32,
631  GNUNET_CRYPTO_crc32_n(iv, sizeof(iv)));
632 #endif
633  return GNUNET_OK;
634 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
int32_t GNUNET_CRYPTO_crc32_n(const void *buf, size_t len)
Compute the CRC32 checksum for the first len bytes of the buffer.
Definition: crypto_crc.c:105
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
ssize_t GNUNET_CRYPTO_symmetric_encrypt(const void *block, size_t size, const struct GNUNET_CRYPTO_SymmetricSessionKey *sessionkey, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, void *result)
Encrypt a block using a symmetric sessionkey.
static unsigned int size
Size of the "table".
Definition: peer.c:66
#define GNUNET_log(kind,...)
struct GNUNET_CRYPTO_SymmetricSessionKey encrypt_key
Key we use to encrypt our messages for the other peer (initialized by us when we do the handshake)...
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ do_decrypt()

static int do_decrypt ( struct GSC_KeyExchangeInfo kx,
const struct GNUNET_CRYPTO_SymmetricInitializationVector iv,
const void *  in,
void *  out,
size_t  size 
)
static

Decrypt size bytes from in and write the result to out.

Use the kx key for inbound traffic of the given neighbour. This function does NOT do any integrity-checks on the result.

Parameters
kxkey information context
ivinitialization vector to use
inciphertext
outplaintext
sizesize of in / out
Returns
GNUNET_OK on success

Definition at line 650 of file gnunet-service-core_kx.c.

References GSC_KeyExchangeInfo::decrypt_key, gettext_noop, GNUNET_break, GNUNET_break_op, GNUNET_CORE_KX_STATE_KEY_RECEIVED, GNUNET_CORE_KX_STATE_REKEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_CRYPTO_crc32_n(), GNUNET_CRYPTO_symmetric_decrypt(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_STATISTICS_update(), GNUNET_SYSERR, GSC_stats, GSC_KeyExchangeInfo::peer, send_key(), and GSC_KeyExchangeInfo::status.

Referenced by handle_encrypted(), handle_ping(), and handle_pong().

655 {
656  if (size != (uint16_t)size)
657  {
658  GNUNET_break(0);
659  return GNUNET_NO;
660  }
662  (kx->status != GNUNET_CORE_KX_STATE_UP) &&
664  {
665  GNUNET_break_op(0);
666  return GNUNET_SYSERR;
667  }
668  if (size != GNUNET_CRYPTO_symmetric_decrypt(in,
669  (uint16_t)size,
670  &kx->decrypt_key,
671  iv,
672  out))
673  {
674  GNUNET_break(0);
675  return GNUNET_SYSERR;
676  }
678  gettext_noop("# bytes decrypted"),
679  size,
680  GNUNET_NO);
681  /* the following is too sensitive to write to log files by accident,
682  so we require manual intervention to get this one... */
683 #if DEBUG_KX
685  "Decrypted %u bytes from `%s' using key %u, IV %u\n",
686  (unsigned int)size,
687  GNUNET_i2s(kx->peer),
688  (unsigned int)kx->decrypt_key.crc32,
689  GNUNET_CRYPTO_crc32_n(iv, sizeof(*iv)));
690 #endif
691  return GNUNET_OK;
692 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
int32_t GNUNET_CRYPTO_crc32_n(const void *buf, size_t len)
Compute the CRC32 checksum for the first len bytes of the buffer.
Definition: crypto_crc.c:105
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
We've received the other peers session key.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
struct GNUNET_CRYPTO_SymmetricSessionKey decrypt_key
Key we use to decrypt messages from the other peer (given to us by the other peer during the handshak...
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
static unsigned int size
Size of the "table".
Definition: peer.c:66
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
#define GNUNET_log(kind,...)
ssize_t GNUNET_CRYPTO_symmetric_decrypt(const void *block, size_t size, const struct GNUNET_CRYPTO_SymmetricSessionKey *sessionkey, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, void *result)
Decrypt a given block using a symmetric sessionkey.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define gettext_noop(String)
Definition: gettext.h:69
We're rekeying (or had a timeout), so we have sent the other peer our new ephemeral key...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ send_key()

static void send_key ( struct GSC_KeyExchangeInfo kx)
static

Send our key (and encrypted PING) to the other peer.

Send our key to the other peer.

Parameters
kxkey exchange context

Definition at line 1465 of file gnunet-service-core_kx.c.

References current_ekm, env, EphemeralKeyMessage::ephemeral_key, GNUNET_assert, GNUNET_CORE_KX_STATE_DOWN, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_i2s(), GNUNET_log, GNUNET_MQ_msg_copy(), GNUNET_MQ_send(), GNUNET_SCHEDULER_add_delayed(), GNUNET_SCHEDULER_cancel(), EphemeralKeyMessage::header, GSC_KeyExchangeInfo::mq, GSC_KeyExchangeInfo::peer, GSC_KeyExchangeInfo::retry_set_key_task, send_ping(), EphemeralKeyMessage::sender_status, GSC_KeyExchangeInfo::set_key_retry_frequency, set_key_retry_task(), and GSC_KeyExchangeInfo::status.

Referenced by do_decrypt(), do_rekey(), handle_encrypted(), handle_ephemeral_key(), handle_transport_notify_connect(), send_keep_alive(), and set_key_retry_task().

1466 {
1467  struct GNUNET_MQ_Envelope *env;
1468 
1470  if (NULL != kx->retry_set_key_task)
1471  {
1473  kx->retry_set_key_task = NULL;
1474  }
1475  /* always update sender status in SET KEY message */
1476 #if DEBUG_KX
1477  {
1478  struct GNUNET_HashCode hc;
1479 
1481  sizeof(current_ekm.ephemeral_key),
1482  &hc);
1484  "Sending EPHEMERAL_KEY %s to `%s' (my status: %d)\n",
1485  GNUNET_h2s(&hc),
1486  GNUNET_i2s(kx->peer),
1487  kx->status);
1488  }
1489 #endif
1490  current_ekm.sender_status = htonl((int32_t)(kx->status));
1492  GNUNET_MQ_send(kx->mq, env);
1494  send_ping(kx);
1495  kx->retry_set_key_task =
1498  kx);
1499 }
struct GNUNET_MQ_Envelope * GNUNET_MQ_msg_copy(const struct GNUNET_MessageHeader *hdr)
Create a new envelope by copying an existing message.
Definition: mq.c:651
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
struct GNUNET_TIME_Relative set_key_retry_frequency
At what frequency are we currently re-trying SET_KEY messages?
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
struct GNUNET_SCHEDULER_Task * retry_set_key_task
ID of task used for re-trying SET_KEY and PING message.
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
static void send_ping(struct GSC_KeyExchangeInfo *kx)
Send our PING to the other peer.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
A 512-bit hashcode.
struct GNUNET_CRYPTO_EcdhePublicKey ephemeral_key
Ephemeral public ECC key.
static void set_key_retry_task(void *cls)
Task that will retry send_key() if our previous attempt failed.
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
struct GNUNET_MessageHeader header
Message type is GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY.
#define GNUNET_log(kind,...)
int32_t sender_status
Status of the sender (should be in enum PeerStateMachine), nbo.
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
static struct EphemeralKeyMessage current_ekm
Current message we send for a key exchange.
We've sent our session key.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
Here is the call graph for this function:
Here is the caller graph for this function:

◆ set_key_retry_task()

static void set_key_retry_task ( void *  cls)
static

Task that will retry send_key() if our previous attempt failed.

Parameters
clsour struct GSC_KeyExchangeInfo

Definition at line 710 of file gnunet-service-core_kx.c.

References GNUNET_assert, GNUNET_CORE_KX_STATE_DOWN, GNUNET_TIME_STD_BACKOFF, GSC_KeyExchangeInfo::retry_set_key_task, send_key(), GSC_KeyExchangeInfo::set_key_retry_frequency, and GSC_KeyExchangeInfo::status.

Referenced by handle_transport_notify_connect(), and send_key().

711 {
712  struct GSC_KeyExchangeInfo *kx = cls;
713 
714  kx->retry_set_key_task = NULL;
718  send_key(kx);
719 }
struct GNUNET_TIME_Relative set_key_retry_frequency
At what frequency are we currently re-trying SET_KEY messages?
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
struct GNUNET_SCHEDULER_Task * retry_set_key_task
ID of task used for re-trying SET_KEY and PING message.
Information about the status of a key exchange with another peer.
#define GNUNET_TIME_STD_BACKOFF(r)
Perform our standard exponential back-off calculation, starting at 1 ms and then going by a factor of...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ setup_fresh_ping()

static void setup_fresh_ping ( struct GSC_KeyExchangeInfo kx)
static

Create a fresh PING message for transmission to the other peer.

Parameters
kxkey exchange context to create PING for

Definition at line 728 of file gnunet-service-core_kx.c.

References calculate_seed(), PingMessage::challenge, derive_iv(), do_encrypt(), GSC_KeyExchangeInfo::encrypt_key, GNUNET_CRYPTO_QUALITY_WEAK, GNUNET_CRYPTO_random_u32(), GNUNET_MESSAGE_TYPE_CORE_PING, GSC_KeyExchangeInfo::peer, GSC_KeyExchangeInfo::ping, GSC_KeyExchangeInfo::ping_challenge, pm, and PingMessage::target.

Referenced by derive_session_keys(), and send_keep_alive().

729 {
730  struct PingMessage pp;
731  struct PingMessage *pm;
733 
734  pm = &kx->ping;
735  kx->ping_challenge =
737  pm->header.size = htons(sizeof(struct PingMessage));
738  pm->header.type = htons(GNUNET_MESSAGE_TYPE_CORE_PING);
739  pm->iv_seed = calculate_seed(kx);
740  derive_iv(&iv, &kx->encrypt_key, pm->iv_seed, kx->peer);
741  pp.challenge = kx->ping_challenge;
742  pp.target = *kx->peer;
743  do_encrypt(kx,
744  &iv,
745  &pp.target,
746  &pm->target,
747  sizeof(struct PingMessage) -
748  ((void *)&pm->target - (void *)pm));
749 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
struct PingMessage ping
PING message we transmit to the other peer.
uint32_t GNUNET_CRYPTO_random_u32(enum GNUNET_CRYPTO_Quality mode, uint32_t i)
Produce a random value.
static int do_encrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Encrypt size bytes from in and write the result to out.
We're sending an (encrypted) PING to the other peer to check if it can decrypt.
uint32_t ping_challenge
What was our PING challenge number (for this peer)?
static uint32_t calculate_seed(struct GSC_KeyExchangeInfo *kx)
Calculate seed value we should use for a message.
#define GNUNET_MESSAGE_TYPE_CORE_PING
Check that other peer is alive (challenge).
static void derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, const struct GNUNET_PeerIdentity *identity)
Derive an IV from packet information.
struct GNUNET_CRYPTO_SymmetricSessionKey encrypt_key
Key we use to encrypt our messages for the other peer (initialized by us when we do the handshake)...
No good quality of the operation is needed (i.e., random numbers can be pseudo-random).
static struct GNUNET_TRANSPORT_PluginMonitor * pm
Handle if we are monitoring plugin session activity.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ deliver_message()

static int deliver_message ( void *  cls,
const struct GNUNET_MessageHeader m 
)
static

Deliver P2P message to interested clients.

Invokes send twice, once for clients that want the full message, and once for clients that only want the header

Parameters
clsthe struct GSC_KeyExchangeInfo
mthe message
Returns
GNUNET_OK on success, GNUNET_NO to stop further processing (no error) GNUNET_SYSERR to stop further processing with error

Definition at line 764 of file gnunet-service-core_kx.c.

References gettext_noop, GNUNET_CORE_KX_STATE_UP, GNUNET_CORE_OPTION_SEND_FULL_INBOUND, GNUNET_CORE_OPTION_SEND_HDR_INBOUND, GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_MESSAGE_TYPE_CORE_BINARY_TYPE_MAP, GNUNET_MESSAGE_TYPE_CORE_COMPRESSED_TYPE_MAP, GNUNET_MESSAGE_TYPE_CORE_CONFIRM_TYPE_MAP, GNUNET_NO, GNUNET_OK, GNUNET_STATISTICS_update(), GSC_CLIENTS_deliver_message(), GSC_SESSIONS_confirm_typemap(), GSC_SESSIONS_set_typemap(), GSC_stats, GSC_KeyExchangeInfo::peer, GNUNET_MessageHeader::size, GSC_KeyExchangeInfo::status, and GNUNET_MessageHeader::type.

Referenced by handle_transport_notify_connect().

765 {
766  struct GSC_KeyExchangeInfo *kx = cls;
767 
769  "Decrypted message of type %d from %s\n",
770  ntohs(m->type),
771  GNUNET_i2s(kx->peer));
772  if (GNUNET_CORE_KX_STATE_UP != kx->status)
773  {
775  gettext_noop("# PAYLOAD dropped (out of order)"),
776  1,
777  GNUNET_NO);
778  return GNUNET_OK;
779  }
780  switch (ntohs(m->type))
781  {
785  return GNUNET_OK;
786 
789  return GNUNET_OK;
790 
791  default:
793  m,
794  ntohs(m->size),
797  m,
798  sizeof(struct GNUNET_MessageHeader),
800  }
801  return GNUNET_OK;
802 }
void GSC_SESSIONS_confirm_typemap(const struct GNUNET_PeerIdentity *peer, const struct GNUNET_MessageHeader *msg)
The other peer has confirmed receiving our type map, check if it is current and if so...
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
#define GNUNET_MESSAGE_TYPE_CORE_COMPRESSED_TYPE_MAP
gzip-compressed type map of the sender
uint16_t type
The type of the message (GNUNET_MESSAGE_TYPE_XXXX), in big-endian format.
#define GNUNET_MESSAGE_TYPE_CORE_CONFIRM_TYPE_MAP
Other peer confirms having received the type map.
void GSC_SESSIONS_set_typemap(const struct GNUNET_PeerIdentity *peer, const struct GNUNET_MessageHeader *msg)
We have received a typemap message from a peer, update ours.
#define GNUNET_CORE_OPTION_SEND_FULL_INBOUND
Client wants all inbound messages in full.
Definition: core.h:55
Information about the status of a key exchange with another peer.
void GSC_CLIENTS_deliver_message(const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *msg, uint16_t msize, uint32_t options)
Deliver P2P message to interested clients.
#define GNUNET_MESSAGE_TYPE_CORE_BINARY_TYPE_MAP
uncompressed type map of the sender
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
#define GNUNET_log(kind,...)
Header for all communications.
#define GNUNET_CORE_OPTION_SEND_HDR_INBOUND
Client just wants the 4-byte message headers of all inbound messages.
Definition: core.h:61
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ handle_transport_notify_connect()

static void* handle_transport_notify_connect ( void *  cls,
const struct GNUNET_PeerIdentity pid,
struct GNUNET_MQ_Handle mq 
)
static

Function called by transport to notify us that a peer connected to us (on the network level).

Starts the key exchange with the given peer.

Parameters
clsclosure (NULL)
pididentity of the peer to do a key exchange with
Returns
key exchange information context

Definition at line 815 of file gnunet-service-core_kx.c.

References deliver_message(), gettext_noop, GNUNET_CONTAINER_DLL_insert, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_cmp(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_MST_create(), GNUNET_new, GNUNET_NO, GNUNET_SCHEDULER_add_delayed(), GNUNET_STATISTICS_update(), GNUNET_TIME_UNIT_SECONDS, GSC_my_identity, GSC_stats, INITIAL_SET_KEY_RETRY_FREQUENCY, monitor_notify_all(), mq, GSC_KeyExchangeInfo::mq, GSC_KeyExchangeInfo::mst, GSC_KeyExchangeInfo::peer, pid, GSC_KeyExchangeInfo::retry_set_key_task, send_key(), GSC_KeyExchangeInfo::set_key_retry_frequency, set_key_retry_task(), and GSC_KeyExchangeInfo::status.

Referenced by GSC_KX_init().

818 {
819  struct GSC_KeyExchangeInfo *kx;
820  struct GNUNET_HashCode h1;
821  struct GNUNET_HashCode h2;
822 
824  "Initiating key exchange with `%s'\n",
825  GNUNET_i2s(pid));
827  gettext_noop("# key exchanges initiated"),
828  1,
829  GNUNET_NO);
830  kx = GNUNET_new(struct GSC_KeyExchangeInfo);
832  kx->mq = mq;
833  kx->peer = pid;
837  monitor_notify_all(kx);
838  GNUNET_CRYPTO_hash(pid, sizeof(struct GNUNET_PeerIdentity), &h1);
840  sizeof(struct GNUNET_PeerIdentity),
841  &h2);
842  if (0 < GNUNET_CRYPTO_hash_cmp(&h1, &h2))
843  {
844  /* peer with "lower" identity starts KX, otherwise we typically end up
845  with both peers starting the exchange and transmit the 'set key'
846  message twice */
847  send_key(kx);
848  }
849  else
850  {
851  /* peer with "higher" identity starts a delayed KX, if the "lower" peer
852  * does not start a KX since it sees no reasons to do so */
853  kx->retry_set_key_task =
856  kx);
857  }
858  return kx;
859 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
struct GNUNET_TIME_Relative set_key_retry_frequency
At what frequency are we currently re-trying SET_KEY messages?
#define GNUNET_CONTAINER_DLL_insert(head, tail, element)
Insert an element at the head of a DLL.
enum GNUNET_CORE_KxState status
What is our connection status?
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
#define GNUNET_TIME_UNIT_SECONDS
One second.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_new(type)
Allocate a struct or union of the given type.
static struct GSC_KeyExchangeInfo * kx_head
DLL head.
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
struct GNUNET_MessageStreamTokenizer * mst
Our message stream tokenizer (for encrypted payload).
static int deliver_message(void *cls, const struct GNUNET_MessageHeader *m)
Deliver P2P message to interested clients.
struct GNUNET_SCHEDULER_Task * retry_set_key_task
ID of task used for re-trying SET_KEY and PING message.
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
static struct GSC_KeyExchangeInfo * kx_tail
DLL tail.
struct GNUNET_MessageStreamTokenizer * GNUNET_MST_create(GNUNET_MessageTokenizerCallback cb, void *cb_cls)
Create a message stream tokenizer.
Definition: mst.c:84
Information about the status of a key exchange with another peer.
A 512-bit hashcode.
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
static void set_key_retry_task(void *cls)
Task that will retry send_key() if our previous attempt failed.
The identity of the host (wraps the signing key of the peer).
int GNUNET_CRYPTO_hash_cmp(const struct GNUNET_HashCode *h1, const struct GNUNET_HashCode *h2)
Compare function for HashCodes, producing a total ordering of all hashcodes.
Definition: crypto_hash.c:278
struct GNUNET_MQ_Handle * mq
Definition: 003.c:5
#define GNUNET_log(kind,...)
We&#39;ve sent our session key.
static struct GNUNET_PeerIdentity pid
Identity of the peer we transmit to / connect to.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define INITIAL_SET_KEY_RETRY_FREQUENCY
How long do we wait for SET_KEY confirmation initially?
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ handle_transport_notify_disconnect()

static void handle_transport_notify_disconnect ( void *  cls,
const struct GNUNET_PeerIdentity peer,
void *  handler_cls 
)
static

Function called by transport telling us that a peer disconnected.

Stop key exchange with the given peer. Clean up key material.

Parameters
clsclosure
peerthe peer that disconnected
handler_clsthe struct GSC_KeyExchangeInfo of the peer

Definition at line 872 of file gnunet-service-core_kx.c.

References gettext_noop, GNUNET_CONTAINER_DLL_remove, GNUNET_CORE_KX_PEER_DISCONNECT, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_i2s(), GNUNET_log, GNUNET_MST_destroy(), GNUNET_NO, GNUNET_SCHEDULER_cancel(), GNUNET_STATISTICS_update(), GSC_SESSIONS_end(), GSC_stats, GSC_KeyExchangeInfo::keep_alive_task, monitor_notify_all(), GSC_KeyExchangeInfo::mst, GSC_KeyExchangeInfo::peer, GSC_KeyExchangeInfo::retry_set_key_task, and GSC_KeyExchangeInfo::status.

Referenced by GSC_KX_init().

875 {
876  struct GSC_KeyExchangeInfo *kx = handler_cls;
877 
879  "Peer `%s' disconnected from us.\n",
880  GNUNET_i2s(peer));
881  GSC_SESSIONS_end(kx->peer);
883  gettext_noop("# key exchanges stopped"),
884  1,
885  GNUNET_NO);
886  if (NULL != kx->retry_set_key_task)
887  {
889  kx->retry_set_key_task = NULL;
890  }
891  if (NULL != kx->keep_alive_task)
892  {
894  kx->keep_alive_task = NULL;
895  }
897  monitor_notify_all(kx);
899  GNUNET_MST_destroy(kx->mst);
900  GNUNET_free(kx);
901 }
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_NO
Definition: gnunet_common.h:78
static struct GSC_KeyExchangeInfo * kx_head
DLL head.
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
struct GNUNET_MessageStreamTokenizer * mst
Our message stream tokenizer (for encrypted payload).
struct GNUNET_SCHEDULER_Task * retry_set_key_task
ID of task used for re-trying SET_KEY and PING message.
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
void GNUNET_MST_destroy(struct GNUNET_MessageStreamTokenizer *mst)
Destroys a tokenizer.
Definition: mst.c:410
static struct GSC_KeyExchangeInfo * kx_tail
DLL tail.
Information about the status of a key exchange with another peer.
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
#define GNUNET_log(kind,...)
Last state of a KX (when it is being terminated).
void GSC_SESSIONS_end(const struct GNUNET_PeerIdentity *pid)
End the session with the given peer (we are no longer connected).
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define GNUNET_free(ptr)
Wrapper around free.
#define gettext_noop(String)
Definition: gettext.h:69
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
Here is the call graph for this function:
Here is the caller graph for this function:

◆ send_ping()

static void send_ping ( struct GSC_KeyExchangeInfo kx)
static

Send our PING to the other peer.

Parameters
kxkey exchange context

Definition at line 910 of file gnunet-service-core_kx.c.

References env, gettext_noop, GNUNET_MQ_msg_copy(), GNUNET_MQ_send(), GNUNET_NO, GNUNET_STATISTICS_update(), GSC_stats, PingMessage::header, GSC_KeyExchangeInfo::mq, and GSC_KeyExchangeInfo::ping.

Referenced by handle_ephemeral_key(), send_keep_alive(), and send_key().

911 {
912  struct GNUNET_MQ_Envelope *env;
913 
915  gettext_noop("# PING messages transmitted"),
916  1,
917  GNUNET_NO);
918  env = GNUNET_MQ_msg_copy(&kx->ping.header);
919  GNUNET_MQ_send(kx->mq, env);
920 }
struct GNUNET_MQ_Envelope * GNUNET_MQ_msg_copy(const struct GNUNET_MessageHeader *hdr)
Create a new envelope by copying an existing message.
Definition: mq.c:651
struct PingMessage ping
PING message we transmit to the other peer.
#define GNUNET_NO
Definition: gnunet_common.h:78
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
struct GNUNET_MessageHeader header
Message type is GNUNET_MESSAGE_TYPE_CORE_PING.
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ derive_session_keys()

static void derive_session_keys ( struct GSC_KeyExchangeInfo kx)
static

Derive fresh session keys from the current ephemeral keys.

Parameters
kxsession to derive keys for

Definition at line 929 of file gnunet-service-core_kx.c.

References GSC_KeyExchangeInfo::decrypt_key, derive_aes_key(), GSC_KeyExchangeInfo::encrypt_key, GNUNET_break, GNUNET_CRYPTO_ecc_ecdh(), GNUNET_OK, GSC_my_identity, GSC_KeyExchangeInfo::last_packets_bitmap, GSC_KeyExchangeInfo::last_sequence_number_received, GSC_KeyExchangeInfo::other_ephemeral_key, GSC_KeyExchangeInfo::peer, and setup_fresh_ping().

Referenced by do_rekey(), and handle_ephemeral_key().

930 {
931  struct GNUNET_HashCode key_material;
932 
934  &kx->other_ephemeral_key,
935  &key_material))
936  {
937  GNUNET_break(0);
938  return;
939  }
940  derive_aes_key(&GSC_my_identity, kx->peer, &key_material, &kx->encrypt_key);
941  derive_aes_key(kx->peer, &GSC_my_identity, &key_material, &kx->decrypt_key);
942  memset(&key_material, 0, sizeof(key_material));
943  /* fresh key, reset sequence numbers */
945  kx->last_packets_bitmap = 0;
946  setup_fresh_ping(kx);
947 }
static void derive_aes_key(const struct GNUNET_PeerIdentity *sender, const struct GNUNET_PeerIdentity *receiver, const struct GNUNET_HashCode *key_material, struct GNUNET_CRYPTO_SymmetricSessionKey *skey)
Derive an AES key from key material.
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
uint32_t last_packets_bitmap
Bit map indicating which of the 32 sequence numbers before the last were received (good for accepting...
static struct GNUNET_CRYPTO_EcdhePrivateKey * my_ephemeral_key
Our ephemeral private key.
int GNUNET_CRYPTO_ecc_ecdh(const struct GNUNET_CRYPTO_EcdhePrivateKey *priv, const struct GNUNET_CRYPTO_EcdhePublicKey *pub, struct GNUNET_HashCode *key_material)
Derive key material from a public and a private ECC key.
Definition: crypto_ecc.c:1185
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
struct GNUNET_CRYPTO_EcdhePublicKey other_ephemeral_key
Ephemeral public ECC key of the other peer.
A 512-bit hashcode.
struct GNUNET_CRYPTO_SymmetricSessionKey decrypt_key
Key we use to decrypt messages from the other peer (given to us by the other peer during the handshak...
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
static void setup_fresh_ping(struct GSC_KeyExchangeInfo *kx)
Create a fresh PING message for transmission to the other peer.
uint32_t last_sequence_number_received
last sequence number received on this connection (highest)
struct GNUNET_CRYPTO_SymmetricSessionKey encrypt_key
Key we use to encrypt our messages for the other peer (initialized by us when we do the handshake)...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ handle_ephemeral_key()

static void handle_ephemeral_key ( void *  cls,
const struct EphemeralKeyMessage m 
)
static

We received a GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY message.

Validate and update our key material and status.

Parameters
clskey exchange status for the corresponding peer
mthe set key message we received

Definition at line 958 of file gnunet-service-core_kx.c.

References _, GNUNET_TIME_Absolute::abs_value_us, EphemeralKeyMessage::creation_time, derive_session_keys(), EphemeralKeyMessage::ephemeral_key, EphemeralKeyMessage::expiration_time, GSC_KeyExchangeInfo::foreign_key_expires, gettext_noop, GNUNET_assert, GNUNET_break, GNUNET_break_op, GNUNET_CORE_KX_STATE_DOWN, GNUNET_CORE_KX_STATE_KEY_RECEIVED, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CORE_KX_STATE_REKEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_CRYPTO_eddsa_verify(), GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_WARNING, GNUNET_h2s(), GNUNET_i2s(), GNUNET_i2s_full(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_SIGNATURE_PURPOSE_SET_ECC_KEY, GNUNET_STATISTICS_update(), GNUNET_TIME_absolute_add(), GNUNET_TIME_absolute_get(), GNUNET_TIME_absolute_ntoh(), GNUNET_TIME_absolute_subtract(), GSC_SESSIONS_reinit(), GSC_stats, GSC_KeyExchangeInfo::keep_alive_task, monitor_notify_all(), EphemeralKeyMessage::origin_identity, GSC_KeyExchangeInfo::other_ephemeral_key, GSC_KeyExchangeInfo::peer, GNUNET_PeerIdentity::public_key, EphemeralKeyMessage::purpose, REKEY_TOLERANCE, send_key(), send_ping(), EphemeralKeyMessage::sender_status, EphemeralKeyMessage::signature, GNUNET_CRYPTO_EccSignaturePurpose::size, and GSC_KeyExchangeInfo::status.

959 {
960  struct GSC_KeyExchangeInfo *kx = cls;
961  struct GNUNET_TIME_Absolute start_t;
962  struct GNUNET_TIME_Absolute end_t;
963  struct GNUNET_TIME_Absolute now;
964  enum GNUNET_CORE_KxState sender_status;
965 
968  (GNUNET_CORE_KX_STATE_UP == kx->status) ||
970  (end_t.abs_value_us < kx->foreign_key_expires.abs_value_us))
971  {
973  gettext_noop("# old ephemeral keys ignored"),
974  1,
975  GNUNET_NO);
977  "Received expired EPHEMERAL_KEY from %s\n",
979  return;
980  }
981  if (0 == memcmp(&m->ephemeral_key,
982  &kx->other_ephemeral_key,
983  sizeof(m->ephemeral_key)))
984  {
986  gettext_noop(
987  "# duplicate ephemeral keys ignored"),
988  1,
989  GNUNET_NO);
991  "Ignoring duplicate EPHEMERAL_KEY from %s\n",
993  return;
994  }
995  if (0 != memcmp(&m->origin_identity,
996  kx->peer,
997  sizeof(struct GNUNET_PeerIdentity)))
998  {
1000  "Received EPHEMERAL_KEY from %s, but expected %s\n",
1002  GNUNET_i2s_full(kx->peer));
1003  GNUNET_break_op(0);
1004  return;
1005  }
1006  if ((ntohl(m->purpose.size) !=
1007  sizeof(struct GNUNET_CRYPTO_EccSignaturePurpose) +
1008  sizeof(struct GNUNET_TIME_AbsoluteNBO) +
1009  sizeof(struct GNUNET_TIME_AbsoluteNBO) +
1010  sizeof(struct GNUNET_CRYPTO_EddsaPublicKey) +
1011  sizeof(struct GNUNET_CRYPTO_EddsaPublicKey)) ||
1012  (GNUNET_OK !=
1014  &m->purpose,
1015  &m->signature,
1017  {
1018  /* invalid signature */
1019  GNUNET_break_op(0);
1021  gettext_noop(
1022  "# EPHEMERAL_KEYs rejected (bad signature)"),
1023  1,
1024  GNUNET_NO);
1026  "Received EPHEMERAL_KEY from %s with bad signature\n",
1028  return;
1029  }
1030  now = GNUNET_TIME_absolute_get();
1032  if ((end_t.abs_value_us <
1034  (start_t.abs_value_us >
1035  GNUNET_TIME_absolute_add(now, REKEY_TOLERANCE).abs_value_us))
1036  {
1037  GNUNET_log(
1039  _(
1040  "EPHEMERAL_KEY from peer `%s' rejected as its validity range does not match our system time (%llu not in [%llu,%llu]).\n"),
1041  GNUNET_i2s(kx->peer),
1042  (unsigned long long)now.abs_value_us,
1043  (unsigned long long)start_t.abs_value_us,
1044  (unsigned long long)end_t.abs_value_us);
1046  gettext_noop(
1047  "# EPHEMERAL_KEY messages rejected due to time"),
1048  1,
1049  GNUNET_NO);
1050  return;
1051  }
1052 #if DEBUG_KX
1053  {
1054  struct GNUNET_HashCode eh;
1055 
1056  GNUNET_CRYPTO_hash(&m->ephemeral_key, sizeof(m->ephemeral_key), &eh);
1058  "Received valid EPHEMERAL_KEY `%s' from `%s' in state %d.\n",
1059  GNUNET_h2s(&eh),
1060  GNUNET_i2s(kx->peer),
1061  kx->status);
1062  }
1063 #endif
1065  gettext_noop("# valid ephemeral keys received"),
1066  1,
1067  GNUNET_NO);
1069  kx->foreign_key_expires = end_t;
1070  derive_session_keys(kx);
1071 
1072  /* check if we still need to send the sender our key */
1073  sender_status = (enum GNUNET_CORE_KxState)ntohl(m->sender_status);
1074  switch (sender_status)
1075  {
1077  GNUNET_break_op(0);
1078  break;
1079 
1081  /* fine, need to send our key after updating our status, see below */
1083  break;
1084 
1086  /* other peer already got our key, but typemap did go down */
1088  break;
1089 
1091  /* other peer already got our key, typemap NOT down */
1092  break;
1093 
1095  /* other peer already got our key, typemap NOT down */
1096  break;
1097 
1098  default:
1099  GNUNET_break(0);
1100  break;
1101  }
1102  /* check if we need to confirm everything is fine via PING + PONG */
1103  switch (kx->status)
1104  {
1106  GNUNET_assert(NULL == kx->keep_alive_task);
1108  monitor_notify_all(kx);
1109  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1110  send_key(kx);
1111  else
1112  send_ping(kx);
1113  break;
1114 
1116  GNUNET_assert(NULL == kx->keep_alive_task);
1118  monitor_notify_all(kx);
1119  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1120  send_key(kx);
1121  else
1122  send_ping(kx);
1123  break;
1124 
1126  GNUNET_assert(NULL == kx->keep_alive_task);
1127  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1128  send_key(kx);
1129  else
1130  send_ping(kx);
1131  break;
1132 
1135  monitor_notify_all(kx);
1136  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1137  send_key(kx);
1138  else
1139  send_ping(kx);
1140  break;
1141 
1143  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1144  send_key(kx);
1145  else
1146  send_ping(kx);
1147  break;
1148 
1149  default:
1150  GNUNET_break(0);
1151  break;
1152  }
1153 }
#define GNUNET_SIGNATURE_PURPOSE_SET_ECC_KEY
Purpose is to set a session key.
#define REKEY_TOLERANCE
What time difference do we tolerate?
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_subtract(struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Relative duration)
Subtract a given relative duration from the given start time.
Definition: time.c:420
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh(struct GNUNET_TIME_AbsoluteNBO a)
Convert absolute time from network byte order.
Definition: time.c:671
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
static void derive_session_keys(struct GSC_KeyExchangeInfo *kx)
Derive fresh session keys from the current ephemeral keys.
#define GNUNET_NO
Definition: gnunet_common.h:78
const char * GNUNET_i2s_full(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_add(struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Relative duration)
Add a given relative duration to the given start time.
Definition: time.c:393
GNUNET_CORE_KxState
State machine for our P2P encryption handshake.
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
We&#39;ve received the other peers session key.
Time for absolute time used by GNUnet, in microseconds and in network byte order. ...
uint64_t abs_value_us
The actual value.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
struct GNUNET_TIME_AbsoluteNBO expiration_time
When does the given ephemeral key expire (end of validity).
header of what an ECC signature signs this must be followed by "size - 8" bytes of the actual signed ...
struct GNUNET_CRYPTO_EddsaSignature signature
An ECC signature of the origin_identity asserting the validity of the given ephemeral key...
struct GNUNET_TIME_AbsoluteNBO creation_time
At what time was this key created (beginning of validity).
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
int GNUNET_CRYPTO_eddsa_verify(uint32_t purpose, const struct GNUNET_CRYPTO_EccSignaturePurpose *validate, const struct GNUNET_CRYPTO_EddsaSignature *sig, const struct GNUNET_CRYPTO_EddsaPublicKey *pub)
Verify EdDSA signature.
Definition: crypto_ecc.c:1116
static void send_ping(struct GSC_KeyExchangeInfo *kx)
Send our PING to the other peer.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
struct GNUNET_CRYPTO_EcdhePublicKey other_ephemeral_key
Ephemeral public ECC key of the other peer.
uint32_t size
How many bytes does this signature sign? (including this purpose header); in network byte order (!)...
Information about the status of a key exchange with another peer.
struct GNUNET_CRYPTO_EccSignaturePurpose purpose
Information about what is being signed.
A 512-bit hashcode.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get(void)
Get the current time.
Definition: time.c:118
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
struct GNUNET_CRYPTO_EcdhePublicKey ephemeral_key
Ephemeral public ECC key.
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
The identity of the host (wraps the signing key of the peer).
struct GNUNET_TIME_Absolute foreign_key_expires
At what time did the other peer generate the decryption key?
#define GNUNET_log(kind,...)
int32_t sender_status
Status of the sender (should be in enum PeerStateMachine), nbo.
Time for absolute times used by GNUnet, in microseconds.
We&#39;ve sent our session key.
struct GNUNET_PeerIdentity origin_identity
Public key of the signing peer (persistent version, not the ephemeral public key).
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
void GSC_SESSIONS_reinit(const struct GNUNET_PeerIdentity *peer)
The other peer has indicated that it &#39;lost&#39; the session (KX down), reinitialize the session on our en...
struct GNUNET_CRYPTO_EddsaPublicKey public_key
#define gettext_noop(String)
Definition: gettext.h:69
We&#39;re rekeying (or had a timeout), so we have sent the other peer our new ephemeral key...
Public ECC key (always for curve Ed25519) encoded in a format suitable for network transmission and E...
Here is the call graph for this function:

◆ handle_ping()

static void handle_ping ( void *  cls,
const struct PingMessage m 
)
static

We received a PING message.

Validate and transmit a PONG message.

Parameters
clskey exchange status for the corresponding peer
mthe encrypted PING message itself

Definition at line 1164 of file gnunet-service-core_kx.c.

References calculate_seed(), PingMessage::challenge, PongMessage::challenge, GSC_KeyExchangeInfo::decrypt_key, derive_iv(), derive_pong_iv(), do_decrypt(), do_encrypt(), GSC_KeyExchangeInfo::encrypt_key, env, gettext_noop, GNUNET_break_op, GNUNET_CORE_KX_STATE_KEY_RECEIVED, GNUNET_CORE_KX_STATE_REKEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_WARNING, GNUNET_i2s(), GNUNET_i2s2(), GNUNET_log, GNUNET_MESSAGE_TYPE_CORE_PONG, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_NO, GNUNET_OK, GNUNET_STATISTICS_update(), GSC_my_identity, GSC_stats, PingMessage::iv_seed, PongMessage::iv_seed, GSC_KeyExchangeInfo::mq, GSC_KeyExchangeInfo::peer, PongMessage::reserved, GSC_KeyExchangeInfo::status, PingMessage::target, and PongMessage::target.

1165 {
1166  struct GSC_KeyExchangeInfo *kx = cls;
1167  struct PingMessage t;
1168  struct PongMessage tx;
1169  struct PongMessage *tp;
1170  struct GNUNET_MQ_Envelope *env;
1172 
1174  gettext_noop("# PING messages received"),
1175  1,
1176  GNUNET_NO);
1178  (kx->status != GNUNET_CORE_KX_STATE_UP) &&
1180  {
1181  /* ignore */
1183  gettext_noop(
1184  "# PING messages dropped (out of order)"),
1185  1,
1186  GNUNET_NO);
1187  return;
1188  }
1190  "Core service receives PING request from `%s'.\n",
1191  GNUNET_i2s(kx->peer));
1192  derive_iv(&iv, &kx->decrypt_key, m->iv_seed, &GSC_my_identity);
1193  if (GNUNET_OK != do_decrypt(kx,
1194  &iv,
1195  &m->target,
1196  &t.target,
1197  sizeof(struct PingMessage) -
1198  ((void *)&m->target - (void *)m)))
1199  {
1200  GNUNET_break_op(0);
1201  return;
1202  }
1203  if (0 !=
1204  memcmp(&t.target, &GSC_my_identity, sizeof(struct GNUNET_PeerIdentity)))
1205  {
1208  "Decryption of PING from peer `%s' failed, PING for `%s'?\n",
1209  GNUNET_i2s(kx->peer),
1210  GNUNET_i2s2(&t.target));
1211  else
1212  GNUNET_log(
1214  "Decryption of PING from peer `%s' failed after rekey (harmless)\n",
1215  GNUNET_i2s(kx->peer));
1216  GNUNET_break_op(0);
1217  return;
1218  }
1219  /* construct PONG */
1220  tx.reserved = 0;
1221  tx.challenge = t.challenge;
1222  tx.target = t.target;
1224  tp->iv_seed = calculate_seed(kx);
1225  derive_pong_iv(&iv, &kx->encrypt_key, tp->iv_seed, t.challenge, kx->peer);
1226  do_encrypt(kx,
1227  &iv,
1228  &tx.challenge,
1229  &tp->challenge,
1230  sizeof(struct PongMessage) -
1231  ((void *)&tp->challenge - (void *)tp));
1233  gettext_noop("# PONG messages created"),
1234  1,
1235  GNUNET_NO);
1236  GNUNET_MQ_send(kx->mq, env);
1237 }
const char * GNUNET_i2s2(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
uint32_t iv_seed
Seed for the IV.
enum GNUNET_CORE_KxState status
What is our connection status?
struct GNUNET_PeerIdentity target
Intended target of the PING, used primarily to check that decryption actually worked.
Response to a PING.
static int do_encrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Encrypt size bytes from in and write the result to out.
#define GNUNET_MQ_msg(mvar, type)
Allocate a GNUNET_MQ_Envelope.
Definition: gnunet_mq_lib.h:67
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
static struct GNUNET_SCHEDULER_Task * t
Main task.
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
We&#39;ve received the other peers session key.
#define GNUNET_MESSAGE_TYPE_CORE_PONG
Confirmation that other peer is alive.
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
static int do_decrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Decrypt size bytes from in and write the result to out.
uint32_t challenge
Random number to make replay attacks harder.
We&#39;re sending an (encrypted) PING to the other peer to check if it can decrypt.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
uint32_t iv_seed
Seed for the IV.
Information about the status of a key exchange with another peer.
struct GNUNET_CRYPTO_SymmetricSessionKey decrypt_key
Key we use to decrypt messages from the other peer (given to us by the other peer during the handshak...
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
static uint32_t calculate_seed(struct GSC_KeyExchangeInfo *kx)
Calculate seed value we should use for a message.
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
static void derive_pong_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, uint32_t challenge, const struct GNUNET_PeerIdentity *identity)
Derive an IV from pong packet information.
The identity of the host (wraps the signing key of the peer).
static void derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, const struct GNUNET_PeerIdentity *identity)
Derive an IV from packet information.
#define GNUNET_log(kind,...)
struct GNUNET_CRYPTO_SymmetricSessionKey encrypt_key
Key we use to encrypt our messages for the other peer (initialized by us when we do the handshake)...
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define gettext_noop(String)
Definition: gettext.h:69
We&#39;re rekeying (or had a timeout), so we have sent the other peer our new ephemeral key...
Here is the call graph for this function:

◆ send_keep_alive()

static void send_keep_alive ( void *  cls)
static

Task triggered when a neighbour entry is about to time out (and we should prevent this by sending a PING).

Parameters
clsthe struct GSC_KeyExchangeInfo

Definition at line 1247 of file gnunet-service-core_kx.c.

References gettext_noop, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_SCHEDULER_add_delayed(), GNUNET_STATISTICS_update(), GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_relative_divide(), GNUNET_TIME_relative_max(), GSC_SESSIONS_end(), GSC_stats, GSC_KeyExchangeInfo::keep_alive_task, MIN_PING_FREQUENCY, monitor_notify_all(), GSC_KeyExchangeInfo::peer, GNUNET_TIME_Relative::rel_value_us, send_key(), send_ping(), setup_fresh_ping(), GSC_KeyExchangeInfo::status, and GSC_KeyExchangeInfo::timeout.

Referenced by update_timeout().

1248 {
1249  struct GSC_KeyExchangeInfo *kx = cls;
1250  struct GNUNET_TIME_Relative retry;
1251  struct GNUNET_TIME_Relative left;
1252 
1253  kx->keep_alive_task = NULL;
1255  if (0 == left.rel_value_us)
1256  {
1258  gettext_noop("# sessions terminated by timeout"),
1259  1,
1260  GNUNET_NO);
1261  GSC_SESSIONS_end(kx->peer);
1263  monitor_notify_all(kx);
1264  send_key(kx);
1265  return;
1266  }
1268  "Sending KEEPALIVE to `%s'\n",
1269  GNUNET_i2s(kx->peer));
1271  gettext_noop("# keepalive messages sent"),
1272  1,
1273  GNUNET_NO);
1274  setup_fresh_ping(kx);
1275  send_ping(kx);
1278  kx->keep_alive_task =
1280 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
struct GNUNET_TIME_Relative GNUNET_TIME_relative_max(struct GNUNET_TIME_Relative t1, struct GNUNET_TIME_Relative t2)
Return the maximum of two relative time values.
Definition: time.c:287
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
#define GNUNET_NO
Definition: gnunet_common.h:78
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
static void send_ping(struct GSC_KeyExchangeInfo *kx)
Send our PING to the other peer.
static void send_keep_alive(void *cls)
Task triggered when a neighbour entry is about to time out (and we should prevent this by sending a P...
#define MIN_PING_FREQUENCY
What is the minimum frequency for a PING message?
Information about the status of a key exchange with another peer.
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
static void setup_fresh_ping(struct GSC_KeyExchangeInfo *kx)
Create a fresh PING message for transmission to the other peer.
#define GNUNET_log(kind,...)
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_remaining(struct GNUNET_TIME_Absolute future)
Given a timestamp in the future, how much time remains until then?
Definition: time.c:331
struct GNUNET_TIME_Absolute timeout
When should the session time out (if there are no PONGs)?
struct GNUNET_TIME_Relative GNUNET_TIME_relative_divide(struct GNUNET_TIME_Relative rel, unsigned long long factor)
Divide relative time by a given factor.
Definition: time.c:525
We&#39;ve sent our session key.
void GSC_SESSIONS_end(const struct GNUNET_PeerIdentity *pid)
End the session with the given peer (we are no longer connected).
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Time for relative time used by GNUnet, in microseconds.
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ update_timeout()

static void update_timeout ( struct GSC_KeyExchangeInfo kx)
static

We've seen a valid message from the other peer.

Update the time when the session would time out and delay sending our keep alive message further.

Parameters
kxkey exchange where we saw activity

Definition at line 1291 of file gnunet-service-core_kx.c.

References GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, GNUNET_SCHEDULER_add_delayed(), GNUNET_SCHEDULER_cancel(), GNUNET_TIME_absolute_get_difference(), GNUNET_TIME_relative_divide(), GNUNET_TIME_relative_to_absolute(), GSC_KeyExchangeInfo::keep_alive_task, GSC_KeyExchangeInfo::last_notify_timeout, monitor_notify_all(), GNUNET_TIME_Relative::rel_value_us, send_keep_alive(), and GSC_KeyExchangeInfo::timeout.

Referenced by handle_encrypted(), and handle_pong().

1292 {
1293  struct GNUNET_TIME_Relative delta;
1294 
1295  kx->timeout =
1297  delta =
1299  if (delta.rel_value_us > 5LL * 1000LL * 1000LL)
1300  {
1301  /* we only notify monitors about timeout changes if those
1302  are bigger than the threshold (5s) */
1303  monitor_notify_all(kx);
1304  }
1305  if (NULL != kx->keep_alive_task)
1309  &send_keep_alive,
1310  kx);
1311 }
uint64_t rel_value_us
The actual value.
static struct GNUNET_TIME_Relative delta
Definition: speedup.c:35
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
struct GNUNET_TIME_Absolute last_notify_timeout
What was the last timeout we informed our monitors about?
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
static void send_keep_alive(void *cls)
Task triggered when a neighbour entry is about to time out (and we should prevent this by sending a P...
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
#define GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT
After how long do we consider a connection to a peer dead if we don&#39;t receive messages from the peer...
struct GNUNET_TIME_Absolute timeout
When should the session time out (if there are no PONGs)?
struct GNUNET_TIME_Relative GNUNET_TIME_relative_divide(struct GNUNET_TIME_Relative rel, unsigned long long factor)
Divide relative time by a given factor.
Definition: time.c:525
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_difference(struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Absolute end)
Compute the time difference between the given start and end times.
Definition: time.c:353
Time for relative time used by GNUnet, in microseconds.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
Here is the call graph for this function:
Here is the caller graph for this function:

◆ handle_pong()

static void handle_pong ( void *  cls,
const struct PongMessage m 
)
static

We received a PONG message.

Validate and update our status.

Parameters
kxkey exchange context for the the PONG
mthe encrypted PONG message itself

Definition at line 1321 of file gnunet-service-core_kx.c.

References PongMessage::challenge, GSC_KeyExchangeInfo::decrypt_key, derive_pong_iv(), do_decrypt(), gettext_noop, GNUNET_assert, GNUNET_break, GNUNET_break_op, GNUNET_CORE_KX_STATE_DOWN, GNUNET_CORE_KX_STATE_KEY_RECEIVED, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CORE_KX_STATE_REKEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_SCHEDULER_cancel(), GNUNET_STATISTICS_update(), GSC_my_identity, GSC_SESSIONS_create(), GSC_stats, PongMessage::iv_seed, GSC_KeyExchangeInfo::keep_alive_task, monitor_notify_all(), GSC_KeyExchangeInfo::peer, GSC_KeyExchangeInfo::ping_challenge, GSC_KeyExchangeInfo::retry_set_key_task, GSC_KeyExchangeInfo::status, PongMessage::target, and update_timeout().

1322 {
1323  struct GSC_KeyExchangeInfo *kx = cls;
1324  struct PongMessage t;
1326 
1328  gettext_noop("# PONG messages received"),
1329  1,
1330  GNUNET_NO);
1331  switch (kx->status)
1332  {
1335  gettext_noop(
1336  "# PONG messages dropped (connection down)"),
1337  1,
1338  GNUNET_NO);
1339  return;
1340 
1343  gettext_noop(
1344  "# PONG messages dropped (out of order)"),
1345  1,
1346  GNUNET_NO);
1347  return;
1348 
1350  break;
1351 
1353  break;
1354 
1356  break;
1357 
1358  default:
1359  GNUNET_break(0);
1360  return;
1361  }
1363  "Core service receives PONG response from `%s'.\n",
1364  GNUNET_i2s(kx->peer));
1365  /* mark as garbage, just to be sure */
1366  memset(&t, 255, sizeof(t));
1367  derive_pong_iv(&iv,
1368  &kx->decrypt_key,
1369  m->iv_seed,
1370  kx->ping_challenge,
1371  &GSC_my_identity);
1372  if (GNUNET_OK != do_decrypt(kx,
1373  &iv,
1374  &m->challenge,
1375  &t.challenge,
1376  sizeof(struct PongMessage) -
1377  ((void *)&m->challenge - (void *)m)))
1378  {
1379  GNUNET_break_op(0);
1380  return;
1381  }
1383  gettext_noop("# PONG messages decrypted"),
1384  1,
1385  GNUNET_NO);
1386  if ((0 !=
1387  memcmp(&t.target, kx->peer, sizeof(struct GNUNET_PeerIdentity))) ||
1388  (kx->ping_challenge != t.challenge))
1389  {
1390  /* PONG malformed */
1392  "Received malformed PONG wanted sender `%s' with challenge %u\n",
1393  GNUNET_i2s(kx->peer),
1394  (unsigned int)kx->ping_challenge);
1396  "Received malformed PONG received from `%s' with challenge %u\n",
1397  GNUNET_i2s(&t.target),
1398  (unsigned int)t.challenge);
1399  return;
1400  }
1402  "Received valid PONG from `%s'\n",
1403  GNUNET_i2s(kx->peer));
1404  /* no need to resend key any longer */
1405  if (NULL != kx->retry_set_key_task)
1406  {
1408  kx->retry_set_key_task = NULL;
1409  }
1410  switch (kx->status)
1411  {
1413  GNUNET_assert(0); /* should be impossible */
1414  return;
1415 
1417  GNUNET_assert(0); /* should be impossible */
1418  return;
1419 
1422  gettext_noop(
1423  "# session keys confirmed via PONG"),
1424  1,
1425  GNUNET_NO);
1427  monitor_notify_all(kx);
1428  GSC_SESSIONS_create(kx->peer, kx);
1429  GNUNET_assert(NULL == kx->keep_alive_task);
1430  update_timeout(kx);
1431  break;
1432 
1435  gettext_noop("# timeouts prevented via PONG"),
1436  1,
1437  GNUNET_NO);
1438  update_timeout(kx);
1439  break;
1440 
1443  gettext_noop(
1444  "# rekey operations confirmed via PONG"),
1445  1,
1446  GNUNET_NO);
1448  monitor_notify_all(kx);
1449  update_timeout(kx);
1450  break;
1451 
1452  default:
1453  GNUNET_break(0);
1454  break;
1455  }
1456 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
Response to a PING.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
static struct GNUNET_SCHEDULER_Task * t
Main task.
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
We&#39;ve received the other peers session key.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
struct GNUNET_SCHEDULER_Task * retry_set_key_task
ID of task used for re-trying SET_KEY and PING message.
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
static int do_decrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Decrypt size bytes from in and write the result to out.
uint32_t challenge
Random number to make replay attacks harder.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
uint32_t iv_seed
Seed for the IV.
uint32_t ping_challenge
What was our PING challenge number (for this peer)?
Information about the status of a key exchange with another peer.
struct GNUNET_CRYPTO_SymmetricSessionKey decrypt_key
Key we use to decrypt messages from the other peer (given to us by the other peer during the handshak...
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
static void update_timeout(struct GSC_KeyExchangeInfo *kx)
We&#39;ve seen a valid message from the other peer.
void GSC_SESSIONS_create(const struct GNUNET_PeerIdentity *peer, struct GSC_KeyExchangeInfo *kx)
Create a session, a key exchange was just completed.
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
static void derive_pong_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, uint32_t challenge, const struct GNUNET_PeerIdentity *identity)
Derive an IV from pong packet information.
The identity of the host (wraps the signing key of the peer).
#define GNUNET_log(kind,...)
We&#39;ve sent our session key.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define gettext_noop(String)
Definition: gettext.h:69
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
We&#39;re rekeying (or had a timeout), so we have sent the other peer our new ephemeral key...
Here is the call graph for this function:

◆ GSC_KX_encrypt_and_transmit()

void GSC_KX_encrypt_and_transmit ( struct GSC_KeyExchangeInfo kx,
const void *  payload,
size_t  payload_size 
)

Encrypt and transmit a message with the given payload.

Parameters
kxkey exchange context
payloadpayload of the message
payload_sizenumber of bytes in payload

Definition at line 1510 of file gnunet-service-core_kx.c.

References calculate_seed(), derive_auth_key(), derive_iv(), do_encrypt(), GSC_KeyExchangeInfo::encrypt_key, ENCRYPTED_HEADER_SIZE, env, GNUNET_assert, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hmac(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_h2s(), GNUNET_h2s2(), GNUNET_i2s(), GNUNET_log, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_NO, GNUNET_OK, GNUNET_TIME_absolute_get(), GNUNET_TIME_absolute_hton(), GSC_KeyExchangeInfo::has_excess_bandwidth, EncryptedMessage::hmac, EncryptedMessage::iv_seed, GSC_KeyExchangeInfo::last_sequence_number_sent, GSC_KeyExchangeInfo::mq, GSC_KeyExchangeInfo::peer, ph, and EncryptedMessage::sequence_number.

Referenced by transmit_typemap_task(), and try_transmission().

1513 {
1514  size_t used = payload_size + sizeof(struct EncryptedMessage);
1515  char pbuf[used]; /* plaintext */
1516  struct EncryptedMessage *em; /* encrypted message */
1517  struct EncryptedMessage *ph; /* plaintext header */
1518  struct GNUNET_MQ_Envelope *env;
1520  struct GNUNET_CRYPTO_AuthKey auth_key;
1521 
1522  ph = (struct EncryptedMessage *)pbuf;
1523  ph->sequence_number = htonl(++kx->last_sequence_number_sent);
1524  ph->iv_seed = calculate_seed(kx);
1525  ph->reserved = 0;
1527  GNUNET_memcpy(&ph[1], payload, payload_size);
1528  env = GNUNET_MQ_msg_extra(em,
1529  payload_size,
1531  em->iv_seed = ph->iv_seed;
1532  derive_iv(&iv, &kx->encrypt_key, ph->iv_seed, kx->peer);
1534  &iv,
1535  &ph->sequence_number,
1536  &em->sequence_number,
1537  used - ENCRYPTED_HEADER_SIZE));
1538 #if DEBUG_KX
1539  {
1540  struct GNUNET_HashCode hc;
1541 
1542  GNUNET_CRYPTO_hash(&ph->sequence_number,
1543  used - ENCRYPTED_HEADER_SIZE,
1544  &hc);
1546  "Encrypted payload `%s' of %u bytes for %s\n",
1547  GNUNET_h2s(&hc),
1548  (unsigned int)(used - ENCRYPTED_HEADER_SIZE),
1549  GNUNET_i2s(kx->peer));
1550  }
1551 #endif
1552  derive_auth_key(&auth_key, &kx->encrypt_key, ph->iv_seed);
1553  GNUNET_CRYPTO_hmac(&auth_key,
1554  &em->sequence_number,
1555  used - ENCRYPTED_HEADER_SIZE,
1556  &em->hmac);
1557 #if DEBUG_KX
1558  {
1559  struct GNUNET_HashCode hc;
1560 
1561  GNUNET_CRYPTO_hash(&auth_key, sizeof(auth_key), &hc);
1563  "For peer %s, used AC %s to create hmac %s\n",
1564  GNUNET_i2s(kx->peer),
1565  GNUNET_h2s(&hc),
1566  GNUNET_h2s2(&em->hmac));
1567  }
1568 #endif
1570  GNUNET_MQ_send(kx->mq, env);
1571 }
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
uint32_t sequence_number
Sequence number, in network byte order.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static struct GNUNET_ATS_PerformanceHandle * ph
ATS performance handle used.
Definition: gnunet-ats.c:116
uint32_t last_sequence_number_sent
last sequence number transmitted
static int do_encrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Encrypt size bytes from in and write the result to out.
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
#define GNUNET_NO
Definition: gnunet_common.h:78
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
struct GNUNET_HashCode hmac
MAC of the encrypted message (starting at sequence_number), used to verify message integrity...
static void derive_auth_key(struct GNUNET_CRYPTO_AuthKey *akey, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed)
Derive an authentication key from "set key" information.
void GNUNET_CRYPTO_hmac(const struct GNUNET_CRYPTO_AuthKey *key, const void *plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
Calculate HMAC of a message (RFC 2104)
Definition: crypto_hash.c:418
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
const char * GNUNET_h2s2(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
#define GNUNET_MQ_msg_extra(mvar, esize, type)
Allocate an envelope, with extra space allocated after the space needed by the message struct...
Definition: gnunet_mq_lib.h:52
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
Encapsulation for encrypted messages exchanged between peers.
A 512-bit hashcode.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get(void)
Get the current time.
Definition: time.c:118
uint32_t iv_seed
Random value used for IV generation.
static uint32_t calculate_seed(struct GSC_KeyExchangeInfo *kx)
Calculate seed value we should use for a message.
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
static unsigned long long payload
How much data are we currently storing in the database?
#define ENCRYPTED_HEADER_SIZE
Number of bytes (at the beginning) of struct EncryptedMessage that are NOT encrypted.
#define GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE
Encapsulation for an encrypted message between peers.
static void derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, const struct GNUNET_PeerIdentity *identity)
Derive an IV from packet information.
int has_excess_bandwidth
GNUNET_YES if this peer currently has excess bandwidth.
#define GNUNET_log(kind,...)
struct GNUNET_CRYPTO_SymmetricSessionKey encrypt_key
Key we use to encrypt our messages for the other peer (initialized by us when we do the handshake)...
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:655
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
type for (message) authentication keys
Here is the call graph for this function:
Here is the caller graph for this function:

◆ check_encrypted()

static int check_encrypted ( void *  cls,
const struct EncryptedMessage m 
)
static

We received an encrypted message.

Check that it is well-formed (size-wise).

Parameters
clskey exchange context for encrypting the message
mencrypted message
Returns
GNUNET_OK if msg is well-formed (size-wise)

Definition at line 1583 of file gnunet-service-core_kx.c.

References GNUNET_break_op, GNUNET_OK, GNUNET_SYSERR, EncryptedMessage::header, size, and GNUNET_MessageHeader::size.

1584 {
1585  uint16_t size = ntohs(m->header.size) - sizeof(*m);
1586 
1587  if (size < sizeof(struct GNUNET_MessageHeader))
1588  {
1589  GNUNET_break_op(0);
1590  return GNUNET_SYSERR;
1591  }
1592  return GNUNET_OK;
1593 }
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
struct GNUNET_MessageHeader header
Message type is GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
static unsigned int size
Size of the "table".
Definition: peer.c:66
Header for all communications.

◆ handle_encrypted()

static void handle_encrypted ( void *  cls,
const struct EncryptedMessage m 
)
static

We received an encrypted message.

Decrypt, validate and pass on to the appropriate clients.

Parameters
clskey exchange context for encrypting the message
mencrypted message

Definition at line 1604 of file gnunet-service-core_kx.c.

References _, buf, GSC_KeyExchangeInfo::decrypt_key, derive_auth_key(), derive_iv(), do_decrypt(), ENCRYPTED_HEADER_SIZE, GSC_KeyExchangeInfo::foreign_key_expires, gettext_noop, GNUNET_ALIGN, GNUNET_break_op, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hmac(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_WARNING, GNUNET_h2s(), GNUNET_h2s2(), GNUNET_i2s(), GNUNET_log, GNUNET_MST_from_buffer(), GNUNET_NO, GNUNET_OK, GNUNET_SCHEDULER_cancel(), GNUNET_STATISTICS_update(), GNUNET_STRINGS_relative_time_to_string(), GNUNET_TIME_absolute_get_duration(), GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_absolute_ntoh(), GNUNET_YES, GSC_my_identity, GSC_SESSIONS_end(), GSC_stats, EncryptedMessage::header, EncryptedMessage::hmac, EncryptedMessage::iv_seed, GSC_KeyExchangeInfo::keep_alive_task, GSC_KeyExchangeInfo::last_packets_bitmap, GSC_KeyExchangeInfo::last_sequence_number_received, MAX_MESSAGE_AGE, monitor_notify_all(), GSC_KeyExchangeInfo::mst, GSC_KeyExchangeInfo::peer, GNUNET_TIME_Relative::rel_value_us, send_key(), EncryptedMessage::sequence_number, size, GNUNET_MessageHeader::size, GSC_KeyExchangeInfo::status, EncryptedMessage::timestamp, and update_timeout().

1605 {
1606  struct GSC_KeyExchangeInfo *kx = cls;
1607  struct EncryptedMessage *pt; /* plaintext */
1608  struct GNUNET_HashCode ph;
1609  uint32_t snum;
1610  struct GNUNET_TIME_Absolute t;
1612  struct GNUNET_CRYPTO_AuthKey auth_key;
1613  uint16_t size = ntohs(m->header.size);
1614  char buf[size] GNUNET_ALIGN;
1615 
1616  if (GNUNET_CORE_KX_STATE_UP != kx->status)
1617  {
1619  gettext_noop(
1620  "# DATA message dropped (out of order)"),
1621  1,
1622  GNUNET_NO);
1623  return;
1624  }
1625  if (0 ==
1627  {
1628  GNUNET_log(
1630  _(
1631  "Session to peer `%s' went down due to key expiration (should not happen)\n"),
1632  GNUNET_i2s(kx->peer));
1634  gettext_noop(
1635  "# sessions terminated by key expiration"),
1636  1,
1637  GNUNET_NO);
1638  GSC_SESSIONS_end(kx->peer);
1639  if (NULL != kx->keep_alive_task)
1640  {
1642  kx->keep_alive_task = NULL;
1643  }
1645  monitor_notify_all(kx);
1646  send_key(kx);
1647  return;
1648  }
1649 
1650  /* validate hash */
1651 #if DEBUG_KX
1652  {
1653  struct GNUNET_HashCode hc;
1654 
1657  "Received encrypted payload `%s' of %u bytes from %s\n",
1658  GNUNET_h2s(&hc),
1659  (unsigned int)(size - ENCRYPTED_HEADER_SIZE),
1660  GNUNET_i2s(kx->peer));
1661  }
1662 #endif
1663  derive_auth_key(&auth_key, &kx->decrypt_key, m->iv_seed);
1664  GNUNET_CRYPTO_hmac(&auth_key,
1665  &m->sequence_number,
1666  size - ENCRYPTED_HEADER_SIZE,
1667  &ph);
1668 #if DEBUG_KX
1669  {
1670  struct GNUNET_HashCode hc;
1671 
1672  GNUNET_CRYPTO_hash(&auth_key, sizeof(auth_key), &hc);
1674  "For peer %s, used AC %s to verify hmac %s\n",
1675  GNUNET_i2s(kx->peer),
1676  GNUNET_h2s(&hc),
1677  GNUNET_h2s2(&m->hmac));
1678  }
1679 #endif
1680  if (0 != memcmp(&ph, &m->hmac, sizeof(struct GNUNET_HashCode)))
1681  {
1682  /* checksum failed */
1684  "Failed checksum validation for a message from `%s'\n",
1685  GNUNET_i2s(kx->peer));
1686  return;
1687  }
1688  derive_iv(&iv, &kx->decrypt_key, m->iv_seed, &GSC_my_identity);
1689  /* decrypt */
1690  if (GNUNET_OK != do_decrypt(kx,
1691  &iv,
1692  &m->sequence_number,
1694  size - ENCRYPTED_HEADER_SIZE))
1695  {
1696  GNUNET_break_op(0);
1697  return;
1698  }
1700  "Decrypted %u bytes from %s\n",
1701  (unsigned int)(size - ENCRYPTED_HEADER_SIZE),
1702  GNUNET_i2s(kx->peer));
1703  pt = (struct EncryptedMessage *)buf;
1704 
1705  /* validate sequence number */
1706  snum = ntohl(pt->sequence_number);
1707  if (kx->last_sequence_number_received == snum)
1708  {
1710  "Received duplicate message, ignoring.\n");
1711  /* duplicate, ignore */
1713  gettext_noop("# bytes dropped (duplicates)"),
1714  size,
1715  GNUNET_NO);
1716  return;
1717  }
1718  if ((kx->last_sequence_number_received > snum) &&
1719  (kx->last_sequence_number_received - snum > 32))
1720  {
1722  "Received ancient out of sequence message, ignoring.\n");
1723  /* ancient out of sequence, ignore */
1725  gettext_noop(
1726  "# bytes dropped (out of sequence)"),
1727  size,
1728  GNUNET_NO);
1729  return;
1730  }
1731  if (kx->last_sequence_number_received > snum)
1732  {
1733  uint32_t rotbit = 1U << (kx->last_sequence_number_received - snum - 1);
1734 
1735  if ((kx->last_packets_bitmap & rotbit) != 0)
1736  {
1738  "Received duplicate message, ignoring.\n");
1740  gettext_noop("# bytes dropped (duplicates)"),
1741  size,
1742  GNUNET_NO);
1743  /* duplicate, ignore */
1744  return;
1745  }
1746  kx->last_packets_bitmap |= rotbit;
1747  }
1748  if (kx->last_sequence_number_received < snum)
1749  {
1750  unsigned int shift = (snum - kx->last_sequence_number_received);
1751 
1752  if (shift >= 8 * sizeof(kx->last_packets_bitmap))
1753  kx->last_packets_bitmap = 0;
1754  else
1755  kx->last_packets_bitmap <<= shift;
1756  kx->last_sequence_number_received = snum;
1757  }
1758 
1759  /* check timestamp */
1761  if (GNUNET_TIME_absolute_get_duration(t).rel_value_us >
1762  MAX_MESSAGE_AGE.rel_value_us)
1763  {
1765  "Message received far too old (%s). Content ignored.\n",
1768  GNUNET_YES));
1770  gettext_noop(
1771  "# bytes dropped (ancient message)"),
1772  size,
1773  GNUNET_NO);
1774  return;
1775  }
1776 
1777  /* process decrypted message(s) */
1778  update_timeout(kx);
1780  gettext_noop("# bytes of payload decrypted"),
1781  size - sizeof(struct EncryptedMessage),
1782  GNUNET_NO);
1783  if (GNUNET_OK !=
1785  &buf[sizeof(struct EncryptedMessage)],
1786  size - sizeof(struct EncryptedMessage),
1787  GNUNET_YES,
1788  GNUNET_NO))
1789  GNUNET_break_op(0);
1790 }
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh(struct GNUNET_TIME_AbsoluteNBO a)
Convert absolute time from network byte order.
Definition: time.c:671
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
uint64_t rel_value_us
The actual value.
enum GNUNET_CORE_KxState status
What is our connection status?
uint32_t last_packets_bitmap
Bit map indicating which of the 32 sequence numbers before the last were received (good for accepting...
uint32_t sequence_number
Sequence number, in network byte order.
static struct GNUNET_ATS_PerformanceHandle * ph
ATS performance handle used.
Definition: gnunet-ats.c:116
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static struct GNUNET_SCHEDULER_Task * t
Main task.
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
struct GNUNET_HashCode hmac
MAC of the encrypted message (starting at sequence_number), used to verify message integrity...
struct GNUNET_STATISTICS_Handle * GSC_stats
For creating statistics.
struct GNUNET_MessageStreamTokenizer * mst
Our message stream tokenizer (for encrypted payload).
static void derive_auth_key(struct GNUNET_CRYPTO_AuthKey *akey, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed)
Derive an authentication key from "set key" information.
void GNUNET_CRYPTO_hmac(const struct GNUNET_CRYPTO_AuthKey *key, const void *plaintext, size_t plaintext_len, struct GNUNET_HashCode *hmac)
Calculate HMAC of a message (RFC 2104)
Definition: crypto_hash.c:418
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
struct GNUNET_MessageHeader header
Message type is GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE.
const char * GNUNET_h2s2(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
static int do_decrypt(struct GSC_KeyExchangeInfo *kx, const struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const void *in, void *out, size_t size)
Decrypt size bytes from in and write the result to out.
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
Encapsulation for encrypted messages exchanged between peers.
const char * GNUNET_STRINGS_relative_time_to_string(struct GNUNET_TIME_Relative delta, int do_round)
Give relative time in human-readable fancy format.
Definition: strings.c:686
static char buf[2048]
int GNUNET_MST_from_buffer(struct GNUNET_MessageStreamTokenizer *mst, const char *buf, size_t size, int purge, int one_shot)
Add incoming data to the receive buffer and call the callback for all complete messages.
Definition: mst.c:113
Information about the status of a key exchange with another peer.
A 512-bit hashcode.
struct GNUNET_CRYPTO_SymmetricSessionKey decrypt_key
Key we use to decrypt messages from the other peer (given to us by the other peer during the handshak...
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
struct GNUNET_SCHEDULER_Task * keep_alive_task
ID of task used for sending keep-alive pings.
static void update_timeout(struct GSC_KeyExchangeInfo *kx)
We&#39;ve seen a valid message from the other peer.
static unsigned int size
Size of the "table".
Definition: peer.c:66
uint32_t iv_seed
Random value used for IV generation.
#define MAX_MESSAGE_AGE
What is the maximum age of a message for us to consider processing it? Note that this looks at the ti...
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
#define ENCRYPTED_HEADER_SIZE
Number of bytes (at the beginning) of struct EncryptedMessage that are NOT encrypted.
static void derive_iv(struct GNUNET_CRYPTO_SymmetricInitializationVector *iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *skey, uint32_t seed, const struct GNUNET_PeerIdentity *identity)
Derive an IV from packet information.
#define GNUNET_ALIGN
gcc-ism to force alignment; we use this to align char-arrays that may then be cast to &#39;struct&#39;s...
uint32_t last_sequence_number_received
last sequence number received on this connection (highest)
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_duration(struct GNUNET_TIME_Absolute whence)
Get the duration of an operation as the difference of the current time and the given start time "henc...
Definition: time.c:373
struct GNUNET_TIME_Absolute foreign_key_expires
At what time did the other peer generate the decryption key?
#define GNUNET_log(kind,...)
struct GNUNET_TIME_Relative GNUNET_TIME_absolute_get_remaining(struct GNUNET_TIME_Absolute future)
Given a timestamp in the future, how much time remains until then?
Definition: time.c:331
Time for absolute times used by GNUnet, in microseconds.
#define GNUNET_YES
Definition: gnunet_common.h:77
We&#39;ve sent our session key.
void GSC_SESSIONS_end(const struct GNUNET_PeerIdentity *pid)
End the session with the given peer (we are no longer connected).
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
struct GNUNET_TIME_AbsoluteNBO timestamp
Timestamp.
type for (message) authentication keys
#define gettext_noop(String)
Definition: gettext.h:69
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
Here is the call graph for this function:

◆ handle_transport_notify_excess_bw()

static void handle_transport_notify_excess_bw ( void *  cls,
const struct GNUNET_PeerIdentity pid,
void *  connect_cls 
)
static

One of our neighbours has excess bandwidth, remember this.

Parameters
clsNULL
pididentity of the peer with excess bandwidth
connect_clsthe struct Neighbour

Definition at line 1801 of file gnunet-service-core_kx.c.

References GNUNET_ERROR_TYPE_DEBUG, GNUNET_i2s(), GNUNET_log, GNUNET_YES, GSC_SESSIONS_solicit(), and GSC_KeyExchangeInfo::has_excess_bandwidth.

Referenced by GSC_KX_init().

1804 {
1805  struct GSC_KeyExchangeInfo *kx = connect_cls;
1806 
1808  "Peer %s has excess bandwidth available\n",
1809  GNUNET_i2s(pid));
1811  GSC_SESSIONS_solicit(pid);
1812 }
Information about the status of a key exchange with another peer.
void GSC_SESSIONS_solicit(const struct GNUNET_PeerIdentity *pid)
Traffic is being solicited for the given peer.
int has_excess_bandwidth
GNUNET_YES if this peer currently has excess bandwidth.
#define GNUNET_log(kind,...)
#define GNUNET_YES
Definition: gnunet_common.h:77
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ sign_ephemeral_key()

static void sign_ephemeral_key ( )
static

Setup the message that links the ephemeral key to our persistent public key and generate the appropriate signature.

Definition at line 1820 of file gnunet-service-core_kx.c.

References EphemeralKeyMessage::creation_time, current_ekm, EphemeralKeyMessage::ephemeral_key, EphemeralKeyMessage::expiration_time, GNUNET_assert, GNUNET_CONFIGURATION_get_value_yesno(), GNUNET_CRYPTO_ecdhe_key_get_public(), GNUNET_CRYPTO_eddsa_sign(), GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY, GNUNET_OK, GNUNET_SIGNATURE_PURPOSE_SET_ECC_KEY, GNUNET_TIME_absolute_get(), GNUNET_TIME_absolute_hton(), GNUNET_TIME_relative_add(), GNUNET_TIME_relative_to_absolute(), GNUNET_TIME_UNIT_FOREVER_ABS, GNUNET_YES, GSC_cfg, GSC_my_identity, EphemeralKeyMessage::header, EphemeralKeyMessage::origin_identity, EphemeralKeyMessage::purpose, GNUNET_CRYPTO_EccSignaturePurpose::purpose, REKEY_FREQUENCY, REKEY_TOLERANCE, EphemeralKeyMessage::sender_status, EphemeralKeyMessage::signature, GNUNET_CRYPTO_EccSignaturePurpose::size, GNUNET_MessageHeader::size, and GNUNET_MessageHeader::type.

Referenced by do_rekey(), and GSC_KX_init().

1821 {
1822  current_ekm.header.size = htons(sizeof(struct EphemeralKeyMessage));
1824  current_ekm.sender_status = 0; /* to be set later */
1827  htonl(sizeof(struct GNUNET_CRYPTO_EccSignaturePurpose) +
1828  sizeof(struct GNUNET_TIME_AbsoluteNBO) +
1829  sizeof(struct GNUNET_TIME_AbsoluteNBO) +
1830  sizeof(struct GNUNET_CRYPTO_EcdhePublicKey) +
1831  sizeof(struct GNUNET_PeerIdentity));
1835  "core",
1836  "USE_EPHEMERAL_KEYS"))
1837  {
1841  }
1842  else
1843  {
1846  }
1854 }
#define GNUNET_SIGNATURE_PURPOSE_SET_ECC_KEY
Purpose is to set a session key.
#define REKEY_TOLERANCE
What time difference do we tolerate?
uint32_t purpose
What does this signature vouch for? This must contain a GNUNET_SIGNATURE_PURPOSE_XXX constant (from g...
static struct GNUNET_CRYPTO_EcdhePrivateKey * my_ephemeral_key
Our ephemeral private key.
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
int GNUNET_CRYPTO_eddsa_sign(const struct GNUNET_CRYPTO_EddsaPrivateKey *priv, const struct GNUNET_CRYPTO_EccSignaturePurpose *purpose, struct GNUNET_CRYPTO_EddsaSignature *sig)
EdDSA sign a given block.
Definition: crypto_ecc.c:989
static struct GNUNET_CRYPTO_EddsaPrivateKey * my_private_key
Our private key.
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
Time for absolute time used by GNUnet, in microseconds and in network byte order. ...
#define GNUNET_TIME_UNIT_FOREVER_ABS
Constant used to specify "forever".
struct GNUNET_TIME_AbsoluteNBO expiration_time
When does the given ephemeral key expire (end of validity).
header of what an ECC signature signs this must be followed by "size - 8" bytes of the actual signed ...
struct GNUNET_CRYPTO_EddsaSignature signature
An ECC signature of the origin_identity asserting the validity of the given ephemeral key...
struct GNUNET_TIME_AbsoluteNBO creation_time
At what time was this key created (beginning of validity).
uint16_t type
The type of the message (GNUNET_MESSAGE_TYPE_XXXX), in big-endian format.
uint32_t size
How many bytes does this signature sign? (including this purpose header); in network byte order (!)...
struct GNUNET_CRYPTO_EccSignaturePurpose purpose
Information about what is being signed.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get(void)
Get the current time.
Definition: time.c:118
#define GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY
Session key exchange between peers.
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
void GNUNET_CRYPTO_ecdhe_key_get_public(const struct GNUNET_CRYPTO_EcdhePrivateKey *priv, struct GNUNET_CRYPTO_EcdhePublicKey *pub)
Extract the public key for the given private key.
Definition: crypto_ecc.c:303
struct GNUNET_CRYPTO_EcdhePublicKey ephemeral_key
Ephemeral public ECC key.
struct GNUNET_TIME_Relative GNUNET_TIME_relative_add(struct GNUNET_TIME_Relative a1, struct GNUNET_TIME_Relative a2)
Add relative times together.
Definition: time.c:577
The identity of the host (wraps the signing key of the peer).
#define REKEY_FREQUENCY
How often do we rekey?
struct GNUNET_MessageHeader header
Message type is GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY.
Public ECC key (always for Curve25519) encoded in a format suitable for network transmission and encr...
int32_t sender_status
Status of the sender (should be in enum PeerStateMachine), nbo.
#define GNUNET_YES
Definition: gnunet_common.h:77
static struct EphemeralKeyMessage current_ekm
Current message we send for a key exchange.
Message transmitted with the signed ephemeral key of a peer.
struct GNUNET_PeerIdentity origin_identity
Public key of the signing peer (persistent version, not the ephemeral public key).
int GNUNET_CONFIGURATION_get_value_yesno(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option)
Get a configuration value that should be in a set of "YES" or "NO".
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:655
const struct GNUNET_CONFIGURATION_Handle * GSC_cfg
Our configuration.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ do_rekey()

static void do_rekey ( void *  cls)
static

Task run to trigger rekeying.

Parameters
clsclosure, NULL

Definition at line 1863 of file gnunet-service-core_kx.c.

References current_ekm, derive_session_keys(), EphemeralKeyMessage::ephemeral_key, GNUNET_assert, GNUNET_CORE_KX_STATE_DOWN, GNUNET_CORE_KX_STATE_KEY_SENT, GNUNET_CORE_KX_STATE_REKEY_SENT, GNUNET_CORE_KX_STATE_UP, GNUNET_CRYPTO_ecdhe_key_create(), GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_h2s(), GNUNET_log, GNUNET_SCHEDULER_add_delayed(), monitor_notify_all(), GSC_KeyExchangeInfo::next, REKEY_FREQUENCY, send_key(), sign_ephemeral_key(), and GSC_KeyExchangeInfo::status.

Referenced by GSC_KX_init().

1864 {
1865  struct GSC_KeyExchangeInfo *pos;
1866 
1868  if (NULL != my_ephemeral_key)
1873  {
1874  struct GNUNET_HashCode eh;
1875 
1877  sizeof(current_ekm.ephemeral_key),
1878  &eh);
1879  GNUNET_log(GNUNET_ERROR_TYPE_INFO, "Rekeying to %s\n", GNUNET_h2s(&eh));
1880  }
1881  for (pos = kx_head; NULL != pos; pos = pos->next)
1882  {
1883  if (GNUNET_CORE_KX_STATE_UP == pos->status)
1884  {
1886  monitor_notify_all(pos);
1887  derive_session_keys(pos);
1888  }
1889  if (GNUNET_CORE_KX_STATE_DOWN == pos->status)
1890  {
1892  monitor_notify_all(pos);
1893  }
1894  monitor_notify_all(pos);
1895  send_key(pos);
1896  }
1897 }
enum GNUNET_CORE_KxState status
What is our connection status?
static struct GNUNET_CRYPTO_EcdhePrivateKey * my_ephemeral_key
Our ephemeral private key.
static void do_rekey(void *cls)
Task run to trigger rekeying.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static void send_key(struct GSC_KeyExchangeInfo *kx)
Send our key (and encrypted PING) to the other peer.
static void derive_session_keys(struct GSC_KeyExchangeInfo *kx)
Derive fresh session keys from the current ephemeral keys.
struct GNUNET_CRYPTO_EcdhePrivateKey * GNUNET_CRYPTO_ecdhe_key_create(void)
Create a new private key.
Definition: crypto_ecc.c:610
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static void sign_ephemeral_key()
Setup the message that links the ephemeral key to our persistent public key and generate the appropri...
static struct GSC_KeyExchangeInfo * kx_head
DLL head.
static void monitor_notify_all(struct GSC_KeyExchangeInfo *kx)
Inform all monitors about the KX state of the given peer.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
struct GSC_KeyExchangeInfo * next
DLL.
Information about the status of a key exchange with another peer.
A 512-bit hashcode.
struct GNUNET_CRYPTO_EcdhePublicKey ephemeral_key
Ephemeral public ECC key.
The other peer has confirmed our session key + PING with a PONG message encrypted with their session ...
static struct GNUNET_SCHEDULER_Task * rekey_task
Task scheduled for periodic re-generation (and thus rekeying) of our ephemeral key.
#define REKEY_FREQUENCY
How often do we rekey?
#define GNUNET_log(kind,...)
static struct EphemeralKeyMessage current_ekm
Current message we send for a key exchange.
We&#39;ve sent our session key.
#define GNUNET_free(ptr)
Wrapper around free.
We&#39;re rekeying (or had a timeout), so we have sent the other peer our new ephemeral key...
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GSC_KX_init()

int GSC_KX_init ( struct GNUNET_CRYPTO_EddsaPrivateKey pk)

Initialize KX subsystem.

Parameters
pkprivate key to use for the peer
Returns
GNUNET_OK on success, GNUNET_SYSERR on failure

Definition at line 1907 of file gnunet-service-core_kx.c.

References current_ekm, do_rekey(), EphemeralKeyMessage::ephemeral_key, GNUNET_break, GNUNET_CRYPTO_ecdhe_key_create(), GNUNET_CRYPTO_eddsa_key_get_public(), GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_h2s(), GNUNET_log, GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE, GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY, GNUNET_MESSAGE_TYPE_CORE_PING, GNUNET_MESSAGE_TYPE_CORE_PONG, GNUNET_MQ_handler_end, GNUNET_MQ_hd_fixed_size, GNUNET_MQ_hd_var_size, GNUNET_notification_context_create(), GNUNET_OK, GNUNET_SCHEDULER_add_delayed(), GNUNET_SYSERR, GNUNET_TRANSPORT_core_connect(), GSC_cfg, GSC_KX_done(), GSC_my_identity, handle_transport_notify_connect(), handle_transport_notify_disconnect(), handle_transport_notify_excess_bw(), ping(), pk, pong(), GNUNET_PeerIdentity::public_key, REKEY_FREQUENCY, and sign_ephemeral_key().

Referenced by run().

1908 {
1910  { GNUNET_MQ_hd_fixed_size(ephemeral_key,
1912  struct EphemeralKeyMessage,
1913  NULL),
1916  struct PingMessage,
1917  NULL),
1920  struct PongMessage,
1921  NULL),
1922  GNUNET_MQ_hd_var_size(encrypted,
1924  struct EncryptedMessage,
1925  NULL),
1927 
1928  my_private_key = pk;
1932  if (NULL == my_ephemeral_key)
1933  {
1934  GNUNET_break(0);
1936  my_private_key = NULL;
1937  return GNUNET_SYSERR;
1938  }
1940  {
1941  struct GNUNET_HashCode eh;
1942 
1944  sizeof(current_ekm.ephemeral_key),
1945  &eh);
1947  "Starting with ephemeral key %s\n",
1948  GNUNET_h2s(&eh));
1949  }
1950 
1953  transport =
1955  &GSC_my_identity,
1956  handlers,
1957  NULL,
1961  if (NULL == transport)
1962  {
1963  GSC_KX_done();
1964  return GNUNET_SYSERR;
1965  }
1966  return GNUNET_OK;
1967 }
static struct GNUNET_CRYPTO_EddsaPrivateKey * pk
Private key of this peer.
static void ping(void *cls)
Send a ping to destination.
static struct GNUNET_CRYPTO_EcdhePrivateKey * my_ephemeral_key
Our ephemeral private key.
static void do_rekey(void *cls)
Task run to trigger rekeying.
Response to a PING.
static struct GNUNET_TRANSPORT_CoreHandle * transport
Transport service.
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
static struct GNUNET_CRYPTO_EddsaPrivateKey * my_private_key
Our private key.
static void handle_transport_notify_excess_bw(void *cls, const struct GNUNET_PeerIdentity *pid, void *connect_cls)
One of our neighbours has excess bandwidth, remember this.
struct GNUNET_CRYPTO_EcdhePrivateKey * GNUNET_CRYPTO_ecdhe_key_create(void)
Create a new private key.
Definition: crypto_ecc.c:610
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
static void sign_ephemeral_key()
Setup the message that links the ephemeral key to our persistent public key and generate the appropri...
struct GNUNET_TRANSPORT_CoreHandle * GNUNET_TRANSPORT_core_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, const struct GNUNET_PeerIdentity *self, const struct GNUNET_MQ_MessageHandler *handlers, void *cls, GNUNET_TRANSPORT_NotifyConnect nc, GNUNET_TRANSPORT_NotifyDisconnect nd)
Connect to the transport service.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
#define GNUNET_MESSAGE_TYPE_CORE_PONG
Confirmation that other peer is alive.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1237
static struct GNUNET_CADET_MessageHandler handlers[]
Handlers, for diverse services.
We&#39;re sending an (encrypted) PING to the other peer to check if it can decrypt.
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:44
Encapsulation for encrypted messages exchanged between peers.
A 512-bit hashcode.
Message handler for a specific message type.
#define GNUNET_MESSAGE_TYPE_CORE_EPHEMERAL_KEY
Session key exchange between peers.
struct GNUNET_PeerIdentity GSC_my_identity
Our identity.
static void pong(struct GNUNET_CADET_Channel *channel, const struct CadetPingMessage *ping)
Reply with a pong to origin.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
struct GNUNET_CRYPTO_EcdhePublicKey ephemeral_key
Ephemeral public ECC key.
static void * handle_transport_notify_connect(void *cls, const struct GNUNET_PeerIdentity *pid, struct GNUNET_MQ_Handle *mq)
Function called by transport to notify us that a peer connected to us (on the network level)...
#define GNUNET_MESSAGE_TYPE_CORE_PING
Check that other peer is alive (challenge).
static struct GNUNET_NotificationContext * nc
Notification context for broadcasting to monitors.
void GNUNET_CRYPTO_eddsa_key_get_public(const struct GNUNET_CRYPTO_EddsaPrivateKey *priv, struct GNUNET_CRYPTO_EddsaPublicKey *pub)
Extract the public key for the given private key.
Definition: crypto_ecc.c:272
struct GNUNET_NotificationContext * GNUNET_notification_context_create(unsigned int queue_length)
Create a new notification context.
Definition: nc.c:119
#define GNUNET_MESSAGE_TYPE_CORE_ENCRYPTED_MESSAGE
Encapsulation for an encrypted message between peers.
static struct GNUNET_SCHEDULER_Task * rekey_task
Task scheduled for periodic re-generation (and thus rekeying) of our ephemeral key.
#define REKEY_FREQUENCY
How often do we rekey?
#define GNUNET_log(kind,...)
static struct EphemeralKeyMessage current_ekm
Current message we send for a key exchange.
static void handle_transport_notify_disconnect(void *cls, const struct GNUNET_PeerIdentity *peer, void *handler_cls)
Function called by transport telling us that a peer disconnected.
Message transmitted with the signed ephemeral key of a peer.
void GSC_KX_done()
Shutdown KX subsystem.
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
const struct GNUNET_CONFIGURATION_Handle * GSC_cfg
Our configuration.
#define GNUNET_free(ptr)
Wrapper around free.
struct GNUNET_CRYPTO_EddsaPublicKey public_key
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GSC_KX_done()

void GSC_KX_done ( void  )

Shutdown KX subsystem.

Definition at line 1974 of file gnunet-service-core_kx.c.

References GNUNET_free, GNUNET_notification_context_destroy(), GNUNET_SCHEDULER_cancel(), and GNUNET_TRANSPORT_core_disconnect().

Referenced by GSC_KX_init(), and shutdown_task().

1975 {
1976  if (NULL != transport)
1977  {
1979  transport = NULL;
1980  }
1981  if (NULL != rekey_task)
1982  {
1984  rekey_task = NULL;
1985  }
1986  if (NULL != my_ephemeral_key)
1987  {
1989  my_ephemeral_key = NULL;
1990  }
1991  if (NULL != my_private_key)
1992  {
1994  my_private_key = NULL;
1995  }
1996  if (NULL != nc)
1997  {
1999  nc = NULL;
2000  }
2001 }
static struct GNUNET_CRYPTO_EcdhePrivateKey * my_ephemeral_key
Our ephemeral private key.
static struct GNUNET_TRANSPORT_CoreHandle * transport
Transport service.
static struct GNUNET_CRYPTO_EddsaPrivateKey * my_private_key
Our private key.
static struct GNUNET_NotificationContext * nc
Notification context for broadcasting to monitors.
static struct GNUNET_SCHEDULER_Task * rekey_task
Task scheduled for periodic re-generation (and thus rekeying) of our ephemeral key.
void GNUNET_TRANSPORT_core_disconnect(struct GNUNET_TRANSPORT_CoreHandle *handle)
Disconnect from the transport service.
void GNUNET_notification_context_destroy(struct GNUNET_NotificationContext *nc)
Destroy the context, force disconnect for all subscribers.
Definition: nc.c:135
#define GNUNET_free(ptr)
Wrapper around free.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:956
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GSC_NEIGHBOURS_get_queue_length()

unsigned int GSC_NEIGHBOURS_get_queue_length ( const struct GSC_KeyExchangeInfo kxinfo)

Check how many messages are queued for the given neighbour.

Parameters
kxinfodata about neighbour to check
Returns
number of items in the message queue

Definition at line 2011 of file gnunet-service-core_kx.c.

References GNUNET_MQ_get_length(), and GSC_KeyExchangeInfo::mq.

Referenced by try_transmission().

2012 {
2013  return GNUNET_MQ_get_length(kxinfo->mq);
2014 }
struct GNUNET_MQ_Handle * mq
Message queue for sending messages to peer.
unsigned int GNUNET_MQ_get_length(struct GNUNET_MQ_Handle *mq)
Obtain the current length of the message queue.
Definition: mq.c:333
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GSC_NEIGHBOURS_check_excess_bandwidth()

int GSC_NEIGHBOURS_check_excess_bandwidth ( const struct GSC_KeyExchangeInfo kxinfo)

Check if the given neighbour has excess bandwidth available.

Parameters
targetneighbour to check
Returns
GNUNET_YES if excess bandwidth is available, GNUNET_NO if not

Definition at line 2024 of file gnunet-service-core_kx.c.

References GSC_KeyExchangeInfo::has_excess_bandwidth.

Referenced by try_transmission().

2025 {
2026  return kxinfo->has_excess_bandwidth;
2027 }
int has_excess_bandwidth
GNUNET_YES if this peer currently has excess bandwidth.
Here is the caller graph for this function:

◆ GSC_KX_handle_client_monitor_peers()

void GSC_KX_handle_client_monitor_peers ( struct GNUNET_MQ_Handle mq)

Handle GNUNET_MESSAGE_TYPE_CORE_MONITOR_PEERS request.

For this request type, the client does not have to have transmitted an INIT request. All current peers are returned, regardless of which message types they accept.

Parameters
mqmessage queue to add for monitoring

Definition at line 2039 of file gnunet-service-core_kx.c.

References env, GNUNET_CORE_KX_ITERATION_FINISHED, GNUNET_MESSAGE_TYPE_CORE_MONITOR_NOTIFY, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_notification_context_add(), GNUNET_TIME_absolute_hton(), GNUNET_TIME_UNIT_FOREVER_ABS, msg, GSC_KeyExchangeInfo::next, GSC_KeyExchangeInfo::peer, MonitorNotifyMessage::peer, MonitorNotifyMessage::state, GSC_KeyExchangeInfo::status, GSC_KeyExchangeInfo::timeout, and MonitorNotifyMessage::timeout.

Referenced by handle_client_monitor_peers().

2040 {
2041  struct GNUNET_MQ_Envelope *env;
2042  struct MonitorNotifyMessage *done_msg;
2043  struct GSC_KeyExchangeInfo *kx;
2044 
2046  for (kx = kx_head; NULL != kx; kx = kx->next)
2047  {
2048  struct GNUNET_MQ_Envelope *env;
2049  struct MonitorNotifyMessage *msg;
2050 
2052  msg->state = htonl((uint32_t)kx->status);
2053  msg->peer = *kx->peer;
2055  GNUNET_MQ_send(mq, env);
2056  }
2058  done_msg->state = htonl((uint32_t)GNUNET_CORE_KX_ITERATION_FINISHED);
2060  GNUNET_MQ_send(mq, env);
2061 }
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
const struct GNUNET_PeerIdentity * peer
Identity of the peer.
enum GNUNET_CORE_KxState status
What is our connection status?
struct GNUNET_TIME_AbsoluteNBO timeout
How long will we stay in this state (if nothing else happens)?
Definition: core.h:313
#define GNUNET_MQ_msg(mvar, type)
Allocate a GNUNET_MQ_Envelope.
Definition: gnunet_mq_lib.h:67
static struct GSC_KeyExchangeInfo * kx_head
DLL head.
void GNUNET_notification_context_add(struct GNUNET_NotificationContext *nc, struct GNUNET_MQ_Handle *mq)
Add a subscriber to the notification context.
Definition: nc.c:158
#define GNUNET_TIME_UNIT_FOREVER_ABS
Constant used to specify "forever".
struct GSC_KeyExchangeInfo * next
DLL.
Information about the status of a key exchange with another peer.
This is not a state in a peer&#39;s state machine, but a special value used with the GNUNET_CORE_MonitorC...
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
static struct GNUNET_NotificationContext * nc
Notification context for broadcasting to monitors.
uint32_t state
New peer state, an enum GNUNET_CORE_KxState in NBO.
Definition: core.h:303
struct GNUNET_TIME_Absolute timeout
When should the session time out (if there are no PONGs)?
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
Message sent by the service to monitor clients to notify them about a peer changing status...
Definition: core.h:294
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:655
#define GNUNET_MESSAGE_TYPE_CORE_MONITOR_NOTIFY
Reply for monitor by CORE service.
struct GNUNET_PeerIdentity peer
Identity of the peer.
Definition: core.h:308
Here is the call graph for this function:
Here is the caller graph for this function:

Variable Documentation

◆ transport

struct GNUNET_TRANSPORT_CoreHandle* transport
static

Transport service.

Definition at line 359 of file gnunet-service-core_kx.c.

Referenced by GST_blacklist_add_peer().

◆ my_private_key

struct GNUNET_CRYPTO_EddsaPrivateKey* my_private_key
static

Our private key.

Definition at line 364 of file gnunet-service-core_kx.c.

◆ my_ephemeral_key

struct GNUNET_CRYPTO_EcdhePrivateKey* my_ephemeral_key
static

Our ephemeral private key.

Definition at line 369 of file gnunet-service-core_kx.c.

◆ current_ekm

struct EphemeralKeyMessage current_ekm
static

Current message we send for a key exchange.

Definition at line 374 of file gnunet-service-core_kx.c.

Referenced by do_rekey(), GSC_KX_init(), send_key(), and sign_ephemeral_key().

◆ kx_head

struct GSC_KeyExchangeInfo* kx_head
static

DLL head.

Definition at line 379 of file gnunet-service-core_kx.c.

◆ kx_tail

struct GSC_KeyExchangeInfo* kx_tail
static

DLL tail.

Definition at line 384 of file gnunet-service-core_kx.c.

◆ rekey_task

struct GNUNET_SCHEDULER_Task* rekey_task
static

Task scheduled for periodic re-generation (and thus rekeying) of our ephemeral key.

Definition at line 390 of file gnunet-service-core_kx.c.

◆ nc

struct GNUNET_NotificationContext* nc
static

Notification context for broadcasting to monitors.

Definition at line 395 of file gnunet-service-core_kx.c.