[lttng-dev] [PATCH lttng-tools] Fix: Some corrections to the lttng man page

[Thibault, Daniel]

De : jeremie.galarneau at gmail.com
Envoyé : 5 novembre 2013 15:51

On Thu, Oct 24, 2013 at 12:09 PM, Thibault, Daniel <Daniel.Thibault at drdc-rddc.gc.ca<mailto:Daniel.Thibault at drdc-rddc.gc.ca>> wrote:
-----Message d'origine-----
Date: Wed, 23 Oct 2013 12:08:47 -0400
From: J?r?mie Galarneau <jeremie.galarneau at efficios.com<mailto:jeremie.galarneau at efficios.com>>

> diff --git a/doc/man/lttng.1 b/doc/man/lttng.1
> [...]
> +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).
   Is this a statement of intent?  LTTng 2.3.0's list command identifies user-space events by trace provider name, event name, and process ID, but not by user ID (in fact it doesn't even yet filter the kernel events out when one asks for 'list -u session'; see bug #654).  And there is as yet no way to filter the 'lttng list' output by user ID (an optional argument for the -u option could do the trick).
   Of course, listing available tracepoints is automatically per-user when using a local session daemon.  But if you're a member of the 'tracing' group, you'll deal exclusively with the root daemon and won't have that choice.
> I didn't change the meaning of the original sentence. It just means that "lttng list" will output the events registered to the user's corresponding session daemon.
> Perhaps you can suggest a better phrasing?
>
> Jérémie

   How about this?

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).

(There is no need to explain further the diff between the two daemons since the preceding paragraph in the man page already talks about co-existing session daemons)

Daniel U. Thibault
Protection des systèmes et contremesures (PSC) | Systems Protection & Countermeasures (SPC)
Cyber sécurité pour les missions essentielles (CME) | Mission Critical Cyber Security (MCCS)
R & D pour la défense Canada - Valcartier (RDDC Valcartier) | Defence R&D Canada - Valcartier (DRDC Valcartier)
2459 route de la Bravoure
Québec QC  G3J 1X5
CANADA
Vox : (418) 844-4000 x4245
Fax : (418) 844-4538
NAC : 918V QSDJ<http://www.travelgis.com/map.asp?addr=918V%20QSDJ> <http://www.travelgis.com/map.asp?addr=918V%20QSDJ>
Gouvernement du Canada | Government of Canada
<http://www.valcartier.drdc-rddc.gc.ca/>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lttng.org/pipermail/lttng-dev/attachments/20131105/dde22a98/attachment.html>