Debug Tutorial: How to Load an Executable

---

debug [ -n ] [ -s startup ] [ yod_args ] [ prog_name ] [ prog_args ]

Command syntax:

debug [ -n ] [ yod_args ] [ prog_name ] [ prog_args ] [ < input_file ]
[ > output_file ]

The command line debugger runs native on the Teraflops system. It is invoked by simply entering debug.

• The program name can be included on the invocation command line resulting in its being loaded prior to the first debug prompt.

• Alternatively, the debug command can be used to (re)load the program after invocation.

• A TOS application load requires the use of the -n switch.

• A Cougar application load is the same as a yod command line, simply replace yod with the debug command.

• Startup files specified at invocation are read immediately followed by .debuginit (located in cwd or $HOME). These are useful for defining personal command aliases and speeding up the setup process for repetitive debug sessions.

• Source location search paths are specified with the use command.

• debug without arguments gives information about a load program and general debug environment.

Examples:

In this example, a parallel Cougar application is loaded after the debugger was invoked, using the debug command.

Debug > debug -sz 16 hello 1 2 3 abc > outputlog
 *** reading symbol table for /home/karla/hello...

 *** initializing Debug for parallel application...
 *** load complete
(all) > debug
Debugger Status:
  Mode      : parallel
  Program   : /home/karla/hello
  Arguments : 1 2 3 abc 
  Input     : 
  Output    : outputlog
  Yod       : /cougar/bin/yod
  YodArgs   : -sz 16
  LogFile   :
  More      : ON
  MsgStyle  : NX

This example loads a TOS application on the invocation line of the debugger.

{jethro:70} debug -n hello.osf

 *** Debug (Parallel Debugger), Release 1.6 beta
 *** Copyright (c) 1990,1991,1992,1993,1994,1995,1996 Intel Corporation

 *** reading symbol table for /home/karla/hello.osf...

 *** load complete
(host) > debug
Debugger Status:
  Mode      : non-parallel
  Program   : /home/karla/hello.osf
  Arguments : 
  Input     : 
  Output    : 
  Yod       : /cougar/bin/yod
  YodArgs   : 
  LogFile   :
  More      : ON
  MsgStyle  : NX