4139N/A - Copyright (C) 2000, 2001 Internet Software Consortium. 4139N/A - Permission to use, copy, modify, and distribute this software for any 4139N/A - purpose with or without fee is hereby granted, provided that the above 4139N/A - copyright notice and this permission notice appear in all copies. 4139N/A - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM 4139N/A - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL 4139N/A - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL 4139N/A - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, 4139N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING 4139N/A - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, 4139N/A - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION 4139N/A - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 4139N/A>lwres_getrrsetbyname</
TITLE 4139N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.61 4139N/A>lwres_getrrsetbyname, lwres_freerrset -- retrieve DNS records</
DIV 4139N/A>(const char *hostname, unsigned int rdclass, unsigned int rdtype, unsigned int flags, struct rrsetinfo **res);</
CODE 4139N/A>(struct rrsetinfo *rrset);</
CODE 4139N/A>The following structures are used:
4139N/A unsigned int rdi_length; /* length of data */
4139N/A unsigned char *rdi_data; /* record data */
4139N/A unsigned int rri_flags; /* RRSET_VALIDATED... */
4139N/A unsigned int rri_rdclass; /* class number */
4139N/A unsigned int rri_rdtype; /* RR type number */
4139N/A unsigned int rri_ttl; /* time to live */
4139N/A unsigned int rri_nrdatas; /* size of rdatas array */
4139N/A unsigned int rri_nsigs; /* size of sigs array */
4139N/A char *rri_name; /* canonical name */
4139N/A struct rdatainfo *rri_rdatas; /* individual records */
4139N/A struct rdatainfo *rri_sigs; /* individual signatures */
4139N/Agets a set of resource records associated with a
4139N/Aa pointer a to null-terminated string. The
4139N/Afield is currently unused and must be zero.</
P 4139N/Astructure, containing a list of one or more
4139N/Astructures containing resource records and potentially another list of
4139N/Astructures containing SIG resource records
4139N/Aassociated with those records.
4139N/Aare copied from the parameters.
4139N/Aare properties of the obtained rrset.
4139N/AThe resource records contained in
4139N/Aare in uncompressed DNS wire format.
4139N/AProperties of the rdataset are represented in the
4139N/Abitfield. If the RRSET_VALIDATED bit is set, the data has been DNSSEC
4139N/Avalidated and the signatures verified. </
P 4139N/A>All of the information returned by
4139N/Ais dynamically allocated: the
4139N/Aand the canonical host name strings pointed to by the
4139N/AMemory allocated for the dynamically allocated structures created by
4139N/Areturns zero on success, and one of the following error
4139N/A>the name exists, but does not have data of the desired type</
P 4139N/A>memory could not be allocated</
P