From e6ec99f16950bc1f7f2f9c74a061616583397b23 Mon Sep 17 00:00:00 2001 From: Andreas Gustafsson Date: Wed, 31 May 2000 23:35:09 +0000 Subject: [PATCH] commented --- bin/named/include/named/aclconf.h | 18 ++++++++++++++++++ lib/dns/include/dns/aclconf.h | 18 ++++++++++++++++++ lib/dns/include/dns/resolver.h | 7 ++++++- 3 files changed, 42 insertions(+), 1 deletion(-) diff --git a/bin/named/include/named/aclconf.h b/bin/named/include/named/aclconf.h index 8df15f65cf..edea487b4e 100644 --- a/bin/named/include/named/aclconf.h +++ b/bin/named/include/named/aclconf.h @@ -35,9 +35,15 @@ ISC_LANG_BEGINDECLS void dns_aclconfctx_init(dns_aclconfctx_t *ctx); +/* + * Initialize an ACL configuration context. + */ void dns_aclconfctx_destroy(dns_aclconfctx_t *ctx); +/* + * Destroy an ACL configuration context. + */ isc_result_t dns_acl_fromconfig(dns_c_ipmatchlist_t *caml, @@ -45,6 +51,18 @@ dns_acl_fromconfig(dns_c_ipmatchlist_t *caml, dns_aclconfctx_t *ctx, isc_mem_t *mctx, dns_acl_t **target); +/* + * Construct a new dns_acl_t from configuration data in 'caml' and + * 'cctx'. Memory is allocated through 'mctx'. + * + * Any named ACLs referred to within 'caml' will be be converted + * inte nested dns_acl_t objects. Multiple references to the same + * named ACLs will be converted into shared references to a single + * nested dns_acl_t object when the referring objects were created + * passing the same ACL configuration context 'ctx'. + * + * On success, attach '*target' to the new dns_acl_t object. + */ ISC_LANG_ENDDECLS diff --git a/lib/dns/include/dns/aclconf.h b/lib/dns/include/dns/aclconf.h index 8df15f65cf..edea487b4e 100644 --- a/lib/dns/include/dns/aclconf.h +++ b/lib/dns/include/dns/aclconf.h @@ -35,9 +35,15 @@ ISC_LANG_BEGINDECLS void dns_aclconfctx_init(dns_aclconfctx_t *ctx); +/* + * Initialize an ACL configuration context. + */ void dns_aclconfctx_destroy(dns_aclconfctx_t *ctx); +/* + * Destroy an ACL configuration context. + */ isc_result_t dns_acl_fromconfig(dns_c_ipmatchlist_t *caml, @@ -45,6 +51,18 @@ dns_acl_fromconfig(dns_c_ipmatchlist_t *caml, dns_aclconfctx_t *ctx, isc_mem_t *mctx, dns_acl_t **target); +/* + * Construct a new dns_acl_t from configuration data in 'caml' and + * 'cctx'. Memory is allocated through 'mctx'. + * + * Any named ACLs referred to within 'caml' will be be converted + * inte nested dns_acl_t objects. Multiple references to the same + * named ACLs will be converted into shared references to a single + * nested dns_acl_t object when the referring objects were created + * passing the same ACL configuration context 'ctx'. + * + * On success, attach '*target' to the new dns_acl_t object. + */ ISC_LANG_ENDDECLS diff --git a/lib/dns/include/dns/resolver.h b/lib/dns/include/dns/resolver.h index 14c60b5117..2a9991d83a 100644 --- a/lib/dns/include/dns/resolver.h +++ b/lib/dns/include/dns/resolver.h @@ -25,7 +25,12 @@ /* * DNS Resolver * - * XXX XXX + * This is the BIND 9 resolver, the module responsible for resolving DNS + * requests by iteratively querying authoritative servers and following + * referrals. This is a "full resolver", not to be confused with + * the stub resolvers most people associate with the word "resolver". + * The full resolver is part of the caching name server or resolver + * daemon the stub resolver talks to. * * MP: * The module ensures appropriate synchronization of data structures it