[GNUnet-SVN] r15816 - gnunet/src/nat

[gnunet]

Author: grothoff
Date: 2011-07-01 18:02:42 +0200 (Fri, 01 Jul 2011)
New Revision: 15816

Modified:
   gnunet/src/nat/nat_test.c
Log:
comments

Modified: gnunet/src/nat/nat_test.c
===================================================================
--- gnunet/src/nat/nat_test.c   2011-07-01 15:13:39 UTC (rev 15815)
+++ gnunet/src/nat/nat_test.c   2011-07-01 16:02:42 UTC (rev 15816)
@@ -28,37 +28,39 @@
 #include "gnunet_nat_lib.h"
 #include "nat.h"
 
+
 /**
- *
+ * Entry we keep for each incoming connection.
  */
 struct NatActivity
 {
   /**
-   *
+   * This is a doubly-linked list.
    */
   struct NatActivity *next;
 
   /**
-   *
+   * This is a doubly-linked list.
    */
   struct NatActivity *prev;
 
   /**
-   *
+   * Socket of the incoming connection.
    */
   struct GNUNET_NETWORK_Handle *sock;
 
   /**
-   *
+   * Handle of the master context.
    */
   struct GNUNET_NAT_Test *h;
 
   /**
-   *
+   * Task reading from the incoming connection.
    */
   GNUNET_SCHEDULER_TaskIdentifier rtask;
 };
 
+
 /**
  * Handle to a NAT test.
  */
@@ -66,57 +68,57 @@
 {
 
   /**
-   *
+   * Configuration used
    */
   const struct GNUNET_CONFIGURATION_Handle *cfg;
 
   /**
-   *
+   * Function to call with success report
    */
   GNUNET_NAT_TestCallback report;
   
   /**
-   *
+   * Closure for 'report'.
    */
   void *report_cls;
 
   /**
-   *
+   * Handle to NAT traversal in use
    */
   struct GNUNET_NAT_Handle *nat;
 
   /**
-   *
+   * Handle to listen socket, or NULL
    */
   struct GNUNET_NETWORK_Handle *lsock;
 
   /**
-   *
+   * Head of list of nat activities.
    */
   struct NatActivity *head;
 
   /**
-   *
+   * Tail of list of nat activities.
    */
   struct NatActivity *tail;
 
   /**
-   *
+   * Identity of task for the listen socket (if any)
    */
   GNUNET_SCHEDULER_TaskIdentifier ltask;
 
   /**
-   *
+   * GNUNET_YES if we're testing TCP
    */
   int is_tcp;
 
   /**
-   *
+   * Data that should be transmitted or source-port.
    */
   uint16_t data;
 
   /**
-   *
+   * Advertised port to the other peer.
    */
   uint16_t adv_port;