The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]

Интерактивная система просмотра системных руководств (man-ов)

 ТемаНаборКатегория 
 
 [Cписок руководств | Печать]

lwres_getrrsetbyname (3)
  • >> lwres_getrrsetbyname (3) ( FreeBSD man: Библиотечные вызовы )
  •  

    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.


     

    Index

    NAME
    SYNOPSIS
    DESCRIPTION
    RETURN VALUES
    SEE ALSO
    COPYRIGHT


    Поиск по тексту MAN-ов: 




    Партнёры:
    PostgresPro
    Inferno Solutions
    Hosting by Hoster.ru
    Хостинг:

    Закладки на сайте
    Проследить за страницей
    Created 1996-2024 by Maxim Chirkov
    Добавить, Поддержать, Вебмастеру