GNUnet  0.11.x
Typedefs | Functions
gnunet-service-transport_validation.h File Reference

address validation API More...

#include "gnunet_statistics_service.h"
#include "gnunet_transport_plugin.h"
#include "gnunet_util_lib.h"
#include "gnunet_hello_lib.h"
Include dependency graph for gnunet-service-transport_validation.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs

typedef void(* GST_ValidationAddressCallback) (void *cls, struct GNUNET_TIME_Absolute valid_until, struct GNUNET_TIME_Absolute validation_block, const struct GNUNET_HELLO_Address *address)
 Function called for each address (or address status change) that the validation module is aware of (for the given target). More...
 

Functions

void GST_validation_start (unsigned int max_fds)
 Start the validation subsystem. More...
 
void GST_validation_stop (void)
 Stop the validation subsystem. More...
 
void GST_validation_set_address_use (const struct GNUNET_HELLO_Address *address, int in_use)
 Update if we are using an address for a connection actively right now. More...
 
int GST_validation_handle_ping (const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *hdr, const struct GNUNET_HELLO_Address *sender_address, struct GNUNET_ATS_Session *session)
 We've received a PING. More...
 
int GST_validation_handle_pong (const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *hdr)
 We've received a PONG. More...
 
int GST_validation_handle_hello (const struct GNUNET_MessageHeader *hello)
 We've received a HELLO, check which addresses are new and trigger validation. More...
 
void GST_validation_handle_address (const struct GNUNET_HELLO_Address *address)
 Validate an individual address. More...
 
void GST_validation_get_addresses (const struct GNUNET_PeerIdentity *target, GST_ValidationAddressCallback cb, void *cb_cls)
 Call the given function for each address for the given target. More...
 

Detailed Description

address validation API

Author
Christian Grothoff

Definition in file gnunet-service-transport_validation.h.

Typedef Documentation

◆ GST_ValidationAddressCallback

typedef void(* GST_ValidationAddressCallback) (void *cls, struct GNUNET_TIME_Absolute valid_until, struct GNUNET_TIME_Absolute validation_block, const struct GNUNET_HELLO_Address *address)

Function called for each address (or address status change) that the validation module is aware of (for the given target).

Parameters
clsclosure
public_keypublic key for the peer, never NULL
valid_untilis ZERO if we never validated the address, otherwise a time up to when we consider it (or was) valid
validation_blockis FOREVER if the address is for an unsupported plugin (from PEERINFO) is ZERO if the address is considered valid (no validation needed) otherwise a time in the future if we're currently denying re-validation
addressthe address

Definition at line 127 of file gnunet-service-transport_validation.h.

Function Documentation

◆ GST_validation_start()

void GST_validation_start ( unsigned int  max_fds)

Start the validation subsystem.

Parameters
max_fdsmaximum number of fds to use

Initialization for validation throttling

We have a maximum number max_fds of connections we can use for validation We monitor the number of validations in parallel and start to throttle it when doing to many validations in parallel: if (running validations < (max_fds / 2))

  • "fast start": run validation immediately
  • have delay of (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT.rel_value_us) / (max_fds / 2) (300 sec / ~150 == ~2 sec.) between two validations

Definition at line 982 of file gnunet-service-transport_validation.c.

References gettext_noop, GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT, GNUNET_CONTAINER_multipeermap_create(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_NO, GNUNET_PEERINFO_notify(), GNUNET_STATISTICS_set(), GNUNET_STRINGS_relative_time_to_string(), GNUNET_TIME_absolute_get(), GNUNET_YES, GST_cfg, GST_stats, process_peerinfo_hello(), GNUNET_TIME_Relative::rel_value_us, validation_delay, VALIDATION_MAP_SIZE, validation_next, validations_fast_start_threshold, and validations_running.

Referenced by run().

996  (GNUNET_CONSTANTS_IDLE_CONNECTION_TIMEOUT.rel_value_us) / (max_fds / 2);
997  validations_fast_start_threshold = (max_fds / 2);
1000  gettext_noop ("# validations running"),
1002  GNUNET_NO);
1004  "Validation uses a fast start threshold of %u connections and a delay of %s\n",
1007  GNUNET_YES));
1009  GNUNET_NO);
1011  &process_peerinfo_hello, NULL);
1012 }
uint64_t rel_value_us
The actual value.
static struct GNUNET_TIME_Absolute validation_next
When is next validation allowed.
#define GNUNET_NO
Definition: gnunet_common.h:78
struct GNUNET_CONTAINER_MultiPeerMap * GNUNET_CONTAINER_multipeermap_create(unsigned int len, int do_not_copy_keys)
Create a multi peer map (hash map for public keys of peers).
struct GNUNET_PEERINFO_NotifyContext * GNUNET_PEERINFO_notify(const struct GNUNET_CONFIGURATION_Handle *cfg, int include_friend_only, GNUNET_PEERINFO_Processor callback, void *callback_cls)
Call a method whenever our known information about peers changes.
static struct GNUNET_STATISTICS_Handle * GST_stats
Statistics handle.
static unsigned int validations_running
Number of validations running; any PING that was not yet matched by a PONG and for which we have not ...
#define VALIDATION_MAP_SIZE
Size of the validation map hashmap.
static void process_peerinfo_hello(void *cls, const struct GNUNET_PeerIdentity *peer, const struct GNUNET_HELLO_Message *hello, const char *err_msg)
Function called for any HELLO known to PEERINFO.
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:687
static struct GNUNET_CONTAINER_MultiPeerMap * validation_map
Map of PeerIdentities to &#39;struct ValidationEntry*&#39;s (addresses of the given peer that we are currentl...
void GNUNET_STATISTICS_set(struct GNUNET_STATISTICS_Handle *handle, const char *name, uint64_t value, int make_persistent)
Set statistic value for the peer.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get(void)
Get the current time.
Definition: time.c:118
static struct GNUNET_TIME_Relative validation_delay
Minimum delay between to validations.
#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...
static struct GNUNET_PEERINFO_NotifyContext * pnc
Context for peerinfo iteration.
#define GNUNET_log(kind,...)
#define GNUNET_YES
Definition: gnunet_common.h:77
static const struct GNUNET_CONFIGURATION_Handle * GST_cfg
Configuration handle.
static unsigned int validations_fast_start_threshold
Validition fast start threshold.
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_stop()

void GST_validation_stop ( void  )

Stop the validation subsystem.

Definition at line 1019 of file gnunet-service-transport_validation.c.

References cleanup_validation_entry(), GNUNET_CONTAINER_multipeermap_destroy(), GNUNET_CONTAINER_multipeermap_iterate(), and GNUNET_PEERINFO_notify_cancel().

Referenced by shutdown_task().

1020 {
1023  NULL);
1025  validation_map = NULL;
1027 }
void GNUNET_PEERINFO_notify_cancel(struct GNUNET_PEERINFO_NotifyContext *nc)
Stop notifying about changes.
void GNUNET_CONTAINER_multipeermap_destroy(struct GNUNET_CONTAINER_MultiPeerMap *map)
Destroy a hash map.
static int cleanup_validation_entry(void *cls, const struct GNUNET_PeerIdentity *key, void *value)
Iterate over validation entries and free them.
static struct GNUNET_CONTAINER_MultiPeerMap * validation_map
Map of PeerIdentities to &#39;struct ValidationEntry*&#39;s (addresses of the given peer that we are currentl...
int GNUNET_CONTAINER_multipeermap_iterate(struct GNUNET_CONTAINER_MultiPeerMap *map, GNUNET_CONTAINER_PeerMapIterator it, void *it_cls)
Iterate over all entries in the map.
static struct GNUNET_PEERINFO_NotifyContext * pnc
Context for peerinfo iteration.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_set_address_use()

void GST_validation_set_address_use ( const struct GNUNET_HELLO_Address address,
int  in_use 
)

Update if we are using an address for a connection actively right now.

Based on this, the validation module will measure latency for the address more or less often.

Parameters
addressthe address that we are now using (or not)
in_useGNUNET_YES if we are now using the address for a connection, GNUNET_NO if we are no longer using the address for a connection

Definition at line 1784 of file gnunet-service-transport_validation.c.

References find_validation_entry(), GNUNET_break, GNUNET_HELLO_address_check_option(), GNUNET_HELLO_ADDRESS_INFO_INBOUND, GNUNET_SCHEDULER_add_now(), GNUNET_SCHEDULER_cancel(), GNUNET_YES, GST_plugins_find(), ValidationEntry::in_use, revalidate_address(), ValidationEntry::revalidation_task, and GNUNET_HELLO_Address::transport_name.

Referenced by free_address(), and set_primary_address().

1786 {
1787  struct ValidationEntry *ve;
1788 
1789  if (GNUNET_HELLO_address_check_option (address,
1791  return; /* ignore inbound for validation */
1792  if (NULL == GST_plugins_find (address->transport_name))
1793  {
1794  /* How can we use an address for which we don't have the plugin? */
1795  GNUNET_break (0);
1796  return;
1797  }
1798  ve = find_validation_entry (address);
1799  if (NULL == ve)
1800  {
1801  GNUNET_break (0);
1802  return;
1803  }
1804  if (in_use == ve->in_use)
1805  return;
1806  ve->in_use = in_use;
1807  if (GNUNET_YES == in_use)
1808  {
1809  /* from now on, higher frequeny, so reschedule now */
1810  if (NULL != ve->revalidation_task)
1813  ve);
1814  }
1815 }
int in_use
Are we currently using this address for a connection?
Information about an address under validation.
static struct ValidationEntry * find_validation_entry(const struct GNUNET_HELLO_Address *address)
Find a ValidationEntry entry for the given neighbour that matches the given address and transport...
#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 * revalidation_task
ID of task that will trigger address revalidation.
int GNUNET_HELLO_address_check_option(const struct GNUNET_HELLO_Address *address, enum GNUNET_HELLO_AddressInfo option)
Check if an address has a local option set.
Definition: address.c:39
This is an inbound address and cannot be used to initiate an outbound connection to another peer...
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_now(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run as soon as possible.
Definition: scheduler.c:1280
const char * transport_name
Name of the transport plugin enabling the communication using this address.
struct GNUNET_TRANSPORT_PluginFunctions * GST_plugins_find(const char *name)
Obtain the plugin API based on a plugin name.
static void revalidate_address(void *cls)
Do address validation again to keep address valid.
#define GNUNET_YES
Definition: gnunet_common.h:77
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_handle_ping()

int GST_validation_handle_ping ( const struct GNUNET_PeerIdentity sender,
const struct GNUNET_MessageHeader hdr,
const struct GNUNET_HELLO_Address sender_address,
struct GNUNET_ATS_Session session 
)

We've received a PING.

If appropriate, generate a PONG.

Parameters
senderpeer sending the PING
hdrthe PING
sender_addressaddress of the sender, NULL if we did not initiate
sessionsession we got the PING from
Returns
GNUNET_OK if the message was fine, GNUNET_SYSERR on serious error

If appropriate, generate a PONG.

Parameters
senderpeer sending the PING
hdrthe PING
sender_addressthe sender address as we got it
sessionsession we got the PING from
Returns
GNUNET_OK if the message was fine, GNUNET_SYSERR on serious error

Definition at line 1090 of file gnunet-service-transport_validation.c.

References _, ACCEPTABLE_PING_DELAY, GNUNET_HELLO_Address::address, GNUNET_HELLO_Address::address_length, TransportPongMessage::addrlen, TransportPingMessage::challenge, TransportPongMessage::challenge, GNUNET_TRANSPORT_PluginFunctions::check_address, GNUNET_TRANSPORT_PluginFunctions::cls, TransportPongMessage::expiration, GNUNET_TRANSPORT_PluginFunctions::get_session, gettext_noop, GNUNET_assert, GNUNET_break, GNUNET_break_op, GNUNET_CRYPTO_eddsa_sign(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_ERROR, GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_HELLO_ADDRESS_INFO_NONE, GNUNET_i2s(), GNUNET_i2s_full(), GNUNET_log, GNUNET_malloc, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_TRANSPORT_PONG, GNUNET_NO, GNUNET_OK, GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN, GNUNET_snprintf(), GNUNET_STATISTICS_update(), GNUNET_strdup, GNUNET_SYSERR, GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_absolute_hton(), GNUNET_TIME_relative_to_absolute(), GNUNET_YES, GST_hello_test_address(), GST_my_identity, GST_my_private_key, GST_neighbours_notify_data_sent(), GST_plugins_a2s(), GST_plugins_find(), GST_stats, GST_validation_get_addresses(), TransportPongMessage::header, GNUNET_HELLO_Address::local_info, multicast_pong(), GNUNET_HELLO_Address::peer, ping(), plugin_name, pong(), PONG_PRIORITY, PONG_SIGNATURE_LIFETIME, GNUNET_CRYPTO_EccSignaturePurpose::purpose, TransportPongMessage::purpose, GNUNET_TIME_Relative::rel_value_us, ret, GNUNET_TRANSPORT_PluginFunctions::send, TransportPongMessage::signature, GNUNET_CRYPTO_EccSignaturePurpose::size, GNUNET_MessageHeader::size, TransportPingMessage::target, GNUNET_HELLO_Address::transport_name, and GNUNET_MessageHeader::type.

Referenced by GST_receive_callback().

1094 {
1095  const struct TransportPingMessage *ping;
1096  struct TransportPongMessage *pong;
1097  struct GNUNET_TRANSPORT_PluginFunctions *papi;
1098  struct GNUNET_CRYPTO_EddsaSignature *sig_cache;
1099  struct GNUNET_TIME_Absolute *sig_cache_exp;
1100  const char *addr;
1101  const char *addrend;
1102  char *plugin_name;
1103  char *pos;
1104  size_t len_address;
1105  size_t len_plugin;
1106  ssize_t ret;
1108 
1109  if (0 ==
1110  memcmp (&GST_my_identity,
1111  sender,
1112  sizeof(struct GNUNET_PeerIdentity)))
1113  return GNUNET_OK; /* our own, ignore! */
1114  if (ntohs (hdr->size) < sizeof(struct TransportPingMessage))
1115  {
1116  GNUNET_break_op (0);
1117  return GNUNET_SYSERR;
1118  }
1119  ping = (const struct TransportPingMessage *) hdr;
1120  if (0 !=
1121  memcmp (&ping->target,
1122  &GST_my_identity,
1123  sizeof(struct GNUNET_PeerIdentity)))
1124  {
1126  gettext_noop
1127  ("# PING message for different peer received"),
1128  1,
1129  GNUNET_NO);
1130  return GNUNET_SYSERR;
1131  }
1133  gettext_noop ("# PING messages received"), 1,
1134  GNUNET_NO);
1135  addr = (const char *) &ping[1];
1136  len_address = ntohs (hdr->size) - sizeof(struct TransportPingMessage);
1137  /* peer wants to confirm that this is one of our addresses, this is what is
1138  * used for address validation */
1139 
1140  sig_cache = NULL;
1141  sig_cache_exp = NULL;
1142  papi = NULL;
1143  if (len_address > 0)
1144  {
1145  addrend = memchr (addr, '\0', len_address);
1146  if (NULL == addrend)
1147  {
1148  GNUNET_break_op (0);
1149  return GNUNET_SYSERR;
1150  }
1151  addrend++;
1152  len_plugin = strlen (addr) + 1;
1153  len_address -= len_plugin;
1155  address.address = addrend;
1156  address.address_length = len_address;
1157  address.transport_name = addr;
1158  address.peer = GST_my_identity;
1159 
1160  if (NULL == address.transport_name)
1161  {
1162  GNUNET_break (0);
1163  }
1164 
1165  if (0 != strstr (address.transport_name, "_client"))
1166  {
1167  plugin_name = GNUNET_strdup (address.transport_name);
1168  pos = strstr (plugin_name, "_client");
1169  GNUNET_assert (NULL != pos);
1170  GNUNET_snprintf (pos, strlen ("_server") + 1, "%s", "_server");
1171  }
1172  else
1173  plugin_name = GNUNET_strdup (address.transport_name);
1174 
1175  if (NULL == (papi = GST_plugins_find (plugin_name)))
1176  {
1177  /* we don't have the plugin for this address */
1179  _ (
1180  "Plugin `%s' not available, cannot confirm having this address\n"),
1181  plugin_name);
1182  GNUNET_free (plugin_name);
1183  return GNUNET_SYSERR;
1184  }
1185  GNUNET_free (plugin_name);
1186  if (GNUNET_OK !=
1187  papi->check_address (papi->cls,
1188  addrend,
1189  len_address))
1190  {
1192  gettext_noop
1193  ("# failed address checks during validation"),
1194  1,
1195  GNUNET_NO);
1197  _ (
1198  "Address `%s' is not one of my addresses, not confirming PING\n"),
1200  return GNUNET_SYSERR;
1201  }
1202  else
1203  {
1205  gettext_noop
1206  (
1207  "# successful address checks during validation"),
1208  1,
1209  GNUNET_NO);
1211  "Address `%s' is one of my addresses, confirming PING\n",
1213  }
1214 
1215  if (GNUNET_YES !=
1217  &sig_cache,
1218  &sig_cache_exp))
1219  {
1221  _ (
1222  "Not confirming PING from peer `%s' with address `%s' since I cannot confirm having this address.\n"),
1223  GNUNET_i2s (sender),
1225  return GNUNET_SYSERR;
1226  }
1227  }
1228  else
1229  {
1230  addrend = NULL; /* make gcc happy */
1231  len_plugin = 0;
1232  static struct GNUNET_CRYPTO_EddsaSignature no_address_signature;
1233  static struct GNUNET_TIME_Absolute no_address_signature_expiration;
1234 
1235  sig_cache = &no_address_signature;
1236  sig_cache_exp = &no_address_signature_expiration;
1237  }
1238 
1240  "I am `%s', sending PONG to peer `%s'\n",
1242  GNUNET_i2s (sender));
1243 
1244  /* message with structure:
1245  * [TransportPongMessage][Transport name][Address] */
1246 
1247  pong = GNUNET_malloc (sizeof(struct TransportPongMessage) + len_address
1248  + len_plugin);
1249  pong->header.size =
1250  htons (sizeof(struct TransportPongMessage) + len_address + len_plugin);
1252  pong->purpose.size =
1253  htonl (sizeof(struct GNUNET_CRYPTO_EccSignaturePurpose)
1254  + sizeof(uint32_t) + sizeof(struct GNUNET_TIME_AbsoluteNBO)
1255  + len_address + len_plugin);
1257  GNUNET_memcpy (&pong->challenge, &ping->challenge, sizeof(ping->challenge));
1258  pong->addrlen = htonl (len_address + len_plugin);
1259  GNUNET_memcpy (&pong[1], addr, len_plugin); /* Copy transport plugin */
1260  if (len_address > 0)
1261  {
1262  GNUNET_assert (NULL != addrend);
1263  GNUNET_memcpy (&((char *) &pong[1])[len_plugin], addrend, len_address);
1264  }
1265  if (GNUNET_TIME_absolute_get_remaining (*sig_cache_exp).rel_value_us <
1266  PONG_SIGNATURE_LIFETIME.rel_value_us / 4)
1267  {
1268  /* create / update cached sig */
1270  "Creating PONG signature to indicate ownership.\n");
1272  pong->expiration = GNUNET_TIME_absolute_hton (*sig_cache_exp);
1273  if (GNUNET_OK !=
1275  sig_cache))
1276  {
1278  _ ("Failed to create PONG signature for peer `%s'\n"),
1279  GNUNET_i2s (sender));
1280  }
1281  }
1282  else
1283  {
1284  pong->expiration = GNUNET_TIME_absolute_hton (*sig_cache_exp);
1285  }
1286  pong->signature = *sig_cache;
1287 
1288  GNUNET_assert (NULL != sender_address);
1289 
1290  /* first see if the session we got this PING from can be used to transmit
1291  * a response reliably */
1292  if (NULL == papi)
1293  {
1294  ret = -1;
1295  }
1296  else
1297  {
1298  GNUNET_assert (NULL != papi->send);
1299  GNUNET_assert (NULL != papi->get_session);
1300  if (NULL == session)
1301  {
1302  session = papi->get_session (papi->cls, sender_address);
1303  }
1304  if (NULL == session)
1305  {
1306  GNUNET_break (0);
1307  ret = -1;
1308  }
1309  else
1310  {
1311  ret = papi->send (papi->cls, session,
1312  (const char *) pong,
1313  ntohs (pong->header.size),
1315  NULL, NULL);
1316  if (-1 != ret)
1317  GST_neighbours_notify_data_sent (sender_address,
1318  session,
1319  pong->header.size);
1320  }
1321  }
1322  if (-1 != ret)
1323  {
1325  "Transmitted PONG to `%s' via reliable mechanism\n",
1326  GNUNET_i2s (sender));
1327  /* done! */
1329  gettext_noop
1330  ("# PONGs unicast via reliable transport"), 1,
1331  GNUNET_NO);
1332  GNUNET_free (pong);
1333  return GNUNET_OK;
1334  }
1335 
1336  /* no reliable method found, try transmission via all known addresses */
1338  gettext_noop
1339  ("# PONGs multicast to all available addresses"),
1340  1,
1341  GNUNET_NO);
1343  &multicast_pong, pong);
1344  GNUNET_free (pong);
1345  return GNUNET_OK;
1346 }
static struct GNUNET_PeerIdentity GST_my_identity
Our public key.
static void ping(void *cls)
Send a ping to destination.
GNUNET_TRANSPORT_CreateSession get_session
Function that will be called tell the plugin to create a session object.
uint64_t rel_value_us
The actual value.
uint32_t purpose
What does this signature vouch for? This must contain a GNUNET_SIGNATURE_PURPOSE_XXX constant (from g...
int GNUNET_snprintf(char *buf, size_t size, const char *format,...)
Like snprintf, just aborts if the buffer is of insufficient size.
GNUNET_TRANSPORT_TransmitFunction send
Function that the transport service will use to transmit data to another peer.
struct GNUNET_MessageHeader header
Type will be GNUNET_MESSAGE_TYPE_TRANSPORT_PONG.
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
void GST_validation_get_addresses(const struct GNUNET_PeerIdentity *target, GST_ValidationAddressCallback cb, void *cb_cls)
Call the given function for each address for the given target.
struct GNUNET_CRYPTO_EddsaSignature signature
Signature.
Each plugin is required to return a pointer to a struct of this type as the return value from its ent...
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:987
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
#define GNUNET_NO
Definition: gnunet_common.h:78
const char * GNUNET_i2s_full(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define PONG_PRIORITY
Priority to use for PONGs.
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.
uint32_t addrlen
Size of address appended to this message (part of what is being signed, hence not redundant)...
#define GNUNET_strdup(a)
Wrapper around GNUNET_xstrdup_.
Time for absolute time used by GNUnet, in microseconds and in network byte order. ...
int GST_hello_test_address(const struct GNUNET_HELLO_Address *address, struct GNUNET_CRYPTO_EddsaSignature **sig, struct GNUNET_TIME_Absolute **sig_expiration)
Test if a particular address is one of ours.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
static void multicast_pong(void *cls, struct GNUNET_TIME_Absolute valid_until, struct GNUNET_TIME_Absolute validation_block, const struct GNUNET_HELLO_Address *address)
Send the given PONG to the given address.
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
header of what an ECC signature signs this must be followed by "size - 8" bytes of the actual signed ...
Message used to ask a peer to validate receipt (to check an address from a HELLO).
uint16_t type
The type of the message (GNUNET_MESSAGE_TYPE_XXXX), in big-endian format.
static struct GNUNET_STATISTICS_Handle * GST_stats
Statistics handle.
void * cls
Closure for all of the callbacks.
#define ACCEPTABLE_PING_DELAY
How much delay is acceptable for sending the PING or PONG?
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
Message used to validate a HELLO.
void GST_neighbours_notify_data_sent(const struct GNUNET_HELLO_Address *address, struct GNUNET_ATS_Session *session, size_t size)
Track information about data we transmitted using the given address and session (used to notify ATS a...
const char * GST_plugins_a2s(const struct GNUNET_HELLO_Address *address)
Convert a given address to a human-readable format.
uint32_t size
How many bytes does this signature sign? (including this purpose header); in network byte order (!)...
struct GNUNET_TRANSPORT_PluginFunctions * GST_plugins_find(const char *name)
Obtain the plugin API based on a plugin name.
uint32_t challenge
Challenge code from PING (showing freshness).
static void pong(struct GNUNET_CADET_Channel *channel, const struct CadetPingMessage *ping)
Reply with a pong to origin.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
struct GNUNET_CRYPTO_EccSignaturePurpose purpose
GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN to confirm that this is a plausible address for the signi...
#define PONG_SIGNATURE_LIFETIME
How long is a PONG signature valid? We&#39;ll recycle a signature until 1/4 of this time is remaining...
an ECC signature using EdDSA.
#define GNUNET_MESSAGE_TYPE_TRANSPORT_PONG
Transport PONG message.
static struct GNUNET_CRYPTO_EddsaPrivateKey * GST_my_private_key
Our private key.
The identity of the host (wraps the signing key of the peer).
No additional information.
#define GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN
Signature for confirming that this peer uses a particular address.
An address for communicating with a 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
Time for absolute times used by GNUnet, in microseconds.
#define GNUNET_YES
Definition: gnunet_common.h:77
GNUNET_TRANSPORT_CheckAddress check_address
Function that will be called to check if a binary address for this plugin is well-formed and correspo...
uint32_t challenge
Challenge code (to ensure fresh reply).
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:657
static char * address
GNS address for this phone.
struct GNUNET_PeerIdentity target
Who is the intended recipient?
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
static char * plugin_name
Name of our plugin.
#define GNUNET_malloc(size)
Wrapper around malloc.
struct GNUNET_TIME_AbsoluteNBO expiration
When does this signature expire?
#define GNUNET_free(ptr)
Wrapper around free.
#define gettext_noop(String)
Definition: gettext.h:69
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_handle_pong()

int GST_validation_handle_pong ( const struct GNUNET_PeerIdentity sender,
const struct GNUNET_MessageHeader hdr 
)

We've received a PONG.

Check if it matches a pending PING and mark the respective address as confirmed.

Parameters
senderpeer sending the PONG
hdrthe PONG
Returns
GNUNET_OK if the message was fine, GNUNET_SYSERR on serious error

Definition at line 1448 of file gnunet-service-transport_validation.c.

References add_valid_peer_address(), GNUNET_HELLO_Address::address, ValidationEntry::address, GNUNET_HELLO_Address::address_length, TransportPongMessage::addrlen, ValidationEntry::copied, GNUNET_ATS_Properties::delay, ValidationEntry::expecting_pong, TransportPongMessage::expiration, find_validation_entry(), gettext_noop, GNUNET_assert, GNUNET_break, GNUNET_break_op, GNUNET_CRYPTO_eddsa_verify(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_INFO, GNUNET_ERROR_TYPE_WARNING, GNUNET_free, GNUNET_HELLO_ADDRESS_INFO_NONE, GNUNET_HELLO_create(), GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_NT_UNSPECIFIED, GNUNET_OK, GNUNET_PEERINFO_add_peer(), GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN, GNUNET_STATISTICS_set(), GNUNET_STATISTICS_update(), GNUNET_SYSERR, GNUNET_TIME_absolute_get_duration(), GNUNET_TIME_absolute_get_remaining(), GNUNET_TIME_absolute_ntoh(), GNUNET_TIME_relative_divide(), GNUNET_TIME_relative_to_absolute(), GNUNET_TRANSPORT_VS_UPDATE, GNUNET_YES, GST_ats_add_address(), GST_ats_is_known_no_session(), GST_ats_update_delay(), GST_my_identity, GST_peerinfo, GST_plugins_a2s(), GST_plugins_find(), GST_stats, HELLO_ADDRESS_EXPIRATION, ValidationEntry::known_to_ats, ValidationEntry::latency, GNUNET_HELLO_Address::local_info, ValidationEntry::network, GNUNET_HELLO_Address::peer, pong(), ValidationEntry::pong_sig_cache, ValidationEntry::pong_sig_valid_until, GNUNET_PeerIdentity::public_key, TransportPongMessage::purpose, GNUNET_TIME_Relative::rel_value_us, GNUNET_ATS_Properties::scope, ValidationEntry::send_time, TransportPongMessage::signature, size, GNUNET_MessageHeader::size, GNUNET_HELLO_Address::transport_name, ValidationEntry::valid_until, validation_entry_changed(), and validations_running.

Referenced by GST_receive_callback().

1450 {
1451  const struct TransportPongMessage *pong;
1452  struct ValidationEntry *ve;
1453  const char *tname;
1454  const char *addr;
1455  size_t addrlen;
1456  size_t slen;
1457  size_t size;
1458  struct GNUNET_HELLO_Message *hello;
1460  int sig_res;
1461  int do_verify;
1462 
1463  if (0 ==
1464  memcmp (&GST_my_identity,
1465  sender,
1466  sizeof(struct GNUNET_PeerIdentity)))
1467  return GNUNET_OK; /* our own, ignore! */
1468 
1469  if (ntohs (hdr->size) < sizeof(struct TransportPongMessage))
1470  {
1471  GNUNET_break_op (0);
1472  return GNUNET_SYSERR;
1473  }
1475  gettext_noop ("# PONG messages received"), 1,
1476  GNUNET_NO);
1477 
1478  /* message with structure:
1479  * [TransportPongMessage][Transport name][Address] */
1480 
1481  pong = (const struct TransportPongMessage *) hdr;
1482  tname = (const char *) &pong[1];
1483  size = ntohs (hdr->size) - sizeof(struct TransportPongMessage);
1484  addr = memchr (tname, '\0', size);
1485  if (NULL == addr)
1486  {
1487  GNUNET_break_op (0);
1488  return GNUNET_SYSERR;
1489  }
1490  addr++;
1491  slen = strlen (tname) + 1;
1492  addrlen = size - slen;
1493 
1494  if (NULL == GST_plugins_find (tname))
1495  {
1496  /* we got the PONG, but the transport plugin specified in it
1497  is not supported by this peer, so this cannot be a good
1498  PONG for us. */
1499  GNUNET_break_op (0);
1500  return GNUNET_OK;
1501  }
1502 
1503  address.peer = *sender;
1504  address.address = addr;
1505  address.address_length = addrlen;
1506  address.transport_name = tname;
1509  if ((NULL == ve) || (GNUNET_NO == ve->expecting_pong))
1510  {
1512  gettext_noop
1513  (
1514  "# PONGs dropped, no matching pending validation"),
1515  1, GNUNET_NO);
1516  return GNUNET_OK;
1517  }
1518  /* now check that PONG is well-formed */
1519  if (0 != memcmp (&ve->address->peer,
1520  sender,
1521  sizeof(struct GNUNET_PeerIdentity)))
1522  {
1523  GNUNET_break_op (0);
1524  return GNUNET_SYSERR;
1525  }
1526  if (0 ==
1529  {
1531  gettext_noop
1532  ("# PONGs dropped, signature expired"), 1,
1533  GNUNET_NO);
1534  return GNUNET_SYSERR;
1535  }
1536 
1537  sig_res = GNUNET_SYSERR;
1538  do_verify = GNUNET_YES;
1541  {
1542  /* We have a cached and valid signature for this peer,
1543  * try to compare instead of verify */
1544  if (0 == memcmp (&ve->pong_sig_cache,
1545  &pong->signature,
1546  sizeof(struct GNUNET_CRYPTO_EddsaSignature)))
1547  {
1548  /* signatures are identical, we can skip verification */
1549  sig_res = GNUNET_OK;
1550  do_verify = GNUNET_NO;
1551  }
1552  else
1553  {
1554  sig_res = GNUNET_SYSERR;
1555  /* signatures do not match, we have to verify */
1556  }
1557  }
1558 
1559  if (GNUNET_YES == do_verify)
1560  {
1561  /* Do expensive verification */
1562  sig_res = GNUNET_CRYPTO_eddsa_verify (
1564  &pong->purpose,
1565  &pong->signature,
1566  &ve->address->peer.public_key);
1567  if (sig_res == GNUNET_SYSERR)
1568  {
1569  GNUNET_break_op (0);
1571  "Failed to verify: invalid signature on address `%s':%s from peer `%s'\n",
1572  tname,
1573  GST_plugins_a2s (ve->address),
1574  GNUNET_i2s (sender));
1575  }
1576  }
1577  if (sig_res == GNUNET_SYSERR)
1578  {
1579  GNUNET_break_op (0);
1580  return GNUNET_SYSERR;
1581  }
1582 
1584  "Validation process successful for peer `%s' with plugin `%s' address `%s'\n",
1585  GNUNET_i2s (sender),
1586  tname,
1587  GST_plugins_a2s (ve->address));
1589  gettext_noop ("# validations succeeded"),
1590  1,
1591  GNUNET_NO);
1592  /* validity achieved, remember it! */
1593  ve->expecting_pong = GNUNET_NO;
1595  ve->pong_sig_cache = pong->signature;
1598  {
1599  if (GNUNET_YES == ve->known_to_ats)
1600  {
1605  }
1606  else
1607  {
1608  struct GNUNET_ATS_Properties prop;
1609 
1610  memset (&prop, 0, sizeof(prop));
1612  prop.scope = ve->network;
1613  prop.delay = GNUNET_TIME_relative_divide (ve->latency, 2);
1616  ve->known_to_ats = GNUNET_YES;
1617  GST_ats_add_address (ve->address, &prop);
1620  }
1621  }
1622  if (validations_running > 0)
1623  {
1626  gettext_noop ("# validations running"),
1628  GNUNET_NO);
1630  "Validation finished, %u validation processes running\n",
1632  }
1633  else
1634  {
1635  GNUNET_break (0);
1636  }
1637 
1638  /* Notify about new validity */
1641 
1642  /* build HELLO to store in PEERINFO */
1644  gettext_noop ("# HELLOs given to peerinfo"),
1645  1,
1646  GNUNET_NO);
1647  ve->copied = GNUNET_NO;
1648  hello = GNUNET_HELLO_create (&ve->address->peer.public_key,
1650  ve,
1651  GNUNET_NO);
1652  GNUNET_break (NULL !=
1654  hello,
1655  NULL,
1656  NULL));
1657  GNUNET_free (hello);
1658  return GNUNET_OK;
1659 }
static struct GNUNET_PeerIdentity GST_my_identity
Our public key.
A HELLO message is used to exchange information about transports with other peers.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_ntoh(struct GNUNET_TIME_AbsoluteNBO a)
Convert absolute time from network byte order.
Definition: time.c:673
uint64_t rel_value_us
The actual value.
struct GNUNET_TIME_Absolute valid_until
Until when is this address valid? ZERO if it is not currently considered valid.
int expecting_pong
Are we expecting a PONG message for this validation entry?
struct GNUNET_HELLO_Message * GNUNET_HELLO_create(const struct GNUNET_CRYPTO_EddsaPublicKey *public_key, GNUNET_HELLO_GenerateAddressListCallback addrgen, void *addrgen_cls, int friend_only)
Construct a HELLO message given the public key, expiration time and an iterator that spews the transp...
Definition: hello.c:204
int copied
When passing the address in add_valid_peer_address(), did we copy the address to the HELLO yet...
struct GNUNET_TIME_Absolute GNUNET_TIME_relative_to_absolute(struct GNUNET_TIME_Relative rel)
Convert relative time to an absolute time in the future.
Definition: time.c:246
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_CRYPTO_EddsaSignature signature
Signature.
Information about an address under validation.
void GST_ats_add_address(const struct GNUNET_HELLO_Address *address, const struct GNUNET_ATS_Properties *prop)
Notify ATS about the new address including the network this address is located in.
int known_to_ats
Is this address known to ATS as valid right now?
static ssize_t add_valid_peer_address(void *cls, size_t max, void *buf)
Add the validated peer address to the HELLO.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
void GNUNET_STATISTICS_update(struct GNUNET_STATISTICS_Handle *handle, const char *name, int64_t delta, int make_persistent)
Set statistic value for the peer.
uint32_t addrlen
Size of address appended to this message (part of what is being signed, hence not redundant)...
static struct ValidationEntry * find_validation_entry(const struct GNUNET_HELLO_Address *address)
Find a ValidationEntry entry for the given neighbour that matches the given address and transport...
static void validation_entry_changed(struct ValidationEntry *ve, enum GNUNET_TRANSPORT_ValidationState state)
A validation entry changed.
ATS performance characteristics for an address.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
struct GNUNET_TIME_Relative latency
Last observed latency for this address (round-trip), delay between last PING sent and PONG received; ...
static struct GNUNET_STATISTICS_Handle * GST_stats
Statistics handle.
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:1114
static unsigned int validations_running
Number of validations running; any PING that was not yet matched by a PONG and for which we have not ...
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
Message used to validate a HELLO.
const char * GST_plugins_a2s(const struct GNUNET_HELLO_Address *address)
Convert a given address to a human-readable format.
void GNUNET_STATISTICS_set(struct GNUNET_STATISTICS_Handle *handle, const char *name, uint64_t value, int make_persistent)
Set statistic value for the peer.
struct GNUNET_TRANSPORT_PluginFunctions * GST_plugins_find(const char *name)
Obtain the plugin API based on a plugin name.
struct GNUNET_MQ_Envelope * GNUNET_PEERINFO_add_peer(struct GNUNET_PEERINFO_Handle *h, const struct GNUNET_HELLO_Message *hello, GNUNET_SCHEDULER_TaskCallback cont, void *cont_cls)
Add a host to the persistent list.
Definition: peerinfo_api.c:553
int GST_ats_is_known_no_session(const struct GNUNET_HELLO_Address *address)
Test if ATS knows about this address.
struct GNUNET_CRYPTO_EddsaSignature pong_sig_cache
Cached PONG signature.
static void pong(struct GNUNET_CADET_Channel *channel, const struct CadetPingMessage *ping)
Reply with a pong to origin.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
static unsigned int size
Size of the "table".
Definition: peer.c:67
struct GNUNET_CRYPTO_EccSignaturePurpose purpose
GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN to confirm that this is a plausible address for the signi...
struct GNUNET_PeerIdentity peer
For which peer is this an address?
an ECC signature using EdDSA.
#define HELLO_ADDRESS_EXPIRATION
After how long do we expire an address in a HELLO that we just validated? This value is also used for...
The identity of the host (wraps the signing key of the peer).
No additional information.
struct GNUNET_PEERINFO_Handle * GST_peerinfo
Handle to peerinfo service.
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:375
#define GNUNET_SIGNATURE_PURPOSE_TRANSPORT_PONG_OWN
Signature for confirming that this peer uses a particular address.
An address for communicating with a peer.
void GST_ats_update_delay(const struct GNUNET_HELLO_Address *address, struct GNUNET_TIME_Relative delay)
Notify ATS about delay changes to properties of an address.
struct GNUNET_TIME_Absolute pong_sig_valid_until
Until when is the cached PONG signature valid? ZERO if it is not currently considered valid...
#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
enum GNUNET_NetworkType network
Which network type does our address belong to?
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:527
#define GNUNET_YES
Definition: gnunet_common.h:77
struct GNUNET_TIME_Absolute send_time
At what time did we send the latest validation request (PING)?
static char * address
GNS address for this phone.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
struct GNUNET_TIME_AbsoluteNBO expiration
When does this signature expire?
#define GNUNET_free(ptr)
Wrapper around free.
struct GNUNET_HELLO_Address * address
The address.
struct GNUNET_CRYPTO_EddsaPublicKey public_key
#define gettext_noop(String)
Definition: gettext.h:69
Category of last resort.
Definition: gnunet_nt_lib.h:40
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_handle_hello()

int GST_validation_handle_hello ( const struct GNUNET_MessageHeader hello)

We've received a HELLO, check which addresses are new and trigger validation.

Parameters
hellothe HELLO we received
Returns
GNUNET_OK if the message was fine, GNUNET_SYSERR on serious error

Definition at line 1670 of file gnunet-service-transport_validation.c.

References GNUNET_assert, GNUNET_break_op, GNUNET_ERROR_TYPE_DEBUG, GNUNET_HELLO_get_id(), GNUNET_HELLO_is_friend_only(), GNUNET_HELLO_iterate_addresses(), GNUNET_i2s(), GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, GNUNET_YES, GST_my_identity, GNUNET_MessageHeader::size, and validate_address_iterator().

Referenced by GST_receive_callback(), and handle_client_hello().

1671 {
1672  const struct GNUNET_HELLO_Message *hm =
1673  (const struct GNUNET_HELLO_Message *) hello;
1674  struct GNUNET_PeerIdentity pid;
1675  int friend;
1676 
1677  friend = GNUNET_HELLO_is_friend_only (hm);
1678  if (((GNUNET_YES != friend) &&
1679  (GNUNET_NO != friend)) ||
1680  (GNUNET_OK != GNUNET_HELLO_get_id (hm, &pid)))
1681  {
1682  /* malformed HELLO */
1683  GNUNET_break_op (0);
1684  return GNUNET_SYSERR;
1685  }
1686  if (0 ==
1687  memcmp (&GST_my_identity,
1688  &pid,
1689  sizeof(struct GNUNET_PeerIdentity)))
1690  {
1691  /* got our own HELLO, how boring */
1693  "Validation received our own HELLO (%s), ignoring\n",
1694  GNUNET_i2s (&pid));
1695  return GNUNET_OK;
1696  }
1698  "Validation received HELLO message for peer `%s' with size %u, checking for new addresses\n",
1699  GNUNET_i2s (&pid),
1700  ntohs (hello->size));
1701  GNUNET_assert (NULL ==
1703  GNUNET_NO,
1705  NULL));
1706  return GNUNET_OK;
1707 }
static struct GNUNET_PeerIdentity GST_my_identity
Our public key.
int GNUNET_HELLO_get_id(const struct GNUNET_HELLO_Message *hello, struct GNUNET_PeerIdentity *peer)
Get the peer identity from a HELLO message.
Definition: hello.c:671
A HELLO message is used to exchange information about transports with other peers.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_NO
Definition: gnunet_common.h:78
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
struct GNUNET_HELLO_Message * GNUNET_HELLO_iterate_addresses(const struct GNUNET_HELLO_Message *msg, int return_modified, GNUNET_HELLO_AddressIterator it, void *it_cls)
Iterate over all of the addresses in the HELLO.
Definition: hello.c:254
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
int GNUNET_HELLO_is_friend_only(const struct GNUNET_HELLO_Message *h)
Return HELLO type.
Definition: hello.c:89
static int validate_address_iterator(void *cls, const struct GNUNET_HELLO_Address *address, struct GNUNET_TIME_Absolute expiration)
Iterator callback to go over all addresses and try to validate them (unless blocked or already valida...
The identity of the host (wraps the signing key of the peer).
#define GNUNET_log(kind,...)
#define GNUNET_YES
Definition: gnunet_common.h:77
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).
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_handle_address()

void GST_validation_handle_address ( const struct GNUNET_HELLO_Address address)

Validate an individual address.

Parameters
addressaddress we should try to validate

Definition at line 1355 of file gnunet-service-transport_validation.c.

References ValidationEntry::address, find_validation_entry(), GNUNET_ERROR_TYPE_INFO, GNUNET_i2s(), GNUNET_log, GNUNET_SCHEDULER_add_now(), GST_plugins_a2s(), GST_plugins_find(), GNUNET_HELLO_Address::peer, revalidate_address(), ValidationEntry::revalidation_task, and GNUNET_HELLO_Address::transport_name.

Referenced by plugin_env_session_start_bl_check_cont(), and validate_address_iterator().

1356 {
1357  struct GNUNET_TRANSPORT_PluginFunctions *papi;
1358  struct ValidationEntry *ve;
1359 
1360  papi = GST_plugins_find (address->transport_name);
1361  if (NULL == papi)
1362  {
1363  /* This plugin is currently unvailable ... ignore */
1365  "No plugin available for %s\n",
1366  address->transport_name);
1367  return;
1368  }
1369  ve = find_validation_entry (address);
1370  if (NULL == ve->revalidation_task)
1371  {
1373  "Validation process started for fresh address `%s' of %s\n",
1374  GST_plugins_a2s (ve->address),
1375  GNUNET_i2s (&ve->address->peer));
1377  }
1378  else
1379  {
1381  "Validation already running for address `%s' of %s\n",
1382  GST_plugins_a2s (ve->address),
1383  GNUNET_i2s (&ve->address->peer));
1384  }
1385 }
Information about an address under validation.
Each plugin is required to return a pointer to a struct of this type as the return value from its ent...
static struct ValidationEntry * find_validation_entry(const struct GNUNET_HELLO_Address *address)
Find a ValidationEntry entry for the given neighbour that matches the given address and transport...
struct GNUNET_SCHEDULER_Task * revalidation_task
ID of task that will trigger address revalidation.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_now(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run as soon as possible.
Definition: scheduler.c:1280
const char * transport_name
Name of the transport plugin enabling the communication using this address.
const char * GST_plugins_a2s(const struct GNUNET_HELLO_Address *address)
Convert a given address to a human-readable format.
struct GNUNET_TRANSPORT_PluginFunctions * GST_plugins_find(const char *name)
Obtain the plugin API based on a plugin name.
struct GNUNET_PeerIdentity peer
For which peer is this an address?
#define GNUNET_log(kind,...)
static void revalidate_address(void *cls)
Do address validation again to keep address valid.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
struct GNUNET_HELLO_Address * address
The address.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GST_validation_get_addresses()

void GST_validation_get_addresses ( const struct GNUNET_PeerIdentity target,
GST_ValidationAddressCallback  cb,
void *  cb_cls 
)

Call the given function for each address for the given target.

Parameters
targetpeer information is requested for
cbfunction to call; will not be called after this function returns
cb_clsclosure for cb

Can either give a snapshot (synchronous API) or be continuous.

Parameters
targetpeer information is requested for
cbfunction to call; will not be called after this function returns
cb_clsclosure for cb

Definition at line 1760 of file gnunet-service-transport_validation.c.

References IteratorContext::cb, IteratorContext::cb_cls, GNUNET_CONTAINER_multipeermap_get_multiple(), and iterate_addresses().

Referenced by GST_validation_handle_ping().

1763 {
1764  struct IteratorContext ic;
1765 
1766  ic.cb = cb;
1767  ic.cb_cls = cb_cls;
1769  target,
1770  &iterate_addresses, &ic);
1771 }
static int iterate_addresses(void *cls, const struct GNUNET_PeerIdentity *key, void *value)
Call the callback in the closure for each validation entry.
Closure for the neighbours_iterate() function.
static struct GNUNET_CONTAINER_MultiPeerMap * validation_map
Map of PeerIdentities to &#39;struct ValidationEntry*&#39;s (addresses of the given peer that we are currentl...
GST_NeighbourIterator cb
Function to call on each connected neighbour.
int GNUNET_CONTAINER_multipeermap_get_multiple(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, GNUNET_CONTAINER_PeerMapIterator it, void *it_cls)
Iterate over all entries in the map that match a particular key.
Here is the call graph for this function:
Here is the caller graph for this function: