Clarify limitations of the --syscall flag with enable-event command

[lttng-tools.git] / doc / man / lttng.1

diff --git a/doc/man/lttng.1 b/doc/man/lttng.1
index 6f9540625f07d4cb662583048585efce4fc277ff..988208395750c24066eb376512b554260b99122a 100644 (file)
--- a/doc/man/lttng.1
+++ b/doc/man/lttng.1
@@ -40,10 +40,10 @@ running as Alice that can be used to trace her applications along side with a
 root daemon or even a Bob daemon. We highly recommend starting the session
 daemon at boot time for stable and long term tracing.
 
-All user-space applications instrumented with lttng-ust(3) will
-automatically register to the session daemon. This feature gives you the
-ability to list available traceable applications and tracepoints on a per user
-basis. (See \fBlist\fP command).
+Each user-space application instrumented with lttng-ust(3) will automatically
+register with the root session daemon and its user session daemon. This allows
+each daemon to list the available traceable applications and tracepoints at any
+given moment (See the \fBlist\fP command).
 .SH "OPTIONS"
 
 .PP
@@ -541,7 +541,9 @@ Dynamic function entry/return probe. Addr and offset can be octal
 .BR "\-\-syscall"
 System call event. Enabling syscalls tracing (kernel tracer), you will
 not be able to disable them with disable-event. This is a known
-limitation. You can disable the entire channel to do the trick.
+limitation. You can disable the entire channel to do the trick. Also note
+that per-syscall selection is not supported yet. Use with "-a" to enable
+all syscalls.
 .TP
 .BR "\-\-filter 'expression'"
 Set a filter on a newly enabled event. Filter expression on event
@@ -598,7 +600,7 @@ names match any of the items in LIST.
 Disable tracing channel
 
 Disabling a channel disables the tracing of all of the channel's events. A channel
-can be reenabled by calling \fBlttng enable-channel NAME\fP again.
+can be re-enabled by calling \fBlttng enable-channel NAME\fP again.
 
 If \fB\-s, \-\-session\fP is omitted, the session name is taken from the .lttngrc
 file.
@@ -860,7 +862,8 @@ Show summary of possible options and commands.
 .TP
 .BR "\-\-list-options"
 Simple listing of options
-.TP "\-\-no-wait"
+.TP
+.BR "\-\-no-wait"
 Don't wait for data availability.
 .RE
 .PP