2
2
Copyright (C) 2002-10 Bruce Allen <smartmontools-support@lists.sourceforge.net>
4
$Id: smartd.conf.5.in 3284 2011-03-04 21:33:35Z chrfranke $
4
$Id: smartd.conf.5.in 3519 2012-03-06 20:01:44Z chrfranke $
6
6
This program is free software; you can redistribute it and/or modify it
7
7
under the terms of the GNU General Public License as published by the Free
22
22
\fBsmartd.conf\fP \- SMART Disk Monitoring Daemon Configuration File\fP
24
.\" %IF NOT OS Windows
25
26
.B /usr/local/etc/smartd.conf
28
.\" %ENDIF NOT OS Windows
27
29
.SH PACKAGE VERSION
28
30
CURRENT_SVN_VERSION CURRENT_SVN_DATE CURRENT_SVN_REV
34
.\"! [This man page is generated for the OS_MAN_FILTER version of smartmontools.
35
.\"! It does not contain info specific to other platforms.]
31
38
\fB/usr/local/etc/smartd.conf\fP is the configuration file for the \fBsmartd\fP
32
39
daemon, which monitors the Self-Monitoring, Analysis and Reporting
33
40
Technology (SMART) system built into many ATA-3 and later ATA, IDE and
42
49
\fB\<CONTROL-C\>\fP in the terminal window where \fBsmartd\fP is
45
.\" DO NOT MODIFY THIS OR THE FOLLOWING TWO LINES. WHAT FOLLOWS
46
.\" IS AUTOMATICALLY INCLUDED FROM THE FILE smartd.8.in
49
52
.SH CONFIGURATION FILE /usr/local/etc/smartd.conf
50
In the absence of a configuration file, under Linux
52
will try to open the 20 ATA devices
53
In the absence of a configuration file
54
\fBsmartd\fP will try to open all available devices.
56
Ubder linux will try to open the 20 ATA devices
54
58
and the 26 SCSI devices
58
will try to open all existing ATA devices (with entries in /dev)
64
will try to open all existing ATA/SATA devices (using ATA subsystem)
60
and all existing SCSI devices (using CAM subsystem).
66
and all existing SCSI/SAS/AHCI devices (using CAM subsystem).
68
.\" %IF OS NetBSD OpenBSD
61
69
Under NetBSD/OpenBSD,
63
71
will try to open all existing ATA devices (with entries in /dev)
65
73
and all existing SCSI devices
75
.\" %ENDIF OS NetBSD OpenBSD
67
77
Under Solaris \fBsmartd\fP will try to open all entries \fB"/dev/rdsk/c?t?d?s?"\fP for IDE/ATA and SCSI disk
68
78
devices, and entries \fB"/dev/rmt/*"\fP for SCSI tape devices.
69
81
Under Windows \fBsmartd\fP will try to open all entries \fB"/dev/hd[a-j]"\fP ("\\\\.\\PhysicalDrive[0-9]")
70
82
for IDE/ATA devices on WinNT4/2000/XP, \fB"/dev/hd[a-d]"\fP
71
83
(bitmask from "\\\\.\\SMARTVSD") for IDE/ATA devices on Win95/98/98SE/ME,
72
84
and \fB"/dev/scsi[0-9][0-7]"\fP (ASPI adapter 0-9, ID 0-7) for SCSI
73
85
devices on all versions of Windows.
74
88
Under Darwin, \fBsmartd\fP will open any ATA block storage device.
76
91
This can be annoying if you have an ATA or SCSI device that hangs or
77
92
misbehaves when receiving SMART commands. Even if this causes no
200
217
.B # Three SATA disks on a HighPoint RocketRAID controller.
201
218
.B # Start short self-tests daily between 1-2, 2-3, and
204
222
.B \ \ /dev/sde -d hpt,1/1 -a -s S/../.././01
205
223
.B \ \ /dev/sde -d hpt,1/2 -a -s S/../.././02
206
224
.B \ \ /dev/sde -d hpt,1/3 -a -s S/../.././03
207
.B # or under FreeBSD
208
.B # /dev/hptrr -d hpt,1/1 -a -s S/../.././01
209
.B # /dev/hptrr -d hpt,1/2 -a -s S/../.././02
210
.B # /dev/hptrr -d hpt,1/3 -a -s S/../.././03
228
.B /dev/hptrr -d hpt,1/1 -a -s S/../.././01
229
.B /dev/hptrr -d hpt,1/2 -a -s S/../.././02
230
.B /dev/hptrr -d hpt,1/3 -a -s S/../.././03
231
.\" %ENDIF OS FreeBSD
213
234
.B # Two SATA disks connected to a HighPoint RocketRAID
214
235
.B # via a pmport device. Start long self-tests Sundays
215
236
.B # between midnight and 1am and 2-3 am.
217
239
.B \ \ /dev/sde -d hpt,1/4/1 -a -s L/../../7/00
218
240
.B \ \ /dev/sde -d hpt,1/4/2 -a -s L/../../7/02
219
.B # or under FreeBSD
220
.B # /dev/hptrr -d hpt,1/4/1 -a -s L/../../7/00
221
.B # /dev/hptrr -d hpt,1/4/2 -a -s L/../../7/02
244
.B \ \ /dev/hptrr -d hpt,1/4/1 -a -s L/../../7/00
245
.B \ \ /dev/hptrr -d hpt,1/4/2 -a -s L/../../7/02
247
.\" %ENDIF OS FreeBSD
224
249
.B # Three SATA disks connected to an Areca
225
250
.B # RAID controller. Start long self-tests Sundays
226
251
.B # between midnight and 3 am.
227
253
.B \ \ /dev/sg2 -d areca,1 -a -s L/../../7/00
228
254
.B \ \ /dev/sg2 -d areca,2 -a -s L/../../7/01
229
255
.B \ \ /dev/sg2 -d areca,3 -a -s L/../../7/02
258
.B \ \ /dev/arcmsr0 -d areca,1 -a -s L/../../7/00
259
.B \ \ /dev/arcmsr0 -d areca,2 -a -s L/../../7/01
260
.B \ \ /dev/arcmsr0 -d areca,3 -a -s L/../../7/02
261
.\" %ENDIF OS FreeBSD
232
264
.B # The following line enables monitoring of the
260
292
devices that are found in the scan. Please see below for additional
295
[NEW EXPERIMENTAL SMARTD FEATURE] If an entry in the configuration file
298
instead of a device name, then all directives in this entry are set
299
as defaults for the next device entries.
304
\ \ DEFAULT -a -R5! -W 2,40,45 -I 194 -s L/../../7/00 -m admin@example.com
308
\ \ DEFAULT -H -m admin@example.com
310
\ \ /dev/sde -d removable
313
has the same effect as:
316
\ \ /dev/sda -a -R5! -W 2,40,45 -I 194 -s L/../../7/00 -m admin@example.com
317
\ \ /dev/sdb -a -R5! -W 2,40,45 -I 194 -s L/../../7/00 -m admin@example.com
318
\ \ /dev/sdc -a -R5! -W 2,40,45 -I 194 -s L/../../7/00 -m admin@example.com
319
\ \ /dev/sdd -H -m admin@example.com
320
\ \ /dev/sde -d removable -H -m admin@example.com
264
324
The following are the Directives that may appear following the device
267
329
on any line of the
268
330
.B /usr/local/etc/smartd.conf
269
331
configuration file. Note that
292
354
controller appear to \fBsmartd\fP as normal ATA devices. Hence all
293
355
the ATA directives can be used for these disks (but see note below).
357
.\" %IF OS Linux FreeBSD
295
358
.B If an Areca controller is used
296
then the corresponding SCSI generic device (/dev/sg?) must be listed,
297
along with the \'\-d areca,N\' Directive (see below). The individual
298
SATA disks hosted by the Areca controller appear to \fBsmartd\fP as
299
normal ATA devices. Hence all the ATA directives can be used for
359
then the corresponding device (SCSI /dev/sg? on Linux or /dev/arcmsr0 on
360
FreeBSD) must be listed, along with the \'\-d areca,N\' Directive (see below).
361
The individual SATA disks hosted by the Areca controller appear to \fBsmartd\fP
362
as normal ATA devices. Hence all the ATA directives can be used for
300
363
these disks. Areca firmware version 1.46 or later which supports
301
364
smartmontools must be used; Please see the \fBsmartctl\fP(8) man page
302
365
for further details.
366
.\" %ENDIF OS Linux FreeBSD
305
369
Specifies the type of the device.
317
381
from issuing SCSI commands to an ATA device.
383
.\" %IF NOT OS Darwin
320
385
\- the device type is SCSI. This prevents
322
387
from issuing ATA commands to a SCSI device.
325
390
\- the device type is SCSI to ATA Translation (SAT).
326
391
This is for ATA disks that have a SCSI to ATA Translation (SAT) Layer
327
392
(SATL) between the disk and the operating system.
329
394
the other 16 bytes long. The default is the 16 byte variant which can be
330
395
overridden with either \'\-d sat,12\' or \'\-d sat,16\'.
397
If \'-d sat,auto\' is specified, device type SAT (for ATA/SATA disks) is
398
only used if the SCSI INQUIRY data reports a SATL (VENDOR: "ATA ").
399
Otherwise device type SCSI (for SCSI/SAS disks) is used.
333
402
\- this device type is for ATA disks that are behind a Cypress USB to PATA
334
403
bridge. This will use the ATACB proprietary scsi pass through command.
382
455
logical device corresponding to the particular physical disks.
383
456
Please see the \fBsmartctl\fP(8) man page for further details.
458
.\" %ENDIF OS FreeBSD Linux
459
.\" %IF OS Linux FreeBSD
386
\- [Linux only] the device consists of one or more SATA disks connected to an
461
\- [Linux and FreeBSD only] the device consists of one or more SATA disks connected to an
387
462
Areca SATA RAID controller. The positive integer N (in the range from 1 to
388
463
24 inclusive) denotes which disk on the controller is monitored.
389
464
In log files and email messages this disk will be identifed as
390
465
areca_disk_XX with XX in the range from 01 to 24 inclusive.
391
466
Please see the \fBsmartctl\fP(8) man page for further details.
468
.\" %ENDIF OS Linux FreeBSD
469
.\" %IF OS FreeBSD Linux
394
471
\- [FreeBSD and Linux only] the device consists of one or more SCSI/SAS disks
395
472
connected to a cciss RAID controller. The non-negative integer N (in the range
403
480
connected to a HighPoint RocketRAID controller. The integer L is the
404
481
controller id, the integer M is the channel number, and the integer N
405
482
is the PMPort number if it is available. The allowed values of L are
406
from 1 to 4 inclusive, M are from 1 to 8 inclusive and N from 1 to 4
483
from 1 to 4 inclusive, M are from 1 to 16 inclusive and N from 1 to 4
407
484
if PMPort available. And also these values are limited by the model
408
485
of the HighPoint RocketRAID controller.
409
486
In log files and email messages this disk will be identified as
536
614
error log has increased since the last check.
539
\- [ATA only] [NEW EXPERIMENTAL SMARTD FEATURE] report if the number of ATA
540
errors reported in the Extended Comprehensive SMART error log has increased
541
since the last check.
617
\- [ATA only] report if the number of ATA errors reported in the Extended
618
Comprehensive SMART error log has increased since the last check.
543
620
If both \'\-l error\' and \'\-l xerror\' are specified, smartd checks
544
621
the maximum of both values.
562
639
[ATA only] Failed self-tests outdated by a newer successful extended
563
self\-test are ignored.
640
self\-test are ignored. The warning email counter is reset if the
641
number of failed self tests dropped to 0. This typically happens when
642
an extended self\-test is run after all bad sectors have been reallocated.
645
\- [ATA only] report if the Offline Data Collection status has changed
646
since the last check. The report will be logged as LOG_CRIT if the new
647
status indicates an error. With some drives the status often changes,
648
therefore \'\-l offlinests\' is not enabled by '\-a\' Directive.
649
.\" %IF NOT OS Cygwin Windows
650
.\"! Appending \',ns\' (no standby) to this directive is not implemented
651
.\"! on OS_MAN_FILTER.
652
.\" %ENDIF NOT OS Cygwin Windows
653
.\" %IF OS Cygwin Windows
655
[Windows and Cygwin only] If \',ns\' (no standby) is appended to this
656
directive, smartd disables system auto standby as long as an Offline
657
Data Collection is in progress. See \'\-l selfteststs,ns\' below.
658
.\" %ENDIF OS Cygwin Windows
661
\- [ATA only] report if the Self-Test execution status has changed
662
since the last check. The report will be logged as LOG_CRIT if the new
663
status indicates an error.
664
.\" %IF NOT OS Cygwin Windows
665
.\"! Appending \',ns\' (no standby) to this directive is not implemented
666
.\"! on OS_MAN_FILTER.
667
.\" %ENDIF NOT OS Cygwin Windows
668
.\" %IF OS Cygwin Windows
670
[Windows and Cygwin only] If \',ns\' (no standby) is appended to this
671
directive, smartd disables system auto standby as long as a Self-Test
672
is in progress. This prevents that a Self-Test is aborted because the
673
OS sets the system to a standby/sleep mode when idle. Smartd check
674
interval (\'\-i\' option) should be shorter than the configured idle
675
timeout. Auto standby is not disabled if the system is running on
677
.\" %ENDIF OS Cygwin Windows
565
679
.I scterc,READTIME,WRITETIME
566
680
\- [ATA only] [NEW EXPERIMENTAL SMARTD FEATURE] sets the SCT Error
572
686
[Please see the \fBsmartctl \-l scterc\fP command-line option.]
690
[NEW EXPERIMENTAL SMARTD FEATURE] Sets non\-SMART device settings
691
when \fBsmartd\fP starts up and has no further effect.
692
[Please see the \fBsmartctl \-\-set\fP command-line option.]
696
\- [ATA only] Sets the Automatic Acoustic Management (AAM) feature.
699
\- [ATA only] Sets the Advanced Power Management (APM) feature.
701
.I lookahead,[on|off]
702
\- [ATA only] Sets the read look-ahead feature.
705
\- [ATA only] Sets ATA Security feature to frozen mode.
708
\- [ATA only] Sets the standby (spindown) timer and places the drive in the
712
\- [ATA only] Sets the volatile write cache feature.
576
716
Run Self-Tests or Offline Immediate Tests, at scheduled times. A
577
717
Self- or Offline Immediate Test will be run at the end of periodic
737
877
executable (for example /usr/local/bin/mail) or a custom script to
738
878
run, please use the \'\-M exec\' Directive below.
740
881
Note that by default under Solaris, in the previous paragraph,
741
882
\'\fBmailx\fP\' and \'\fB/bin/mailx\fP\' are used, since Solaris
742
883
\'/bin/mail\' does not accept a \'\-s\' (Subject) command-line
886
.\" %ENDIF OS Solaris
745
888
On Windows, the \'\fBBlat\fP\' mailer
746
889
(\fBhttp://blat.sourceforge.net/\fP) is used by default.
747
890
This mailer uses a different command line syntax, see
748
891
\'\-M exec\' below.
893
.\" %ENDIF OS Windows
750
894
Note also that there is a special argument
752
896
which can be given to the \'\-m\' Directive in conjunction with the \'\-M
759
903
you have mail problems, we recommend running \fBsmartd\fP in debug
760
904
mode with the \'-d\' flag, using the \'-M test\' Directive described
763
908
The following extension is available on Windows:
764
909
By specifying \'\fBmsgbox\fP\' as a mail address, a warning
766
911
Using both \'\fBmsgbox\fP\' and regular mail addresses is possible,
767
912
if \'\fBmsgbox\fP\' is the first word in the comma separated list.
768
913
With \'\fBsysmsgbox\fP\', a system modal (always on top) message box
769
is used. If running as a service, a service notification message box
770
(always shown on current visible desktop) is used.
916
If running as a service, a service notification message box
917
(always shown on current visible desktop) is used. Please note that
918
service notification message boxes are no longer supported on Windows
920
.\" %ENDIF OS Windows
773
923
These Directives modify the behavior of the
798
948
type of disk problem detected. Each interval is twice as long as the
799
949
previous interval.
951
If a disk problem is no longer detected, the internal email counter is
952
reset. If the problem reappears a new warning email is sent immediately.
801
954
In addition, one may add zero or more of the following Directives:
852
1005
the form used is \'/dev/sdc [3ware_disk_01]\'. For HighPoint
853
1006
RocketRAID controller, the form is \'/dev/sdd [hpt_1/1/1]\' under Linux
854
1007
or \'/dev/hptrr [hpt_1/1/1]\' under FreeBSD. For Areca controllers, the
855
form is \'/dev/sg2 [areca_disk_09]\'. In these cases the device string
1008
form is \'/dev/sg2 [areca_disk_09]\' on Linux or \'/dev/arcmsr0 [areca_disk_09]\' on FreeBSD. In these cases the device string
856
1009
contains a space and is NOT quoted. So to use $SMARTD_DEVICESTRING in a
857
1010
bash script you should probably enclose it in double quotes.
858
1011
.IP \fBSMARTD_FAILTYPE\fP 4
953
1106
.B -m root -M exec /Example_1/bash/script/below
956
1110
Note that on Windows, the syntax of the \'\fBBlat\fP\' mailer is
959
1113
- -q -subject "$SMARTD_SUBJECT" -to "$SMARTD_ADDRESS"
1116
.\" %ENDIF OS Windows
962
1117
If the \'\-m ADD\' Directive is given with the special address argument
964
1119
then the executable pointed to by PATH is run in a shell with
1079
1234
attribute when a bad sector is reallocated.
1080
1235
See also \'\-v 197,increasing\' below.
1237
The warning email counter is reset if the number of pending sectors
1238
dropped to 0. This typically happens when all pending sectors have
1239
been reallocated or could be read again.
1082
1241
A pending sector is a disk sector (containing 512 bytes of your data)
1083
1242
which the device would like to mark as ``bad" and reallocate.
1084
1243
Typically this is because your computer tried to read that sector, and
1107
1266
attribute when a bad sector is reallocated.
1108
1267
See also \'\-v 198,increasing\' below.
1269
The warning email counter is reset if the number of offline uncorrectable
1270
sectors dropped to 0. This typically happens when all offline uncorrectable
1271
sectors have been reallocated or could be read again.
1110
1273
An offline uncorrectable sector is a disk sector which was not
1111
1274
readable during an off\-line scan or a self\-test. This is important
1112
1275
to know, because if you have data stored in this disk sector, and you
1123
1286
will be send if '-m' is specified. If only the limit \fBINFO\fP is
1124
1287
reached, a message with loglevel \fB\'LOG_INFO\'\fP will be logged.
1289
The warning email counter is reset if the temperature dropped below
1290
\fBINFO\fP or \fBCRIT\fP-5 if \fBINFO\fP is not specified.
1126
1292
If this directive is used in conjunction with state persistence
1127
1293
(\'\-s\' option), the min and max temperature values are preserved
1128
1294
across boot cycles. The minimum temperature value is not updated
1238
1404
to report failures of Usage (rather than Prefail) Attributes,
1240
1406
to track changes in both Prefailure and Usage Attributes,
1241
.B \'\-l\ selftest\'
1408
to report increases in the number of ATA errors,
1409
.B \'\-l\ selftest\'
1242
1410
to report increases in the number of Self-Test Log errors,
1244
to report increases in the number of ATA errors,
1411
.B \'\-l\ selfteststs\'
1412
to report changes of Self-Test execution status,
1246
1414
to report nonzero values of the current pending sector count, and
1281
1449
ignore any remaining lines in the configuration file, and will scan
1284
[NEW EXPERIMENTAL SMARTD FEATURE] Configuration entries for devices
1285
not found by the platform\-specific device scanning may precede the
1286
\fBDEVICESCAN\fP entry.
1452
Configuration entries for devices not found by the platform\-specific
1453
device scanning may precede the \fBDEVICESCAN\fP entry.
1288
1455
If \fBDEVICESCAN\fP is not followed by any Directives, then smartd
1289
1456
will scan for both ATA and SCSI devices, and will monitor all possible
1369
1536
within the script, and a snippet of STDOUT/STDERR is logged to SYSLOG.
1370
1537
The remainder is flushed.
1373
.\" DO NOT MODIFY THIS OR PREVIOUS/NEXT LINES. THIS DEFINES THE
1374
.\" END OF THE INCLUDED SECTION FROM smartd.8.in
1378
1541
\fBBruce Allen\fP smartmontools\-support@lists.sourceforge.net
1389
1552
\fBGuido Guenther\fP (Autoconf/Automake packaging)
1390
1553
\fBGeoffrey Keating\fP (Darwin ATA interface)
1391
1554
\fBEduard Martinescu\fP (FreeBSD interface)
1392
\fBFr\*'ed\*'eric L. W. Meunier\fP (Web site and Mailing list)
1555
\fBFr\['e]d\['e]ric L. W. Meunier\fP (Web site and Mailing list)
1393
1556
\fBGabriele Pohl\fP (Web site and Wiki, conversion from CVS to SVN)
1394
1557
\fBKeiji Sawada\fP (Solaris ATA interface)
1395
1558
\fBManfred Schwarb\fP (Drive database)