DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
Using the graphical interface of debug

Invoking the debugger

From the UNIX desktop, the debugger may be invoked in one of four ways:

  1. By dragging an object file from a folder and dropping it onto the debugger's icon in the Desktop_Tools folder of the Application Manager. This will start the debugger with the dropped object file as a created process. This has the advantage of making the debugger's current directory the same as the folder in which the object file appears. The disadvantages are that you cannot give the debugger or created object any options, or redirect the debugged object's I/O, and you cannot drag and drop a core file onto the debugger's icon. However, you can drag an entry from the /proc folder and drop it on the debugger's icon to grab a running object.

  2. By double clicking on the debugger's icon in the Desktop_Tools folder of the Application Manager. This will start up the debugger with an empty Source window. From there, you may create or grab processes with the options in the ``Debug menu''. This will let you pass options to the debugged processes, but not to the debugger itself. This method also has the disadvantage that the debugger's current working directory may have no connection with the directory of the file you want to debug. You can set the current working directory with the ``Change Directory'' option which is in the ``File menu'' of the Source, Process, and Command windows in the debugger's default configuration.

  3. By clicking the right mouse button on the icon in the File Manager that represents the executable you want to debug. A popup menu will display a Debug option. You can select this option to start the debugger with the icon's object file as the created process. This has the advantage of making the debugger's current directory the same as the folder in which the object file appears. The disadvantages are that you cannot give the debugger or created object any options, or redirect the debugged object's I/O.

  4. By typing debug options in an xterm window. Even though you type a command to start the debugger, this will still invoke the graphical interface. You may, however, use the command line interface by typing debug -ic (ic for interface, command). Although this is more work than clicking on an icon, this method is the most flexible, allowing you to create processes with options, grab running processes, or grab core files from the command line. See debug(1) for the options available.

    The -X option lets you pass options specific to the graphical user interface. For example,

    $ debug -X-iconic
    
    will bring up the initial debugger windows as their respective minimized icons. You can also use the -X option to specify such things as fonts and colors. For example,
    $ debug -X"-background green"
    
    will make green the background color for all the debugger's windows, and
    $ debug -X '-xrm "debug*Source*background: green"'
    
    will set the background color in the Source window only. Note that the -X option takes only one argument, so any option that you want to pass through with whitespace in it must be quoted.

    In this method, the debugger's current working directory will be the same as the xterm window's.


Several of the properties that can be set from the options in the ``Properties menu'' can also be set as customizable resources (see ``Resource settings'') or may be set from the command line. The command line options are:

Using all three methods of invocation, you may create or grab additional processes using the ``Create'', ``Grab process'', and ``Grab core'' popup windows. Note that threads can only be created under programmatic control, and also cannot be individually grabbed.


Next topic: Learning to use the graphical debugger
Previous topic: Using the graphical interface of debug

© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 27 April 2004