From 4259d2df7dd95637a4b1e3fb174fe5e5aef81069 Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Wed, 24 Mar 2010 10:34:30 +0100 Subject: remove the ares subtree c-ares is now hosted entirely separate from the curl project see http://c-ares.haxx.se/ for all details concerning c-ares, its source repository and more. --- ares/ares_set_servers.3 | 85 ------------------------------------------------- 1 file changed, 85 deletions(-) delete mode 100644 ares/ares_set_servers.3 (limited to 'ares/ares_set_servers.3') diff --git a/ares/ares_set_servers.3 b/ares/ares_set_servers.3 deleted file mode 100644 index 949b81fbe..000000000 --- a/ares/ares_set_servers.3 +++ /dev/null @@ -1,85 +0,0 @@ -.\" $Id$ -.\" -.\" Copyright 1998 by the Massachusetts Institute of Technology. -.\" Copyright (C) 2008-2010 by Daniel Stenberg -.\" -.\" Permission to use, copy, modify, and distribute this -.\" software and its documentation for any purpose and without -.\" fee is hereby granted, provided that the above copyright -.\" notice appear in all copies and that both that copyright -.\" notice and this permission notice appear in supporting -.\" documentation, and that the name of M.I.T. not be used in -.\" advertising or publicity pertaining to distribution of the -.\" software without specific, written prior permission. -.\" M.I.T. makes no representations about the suitability of -.\" this software for any purpose. It is provided "as is" -.\" without express or implied warranty. -.\" -.TH ARES_SET_SERVERS 3 "5 March 2010" -.SH NAME -ares_set_servers \- Initialize an ares_channel name servers configuration -.SH SYNOPSIS -.nf -.B #include -.PP -.B int ares_set_servers(ares_channel \fIchannel\fP, struct ares_addr_node *\fIservers\fP) -.fi -.SH DESCRIPTION -The \fBares_set_servers(3)\fP function initializes name servers configuration -for the channel data identified by -.IR channel , -from a -.IR servers -pointer to a linked list of ares_addr_node structs holding name servers -address data. - -The name server linked list pointer argument may be the result of a previous -call to \fBares_get_servers(3)\fP or a linked list of ares_addr_node structs -setup by other means. - -This function replaces any potentially previously configured name servers -with the ones given in the linked list. So, in order to configure a channel -with more than one name server all the desired ones must be specified in a -single list. - -\fBares_set_servers(3)\fP does not take ownership of the linked list argument. -The caller is responsible to free the linked list when no longer needed. - -This function is capable of handling IPv4 and IPv6 name server -addresses simultaneously, rendering \fBares_init_options(3)\fP with -optmask \fBARES_OPT_SERVERS\fP functionally obsolete except for -IPv4-only name server usage. - -.SH RETURN VALUES -.B ares_set_servers(3) -may return any of the following values: -.TP 15 -.B ARES_SUCCESS -The name servers configuration was successfuly initialized. -.TP 15 -.B ARES_ENOMEM -The process's available memory was exhausted. -.TP 15 -.B ARES_ENODATA -The channel data identified by -.IR channel -was invalid. -.TP 15 -.B ARES_ENOTINITIALIZED -c-ares library initialization not yet performed. -.SH SEE ALSO -.BR ares_get_servers (3), -.BR ares_init_options (3), -.BR ares_dup(3) -.SH AVAILABILITY -ares_set_servers(3) was added in c-ares 1.7.1 -.SH AUTHOR -Implementation of this function and associated library internals are based -on code, comments and feedback provided November and December of 2008 by -Daniel Stenberg, Gregor Jasny, Phil Blundell and Yang Tse, December 2009 -by Cedric Bail, February 2010 by Jakub Hrozek. On March 2010 Yang Tse -shuffled all the bits and this function popped out. -.br -Copyright 1998 by the Massachusetts Institute of Technology. -.br -Copyright (C) 2008-2010 by Daniel Stenberg -- cgit v1.2.3