diff options
author | Seonah Moon <seonah1.moon@samsung.com> | 2020-12-23 13:54:58 +0900 |
---|---|---|
committer | Seonah Moon <seonah1.moon@samsung.com> | 2020-12-23 13:54:58 +0900 |
commit | d155550ca2bd773d4bf3761301c93d07b345f9d2 (patch) | |
tree | 37a66189331b8387139ca266e8a87ada3d30529c /ares_save_options.3 | |
parent | 62cb64b22c599fa9c2c7d864569c017b55100279 (diff) | |
download | c-ares-d155550ca2bd773d4bf3761301c93d07b345f9d2.tar.gz c-ares-d155550ca2bd773d4bf3761301c93d07b345f9d2.tar.bz2 c-ares-d155550ca2bd773d4bf3761301c93d07b345f9d2.zip |
Revert "Revert "Imported Upstream version 1.17.1""
This reverts commit 62cb64b22c599fa9c2c7d864569c017b55100279.
Diffstat (limited to 'ares_save_options.3')
-rw-r--r-- | ares_save_options.3 | 74 |
1 files changed, 0 insertions, 74 deletions
diff --git a/ares_save_options.3 b/ares_save_options.3 deleted file mode 100644 index bddae04..0000000 --- a/ares_save_options.3 +++ /dev/null @@ -1,74 +0,0 @@ -.\" -.\" Copyright 1998 by the Massachusetts Institute of Technology. -.\" -.\" 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_SAVE_OPTIONS 3 "5 March 2010" -.SH NAME -ares_save_options \- Save configuration values obtained from initialized ares_channel -.SH SYNOPSIS -.nf -.B #include <ares.h> -.PP -.B int ares_save_options(ares_channel \fIchannel\fP, struct ares_options *\fIoptions\fP, int *\fIoptmask\fP) -.fi -.SH DESCRIPTION -The \fBares_save_options(3)\fP function saves the channel data identified by -.IR channel , -into the options struct identified by -.IR options , -and saves the mask of options which are set to the integer -pointer (passed by reference) identified by -.IR optmask . - -The resultant options and optmask are then able to be -passed directly to ares_init_options. When the options -are no longer needed, ares_destroy_options should be called -to free any associated memory. -.SH RETURN VALUES -.B ares_save_options(3) -can return any of the following values: -.TP 15 -.B ARES_SUCCESS -The channel data was successfully stored -.TP 15 -.B ARES_ENOMEM -The memory was exhausted -.TP 15 -.B ARES_ENODATA -The channel data identified by -.IR channel -were invalid. -.SH NOTE -Since c-ares 1.6.0 the ares_options struct has been "locked" meaning that it -won't be extended to cover new functions. This function will remain -functioning, but it can only return config data that can be represented in -this config struct, which may no longer be the complete set of config -options. \fBares_dup(3)\fP will not have that restriction. - -The ares_options struct can not handle potential IPv6 name servers the -ares_channel might be configured to use. The \fBares_save_options(3)\fP function -will only return IPv4 servers, if any. In order to retrieve all name servers -an ares_channel might be using, the \fBares_get_servers(3)\fP function must be -used instead. -.SH SEE ALSO -.BR ares_destroy_options (3), -.BR ares_init_options (3), -.BR ares_get_servers (3), -.BR ares_dup (3) -.SH AVAILABILITY -ares_save_options(3) was added in c-ares 1.4.0 -.SH AUTHOR -Brad House -.br -Copyright 1998 by the Massachusetts Institute of Technology. |