From 40e25a57655bc682c8aa13f10ab9a0fb9c10e2f2 Mon Sep 17 00:00:00 2001 From: Bart Polot Date: Mon, 21 Oct 2013 16:12:48 +0000 Subject: [PATCH] - doxygen --- src/mesh/gnunet-service-mesh_connection.c | 5 ++++- src/mesh/gnunet-service-mesh_connection.h | 5 ++++- 2 files changed, 8 insertions(+), 2 deletions(-) diff --git a/src/mesh/gnunet-service-mesh_connection.c b/src/mesh/gnunet-service-mesh_connection.c index 3f6ebc7e4..2c07baa50 100644 --- a/src/mesh/gnunet-service-mesh_connection.c +++ b/src/mesh/gnunet-service-mesh_connection.c @@ -787,8 +787,11 @@ connection_unlock_queue (struct MeshConnection *c, int fwd) /** * Cancel all transmissions that belong to a certain connection. + * + * If the connection is scheduled for destruction and no more messages are left, + * the connection will be destroyed by the continuation call. * - * @param c Connection which to cancel. + * @param c Connection which to cancel. Might be destroyed during this call. * @param fwd Cancel fwd traffic? */ static void diff --git a/src/mesh/gnunet-service-mesh_connection.h b/src/mesh/gnunet-service-mesh_connection.h index d6b261002..3f75bcdab 100644 --- a/src/mesh/gnunet-service-mesh_connection.h +++ b/src/mesh/gnunet-service-mesh_connection.h @@ -231,7 +231,10 @@ GMC_new (const struct GNUNET_HashCode *cid, unsigned int own_pos); /** - * Connection is no longer needed: destroy it and remove from tunnel. + * Connection is no longer needed: destroy it. + * + * Cancels all pending traffic (including possible DESTROY messages), all + * maintenance tasks and removes the connection from neighbor peers and tunnel. * * @param c Connection to destroy. */ -- 2.25.1