.ig
Copyright (C) 2002-6 Bruce Allen <smartmontools-support@lists.sourceforge.net>
-$Id: smartd.8.in,v 1.100 2006/04/12 13:55:44 ballen4705 Exp $
+$Id: smartd.8.in,v 1.106 2006/09/27 21:42:03 chrfranke Exp $
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
(bitmask from "\\\\.\\SMARTVSD") for IDE/ATA devices on Win95/98/98SE/ME,
and \fB"/dev/scsi[0-9][0-7]"\fP (ASPI adapter 0-9, ID 0-7) for SCSI
devices on all versions of Windows.
+If a 3ware 9000 controller is installed, examine all entries
+\fB"/dev/hdX,N"\fP for the first logical drive (\'unit\'
+\fB"/dev/hdX"\fP) and all physical disks (\'ports\' \fB",N"\fP)
+detected behind this controller. Same for a second controller if present.
.IP \fBCYGWIN\fP: 9
See "WINDOWS" above.
.IP \fBOS/2,eComStation\fP: 9
.B \-\-service
Cygwin and Windows only: Enables \fBsmartd\fP to run as a Windows service.
-On Cygwin, this option simply prevents fork'ing into background mode to
+On Cygwin, this option simply prevents forking into background mode to
allow running \fBsmartd\fP as service via cygrunsrv, see NOTES below.
On Windows, this option enables the buildin service support.
.B # This is an example smartd startup config file
.B # /usr/local/etc/smartd.conf for monitoring three
.B # ATA disks, three SCSI disks, six ATA disks
-.B # behind two 3ware controllers and one SATA disk
+.B # behind two 3ware controllers, three SATA disks
+.B # directly connected to the highpoint rocket-
+.B # raid controller, two SATA disks connected to
+.B # the highpoint controller via a pmport device
+.B # and one SATA disk.
.B #
.nf
.B # First ATA disk on two different interfaces. On
.B \ \ /dev/twa0 -d 3ware,1 -a -s L/../../7/02
.B #
.nf
+.B # Three SATA disks on a highpoint rocketraid controller.
+.B # Start short self-tests daily between 1-2, 2-3, and
+.B # 3-4 am.
+.B \ \ /dev/sde -d hpt,1/1 -a -s S/../.././01
+.B \ \ /dev/sde -d hpt,1/2 -a -s S/../.././02
+.B \ \ /dev/sde -d hpt,1/3 -a -s S/../.././03
+.B #
+.nf
+.B # Two SATA disks connected to a highpoint rocketraid
+.B # via a pmport device. Start long self-tests Sundays
+.B # between midnight and 1am and 2-3 am
+.B \ \ /dev/sde -d hpt,1/4/1 -a -s L/../../7/00
+.B \ \ /dev/sde -d hpt,1/4/2 -a -s L/../../7/02
+.B #
+.nf
.B # The following line enables monitoring of the
.B # ATA Error Log and the Self-Test Error Log.
.B # It also tracks changes in both Prefailure
.TP
.B \-d TYPE
Specifies the type of the device. This Directive may be used multiple
-times for one device, but the arguments \fIata\fP, \fIscsi\fP,
+times for one device, but the arguments \fIata\fP, \fIscsi\fP, \fIsat\fP,
\fImarvell\fP, and \fI3ware,N\fP are mutually-exclusive. If more than
one is given then \fBsmartd\fP will use the last one which appears.
\fBsmartd\fP
from issuing ATA commands to a SCSI device.
+.I sat
+\- the device type is SCSI to ATA Translation (SAT).
+\fBsmartd\fP
+will generate ATA (smart) commands and then package them in
+the SAT defined ATA PASS THROUGH SCSI commands. The commands
+are then routed through the SCSI pass through interface to the
+operating system. There are two types of ATA PASS THROUGH
+SCSI commands: a 12 byte and 16 byte variant.
+\fBsmartd\fP
+can use either and defaults to the 16 byte variant. This can
+be overridden with this syntax: \'\-d sat,12\' or \'\-d sat,16\'.
+
.I marvell
\- Under Linux, interact with SATA disks behind Marvell chip-set
controllers (using the Marvell rather than libata driver).
.B 3ware controllers are currently ONLY supported under Linux.
+.I hpt,L/M/N
+\- the device consists of one or more ATA disks connected to a HighPoint
+RocketRAID controller. The integer L is the controller id, the integer M
+is the channel number, and the integer N is the PMPort number if it is
+available. The allowed values of L are from 1 to 4 inclusive, M are from
+1 to 8 inclusive and N from 1 to 4 if PMPort available. And also these
+values are limited by the model of the HighPoint RocketRAID controller.
+In log files and email messages this disk will be identified as
+hpt_X/X/X and X/X/X is the same as L/M/N, note if no N indicated, N set
+to the default value 1.
+
+.B HighPoint RocketRAID controllers are currently ONLY supported under Linux.
+
.I removable
\- the device or its media is removable. This indicates to
\fBsmartd\fP
In the IDLE state, most disks are still spinning, so this is probably
not what you want.
+When a self test is scheduled (see \'\-s\' Directive below), the
+\'\fB\-n\fP\' Directive is ignored, and all tests are carried out.
+
When a periodic test is skipped, \fBsmartd\fP normally writes an
informal log message. The message can be suppressed by appending
the option \',q\' to POWERMODE (like \'\-n standby,q\').
.IP \fBSMARTD_DEVICE\fP 4
is set to the device path (examples: /dev/hda, /dev/sdb).
.IP \fBSMARTD_DEVICETYPE\fP 4
-is set to the device type (possible values: ata, scsi, 3ware,N). Here
-N=0,...,15 denotes the ATA disk behind a 3ware RAID controller.
+is set to the device type (possible values: ata, scsi, 3ware,N, hpt,L/M/N).
+Here N=0,...,15 denotes the ATA disk behind a 3ware RAID controller and
+L/M/N denotes the SATA disk behind a HighPoint RocketRAID controller.
.IP \fBSMARTD_DEVICESTRING\fP 4
is set to the device description. For SMARTD_DEVICETYPE of ata or
scsi, this is the same as SMARTD_DEVICE. For 3ware RAID controllers,
-the form used is \'/dev/sdc [3ware_disk_01]\'. In this case the device
-string contains a space and is NOT quoted. So to use
+the form used is \'/dev/sdc [3ware_disk_01]\'. For HighPoint RocketRAID
+controller, the form is \'/dev/sdd [hpt_1/1/1]\'. In these cases the
+device string contains a space and is NOT quoted. So to use
$SMARTD_DEVICESTRING in a bash script you should probably enclose it
in double quotes.
.IP \fBSMARTD_FAILTYPE\fP 4
need to read it, the read will fail. Please see the previous \'\-C\'
option for more details.
+.TP
+.B \-W DIFF[,INFO[,CRIT]]
+Report if the current temperature had changed by at least \fBDIFF\fP
+degrees since last report. Report or Warn if the temperature is greater
+or equal than one of \fBINFO\fP or \fBCRIT\fP degrees Celsius. If the
+limit \fBCRIT\fP is reached, a message with loglevel
+\fB\'LOG_CRITICAL\'\fP will be logged to syslog and a warning email
+will be send if '-m' is specified. If only the limit \fBINFO\fP is
+reached, a message with loglevel \fB\'LOG_INFO\'\fP will be logged.
+
+To disable any of the 3 reports, set the corresponding limit to 0.
+Trailing zero arguments may be omitted. By default, all temperature
+reports are disabled (\'-W 0\').
+
+To track temperature changes of at least 2 degrees, use:
+.nf
+\fB \-W 2
+.fi
+To log informal messages on temperatures of at least 40 degrees, use:
+.nf
+\fB \-W 0,40
+.fi
+For warning messages/mails on temperatures of at least 45 degrees, use:
+.nf
+\fB \-W 0,0,45
+.fi
+To combine all of the above reports, use:
+.nf
+\fB \-W 2,40,45
+.fi
+
+For ATA devices, smartd interprets Attribute 194 as Temperature Celsius
+by default. This can be changed to Attribute 9 or 220 by the drive
+database or by the \'-v\' directive, see below.
+
.TP
.B \-F TYPE
[ATA only] Modifies the behavior of \fBsmartd\fP to compensate for
.SH
CVS ID OF THIS PAGE:
-$Id: smartd.8.in,v 1.100 2006/04/12 13:55:44 ballen4705 Exp $
+$Id: smartd.8.in,v 1.106 2006/09/27 21:42:03 chrfranke Exp $
projects / mirror_smartmontools-debian.git / blobdiff