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 | e61d4b9e21578a5b77118030a6711bbbb9abd7de (patch) | |
tree | ff192f64441998a74a164678cdb192133d746c50 /CHANGES | |
parent | efa7c4807b26bf919b72d9392a036601a88b717b (diff) | |
download | c-ares-e61d4b9e21578a5b77118030a6711bbbb9abd7de.tar.gz c-ares-e61d4b9e21578a5b77118030a6711bbbb9abd7de.tar.bz2 c-ares-e61d4b9e21578a5b77118030a6711bbbb9abd7de.zip |
Introduce ares_dup(3) and new thoughts about API/ABI and how to move forwards.
Also discussed on the ml.
Diffstat (limited to 'CHANGES')
-rw-r--r-- | CHANGES | 34 |
1 files changed, 34 insertions, 0 deletions
@@ -1,5 +1,39 @@ Changelog for the c-ares project +* Dec 3 2008 (Daniel Stenberg) + + API changes: + + I made sure the public ares_config struct looks like before and yet it + supports the ROTATE option thanks to c-ares now storing the "optmask" + internally. Thus we should be ABI compatible with the past release(s) + now. My efforts mentioned below should not break backwards ABI compliance. + + Here's how I suggest we proceed with the API: + + ares_init() will be primary "channel creator" function. + + ares_init_options() will continue to work exactly like now and before. For + starters, it will be the (only) way to set the existing options. + + ares_save_options() will continue to work like today, but will ONLY save + options that you can set today (including ARES_OPT_ROTATE actually) but new + options that we add may not be saved with this. + + Instead we introduce: + + ares_dup() that instead can make a new channel and clone the config used + from an existing channel. It will then clone all config options, including + future new things we add. + + ares_set_*() style functions that set (new) config options. As a start we + simply add these for new functionality, but over time we can also introduce + them for existing "struct ares_options" so that we can eventually deprecate + the two ares_*_options() functions. + + ares_get_*() style functions for extracting info from a channel handle that + should be used instead of ares_save_options(). + * Nov 26 2008 (Yang Tse) - Brad Spencer provided changes to allow buildconf to work on OS X. |