Command Line Switches
How to use MrGPF
──────────────────────────────────────────────────────────────────────────────
Running MrGPF results in something similar to the following:
MrGPF v1.xx MrDebug GPF Map File Scanner
(c) 1994 Dark Black Software Ltd
Syntax: MrGPF [MapFile] [Seg:Off] [/<sw>[-|+] [/<sw>[-|+]]...]
[MapFile] The name of the MAP file to scan
[Seg:Off] The address to locate in the MAP file
options:
s Only scan for GPF Screen Dump
f Only scan for MrDebug *.GPF file(s)
a+ Scan ONE or ALL MrDebug GPF Files
+ is ALL MrDebug GPF Files
- is ONE (most recent) MrDebug GPF File
k Keep command line 'a' option as default
c Show Assembly Dump
h This screen
By default, MrGPF will scan for any .GPF files that exist in the current
directory and for a GPF on the screen. MrGPF will scan the GPF's and the MAP
file, filling in information that is missing from the .GPF files. This all
happens without the need for any command line switches.
If you pass MrGPF the name of a map file and Segment:Offset, then MrGPF will
use those parameters to report back the module and function where the GPF
occurred (assuming that the MAP file contains this information!), ignoring
any other switches passed down. The following demonstrates manually telling
MrGPF where to find a GPF
MrGpf MyApp A:6FE2
Please note that there is no need to supply a .MAP for the file extension as
MrGPF assumes .MAP, unless you do not use .MAP as the standard extension for
a map file.
There is also no need to supply leading zeros to the Segment or Offset as
MrGPF will fill them in for you.
/s - tells MrGPF to scan only the screen for information about the GPF. This
will ignore any .GPF files in the current directory.
/f - tells MrGPF to ignore any GPF displayed on the screen and only report on
the .GPF contained in a file (or files) in the current directory. The number
of files that the GPF scan takes place on will depend upon the /a setting.
/a - tells MrGPF whether a scan should report on all of the .GPF files in
the current directory or just the most recent .GPF file is reported on. This
may be controlled by adding a + or a - to the a switch. For Example:
MrGPF /a+ will report on all .GPF files
whereas:
MrGPF /a- will report on only the most recent .GPF file
When used on it's own the /a switch will toggle the setting of the current
default /a setting saved with the /k switch. The current setting of the /a
switch may be seen by typing MrGPF /h or /?.
/k - will allow you to save a /a switch on the command line. For
Example:
MrGPF /a- /k will make the /a- switch the default
And finally for those sad people who understand how a widget works, the
/c option will produce an assembler listing of the offending instruction
± a widget as long as the DOS debug program is in your path.