Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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_rdata(struct dnstable_reader *r);

       struct dnstable_iter *
       dnstable_reader_query(struct dnstable_reader *r,	struct dnstable_query *q);

       struct dnstable_iter *
       dnstable_reader_query_no_aggregate(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
       dnstable_reader_init(), which takes an mtbl_source object, or by
       calling dnstable_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.fileset", 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 underlying setfile.

       dnstable_reader_iter() iterates over every entry	object in the data
       source.

       dnstable_reader_iter_rrset() iterates over just the entries of type
       DNSTABLE_ENTRY_TYPE_RRSET. Likewise, dnstable_reader_iter_rdata()
       iterates	over just the entries of type DNSTABLE_ENTRY_TYPE_RDATA.

       dnstable_reader_query() iterates	over all the entry objects that	match
       the specified query object.

       dnstable_reader_query_no_aggregate() iterates over all the entry
       objects that match the specified	query object, but does not call	a
       merge function to aggregate values.

SEE ALSO
       dnstable_iter(3), dnstable_query(3), mtbl_source(3)

				  05/31/2018		    DNSTABLE_READER(3)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dnstable_reader&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help