diff --git a/sm5/smartd.conf.5 b/sm5/smartd.conf.5 index de36702edd16d1440d90e3b342d1f392d94b7a51..7e1d3682d454957033bb225f1ceafe54866c8471 100644 --- a/sm5/smartd.conf.5 +++ b/sm5/smartd.conf.5 @@ -1,6 +1,6 @@ \# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net> \# -\# $Id: smartd.conf.5,v 1.6 2002/11/13 10:49:13 ballen4705 Exp $ +\# $Id: smartd.conf.5,v 1.7 2002/11/21 14:15:17 ballen4705 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 the Free @@ -16,7 +16,7 @@ \# Research Center), Jack Baskin School of Engineering, University of \# California, Santa Cruz. http://ssrc.soe.ucsc.edu/ \# -.TH SMARTD.CONF 5 "$Date: 2002/11/13 10:49:13 $" "smartmontools-5.0" +.TH SMARTD.CONF 5 "$Date: 2002/11/21 14:15:17 $" "smartmontools-5.0" .SH NAME smartd.conf \- S.M.A.R.T. Monitoring Daemon Configuration File @@ -106,10 +106,11 @@ Section below! .B \ \ /dev/hdc -a -I 194 -I 5 -i 12 .B # .nf -.B # SCSI disks: +.B # SCSI disks. Send a TEST warning email to admin on +.B # startup. (Note: the -1 is the argument of -m.) .B # .B \ \ /dev/sda -.B \ \ /dev/sdc -M admin@yoyodyne.com +.B \ \ /dev/sdc -M admin@yoyodyne.com -m -1 .B # .nf .B # Strange device. It's SCSI: @@ -153,7 +154,8 @@ name. .B For ATA disks, if .B no Directives appear, the disk will not be monitored. -The '\-a' Directive will try to monitor everything possible. +Conversely, the '\-a' Directive will try to monitor everything +possible. .B If a SCSI disk is listed, it will be monitored at the only implemented level: roughly equivalent @@ -237,13 +239,17 @@ life period." command-line option.] .TP .B \-M <ADD> -Mail: Send a warning email to the email address <ADD> if the '\-c', '\-l', '\-L', or '\-f' -Directives detect a failure or a new error. This Directive only -works in conjunction with these other Directives (or with the equivalent '\-a' -Directive). To prevent your email in-box from getting filled up -with warning messages, only a single warning will be sent for each of -the enabled test types, '\-c', '\-l', '\-L', or '\-f', even if more -than one failure or error is detected. +Mail: Send a warning email to the email address <ADD> if +the '\-c', '\-l', '\-L', or '\-f' +Directives detect a failure or a new error. +This Directive only works in conjunction with these other Directives +(or with the equivalent '\-a' Directive). To prevent your email +in-box from getting filled up with warning messages, by default only a +single warning will be sent for each of the enabled test +types, '\-c', '\-l', '\-L', or '\-f', +even if more than one failure or error is +detected or if the failure or error persists. [This behavior can be +modified; see the '\-m' Directive below.] The email is sent using the system .B mail @@ -254,11 +260,50 @@ find the mail command (normally /bin/mail) the command must be in the path of the shell or environment from which .B smartd -was started. +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. -If you want to send email to more than one user, you can use the form +To send email to more than one user, please use the following form for the address +<ADD>: .B user1@add1,user2@add2,...,userN@addN -with no spaces for <ADD>. +(with no spaces). +.TP +.B \-m <N> +Modify Mail: Modifies the behavior of the '\-M' email Directive above, +and has no effect without this other Directive. This option controls +when, and how often, the '\-M' Directive sends email warning messages. + +This Directive takes a decimal integer argument <N> in the range from +-3 to 3 inclusive. +.nf +.B If <N>=0 or 1: +.fi +equivalent to not having this '\-m' Directive present at all. Only +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. +.nf +.B If <N>=3: +.fi +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 +type of disk problem detected. Each interval is twice as long as the +previous interval. +.nf +.B If <N>=-1, -2, or -3: +.fi +Negative values of <N> have the same meaning as the corresponding +positive value, but also send a single additional "test email" +immediately upon +.B smartd +startup. This allows one to verify that any email is correctly +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 .B \-p Prefail: Report anytime that a Prefail Attribute has changed @@ -376,4 +421,4 @@ SEE ALSO: .SH CVS ID OF THIS PAGE: -$Id: smartd.conf.5,v 1.6 2002/11/13 10:49:13 ballen4705 Exp $ +$Id: smartd.conf.5,v 1.7 2002/11/21 14:15:17 ballen4705 Exp $