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

[Jérémie Galarneau]

On Tue, Nov 5, 2013 at 4:34 PM, Thibault, Daniel <
Daniel.Thibault at drdc-rddc.gc.ca> wrote:

>  *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> wrote:
>
> -----Message d'origine-----
> Date: Wed, 23 Oct 2013 12:08:47 -0400
> From: J?r?mie Galarneau <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).
>
>
>

Looks good to me.

Cheers,
Jérémie


>  (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
> <http://www.travelgis.com/map.asp?addr=918V%20QSDJ>*>
> Gouvernement du Canada | Government of Canada
> <http://www.valcartier.drdc-rddc.gc.ca/>
>



-- 
Jérémie Galarneau
EfficiOS Inc.
http://www.efficios.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lttng.org/pipermail/lttng-dev/attachments/20131105/40ebef8a/attachment-0001.html>