Commit 3c11c877 authored by Bob Halley's avatar Bob Halley
Browse files

update comments

parent 95e0ab82
...@@ -429,6 +429,10 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version, ...@@ -429,6 +429,10 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version,
* To respond to a query for SIG records, the caller should create a * To respond to a query for SIG records, the caller should create a
* rdataset iterator and extract the signatures from each rdataset. * rdataset iterator and extract the signatures from each rdataset.
* *
* Making queries of type ANY with DNS_DBFIND_GLUEOK is not recommended,
* because the burden of determining whether a given rdataset is valid
* glue or not falls upon the caller.
*
* Requires: * Requires:
* *
* 'db' is a valid database. * 'db' is a valid database.
...@@ -465,7 +469,14 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version, ...@@ -465,7 +469,14 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version,
* the DNS_DBFIND_GLUEOK option * the DNS_DBFIND_GLUEOK option
* is set. This result can only * is set. This result can only
* occur if 'db' is a zone * occur if 'db' is a zone
* database. * database. If type ==
* dns_rdatatype_any, then the
* node returned may contain, or
* consist entirely of invalid
* glue (i.e. data occluded by a
* zone cut). The caller must
* take care not to return invalid
* glue to a client.
* *
* DNS_R_DELEGATION The data requested is beneath * DNS_R_DELEGATION The data requested is beneath
* a zone cut. node, foundname, * a zone cut. node, foundname,
...@@ -478,9 +489,10 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version, ...@@ -478,9 +489,10 @@ dns_db_find(dns_db_t *db, dns_name_t *name, dns_dbversion_t *version,
* DNS_R_ZONECUT type == dns_rdatatype_any, and * DNS_R_ZONECUT type == dns_rdatatype_any, and
* the desired node is a zonecut. * the desired node is a zonecut.
* The caller must take care not * The caller must take care not
* to return glue. This result * to return inappropriate glue
* can only occur if 'db' is a * to a client. This result can
* zone database. * only occur if 'db' is a zone
* database.
* *
* DNS_R_DNAME The data requested is beneath * DNS_R_DNAME The data requested is beneath
* a DNAME. node, foundname, * a DNAME. node, foundname,
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment