dgmon(1M)

NAME

dgmon − run diagnostic phases in firmware

SYNOPSIS

dgn [ unit [ =number ]]
dgn [ unit[ =number ]] [ ph=a[-b] ] [ rep=n ] [ ucl ] [ soak ]
l(ist) unit
h(elp)
s(how)

DESCRIPTION

The Diagnostic Monitor Utility, dgmon, allows diagnostics to be run in the firmware mode using the system console. The particular diagnostic phases are specified via the dgn command. The interface and the entry into the diagnostic mode is discussed in detail in the SunOS 5.1 Routine System Administration Guide. Diagnostics can be invoked for the entire computer, types of devices (for instance, all ports boards), a specific device (for instance, the system board), or a particular phase or range of phases for the device or device type. Each diagnostic phase and phase description can be found by listing the diagnostic phases for each computer device (such as l sbd). The Monitor s(how) command lists the physical devices.

Types of diagnostic phases:

Normal diagnostics that run every time the computer is powered up

Demand diagnostics that run during soak or must be specifically requested

Interactive diagnostics that must be specifically requested and may cause loss of stored data or require operator intervention

The Diagnostic Monitor denies requests for diagnostics on unequipped devices and non-existent phases.

Option definitions:

ucl unconditional execution—run all specified phases and display all failing results

rep=n repeat phase(s) n times

ph=a run phase a only

ph=a-b run phases a through b only

soak silently and continuously run normal and demand diagnostics for specified range (default: all of phase table) and for specified repetitions (default: continuous, stopped with keyboard entry)

EXAMPLES

dgn	(full system)
dgn ports	(all ports devices)
dgn sbd 0 ucl	(unconditional execution)
dgn ports 0	(ports 0 diagnostic)
dgn ports 1 ucl
dgn sbd ph=3	(run phase 3 only)
dgn sbd ph=1-5	(run phases 1 through 5 only)
dgn sbd soak	(diagnostic system board soak)

Whenever specific phases are requested, the device to be tested must be designated.

DIAGNOSTICS

Improper syntax generates a message or reports the invalid input. The “h” command generates a listing of the correct syntax for the system board firmware.