Package: smartmontools
Version: 7.3-1+b1
Severity: minor
Tags: patch
Dear Maintainer,
here are some notes and editorial fixes for the man page.
Patch is in the attachment.
-.-.
The difference between the formatted outputs can be seen with:
nroff -man <file1> > <out1>
nroff -man <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
"groff -man -Z" instead of "nroff -man"
Add the option "-t", if the file contains a table.
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual, the following
must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint smartd.conf.5":
mandoc: smartd.conf.5:250:2: WARNING: line scope broken: SH breaks TP
mandoc: smartd.conf.5:600:81: STYLE: input text line longer than 80 bytes: It
may also be used ...
mandoc: smartd.conf.5:1080:84: STYLE: input text line longer than 80 bytes: If
\*(Aq@ALL\*(Aq is...
-.-.
Change '-' (\-) to '\(en' (en-dash) for a numeric range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.
smartd.conf.5:2:Copyright (C) 2002-10 Bruce Allen
smartd.conf.5:3:Copyright (C) 2004-21 Christian Franke
smartd.conf.5:122:# Start short self\-tests daily between 1\-2, 2\-3, and
smartd.conf.5:123:# 3\-4 am.
smartd.conf.5:142:# Start short self\-tests daily between 1\-2, 2\-3, and
smartd.conf.5:143:# 3\-4 am.
smartd.conf.5:152:# 1 am and 2\-3 am
smartd.conf.5:173:# Start short self\-tests daily between 1\-2, 2\-3, and
smartd.conf.5:174:# 3\-4 am.
smartd.conf.5:192:# between midnight and 1 am and 2\-3 am.
smartd.conf.5:225:# Start short self\-tests daily between 1\-2, 2\-3, and
smartd.conf.5:226:# 3\-4 am.
smartd.conf.5:964: smartctl \-t select,0\-99999999 /dev/sda
smartd.conf.5:969:\fB \-s n/../../[1\-5]/12\fP
-.-.
Wrong distance between sentences.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Seach for two words are easier, when they belong to the same line, and
the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
167:# uses the cciss driver. Start long tests on Sunday nights and short
248:then the corresponding block device (/dev/sd?) must be listed,
371:then the corresponding SCSI (/dev/sd?) or character device (/dev/twe?,
372:/dev/twa?, /dev/twl? or /dev/tws?) must be listed, along with the
379:then the corresponding device (SCSI /dev/sg? on Linux or /dev/arcmsr0 on
-.-.
Protect a period (.) or a apostrophe (') with '\&' from becoming a
control character, if it could end up at the start of a line
(by splitting the line into more lines).
115:# flagged with the '\-d sat' option. This situation
648:\fBsmartd\fP checks it. This is the default behavior if the '\-n'
786:Appending ',ns' (no standby) to this directive is not implemented \"#
801:Appending ',ns' (no standby) to this directive is not implemented \"#
934:0, ... hours, use:
938:To enable staggered tests with delays 0, 1, 2, ..., 9, 10, 0, ... hours,
-.-.
Split a punctuation from a single argument, if a two-font macro is meant
64:.B /etc/smartd.conf.
-.-.
Use \(en for a dash (en-dash) between space characters and at the
beginning of a line, not a minus (\-) or a hyphen (-), except in the
NAME section.
smartd.conf.5:394:\- attempt to guess the device type from the device name or
from
[... and more]
smartd.conf.5:1644:\- show the presets that are available for all drives and
then exit.
-.-.
[ "test-groff" is a developmental version of "groff" ]
Input file is ./smartd.conf.5
Output from "test-groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z ":
troff: backtrace: file '<stdin>':33
troff:<stdin>:33: warning: trailing space in the line
troff: backtrace: file '<stdin>':34
troff:<stdin>:34: warning: trailing space in the line
troff: backtrace: file '<stdin>':786
troff:<stdin>:786: warning: trailing space in the line
troff: backtrace: file '<stdin>':787
troff:<stdin>:787: warning: trailing space in the line
troff: backtrace: file '<stdin>':801
troff:<stdin>:801: warning: trailing space in the line
troff: backtrace: file '<stdin>':802
troff:<stdin>:802: warning: trailing space in the line
-.-.
-- System Information:
Debian Release: trixie/sid
APT prefers testing-proposed-updates
APT policy: (500, 'testing-proposed-updates'), (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.3.7-1 (SMP w/2 CPU threads; PREEMPT)
Kernel taint flags: TAINT_WARN
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages smartmontools depends on:
ii debianutils 5.8-1
ii libc6 2.37-5
ii libcap-ng0 0.8.3-1+b3
ii libgcc-s1 13.1.0-6
ii libselinux1 3.4-1+b6
ii libstdc++6 13.1.0-6
ii libsystemd0 253.5-1
ii lsb-base 11.6
ii sysvinit-utils [lsb-base] 3.07-1
smartmontools recommends no packages.
Versions of packages smartmontools suggests:
ii bsd-mailx [mailx] 8.1.2-0.20220412cvs-1
ii curl 7.88.1-10
ii gpg 2.2.40-1.1
pn gsmartcontrol <none>
ii lynx 2.9.0dev.12-1
pn smart-notifier <none>
ii wget 1.21.3-1+b2
-- no debconf information
--- smartd.conf.5 2023-07-17 00:09:00.000000000 +0000
+++ smartd.conf.5.new 2023-07-17 02:17:25.000000000 +0000
@@ -30,9 +30,9 @@ $Id: smartd.conf.5.in 5333 2022-02-26 00
.Sp
.SH DESCRIPTION
.\" %IF NOT OS ALL
-[This man page is generated for the Linux version of smartmontools. \"#
-It does not contain info specific to other platforms.] \"#
-.PP \"#
+[This man page is generated for the Linux version of smartmontools.\"#
+It does not contain info specific to other platforms.]\"#
+.PP\"#
.\" %ENDIF NOT OS ALL
\fB/etc/smartd.conf\fP is the configuration file for the \fBsmartd\fP
daemon.
@@ -61,7 +61,7 @@ One can avoid this problem, and gain mor
events monitored by
\fBsmartd\fP,
by using the configuration file
-.B /etc/smartd.conf.
+.BR /etc/smartd.conf .
This file contains a list of devices to monitor, with one device per
line. An example file is included with the
.B smartmontools
@@ -112,15 +112,15 @@ Section below!
# An ATA disk may appear as a SCSI device to the
# OS. If a SCSI to ATA Translation (SAT) layer
# is between the OS and the device then this can be
-# flagged with the '\-d sat' option. This situation
+# flagged with the \&'\-d sat' option. This situation
# may become common with SATA disks in SAS and FC
# environments.
/dev/sda \-a \-d sat
.\" %IF OS FreeBSD Linux
#
# Disks connected to a MegaRAID controller
-# Start short self\-tests daily between 1\-2, 2\-3, and
-# 3\-4 am.
+# Start short self\-tests daily between 1\(en2, 2\(en3, and
+# 3\(en4 am.
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS Linux
# Linux:
@@ -149,7 +149,7 @@ Section below!
#
# Two SATA (not SAS) disks on a 3ware 9750 controller.
# Start long self\-tests Sundays between midnight and
-# 1 am and 2\-3 am
+# 1 am and 2\(en3 am
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS Linux
# under Linux
@@ -164,7 +164,7 @@ Section below!
.\" %IF OS FreeBSD Linux
#
# Monitor 2 disks connected to the first HP SmartArray controller which
-# uses the cciss driver. Start long tests on Sunday nights and short
+# uses the cciss driver. Start long tests on Sunday nights and short
# self-tests every night and send errors to root
# \ /dev/sda -d cciss,0 -a -s (L/../../7/02|S/../.././02) -m root
# \ /dev/sda -d cciss,1 -a -s (L/../../7/03|S/../.././03) -m root
@@ -189,7 +189,7 @@ Section below!
#
# Two SATA disks connected to a HighPoint RocketRAID
# via a pmport device. Start long self\-tests Sundays
-# between midnight and 1 am and 2\-3 am.
+# between midnight and 1 am and 2\(en3 am.
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS Linux
# under Linux
@@ -222,8 +222,8 @@ Section below!
.\" %IF OS Linux
#
# Two SATA disks on an Intelliprop controller.
-# Start short self\-tests daily between 1\-2, 2\-3, and
-# 3\-4 am.
+# Start short self\-tests daily between 1\(en2, 2\(en3, and
+# 3\(en4 am.
/dev/sde \-d intelliprop,0+sat \-a \-s S/../.././01
/dev/sde \-d intelliprop,1+sat \-a \-s S/../.././02
.\" %ENDIF OS Linux
@@ -245,9 +245,8 @@ Section below!
.Ve
.Sp
.B If a cciss controller is used
-then the corresponding block device (/dev/sd?) must be listed,
+then the corresponding block device (/dev/sd?\&) must be listed,
along with the \'\-d cciss,N\' Directive (see below).
-.TP
.SH DEVICESCAN
If a non-comment entry in the configuration file is the text string
.B DEVICESCAN
@@ -369,14 +368,14 @@ status fails, or if new errors appear in
.PP
.B If a 3ware controller is used
then the corresponding SCSI (/dev/sd?) or character device (/dev/twe?,
-/dev/twa?, /dev/twl? or /dev/tws?) must be listed, along with the
+/dev/twa?, /dev/twl?\& or /dev/tws?\&) must be listed, along with the
\*(Aq\-d 3ware,N\*(Aq Directive (see below).
The individual ATA disks hosted by the 3ware controller appear to \fBsmartd\fP
as normal ATA devices.
Hence all the ATA directives can be used for these disks (but see note below).
.PP
.B If an Areca controller is used
-then the corresponding device (SCSI /dev/sg? on Linux or /dev/arcmsr0 on
+then the corresponding device (SCSI /dev/sg?\& on Linux or /dev/arcmsr0 on
FreeBSD) must be listed, along with the \*(Aq\-d areca,N\*(Aq Directive
(see below).
The individual SATA disks hosted by the Areca controller appear to \fBsmartd\fP
@@ -391,26 +390,26 @@ Specifies the type of the device.
The valid arguments to this directive are:
.Sp
.I auto
-\- attempt to guess the device type from the device name or from
+\(en attempt to guess the device type from the device name or from
controller type info provided by the operating system or from
a matching USB ID entry in the drive database.
This is the default.
.Sp
.I ata
-\- the device type is ATA. This prevents
+\(en the device type is ATA. This prevents
\fBsmartd\fP
from issuing SCSI commands to an ATA device.
.Sp
.\" %IF NOT OS Darwin
.I scsi
-\- the device type is SCSI. This prevents
+\(en the device type is SCSI. This prevents
\fBsmartd\fP
from issuing ATA commands to a SCSI device.
.Sp
.\" %ENDIF NOT OS Darwin
.\" %IF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.I nvme[,NSID]
-\- the device type is NVM Express (NVMe).
+\(en the device type is NVM Express (NVMe).
The optional parameter NSID specifies the namespace id (in hex) passed
to the driver.
Use 0xffffffff for the broadcast namespace id.
@@ -419,7 +418,7 @@ The default for NSID is the namespace id
.\" %ENDIF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.\" %IF NOT OS Darwin
.I sat[,auto][,N]
-\- the device type is SCSI to ATA Translation (SAT).
+\(en the device type is SCSI to ATA Translation (SAT).
This is for ATA disks that have a SCSI to ATA Translation Layer (SATL)
between the disk and the operating system.
SAT defines two ATA PASS THROUGH SCSI commands, one 12 bytes long and
@@ -431,14 +430,14 @@ is only used if the SCSI INQUIRY data re
Otherwise device type SCSI (for SCSI/SAS disks) is used.
.Sp
.I usbcypress
-\- this device type is for ATA disks that are behind a Cypress USB to PATA
+\(en this device type is for ATA disks that are behind a Cypress USB to PATA
bridge. This will use the ATACB proprietary scsi pass through command.
The default SCSI operation code is 0x24, but although it can be overridden
with \*(Aq\-d usbcypress,0xN\*(Aq, where N is the scsi operation code,
you're running the risk of damage to the device or filesystems on it.
.Sp
.I usbjmicron[,p][,x][,PORT]
-\- this device type is for SATA disks that are behind a JMicron USB to
+\(en this device type is for SATA disks that are behind a JMicron USB to
PATA/SATA bridge.
The 48-bit ATA commands (required e.g.\& for \*(Aq\-l xerror\*(Aq, see below)
do not work with all of these bridges and are therefore disabled by default.
@@ -460,40 +459,40 @@ Newer Prolific firmware requires a modif
Note that this does not yet support the SMART status command.
.Sp
.I usbprolific
-\- this device type is for SATA disks that are behind a Prolific
+\(en this device type is for SATA disks that are behind a Prolific
PL2571/2771/2773/2775 USB to SATA bridge.
.Sp
.I usbsunplus
-\- this device type is for SATA disks that are behind a SunplusIT USB to SATA
+\(en this device type is for SATA disks that are behind a SunplusIT USB to SATA
bridge.
.Sp
.I sntasmedia
-\- [NEW EXPERIMENTAL SMARTD FEATURE]
+\(en [NEW EXPERIMENTAL SMARTD FEATURE]
this device type is for NVMe disks that are behind an ASMedia USB to NVMe
bridge.
.Sp
.I sntjmicron[,NSID]
-\- this device type is for NVMe disks that are behind a JMicron USB to NVMe
+\(en this device type is for NVMe disks that are behind a JMicron USB to NVMe
bridge.
The optional parameter NSID specifies the namespace id (in hex) passed
to the driver.
The default namespace id is the broadcast namespace id (0xffffffff).
.Sp
.I sntrealtek
-\- [NEW EXPERIMENTAL SMARTD FEATURE]
+\(en [NEW EXPERIMENTAL SMARTD FEATURE]
this device type is for NVMe disks that are behind a Realtek USB to NVMe
bridge.
.Sp
.\" %ENDIF NOT OS Darwin
.\" %IF OS Linux
.I marvell
-\- [Linux only] interact with SATA disks behind Marvell chip-set
+\(en [Linux only] interact with SATA disks behind Marvell chip-set
controllers (using the Marvell rather than libata driver).
.Sp
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS FreeBSD Linux
.I megaraid,N
-\- [Linux and FreeBSD only] the device consists of one or more SCSI/SAS disks
connected
+\(en [Linux and FreeBSD only] the device consists of one or more SCSI/SAS
disks connected
to a MegaRAID controller. The non-negative integer N (in the range of 0 to
127 inclusive) denotes which disk on the controller is monitored.
This interface will also work for Dell PERC controllers.
@@ -505,7 +504,7 @@ Please see the \fBsmartctl\fP(8) man pag
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS Linux Windows Cygwin
.I aacraid,H,L,ID
-\- [Linux, Windows and Cygwin only] the device consists of one or more
+\(en [Linux, Windows and Cygwin only] the device consists of one or more
SCSI/SAS or SATA disks connected to an AacRaid controller.
The non-negative integers H,L,ID (Host number, Lun, ID) denote which disk
on the controller is monitored.
@@ -516,7 +515,7 @@ Please see the \fBsmartctl\fP(8) man pag
.\" %ENDIF OS Linux Windows Cygwin
.\" %IF OS FreeBSD Linux
.I 3ware,N
-\- [FreeBSD and Linux only] the device consists of one or more ATA disks
+\(en [FreeBSD and Linux only] the device consists of one or more ATA disks
connected to a 3ware RAID controller. The non-negative integer N
(in the range from 0 to 127 inclusive) denotes which disk on the controller
is monitored.
@@ -532,7 +531,7 @@ Please see the \fBsmartctl\fP(8) man pag
.\" %ENDIF OS FreeBSD Linux
.\" %IF OS FreeBSD Linux Windows Cygwin
.I areca,N
-\- [FreeBSD, Linux, Windows and Cygwin only] the device consists of one or
+\(en [FreeBSD, Linux, Windows and Cygwin only] the device consists of one or
more SATA disks connected to an Areca SATA RAID controller.
The positive integer N (in the range from 1 to 24 inclusive) denotes which
disk on the controller is monitored.
@@ -541,7 +540,7 @@ areca_disk_XX with XX in the range from
Please see the \fBsmartctl\fP(8) man page for further details.
.Sp
.I areca,N/E
-\- [FreeBSD, Linux, Windows and Cygwin only] the device consists of one
+\(en [FreeBSD, Linux, Windows and Cygwin only] the device consists of one
or more SATA or SAS disks connected to an Areca SAS RAID controller.
The integer N (range 1 to 128) denotes the channel (slot) and E (range
1 to 8) denotes the enclosure.
@@ -550,7 +549,7 @@ Important: This requires Areca SAS contr
.\" %ENDIF OS FreeBSD Linux Windows Cygwin
.\" %IF OS FreeBSD Linux
.I cciss,N
-\- [FreeBSD and Linux only] the device consists of one or more SCSI/SAS or
+\(en [FreeBSD and Linux only] the device consists of one or more SCSI/SAS or
SATA disks connected to a cciss RAID controller.
The non-negative integer N (in the range from 0 to 15 inclusive) denotes
which disk on the controller is monitored.
@@ -559,7 +558,7 @@ with XX in the range from 00 to 15 inclu
Please see the \fBsmartctl\fP(8) man page for further details.
.Sp
.I hpt,L/M/N
-\- [FreeBSD and Linux only] the device consists of one or more ATA disks
+\(en [FreeBSD and Linux only] 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
@@ -573,13 +572,13 @@ Please see the \fBsmartctl\fP(8) man pag
.Sp
.\" %ENDIF OS FreeBSD Linux
.I intelliprop,N[+TYPE]
-\- the device consists of multiple ATA disks connected to an Intelliprop
+\(en the device consists of multiple ATA disks connected to an Intelliprop
controller.
The integer N is the port number from 0 to 3 of the ATA drive to be targeted.
Please see the \fBsmartctl\fP(8) man page for further details.
.Sp
.I jmb39x[\-q],N[,sLBA][,force][+TYPE]
-\- [NEW EXPERIMENTAL SMARTD FEATURE]
+\(en [NEW EXPERIMENTAL SMARTD FEATURE]
the device consists of multiple SATA disks connected to a JMicron JMB39x RAID
port multiplier.
The suffix \*(Aq\-q\*(Aq selects a slightly different command variant used by
@@ -588,13 +587,13 @@ The integer N is the port number from 0
Please see the \fBsmartctl\fP(8) man page for further details.
.Sp
.I jms56x,N[,sLBA][,force][+TYPE]
-\- [NEW EXPERIMENTAL SMARTD FEATURE]
+\(en [NEW EXPERIMENTAL SMARTD FEATURE]
the device consists of multiple SATA disks connected to a JMicron JMS56x
USB to SATA RAID bridge.
See \*(Aqjmb39x...\*(Aq above for valid arguments.
.Sp
.I ignore
-\- the device specified by this configuration entry should be ignored.
+\(en the device specified by this configuration entry should be ignored.
This allows one to ignore specific devices which are detected by a following
DEVICESCAN configuration line.
It may also be used to temporary disable longer multi-line configuration
entries.
@@ -602,7 +601,7 @@ This Directive may be used in conjunctio
Directives.
.Sp
.I removable
-\- the device or its media is removable. This indicates to
+\(en the device or its media is removable. This indicates to
\fBsmartd\fP
that it should continue (instead of exiting, which is the default
behavior) if the device does not appear to be present when
@@ -643,22 +642,22 @@ by periodic \fBsmartd\fP polling. The a
are:
.Sp
.I never
-\- \fBsmartd\fP will poll (check) the device regardless of its power
+\(en \fBsmartd\fP will poll (check) the device regardless of its power
mode. This may cause a disk which is spun-down to be spun-up when
-\fBsmartd\fP checks it. This is the default behavior if the '\-n'
+\fBsmartd\fP checks it. This is the default behavior if the \&'\-n'
Directive is not given.
.Sp
.I sleep
-\- check the device unless it is in SLEEP mode.
+\(en check the device unless it is in SLEEP mode.
.Sp
.I standby
-\- check the device unless it is in SLEEP or STANDBY mode. In
+\(en check the device unless it is in SLEEP or STANDBY mode. In
these modes most disks are not spinning, so if you want to prevent
a laptop disk from spinning up each time that \fBsmartd\fP polls,
this is probably what you want.
.Sp
.I idle
-\- check the device unless it is in SLEEP, STANDBY or IDLE mode.
+\(en check the device unless it is in SLEEP, STANDBY or IDLE mode.
In the IDLE state, most disks are still spinning, so this is probably
not what you want.
.Sp
@@ -682,11 +681,11 @@ should be of SMART command failures. Th
Directive are:
.Sp
.I normal
-\- do not try to monitor the disk if a mandatory SMART command fails, but
+\(en 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.
.Sp
.I permissive
-\- try to monitor the disk even if it appears to lack SMART
+\(en 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.
@@ -735,17 +734,17 @@ Reports increases in the number of error
valid arguments to this Directive are:
.Sp
.I error
-\- [ATA] report if the number of ATA errors reported in the Summary SMART
+\(en [ATA] report if the number of ATA errors reported in the Summary SMART
error log has increased since the last check.
.Sp
.\" %IF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.I error
-\- [NVMe] report if the "Number of Error Information Log Entries" from the
+\(en [NVMe] report if the "Number of Error Information Log Entries" from the
SMART/Health Information log has increased since the last check.
.Sp
.\" %ENDIF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.I xerror
-\- [ATA] report if the number of ATA errors reported in the Extended
+\(en [ATA] report if the number of ATA errors reported in the Extended
Comprehensive SMART error log has increased since the last check.
.Sp
If both \*(Aq\-l error\*(Aq and \*(Aq\-l xerror\*(Aq are specified, smartd
@@ -755,11 +754,11 @@ checks the maximum of both values.
.Sp
.\" %IF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.I xerror
-\- [NVMe] same as \*(Aq\-l error\*(Aq.
+\(en [NVMe] same as \*(Aq\-l error\*(Aq.
.\" %ENDIF OS Darwin FreeBSD Linux NetBSD Windows Cygwin
.Sp
.I selftest
-\- report if the number of failed tests reported in the SMART
+\(en report if the number of failed tests reported in the SMART
Self-Test Log has increased since the last check, or if the timestamp
associated with the most recent failed test has increased. Note that
such errors will \fBonly\fP be logged if you run self-tests on the
@@ -778,13 +777,13 @@ number of failed self tests dropped to 0
an extended self-test is run after all bad sectors have been reallocated.
.Sp
.I offlinests[,ns]
-\- [ATA only] report if the Offline Data Collection status has changed
+\(en [ATA only] report if the Offline Data Collection status has changed
since the last check. The report will be logged as LOG_CRIT if the new
status indicates an error. With some drives the status often changes,
therefore \*(Aq\-l offlinests\*(Aq is not enabled by \*(Aq\-a\*(Aq Directive.
.\" %IF NOT OS Cygwin Windows
-Appending ',ns' (no standby) to this directive is not implemented \"#
-on Linux. \"#
+Appending \&',ns' (no standby) to this directive is not implemented\"#
+on Linux.\"#
.\" %ENDIF NOT OS Cygwin Windows
.\"# .\" %IF OS Cygwin Windows
.\"# .Sp
@@ -794,12 +793,12 @@ on Linux. \"#
.\"# .\" %ENDIF OS Cygwin Windows
.Sp
.I selfteststs[,ns]
-\- [ATA only] report if the Self-Test execution status has changed
+\(en [ATA only] report if the Self-Test execution status has changed
since the last check. The report will be logged as LOG_CRIT if the new
status indicates an error.
.\" %IF NOT OS Cygwin Windows
-Appending ',ns' (no standby) to this directive is not implemented \"#
-on Linux. \"#
+Appending \&',ns' (no standby) to this directive is not implemented\"#
+on Linux.\"#
.\" %ENDIF NOT OS Cygwin Windows
.\"# .\" %IF OS Cygwin Windows
.\"# .Sp
@@ -813,7 +812,7 @@ on Linux. \"#
.\"# .\" %ENDIF OS Cygwin Windows
.Sp
.I scterc,READTIME,WRITETIME
-\- [ATA only] sets the SCT Error Recovery Control settings to the specified
+\(en [ATA only] sets the SCT Error Recovery Control settings to the specified
values (deciseconds) when \fBsmartd\fP starts up and has no further effect.
Values of 0 disable the feature, other values less than 65 are probably
not supported. For RAID configurations, this is typically set to
@@ -827,26 +826,26 @@ further effect.
Valid arguments are:
.Sp
.I aam,[N|off]
-\- [ATA only] Sets the Automatic Acoustic Management (AAM) feature.
+\(en [ATA only] Sets the Automatic Acoustic Management (AAM) feature.
.Sp
.I apm,[N|off]
-\- [ATA only] Sets the Advanced Power Management (APM) feature.
+\(en [ATA only] Sets the Advanced Power Management (APM) feature.
.Sp
.I lookahead,[on|off]
-\- [ATA only] Sets the read look-ahead feature.
+\(en [ATA only] Sets the read look-ahead feature.
.Sp
.I security-freeze
-\- [ATA only] Sets ATA Security feature to frozen mode.
+\(en [ATA only] Sets ATA Security feature to frozen mode.
.Sp
.I standby,[N|off]
-\- [ATA only] Sets the standby (spindown) timer and places the drive in the
+\(en [ATA only] Sets the standby (spindown) timer and places the drive in the
IDLE mode.
.Sp
.I wcache,[on|off]
-\- [ATA only] Sets the volatile write cache feature.
+\(en [ATA only] Sets the volatile write cache feature.
.Sp
.I dsn,[on|off]
-\- [ATA only] Sets the DSN feature.
+\(en [ATA only] Sets the DSN feature.
.TP
.B \-s REGEXP
Run Self-Tests or Offline Immediate Tests, at scheduled times. A
@@ -931,11 +930,11 @@ To enable staggered tests with delays in
\fB \-s L/../../7/04:003\fP
.br
To enable staggered tests with delays 0, 3, 6, 9, 1, 4, 7, 10, 2, 5, 8,
-0, ... hours, use:
+0, \&...\& hours, use:
.br
\fB \-s L/../../7/04:003-010\fP
.br
-To enable staggered tests with delays 0, 1, 2, ..., 9, 10, 0, ... hours,
+To enable staggered tests with delays 0, 1, 2, \&..., 9, 10, 0, \&...\& hours,
use:
.br
\fB \-s L/../../7/04:001-010\fP
@@ -961,12 +960,12 @@ a full disk test can be performed by sev
To setup a full test of a 1 TB disk within 20 days (one 50 GB span
each day), run this command once:
.nf
- smartctl \-t select,0\-99999999 /dev/sda
+ smartctl \-t select,0\(en99999999 /dev/sda
.fi
To run the next test spans on Monday\(enFriday between 12\(en13 am, run smartd
with this directive:
.br
-\fB \-s n/../../[1\-5]/12\fP
+\fB \-s n/../../[1\(en5]/12\fP
.Sp
Scheduled tests are run immediately following the regularly-scheduled
device polling, if the current local date, time, and test type, match
@@ -1077,7 +1076,8 @@ If a word of the comma separated list ha
script /etc/smartmontools/smartd_warning.d/plugin is run and the word is
removed from the list before sending mail. The string \*(Aqplugin\*(Aq may
be any valid name except \*(AqALL\*(Aq.
-If \*(Aq@ALL\*(Aq is specified, all scripts in
/etc/smartmontools/smartd_warning.d/*
+If \*(Aq@ALL\*(Aq is specified,
+all scripts in /etc/smartmontools/smartd_warning.d/*
are run instead.
This is handled by the script /usr/share/smartmontools/smartd_warning.sh
(see also \*(Aq\-M exec\*(Aq below).
@@ -1114,16 +1114,16 @@ The valid arguments to the \-M Directive
three):
.Sp
.I once
-\- send only one warning email for each type of disk problem detected. This
+\(en send only one warning email for each type of disk problem detected. This
is the default unless state persistence (\*(Aq\-s\*(Aq option) is enabled.
.Sp
.I daily
-\- send additional warning reminder emails, once per day, for each type
+\(en send additional warning reminder emails, once per day, for each type
of disk problem detected. This is the default if state persistence
(\*(Aq\-s\*(Aq option) is enabled.
.Sp
.I diminishing
-\- send additional warning reminder emails, after a one-day interval,
+\(en 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.
@@ -1134,7 +1134,7 @@ reset. If the problem reappears a new w
In addition, one may add zero or more of the following Directives:
.Sp
.I test
-\- send a single test email
+\(en send a single test email
immediately upon
\fBsmartd\fP
startup. This allows one to verify that email is delivered correctly.
@@ -1144,7 +1144,7 @@ will also send the normal email warnings
\*(Aq\-m\*(Aq Directive, in addition to the single test email!
.Sp
.I exec PATH
-\- run the executable PATH instead of the default mail command, when
+\(en run the executable PATH instead of the default mail command, when
\fBsmartd\fP
needs to send email. PATH must point to an executable binary file or
script.
@@ -1573,17 +1573,17 @@ known and understood device firmware bug
multiple times. The valid arguments are:
.Sp
.I none
-\- Assume that the device firmware obeys the ATA specifications. This
+\(en Assume that the device firmware obeys the ATA specifications. This
is the default, unless the device has presets for \*(Aq\-F\*(Aq in the
drive database. Using this directive will override any preset values.
.Sp
.I nologdir
-\- Suppresses read attempts of SMART or GP Log Directory.
+\(en Suppresses read attempts of SMART or GP Log Directory.
Support for all standard logs is assumed without an actual check.
Some Intel SSDs may freeze if log address 0 is read.
.Sp
.I samsung
-\- In some Samsung disks (example: model SV4012H Firmware Version:
+\(en In some Samsung disks (example: model SV4012H Firmware Version:
RM100-08) some of the two- and four-byte quantities in the SMART data
structures are byte-swapped (relative to the ATA specification).
Enabling this option tells \fBsmartd\fP to evaluate these quantities
@@ -1593,18 +1593,18 @@ are (1) no self-test log printed, even t
(3) strange and impossible values for the ATA error log timestamps.
.Sp
.I samsung2
-\- In some Samsung disks the number of ATA errors reported is byte swapped.
+\(en In some Samsung disks the number of ATA errors reported is byte swapped.
Enabling this option tells \fBsmartd\fP to evaluate this quantity in
byte-reversed order.
.Sp
.I samsung3
-\- Some Samsung disks (at least SP2514N with Firmware VF100-37) report
+\(en Some Samsung disks (at least SP2514N with Firmware VF100-37) report
a self-test still in progress with 0% remaining when the test was already
completed. If this directive is specified, \fBsmartd\fP will not skip the
next scheduled self-test (see Directive \*(Aq\-s\*(Aq above) in this case.
.Sp
.I xerrorlba
-\- This only affects \fBsmartctl\fP.
+\(en This only affects \fBsmartctl\fP.
.Sp
[Please see the \fBsmartctl \-F\fP command-line option.]
.TP
@@ -1617,12 +1617,12 @@ Please see \fBsmartctl \-v\fP command-li
The following arguments affect smartd warning output:
.Sp
.I 197,increasing
-\- Raw Attribute number 197 (Current Pending Sector Count) is not
+\(en Raw Attribute number 197 (Current Pending Sector Count) is not
reset if uncorrectable sectors are reallocated. This sets \*(Aq\-C 197+\*(Aq
if no other \*(Aq\-C\*(Aq directive is specified.
.Sp
.I 198,increasing
-\- Raw Attribute number 198 (Offline Uncorrectable Sector Count) is not
+\(en Raw Attribute number 198 (Offline Uncorrectable Sector Count) is not
reset if uncorrectable sectors are reallocated. This sets \*(Aq\-U 198+\*(Aq
if no other \*(Aq\-U\*(Aq directive is specified.
.TP
@@ -1632,16 +1632,16 @@ that are available for this drive.
The valid arguments to this Directive are:
.Sp
.I use
-\- use any presets that are available for this drive. This is the default.
+\(en use any presets that are available for this drive. This is the default.
.Sp
.I ignore
-\- do not use any presets for this drive.
+\(en do not use any presets for this drive.
.Sp
.I show
-\- show the presets listed for this drive in the database.
+\(en show the presets listed for this drive in the database.
.Sp
.I showall
-\- show the presets that are available for all drives and then exit.
+\(en show the presets that are available for all drives and then exit.
.Sp
[Please see the
.B smartctl \-P
