summaryrefslogtreecommitdiff
path: root/ares_library_init.3
diff options
context:
space:
mode:
authorYang Tse <yangsita@gmail.com>2009-05-20 11:25:21 +0000
committerYang Tse <yangsita@gmail.com>2009-05-20 11:25:21 +0000
commitcf2882882d67fd8eddb8fa2c49fc78111f5a3f5d (patch)
tree169a3891b7954f80776b0c4baec1d7d4700a082e /ares_library_init.3
parent1ddd0215043496bcebb73b2107f8bc33e87edc8a (diff)
downloadc-ares-cf2882882d67fd8eddb8fa2c49fc78111f5a3f5d.tar.gz
c-ares-cf2882882d67fd8eddb8fa2c49fc78111f5a3f5d.tar.bz2
c-ares-cf2882882d67fd8eddb8fa2c49fc78111f5a3f5d.zip
Update man page
Diffstat (limited to 'ares_library_init.3')
-rw-r--r--ares_library_init.311
1 files changed, 7 insertions, 4 deletions
diff --git a/ares_library_init.3 b/ares_library_init.3
index 2a69b14..d060951 100644
--- a/ares_library_init.3
+++ b/ares_library_init.3
@@ -58,13 +58,16 @@ library initialization, and also due to the fact that ares_library_init()
might call functions from other libraries that are thread unsafe, and
could conflict with any other thread that is already using these other
libraries.
+.PP
+Win32/64 application DLLs shall not call ares_library_init() from the
+DllMain function. Doing so will produce deadlocks and other problems.
.SH FLAGS
.TP 5
.B ARES_LIB_INIT_ALL
Initialize everything possible. This sets all known bits.
.TP
.B ARES_LIB_INIT_WIN32
-Initialize Win32 specific libraries.
+Initialize Win32/64 specific libraries.
.TP
.B ARES_LIB_INIT_NONE
Initialize nothing extra. This sets no bit.
@@ -79,11 +82,11 @@ the definition of preprocessor symbol \fICARES_HAVE_ARES_LIBRARY_INIT\fP
as an indication of the availability of this function.
.PP
Since the introduction of this function it is absolutely mandatory to
-call it for any Win32 program using c-ares.
+call it for any Win32/64 program using c-ares.
.PP
-Non-Win32 systems can still use c-ares version 1.6.1 without calling
+Non-Win32/64 systems can still use c-ares version 1.6.1 without calling
ares_library_init() due to the fact that it is nearly a do-nothing
-function on non-Win32 platforms.
+function on non-Win32/64 platforms.
.SH SEE ALSO
.BR ares_library_cleanup(3),
.BR ares_strerror(3)