CR1.1;cpuhelp, revision 1.0, 12/17/91
cpuhelp - get help in choosing a compiler -cpu option argument
usage: cpuhelp [-c cpuarg | -m model | -a[ll] ]
DESCRIPTION
The cpuhelp utility provides information to help you choose the most
appropriate argument for the -cpu compiler option. The -cpu option,
which you can use with all Domain compilers, specifies the target machine
on which your executable code will run. (With /bin/cc and /bin/f77, the
format of the option is -A cpu,cpuarg.)
OPTIONS
-c cpuarg Lists all the target machines on which code compiled with -cpu
cpuarg will run. The cpuarg may be any of the following:
mathlib_sr10, mathlib, mathchip, 3000, 580, 570, 560, 330, 90,
a88k, fpa1, fpx, peb, 160, 460, 660, any, m68k.
-m model Lists the best -cpu arguments to use in order to create code
that will run on the machine model, where model is either the
full model name (DN4500, for example) or just the model number
(4500). "Best" may have several meanings depending on your
needs, and the -m display shows three possible kinds of "best":
Most Compatibility
This -cpu argument generates code that will run
on the widest possible variety of machines,
including the specified model.
Optimal Performance
This -cpu argument generates the best possible
code for the specified model, though the code
may not run on other platforms.
Best Compromise
This -cpu argument generates code that is of
better quality than that produced by the "most
compatibility" argument, but not as good as that
produced by the "optimal performance" argument
(though it may run on more machines).
-a[ll] Provides a table of information similar to that produced by -m
for all of the most common Domain/OS systems.
EXAMPLES
To find out which -cpu options generate code for a DN5500 system, use the
command cpuhelp -m 5500 or cpuhelp -m DN5500, which produces the
following display:
$ cpuhelp -m 5500
Node Type: DN55xx Most Commonality : -cpu any
Optimal Performance: -cpu mathlib
Best Compromise : -cpu mathlib_sr10
This display tells you that -cpu any generates code for the widest
possible variety of machines including the DN5500; that -cpu mathchip
generates the fastest possible code for a DN5500; and that -cpu
mathlib_sr10 generates better code than -cpu any but worse code than -cpu
mathchip.
To find out what machines the option -cpu mathlib_sr10 generates code
for, use the command cpuhelp -c mathlib_sr10, which produces the
following display:
$ cpuhelp -c mathlib_sr10
-cpu mathlib_sr10 Runs (nearly optimally) On: DN330, DN5xx,
DN25xx/30xx/35xx/40xx/45xx, 400, 425, 433