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

412 {
413  /* Note: may want to make this non-random and instead
414  derive from key material to avoid having an undetectable
415  side-channel */
416  return htonl (
418 }
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 427 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().

428 {
429  struct MonitorNotifyMessage msg;
430 
432  msg.header.size = htons (sizeof (msg));
433  msg.state = htonl ((uint32_t) kx->status);
434  msg.peer = *kx->peer;
435  msg.timeout = GNUNET_TIME_absolute_hton (kx->timeout);
437  kx->last_notify_timeout = kx->timeout;
438 }
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:81
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:192
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:304
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:654
#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 449 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().

452 {
453  static const char ctx[] = "authentication key";
454 #if DEBUG_KX
455  struct GNUNET_HashCode sh;
456 
457  GNUNET_CRYPTO_hash (skey, sizeof (*skey), &sh);
459  "Deriving Auth key from SKEY %s and seed %u\n",
460  GNUNET_h2s (&sh),
461  (unsigned int) seed);
462 #endif
464  skey,
465  &seed,
466  sizeof (seed),
467  skey,
468  sizeof (
470  ctx,
471  sizeof (ctx),
472  NULL);
473 }
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 485 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().

489 {
490  static const char ctx[] = "initialization vector";
491 #if DEBUG_KX
492  struct GNUNET_HashCode sh;
493 
494  GNUNET_CRYPTO_hash (skey, sizeof (*skey), &sh);
496  "Deriving IV from SKEY %s and seed %u for peer %s\n",
497  GNUNET_h2s (&sh),
498  (unsigned int) seed,
499  GNUNET_i2s (identity));
500 #endif
502  skey,
503  &seed,
504  sizeof (seed),
505  identity,
506  sizeof (struct GNUNET_PeerIdentity),
507  ctx,
508  sizeof (ctx),
509  NULL);
510 }
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 523 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().

528 {
529  static const char ctx[] = "pong initialization vector";
530 #if DEBUG_KX
531  struct GNUNET_HashCode sh;
532 
533  GNUNET_CRYPTO_hash (skey, sizeof (*skey), &sh);
535  "Deriving PONG IV from SKEY %s and seed %u/%u for %s\n",
536  GNUNET_h2s (&sh),
537  (unsigned int) seed,
538  (unsigned int) challenge,
539  GNUNET_i2s (identity));
540 #endif
542  skey,
543  &seed,
544  sizeof (seed),
545  identity,
546  sizeof (struct GNUNET_PeerIdentity),
547  &challenge,
548  sizeof (challenge),
549  ctx,
550  sizeof (ctx),
551  NULL);
552 }
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 564 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().

568 {
569  static const char ctx[] = "aes key generation vector";
570 #if DEBUG_KX
571  struct GNUNET_HashCode sh;
572 
573  GNUNET_CRYPTO_hash (skey, sizeof (*skey), &sh);
575  "Deriving AES Keys for %s to %s from %s\n",
576  GNUNET_i2s (sender),
577  GNUNET_i2s2 (receiver),
578  GNUNET_h2s (key_material));
579 #endif
580  GNUNET_CRYPTO_kdf (skey,
581  sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
582  ctx,
583  sizeof (ctx),
584  key_material,
585  sizeof (struct GNUNET_HashCode),
586  sender,
587  sizeof (struct GNUNET_PeerIdentity),
588  receiver,
589  sizeof (struct GNUNET_PeerIdentity),
590  NULL);
591 }
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 606 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().

611 {
612  if (size != (uint16_t) size)
613  {
614  GNUNET_break (0);
615  return GNUNET_NO;
616  }
618  (uint16_t) size,
619  &kx->encrypt_key,
620  iv,
621  out));
623  gettext_noop ("# bytes encrypted"),
624  size,
625  GNUNET_NO);
626  /* the following is too sensitive to write to log files by accident,
627  so we require manual intervention to get this one... */
628 #if DEBUG_KX
630  "Encrypted %u bytes for `%s' using key %u, IV %u\n",
631  (unsigned int) size,
632  GNUNET_i2s (kx->peer),
633  (unsigned int) kx->encrypt_key.crc32,
634  GNUNET_CRYPTO_crc32_n (iv, sizeof (iv)));
635 #endif
636  return GNUNET_OK;
637 }
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:81
#define GNUNET_OK
Named constants for return values.
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.
#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:67
#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 653 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().

658 {
659  if (size != (uint16_t) size)
660  {
661  GNUNET_break (0);
662  return GNUNET_NO;
663  }
665  (kx->status != GNUNET_CORE_KX_STATE_UP) &&
667  {
668  GNUNET_break_op (0);
669  return GNUNET_SYSERR;
670  }
671  if (size != GNUNET_CRYPTO_symmetric_decrypt (in,
672  (uint16_t) size,
673  &kx->decrypt_key,
674  iv,
675  out))
676  {
677  GNUNET_break (0);
678  return GNUNET_SYSERR;
679  }
681  gettext_noop ("# bytes decrypted"),
682  size,
683  GNUNET_NO);
684  /* the following is too sensitive to write to log files by accident,
685  so we require manual intervention to get this one... */
686 #if DEBUG_KX
688  "Decrypted %u bytes from `%s' using key %u, IV %u\n",
689  (unsigned int) size,
690  GNUNET_i2s (kx->peer),
691  (unsigned int) kx->decrypt_key.crc32,
692  GNUNET_CRYPTO_crc32_n (iv, sizeof (*iv)));
693 #endif
694  return GNUNET_OK;
695 }
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:81
#define GNUNET_OK
Named constants for return values.
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.
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:79
static unsigned int size
Size of the "table".
Definition: peer.c:67
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 1446 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().

1447 {
1448  struct GNUNET_MQ_Envelope *env;
1449 
1451  if (NULL != kx->retry_set_key_task)
1452  {
1454  kx->retry_set_key_task = NULL;
1455  }
1456  /* always update sender status in SET KEY message */
1457 #if DEBUG_KX
1458  {
1459  struct GNUNET_HashCode hc;
1460 
1462  sizeof (current_ekm.ephemeral_key),
1463  &hc);
1465  "Sending EPHEMERAL_KEY %s to `%s' (my status: %d)\n",
1466  GNUNET_h2s (&hc),
1467  GNUNET_i2s (kx->peer),
1468  kx->status);
1469  }
1470 #endif
1471  current_ekm.sender_status = htonl ((int32_t) (kx->status));
1473  GNUNET_MQ_send (kx->mq, env);
1475  send_ping (kx);
1476  kx->retry_set_key_task =
1479  kx);
1480 }
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:653
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:1246
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:353
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:965
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 713 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().

714 {
715  struct GSC_KeyExchangeInfo *kx = cls;
716 
717  kx->retry_set_key_task = NULL;
721  send_key (kx);
722 }
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 731 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().

732 {
733  struct PingMessage pp;
734  struct PingMessage *pm;
736 
737  pm = &kx->ping;
738  kx->ping_challenge =
740  pm->header.size = htons (sizeof (struct PingMessage));
741  pm->header.type = htons (GNUNET_MESSAGE_TYPE_CORE_PING);
742  pm->iv_seed = calculate_seed (kx);
743  derive_iv (&iv, &kx->encrypt_key, pm->iv_seed, kx->peer);
744  pp.challenge = kx->ping_challenge;
745  pp.target = *kx->peer;
746  do_encrypt (kx,
747  &iv,
748  &pp.target,
749  &pm->target,
750  sizeof (struct PingMessage) -
751  ((void *) &pm->target - (void *) pm));
752 }
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 767 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().

768 {
769  struct GSC_KeyExchangeInfo *kx = cls;
770 
772  "Decrypted message of type %d from %s\n",
773  ntohs (m->type),
774  GNUNET_i2s (kx->peer));
775  if (GNUNET_CORE_KX_STATE_UP != kx->status)
776  {
778  gettext_noop ("# PAYLOAD dropped (out of order)"),
779  1,
780  GNUNET_NO);
781  return GNUNET_OK;
782  }
783  switch (ntohs (m->type))
784  {
788  return GNUNET_OK;
791  return GNUNET_OK;
792  default:
794  m,
795  ntohs (m->size),
798  m,
799  sizeof (struct GNUNET_MessageHeader),
801  }
802  return GNUNET_OK;
803 }
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:81
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:78
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 816 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().

819 {
820  struct GSC_KeyExchangeInfo *kx;
821  struct GNUNET_HashCode h1;
822  struct GNUNET_HashCode h2;
823 
825  "Initiating key exchange with `%s'\n",
826  GNUNET_i2s (pid));
828  gettext_noop ("# key exchanges initiated"),
829  1,
830  GNUNET_NO);
831  kx = GNUNET_new (struct GSC_KeyExchangeInfo);
833  kx->mq = mq;
834  kx->peer = pid;
838  monitor_notify_all (kx);
839  GNUNET_CRYPTO_hash (pid, sizeof (struct GNUNET_PeerIdentity), &h1);
841  sizeof (struct GNUNET_PeerIdentity),
842  &h2);
843  if (0 < GNUNET_CRYPTO_hash_cmp (&h1, &h2))
844  {
845  /* peer with "lower" identity starts KX, otherwise we typically end up
846  with both peers starting the exchange and transmit the 'set key'
847  message twice */
848  send_key (kx);
849  }
850  else
851  {
852  /* peer with "higher" identity starts a delayed KX, if the "lower" peer
853  * does not start a KX since it sees no reasons to do so */
854  kx->retry_set_key_task =
857  kx);
858  }
859  return kx;
860 }
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:81
#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:1246
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:87
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 873 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().

876 {
877  struct GSC_KeyExchangeInfo *kx = handler_cls;
878 
880  "Peer `%s' disconnected from us.\n",
881  GNUNET_i2s (peer));
882  GSC_SESSIONS_end (kx->peer);
884  gettext_noop ("# key exchanges stopped"),
885  1,
886  GNUNET_NO);
887  if (NULL != kx->retry_set_key_task)
888  {
890  kx->retry_set_key_task = NULL;
891  }
892  if (NULL != kx->keep_alive_task)
893  {
895  kx->keep_alive_task = NULL;
896  }
898  monitor_notify_all (kx);
900  GNUNET_MST_destroy (kx->mst);
901  GNUNET_free (kx);
902 }
#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:81
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:413
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:965
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 911 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().

912 {
913  struct GNUNET_MQ_Envelope *env;
914 
916  gettext_noop ("# PING messages transmitted"),
917  1,
918  GNUNET_NO);
919  env = GNUNET_MQ_msg_copy (&kx->ping.header);
920  GNUNET_MQ_send (kx->mq, env);
921 }
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:653
struct PingMessage ping
PING message we transmit to the other peer.
#define GNUNET_NO
Definition: gnunet_common.h:81
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:353
#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 930 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().

931 {
932  struct GNUNET_HashCode key_material;
933 
935  &kx->other_ephemeral_key,
936  &key_material))
937  {
938  GNUNET_break (0);
939  return;
940  }
941  derive_aes_key (&GSC_my_identity, kx->peer, &key_material, &kx->encrypt_key);
942  derive_aes_key (kx->peer, &GSC_my_identity, &key_material, &kx->decrypt_key);
943  memset (&key_material, 0, sizeof (key_material));
944  /* fresh key, reset sequence numbers */
946  kx->last_packets_bitmap = 0;
947  setup_fresh_ping (kx);
948 }
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:1184
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:78
#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 959 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.

960 {
961  struct GSC_KeyExchangeInfo *kx = cls;
962  struct GNUNET_TIME_Absolute start_t;
963  struct GNUNET_TIME_Absolute end_t;
964  struct GNUNET_TIME_Absolute now;
965  enum GNUNET_CORE_KxState sender_status;
966 
969  (GNUNET_CORE_KX_STATE_UP == kx->status) ||
971  (end_t.abs_value_us < kx->foreign_key_expires.abs_value_us))
972  {
974  gettext_noop ("# old ephemeral keys ignored"),
975  1,
976  GNUNET_NO);
978  "Received expired EPHEMERAL_KEY from %s\n",
980  return;
981  }
982  if (0 == memcmp (&m->ephemeral_key,
983  &kx->other_ephemeral_key,
984  sizeof (m->ephemeral_key)))
985  {
987  gettext_noop (
988  "# duplicate ephemeral keys ignored"),
989  1,
990  GNUNET_NO);
992  "Ignoring duplicate EPHEMERAL_KEY from %s\n",
994  return;
995  }
996  if (0 != memcmp (&m->origin_identity,
997  kx->peer,
998  sizeof (struct GNUNET_PeerIdentity)))
999  {
1001  "Received EPHEMERAL_KEY from %s, but expected %s\n",
1003  GNUNET_i2s_full (kx->peer));
1004  GNUNET_break_op (0);
1005  return;
1006  }
1007  if ((ntohl (m->purpose.size) !=
1008  sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) +
1009  sizeof (struct GNUNET_TIME_AbsoluteNBO) +
1010  sizeof (struct GNUNET_TIME_AbsoluteNBO) +
1011  sizeof (struct GNUNET_CRYPTO_EddsaPublicKey) +
1012  sizeof (struct GNUNET_CRYPTO_EddsaPublicKey)) ||
1013  (GNUNET_OK !=
1015  &m->purpose,
1016  &m->signature,
1018  {
1019  /* invalid signature */
1020  GNUNET_break_op (0);
1022  gettext_noop (
1023  "# EPHEMERAL_KEYs rejected (bad signature)"),
1024  1,
1025  GNUNET_NO);
1027  "Received EPHEMERAL_KEY from %s with bad signature\n",
1028  GNUNET_i2s (&m->origin_identity));
1029  return;
1030  }
1031  now = GNUNET_TIME_absolute_get ();
1033  if ((end_t.abs_value_us <
1035  (start_t.abs_value_us >
1036  GNUNET_TIME_absolute_add (now, REKEY_TOLERANCE).abs_value_us))
1037  {
1038  GNUNET_log (
1040  _ (
1041  "EPHEMERAL_KEY from peer `%s' rejected as its validity range does not match our system time (%llu not in [%llu,%llu]).\n"),
1042  GNUNET_i2s (kx->peer),
1043  (unsigned long long) now.abs_value_us,
1044  (unsigned long long) start_t.abs_value_us,
1045  (unsigned long long) end_t.abs_value_us);
1047  gettext_noop (
1048  "# EPHEMERAL_KEY messages rejected due to time"),
1049  1,
1050  GNUNET_NO);
1051  return;
1052  }
1053 #if DEBUG_KX
1054  {
1055  struct GNUNET_HashCode eh;
1056 
1057  GNUNET_CRYPTO_hash (&m->ephemeral_key, sizeof (m->ephemeral_key), &eh);
1059  "Received valid EPHEMERAL_KEY `%s' from `%s' in state %d.\n",
1060  GNUNET_h2s (&eh),
1061  GNUNET_i2s (kx->peer),
1062  kx->status);
1063  }
1064 #endif
1066  gettext_noop ("# valid ephemeral keys received"),
1067  1,
1068  GNUNET_NO);
1070  kx->foreign_key_expires = end_t;
1071  derive_session_keys (kx);
1072 
1073  /* check if we still need to send the sender our key */
1074  sender_status = (enum GNUNET_CORE_KxState) ntohl (m->sender_status);
1075  switch (sender_status)
1076  {
1078  GNUNET_break_op (0);
1079  break;
1081  /* fine, need to send our key after updating our status, see below */
1082  GSC_SESSIONS_reinit (kx->peer);
1083  break;
1085  /* other peer already got our key, but typemap did go down */
1086  GSC_SESSIONS_reinit (kx->peer);
1087  break;
1089  /* other peer already got our key, typemap NOT down */
1090  break;
1092  /* other peer already got our key, typemap NOT down */
1093  break;
1094  default:
1095  GNUNET_break (0);
1096  break;
1097  }
1098  /* check if we need to confirm everything is fine via PING + PONG */
1099  switch (kx->status)
1100  {
1102  GNUNET_assert (NULL == kx->keep_alive_task);
1104  monitor_notify_all (kx);
1105  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1106  send_key (kx);
1107  else
1108  send_ping (kx);
1109  break;
1111  GNUNET_assert (NULL == kx->keep_alive_task);
1113  monitor_notify_all (kx);
1114  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1115  send_key (kx);
1116  else
1117  send_ping (kx);
1118  break;
1120  GNUNET_assert (NULL == kx->keep_alive_task);
1121  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1122  send_key (kx);
1123  else
1124  send_ping (kx);
1125  break;
1128  monitor_notify_all (kx);
1129  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1130  send_key (kx);
1131  else
1132  send_ping (kx);
1133  break;
1135  if (GNUNET_CORE_KX_STATE_KEY_SENT == sender_status)
1136  send_key (kx);
1137  else
1138  send_ping (kx);
1139  break;
1140  default:
1141  GNUNET_break (0);
1142  break;
1143  }
1144 }
#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:419
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh(struct GNUNET_TIME_AbsoluteNBO a)
Convert absolute time from network byte order.
Definition: time.c:670
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:81
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:78
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:208
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 1155 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.

1156 {
1157  struct GSC_KeyExchangeInfo *kx = cls;
1158  struct PingMessage t;
1159  struct PongMessage tx;
1160  struct PongMessage *tp;
1161  struct GNUNET_MQ_Envelope *env;
1163 
1165  gettext_noop ("# PING messages received"),
1166  1,
1167  GNUNET_NO);
1169  (kx->status != GNUNET_CORE_KX_STATE_UP) &&
1171  {
1172  /* ignore */
1174  gettext_noop (
1175  "# PING messages dropped (out of order)"),
1176  1,
1177  GNUNET_NO);
1178  return;
1179  }
1181  "Core service receives PING request from `%s'.\n",
1182  GNUNET_i2s (kx->peer));
1183  derive_iv (&iv, &kx->decrypt_key, m->iv_seed, &GSC_my_identity);
1184  if (GNUNET_OK != do_decrypt (kx,
1185  &iv,
1186  &m->target,
1187  &t.target,
1188  sizeof (struct PingMessage) -
1189  ((void *) &m->target - (void *) m)))
1190  {
1191  GNUNET_break_op (0);
1192  return;
1193  }
1194  if (0 !=
1195  memcmp (&t.target, &GSC_my_identity, sizeof (struct GNUNET_PeerIdentity)))
1196  {
1199  "Decryption of PING from peer `%s' failed, PING for `%s'?\n",
1200  GNUNET_i2s (kx->peer),
1201  GNUNET_i2s2 (&t.target));
1202  else
1203  GNUNET_log (
1205  "Decryption of PING from peer `%s' failed after rekey (harmless)\n",
1206  GNUNET_i2s (kx->peer));
1207  GNUNET_break_op (0);
1208  return;
1209  }
1210  /* construct PONG */
1211  tx.reserved = 0;
1212  tx.challenge = t.challenge;
1213  tx.target = t.target;
1215  tp->iv_seed = calculate_seed (kx);
1216  derive_pong_iv (&iv, &kx->encrypt_key, tp->iv_seed, t.challenge, kx->peer);
1217  do_encrypt (kx,
1218  &iv,
1219  &tx.challenge,
1220  &tp->challenge,
1221  sizeof (struct PongMessage) -
1222  ((void *) &tp->challenge - (void *) tp));
1224  gettext_noop ("# PONG messages created"),
1225  1,
1226  GNUNET_NO);
1227  GNUNET_MQ_send (kx->mq, env);
1228 }
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:81
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:78
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:353
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 1238 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().

1239 {
1240  struct GSC_KeyExchangeInfo *kx = cls;
1241  struct GNUNET_TIME_Relative retry;
1242  struct GNUNET_TIME_Relative left;
1243 
1244  kx->keep_alive_task = NULL;
1246  if (0 == left.rel_value_us)
1247  {
1249  gettext_noop ("# sessions terminated by timeout"),
1250  1,
1251  GNUNET_NO);
1252  GSC_SESSIONS_end (kx->peer);
1254  monitor_notify_all (kx);
1255  send_key (kx);
1256  return;
1257  }
1259  "Sending KEEPALIVE to `%s'\n",
1260  GNUNET_i2s (kx->peer));
1262  gettext_noop ("# keepalive messages sent"),
1263  1,
1264  GNUNET_NO);
1265  setup_fresh_ping (kx);
1266  send_ping (kx);
1269  kx->keep_alive_task =
1271 }
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:286
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:81
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:1246
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 1282 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().

1283 {
1284  struct GNUNET_TIME_Relative delta;
1285 
1286  kx->timeout =
1288  delta =
1290  if (delta.rel_value_us > 5LL * 1000LL * 1000LL)
1291  {
1292  /* we only notify monitors about timeout changes if those
1293  are bigger than the threshold (5s) */
1294  monitor_notify_all (kx);
1295  }
1296  if (NULL != kx->keep_alive_task)
1300  &send_keep_alive,
1301  kx);
1302 }
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:245
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:1246
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:965
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 1312 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().

1313 {
1314  struct GSC_KeyExchangeInfo *kx = cls;
1315  struct PongMessage t;
1317 
1319  gettext_noop ("# PONG messages received"),
1320  1,
1321  GNUNET_NO);
1322  switch (kx->status)
1323  {
1326  gettext_noop (
1327  "# PONG messages dropped (connection down)"),
1328  1,
1329  GNUNET_NO);
1330  return;
1333  gettext_noop (
1334  "# PONG messages dropped (out of order)"),
1335  1,
1336  GNUNET_NO);
1337  return;
1339  break;
1341  break;
1343  break;
1344  default:
1345  GNUNET_break (0);
1346  return;
1347  }
1349  "Core service receives PONG response from `%s'.\n",
1350  GNUNET_i2s (kx->peer));
1351  /* mark as garbage, just to be sure */
1352  memset (&t, 255, sizeof (t));
1353  derive_pong_iv (&iv,
1354  &kx->decrypt_key,
1355  m->iv_seed,
1356  kx->ping_challenge,
1357  &GSC_my_identity);
1358  if (GNUNET_OK != do_decrypt (kx,
1359  &iv,
1360  &m->challenge,
1361  &t.challenge,
1362  sizeof (struct PongMessage) -
1363  ((void *) &m->challenge - (void *) m)))
1364  {
1365  GNUNET_break_op (0);
1366  return;
1367  }
1369  gettext_noop ("# PONG messages decrypted"),
1370  1,
1371  GNUNET_NO);
1372  if ((0 !=
1373  memcmp (&t.target, kx->peer, sizeof (struct GNUNET_PeerIdentity))) ||
1374  (kx->ping_challenge != t.challenge))
1375  {
1376  /* PONG malformed */
1378  "Received malformed PONG wanted sender `%s' with challenge %u\n",
1379  GNUNET_i2s (kx->peer),
1380  (unsigned int) kx->ping_challenge);
1382  "Received malformed PONG received from `%s' with challenge %u\n",
1383  GNUNET_i2s (&t.target),
1384  (unsigned int) t.challenge);
1385  return;
1386  }
1388  "Received valid PONG from `%s'\n",
1389  GNUNET_i2s (kx->peer));
1390  /* no need to resend key any longer */
1391  if (NULL != kx->retry_set_key_task)
1392  {
1394  kx->retry_set_key_task = NULL;
1395  }
1396  switch (kx->status)
1397  {
1399  GNUNET_assert (0); /* should be impossible */
1400  return;
1402  GNUNET_assert (0); /* should be impossible */
1403  return;
1406  gettext_noop (
1407  "# session keys confirmed via PONG"),
1408  1,
1409  GNUNET_NO);
1411  monitor_notify_all (kx);
1412  GSC_SESSIONS_create (kx->peer, kx);
1413  GNUNET_assert (NULL == kx->keep_alive_task);
1414  update_timeout (kx);
1415  break;
1418  gettext_noop ("# timeouts prevented via PONG"),
1419  1,
1420  GNUNET_NO);
1421  update_timeout (kx);
1422  break;
1425  gettext_noop (
1426  "# rekey operations confirmed via PONG"),
1427  1,
1428  GNUNET_NO);
1430  monitor_notify_all (kx);
1431  update_timeout (kx);
1432  break;
1433  default:
1434  GNUNET_break (0);
1435  break;
1436  }
1437 }
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:81
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:78
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:965
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 1491 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().

1494 {
1495  size_t used = payload_size + sizeof (struct EncryptedMessage);
1496  char pbuf[used]; /* plaintext */
1497  struct EncryptedMessage *em; /* encrypted message */
1498  struct EncryptedMessage *ph; /* plaintext header */
1499  struct GNUNET_MQ_Envelope *env;
1501  struct GNUNET_CRYPTO_AuthKey auth_key;
1502 
1503  ph = (struct EncryptedMessage *) pbuf;
1504  ph->sequence_number = htonl (++kx->last_sequence_number_sent);
1505  ph->iv_seed = calculate_seed (kx);
1506  ph->reserved = 0;
1508  GNUNET_memcpy (&ph[1], payload, payload_size);
1509  env = GNUNET_MQ_msg_extra (em,
1510  payload_size,
1512  em->iv_seed = ph->iv_seed;
1513  derive_iv (&iv, &kx->encrypt_key, ph->iv_seed, kx->peer);
1515  &iv,
1516  &ph->sequence_number,
1517  &em->sequence_number,
1518  used - ENCRYPTED_HEADER_SIZE));
1519 #if DEBUG_KX
1520  {
1521  struct GNUNET_HashCode hc;
1522 
1523  GNUNET_CRYPTO_hash (&ph->sequence_number,
1524  used - ENCRYPTED_HEADER_SIZE,
1525  &hc);
1527  "Encrypted payload `%s' of %u bytes for %s\n",
1528  GNUNET_h2s (&hc),
1529  (unsigned int) (used - ENCRYPTED_HEADER_SIZE),
1530  GNUNET_i2s (kx->peer));
1531  }
1532 #endif
1533  derive_auth_key (&auth_key, &kx->encrypt_key, ph->iv_seed);
1534  GNUNET_CRYPTO_hmac (&auth_key,
1535  &em->sequence_number,
1536  used - ENCRYPTED_HEADER_SIZE,
1537  &em->hmac);
1538 #if DEBUG_KX
1539  {
1540  struct GNUNET_HashCode hc;
1541 
1542  GNUNET_CRYPTO_hash (&auth_key, sizeof (auth_key), &hc);
1544  "For peer %s, used AC %s to create hmac %s\n",
1545  GNUNET_i2s (kx->peer),
1546  GNUNET_h2s (&hc),
1547  GNUNET_h2s2 (&em->hmac));
1548  }
1549 #endif
1551  GNUNET_MQ_send (kx->mq, env);
1552 }
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_NO
Definition: gnunet_common.h:81
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:78
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
#define GNUNET_memcpy(dst, src, n)
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:353
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:654
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 1564 of file gnunet-service-core_kx.c.

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

1565 {
1566  uint16_t size = ntohs (m->header.size) - sizeof (*m);
1567 
1568  if (size < sizeof (struct GNUNET_MessageHeader))
1569  {
1570  GNUNET_break_op (0);
1571  return GNUNET_SYSERR;
1572  }
1573  return GNUNET_OK;
1574 }
#define GNUNET_OK
Named constants for return values.
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_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:79
static unsigned int size
Size of the "table".
Definition: peer.c:67
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 1585 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().

1586 {
1587  struct GSC_KeyExchangeInfo *kx = cls;
1588  struct EncryptedMessage *pt; /* plaintext */
1589  struct GNUNET_HashCode ph;
1590  uint32_t snum;
1591  struct GNUNET_TIME_Absolute t;
1593  struct GNUNET_CRYPTO_AuthKey auth_key;
1594  uint16_t size = ntohs (m->header.size);
1595  char buf[size] GNUNET_ALIGN;
1596 
1597  if (GNUNET_CORE_KX_STATE_UP != kx->status)
1598  {
1600  gettext_noop (
1601  "# DATA message dropped (out of order)"),
1602  1,
1603  GNUNET_NO);
1604  return;
1605  }
1606  if (0 ==
1608  {
1609  GNUNET_log (
1611  _ (
1612  "Session to peer `%s' went down due to key expiration (should not happen)\n"),
1613  GNUNET_i2s (kx->peer));
1615  gettext_noop (
1616  "# sessions terminated by key expiration"),
1617  1,
1618  GNUNET_NO);
1619  GSC_SESSIONS_end (kx->peer);
1620  if (NULL != kx->keep_alive_task)
1621  {
1623  kx->keep_alive_task = NULL;
1624  }
1626  monitor_notify_all (kx);
1627  send_key (kx);
1628  return;
1629  }
1630 
1631  /* validate hash */
1632 #if DEBUG_KX
1633  {
1634  struct GNUNET_HashCode hc;
1635 
1638  "Received encrypted payload `%s' of %u bytes from %s\n",
1639  GNUNET_h2s (&hc),
1640  (unsigned int) (size - ENCRYPTED_HEADER_SIZE),
1641  GNUNET_i2s (kx->peer));
1642  }
1643 #endif
1644  derive_auth_key (&auth_key, &kx->decrypt_key, m->iv_seed);
1645  GNUNET_CRYPTO_hmac (&auth_key,
1646  &m->sequence_number,
1647  size - ENCRYPTED_HEADER_SIZE,
1648  &ph);
1649 #if DEBUG_KX
1650  {
1651  struct GNUNET_HashCode hc;
1652 
1653  GNUNET_CRYPTO_hash (&auth_key, sizeof (auth_key), &hc);
1655  "For peer %s, used AC %s to verify hmac %s\n",
1656  GNUNET_i2s (kx->peer),
1657  GNUNET_h2s (&hc),
1658  GNUNET_h2s2 (&m->hmac));
1659  }
1660 #endif
1661  if (0 != memcmp (&ph, &m->hmac, sizeof (struct GNUNET_HashCode)))
1662  {
1663  /* checksum failed */
1665  "Failed checksum validation for a message from `%s'\n",
1666  GNUNET_i2s (kx->peer));
1667  return;
1668  }
1669  derive_iv (&iv, &kx->decrypt_key, m->iv_seed, &GSC_my_identity);
1670  /* decrypt */
1671  if (GNUNET_OK != do_decrypt (kx,
1672  &iv,
1673  &m->sequence_number,
1675  size - ENCRYPTED_HEADER_SIZE))
1676  {
1677  GNUNET_break_op (0);
1678  return;
1679  }
1681  "Decrypted %u bytes from %s\n",
1682  (unsigned int) (size - ENCRYPTED_HEADER_SIZE),
1683  GNUNET_i2s (kx->peer));
1684  pt = (struct EncryptedMessage *) buf;
1685 
1686  /* validate sequence number */
1687  snum = ntohl (pt->sequence_number);
1688  if (kx->last_sequence_number_received == snum)
1689  {
1691  "Received duplicate message, ignoring.\n");
1692  /* duplicate, ignore */
1694  gettext_noop ("# bytes dropped (duplicates)"),
1695  size,
1696  GNUNET_NO);
1697  return;
1698  }
1699  if ((kx->last_sequence_number_received > snum) &&
1700  (kx->last_sequence_number_received - snum > 32))
1701  {
1703  "Received ancient out of sequence message, ignoring.\n");
1704  /* ancient out of sequence, ignore */
1706  gettext_noop (
1707  "# bytes dropped (out of sequence)"),
1708  size,
1709  GNUNET_NO);
1710  return;
1711  }
1712  if (kx->last_sequence_number_received > snum)
1713  {
1714  uint32_t rotbit = 1U << (kx->last_sequence_number_received - snum - 1);
1715 
1716  if ((kx->last_packets_bitmap & rotbit) != 0)
1717  {
1719  "Received duplicate message, ignoring.\n");
1721  gettext_noop ("# bytes dropped (duplicates)"),
1722  size,
1723  GNUNET_NO);
1724  /* duplicate, ignore */
1725  return;
1726  }
1727  kx->last_packets_bitmap |= rotbit;
1728  }
1729  if (kx->last_sequence_number_received < snum)
1730  {
1731  unsigned int shift = (snum - kx->last_sequence_number_received);
1732 
1733  if (shift >= 8 * sizeof (kx->last_packets_bitmap))
1734  kx->last_packets_bitmap = 0;
1735  else
1736  kx->last_packets_bitmap <<= shift;
1737  kx->last_sequence_number_received = snum;
1738  }
1739 
1740  /* check timestamp */
1742  if (GNUNET_TIME_absolute_get_duration (t).rel_value_us >
1743  MAX_MESSAGE_AGE.rel_value_us)
1744  {
1746  "Message received far too old (%s). Content ignored.\n",
1749  GNUNET_YES));
1751  gettext_noop (
1752  "# bytes dropped (ancient message)"),
1753  size,
1754  GNUNET_NO);
1755  return;
1756  }
1757 
1758  /* process decrypted message(s) */
1759  update_timeout (kx);
1761  gettext_noop ("# bytes of payload decrypted"),
1762  size - sizeof (struct EncryptedMessage),
1763  GNUNET_NO);
1764  if (GNUNET_OK !=
1766  &buf[sizeof (struct EncryptedMessage)],
1767  size - sizeof (struct EncryptedMessage),
1768  GNUNET_YES,
1769  GNUNET_NO))
1770  GNUNET_break_op (0);
1771 }
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh(struct GNUNET_TIME_AbsoluteNBO a)
Convert absolute time from network byte order.
Definition: time.c:670
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:81
#define GNUNET_OK
Named constants for return values.
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).
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:208
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:727
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:116
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:67
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:80
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:965
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 1782 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().

1785 {
1786  struct GSC_KeyExchangeInfo *kx = connect_cls;
1787 
1789  "Peer %s has excess bandwidth available\n",
1790  GNUNET_i2s (pid));
1792  GSC_SESSIONS_solicit (pid);
1793 }
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:80
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 1801 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().

1802 {
1803  current_ekm.header.size = htons (sizeof (struct EphemeralKeyMessage));
1805  current_ekm.sender_status = 0; /* to be set later */
1808  htonl (sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) +
1809  sizeof (struct GNUNET_TIME_AbsoluteNBO) +
1810  sizeof (struct GNUNET_TIME_AbsoluteNBO) +
1811  sizeof (struct GNUNET_CRYPTO_EcdhePublicKey) +
1812  sizeof (struct GNUNET_PeerIdentity));
1816  "core",
1817  "USE_EPHEMERAL_KEYS"))
1818  {
1822  }
1823  else
1824  {
1827  }
1835 }
#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:245
#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:78
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:576
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:80
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:654
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 1844 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().

1845 {
1846  struct GSC_KeyExchangeInfo *pos;
1847 
1849  if (NULL != my_ephemeral_key)
1852  GNUNET_assert (NULL != my_ephemeral_key);
1853  sign_ephemeral_key ();
1854  {
1855  struct GNUNET_HashCode eh;
1856 
1858  sizeof (current_ekm.ephemeral_key),
1859  &eh);
1860  GNUNET_log (GNUNET_ERROR_TYPE_INFO, "Rekeying to %s\n", GNUNET_h2s (&eh));
1861  }
1862  for (pos = kx_head; NULL != pos; pos = pos->next)
1863  {
1864  if (GNUNET_CORE_KX_STATE_UP == pos->status)
1865  {
1867  monitor_notify_all (pos);
1868  derive_session_keys (pos);
1869  }
1870  if (GNUNET_CORE_KX_STATE_DOWN == pos->status)
1871  {
1873  monitor_notify_all (pos);
1874  }
1875  monitor_notify_all (pos);
1876  send_key (pos);
1877  }
1878 }
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:1246
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 1888 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().

1889 {
1891  {GNUNET_MQ_hd_fixed_size (ephemeral_key,
1893  struct EphemeralKeyMessage,
1894  NULL),
1897  struct PingMessage,
1898  NULL),
1901  struct PongMessage,
1902  NULL),
1903  GNUNET_MQ_hd_var_size (encrypted,
1905  struct EncryptedMessage,
1906  NULL),
1908 
1909  my_private_key = pk;
1913  if (NULL == my_ephemeral_key)
1914  {
1915  GNUNET_break (0);
1917  my_private_key = NULL;
1918  return GNUNET_SYSERR;
1919  }
1920  sign_ephemeral_key ();
1921  {
1922  struct GNUNET_HashCode eh;
1923 
1925  sizeof (current_ekm.ephemeral_key),
1926  &eh);
1928  "Starting with ephemeral key %s\n",
1929  GNUNET_h2s (&eh));
1930  }
1931 
1934  transport =
1936  &GSC_my_identity,
1937  handlers,
1938  NULL,
1942  if (NULL == transport)
1943  {
1944  GSC_KX_done ();
1945  return GNUNET_SYSERR;
1946  }
1947  return GNUNET_OK;
1948 }
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:78
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:1246
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:79
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:125
#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 1955 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().

1956 {
1957  if (NULL != transport)
1958  {
1960  transport = NULL;
1961  }
1962  if (NULL != rekey_task)
1963  {
1965  rekey_task = NULL;
1966  }
1967  if (NULL != my_ephemeral_key)
1968  {
1970  my_ephemeral_key = NULL;
1971  }
1972  if (NULL != my_private_key)
1973  {
1975  my_private_key = NULL;
1976  }
1977  if (NULL != nc)
1978  {
1980  nc = NULL;
1981  }
1982 }
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:141
#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:965
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 1992 of file gnunet-service-core_kx.c.

References GNUNET_MQ_get_length(), and GSC_KeyExchangeInfo::mq.

Referenced by try_transmission().

1993 {
1994  return GNUNET_MQ_get_length (kxinfo->mq);
1995 }
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:335
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 2005 of file gnunet-service-core_kx.c.

References GSC_KeyExchangeInfo::has_excess_bandwidth.

Referenced by try_transmission().

2006 {
2007  return kxinfo->has_excess_bandwidth;
2008 }
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 2020 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().

2021 {
2022  struct GNUNET_MQ_Envelope *env;
2023  struct MonitorNotifyMessage *done_msg;
2024  struct GSC_KeyExchangeInfo *kx;
2025 
2027  for (kx = kx_head; NULL != kx; kx = kx->next)
2028  {
2029  struct GNUNET_MQ_Envelope *env;
2030  struct MonitorNotifyMessage *msg;
2031 
2033  msg->state = htonl ((uint32_t) kx->status);
2034  msg->peer = *kx->peer;
2036  GNUNET_MQ_send (mq, env);
2037  }
2039  done_msg->state = htonl ((uint32_t) GNUNET_CORE_KX_ITERATION_FINISHED);
2041  GNUNET_MQ_send (mq, env);
2042 }
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:324
#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:164
#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:314
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:353
Message sent by the service to monitor clients to notify them about a peer changing status...
Definition: core.h:304
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:654
#define GNUNET_MESSAGE_TYPE_CORE_MONITOR_NOTIFY
Reply for monitor by CORE service.
struct GNUNET_PeerIdentity peer
Identity of the peer.
Definition: core.h:319
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 366 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 371 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 376 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 381 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 386 of file gnunet-service-core_kx.c.

◆ kx_tail

struct GSC_KeyExchangeInfo* kx_tail
static

DLL tail.

Definition at line 391 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 397 of file gnunet-service-core_kx.c.

◆ nc

struct GNUNET_NotificationContext* nc
static

Notification context for broadcasting to monitors.

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