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.