lwres_getrrsetbyname man page on FreeBSD

Man page or keyword search:  
man Server   9747 pages
apropos Keyword Search (all sections)
Output format
FreeBSD logo
[printable version]

LWRES_GETRRSETBYNAME(3)		     BIND9	       LWRES_GETRRSETBYNAME(3)

NAME
       lwres_getrrsetbyname, lwres_freerrset - retrieve DNS records

SYNOPSIS
       #include <lwres/netdb.h>

       int lwres_getrrsetbyname(const char *hostname, unsigned int rdclass,
				unsigned int rdtype, unsigned int flags,
				struct rrsetinfo **res);

       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.

BIND9				 Oct 18, 2000	       LWRES_GETRRSETBYNAME(3)
[top]

List of man pages available for FreeBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
...................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net