X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Ftransport%2Fgnunet-service-transport_validation.h;h=8d11413db77012a668be4fbd25a781a284fde3b3;hb=ec50a665dc884f7997419d0351ae8ade9c1aeabe;hp=929e97a5ca2168b9590f166914c398d648d308d2;hpb=ca35f67faee8371fa763bdf49f04a8d5d4cdc021;p=oweals%2Fgnunet.git diff --git a/src/transport/gnunet-service-transport_validation.h b/src/transport/gnunet-service-transport_validation.h index 929e97a5c..8d11413db 100644 --- a/src/transport/gnunet-service-transport_validation.h +++ b/src/transport/gnunet-service-transport_validation.h @@ -1,21 +1,19 @@ /* This file is part of GNUnet. - (C) 2010,2011 Christian Grothoff (and other contributing authors) + Copyright (C) 2010,2011 GNUnet e.V. - GNUnet is free software; you can redistribute it and/or modify - it under the terms of the GNU General Public License as published - by the Free Software Foundation; either version 3, or (at your - option) any later version. + GNUnet is free software: you can redistribute it and/or modify it + under the terms of the GNU Affero General Public License as published + by the Free Software Foundation, either version 3 of the License, + or (at your option) any later version. GNUnet is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - General Public License for more details. - - You should have received a copy of the GNU General Public License - along with GNUnet; see the file COPYING. If not, write to the - Free Software Foundation, Inc., 59 Temple Place - Suite 330, - Boston, MA 02111-1307, USA. + Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . */ /** @@ -31,7 +29,6 @@ #include "gnunet_util_lib.h" #include "gnunet_hello_lib.h" - /** * Start the validation subsystem. * @@ -53,33 +50,13 @@ GST_validation_stop (void); * Based on this, the validation module will measure latency for the * address more or less often. * - * @param address the address - * @param session the session - * @param in_use GNUNET_YES if we are now using the address for a connection, - * GNUNET_NO if we are no longer using the address for a connection - * @param line line of caller just for DEBUGGING! + * @param address the address that we are now using (or not) + * @param in_use #GNUNET_YES if we are now using the address for a connection, + * #GNUNET_NO if we are no longer using the address for a connection */ void GST_validation_set_address_use (const struct GNUNET_HELLO_Address *address, - struct Session *session, - int in_use, - int line); - - -/** - * Query validation about the latest observed latency on a given - * address. - * - * @param sender peer - * @param address the address - * @param session session - * @return observed latency of the address, FOREVER if the address was - * never successfully validated - */ -struct GNUNET_TIME_Relative -GST_validation_get_address_latency (const struct GNUNET_PeerIdentity *sender, - const struct GNUNET_HELLO_Address *address, - struct Session *session); + int in_use); /** @@ -89,12 +66,13 @@ GST_validation_get_address_latency (const struct GNUNET_PeerIdentity *sender, * @param hdr the PING * @param sender_address address of the sender, NULL if we did not initiate * @param session session we got the PING from + * @return #GNUNET_OK if the message was fine, #GNUNET_SYSERR on serious error */ -void +int GST_validation_handle_ping (const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *hdr, const struct GNUNET_HELLO_Address *sender_address, - struct Session *session); + struct GNUNET_ATS_Session *session); /** @@ -103,8 +81,9 @@ GST_validation_handle_ping (const struct GNUNET_PeerIdentity *sender, * * @param sender peer sending the PONG * @param hdr the PONG + * @return #GNUNET_OK if the message was fine, #GNUNET_SYSERR on serious error */ -void +int GST_validation_handle_pong (const struct GNUNET_PeerIdentity *sender, const struct GNUNET_MessageHeader *hdr); @@ -114,11 +93,21 @@ GST_validation_handle_pong (const struct GNUNET_PeerIdentity *sender, * validation. * * @param hello the HELLO we received + * @return #GNUNET_OK if the message was fine, #GNUNET_SYSERR on serious error */ -void +int GST_validation_handle_hello (const struct GNUNET_MessageHeader *hello); +/** + * Validate an individual address. + * + * @param address address we should try to validate + */ +void +GST_validation_handle_address (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). @@ -132,16 +121,11 @@ GST_validation_handle_hello (const struct GNUNET_MessageHeader *hello); * otherwise a time in the future if we're currently denying re-validation * @param address the address */ -typedef void (*GST_ValidationAddressCallback) (void *cls, - const struct - GNUNET_CRYPTO_EccPublicKeyBinaryEncoded - * public_key, - struct GNUNET_TIME_Absolute - valid_until, - struct GNUNET_TIME_Absolute - validation_block, - const struct GNUNET_HELLO_Address - * address); +typedef void +(*GST_ValidationAddressCallback) (void *cls, + struct GNUNET_TIME_Absolute valid_until, + struct GNUNET_TIME_Absolute validation_block, + const struct GNUNET_HELLO_Address *address); /** @@ -149,7 +133,7 @@ typedef void (*GST_ValidationAddressCallback) (void *cls, * * @param target peer information is requested for * @param cb function to call; will not be called after this function returns - * @param cb_cls closure for 'cb' + * @param cb_cls closure for @a cb */ void GST_validation_get_addresses (const struct GNUNET_PeerIdentity *target,