From: Alexander Klauer <Alexander.Klauer@itwm.fraunhofer.de>
Date: Mon, 8 Apr 2013 09:48:45 +0000 (+0200)
Subject: ares_destroy() documentation: no new requests
X-Git-Tag: upstream/1.10.0~16
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=1317a1c94b567ac8214efc3cc4d89e561c9ae938;p=platform%2Fupstream%2Fc-ares.git

ares_destroy() documentation: no new requests

Clarify that no new requests may be added to a resolver channel that is
currently being destroyed.
---

diff --git a/ares_destroy.3 b/ares_destroy.3
index 79171ec..3724df1 100644
--- a/ares_destroy.3
+++ b/ares_destroy.3
@@ -33,7 +33,8 @@ invokes the callbacks for each pending query on the channel, passing a
 status of
 .BR ARES_EDESTRUCTION .
 These calls give the callbacks a chance to clean up any state which
-might have been stored in their arguments.
+might have been stored in their arguments. A callback must not add new
+requests to a channel being destroyed.
 .SH SEE ALSO
 .BR ares_init (3),
 .BR ares_cancel (3)