Sun Microsystems Sun Workstation 100U System Manager's Manual page 177

DIAG(SS)
MAINTENANCE COMMANDS DIAG( 8S)
NAME
diag - General-purpose stand-alone utility package
SYNOPSIS
b standi dlac
DESCRIPTION
22
Diag is a general-purpose stand-alone utility package containing a grab-bag of the kinds of tools
needed for disk initialization, testing, and file transfer. Diag supports the various
SMD
and
ST-506
disk controllers.
Note: that dial can only be called from the Sun Workstation PROM monitor - diag is not a sys-
tem utility.
The most common use of diGI is formatting a.nd labelling a disk - see the /ormGI, IGhel, and pGr-
tition commands.
Dial is interactive - it prompts for options a.nd arguments. There are two phases to using diag:
in the first phase, diag prompts for information about the type of disk drive and controller that it
is working with, and essentially 'configures' itself to work with that disk and controller. At the
end of this phase, diag tries to access the disk controller you have defined. If the attempt
succeeds, diag gives you a status report on the disk and gives you a 'diag>' prompt; this signals
the beginning of dia,'s second phase. If the attempt to access the controller fails (if the controller
is mis-defined or non-existent, for example), you get a bus error message, and return to the
PROM monitor.
During diag's second phase, you can use the commands listed below in response to the 'diag>'
prompt. A specific diag command is called up by typing enough characters to uniquely identify
the command. The commands that diag currently recognizes are:
clear
dlaS
Sends a restore command to a disk. This is needed to manually reset disk errors.
Re-initializes the diag program itself - goes back to phase one of the inititialization
process described above.
e .... o...
Toggles an option to report all errors as they occur.
flx Formats a single track (Interphase 2180 controller) or sector (Xylogics SMD controller)
of a disk. This sub-command is not available for use with Adaptec disk controllers
(ST-506 interrace). If the track/sector is already formatted, you are asked for
confirmation in order to avoid destroying the data on the track/sector.
format Formats a disk.
help or
r
Displays a list of the available commands.
Info Toggles an option to report aU disk activity as it completes.
label Labels the disk.
map Explicitly maps one track or sector to a different track or sector. Usually required for
bad track mapping. The format command usually does this automatically. Note that,
like the the fix command above, map is disk controller-dependent: you can map
tracks with an Interphase controller, and sectors with Xylogics controllers. map is not
available for use with Adaptec disk controllers (ST-506 interface).
partition Creates, assigns, or modifies logical partition tables for
a disk. The UNIX operating
system requires logical partitions. The label command writes the partition map to the
disk. There are standard partition tables for each type of disk that diag knows about.
position Tests the disk by reading sectors from random positions on the disk. This command
runs until the user aborts it by typing the letter 'a'.
quit Quits rrom diag and returns to whoever called it up.
Last change: 19 March 1984
Sun Release 1.1