[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
+--------------------------------------------------------------------------+
| Option Description |
---------------------------------------------------------------------------|
| /a:size Specify activation stack size. |
| /if:file Include symbols in file. (Wildcards are permitted.) |
| /im:module Include symbols in module. (Wildcards are permitted.) |
| /is:symbol Include symbol. (Wildcards are permitted.) |
| /l Include all libraries. |
| /m:mapfile Override map file name. |
| /n Include segment name symbols. |
| /o Collect overlay statistics only. |
| /s Make symbol names case-sensitive. |
| /u Trim leading underscore from symbol names. |
| /w:wspfile Override .WSP file name |
| /xf:file Exclude symbols in file. (Wildcards are permitted.) |
| /xm:module Exclude symbols in module. (Wildcards are permitted.) |
| /xs:symbol Exclude symbol. (Wildcards are permitted.) |
| /y Allows out-of-date map file. |
+--------------------------------------------------------------------------+
WSPRUN [options] RUNFILE[.exe] [arguments...]
CNWSPRUN for Clarion Programmers
All options must precede the file name. The square brackets ([ ]) indicate
an item is optional. Do not use the bracket. Italics indicate an item is
replaced with a user-defined value or option. Options refer to the WSPRUN
options described below. Runfile is the name of the executable file to be
profiled. Arguments refer to any command line argument(s) runfile requires
in order to execute properly. They are passed directed to runfile as if it
was executed from the DOS prompt.
WSPRUN Options Details
/a:size Specify activation stack size.
Syntax
Size measures activation records as 18 bytes per record. The default is
100 bytes.
Description
This option sets the size of the activation stack. This is a stack that
the profiler uses to keep track of active functions.
/if:file Include symbols in file. (Wildcards are permitted.)
/im:module Include symbols in module. (Wildcards are permitted.)
/is:symbol Include symbol. (Wildcards are permitted.)
Syntax
You can use * and ? wildcards to indicate a string in the file or module
name. However, they differ from the familiar DOS wildcards in that
they mean any string of characters (including empty strings). You can
use multiple wildcards within one name.
Description
This option includes symbols in a named file or module or includes all
named symbols. By default, WarpSpeed only profiles functions defined
in object modules not included in libraries. You can use as many of
these switches as desired on the command line. They are processed
from left to right so that the later ones override earlier ones.
----------------------------------[ Example ]------------------------------------
To profile MYPROG.EXE including all symbols in EXTEND.LIB except for DBEDIT(),
use:
/IF:EXTEND.LIB /XSS:DEBEDIT MYPROGRAM
To include any library file, use:
/IF:*.LIB
To include any library file with x within its name, use:
/IF:*X*.LIB
/l Include all libraries.
Description
This option include all libraries during WSPRUN. The default is not to
profile any function in a library. (Achieve the same results by using the
option: /if:*.LIB.)
/m:mapfile Override map file name.
Syntax
Mapfile is the name of the .MAP file.
Description
This option overrides map file name so you can use a different name.
By default, WarpSpeed uses the file name that matches the executable
file but changes the extension to .MAP.
/n Include segment name symbols.
Description
This option includes segment name symbols. It is required for profiling
Clipper 5 programs if STATIC functions are to be profiled.
/o Collect overlay statistics only.
Description
This option gathers overlay statistics. Use /o to limit the scope of the
profiler to include overlay load and reload information only.
/s Make symbol names case-sensitive.
Description
This option makes symbol names case-sensitive. For example _HELP
and _help indicate two different symbols.
/u Trim leading underscore from symbol names.
Description
This option removes one leading underscore from the name of each
symbol that starts with an underscore. C programmers may find this
option especially useful.
/w:wspfile Override .WSP file name
Syntax
Wspfile is the name of the desired file.
Description
This option overrides the name of the .WSP file. By default, WSPRUN
creates a file with the same name as the map file but using a .WSP
extension.
/xf:file Exclude symbols in file. (Wildcards are permitted.)
/xm:module Exclude symbols in module. (Wildcards are permitted.)
/xs:symbol Exclude symbol. (Wildcards are permitted.)
Syntax
You can use * and ? wildcards to indicate a string in the file or module
name. However, they differ from the familiar DOS wildcards in that
they mean any string of characters (including empty strings). You can
use multiple wildcards within one name.
Description
This option excludes symbols in a named file or module, or all named
symbols. By default, WarpSpeed only profiles functions defined in
object modules not included in libraries. You can use as many of these
switches as desired on the command line. They are processed from left
to right so that the later ones override earlier ones.
----------------------------------[ Example ]------------------------------------
To profile MYPROG.EXE including all symbols in EXTEND.LIB except for DBEDIT(),
use:
/if:extend.lib /xss:debedit myprogram
To exclude any symbols starting with _ use:
/xs:_*
To exclude any symbol ending with @, use:
/xs:*@
Technical
Note
If you specify /u and one of these options, the exclude switch only
matches names starting with more than one underscore (_).
/y
Description
This option allows use of an out-of-date map file. WSPRUN generates a
warning message if the map file is older that the executable file. This
switch overrides the warning and the program automatically proceeds.
See Also: WarpSpeed Profiler
Online resources provided by: http://www.ClipX.Net --- NG 2 HTML conversion by Dave Pearson