moparisthebest/curl
1
0
Fork 0
mirror of https://github.com/moparisthebest/curl synced 2024-12-21 23:58:49 -05:00
Code Issues Releases Wiki Activity

NORECURSE clarification, minor formatting update

Browse Source
This commit is contained in:
Daniel Stenberg 2004-12-07 10:43:21 +00:00
parent c78ee11c41
commit 7fd1ce4dc3
2 changed files with 17 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ares/ares_destroy.3
View File

@ -14,14 +14,14 @@
.\" this software for any purpose. It is provided "as is" .\" this software for any purpose. It is provided "as is"
.\" without express or implied warranty. .\" without express or implied warranty.
.\" .\"
.TH ARES_DESTROY 3 "23 July 1998" .TH ARES_DESTROY 3 "7 December 2004"
.SH NAME .SH NAME
ares_destroy \- Destroy a resolver channel ares_destroy \- Destroy a resolver channel
.SH SYNOPSIS .SH SYNOPSIS
.nf .nf
.B #include <ares.h> .B #include <ares.h>
.PP .PP
.B int ares_destroy(ares_channel \fIchannel\fP) .B void ares_destroy(ares_channel \fIchannel\fP)
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
The The

39
ares/ares_init.3
View File

@ -14,7 +14,7 @@
.\" this software for any purpose. It is provided "as is" .\" this software for any purpose. It is provided "as is"
.\" without express or implied warranty. .\" without express or implied warranty.
.\" .\"
.TH ARES_INIT 3 "21 July 1998" .TH ARES_INIT 3 "7 December 2004"
.SH NAME .SH NAME
ares_init, ares_init_options \- Initialize a resolver channel ares_init, ares_init_options \- Initialize a resolver channel
.SH SYNOPSIS .SH SYNOPSIS
@ -25,31 +25,20 @@ ares_init, ares_init_options \- Initialize a resolver channel
.B int ares_init_options(ares_channel *\fIchannel\fP, .B int ares_init_options(ares_channel *\fIchannel\fP,
.B struct ares_options *\fIoptions\fP, int \fIoptmask\fP) .B struct ares_options *\fIoptions\fP, int \fIoptmask\fP)
.PP .PP
.B cc file.c -lares .B cc file.c -lcares
.fi .fi
.SH DESCRIPTION .SH DESCRIPTION
The The \fBares_init\fP function initializes a communications channel for name
.B ares_init service lookups. If it returns successfully, \fBares_init\fP will set the
function initializes a communications channel for name service variable pointed to by \fIchannel\fP to a handle used to identify the name
lookups. If it returns successfully, service channel. The caller should invoke
.B ares_init
will set the variable pointed to by
.I channel
to a handle used to identify the name service channel. The caller
should invoke
.BR ares_destroy (3) .BR ares_destroy (3)
on the handle when the channel is no longer needed. on the handle when the channel is no longer needed.
.PP .PP
The The \fBares_init_options\fP function also initializes a name service channel,
.B ares_init_options with additional options useful for applications requiring more control over
function also initializes a name service channel, with additional name service configuration. The \fIoptmask\fP parameter specifies which fields
options useful for applications requiring more control over name in the structure pointed to by \fIoptions\fP are set, as follows:
service configuration. The
.I optmask
parameter specifies which fields in the structure pointed to by
.I options
are set, as follows:
.PP
.TP 18 .TP 18
.B ARES_OPT_FLAGS .B ARES_OPT_FLAGS
.B int \fIflags\fP; .B int \fIflags\fP;
@ -127,9 +116,11 @@ If a truncated response to a UDP query is received, do not fall back
to TCP; simply continue on with the truncated response. to TCP; simply continue on with the truncated response.
.TP 23 .TP 23
.B ARES_FLAG_NORECURSE .B ARES_FLAG_NORECURSE
Do not set the "recursion desired" bit on outgoing queries, so that Do not set the "recursion desired" bit on outgoing queries, so that the name
the name server being contacted will not try to fetch the answer from server being contacted will not try to fetch the answer from other servers if
other servers if it doesn't know the answer locally. it doesn't know the answer locally. Be aware that ares will not do the
recursion for you. Recursion must be handled by the application calling ares
if \fIARES_FLAG_NORECURSE\fP is set.
.TP 23 .TP 23
.B ARES_FLAG_STAYOPEN .B ARES_FLAG_STAYOPEN
Do not close communciations sockets when the number of active queries Do not close communciations sockets when the number of active queries