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

Mathieu Desnoyers mathieu.desnoyers at efficios.com
Mon Feb 3 11:05:39 EST 2014


Perhaps someone should open a bug report to track this, or submit a patch ? 

Thanks, 

Mathieu 

----- Original Message -----

> From: "Jérémie Galarneau" <jeremie.galarneau at efficios.com>
> To: "Daniel Thibault" <Daniel.Thibault at drdc-rddc.gc.ca>
> Cc: lttng-dev at lists.lttng.org
> Sent: Tuesday, November 5, 2013 8:25:12 PM
> Subject: Re: [lttng-dev] [PATCH lttng-tools] Fix: Some corrections to the
> lttng man page

> 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 >
> 
> > Gouvernement du Canada | Government of Canada
> 
> > < http://www.valcartier.drdc-rddc.gc.ca/ >
> 

> --
> Jérémie Galarneau
> EfficiOS Inc.
> http://www.efficios.com

> _______________________________________________
> lttng-dev mailing list
> lttng-dev at lists.lttng.org
> http://lists.lttng.org/cgi-bin/mailman/listinfo/lttng-dev

-- 
Mathieu Desnoyers 
EfficiOS Inc. 
http://www.efficios.com 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.lttng.org/pipermail/lttng-dev/attachments/20140203/9b6532a6/attachment-0001.html>


More information about the lttng-dev mailing list