utilts.gml

开放源码的编译器open watcom 1.6.0版的源代码

.* (c) Portions Copyright 1990, 1995 by Tenberry Software, Inc.
.*
.chap *refid=rsiutls Utilities
.*
.np
.ix '&dos4gprd' 'utilities'
This chapter describes the Tenberry Software &dos4g utility programs
provided with the &cmpname package.
Each program is described using the following format:
.begnote $setptnt 6
.note Purpose:
This is a brief statement of what the utility program does.
More specific information is provided under "Notes".
.note Syntax:
This shows the syntax of the program.
The fixed portion of each command is in a
.mono typewriter font,
while variable parts of the command are in
.us italics.
Optional parts are enclosed in [brackets].
.note Notes:
These are explanatory remarks noting major features and possible
pitfalls.
We explain anything special that you might need to know about the
program.
.note See Also:
This is a cross-reference to any information that is related to the
program.
.note Example:
You'll find one or more sample uses of the utility program with an
explanation of what the program is doing.
.endnote
.np
Some of the utilities are &dos4g-based, protected-mode programs.
To determine which programs run in protected mode and which in real,
run the program.
If you see the &dos4g banner, the program runs in protected mode.
.*
.npsection &dos4gnam
.*
.ix '&dos4gnam'
.begnote $setptnt 6
.note Purpose:
Loads and executes linear executables.
.note Syntax:
.us linear_executable
.note Notes:
.ix 'stub program'
The stub program at the beginning of the linear executable invokes
this program, which loads the linear executable and starts up the DOS
extender.
The stub program must be able to find &dos4gnam: make sure it is in the
path.
.endnote
.*
.npsection PMINFO
.*
.ix 'PMINFO'
.begnote $setptnt 6
.note Purpose:
.ix 'mode switching' 'performance'
.ix 'switching modes' 'performance'
Measures the performance of protected/real-mode switching and extended
memory.
.note Syntax:
.mono PMINFO.EXE
.note Notes:
We encourage you to distribute this program to your users.
.np
The time-based measurements made by PMINFO may vary slightly from run
to run.
.note Example:
The following example shows the output of the PMINFO program on a
386 AT-compatible machine.
.cbox begin
.in -2
C>pminfo
     Protected Mode and Extended Memory Performance Measurement -- 5.00
             Copyright (c) Tenberry Software, Inc. 1987 - 1993

DOS memory   Extended memory   CPU performance equivalent to 67.0 MHz 80486
----------   ---------------
       736              8012   K bytes configured (according to BIOS).
       640             15360   K bytes physically present (SETUP).
       651              7887   K bytes available for DOS/16M programs.
22.0 (3.0)        18.9 (4.0)   MB/sec word transfer rate (wait states).
42.9 (3.0)        37.0 (4.0)   MB/sec 32-bit transfer rate (wait states).

Overall cpu and memory performance (non-floating point) for typical
DOS programs is 10.36