xref: /illumos-gate/usr/src/man/man3lib/libresolv.3lib (revision c65ebfc7045424bd04a6c7719a27b0ad3399ad54)
te
Copyright (C) 2004, Sun Microsystems, Inc. All Rights Reserved.
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
LIBRESOLV 3LIB "Mar 24, 2004"
NAME
libresolv - resolver library
SYNOPSIS

cc [ flag... ] file... -lresolv  -lsocket   -lnsl  [ library... ]
#include <sys/types.h>
#include <netinet/in.h>
#include <arpa/nameser.h>
#include <resolv.h>
#include <netdb.h>
DESCRIPTION

Functions in this library provide for creating, sending, and interpreting packets to the Internet domain name servers.

INTERFACES

The shared object libresolv.so.2 provides the public interfaces defined below. See Intro(3) for additional information on shared object interfaces.

__dn_skipname __fp_query
__hostalias __p_cdname
__p_class __p_query
__p_time __p_type
__putlong _getlong
_getshort _res
dn_comp dn_expand
fp_resstat h_errno
herror hstrerror
res_hostalias res_init
res_mkquery res_nclose
res_ninit res_nmkquery
res_nquery res_nquerydomain
res_nsearch res_nsend
res_nsendsigned res_query
res_querydomain res_search
res_send res_update

Programs are expected to use the aliases defined in <resolv.h> rather than calling the "__" prefixed procedures, as indicated in the following table. Use of the routines in the first column is discouraged.

FUNCTION REFERENCED ALIAS TO USE
__dn_skipname dn_skipname
__fp_query fp_query
__putlong putlong
__p_cdname p_cdname
__p_class p_class
__p_time p_time
__p_type p_type
FILES
/lib/libresolv.so.1

shared object for backward compatibility only

/lib/64/libresolv.so.1

64-bit shared object for backward compatibility only

/lib/libresolv.so.2

shared object

/lib/64/libresolv.so.2

64-bit shared object

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Standard: BIND 8.2.4
MT-Level See resolver(3RESOLV)
SEE ALSO

pvs(1), Intro(3), resolver(3RESOLV), attributes(5)