From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 23285 invoked by alias); 31 Mar 2008 18:44:19 -0000 Received: (qmail 23217 invoked by uid 367); 31 Mar 2008 18:44:14 -0000 Date: Mon, 31 Mar 2008 18:44:00 -0000 Message-ID: <20080331184414.23202.qmail@sourceware.org> From: cagney@sourceware.org To: frysk-cvs@sourceware.org Subject: [SCM] master: Implement man-page includes using fstack as an example. X-Git-Refname: refs/heads/master X-Git-Reftype: branch X-Git-Oldrev: 8983411653f8a41593abda4232dab5525c617e47 X-Git-Newrev: 888eca8cb8d14ed37d0901755701c817d79381fe Mailing-List: contact frysk-cvs-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: frysk-cvs-owner@sourceware.org Reply-To: frysk@sourceware.org X-SW-Source: 2008-q1/txt/msg00435.txt.bz2 The branch, master has been updated via 888eca8cb8d14ed37d0901755701c817d79381fe (commit) from 8983411653f8a41593abda4232dab5525c617e47 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email. - Log ----------------------------------------------------------------- commit 888eca8cb8d14ed37d0901755701c817d79381fe Author: Andrew Cagney Date: Mon Mar 31 14:42:51 2008 -0400 Implement man-page includes using fstack as an example. frysk-core/frysk/bindir/ChangeLog 2008-03-31 Andrew Cagney * fstack.xml: Use stack-options.xml, standard-options.xml, and version.in. frysk-core/frysk/util/ChangeLog 2008-03-31 Andrew Cagney * standard-options.xml: New. * stack-options.xml: New. ----------------------------------------------------------------------- Summary of changes: frysk-core/frysk/bindir/ChangeLog | 5 + frysk-core/frysk/bindir/fstack.xml | 49 ++++------- frysk-core/frysk/util/ChangeLog | 5 + .../frysk/util/stack-options.xml | 92 ++++++++------------ .../frysk/util/standard-options.xml | 83 ++++++------------ 5 files changed, 92 insertions(+), 142 deletions(-) copy frysk-common/frysk.xml => frysk-core/frysk/util/stack-options.xml (56%) copy frysk-common/frysk.xml => frysk-core/frysk/util/standard-options.xml (62%) First 500 lines of diff: diff --git a/frysk-core/frysk/bindir/ChangeLog b/frysk-core/frysk/bindir/ChangeLog index a5d7c1d..aec0252 100644 --- a/frysk-core/frysk/bindir/ChangeLog +++ b/frysk-core/frysk/bindir/ChangeLog @@ -1,3 +1,8 @@ +2008-03-31 Andrew Cagney + + * fstack.xml: Use stack-options.xml, standard-options.xml, and + version.in. + 2008-03-27 Stan Cox * fexe.java (executeLive): Also show sysrooted exe path. diff --git a/frysk-core/frysk/bindir/fstack.xml b/frysk-core/frysk/bindir/fstack.xml index aaba593..6dca143 100644 --- a/frysk-core/frysk/bindir/fstack.xml +++ b/frysk-core/frysk/bindir/fstack.xml @@ -44,20 +44,27 @@ --> + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" - + [ + + + + ] +> - fstack - March 14 2008 + Frysk Utilities + March 31 2008 fstack 1 + Frysk + &version; @@ -68,43 +75,21 @@ fstack - - - - - - pids - DESCRIPTION - fstack Runs the frysk stack tracing utility. - - fstack is a small utility that uses the frysk engine to display a process stack in a similar manner to pstack. - - - - - - Enable logging to the console and at the specified - log level. The log level can be: [ OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST]. - - - - - - Specify the file logging level. The log level can be: [ OFF | SEVERE | WARNING | INFO | CONFIG | FINE | FINER | FINEST]. - - - + fstack prints a stack back-trace of the + specified process, or core-file's threads. + + &stackoptions; + &standardoptions; + - - - - - - +Stack print options: - - fhpd - March 14 2008 - - - - frysk - 7 - + - - frysk - The Frysk Debugging, Tracing, and Monitoring Tool Suite - - - - DESCRIPTION + + + + Limit the back-trace to count + frames. The default is to limit the back-trace to 10 frames. + Specify 0 or "all" to print all frames. + - The Frysk Tool Suite provides a collection of command line - and gnome utilities for the debugging, tracing, and monitoring of - user programs. + + + + Perform a light-weight stack backtrace containing only + minimal information. Equivalent to -print + -. + - + + + + Perform a detailed stack back-trace that includes, where + possible, inlined function calls, parameter names and values, and + debug-names. Equivalent to -print + inline,params,debug-names. + - - SEE ALSO - -funit(8) -fauxv(1) -fcatch(1) -fcore(1) -fdebuginfo(1) -ferror(1) -fexe(1) -fhpd(1) -fmaps(1) -fparser(1) -fstack(1) -fstep(1) -ftrace(1) -fdebugrpm(1) - - - - - BUGS - Report bugs to - - - + + + + Specify the level of detail to include in a stack + back-trace. print-option can be any + of: debug-names - use debug information, such as DWARF, to + determine the name of functions; full-path - do not truncate file + paths; inline - include in-line function in back-trace; params - + include the values of any parameters. To negate + a print-option prefix it with + "-". + - + diff --git a/frysk-common/frysk.xml b/frysk-core/frysk/util/standard-options.xml similarity index 62% copy from frysk-common/frysk.xml copy to frysk-core/frysk/util/standard-options.xml index 404b014..3e5f85f 100644 --- a/frysk-common/frysk.xml +++ b/frysk-core/frysk/util/standard-options.xml @@ -1,5 +1,3 @@ - - - - - - - +Standard Frysk options: - - fhpd - March 14 2008 - - - - frysk - 7 - + - - frysk - The Frysk Debugging, Tracing, and Monitoring Tool Suite - - - - DESCRIPTION + + + The full path of the executable to + read. + - The Frysk Tool Suite provides a collection of command line - and gnome utilities for the debugging, tracing, and monitoring of - user programs. + + + Do not attempt to read the corresponding + executable when loading a core file. + - + + + The system root directory under which all + executables, libraries, and source are located. + - - SEE ALSO - -funit(8) -fauxv(1) -fcatch(1) -fcore(1) -fdebuginfo(1) -ferror(1) -fexe(1) -fhpd(1) -fmaps(1) -fparser(1) -fstack(1) -fstep(1) -ftrace(1) -fdebugrpm(1) - - - - - BUGS - Report bugs to - - - + + + Set internal debug-tracing of the specified + Java class + to level (level can be NONE, INFO, + WARNING, FINE, and FINEST). If + the level is absent, FINE is assumed; + if the class is absent, the global + level is set. + - + hooks/post-receive -- frysk system monitor/debugger