SUNDIAG(8) — MAINTENANCE COMMANDS

NAME

sundiag − system diagnostics

SYNOPSIS

/usr/diag/sundiag/sundiag [ −Cmt ] [ −k kernel_name ] [ −o saved_options_file ]

[ generic_tool_arguments ]

AVAILABILITY

This program is available with the User Diagnostics software installation option. Refer to Installing SunOS 4.1 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.

• 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(3V) 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.

−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.

−t Run sundiag on a terminal.

−k kernel_name
Specify the customized kernel name that was used to boot up the system. The default kernel name is /vmunix. Since the rstatd(8C) that the performance monitor requires is hard-wired to use /vmunix as the kernel name, the performance monitor is disabled when this option is specified.

−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