Swat Introduction: 1 DOS Command Line Options

To use Swat, you must have the pccom tool running on the target machine. You may then invoke Swat on the development machine. Swat takes the following command-line flags:

-e: Start up the non-error-checking version of the loader on the target machine.
-C: Disable symbol file path caching.
-h: Displays a usage line.
-k: Use a non-standard kernel file.
-n: Start up the non-error-checking version of GEOS on the target machine.
-r: Start up the error-checking version of GEOS on the target machine.
-s: Start up the error-checking loader on the target machine.
-D: You will only need to use this flag if debugging Swat.

If you have set up your communications incorrectly, Swat will have problems. (Often these problems don't show up when sending or receiving files; Swat demands more from the communications programs than pcsend and pcget.)

One common problem arises when other devices are generating interrupts which are not being successfully masked out. If, for instance, you have a network card which is operating on IRQ 2, you must make sure that either the pccom tool or else Swat is called with the /i:a option. Swat will intercept IRQ level 5 by default. To determine what number to pass with the /i, take the IRQ level, add 8, and express the result in hexadecimal.

If Swat complains that it is "timing out" on some operation, you may have your communication speed set too high. Try changing the baud rate field in PTTY to a lower value.

Normally, Swat insists that any geodes it examines should have their symbolic information in the appropriate subdirectory of your root GEOSSDK development directory--the possible subdirectories are Appl, Library, Driver, and Loader. To ask Swat to look in different places for these sorts of files, change the SWAT.CFG file in your PCGEOS\BIN directory. You may also specify a fifth directory in which to look for geodes. You may specify absolute pathnames in this file; if you give relative paths, they will be assumed to start at the directory specified with your ROOT_DIR variable.

If you add a "default" line to your SWAT.CFG file, that tells Swat where to look for .SYM files as a last resort. To save hard disk space, some developers delete rarely-accessed .SYM files from their hard drive, leave their SDK CD in the CD-ROM drive, and specify the GEOSSDK directory as the default place to look for .SYM files:

default D:\GEOSSDK

GEOS SDK TechDocs |

Swat Introduction | Next:

2 Notation