Skip to content
Snippets Groups Projects
Commit 92502477 authored by pjwilliams's avatar pjwilliams
Browse files

Updated smartd and smartd.conf man pages to include new Directives 

git-svn-id: https://smartmontools.svn.sourceforge.net/svnroot/smartmontools/trunk@397 4ea69e1a-61f1-4043-bf83-b5c94c648137
parent 3c730e5c
No related branches found
No related tags found
No related merge requests found
Show whitespace changes
Inline Side-by-side
sm5/CHANGELOG
+ 3
− 1
View file @ 92502477
CHANGELOG for smartmontools CHANGELOG for smartmontools
$Id: CHANGELOG,v 1.74 2003/01/01 06:39:23 ballen4705 Exp $ $Id: CHANGELOG,v 1.75 2003/01/02 16:38:29 pjwilliams Exp $
Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net> Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net>
...@@ -33,6 +33,8 @@ NOTES FOR FUTURE RELEASES: see TODO file. ...@@ -33,6 +33,8 @@ NOTES FOR FUTURE RELEASES: see TODO file.
CURRENT RELEASE (see VERSION file in this directory): CURRENT RELEASE (see VERSION file in this directory):
[PW] Changed smartd.conf Directives -- see man page
[BA/DG] Fixed uncommented comment in smartd.conf [BA/DG] Fixed uncommented comment in smartd.conf
[DG] Correct 'Recommended start stop count' for SCSI devices [DG] Correct 'Recommended start stop count' for SCSI devices
......
sm5/smartd.8
+ 150
− 143
View file @ 92502477
\# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net> \# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net>
\# \#
\# $Id: smartd.8,v 1.43 2003/01/01 07:24:54 ballen4705 Exp $ \# $Id: smartd.8,v 1.44 2003/01/02 16:38:29 pjwilliams Exp $
\# \#
\# This program is free software; you can redistribute it and/or modify it \# 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 the Free \# under the terms of the GNU General Public License as published by the Free
...@@ -16,7 +16,7 @@ ...@@ -16,7 +16,7 @@
\# Research Center), Jack Baskin School of Engineering, University of \# Research Center), Jack Baskin School of Engineering, University of
\# California, Santa Cruz. http://ssrc.soe.ucsc.edu/ \# California, Santa Cruz. http://ssrc.soe.ucsc.edu/
\# \#
.TH SMARTD 8 "$Date: 2003/01/01 07:24:54 $" "smartmontools-5.0" .TH SMARTD 8 "$Date: 2003/01/02 16:38:29 $" "smartmontools-5.0"
.SH NAME .SH NAME
smartd \- S.M.A.R.T. Daemon smartd \- S.M.A.R.T. Daemon
.SH SYNOPSIS .SH SYNOPSIS
...@@ -247,20 +247,20 @@ Section below! ...@@ -247,20 +247,20 @@ Section below!
.nf .nf
.B # First ATA disk on each of two interfaces: .B # First ATA disk on each of two interfaces:
.B # .B #
.B \ \ /dev/hda -a -M admin@yoyodyne.com,root@localhost .B \ \ /dev/hda -a -m admin@yoyodyne.com,root@localhost
.B \ \ /dev/hdc -a -I 194 -I 5 -i 12 .B \ \ /dev/hdc -a -I 194 -I 5 -i 12
.B # .B #
.nf .nf
.B # SCSI disks. Send a TEST warning email to admin on .B # SCSI disks. Send a TEST warning email to admin on
.B # startup. (Note: the -1 is the argument of -m.) .B # startup.
.B # .B #
.B \ \ /dev/sda .B \ \ /dev/sda
.B \ \ /dev/sdc -M admin@yoyodyne.com -m -1 .B \ \ /dev/sdc -m admin@yoyodyne.com -M once,test
.B # .B #
.nf .nf
.B # Strange device. It's SCSI: .B # Strange device. It's SCSI:
.B # .B #
.B \ \ /dev/weird -S .B \ \ /dev/weird -d scsi
.B # .B #
.nf .nf
.B # The following line enables monitoring of the .B # The following line enables monitoring of the
...@@ -269,10 +269,12 @@ Section below! ...@@ -269,10 +269,12 @@ Section below!
.B # and Usage Attributes, apart from Attributes .B # and Usage Attributes, apart from Attributes
.B # 9, 194, and 231, and shows continued lines: .B # 9, 194, and 231, and shows continued lines:
.B # .B #
.B \ \ /dev/hdd\ -L\ -l\ -t\ \ \(rs\ \ # Attributes not tracked: .B \ \ /dev/hdd\ -l\ error\ \(rs
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I\ 194\ \(rs\ \ # temperature .B \ \ \ \ \ \ \ \ \ \ \ -l\ selftest\ \(rs
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I\ 231\ \(rs\ \ # also temperature .B \ \ \ \ \ \ \ \ \ \ \ -t\ \(rs\ \ \ \ \ \ # Attributes not tracked:
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I 9\ \ \ \ \ \ # power-on hours .B \ \ \ \ \ \ \ \ \ \ \ -I\ 194\ \(rs\ \ # temperature
.B \ \ \ \ \ \ \ \ \ \ \ -I\ 231\ \(rs\ \ # also temperature
.B \ \ \ \ \ \ \ \ \ \ \ -I 9\ \ \ \ \ \ # power-on hours
.B # .B #
.B ################################################ .B ################################################
.fi .fi
...@@ -304,20 +306,19 @@ possible. ...@@ -304,20 +306,19 @@ possible.
.B If a SCSI disk is listed, .B If a SCSI disk is listed,
it will be monitored at the only implemented level: roughly equivalent it will be monitored at the only implemented level: roughly equivalent
to using the '\-c' option for an ATA disk. So with the exception of '\-S', '\-M', and '\-m', to using the '\-H' option for an ATA disk. So with the exception of '\-d', '\-m', and '\-M',
the Directives below are ignored for SCSI the Directives below are ignored for SCSI
disks. For SCSI disks, the '\-M' Directive sends a warning email if disks. For SCSI disks, the '\-m' Directive sends a warning email if
the SMART status indicates a disk failure or problem. the SMART status indicates a disk failure or problem.
.TP .TP
.B \-A .B \-d TYPE
ATA: The device is an ATA device. Don't try issuing SCSI commands to it. Specifies the type of the device. This will prevent
.TP .B smartd
.B \-S from issuing SCSI commands to an ATA device and vice versa. The valid
SCSI: The device is a SCSI device. Don't try issuing IDE/ATA arguments to this Directive are \fIata\fP and \fIscsi\fP.
commands to it.
In the absence of either of these previous two Directives, In the absence of this Directive,
.B smartd .B smartd
will first attempt to guess the device type by looking at whether the sixth will first attempt to guess the device type by looking at whether the sixth
character in the device name is an 's' or an 'h'. This will work for character in the device name is an 's' or an 'h'. This will work for
...@@ -326,44 +327,47 @@ device names like /dev/hda or /dev/sdb. If ...@@ -326,44 +327,47 @@ device names like /dev/hda or /dev/sdb. If
can't guess from this sixth character, then it will simply try to can't guess from this sixth character, then it will simply try to
access the device using first ATA and then SCSI ioctl()s. access the device using first ATA and then SCSI ioctl()s.
.TP .TP
.B \-P .B \-T TYPE
Permissive: Even if the disk appears to lack SMART capabilities, try Specifies how tolerant
to monitor it anyway. This may be required for some old disks (prior .B smartd
to ATA-3 revision 4) that implemented SMART before the SMART standards should be of SMART command failures. The valid arguments to this
were incorporated into the ATA/ATAPI Specifications. [Please see the Directive are:
.B smartctl \-P
.I normal
\- do not try to monitor the disk if a mandatory SMART command fails, but
continue if an optional SMART command fails. This is the default.
.I permissive
\- try to monitor the disk even if it appears to lack SMART capabilities.
This may be required for some old disks (prior to ATA-3 revision 4) that
implemented SMART before the SMART standards
were incorporated into the ATA/ATAPI Specifications.
[Please see the
.B smartctl \-T
command-line option.] command-line option.]
.TP .TP
.B \-T <N> .B \-o VALUE
Testing: This Directive takes a decimal integer argument <N> which can Enables or disables SMART Automatic Offline Testing when
have value 0 or 1. If <N>=1 this Directive enables Automatic Offline
Testing. The delay between tests is vendor-specific but is typically
four hours. If <N>=0 this Directive disables Automatic Offline Testing.
This Directive will enable/disable Automatic Offline Testing when
.B smartd .B smartd
starts up and will have no further effect. starts up and has no further effect. The valid arguments to this
Directive are \fIon\fP and \fIoff\fP.
The delay between tests is vendor-specific, but is typically four hours.
[Please see the [Please see the
.B smartctl \-t .B smartctl \-o
and command-line option.]
.B \-T
command-line options.]
.TP .TP
.B \-s <N> .B \-S VALUE
Save: Enables or disables Attribute Autosave when
This Directive takes a decimal integer argument <N> which can
have value 0 or 1. If <N>=1 this Directive enables Attribute Autosave.
If <N>=0 this Directive disables Attribute Autosave. This Directive
will enable/disable Attribute Autosave when
.B smartd .B smartd
starts up and will have no further effect. starts up and has no further effect. The valid arguments to this
[Please see the Directive are \fIon\fP and \fIoff\fP. [Please see the
.B smartctl \-f .B smartctl \-f
and command-line option.]
.B \-F
command-line options.]
.TP .TP
.B \-c .B \-H
Check: Will check the SMART status of the disk. If any Prefailure Check the SMART health status of the disk. If any Prefailure
Attributes are less than or equal to their threshold values, then disk Attributes are less than or equal to their threshold values, then disk
failure is predicted in less than 24 hours, and a message at priority failure is predicted in less than 24 hours, and a message at priority
.B 'CRITICAL' .B 'CRITICAL'
...@@ -371,49 +375,55 @@ will be logged to syslog. [Please see the ...@@ -371,49 +375,55 @@ will be logged to syslog. [Please see the
.B smartctl \-c .B smartctl \-c
command-line option.] command-line option.]
.TP .TP
.B \-l .B \-l TYPE
Log: Report if that the number of ATA errors reported in the ATA Reports increases in the number of errors in one of the two SMART logs. The
Error Log has increased since the last check. valid arguments to this Directive are:
[Please see the
.B smartctl \-l .I error
command-line option.] \- report if that the number of ATA errors reported in the ATA Error Log has
.TP increased since the last check.
.B \-L
Log: Report if that the number of errors reported in the SMART .I selftest
Self-Test Log has increased since the last check. Note that such \- report if that the number of errors reported in the SMART Self-Test Log
errors will has increased since the last check. Note that such errors will
.I only .I only
be logged if you run self-tests on the disk (and it fails the be logged if you run self-tests on the disk (and it fails the tests!).
tests!). [Self-Tests can be run by using the [Self-Tests can be run by using the
.B '\-SXsx' .B '\-t\ short'
and
.B '\-t\ long'
options of options of
.B smartctl, .B smartctl
and the results of the testing can be observed using the and the results of the testing can be observed using the
.B smartctl \-L .B smartctl '\-l\ selftest'
command line option.] command-line option.]
[Please see the
.B smartctl \-l
command-line option.]
.TP .TP
.B \-f .B \-f
Fail: Check for 'failure' of any Usage Attributes. If these Check for 'failure' of any Usage Attributes. If these
Attributes are less than or equal to the threshold, it does NOT Attributes are less than or equal to the threshold, it does NOT
indicate imminent disk failure. It "indicates an advisory condition indicate imminent disk failure. It "indicates an advisory condition
where the usage or age of the device has exceeded its intended design where the usage or age of the device has exceeded its intended design
life period." life period." [Please see the
[Please see the .B smartctl \-A
.B smartctl \-v
command-line option.] command-line option.]
.TP .TP
.B \-M <ADD> .B \-m ADD
Mail: Send a warning email to the email address <ADD> if Send a warning email to the email address
the '\-c', '\-l', '\-L', or '\-f' .B ADD
if the '\-H', '\-l', or '\-f'
Directives detect a failure or a new error. Directives detect a failure or a new error.
This Directive only works in conjunction with these other Directives This Directive only works in conjunction with these other Directives
(or with the equivalent '\-a' Directive). To prevent your email (or with the equivalent '\-a' Directive). To prevent your email
in-box from getting filled up with warning messages, by default only a in-box from getting filled up with warning messages, by default only a
single warning will be sent for each of the enabled test single warning will be sent for each of the enabled test
types, '\-c', '\-l', '\-L', or '\-f', types, '\-H', '\-l', or '\-f',
even if more than one failure or error is even if more than one failure or error is
detected or if the failure or error persists. [This behavior can be detected or if the failure or error persists. [This behavior can be
modified; see the '\-m' Directive below.] modified; see the '\-M' Directive below.]
The email is sent using the system The email is sent using the system
.B mail .B mail
...@@ -425,104 +435,97 @@ command must be in the path of the ...@@ -425,104 +435,97 @@ command must be in the path of the
shell or environment from which shell or environment from which
.B smartd .B smartd
was started. To test that the mail is being sent correctly, or to was started. To test that the mail is being sent correctly, or to
alter the pattern of when mail is sent, see the `\-m' Directive below. alter the pattern of when mail is sent, see the `\-M' Directive below.
To send email to more than one user, please use the following form for the address To send email to more than one user, please use the following form for the address:
<ADD>:
.B user1@add1,user2@add2,...,userN@addN .B user1@add1,user2@add2,...,userN@addN
(with no spaces). (with no spaces).
.TP .TP
.B \-m <N> .B \-M TYPE
Modify Mail: Modifies the behavior of the '\-M' email Directive above, Modifies the behavior of the '\-m' email Directive above,
and has no effect without this other Directive. This option controls and has no effect without this other Directive. This option controls
when, and how often, the '\-M' Directive sends email warning messages. when, and how often, the '\-m' Directive sends email warning messages.
The valid arguments to this Directive are:
This Directive takes a decimal integer argument <N> in the range from .I once
-3 to 3 inclusive. \- send only one warning email for each type of disk problem detected. This
.nf is the default.
.B If <N>=0 or 1:
.fi .I daily
equivalent to not having this '\-m' Directive present at all. Only \- send additional warning reminder emails, once per day, for each type
one warning email is sent for each type of disk problem detected.
.nf
.B If <N>=2:
.fi
send additional warning reminder emails, once per day, for each type
of disk problem detected. of disk problem detected.
.nf
.B If <N>=3: .I diminishing
.fi \- send additional warning reminder emails, after a one-day interval,
send additional warning reminder emails, after a one-day interval,
then a two-day interval, then a four-day interval, and so on for each then a two-day interval, then a four-day interval, and so on for each
type of disk problem detected. Each interval is twice as long as the type of disk problem detected. Each interval is twice as long as the
previous interval. previous interval.
.nf
.B If <N>=-1, -2, or -3: .I once,test daily,test diminishing,test
.fi \- same as the respective arguments above, but also send a single test email
Negative values of <N> have the same meaning as the corresponding
positive value, but also send a single additional "test email"
immediately upon immediately upon
.B smartd .B smartd
startup. This allows one to verify that any email is correctly startup. This allows one to verify that any email is correctly delivered.
delivered. For example, setting <N>=-2 will send a test email on
.B smartd
startup, and additional warning reminder emails at one-day intervals
after any disk problems are detected.
.TP .TP
.B \-p .B \-p
Prefail: Report anytime that a Prefail Attribute has changed Report anytime that a Prefail Attribute has changed
its value since the last check, 30 minutes ago. [Please see the its value since the last check, 30 minutes ago. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-u .B \-u
Usage: Report anytime that a Usage Attribute has changed its value Report anytime that a Usage Attribute has changed its value
since the last check, N seconds ago. [Please see the since the last check, N seconds ago. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-t .B \-t
Track: Equivalent to turning on the two previous flags '\-t' and '\-u'. Equivalent to turning on the two previous flags '\-p' and '\-u'.
Tracks changes in Tracks changes in
.I all .I all
device Attributes. [Please see the device Attributes. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-i <ID> .B \-i ID
Ignore: This Directive modifies the behavior of the '\-f' Directive Ignore device Attribute number
and has no effect without it. .B ID
.I This Directive requires a decimal integer argument <ID> in the range from 1 to 255. when checking for failure of Usage Attributes.
It means to ignore device Attribute number <ID>, when checking for .B ID
failure of Usage Attributes. This is useful, for example, if you have must be a decimal integer in the range from 1 to 255. This Directive modifies
a very old disk and don't want to keep getting messages about the the behavior of the '\-f' Directive and has no effect without it.
hours-on-lifetime Attribute (usually Attribute 9) failing. This
Directive may appear multiple times for a single device, if you want This is useful, for example, if you have a very old disk and don't want to keep
to ignore multiple Attributes. getting messages about the hours-on-lifetime Attribute (usually Attribute 9)
.TP failing. This Directive may appear multiple times for a single device, if you
.B \-I <ID>
Ignore: This Directive modifies the
behavior of the '\-p', '\-u', and '\-t' Directives
and has no effect without one of them.
.I This Directive requires a decimal integer argument <ID> in the range from 1 to 255.
It means to ignore device Attribute <ID>, when tracking changes in the
Attribute values. This is useful, for example, if one of the device
Attributes is the disk temperature (usually Attribute 194 or
231). It's annoying to get reports each time the temperature changes.
This Directive may appear multiple times for a single device, if you
want to ignore multiple Attributes. want to ignore multiple Attributes.
.TP .TP
.B \-I ID
Ignore device Attribute
.B ID
when tracking changes in the Attribute values.
.B ID
must be a decimal integer in the range from 1 to 255. This Directive modifies
the behavior of the '\-p', '\-u', and '\-t' Directives and has no effect
without one of them.
This is useful, for example, if one of the device Attributes is the disk
temperature (usually Attribute 194 or 231). It's annoying to get reports
each time the temperature changes. This Directive may appear multiple
times for a single device, if you want to ignore multiple Attributes.
.TP
.B \-a .B \-a
All: equivalent to turning on the following Directives: Equivalent to turning on all of the following Directives:
.B '\-c' .B '\-H'
to check the SMART status, to check the SMART health status,
.B '\-f' .B '\-f'
to report failures of Usage (rather than Prefail) Attributes, to report failures of Usage (rather than Prefail) Attributes,
.B '\-t' .B '\-t'
to track changes in both Prefailure and Usage Attributes, to track changes in both Prefailure and Usage Attributes,
.B '\-L' .B '\-l\ selftest'
to report increases in the number of Self-Test Log errors, and to report increases in the number of Self-Test Log errors, and
.B '\-l' .B '\-l\ error'
to report increases in the number of ATA errors. to report increases in the number of ATA errors.
.TP .TP
.B # .B #
...@@ -540,7 +543,7 @@ to see what SMART functionality your disk(s) support(s). If you do ...@@ -540,7 +543,7 @@ to see what SMART functionality your disk(s) support(s). If you do
not like voluminous syslog messages, a good choice of not like voluminous syslog messages, a good choice of
.B smartd .B smartd
configuration file Directives might be configuration file Directives might be
.B \-c \-L \-l \-f. .B \-H \-l\ selftest \-l\ error \-f.
If you want more frequent information, use If you want more frequent information, use
.B -a. .B -a.
...@@ -553,7 +556,9 @@ If you want more frequent information, use ...@@ -553,7 +556,9 @@ If you want more frequent information, use
will make log entries at loglevel will make log entries at loglevel
.B LOG_INFO .B LOG_INFO
if SMART Attribute values have changed, as reported using the if SMART Attribute values have changed, as reported using the
.B '\-t', '\-p', or '\-u' .B '\-t', '\-p',
or
.B '\-u'
Directives. For example: Directives. For example:
.nf .nf
.B 'Device: /dev/hda, SMART Attribute: 194 Temperature_Celsius changed from 94 to 93' .B 'Device: /dev/hda, SMART Attribute: 194 Temperature_Celsius changed from 94 to 93'
...@@ -572,7 +577,9 @@ if a SMART Attribute has failed, for example: ...@@ -572,7 +577,9 @@ if a SMART Attribute has failed, for example:
.B 'Device: /dev/hdc, Failed SMART Attribute: 5 Reallocated_Sector_Ct' .B 'Device: /dev/hdc, Failed SMART Attribute: 5 Reallocated_Sector_Ct'
.fi .fi
This loglevel is used for reporting enabled by the This loglevel is used for reporting enabled by the
.B '\-c', \-f', '\-L', and '\-l' .B '\-H', \-f', '\-l\ selftest',
and
.B '\-l\ error'
Directives. Entries reporting failure of SMART Prefailure Attributes Directives. Entries reporting failure of SMART Prefailure Attributes
should not be ignored: they mean that the disk is failing. Use the should not be ignored: they mean that the disk is failing. Use the
.B smartctl .B smartctl
...@@ -657,4 +664,4 @@ Please let us know if there is an on\-line source for this document. ...@@ -657,4 +664,4 @@ Please let us know if there is an on\-line source for this document.
.SH .SH
CVS ID OF THIS PAGE: CVS ID OF THIS PAGE:
$Id: smartd.8,v 1.43 2003/01/01 07:24:54 ballen4705 Exp $ $Id: smartd.8,v 1.44 2003/01/02 16:38:29 pjwilliams Exp $
sm5/smartd.conf.5
+ 144
− 141
View file @ 92502477
\# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net> \# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net>
\# \#
\# $Id: smartd.conf.5,v 1.15 2002/12/29 01:10:42 pjwilliams Exp $ \# $Id: smartd.conf.5,v 1.16 2003/01/02 16:38:29 pjwilliams Exp $
\# \#
\# This program is free software; you can redistribute it and/or modify it \# 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 the Free \# under the terms of the GNU General Public License as published by the Free
...@@ -16,7 +16,7 @@ ...@@ -16,7 +16,7 @@
\# Research Center), Jack Baskin School of Engineering, University of \# Research Center), Jack Baskin School of Engineering, University of
\# California, Santa Cruz. http://ssrc.soe.ucsc.edu/ \# California, Santa Cruz. http://ssrc.soe.ucsc.edu/
\# \#
.TH SMARTD.CONF 5 "$Date: 2002/12/29 01:10:42 $" "smartmontools-5.0" .TH SMARTD.CONF 5 "$Date: 2003/01/02 16:38:29 $" "smartmontools-5.0"
.SH NAME .SH NAME
smartd.conf \- S.M.A.R.T. Monitoring Daemon Configuration File smartd.conf \- S.M.A.R.T. Monitoring Daemon Configuration File
...@@ -103,20 +103,20 @@ Section below! ...@@ -103,20 +103,20 @@ Section below!
.nf .nf
.B # First ATA disk on each of two interfaces: .B # First ATA disk on each of two interfaces:
.B # .B #
.B \ \ /dev/hda -a -M admin@yoyodyne.com,root@localhost .B \ \ /dev/hda -a -m admin@yoyodyne.com,root@localhost
.B \ \ /dev/hdc -a -I 194 -I 5 -i 12 .B \ \ /dev/hdc -a -I 194 -I 5 -i 12
.B # .B #
.nf .nf
.B # SCSI disks. Send a TEST warning email to admin on .B # SCSI disks. Send a TEST warning email to admin on
.B # startup. (Note: the -1 is the argument of -m.) .B # startup.
.B # .B #
.B \ \ /dev/sda .B \ \ /dev/sda
.B \ \ /dev/sdc -M admin@yoyodyne.com -m -1 .B \ \ /dev/sdc -m admin@yoyodyne.com -M once,test
.B # .B #
.nf .nf
.B # Strange device. It's SCSI: .B # Strange device. It's SCSI:
.B # .B #
.B \ \ /dev/weird -S .B \ \ /dev/weird -d scsi
.B # .B #
.nf .nf
.B # The following line enables monitoring of the .B # The following line enables monitoring of the
...@@ -125,10 +125,12 @@ Section below! ...@@ -125,10 +125,12 @@ Section below!
.B # and Usage Attributes, apart from Attributes .B # and Usage Attributes, apart from Attributes
.B # 9, 194, and 231, and shows continued lines: .B # 9, 194, and 231, and shows continued lines:
.B # .B #
.B \ \ /dev/hdd\ -L\ -l\ -t\ \ \(rs\ \ # Attributes not tracked: .B \ \ /dev/hdd\ -l\ error\ \(rs
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I\ 194\ \(rs\ \ # temperature .B \ \ \ \ \ \ \ \ \ \ \ -l\ selftest\ \(rs
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I\ 231\ \(rs\ \ # also temperature .B \ \ \ \ \ \ \ \ \ \ \ -t\ \(rs\ \ \ \ \ \ # Attributes not tracked:
.B \ \ \ \ \ \ \ \ \ \ \ \ \ \ -I 9\ \ \ \ \ \ # power-on hours .B \ \ \ \ \ \ \ \ \ \ \ -I\ 194\ \(rs\ \ # temperature
.B \ \ \ \ \ \ \ \ \ \ \ -I\ 231\ \(rs\ \ # also temperature
.B \ \ \ \ \ \ \ \ \ \ \ -I 9\ \ \ \ \ \ # power-on hours
.B # .B #
.B ################################################ .B ################################################
.fi .fi
...@@ -160,20 +162,19 @@ possible. ...@@ -160,20 +162,19 @@ possible.
.B If a SCSI disk is listed, .B If a SCSI disk is listed,
it will be monitored at the only implemented level: roughly equivalent it will be monitored at the only implemented level: roughly equivalent
to using the '\-c' option for an ATA disk. So with the exception of '\-S', '\-M', and '\-m', to using the '\-H' option for an ATA disk. So with the exception of '\-d', '\-m', and '\-M',
the Directives below are ignored for SCSI the Directives below are ignored for SCSI
disks. For SCSI disks, the '\-M' Directive sends a warning email if disks. For SCSI disks, the '\-m' Directive sends a warning email if
the SMART status indicates a disk failure or problem. the SMART status indicates a disk failure or problem.
.TP .TP
.B \-A .B \-d TYPE
ATA: The device is an ATA device. Don't try issuing SCSI commands to it. Specifies the type of the device. This will prevent
.TP .B smartd
.B \-S from issuing SCSI commands to an ATA device and vice versa. The valid
SCSI: The device is a SCSI device. Don't try issuing IDE/ATA arguments to this Directive are \fIata\fP and \fIscsi\fP.
commands to it.
In the absence of either of these previous two Directives, In the absence of this Directive,
.B smartd .B smartd
will first attempt to guess the device type by looking at whether the sixth will first attempt to guess the device type by looking at whether the sixth
character in the device name is an 's' or an 'h'. This will work for character in the device name is an 's' or an 'h'. This will work for
...@@ -182,44 +183,47 @@ device names like /dev/hda or /dev/sdb. If ...@@ -182,44 +183,47 @@ device names like /dev/hda or /dev/sdb. If
can't guess from this sixth character, then it will simply try to can't guess from this sixth character, then it will simply try to
access the device using first ATA and then SCSI ioctl()s. access the device using first ATA and then SCSI ioctl()s.
.TP .TP
.B \-P .B \-T TYPE
Permissive: Even if the disk appears to lack SMART capabilities, try Specifies how tolerant
to monitor it anyway. This may be required for some old disks (prior .B smartd
to ATA-3 revision 4) that implemented SMART before the SMART standards should be of SMART command failures. The valid arguments to this
were incorporated into the ATA/ATAPI Specifications. [Please see the Directive are:
.B smartctl \-P
.I normal
\- do not try to monitor the disk if a mandatory SMART command fails, but
continue if an optional SMART command fails. This is the default.
.I permissive
\- try to monitor the disk even if it appears to lack SMART capabilities.
This may be required for some old disks (prior to ATA-3 revision 4) that
implemented SMART before the SMART standards
were incorporated into the ATA/ATAPI Specifications.
[Please see the
.B smartctl \-T
command-line option.] command-line option.]
.TP .TP
.B \-T <N> .B \-o VALUE
Testing: This Directive takes a decimal integer argument <N> which can Enables or disables SMART Automatic Offline Testing when
have value 0 or 1. If <N>=1 this Directive enables Automatic Offline
Testing. The delay between tests is vendor-specific but is typically
four hours. If <N>=0 this Directive disables Automatic Offline Testing.
This Directive will enable/disable Automatic Offline Testing when
.B smartd .B smartd
starts up and will have no further effect. starts up and has no further effect. The valid arguments to this
Directive are \fIon\fP and \fIoff\fP.
The delay between tests is vendor-specific, but is typically four hours.
[Please see the [Please see the
.B smartctl \-t .B smartctl \-o
and command-line option.]
.B \-T
command-line options.]
.TP .TP
.B \-s <N> .B \-S VALUE
Save: Enables or disables Attribute Autosave when
This Directive takes a decimal integer argument <N> which can
have value 0 or 1. If <N>=1 this Directive enables Attribute Autosave.
If <N>=0 this Directive disables Attribute Autosave. This Directive
will enable/disable Attribute Autosave when
.B smartd .B smartd
starts up and will have no further effect. starts up and has no further effect. The valid arguments to this
[Please see the Directive are \fIon\fP and \fIoff\fP. [Please see the
.B smartctl \-f .B smartctl \-f
and command-line option.]
.B \-F
command-line options.]
.TP .TP
.B \-c .B \-H
Check: Will check the SMART status of the disk. If any Prefailure Check the SMART health status of the disk. If any Prefailure
Attributes are less than or equal to their threshold values, then disk Attributes are less than or equal to their threshold values, then disk
failure is predicted in less than 24 hours, and a message at priority failure is predicted in less than 24 hours, and a message at priority
.B 'CRITICAL' .B 'CRITICAL'
...@@ -227,49 +231,55 @@ will be logged to syslog. [Please see the ...@@ -227,49 +231,55 @@ will be logged to syslog. [Please see the
.B smartctl \-c .B smartctl \-c
command-line option.] command-line option.]
.TP .TP
.B \-l .B \-l TYPE
Log: Report if that the number of ATA errors reported in the ATA Reports increases in the number of errors in one of the two SMART logs. The
Error Log has increased since the last check. valid arguments to this Directive are:
[Please see the
.B smartctl \-l .I error
command-line option.] \- report if that the number of ATA errors reported in the ATA Error Log has
.TP increased since the last check.
.B \-L
Log: Report if that the number of errors reported in the SMART .I selftest
Self-Test Log has increased since the last check. Note that such \- report if that the number of errors reported in the SMART Self-Test Log
errors will has increased since the last check. Note that such errors will
.I only .I only
be logged if you run self-tests on the disk (and it fails the be logged if you run self-tests on the disk (and it fails the tests!).
tests!). [Self-Tests can be run by using the [Self-Tests can be run by using the
.B '\-SXsx' .B '\-t\ short'
and
.B '\-t\ long'
options of options of
.B smartctl, .B smartctl
and the results of the testing can be observed using the and the results of the testing can be observed using the
.B smartctl \-L .B smartctl '\-l\ selftest'
command line option.] command-line option.]
[Please see the
.B smartctl \-l
command-line option.]
.TP .TP
.B \-f .B \-f
Fail: Check for 'failure' of any Usage Attributes. If these Check for 'failure' of any Usage Attributes. If these
Attributes are less than or equal to the threshold, it does NOT Attributes are less than or equal to the threshold, it does NOT
indicate imminent disk failure. It "indicates an advisory condition indicate imminent disk failure. It "indicates an advisory condition
where the usage or age of the device has exceeded its intended design where the usage or age of the device has exceeded its intended design
life period." life period." [Please see the
[Please see the .B smartctl \-A
.B smartctl \-v
command-line option.] command-line option.]
.TP .TP
.B \-M <ADD> .B \-m ADD
Mail: Send a warning email to the email address <ADD> if Send a warning email to the email address
the '\-c', '\-l', '\-L', or '\-f' .B ADD
if the '\-H', '\-l', or '\-f'
Directives detect a failure or a new error. Directives detect a failure or a new error.
This Directive only works in conjunction with these other Directives This Directive only works in conjunction with these other Directives
(or with the equivalent '\-a' Directive). To prevent your email (or with the equivalent '\-a' Directive). To prevent your email
in-box from getting filled up with warning messages, by default only a in-box from getting filled up with warning messages, by default only a
single warning will be sent for each of the enabled test single warning will be sent for each of the enabled test
types, '\-c', '\-l', '\-L', or '\-f', types, '\-H', '\-l', or '\-f',
even if more than one failure or error is even if more than one failure or error is
detected or if the failure or error persists. [This behavior can be detected or if the failure or error persists. [This behavior can be
modified; see the '\-m' Directive below.] modified; see the '\-M' Directive below.]
The email is sent using the system The email is sent using the system
.B mail .B mail
...@@ -281,104 +291,97 @@ command must be in the path of the ...@@ -281,104 +291,97 @@ command must be in the path of the
shell or environment from which shell or environment from which
.B smartd .B smartd
was started. To test that the mail is being sent correctly, or to was started. To test that the mail is being sent correctly, or to
alter the pattern of when mail is sent, see the `\-m' Directive below. alter the pattern of when mail is sent, see the `\-M' Directive below.
To send email to more than one user, please use the following form for the address To send email to more than one user, please use the following form for the address:
<ADD>:
.B user1@add1,user2@add2,...,userN@addN .B user1@add1,user2@add2,...,userN@addN
(with no spaces). (with no spaces).
.TP .TP
.B \-m <N> .B \-M TYPE
Modify Mail: Modifies the behavior of the '\-M' email Directive above, Modifies the behavior of the '\-m' email Directive above,
and has no effect without this other Directive. This option controls and has no effect without this other Directive. This option controls
when, and how often, the '\-M' Directive sends email warning messages. when, and how often, the '\-m' Directive sends email warning messages.
The valid arguments to this Directive are:
This Directive takes a decimal integer argument <N> in the range from .I once
-3 to 3 inclusive. \- send only one warning email for each type of disk problem detected. This
.nf is the default.
.B If <N>=0 or 1:
.fi .I daily
equivalent to not having this '\-m' Directive present at all. Only \- send additional warning reminder emails, once per day, for each type
one warning email is sent for each type of disk problem detected.
.nf
.B If <N>=2:
.fi
send additional warning reminder emails, once per day, for each type
of disk problem detected. of disk problem detected.
.nf
.B If <N>=3: .I diminishing
.fi \- send additional warning reminder emails, after a one-day interval,
send additional warning reminder emails, after a one-day interval,
then a two-day interval, then a four-day interval, and so on for each then a two-day interval, then a four-day interval, and so on for each
type of disk problem detected. Each interval is twice as long as the type of disk problem detected. Each interval is twice as long as the
previous interval. previous interval.
.nf
.B If <N>=-1, -2, or -3: .I once,test daily,test diminishing,test
.fi \- same as the respective arguments above, but also send a single test email
Negative values of <N> have the same meaning as the corresponding
positive value, but also send a single additional "test email"
immediately upon immediately upon
.B smartd .B smartd
startup. This allows one to verify that any email is correctly startup. This allows one to verify that any email is correctly delivered.
delivered. For example, setting <N>=-2 will send a test email on
.B smartd
startup, and additional warning reminder emails at one-day intervals
after any disk problems are detected.
.TP .TP
.B \-p .B \-p
Prefail: Report anytime that a Prefail Attribute has changed Report anytime that a Prefail Attribute has changed
its value since the last check, 30 minutes ago. [Please see the its value since the last check, 30 minutes ago. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-u .B \-u
Usage: Report anytime that a Usage Attribute has changed its value Report anytime that a Usage Attribute has changed its value
since the last check, N seconds ago. [Please see the since the last check, N seconds ago. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-t .B \-t
Track: Equivalent to turning on the two previous flags '\-t' and '\-u'. Equivalent to turning on the two previous flags '\-p' and '\-u'.
Tracks changes in Tracks changes in
.I all .I all
device Attributes. [Please see the device Attributes. [Please see the
.B smartctl \-v .B smartctl \-A
command-line option.] command-line option.]
.TP .TP
.B \-i <ID> .B \-i ID
Ignore: This Directive modifies the behavior of the '\-f' Directive Ignore device Attribute number
and has no effect without it. .B ID
.I This Directive requires a decimal integer argument <ID> in the range from 1 to 255. when checking for failure of Usage Attributes.
It means to ignore device Attribute number <ID>, when checking for .B ID
failure of Usage Attributes. This is useful, for example, if you have must be a decimal integer in the range from 1 to 255. This Directive modifies
a very old disk and don't want to keep getting messages about the the behavior of the '\-f' Directive and has no effect without it.
hours-on-lifetime Attribute (usually Attribute 9) failing. This
Directive may appear multiple times for a single device, if you want This is useful, for example, if you have a very old disk and don't want to keep
to ignore multiple Attributes. getting messages about the hours-on-lifetime Attribute (usually Attribute 9)
.TP failing. This Directive may appear multiple times for a single device, if you
.B \-I <ID>
Ignore: This Directive modifies the
behavior of the '\-p', '\-u', and '\-t' Directives
and has no effect without one of them.
.I This Directive requires a decimal integer argument <ID> in the range from 1 to 255.
It means to ignore device Attribute <ID>, when tracking changes in the
Attribute values. This is useful, for example, if one of the device
Attributes is the disk temperature (usually Attribute 194 or
231). It's annoying to get reports each time the temperature changes.
This Directive may appear multiple times for a single device, if you
want to ignore multiple Attributes. want to ignore multiple Attributes.
.TP .TP
.B \-I ID
Ignore device Attribute
.B ID
when tracking changes in the Attribute values.
.B ID
must be a decimal integer in the range from 1 to 255. This Directive modifies
the behavior of the '\-p', '\-u', and '\-t' Directives and has no effect
without one of them.
This is useful, for example, if one of the device Attributes is the disk
temperature (usually Attribute 194 or 231). It's annoying to get reports
each time the temperature changes. This Directive may appear multiple
times for a single device, if you want to ignore multiple Attributes.
.TP
.B \-a .B \-a
All: equivalent to turning on the following Directives: Equivalent to turning on all of the following Directives:
.B '\-c' .B '\-H'
to check the SMART status, to check the SMART health status,
.B '\-f' .B '\-f'
to report failures of Usage (rather than Prefail) Attributes, to report failures of Usage (rather than Prefail) Attributes,
.B '\-t' .B '\-t'
to track changes in both Prefailure and Usage Attributes, to track changes in both Prefailure and Usage Attributes,
.B '\-L' .B '\-l\ selftest'
to report increases in the number of Self-Test Log errors, and to report increases in the number of Self-Test Log errors, and
.B '\-l' .B '\-l\ error'
to report increases in the number of ATA errors. to report increases in the number of ATA errors.
.TP .TP
.B # .B #
...@@ -396,7 +399,7 @@ to see what SMART functionality your disk(s) support(s). If you do ...@@ -396,7 +399,7 @@ to see what SMART functionality your disk(s) support(s). If you do
not like voluminous syslog messages, a good choice of not like voluminous syslog messages, a good choice of
.B smartd .B smartd
configuration file Directives might be configuration file Directives might be
.B \-c \-L \-l \-f. .B \-H \-l\ selftest \-l\ error \-f.
If you want more frequent information, use If you want more frequent information, use
.B -a. .B -a.
...@@ -443,4 +446,4 @@ SEE ALSO: ...@@ -443,4 +446,4 @@ SEE ALSO:
.SH .SH
CVS ID OF THIS PAGE: CVS ID OF THIS PAGE:
$Id: smartd.conf.5,v 1.15 2002/12/29 01:10:42 pjwilliams Exp $ $Id: smartd.conf.5,v 1.16 2003/01/02 16:38:29 pjwilliams Exp $
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment

AEI Privacy Policy Imprint