SUNDIAG(8) — MAINTENANCE COMMANDS

NAME

sundiag − system diagnostics

SYNOPSIS

/usr/diag/sundiag/sundiag [ −Cmptv ] [ −h remotehost ] [ −o saved_options_file ] [ generic_tool_arguments ]

AVAILABILITY

This program is available with the User Diagnostics software installation option. Refer to Installing the SunOS for information on how to install optional software.

DESCRIPTION

sundiag is a diagnostic facility that tests the functionality of the operating system and reports its findings. It can also be used to report the hardware configuration as detected by the system.

You must be root to use sundiag.

When run on the console monitor, sundiag takes full advantage of the SunView 1 windowing environment. There are four subwindows: a control panel for displaying the discovered hardware configuration and manipulating of the numerous test parameters and options, a test status panel which shows the test results, a console window which is used to display messages, and a performance monitor. There are also some popup frames, including a text frame for viewing sundiag and system log files.

When executed from a terminal, sundiag uses curses(3X) to simulate each subwindow on the screen.

sundiag consists of sundiag, along with several binary modules and executable files containing the actual test code, all of which reside in /usr/diag/sundiag.

OPTIONS

−C Redirect the console output from any existing console window to the sundiag console sub-window. This option does not work when running on a terminal or tty emulator.

−m Create a device file for all devices found during the kernel probe. sundiag uses the same major/minor device numbers and permissions declared in /dev/MAKEDEV.

−p Ignore the kernel probe for devices, especially when running user-defined tests found in the .usertest file.

−t Run sundiag on a terminal. Incompatible with −C.

−v Suppress the sundiag start-up messages so that they do not interfere with the display when SunView windows come up. This argument may be used in the .sunview file.

−h remotehost
Use this option to invoke sundiag when using the SunView-based Remote Interface. Refer to the UNKNOWN TITLE ABBREVIATION: SUNDIAG for information on this interface.

−o saved_options_file
Use the saved_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.

generic_tool_arguments
Refer to sunview(1) for examples of generic tool arguments that may be used with sundiag.

FILES

/var/adm/sundiaglog/options/.sundiag start-up option file

/usr/diag/sundiag/.usertest user-defined test description file

Museum

Related Articles