NAME
lwres_getrrsetbyname, lwres_freerrset - retrieve DNS records
SYNOPSIS
I int lwres_getrrsetbyname(const char * hostname , unsigned int rdclass , unsigned int rdtype , unsigned int flags , struct rrsetinfo ** res );
I 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
lwres(3).
COPYRIGHT
Copyright 2004, 2005, 2007 Internet Systems Consortium, Inc. ("ISC")
Copyright 2000, 2001 Internet Software Consortium.