up | Inhaltsverzeichniss | Kommentar

Manual page for SUNDIAG(8)

sundiag - SunOS hardware diagnostic program


/usr/diag/sundiag/sundiag [ -Cmpqtvw ] [ -a | -h hostname ] [ -o option_file ] [ -b batch_file ]
          [ -k kernel_name ] [ -o saved_options_file ] [ sunview_arguments ]
/usr/diag/sundiag/testname testname-specific_arguments [ cprquvdt ] [ h hostname ]


This program is in the diagnostics (User_Diag) software category of SunOS. Refer to Installing SunOS for information on how to install optional software.


Sundiag 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 not detected by sundiag, then it is not connected properly.

Only super-user can use Sundiag .

The Sundiag program consists of the sundiag window-based user interface, along with several binary modules and executable files containing the actual test code, all of which reside in /usr/diag/sundiag.

The Sundiag program can be run from the SunView window environment, from a tty, or individual tests can be run from the command line of a C-shell or Bourne shell. 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 a tty interface.

Redirect the console output from any existing console window to the sundiag console sub-window. If you are using the tty interface, the console message is displayed in the message line of the status screen.
Create any missing device files for the devices found during the kernel probe. sundiag uses the same major/minor device numbers and permissions declared in /dev/MAKEDEV.
Skip the Sundiag kernel probe for devices. If this argument is specified, Sundiag only runs the user-defined tests it finds in .usertest.
Automatically quit the Sundiag program when testing stops. This option is designed for use in sh.1 or csh.1 shell scripts, and can only be issued from a command line.
Run sundiag in tty mode.
Suppress Sundiag start-up messages, so they do not interfere with the display when SunView windows come up. This argument is used in your .sunview file.
Write the system hardware configuration to the /usr/adm/sundiaglog/sundiag.conf file.
-a hostname
Run sundiag 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] for details.
-o options_file
Use the options_file to restore options. The default option file is .sundiag. .sundiag is used if the -o 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 system. The default kernel name is /vmunix. The performance monitor is disabled when this option is specified, since it depends upon rstadt.8c rstadt.8c in turn, relies on /vmunix as the kernel name.
Refer to sunview.1 for examples of generic tool arguments that may be used with sundiag.

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 crashes.
Skip any test loops.
Continue testing after an error has occurred. The test continues with the next test sequence instead of exiting.
Run a faster, abbreviated version of the test, if it exists.
Display information on how to run the test. It shows three parts: command line usage, standard arguments and routine specific arguments.
Display verbose messages regarding the test. These messages tell you more about the testing process that is going on. This mode is more valuable for some tests than others; graphics tests only return start and stop messages/failures.
Display debug messages from the test. These messages provide more 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
Specify hostname to receive system messages regarding this test.


Running the Sundiag Program from SunView

When sundiag is started from the SunView window environment, it brings up its own window with four subwindows:

There are also some popup frames, including a text frame for viewing sundiag and system log files.

Running the Sundiag Program from a tty Interface

sundiag can be run from a terminal, by specifying the -t option (tty mode) when Sundiag is started. In tty mode, Sundiag emulates the window interface on a terminal screen. The tests and test options available in the window system are also available in tty mode. Commands and options are shown in brackets at the top of the tty screen, and are typed in at the command line on the bottom of the screen.

When executed from a terminal, sundiag uses curses.3v 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 OPTIONS sections.


start-up option file
user-defined test description file
Sundiag status log file
Sundiag status error file
SunOS system log


sunview.1 curses.3v rstatd.8c

[a manual with the abbreviation INSTALL]
[a manual with the abbreviation SUNDIAG]

index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © by Hans-Peter Bischof. All Rights Reserved (1997).

Last modified 21/April/97