diff options
author | Daniel Stenberg <daniel@haxx.se> | 2008-12-03 09:59:50 +0000 |
---|---|---|
committer | Daniel Stenberg <daniel@haxx.se> | 2008-12-03 09:59:50 +0000 |
commit | dd3594c6b3271e47d9b3bfcb1b6045b4da8820cd (patch) | |
tree | 111418ac692ae2ebd0ce016175e072b7cde0cb29 /ares/ares_save_options.3 | |
parent | f7ea43151623042dc8e51d6c4076bdddf515f5a1 (diff) |
Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards.
Also discussed on the ml.
Diffstat (limited to 'ares/ares_save_options.3')
-rw-r--r-- | ares/ares_save_options.3 | 17 |
1 files changed, 11 insertions, 6 deletions
diff --git a/ares/ares_save_options.3 b/ares/ares_save_options.3 index 46fd5967a..79f9db9a1 100644 --- a/ares/ares_save_options.3 +++ b/ares/ares_save_options.3 @@ -24,9 +24,7 @@ ares_save_options \- Save configuration values obtained from initialized ares_ch .B void ares_save_options(ares_channel \fIchannel\fP, struct ares_options *\fIoptions\fP, int *\fIoptmask\fP) .fi .SH DESCRIPTION -The -.B ares_save_options -function saves the channel data identified by +The \fBares_save_options(3)\fP function saves the channel data identified by .IR channel , into the options struct identified by .IR options , @@ -38,11 +36,18 @@ 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 NOTE +Since c-ares 1.6.0 the ares_options struct has been "locked" meaning that it +won't be extended to cover new funtions. 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. .SH SEE ALSO .BR ares_destroy_options (3), -.BR ares_init_options (3) +.BR ares_init_options (3), +.BR ares_dup (3) +.SH AVAILABILITY +ares_save_options(3) was added in c-ares 1.4.0 .SH AUTHOR Brad House .br |