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 (file)
--- 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)