[ltt-dev] [RFC] lttng-tools command line interface

[Mathieu Desnoyers]

* Alexandre Montplaisir (alexandre.montplaisir at polymtl.ca) wrote:
> Very nice!
>
>
> Some dumb questions:
>
> On 11-06-07 07:08 PM, Mathieu Desnoyers wrote:
>> ... the elements below between [ ] are
>> actually optional, not "implied by default" as stated above.
>>
>
>> * Tracing session control
>>
>> lttng create [--session name] # create a tracing session
>>       [--output path]          # optionally specify the output path
>>       [--name name]            # optional session name (default provided)
>>
>> --->  This command prints
>>       "Working directory of created session is /path/to/name. Change your"
>>       "current working directory to interact with this session."
>
> Is this what is printed if only "lttng create" with no parameters is  
> typed in?

This is what is printed with or without parameters.

> If yes, what is the default session name?

Maybe David has ideas on this ? I'm thinking along:
trace-$(date)

> If not, I guess it prints the same as "lttng create --help" ?
>
>>
>> --->  All the following commands use the current working directory
>>       .lttng/config file to keep track of the session on which actions
>>       should be applied.
>
> Yup, Git-alike  ;)
>
>>
>> lttng destroy [--session name] # teardown a tracing session
>> lttng start [--session name]   # start tracing for a session
>> lttng stop [--session name]    # stop tracing for a session
>
> Is "--session" needed here, or would just "lttng destroy mysession" be  
> allowed/wanted too?

good point, will add.


> À la "git push origin master", which does not require any --options for  
> mandatory parameters, only extras.
>
>>
>> lttng add-context name --kernel [--event name] [--channel name] --type context_type [context options]
>> lttng add-context name --userspace [--event name] [--channel name] [--all/--pid n/cmd_name] --type context_type [context options]
>
> I guess you have plans for short options too? like,
> -k, --kernel
> -u, --userspace
> -e, --event
> etc.

Yes, we wanted to get the long options right first, and let David figure
out the shortcuts ;)

>
>> Comments are immensely welcome!
>>
>> Thanks,
>>
>> Mathieu
>>
>
> Looks great! Can't wait to try it!

Me too !

Thanks for the feedback,

Mathieu

>
> -- 
> Alexandre Montplaisir
> DORSAL lab,
> École Polytechnique de Montréal
>

-- 
Mathieu Desnoyers
Operating System Efficiency R&D Consultant
EfficiOS Inc.
http://www.efficios.com