Re: common print-stack options

[Mark Wielaard <mark@klomp.org>]

Hi Andrew,

On Thu, 2008-03-20 at 14:33 -0400, Andrew Cagney wrote:
> http://sourceware.org/bugzilla/show_bug.cgi?id=5978
> 
> FYI, all the utilities (fstack, ftrace, ferror, fcatch) now share a 
> common set of options for specifying what a stack backtrace should look 
> like, for instance:
>
> I've marked down a brainstorming session on what the print-stack options 
> should be for next wednesday's meeting.

I think the suggested options in the bug report are nice:

Stack print options:
  -n, -number-of-frames NUMBER    number of frames to print. Use -n 0 or -n 
                                    all to print all frames.
  -f, -full-path                  print the full path to object files
  -a, -all                        Print all information that can be retrieved 
                                    about the stack
                                    this is equivalent to -print 
                                    functions,params,scopes,fullpath
  -v, -virtual                    Includes virtual frames in the stack trace.
                                    Virtual frames are artificial frames 
                                    corresponding to calls to inlined functions
  -c, -common                     print commonly used debug information:this 
                                    is equivalent to -print 
                                    functions,params,fullpath
      -print [item],...           itmes to print. Possible items:
                                    functions : print function names using 
                                    debug information
                                    scopes : print variables declared in each 
                                    scope within the function.
                                    params : print function parameters
                                    fullpath : print full executbale path

Having some options separate and available also in --print [item] is
slightly confusing though, I would propose to make them all "top-level"
options, or all --print [item] options.

Since this is a common option but just for stack trace printing, you
might want to change --print [item] to --stack [item]. Where a --stack
without items replaces the --common option. And maybe replace -a with
--stack all.

Cheers,

Mark