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

FILES

/dev/hdelog

SEE ALSO

hdefix(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)