Manual page for SUNDIAG(8)
sundiag - SunOS hardware diagnostic program
-a | -h hostname
This program is in the
software category of SunOS. Refer to
for information on how to install optional software.
is a diagnostic utility that
tests hardware functionality.
At start-up, Sundiag
probes for the hardware installed on
the system under test, and displays test options for
the hardware it detects.
If a hardware device connected
to the system under test is
then it is not connected properly.
consists of the
window-based user interface,
along with several binary modules and executable files
containing the actual test code,
all of which reside in
The Sundiag program can be run from the SunView window
environment, from a
individual tests can be run from the command line of
Sundiag cannot be used with the OpenWindows
user interface yet.
Running Sundiag in SunView or tty Mode
The following options are available when Sundiag is
run from the SunView window environment, or
Redirect the console output from any existing console
window to the
console sub-window. If you are using the
interface, the console
displayed in the message line of the status screen.
Create any missing device files for
the devices found during the kernel probe.
uses the same major/minor device numbers and permissions
Skip the Sundiag kernel probe for devices. If this argument is
specified, Sundiag only runs the user-defined tests it finds in
Automatically quit the
Sundiag program when testing stops. This option
designed for use in
and can only be issued from a
Suppress Sundiag start-up messages, so they do
not interfere with the display when SunView windows
This argument is used in your
Write the system hardware configuration to the
- -a hostname
in automated test mode. This option requires special
Sun automated test equipment and is intended for use
by Sun manufacturing.
- -h hostname
Run Sundiag remotely. Specialized instructions are
required; see the
[a manual with the abbreviation SUNDIAG]
- -o options_file
to restore options.
The default option file is
is used if the
option is not used and
if the default file exists.
- -b batch_file
Run Sundiag in batch mode.
- -k kernel_name
Specify the customized kernel name that was used to boot
The default kernel name is
The performance monitor is disabled when
this option is specified,
since it depends upon
in turn, relies on
as the kernel name.
for examples of generic tool arguments that may
be used with
Running Sundiag Tests from a Command Line
The following options are available when running individual
Sundiag tests from a command line (``standard arguments'').
Create a core dump file if the
system under test
Skip any test loops.
Continue testing after an error has occurred.
continues with the next test sequence instead of exiting.
Run a faster, abbreviated
version of the test, if it
Display information on how to run the
test. It shows three parts:
command line usage,
standard arguments and routine specific arguments.
messages regarding the test. These
messages tell you more
about the testing process that
is going on. This mode is more valuable
tests than others; graphics tests only return start and stop
Display debug messages from the test. These messages
sophisticated information (mainly useful for test programmers).
Display messages which
allow you to trace down function
calls and the
sequences being used by the
test code for some of the tests.
- h hostname
to receive system messages regarding
Running the Sundiag Program from SunView
is started from the SunView window environment,
it brings up its own window with four
- A test status panel on the upper left of the
screen, which shows the test results.
- A performance monitor in the upper middle of the
screen, which tracks system activity levels.
- A control panel on the upper right of the screen,
which displays the hardware
available for test.
Select the hardware to be
tested by clicking the left mouse
button in the small boxes next to each
will appear in the box next to the
tests which have been selected for test.
Most hardware items have option menus
for changing test parameters.
The option menus can be opened by
clicking the left mouse button
to the right of each hardware item.
- A console window on the lower right of the
screen, which displays system and error messages.
There are also some popup frames,
including a text frame for viewing
and system log files.
Running the Sundiag Program from a tty Interface
can be run from a terminal,
by specifying the
when Sundiag is started.
emulates the window interface on a
terminal screen. The tests
and test options available
in the window system are also available
Commands and options are shown in brackets at
the top of the
screen, and are typed in at the command line on the
bottom of the screen.
When executed from a terminal,
to simulate subwindows on the screen.
Running Individual Sundiag Tests from a Command Line
Sundiag tests can be run individually
from a shell command line using the
syntax explained above in the SNOPSIS and
start-up option file
user-defined test description file
Sundiag status log file
Sundiag status error file
SunOS system log
[a manual with the abbreviation INSTALL]
[a manual with the abbreviation SUNDIAG]
Created by unroff & hp-tools.
© by Hans-Peter Bischof. All Rights Reserved (1997).
Last modified 21/April/97