tsocket: Improve the tsocket_address_bsd_sockaddr documentation.

Signed-off-by: Stefan Metzmacher <metze@samba.org>
(cherry picked from commit 1983256c70cf07b8c8afddd024ee5fd2522ee83c)

Signed-off-by: Stefan Metzmacher <metze@samba.org>
(cherry picked from commit 672b1c8f9d090b294f89bc322320d65375670660)

diff --git a/lib/tsocket/tsocket.h b/lib/tsocket/tsocket.h
index 1cd40e476e6f3ec6d974fa483b94966e665b45c8..d983325c4540935a1fd59c3f355584a6887013d4 100644 (file)
--- a/lib/tsocket/tsocket.h
+++ b/lib/tsocket/tsocket.h
@@ -869,7 +869,9 @@ ssize_t tsocket_address_bsd_sockaddr(const struct tsocket_address *addr,
  * @brief Wrap an existing file descriptors into the tstream abstraction.
  *
  * You can use this function to wrap an existing file descriptors into the
- * tstream abstraction.
+ * tstream abstraction. After that you're not able to use this file descriptor
+ * for anything else. The file descriptor will be closed when the stream gets
+ * freed. If you still want to use the fd you have have to create a duplicate.
  *
  * @param[in]  mem_ctx      The talloc memory context to use.
  *