lwres_getrrsetbyname.docbook revision dafcb997e390efa4423883dafd100c975c4095d6
f743002678eb67b99bbc29fee116b65d9530fec0wrowe<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
a34684a59b60a4173c25035d0c627ef17e6dc215rpluem - Copyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - Copyright (C) 2001 Internet Software Consortium.
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - Permission to use, copy, modify, and distribute this software for any
1337c7673efc1f80f634139fbad7cbb98a0dc657ylavic - purpose with or without fee is hereby granted, provided that the above
4da61833a1cbbca94094f9653fd970582b97a72etrawick - copyright notice and this permission notice appear in all copies.
4da61833a1cbbca94094f9653fd970582b97a72etrawick - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
4da61833a1cbbca94094f9653fd970582b97a72etrawick - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
4da61833a1cbbca94094f9653fd970582b97a72etrawick - AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
4789804be088bcd86ae637a29cdb7fda25169521jailletc - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
4789804be088bcd86ae637a29cdb7fda25169521jailletc - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
4789804be088bcd86ae637a29cdb7fda25169521jailletc - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
4789804be088bcd86ae637a29cdb7fda25169521jailletc - PERFORMANCE OF THIS SOFTWARE.
e50c3026198fd496f183cda4c32a202925476778covener<!-- $Id: lwres_getrrsetbyname.docbook,v 1.4 2004/03/05 05:12:57 marka Exp $ -->
6c3b9cebb551140fbb25d58bae08b539b3802133ylavic<refentryinfo>
4f29b65ab4b547ad5dbe506e2d0ff5d12ead9247ylavic</refentryinfo>
69301145375a889e7e37caf7cc7321ac0f91801erpluem<refnamediv>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza</refnamediv>
506bfe33206b2fece40ef25f695af39dd4130facjkaluza<refsynopsisdiv>
d58a848a016d401b965111e50ef829e1641f7834minfrin<funcsynopsis>
d58a848a016d401b965111e50ef829e1641f7834minfrin<funcsynopsisinfo>#include <lwres/netdb.h></funcsynopsisinfo>
d58a848a016d401b965111e50ef829e1641f7834minfrin<funcprototype>
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic</funcprototype>
e8bd80a4bb88199d2f9a24a50345688e52d9c116ylavic<funcprototype>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic</funcprototype>
330e16bea8fe9cace4de90c349750c03dfb1fe64ylavic</funcsynopsis>
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerThe following structures are used:
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener<programlisting>
d7205b1a86c51c27b71a2c458dc453fd53a261c1covenerstruct rdatainfo {
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener unsigned int rdi_length; /* length of data */
d7205b1a86c51c27b71a2c458dc453fd53a261c1covener unsigned char *rdi_data; /* record data */
44ff304057225e944e220e981d434a046d14cf06covenerstruct rrsetinfo {
44ff304057225e944e220e981d434a046d14cf06covener unsigned int rri_flags; /* RRSET_VALIDATED... */
5d1ba75b8794925e67591c209085a49279791de9covener unsigned int rri_rdclass; /* class number */
5d1ba75b8794925e67591c209085a49279791de9covener unsigned int rri_rdtype; /* RR type number */
5d1ba75b8794925e67591c209085a49279791de9covener unsigned int rri_ttl; /* time to live */
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand unsigned int rri_nrdatas; /* size of rdatas array */
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand unsigned int rri_nsigs; /* size of sigs array */
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand char *rri_name; /* canonical name */
032982212dbcc7c3cce95bf89c503bb56e185ac7kbrand struct rdatainfo *rri_rdatas; /* individual records */
caad2986f81ab263f7af41467dd622dc9add17f3ylavic struct rdatainfo *rri_sigs; /* individual signatures */
caad2986f81ab263f7af41467dd622dc9add17f3ylavic</programlisting>
45a10d38e6051fd7bdf9d742aaae633d97ff02abjailletc</refsynopsisdiv>
1e2d421a36999d292042a5539971070d54aa6c63ylavicgets a set of resource records associated with a
5ef3c61605a3a021ff71f488983cb0065f8e1a79covenera pointer a to null-terminated string. The
09c87c777bed1655621bb20e1c46cb6b1a63279dcovenerfield is currently unused and must be zero.
3060ce7f798fbda7999cd4ddf89b525d2b294185covenerAfter a successful call to
e6b4bd1113567627ab6bb6c6a7105e1e01a7d889jailletcis a pointer to an
e466c40e1801982602ee0200c9e8b61cc148742djailletcstructure, containing a list of one or more
457468b82e59d01eba00dd9d0817309c8f5e414ejimstructures containing resource records and potentially another list of
457468b82e59d01eba00dd9d0817309c8f5e414ejimstructures containing SIG resource records
04983e3bd1754764eec7d6bb772fe3b0bf391771jortonassociated with those records.
49dacedb6c387b786b7911082ff35121a45f414bcovenerare copied from the parameters.
cfd9415521847b2f9394fad04fb701cfb955f503rjungare properties of the obtained rrset.
28c31fb73c1264bd1d0ff932573677030b024c7dwroweThe resource records contained in
28c31fb73c1264bd1d0ff932573677030b024c7dwroweare in uncompressed DNS wire format.
8491e0600f69b0405e156ea8a419653c065c645bcovenerProperties of the rdataset are represented in the
63b9f1f5880391261705f696d7d65507bbe9ace3covenerbitfield. If the RRSET_VALIDATED bit is set, the data has been DNSSEC
63b9f1f5880391261705f696d7d65507bbe9ace3covenervalidated and the signatures verified.
49dacedb6c387b786b7911082ff35121a45f414bcovenerAll of the information returned by
3c990331fc6702119e4f5b8ba9eae3021aea5265jimis dynamically allocated: the
fc42512879dd0504532f52fe5d0d0383dda96a1eniqstructures,
fc42512879dd0504532f52fe5d0d0383dda96a1eniqand the canonical host name strings pointed to by the
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niqMemory allocated for the dynamically allocated structures created by
0451df5dc50fa5d8b3e07d92ee6a92e36a1181a5niqa successful call to
983528026996668ea295be95aedb9c7a346af470ylavicis released by
06b8f183140c8e02e0974e938a05078b511d1603coveneris a pointer to a
15890c9306ba98f6fc243e15a3c4778ddc7d773erpluemcreated by a call to
65967d05f839dbf27cf91d91fa79585eeae19660minfrinreturns zero on success, and one of the following error
65967d05f839dbf27cf91d91fa79585eeae19660minfrincodes if an error occurred:
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<variablelist>
8152945ae46857b170cb227e79bb799f4fc7710dminfrin<varlistentry><term><constant>ERRSET_NONAME</constant></term>
75f5c2db254c0167a0e396254460de09b775d203trawickthe name does not exist
4f0358189bfa57b8e75bd6b94db264302a8f336amrumph<varlistentry><term><constant>ERRSET_NODATA</constant></term>
4f0358189bfa57b8e75bd6b94db264302a8f336amrumphthe name exists, but does not have data of the desired type
5716f9c6daa92dde5f2f9d11ed63f7c9549c223atrawick<varlistentry><term><constant>ERRSET_NOMEMORY</constant></term>
54d750a84a175d8e338880514d440773eb986b50covenermemory could not be allocated
54d750a84a175d8e338880514d440773eb986b50covener<varlistentry><term><constant>ERRSET_INVAL</constant></term>
54d750a84a175d8e338880514d440773eb986b50covenera parameter is invalid
7a3aa12f0eda24793ee26d6a179bd53132e9dae8covener<varlistentry><term><constant>ERRSET_FAIL</constant></term>
54d750a84a175d8e338880514d440773eb986b50covenerother failure
2e15620d724fb8e3a5be183b917359a2fd6e9468covener</variablelist>
1b988c41ee505962781d110a3e4c2c90f1ea0aa4covener<citerefentry>
b8efdc95bec9cf089aa1be0bfd07d46aa1137a7acovener<refentrytitle>lwres</refentrytitle><manvolnum>3</manvolnum>
b8efdc95bec9cf089aa1be0bfd07d46aa1137a7acovener</citerefentry>.