lwres_getrrsetbyname.html revision c651f15b30f1dae5cc2f00878fb5da5b3a35a468
163N/A<!--
163N/A - Copyright (C) 2004, 2005 Internet Systems Consortium, Inc. ("ISC")
163N/A - Copyright (C) 2000, 2001 Internet Software Consortium.
163N/A -
163N/A - Permission to use, copy, modify, and distribute this software for any
163N/A - purpose with or without fee is hereby granted, provided that the above
163N/A - copyright notice and this permission notice appear in all copies.
163N/A -
163N/A - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
163N/A - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
163N/A - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
163N/A - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
163N/A - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
163N/A - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
163N/A - PERFORMANCE OF THIS SOFTWARE.
163N/A-->
163N/A
163N/A<!-- $Id: lwres_getrrsetbyname.html,v 1.11 2005/04/07 03:50:03 marka Exp $ -->
163N/A
163N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
163N/A<HTML
163N/A><HEAD
844N/A><TITLE
163N/A>lwres_getrrsetbyname</TITLE
163N/A><META
163N/ANAME="GENERATOR"
163N/ACONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
163N/A><BODY
163N/ACLASS="REFENTRY"
211N/ABGCOLOR="#FFFFFF"
636N/ATEXT="#000000"
636N/ALINK="#0000FF"
211N/AVLINK="#840084"
211N/AALINK="#0000FF"
844N/A><H1
844N/A><A
618N/ANAME="AEN1"
163N/A></A
163N/A>lwres_getrrsetbyname</H1
163N/A><DIV
163N/ACLASS="REFNAMEDIV"
163N/A><A
211N/ANAME="AEN8"
163N/A></A
163N/A><H2
163N/A>Name</H2
163N/A>lwres_getrrsetbyname, lwres_freerrset&nbsp;--&nbsp;retrieve DNS records</DIV
163N/A><DIV
163N/ACLASS="REFSYNOPSISDIV"
163N/A><A
163N/ANAME="AEN12"
163N/A></A
163N/A><H2
163N/A>Synopsis</H2
163N/A><DIV
163N/ACLASS="FUNCSYNOPSIS"
163N/A><P
163N/A></P
163N/A><A
163N/ANAME="AEN13"
163N/A></A
163N/A><PRE
163N/ACLASS="FUNCSYNOPSISINFO"
163N/A>#include &lt;lwres/netdb.h&gt;</PRE
163N/A><P
163N/A><CODE
163N/A><CODE
163N/ACLASS="FUNCDEF"
163N/A>int
163N/Alwres_getrrsetbyname</CODE
163N/A>(const char *hostname, unsigned int rdclass, unsigned int rdtype, unsigned int flags, struct rrsetinfo **res);</CODE
163N/A></P
163N/A><P
211N/A><CODE
163N/A><CODE
163N/ACLASS="FUNCDEF"
163N/A>void
163N/Alwres_freerrset</CODE
163N/A>(struct rrsetinfo *rrset);</CODE
211N/A></P
163N/A><P
163N/A></P
163N/A></DIV
163N/A><P
163N/A>The following structures are used:
163N/A<PRE
163N/ACLASS="PROGRAMLISTING"
163N/A>struct rdatainfo {
163N/A unsigned int rdi_length; /* length of data */
211N/A unsigned char *rdi_data; /* record data */
211N/A};
163N/A
163N/Astruct rrsetinfo {
163N/A unsigned int rri_flags; /* RRSET_VALIDATED... */
163N/A unsigned int rri_rdclass; /* class number */
163N/A unsigned int rri_rdtype; /* RR type number */
163N/A unsigned int rri_ttl; /* time to live */
181N/A unsigned int rri_nrdatas; /* size of rdatas array */
163N/A unsigned int rri_nsigs; /* size of sigs array */
163N/A char *rri_name; /* canonical name */
163N/A struct rdatainfo *rri_rdatas; /* individual records */
163N/A struct rdatainfo *rri_sigs; /* individual signatures */
};</PRE
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29"
></A
><H2
>DESCRIPTION</H2
><P
><CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
gets a set of resource records associated with a
<CODE
CLASS="PARAMETER"
>hostname</CODE
>,
<CODE
CLASS="PARAMETER"
>class</CODE
>,
and
<CODE
CLASS="PARAMETER"
>type</CODE
>.
<CODE
CLASS="PARAMETER"
>hostname</CODE
>
is
a pointer a to null-terminated string. The
<CODE
CLASS="PARAMETER"
>flags</CODE
>
field is currently unused and must be zero.</P
><P
>After a successful call to
<CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>,
<CODE
CLASS="PARAMETER"
>*res</CODE
>
is a pointer to an
<SPAN
CLASS="TYPE"
>rrsetinfo</SPAN
>
structure, containing a list of one or more
<SPAN
CLASS="TYPE"
>rdatainfo</SPAN
>
structures containing resource records and potentially another list of
<SPAN
CLASS="TYPE"
>rdatainfo</SPAN
>
structures containing SIG resource records
associated with those records.
The members
<CODE
CLASS="CONSTANT"
>rri_rdclass</CODE
>
and
<CODE
CLASS="CONSTANT"
>rri_rdtype</CODE
>
are copied from the parameters.
<CODE
CLASS="CONSTANT"
>rri_ttl</CODE
>
and
<CODE
CLASS="CONSTANT"
>rri_name</CODE
>
are properties of the obtained rrset.
The resource records contained in
<CODE
CLASS="CONSTANT"
>rri_rdatas</CODE
>
and
<CODE
CLASS="CONSTANT"
>rri_sigs</CODE
>
are in uncompressed DNS wire format.
Properties of the rdataset are represented in the
<CODE
CLASS="CONSTANT"
>rri_flags</CODE
>
bitfield. If the RRSET_VALIDATED bit is set, the data has been DNSSEC
validated and the signatures verified. </P
><P
>All of the information returned by
<CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
is dynamically allocated: the
<CODE
CLASS="CONSTANT"
>rrsetinfo</CODE
>
and
<CODE
CLASS="CONSTANT"
>rdatainfo</CODE
>
structures,
and the canonical host name strings pointed to by the
<CODE
CLASS="CONSTANT"
>rrsetinfo</CODE
>structure.
Memory allocated for the dynamically allocated structures created by
a successful call to
<CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
is released by
<CODE
CLASS="FUNCTION"
>lwres_freerrset()</CODE
>.
<CODE
CLASS="PARAMETER"
>rrset</CODE
>
is a pointer to a
<SPAN
CLASS="TYPE"
>struct rrset</SPAN
>
created by a call to
<CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>.&#13;</P
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN62"
></A
><H2
>RETURN VALUES</H2
><P
><CODE
CLASS="FUNCTION"
>lwres_getrrsetbyname()</CODE
>
returns zero on success, and one of the following error
codes if an error occurred:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><CODE
CLASS="CONSTANT"
>ERRSET_NONAME</CODE
></DT
><DD
><P
>the name does not exist</P
></DD
><DT
><CODE
CLASS="CONSTANT"
>ERRSET_NODATA</CODE
></DT
><DD
><P
>the name exists, but does not have data of the desired type</P
></DD
><DT
><CODE
CLASS="CONSTANT"
>ERRSET_NOMEMORY</CODE
></DT
><DD
><P
>memory could not be allocated</P
></DD
><DT
><CODE
CLASS="CONSTANT"
>ERRSET_INVAL</CODE
></DT
><DD
><P
>a parameter is invalid</P
></DD
><DT
><CODE
CLASS="CONSTANT"
>ERRSET_FAIL</CODE
></DT
><DD
><P
>other failure</P
></DD
><DT
><CODE
CLASS="CONSTANT"
></CODE
></DT
><DD
><P
></P
></DD
></DL
></DIV
>&#13;</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN97"
></A
><H2
>SEE ALSO</H2
><P
><SPAN
CLASS="CITEREFENTRY"
><SPAN
CLASS="REFENTRYTITLE"
>lwres</SPAN
>(3)</SPAN
>.</P
></DIV
></BODY
></HTML
>