From: Philippe Proulx <eeppeliteloop@gmail.com>
Date: Tue, 29 Nov 2016 03:16:34 +0000 (-0500)
Subject: lttng-ust(3): document liblttng-ust-fd
X-Git-Tag: v2.10.0-rc1~26
X-Git-Url: https://git.lttng.org./?a=commitdiff_plain;h=321d3c8d294668d0699d20e14e3c7f26398b8815;p=lttng-ust.git

lttng-ust(3): document liblttng-ust-fd

Signed-off-by: Philippe Proulx <eeppeliteloop@gmail.com>
Signed-off-by: Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
---

diff --git a/doc/man/lttng-ust.3.txt b/doc/man/lttng-ust.3.txt
index 8ecda775..ed525f6e 100644
--- a/doc/man/lttng-ust.3.txt
+++ b/doc/man/lttng-ust.3.txt
@@ -738,6 +738,12 @@ without a following man:exec(3) family system call. The library
 application with the `LD_PRELOAD` environment variable (see
 man:ld.so(8)).
 
+To use `liblttng-ust` with a daemon application which closes file
+descriptors that were not opened by it, preload the `liblttng-ust-fd.so`
+library before you start the application. Typical use cases include
+daemons closing all file descriptors after man:fork(2), and buggy
+applications doing ``double-closes''.
+
 
 Context information
 ~~~~~~~~~~~~~~~~~~~