Previous Topic Next topic Print topic


Invoking CodeWatch

Once the program has been compiled in debug mode and linked, you can use CodeWatch to debug your program. To invoke CodeWatch, use one of the following command formats:

Graphical Interface (Windows only)

cwgui [-e]
      [-srcpath [source_directory [:source_directory] ...]]
      [-stbpath [STB_directory [:STB_directory] ...]]
      [-path [directory [:directory] ...]]
      [-usrin filename]
      [-usrout filename]
      [-8bit]
      [program-name]
      [program-arguments]

Command Line Interface

cwcmd [-classic]
      [-x]
      [-e]
      [-srcpath [source_directory [:source_directory] ...]]
      [-stbpath [STB_directory [:STB_directory] ...]]
      [-path [directory [:directory] ...]]
      [-usrin filename]
      [-usrout filename]
      [-8bit]
      [program-name]
      [program-arguments]

where:

-e (echo) Specifies that every debugger command entered will be echoed back to the terminal.
-srcpath, -stbpath, and -path Specify directory paths to be searched for source and STB files. See In Search of Source and STB Files for more information.
usrin and -usrout Specify files to redirect user program input from or output to, respectively. See "Redirecting User Program I/O" for more information.
8bit Allows CodeWatch to treat an extended set of ASCII characters as printable. See "Extended ASCII Character Support" for more information.
program-name Is the name of the executable file to be debugged. If the debugger is invoked without a program-name argument, the a.out file in the current directory will be used if it exists; otherwise, CodeWatch comes up "standalone."
program-arguments Are command-line arguments to be passed to the program.

CodeWatch does not require a program-to-debug at startup time. If no program-to-debug is supplied to CodeWatch, CodeWatch comes up standalone. However, on UNIX systems, it will first look for a.out as the default program name. When CodeWatch comes up standalone, a LOAD or ATTACH command must be used to specify the program to be debugged.

Previous Topic Next topic Print topic