DNSTABLE_READER(3) DNSTABLE_READER(3) NAME dnstable_reader - read dnstable data from an mtbl source SYNOPSIS #include <dnstable.h> struct dnstable_reader * dnstable_reader_init(const struct mtbl_source *s); struct dnstable_reader * dnstable_reader_init_setfile(const char *setfile); void dnstable_reader_reload_setfile(struct dnstable_reader *r); void dnstable_reader_destroy(struct dnstable_reader **r); struct dnstable_iter * dnstable_reader_iter(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_rrset(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_rrset_names(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_rdata(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_rdata_names(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_time_range(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_source_info(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_iter_version(struct dnstable_reader *r); struct dnstable_iter * dnstable_reader_query(struct dnstable_reader *r, struct dnstable_query *q); DESCRIPTION dnstable_reader is the high-level interface for reading dnstable entries from a dnstable data source. Results are returned through the dnstable_iter interface. dnstable_reader objects can be initialized by calling dnsta- ble_reader_init(), which takes an mtbl_source object, or by calling dnsta- ble_reader_init_setfile(), which takes a full path name to a "setfile", which is a text file containing a list of dnstable data file paths, one per line. The directory name of that path is prepended to each data file's path. For example, if the setfile path is "/export/dnstable/mtbl/dns.file- set", and a line in it is of the form "dns.2017.Y.mtbl" then dnstable will try to open "/export/dnstable/mtbl/dns.2017.Y.mtbl". dnstable_reader_reload_setfile() will force a reload of a dnstable_reader object initialized by dnstable_reader_init_setfile() by re-reading the un- derlying setfile. dnstable_reader_iter() iterates over every entry object in the data source. dnstable_reader_iter_rrset() iterates over just the entries of type DNSTA- BLE_ENTRY_TYPE_RRSET. Likewise, dnstable_reader_iter_rdata() iterates over just the entries of type DNSTABLE_ENTRY_TYPE_RDATA, dnsta- ble_reader_iter_rrset_names() iterates over entries of type DNSTABLE_EN- TRY_TYPE_RRSET_NAME_FWD, and dnstable_reader_iter_rdata_names() iterates over just the entries of type DNSTABLE_ENTRY_TYPE_RDATA_NAME_REV. dnstable_reader_query() iterates over all the entry objects that match the specified query object. The query object is used during the operation of the returned iterator, and must not be destroyed until after the iterator is destroyed. SEE ALSO dnstable_iter(3), dnstable_query(3), mtbl_source(3) 02/02/2024 DNSTABLE_READER(3)
NAME | SYNOPSIS | DESCRIPTION | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=dnstable_reader&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>