From ea648e70a989cca190cd7403fe892fd2dcc290b4 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 5 May 2024 20:37:14 +0200 Subject: Adding upstream version 1:9.11.5.P4+dfsg. Signed-off-by: Daniel Baumann --- lib/lwres/man/lwres_getrrsetbyname.docbook | 215 +++++++++++++++++++++++++++++ 1 file changed, 215 insertions(+) create mode 100644 lib/lwres/man/lwres_getrrsetbyname.docbook (limited to 'lib/lwres/man/lwres_getrrsetbyname.docbook') diff --git a/lib/lwres/man/lwres_getrrsetbyname.docbook b/lib/lwres/man/lwres_getrrsetbyname.docbook new file mode 100644 index 0000000..97f75f5 --- /dev/null +++ b/lib/lwres/man/lwres_getrrsetbyname.docbook @@ -0,0 +1,215 @@ + + + + + + 2007-06-18 + + + ISC + Internet Systems Consortium, Inc. + + + + lwres_getrrsetbyname + 3 + BIND9 + + + + + 2000 + 2001 + 2004 + 2005 + 2007 + 2014 + 2015 + 2016 + 2018 + 2019 + Internet Systems Consortium, Inc. ("ISC") + + + + + lwres_getrrsetbyname + lwres_freerrset + retrieve DNS records + + + +#include <lwres/netdb.h> + + +int +lwres_getrrsetbyname + const char *hostname + unsigned int rdclass + unsigned int rdtype + unsigned int flags + struct rrsetinfo **res + + + +void +lwres_freerrset + struct rrsetinfo *rrset + + + + + The following structures are used: + + +struct rdatainfo { + unsigned int rdi_length; /* length of data */ + unsigned char *rdi_data; /* record data */ +}; + + + +struct rrsetinfo { + unsigned int rri_flags; /* RRSET_VALIDATED... */ + unsigned int rri_rdclass; /* class number */ + unsigned int rri_rdtype; /* RR type number */ + unsigned int rri_ttl; /* time to live */ + unsigned int rri_nrdatas; /* size of rdatas array */ + unsigned int rri_nsigs; /* size of sigs array */ + char *rri_name; /* canonical name */ + struct rdatainfo *rri_rdatas; /* individual records */ + struct rdatainfo *rri_sigs; /* individual signatures */ +}; + + + + + DESCRIPTION + + lwres_getrrsetbyname() + gets a set of resource records associated with a + hostname, class, + and type. + hostname is a pointer a to + null-terminated string. The flags field + is currently unused and must be zero. + + + After a successful call to + lwres_getrrsetbyname(), + *res is a pointer to an + rrsetinfo structure, containing a list of one or + more rdatainfo structures containing resource + records and potentially another list of rdatainfo + structures containing SIG resource records associated with those + records. The members rri_rdclass and + rri_rdtype are copied from the parameters. + rri_ttl and rri_name + are properties of the obtained rrset. The resource records + contained in rri_rdatas and + rri_sigs are in uncompressed DNS wire + format. Properties of the rdataset are represented in the + rri_flags bitfield. If the RRSET_VALIDATED + bit is set, the data has been DNSSEC validated and the + signatures verified. + + + All of the information returned by + lwres_getrrsetbyname() is dynamically + allocated: the rrsetinfo and + rdatainfo structures, and the canonical + host name strings pointed to by the + rrsetinfostructure. + + Memory allocated for the dynamically allocated structures + created by a successful call to + lwres_getrrsetbyname() is released by + lwres_freerrset(). + + rrset is a pointer to a struct + rrset created by a call to + lwres_getrrsetbyname(). + + + + RETURN VALUES + + lwres_getrrsetbyname() + returns zero on success, and one of the following error codes if + an error occurred: + + + + ERRSET_NONAME + + + the name does not exist + + + + + + ERRSET_NODATA + + + the name exists, but does not have data of the desired type + + + + + + ERRSET_NOMEMORY + + + memory could not be allocated + + + + + + ERRSET_INVAL + + + a parameter is invalid + + + + + + ERRSET_FAIL + + + other failure + + + + + + + + + + + + + + + + SEE ALSO + + + lwres3 + . + + + + -- cgit v1.2.3