summaryrefslogtreecommitdiff
path: root/ares_library_init.3
diff options
context:
space:
mode:
authorYu Jiung <jiung.yu@samsung.com>2016-11-10 16:59:08 +0900
committerYu Jiung <jiung.yu@samsung.com>2016-11-10 16:59:08 +0900
commit6e8e7a899a742f7f170ff6f07a26cf4832f4fdc9 (patch)
tree81f0750d91aa467df3ee81cf30d22a65db2e6685 /ares_library_init.3
parentd82f8426a5e255f0533f07ee458870ba124f90e7 (diff)
parent45e88a8337839e5fd88519bc55467053d521c9f6 (diff)
downloadc-ares-3ffaf3b0fd6f6c9c7542fb335c1e84f99ccb3376.tar.gz
c-ares-3ffaf3b0fd6f6c9c7542fb335c1e84f99ccb3376.tar.bz2
c-ares-3ffaf3b0fd6f6c9c7542fb335c1e84f99ccb3376.zip
Conflicts: packaging/c-ares.spec Change-Id: Id23d5351f77b4520d8bbcc4c0e1eb09136018b58
Diffstat (limited to 'ares_library_init.3')
-rw-r--r--ares_library_init.319
1 files changed, 14 insertions, 5 deletions
diff --git a/ares_library_init.3 b/ares_library_init.3
index 797476b..4734f92 100644
--- a/ares_library_init.3
+++ b/ares_library_init.3
@@ -19,11 +19,14 @@
ares_library_init \- c-ares library initialization
.SH SYNOPSIS
.nf
-.B #include <ares.h>
-.PP
-.B int ares_library_init(int \fIflags\fP)
-.PP
-.B cc file.c -lcares
+#include <ares.h>
+
+int ares_library_init(int \fIflags\fP)
+
+int ares_library_init_mem(int \fIflags\fP,
+ void *(*\fIamalloc\fP)(size_t),
+ void (*\fIafree\fP)(void *ptr),
+ void (*\fIarealloc\fP)(void *ptr, size_t size))
.fi
.SH DESCRIPTION
.PP
@@ -51,6 +54,12 @@ ORing the values together. In normal operation you should specify
\fIARES_LIB_INIT_ALL\fP. Don't use any other value unless you are
familiar with it and trying to control some internal c-ares feature.
.PP
+The
+.B ares_library_init_mem
+function allows the caller to provide memory management functions that the
+c-ares library will be use instead of \fImalloc(3)\fP, \fIfree(3)\fP and
+\fIrealloc(3)\fP.
+.PP
.B This function is not thread safe.
You have to call it once the program has started, but this call must be done
before the program starts any other thread. This is required to avoid