Provided by: xxgdb_1.12-17build2_amd64 bug

NAME

       xxgdb - X window system interface to the gdb debugger.

SYNOPSIS

       xxgdb [ -toolkitoption ... ] [-xxgdboption ... ] [-gdboption ... ] [objfile [ corefile ]]

DESCRIPTION

       Xxgdb  is  a  graphical  user interface to the gdb debugger under the X Window System.  It
       provides visual feedback and mouse input for the user to control program execution through
       breakpoints,  to  examine  and  traverse  the  function  call  stack, to display values of
       variables and data structures, and to browse source files and functions.

       Xxgdb allows initial gdb commands stored in the file .gdbinit to be  executed  immediately
       after  the  symbolic  information  is  read.   If  .gdbinit  does not exist in the current
       directory, the user's home directory is searched ( /.gdbinit). Option -nx can be  used  to
       prevent  xxgdb  from executing this file. Option -i can be used to change the file name of
       command file.

       Objfile is an object file  produced  by  a  compiler  with  the  appropriate  option  (-g)
       specified to produce symbol table information for gdb.

       If a file named core exists in the current directory or a corefile is specified, xxgdb can
       be used to examine the state of the program when the core dump occurred.

       The name of the debugger invoked by xxgdb is, by default, gdb, but it  can  be  overridden
       with the environment variable XXGDB_DEBUGGER or with the db_name option.

OPTIONS

       Xxgdb  accepts  all of the standard X Toolkit command line options (see X(1)), and all the
       gdb options (see gdb(1)), plus the following xxgdb specific options:

       -db_name debuggername
              Specify the name of the debugger to override  the  default  "gdb".   WARNING  :  by
              default  prompt  is  the name of the debugger enclosed in parenthesis followed by a
              space. So if the prompt is still "(gdb) ", you HAVE TO use -db_prompt "gdb"

       -db_prompt promptstring
              Specify to xxgdb what is the debugger prompt. The default is to expect  the  prompt
              to  be  the  name  of the debugger enclosed in parenthesis followed by a space (eg,
              "(gdb) ").

       -i filename
              Specify the filename of initial gdb command file. The default is ".gdbinit".

       -nx    Do not execute .gdbinit file (or file specified with -i)

       -bigicon
              Uses a 64x64 icon instead of the default 48x48 icon.

SUBWINDOWS

       Xxgdb consists of the following subwindows:

       File Window         Display the full pathname of the file displayed in the source  window,
                           and the line number of the caret.

       Source Window       Display the contents of a source file.

       Message Window      Display the execution status and error messages of xxgdb .

       Command Window      Provide  a list of the common gdb commands which are invoked by simply
                           clicking the LEFT mouse button.

       Dialogue Window     Provide a typing interface to gdb.

       Display Window      Provide a window for displaying variables each time execution stops.

       Popup Windows       Provide windows for  displaying  variables  (see  "Displaying  C  Data
                           Structures" below).

       The  relative  sizes  of the source window, command window, and the dialogue window can be
       adjusted by dragging the grip (a small square near the right edge of a horizontal  border)
       with the LEFT mouse button down.

SELECTION

       Text selection in the source window is modified to make it easier to select C expressions.
       LEFT mouse button down selects a C expression by highlighting it in  reverse-video.   LEFT
       mouse button down also positions the caret and updates the line label accordingly.

       C  expression  selection  is  based on the resource delimiters which determines the set of
       characters that delimits a C expression.  (The default  word  selection  behavior  in  the
       Athena  text  widget selects a word delimited by white spaces.)  Text selection adjustment
       is possible by holding the LEFT mouse button down and dragging.

       A LEFT mouse button click with the SHIFT button down prints the value  of  the  expression
       selected.

SCROLLBAR

       Pressing  the LEFT mouse button scrolls the text forward, whereas pressing the RIGHT mouse
       button scrolls the text backward.  The amount of scrolling depends on the distance of  the
       pointer button away from the top of the scrollbar.  If the button is pressed at the top of
       the scrollbar, only one line of text is scrolled.  If the button is pressed at the  bottom
       of the scrollbar, one screenful of text is scrolled.

       Pressing  the  MIDDLE  mouse button changes the thumb position of the scrollbar.  Dragging
       the MIDDLE mouse button down moves the thumb along and changes the text displayed.

IOWIN and NOIOWIN COMMAND

       If compiled, with the right option, xxgdb can use a separate io window to talk to gdb,  so
       program  output  is not confused with gdb output.  Type command 'iowin' in Dialogue Window
       to create io window. If you get 'Undefined command' error  message,  then  xxgdb  was  not
       compiled for that feature. The program xxgdbiowin is used for this io window.

       If  xxgdb  was  compiled with iowin support, typing 'noiowin' will close the io window and
       reset the controlling terminal of the debugger.

COMMAND BUTTONS

   Execution Commands
       run         Begin program execution.

       cont        Continue execution from where it stopped.

       next        Execute one source line, without stepping into any function call.

       step        Execute one source line, stepping into a function if the source line  contains
                   a function call.

       finish      Continue execution until the selected procedure returns; the current procedure
                   is used if none is selected.

   Breakpoint Commands
       break     Stop program execution at the line or  in  the  function  selected.   To  set  a
                 breakpoint in the program, place the caret at the start of the source line or on
                 the function name and click the break button.  A stop sign will appear  next  to
                 the source line.

       tbreak    Set  a  breakpoint  enabled  only  for  one stop.  This is the same as the break
                 button except the breakpoint is automatically disabled the first time it hit.

       delete    Remove the breakpoint on the source  line  selected  or  the  breakpoint  number
                 selected.

       show brkpts
                 Show the current breakpoints (both active and inactive).

   Stack Commands
       stack     Show a stack trace of the functions called.

       up        Move up one level on the call stack.

       down      Move down one level on the call stack.

   Data Display Commands
       print     Print  the  value  of  a  selected  expression.  (also  see  "Displaying  C Data
                 Structures" below)

       print *   Print the value of the object the selected expression is pointing to.  (also see
                 "Displaying C Data Structures" below)

       display   Display  the  value of a selected expression in the display window, updating its
                 value every time execution stops.

       undisplay Stop displaying the value of the selected expression in the display window.   If
                 the  selected  expression  is  a  constant,  it  refers  to  the  display number
                 associated with an expression in the display window.

       args      Print the arguments of the selected frame.

       show display
                 Show the names of currently displayed expressions.

       locals    Print the local variables of the selected frame.

       stack     Print a backtrace of the entire stack.

   Miscellaneous Commands
       search Pop up a search panel which allows both forward (>>) and  reverse  (<<)  search  of
              text strings in the source file.  Hitting carriage return after entering the search
              string will begin a forward search and pop down the search panel.

       file   Pop up a directory browser that allows  the  user  to  move  up  and  down  in  the
              directory tree, to select a text file to be displayed, to select an executable file
              to debug, or to select a core file to debug.  Directory entries are marked  with  a
              trailing  slash  (`/')  and  executables with a trailing asterisk (`*').  Filenames
              beginning with a dot (`.')  or ending with a tilde (`~')  are  not  listed  in  the
              menu.

       search Pop  up  a  search  panel which allows both forward (>>) and reverse (<<) search of
              text strings in the source file.  Hitting carriage return after entering the search
              string will begin a forward search and pop down the search panel.

       yes    Send 'y' (yes) to gdb. To be used when gdb requires a yes/no response.

       no     Send 'n' (no) to gdb. To be used when gdb requires a yes/no response.

       quit   Exit xxgdb.

       I/O Win
              Create io window.

       No I/O Win
              Delete io window.

   Displaying C Data Structures
       Xxgdb  provides  some  primitive  support  for graphically displaying C structures and the
       ability of following pointers.  Pressing the RIGHT mouse button on the print (or print  *)
       command  button  displays  the value of the selected expression (or the value the selected
       expression is pointing to) in a  popup.   If  the  value  is  a  pointer  or  a  structure
       containing pointers, the user can examine the value of the object that pointer is pointing
       to by clicking the pointer value.  This will create another popup that displays the object
       the  pointer  points  to.  Clicking the label of the popup pops down itself and all of its
       descendants.

X DEFAULTS

       To change the default values of widget resources used in xxgdb, you need to reference  the
       widgets  by  name or by class.  The widget hierarchies for the main window, the file menu,
       the search dialog box, and the popup data display used in xxgdb are shown as follows, with
       the name of the widget followed by the name of its class in parentheses:

       Main window:
           toplevel (ToplevelShell)
             vpane (Paned)
            fileWindow (Form)
              fileLabel (Label)
              lineLabel (Label)
            sourceForm (Form)
              sourceWindow (AsciiText)
            messageWindow (Label)
            commandWindow (Box)
              run (Command)
              cont (Command)
              next (Command)
              step (Command)
              finish (Command)
              break (Command)
              tbreak (Command)
              delete (Command)
              up (Command)
              down (Command)
              print (Command)
              print * (Command)
              display (Command)
              undisplay (Command)
              args (Command)
              locals (Command)
              stack (Command)
              search (Command)
              file (Command)
              show display (Command)
              show brkpts (Command)
              yes (Command)
              no (Command)
              quit (Command)
            dialogWindow (AsciiText)
            displayWindow (AsciiText)

       File menu:
           File Directory (TransientShell)
             popup (Paned)
            fileMenuLabel (Label)
            fileMenu (List)
            cancelButton (Command)

       Search dialog box:
           Search (TransientShell)
             searchPopup (Dialog)
            << (Command)
            >> (Command)
            DONE (Command)

       Data display popup:
           Data Popup (TransientShell)
             popup (Form)
            label (Label)
            dataDpyWindow (AsciiText)

       In  addition  to  the  standard X resources, xxgdb uses the following application-specific
       resources for user customization.  The value in parentheses is the default value.

       bell   If True, the bell is on. (True)

       displayWindow
              If True, the display window appears on start up. (False)

       delimiters
              The set of delimiters for word selection. (" !%^&*()+=~|;:{},/#<?\"\n\t")

       stop_color
              Color of the stop sign. (Red)

       arrow_color
              Color of the arrow sign. (Blue)

       updown_color
              Color of the updown sign. (Blue)

       bomb_color
              Color of the bomb sign. (Red)

       dataDpyMaxHeight
              Maximum height of the data display window. (300)

       dataDpyMaxWidth
              Maximum width of the data display window. (600)

       prompt The prompt string used in xxgdb. ("(xxgdb) ")

       db_name
              The name of the debugger program. ("gdb")

       db_prompt
              The prompt string of the debugger program. ("(gdb) ")

       gdbinit
              The filename of initial command file. (".gdbinit")

       nx     If True, xxgdb will not execute .gdbinit at start-up. (False)

       tabstop
              When displaying source code, the width (in spaces) of a tab. (8)

FILES

       a.out          default object file
       core           default core file
       ~/XDbx         resources file (or /usr/lib/X11/app-defaults/XDbx)
       .gdbinit       local initial commands file
       ~/.gdbinit     user's initial commands file

SEE ALSO

       X(1), gdb(1)

COPYRIGHT

       Copyright 1989 The University of Texas at Austin.
       Copyright 1990 Microelectronics and Computer Technology Corporation.
       Copyright 1990-1994 Thomson Consumer Electronics, Inc.

AUTHOR

       Po Cheung.
       Pierre Willard.