hdeadd(1M) hdeadd(1M)
NAME
hdeadd - add/delete hdelog (Hard Disk Error Log) reports
SYNOPSIS
/usr/sbin/hdeadd -a [ aoptions ]
/usr/sbin/hdeadd -d [ doptions ]
/usr/sbin/hdeadd -e [ [ -D ] major minor ]
/usr/sbin/hdeadd -f filename
/usr/sbin/hdeadd -r [ -D ] major minor filename
/usr/sbin/hdeadd -s [ -D ] major minor filename
DESCRIPTION
This command is part of the bad block handling utility. It may be
used only by the super-user for manually adding or deleting disk
error reports recorded by hdelogger. These include disk errors
reported while in firmware mode and disk errors that cause the system
to PANIC.
hdeadd may be used to print the list of equipped disks or to
determine if a specific disk device is on the list. In addition,
this command has some options that are for use in testing the
feature.
The following options may be used with hdeadd:
-a hdeadd allows a Hard Disk Error (HDE) report to be added
manually to the HDE Log of a disk.
-d hdeadd allows a specific report or a range of reports to be
deleted from the HDE Log of a disk.
-e prints out the list of major/minor device numbers of the
equipped hard disks. If the major and minor device numbers are
also provided, it determines if that specification is an
equipped hard disk. The result is both printed on the standard
output and is used to determine the exit status. A NORMAL (or
TRUE) exit means it is an equipped disk.
-f the file specified by filename is assumed to contain a canned
set of HDE Log manipulations. Each line of text contains one
specification in the command argument form, starting with a -a
or a -d option.
-s saves a copy of the HDE Log of the specified (by major/minor
device number) disk in the file specified by filename.
7/91 Page 1
hdeadd(1M) hdeadd(1M)
-r restores the HDE Log of the specified disk from the file
specified by filename.
The valid aoptions are only hard disk error specifications.
The valid doptions are either a hard disk error specification or an
error range specification.
A hard disk error specification includes the following values:
-D maj min
Specifies the major device number (maj) and minor device
number (min) of the disk.
-b blockno
Normal form: Specifies the physical disk block number in
integer counter form (i.e., treating the disk as a simple
stream of blocks). Physical disk block numbering starts with
zero meaning sector 0 of track 0 of cylinder 0. This is the
normal form that is reported by the operating system.
-B cyl trk sec
Alternate form: Specifies the physical disk block number in
terms of its physical cylinder number (cyl), track number
within cylinder (trk), and sector number within track (sec).
This alternate form is available to cover the possibility of
a non-operating system detector reporting block numbers in
this hardware form.
-t mmddhhmm[yy]
Optional: Specifies the time of day when the error actually
occurred. If omitted when adding reports, the current time
is used. If omitted when deleting reports, any reports for
the given block are deleted.
An error range specification includes the following values:
-D maj min
Specifies the major device number (maj) and minor device
number (min) of the disk.
-F mmddhhmm[yy]
Optional: Specifies the "from" time for the time interval
being purged. If omitted, zero (the beginning of time) is
used.
-T mmddhhmm[yy]
Optional: Specifies the "to" time for the time interval
being purged. If omitted, the end of time is used. The
range comparisons include the end values of the range in the
purge.
Page 2 7/91
hdeadd(1M) hdeadd(1M)
FILES
/dev/hdelog
SEE ALSO
dinit(1M), hdelogger(1M), hdelog(7).
Bad Block Handling in the System Administrator's Guide.
DIAGNOSTICS
The HDE commands exit with one of three values:
0 means NORMAL, or TRUE
1 means bad command usage or execution errors
2 means BAD BLOCKS or FALSE (but command executed successfully)
7/91 Page 3