Subject: [PATCH 3/4] ares_destroy() documentation: no new requests

[PATCH 3/4] ares_destroy() documentation: no new requests

From: Alexander Klauer <Alexander.Klauer_at_itwm.fraunhofer.de>
Date: Thu, 21 Mar 2013 10:20:14 +0100

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

---
 ares_destroy.3 |    3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
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)
-- 
1.7.9.5
Received on 2013-03-21