lwres_getrrsetbyname.html revision e3f6b4d2195b2fcd28f769452d460d1b35f1952a
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek<!--
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - Copyright (C) 2000, 2001 Internet Software Consortium.
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek -
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - Permission to use, copy, modify, and distribute this software for any
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - purpose with or without fee is hereby granted, provided that the above
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - copyright notice and this permission notice appear in all copies.
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek -
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek - PERFORMANCE OF THIS SOFTWARE.
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek-->
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek<HTML
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><HEAD
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><TITLE
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek>lwres_getrrsetbyname</TITLE
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><META
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekNAME="GENERATOR"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekCONTENT="Modular DocBook HTML Stylesheet Version 1.73
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek"></HEAD
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><BODY
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekCLASS="REFENTRY"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekBGCOLOR="#FFFFFF"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekTEXT="#000000"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub HrozekLINK="#0000FF"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub HrozekVLINK="#840084"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub HrozekALINK="#0000FF"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek><H1
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek><A
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub HrozekNAME="AEN1"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek>lwres_getrrsetbyname</A
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek></H1
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek><DIV
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub HrozekCLASS="REFNAMEDIV"
19fd860d78256a4ab5a268cd58337a8bd2920cebJakub Hrozek><A
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekNAME="AEN8"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek></A
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><H2
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek>Name</H2
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek>lwres_getrrsetbyname, lwres_freerrset&nbsp;--&nbsp;retrieve DNS records</DIV
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><DIV
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekCLASS="REFSYNOPSISDIV"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek><A
8ca73915a3bf60331468fed6b3b38652c979f95dJakub HrozekNAME="AEN12"
8ca73915a3bf60331468fed6b3b38652c979f95dJakub Hrozek></A
><H2
>Synopsis</H2
><DIV
CLASS="FUNCSYNOPSIS"
><A
NAME="AEN13"
></A
><P
></P
><PRE
CLASS="FUNCSYNOPSISINFO"
>#include &lt;lwres/netdb.h&gt;</PRE
><P
><CODE
><CODE
CLASS="FUNCDEF"
>int
lwres_getrrsetbyname</CODE
>(const char *hostname, unsigned int rdclass, unsigned int rdtype, unsigned int flags, struct rrsetinfo **res);</CODE
></P
><P
><CODE
><CODE
CLASS="FUNCDEF"
>void
lwres_freerrset</CODE
>(struct rrsetinfo *rrset);</CODE
></P
><P
></P
></DIV
><P
>The following structures are used:
<PRE
CLASS="PROGRAMLISTING"
>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 */
};</PRE
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN29"
></A
><H2
>DESCRIPTION</H2
><P
><TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>
gets a set of resource records associated with a
<TT
CLASS="PARAMETER"
><I
>hostname</I
></TT
>,
<TT
CLASS="PARAMETER"
><I
>class</I
></TT
>,
and
<TT
CLASS="PARAMETER"
><I
>type</I
></TT
>.
<TT
CLASS="PARAMETER"
><I
>hostname</I
></TT
>
is
a pointer a to null-terminated string. The
<TT
CLASS="PARAMETER"
><I
>flags</I
></TT
>
field is currently unused and must be zero.</P
><P
>After a successful call to
<TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>,
<TT
CLASS="PARAMETER"
><I
>*res</I
></TT
>
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
<TT
CLASS="CONSTANT"
>rri_rdclass</TT
>
and
<TT
CLASS="CONSTANT"
>rri_rdtype</TT
>
are copied from the parameters.
<TT
CLASS="CONSTANT"
>rri_ttl</TT
>
and
<TT
CLASS="CONSTANT"
>rri_name</TT
>
are properties of the obtained rrset.
The resource records contained in
<TT
CLASS="CONSTANT"
>rri_rdatas</TT
>
and
<TT
CLASS="CONSTANT"
>rri_sigs</TT
>
are in uncompressed DNS wire format.
Properties of the rdataset are represented in the
<TT
CLASS="CONSTANT"
>rri_flags</TT
>
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
<TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>
is dynamically allocated: the
<TT
CLASS="CONSTANT"
>rrsetinfo</TT
>
and
<TT
CLASS="CONSTANT"
>rdatainfo</TT
>
structures,
and the canonical host name strings pointed to by the
<TT
CLASS="CONSTANT"
>rrsetinfo</TT
>structure.
Memory allocated for the dynamically allocated structures created by
a successful call to
<TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>
is released by
<TT
CLASS="FUNCTION"
>lwres_freerrset()</TT
>.
<TT
CLASS="PARAMETER"
><I
>rrset</I
></TT
>
is a pointer to a
<SPAN
CLASS="TYPE"
>struct rrset</SPAN
>
created by a call to
<TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>.&#13;</P
><P
></P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN62"
></A
><H2
>RETURN VALUES</H2
><P
><TT
CLASS="FUNCTION"
>lwres_getrrsetbyname()</TT
>
returns zero on success, and one of the following error
codes if an error occurred:
<P
></P
><DIV
CLASS="VARIABLELIST"
><DL
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NONAME</TT
></DT
><DD
><P
>the name does not exist</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NODATA</TT
></DT
><DD
><P
>the name exists, but does not have data of the desired type</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_NOMEMORY</TT
></DT
><DD
><P
>memory could not be allocated</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_INVAL</TT
></DT
><DD
><P
>a parameter is invalid</P
></DD
><DT
><TT
CLASS="CONSTANT"
>ERRSET_FAIL</TT
></DT
><DD
><P
>other failure</P
></DD
><DT
><TT
CLASS="CONSTANT"
></TT
></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
>