comments
authorChristian Grothoff <christian@grothoff.org>
Fri, 1 Jul 2011 16:02:42 +0000 (16:02 +0000)
committerChristian Grothoff <christian@grothoff.org>
Fri, 1 Jul 2011 16:02:42 +0000 (16:02 +0000)
src/nat/nat_test.c

index a8bf227a03422cccec4396aa7c3eb994c605cb0b..4b502ec60fd814d7cb2a91f1c57bb51616aab0d3 100644 (file)
 #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 @@ struct GNUNET_NAT_Test
 {
 
   /**
-   *
+   * 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;