From bfc4767894f8c14d463fdcd17f33b65c2bc0f5e2 Mon Sep 17 00:00:00 2001 From: Mark Andrews Date: Wed, 10 Feb 1999 05:45:00 +0000 Subject: [PATCH] Additional description of function --- lib/dns/include/dns/master.h | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) diff --git a/lib/dns/include/dns/master.h b/lib/dns/include/dns/master.h index 4886e1052a..344ae6d8a5 100644 --- a/lib/dns/include/dns/master.h +++ b/lib/dns/include/dns/master.h @@ -37,9 +37,24 @@ dns_result_t dns_master_load(char *master_file, isc_mem_t *mctx); /* + * Loads a RFC 1305 master file from disk into rdatasets then call + * 'callbacks->commit' to commit the dataset. Rdata memory belongs + * to dns_master_load and will be reused / released when the callback + * completes. + * + * 'callbacks->commit' is assumed to call 'callbacks->error' or + * 'callbacks->warn' to generate any error messages required. + * * Requires: - * callbacks->commit to point ta a valid function. - * masterfile point to a valid string. + * 'master_file' to point to a valid string. + * 'top' to point to a valid name. + * 'origin' to point to a valid name. + * 'soacount' to point to a int. + * 'nscount' to point to a int. + * 'callbacks->commit' to point ta a valid function. + * 'callbacks->error' to point ta a valid function. + * 'callbacks->warn' to point ta a valid function. + * 'mctx' to point to a memory context. */ #endif /* DNS_MASTER_H */