From 8a5993b15da336afade45be6ee4619a39561956a Mon Sep 17 00:00:00 2001 From: Matthias Wachs Date: Thu, 16 Jan 2014 12:29:57 +0000 Subject: documentation for transport service --- src/transport/gnunet-service-transport_validation.h | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) (limited to 'src/transport/gnunet-service-transport_validation.h') diff --git a/src/transport/gnunet-service-transport_validation.h b/src/transport/gnunet-service-transport_validation.h index d117faca5..179070454 100644 --- a/src/transport/gnunet-service-transport_validation.h +++ b/src/transport/gnunet-service-transport_validation.h @@ -32,17 +32,16 @@ #include "gnunet_hello_lib.h" /** - * Function called for each address (or address status change) that - * the validation module is aware of (for the given target). + * Function called to notify transport users that a neighbour peer changed its + * active address. * * @param cls closure - * @param public_key public key for the peer, never NULL - * @param valid_until is ZERO if we never validated the address, - * otherwise a time up to when we consider it (or was) valid - * @param validation_block is 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 - * @param address the address + * @param peer peer this update is about (never NULL) + * @param address address (never NULL) + * @param last_validation point in time when last validation was performed + * @param valid_until point in time how long address is valid + * @param next_validation point in time when next validation will be performed + * @param state state of validation notification */ typedef void (*GST_ValidationChangedCallback) (void *cls, const struct GNUNET_PeerIdentity *peer, -- cgit v1.2.3