RECLAIM/OIDC: code cleanup

[oweals/gnunet.git] / src / include / gnunet_transport_core_service.h

diff --git a/src/include/gnunet_transport_core_service.h b/src/include/gnunet_transport_core_service.h
index 6dada4f54effe4aa3788fa6f6431f16374b02f50..f442b53c0a648d058e11bff2054201b189f224ed 100644 (file)
--- a/src/include/gnunet_transport_core_service.h
+++ b/src/include/gnunet_transport_core_service.h
@@ -2,20 +2,20 @@
      This file is part of GNUnet.
      Copyright (C) 2009-2016 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.
+     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 <http://www.gnu.org/licenses/>.
 
-     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., 51 Franklin Street, Fifth Floor,
-     Boston, MA 02110-1301, USA.
+     SPDX-License-Identifier: AGPL3.0-or-later
 */
 /**
  * @author Christian Grothoff
@@ -60,12 +60,15 @@ struct GNUNET_TRANSPORT_CoreHandle;
  * peer connected to us.
  *
  * @param cls closure
- * @param peer the peer that connected
+ * @param peer the identity of the peer that connected; this
+ *        pointer will remain valid until the disconnect, hence
+ *        applications do not necessarily have to make a copy 
+ *        of the value if they only need it until disconnect
  * @param mq message queue to use to transmit to @a peer
  * @return closure to use in MQ handlers
  */
 typedef void *
-(*GNUNET_TRANSPORT_NotifyConnecT) (void *cls,
+(*GNUNET_TRANSPORT_NotifyConnect) (void *cls,
                                    const struct GNUNET_PeerIdentity *peer,
                                    struct GNUNET_MQ_Handle *mq);
 
@@ -76,13 +79,13 @@ typedef void *
  * connect notification will be destroyed and must not be used
  * henceforth.
  *
- * @param cls closure from #GNUNET_TRANSPORT_connecT
+ * @param cls closure from #GNUNET_TRANSPORT_core_connect
  * @param peer the peer that disconnected
  * @param handlers_cls closure of the handlers, was returned from the
  *                    connect notification callback
  */
 typedef void
-(*GNUNET_TRANSPORT_NotifyDisconnecT) (void *cls,
+(*GNUNET_TRANSPORT_NotifyDisconnect) (void *cls,
                                       const struct GNUNET_PeerIdentity *peer,
                                       void *handler_cls);
 
@@ -104,7 +107,7 @@ typedef void
  *                    connect notification callback
  */
 typedef void
-(*GNUNET_TRANSPORT_NotifyExcessBandwidtH)(void *cls,
+(*GNUNET_TRANSPORT_NotifyExcessBandwidth)(void *cls,
                                           const struct GNUNET_PeerIdentity *neighbour,
                                           void *handlers_cls);
 
@@ -132,9 +135,9 @@ 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,
-                               GNUNET_TRANSPORT_NotifyExcessBandwidtH neb);
+                               GNUNET_TRANSPORT_NotifyConnect nc,
+                               GNUNET_TRANSPORT_NotifyDisconnect nd,
+                               GNUNET_TRANSPORT_NotifyExcessBandwidth neb);
 
 
 /**