[GNUnet-SVN] r24397 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2012-10-18 11:46:13 +0200 (Thu, 18 Oct 2012)
New Revision: 24397

Modified:
   gnunet/src/include/gnunet_dnsparser_lib.h
Log:
-clarify API

Modified: gnunet/src/include/gnunet_dnsparser_lib.h
===================================================================
--- gnunet/src/include/gnunet_dnsparser_lib.h   2012-10-18 09:43:08 UTC (rev 
24396)
+++ gnunet/src/include/gnunet_dnsparser_lib.h   2012-10-18 09:46:13 UTC (rev 
24397)
@@ -197,6 +197,10 @@
 
   /**
    * Name of the record that the query is for (0-terminated).
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *name;
 
@@ -226,6 +230,10 @@
 
   /**
    * Name of the mail server.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *mxhost;
 
@@ -249,6 +257,10 @@
   /**
    * Service name without the underscore (!).  Note that RFC 6335 clarifies the
    * set of legal characters for service names.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *service;
 
@@ -260,11 +272,19 @@
 
   /**
    * Domain name for which the record is valid
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *domain_name;
 
   /**
    * Hostname offering the service.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *target;
 
@@ -299,12 +319,20 @@
   /**
    *The domainname of the name server that was the
    * original or primary source of data for this zone.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *mname;
 
   /**
    * A domainname which specifies the mailbox of the
    * person responsible for this zone.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *rname;
 
@@ -365,6 +393,10 @@
 
   /**
    * Name of the record that the query is for (0-terminated).
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
    */
   char *name;
 
@@ -376,6 +408,10 @@
 
     /**
      * For NS, CNAME and PTR records, this is the uncompressed 0-terminated 
hostname.
+   * In UTF-8 format.  The library will convert from and to DNS-IDNA 
+   * as necessary.  Use 'GNUNET_DNSPARSER_check_label' to test if an
+   * individual label is well-formed.  If a given name is not well-formed,
+   * creating the DNS packet will fail.
      */
     char *hostname;