hdeadd(1M) MISC. REFERENCE MANUAL PAGES hdeadd(1M)
NAME
hdeadd - add/delete hdelog (Hard Disk Error Log) reports
SYNOPSIS
/usr/sbin/hdeadd -a [ aoptions ] /usr/sbin/hdeadd -d [ dop-
tions ] /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.
-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 dop-
tions are either a hard disk error specification or an
error range specification. A hard disk error specifi-
cation includes the following values:
Last change: Essential Utilities 1
hdeadd(1M) MISC. REFERENCE MANUAL PAGES hdeadd(1M)
-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 sec-
tor 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 begin-
ning 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.
FILES
/dev/hdelog
SEE ALSO
hdefix(1M), hdelogger(1M), hdelog(7).
Bad Block Handling in the System Administrator's Guide.
Last change: Essential Utilities 2
hdeadd(1M) MISC. REFERENCE MANUAL PAGES hdeadd(1M)
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 suc-
cessfully)
Last change: Essential Utilities 3