Skip to content
Snippets Groups Projects
Commit 052af61b authored by ballen4705's avatar ballen4705
Browse files

Minor improvements and a couple of typo fixes. 

git-svn-id: https://smartmontools.svn.sourceforge.net/svnroot/smartmontools/trunk@398 4ea69e1a-61f1-4043-bf83-b5c94c648137
parent 92502477
No related branches found
No related tags found
No related merge requests found
Show whitespace changes
Inline Side-by-side
Showing
with 62 additions and 35 deletions
sm5/smartctl.8
+ 62
− 35
View file @ 052af61b
\# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net> \# Copyright (C) 2002 Bruce Allen <smartmontools-support@lists.sourceforge.net>
\# \#
\# $Id: smartctl.8,v 1.31 2003/01/01 08:21:00 ballen4705 Exp $ \# $Id: smartctl.8,v 1.32 2003/01/03 06:19:55 ballen4705 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 SMARTCTL 8 "$Date: 2003/01/01 08:21:00 $" "smartmontools-5.0" .TH SMARTCTL 8 "$Date: 2003/01/03 06:19:55 $" "smartmontools-5.0"
.SH NAME .SH NAME
smartctl \- S.M.A.R.T. control and monitor utility smartctl \- S.M.A.R.T. control and monitor utility
.SH SYNOPSIS .SH SYNOPSIS
...@@ -37,7 +37,8 @@ is a command line utility designed to perform S.M.A.R.T. tasks such as ...@@ -37,7 +37,8 @@ is a command line utility designed to perform S.M.A.R.T. tasks such as
printing the S.M.A.R.T. self-test and error logs, and enabling and printing the S.M.A.R.T. self-test and error logs, and enabling and
disabling S.M.A.R.T. automatic testing. Note: if the user issues a disabling S.M.A.R.T. automatic testing. Note: if the user issues a
S.M.A.R.T. command that is (apparently) not implemented by the device, S.M.A.R.T. command that is (apparently) not implemented by the device,
we print a warning message but issue the command anyway. This should .B smartctl
will print a warning message but issue the command anyway. This should
not cause problems: unimplemented S.M.A.R.T. commands issued to a not cause problems: unimplemented S.M.A.R.T. commands issued to a
drive are ignored and return an error. drive are ignored and return an error.
...@@ -45,7 +46,7 @@ drive are ignored and return an error. ...@@ -45,7 +46,7 @@ drive are ignored and return an error.
also provides limited TapeAlerts support for some SCSI tape drives and also provides limited TapeAlerts support for some SCSI tape drives and
changers. changers.
The user must specify the device to be controlled or interrogated as an The user must specify the device to be controlled or interrogated as the final
argument to argument to
.B smartctl. .B smartctl.
ATA devices use the form "/dev/hd*" and SCSI devices use the form "/dev/sd*". ATA devices use the form "/dev/hd*" and SCSI devices use the form "/dev/sd*".
...@@ -55,14 +56,22 @@ For SCSI Tape Drives and Changers with TapeAlerts support use the devices ...@@ -55,14 +56,22 @@ For SCSI Tape Drives and Changers with TapeAlerts support use the devices
will attempt to guess the device type, but the '\-d' option can be used to will attempt to guess the device type, but the '\-d' option can be used to
specify a device type of ATA or SCSI if required. specify a device type of ATA or SCSI if required.
Note that the printed output of
.B smartctl
displays most numerical values in base 10 (decimal), but some values
are displayed in base 16 (hexidecimal). To distinguish them, the base
16 values are always displayed with a leading
.B "0x"
for example: "0xff". This convention is also followed in this man
page.
.PP .PP
.SH OPTIONS .SH OPTIONS
.PP .PP
The options are grouped below into several categories. The options are grouped below into several categories.
.B smartctl .B smartctl
will execute these in the order: INFORMATION, ENABLE/DISABLE, DISPLAY will execute the corresponding commands in the order: INFORMATION,
DATA, RUN/ABORT TESTS. ENABLE/DISABLE, DISPLAY DATA, RUN/ABORT TESTS.
SCSI devices only accept the options SCSI devices only accept the options
.B \-h, \-?, \-V, \-i, \-a, \-d, \-s, \-H, \-t, \-C .B \-h, \-?, \-V, \-i, \-a, \-d, \-s, \-H, \-t, \-C
...@@ -74,7 +83,7 @@ and ...@@ -74,7 +83,7 @@ and
.B \-H. .B \-H.
Long options are not supported on all systems. Use Long options are not supported on all systems. Use
.B 'smartd \-h' .B 'smartctl \-h'
to see the available options. to see the available options.
.TP .TP
...@@ -308,35 +317,52 @@ by this option. ...@@ -308,35 +317,52 @@ by this option.
Prints only the vendor specific S.M.A.R.T. attributes. The Prints only the vendor specific S.M.A.R.T. attributes. The
attributes are numbered from 1 to 253 and have specific names. For attributes are numbered from 1 to 253 and have specific names. For
example attribute 12 is 'power cycle count': how many times has the example attribute 12 is 'power cycle count': how many times has the
disk been powered up. Each attribute has a 'Raw' value, printed under disk been powered up.
the heading 'Raw Value', and a 'Normalized' value printed under the
heading 'Value'. [Note: Each attribute has a 'Raw' value, printed under the heading 'RAW_VALUE',
and a 'Normalized' value printed under the heading 'VALUE'. [Note:
.B smartctl .B smartctl
prints these values in base-10.] prints these values in base-10.]
Each vendor uses their own magic to convert the Raw In the example just given, the 'Raw Value' for attribute 12 would be the actual
value to a Normalized value. If the Normalized value is number of times that the disk has been power-cycled, for example 365 if the disk
has been turned on once per day for exactly one year.
Each vendor uses their own magic to convert this Raw
value to a Normalized value in the range from 1 to 254.
Note that the conversion from 'Raw' value to a quantity with physical
units is not specified by the S.M.A.R.T. standard. In most cases, the
values printed by
.B smartctl
are sensible. For example the temperature attribute generally has its
raw value equal to the temperature in Celsius. However in some cases
vendors use unusual conventions. For example the Hitachi disk on my
laptop reports its power-on hours in minutes, not hours. Some IBM
disks track three temperatures rather than one, in their raw values.
And so on.
Each attribute also has a Threshold value (whose range is 0 to 255)
which is printed under the heading 'THRESH'. If the Normalized value
is
.B less than or equal to .B less than or equal to
the value given under the 'Threshold' column, then disk failure the Threshold value, then disk failure
is imminent. The column labeled 'Worst' shows the lowest (closest to is imminent.
failure) value that the disk has recorded at any time during its
lifetime when S.M.A.R.T. was enabled. Each attribute also has a 'Worst' value shown under the heading 'WORST'.
This is the smallest (closest to failure) value that the
disk has recorded at any time during its lifetime when S.M.A.R.T. was
enabled. [Note however that some vendors will have firmware which will
.B increase
the 'Worst' value for some "rate-type" attributes.]
Note that the conversion from 'Raw' value to physical units is not The attribute table printed out by
specified by the S.M.A.R.T. standard. In most cases, the values printed by
.B smartctl .B smartctl
are sensible. However in some cases a vendor uses unusual also shows the 'Type' of the attribute. Pre-failure attributes are
conventions. For example the Hitachi disk on my laptop reports its ones which, if less than or equal to their threshold values, indicate
power-on hours in minutes, not hours. Some IBM disks track three pending disk failure. Old age, or usage attributes, are ones which
temperatures rather than one, in their raw values. And so on. indicate end-of-product life from old-age or normal aging and wearout,
if the attribute value is less than or equal to the threshold.
The table printed out by this option also shows the 'Type' of the
attribute. Pre-failure attributes are ones which, if less than or If the attribute's current Normalized value is <= threshold, then the 'Ever
equal to their threshold values, indicate pending disk failure. Old
age, or usage attributes, are ones which indicate end-of-product life
from old-age or normal aging and wearout, if the attribute value is
less than or equal to the threshold.
If the attribute's current value is <= threshold, then the 'Ever
failed' column will display 'FAILED NOW!'. If not, but the worst failed' column will display 'FAILED NOW!'. If not, but the worst
recorded value is <= threshold, then this column will display 'In the recorded value is <= threshold, then this column will display 'In the
past'. past'.
...@@ -344,7 +370,7 @@ past'. ...@@ -344,7 +370,7 @@ past'.
Note that starting with ATA/ATAPI-4, revision 4, the meaning of these Note that starting with ATA/ATAPI-4, revision 4, the meaning of these
attribute fields has been made entirely vendor-specific. However most attribute fields has been made entirely vendor-specific. However most
ATA/ATAPI-5 disks seem to respect their meaning, so we have retained ATA/ATAPI-5 disks seem to respect their meaning, so we have retained
this option. the option of printing the attribute values.
.TP .TP
.B \-l TYPE, \-\-log=TYPE .B \-l TYPE, \-\-log=TYPE
Prints either the S.M.A.R.T. error log or the S.M.A.R.T. self-test log. The Prints either the S.M.A.R.T. error log or the S.M.A.R.T. self-test log. The
...@@ -381,7 +407,8 @@ one valid argument to this option: ...@@ -381,7 +407,8 @@ one valid argument to this option:
.I 9,minutes .I 9,minutes
\- the disk stores Raw Attribute number 9 (power on time) in \- the disk stores Raw Attribute number 9 (power on time) in
minutes rather than hours, so divide by 60 before displaying it. minutes rather than hours, so display it in the form 'X h + Y m',
where X is hours and Y is minutes.
.TP .TP
.B S.M.A.R.T. RUN/ABORT OFFLINE TEST AND SELF-TEST OPTIONS: .B S.M.A.R.T. RUN/ABORT OFFLINE TEST AND SELF-TEST OPTIONS:
...@@ -437,7 +464,7 @@ With '\-t short' or '\-t long', runs the self-test in captive mode. This has ...@@ -437,7 +464,7 @@ With '\-t short' or '\-t long', runs the self-test in captive mode. This has
no effect with '\-t offline' or if the '\-t' option is not used. no effect with '\-t offline' or if the '\-t' option is not used.
.B WARNING: Tests run in captive mode may busy out the drive for the length .B WARNING: Tests run in captive mode may busy out the drive for the length
.B of the test. Only run this on drives without any mounted partitions. .B of the test. Only run captive tests on drives without any mounted partitions!
.TP .TP
.B \-X, \-\-abort .B \-X, \-\-abort
...@@ -621,4 +648,4 @@ Please let us know if there is an on\-line source for this document. ...@@ -621,4 +648,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: smartctl.8,v 1.31 2003/01/01 08:21:00 ballen4705 Exp $ $Id: smartctl.8,v 1.32 2003/01/03 06:19:55 ballen4705 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