'\" te
.\" Copyright (c) 2009, 2011, Oracle and/or its affiliates. All rights reserved.
.TH libresolv 3LIB "23 Aug 2011" "SunOS 5.11" "Interface Libraries"
.SH NAME
libresolv \- resolver library
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-lresolv\fR \fB -lsocket \fR \fB -lnsl \fR [ \fIlibrary\fR... ]
#include <\fBsys/types.h\fR>
#include <\fBnetinet/in.h\fR>
#include <\fBarpa/nameser.h\fR>
#include <\fBresolv.h\fR>
#include <\fBnetdb.h\fR>
.fi

.SH DESCRIPTION
.sp
.LP
Functions in this library provide for creating, sending, and interpreting packets to the Internet domain name servers.
.SH INTERFACES
.sp
.LP
The shared object \fBlibresolv.so.2\fR provides the public interfaces defined below. See \fBIntro\fR(3) for additional information on shared object interfaces.
.sp

.sp
.TS
tab();
lw(2.75i) lw(2.75i) 
lw(2.75i) lw(2.75i) 
.
\fB__dn_skipname\fR\fB__fp_query\fR
\fB__hostalias\fR\fB__p_cdname\fR
\fB__p_class\fR\fB__p_query\fR
\fB__p_time\fR\fB__p_type\fR
\fB__putlong\fR\fB_getlong\fR
\fB_getshort\fR\fB_res\fR
\fBdn_comp\fR\fBdn_expand\fR
\fBfp_resstat\fR\fBh_errno\fR
\fBherror\fR\fBhstrerror\fR
\fBinet_cidr_ntop\fR\fBinet_cidr_pton\fR
\fBns_find_tsig\fR\fBns_sign\fR
\fBns_sign_tcp\fR\fBns_sign_tcp_init\fR
\fBns_verify\fR\fBns_verify_tcp\fR
\fBns_verify_tcp_init\fR\fBres_hostalias\fR
\fBres_init\fR\fBres_mkquery\fR
\fBres_nclose\fR\fBres_ninit\fR
\fBres_nmkquery\fR\fBres_nquery\fR
\fBres_nquerydomain\fR\fBres_nsearch\fR
\fBres_nsend\fR\fBres_nsendsigned\fR
\fBres_query\fR\fBres_querydomain\fR
\fBres_search\fR\fBres_send\fR
\fBres_update\fR
.TE

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

.sp
.TS
tab();
cw(2.75i) cw(2.75i) 
lw(2.75i) lw(2.75i) 
.
\fBFUNCTION REFERENCED\fR \fBALIAS TO USE\fR
\fB__dn_skipname\fR\fBdn_skipname\fR
\fB__fp_query\fR\fBfp_query\fR
\fB__putlong\fR\fBputlong\fR
\fB__p_cdname\fR\fBp_cdname\fR
\fB__p_class\fR\fBp_class\fR
\fB__p_time\fR\fBp_time\fR
\fB__p_type\fR\fBp_type\fR
.TE

.SH FILES
.sp
.ne 2
.mk
.na
\fB\fB/lib/libresolv.so.1\fR\fR
.ad
.RS 26n
.rt  
shared object for backward compatibility only
.RE

.sp
.ne 2
.mk
.na
\fB\fB/lib/64/libresolv.so.1\fR\fR
.ad
.RS 26n
.rt  
64-bit shared object for backward compatibility only
.RE

.sp
.ne 2
.mk
.na
\fB\fB/lib/libresolv.so.2\fR\fR
.ad
.RS 26n
.rt  
shared object
.RE

.sp
.ne 2
.mk
.na
\fB\fB/lib/64/libresolv.so.2\fR\fR
.ad
.RS 26n
.rt  
64-bit shared object
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/library
_
Interface StabilityCommitted  
_
MT-LevelT{
Unsafe for deprecated interfaces; MT-Safe for all others
T}
_
StandardBIND 8.2.4
.TE

.SH SEE ALSO
.sp
.LP
\fBpvs\fR(1), \fBIntro\fR(3), \fBresolver\fR(3RESOLV), \fBattributes\fR(5)