-h, --help, --usage
Prints a usage message to STDOUT and exits.
|
-V, --version, --copyright, --license
Prints version, copyright, license, home page and SVN revision information for your copy of
smartctl to STDOUT and then exits. Please include this information if you are reporting bugs or
problems.
|
-i, --info
Prints the device model number, serial number, firmware version, and ATA Standard version/revision
information. Says if the device supports SMART, and if so, whether SMART support is currently
enabled or disabled. If the device supports Logical Block Address mode (LBA mode) print current
user drive capacity in bytes. (If drive is has a user protected area reserved, or is "clipped",
this may be smaller than the potential maximum drive capacity.) Indicates if the drive is in the
smartmontools database (see ´-v´ options below). If so, the drive model family may also be
printed. If ´-n´ (see below) is specified, the power mode of the drive is printed.
|
-a, --all
Prints all SMART information about the disk, or TapeAlert information about the tape drive or
changer. For ATA devices this is equivalent to
´-H -i -c -A -l error -l selftest -l selective´
and for SCSI, this is equivalent to
´-H -i -A -l error -l selftest´.
Note that for ATA disks this does not enable the non-SMART options and the SMART options which
require support for 48-bit ATA commands.
|
-x, --xall
Prints all SMART and non-SMART information about the device. For ATA devices this is equivalent to
´-H -i -c -A -f brief -l xerror,error -l xselftest,selftest
-l selective -l directory -l scttemp -l scterc -l sataphy´.
and for SCSI, this is equivalent to
´-H -i -A -l error -l selftest -l background -l sasphy´.
|
--scan Scans for devices and prints each device name, device type and protocol ([ATA] or [SCSI]) info.
May be used in conjunction with ´-d TYPE´ to restrict the scan to a specific TYPE. See also info
about platform specific device scan and the DEVICESCAN directive on smartd(8) man page.
|
--scan-open
Same as --scan, but also tries to open each device before printing device info. The device open
may change the device type due to autodetection (see also ´-d test´).
|
-q TYPE, --quietmode=TYPE
Specifies that smartctl should run in one of the two quiet modes described here. The valid
arguments to this option are:
errorsonly - only print: For the ´-l error´ option, if nonzero, the number of errors recorded in
the SMART error log and the power-on time when they occurred; For the ´-l selftest´ option, errors
recorded in the device self-test log; For the ´-H´ option, SMART "disk failing" status or device
Attributes (pre-failure or usage) which failed either now or in the past; For the ´-A´ option,
device Attributes (pre-failure or usage) which failed either now or in the past.
silent - print no output. The only way to learn about what was found is to use the exit status of
smartctl (see RETURN VALUES below).
noserial - Do not print the serial number of the device.
|
-d TYPE, --device=TYPE
Specifies the type of the device. The valid arguments to this option are:
|
-T TYPE, --tolerance=TYPE
[ATA only] Specifies how tolerant smartctl should be of ATA and SMART command failures.
|
-b TYPE, --badsum=TYPE
[ATA only] Specifies the action smartctl should take if a checksum error is detected in the: (1)
Device Identity Structure, (2) SMART Self-Test Log Structure, (3) SMART Attribute Value Structure,
(4) SMART Attribute Threshold Structure, or (5) ATA Error Log Structure.
The valid arguments to this option are:
warn - report the incorrect checksum but carry on in spite of it. This is the default.
exit - exit smartctl.
ignore - continue silently without issuing a warning.
|
-r TYPE, --report=TYPE
Intended primarily to help smartmontools developers understand the behavior of smartmontools on
non-conforming or poorly conforming hardware. This option reports details of smartctl
transactions with the device. The option can be used multiple times. When used just once, it
shows a record of the ioctl() transactions with the device. When used more than once, the detail
of these ioctl() transactions are reported in greater detail. The valid arguments to this option
are:
|
-n POWERMODE, --nocheck=POWERMODE
[ATA only] Specifies if smartctl should exit before performing any checks when the device is in a
low-power mode. It may be used to prevent a disk from being spun-up by smartctl. The power mode is
ignored by default. A nonzero exit status is returned if the device is in one of the specified
low-power modes (see RETURN VALUES below).
|
-s VALUE, --smart=VALUE
Enables or disables SMART on device. The valid arguments to this option are on and off. Note
that the command ´-s on´ (perhaps used with with the ´-o on´ and ´-S on´ options) should be placed
in a start-up script for your machine, for example in rc.local or rc.sysinit. In principle the
SMART feature settings are preserved over power-cycling, but it doesn´t hurt to be sure. It is not
necessary (or useful) to enable SMART to see the TapeAlert messages.
|
-o VALUE, --offlineauto=VALUE
[ATA only] Enables or disables SMART automatic offline test, which scans the drive every four
hours for disk defects. This command can be given during normal system operation. The valid
arguments to this option are on and off.
|
-S VALUE, --saveauto=VALUE
[ATA] Enables or disables SMART autosave of device vendor-specific Attributes. The valid arguments
to this option are on and off. Note that this feature is preserved across disk power cycles, so
you should only need to issue it once.
|
-H, --health
Check: Ask the device to report its SMART health status or pending TapeAlert messages. SMART
status is based on information that it has gathered from online and offline tests, which were used
to determine/update its SMART vendor-specific Attribute values. TapeAlert status is obtained by
reading the TapeAlert log page.
If the device reports failing health status, this means either that the device has already failed,
or that it is predicting its own failure within the next 24 hours. If this happens, use the ´-a´
option to get more information, and get your data off the disk and to someplace safe as soon as
you can.
|
-c, --capabilities
[ATA only] Prints only the generic SMART capabilities. These show what SMART features are
implemented and how the device will respond to some of the different SMART commands. For example
it shows if the device logs errors, if it supports offline surface scanning, and so on. If the
device can carry out self-tests, this option also shows the estimated time required to run those
tests.
Note that the time required to run the Self-tests (listed in minutes) are fixed. However the time
required to run the Immediate Offline Test (listed in seconds) is variable. This means that if
you issue a command to perform an Immediate Offline test with the ´-t offline´ option, then the
time may jump to a larger value and then count down as the Immediate Offline Test is carried out.
Please see REFERENCES below for further information about the the flags and capabilities described
by this option.
|
-A, --attributes
[ATA] Prints only the vendor specific SMART Attributes. The Attributes are numbered from 1 to 253
and have specific names and ID numbers. For example Attribute 12 is "power cycle count": how many
times has the disk been powered up.
|
-f FORMAT, --format=FORMAT
[ATA only] Selects the output format of the attributes to one of:
old - Old smartctl format. This is the default unless the ´-x´ option is specified.
brief - New format which fits into 80 colums (except in some rare cases). This format also
decodes four additional attribute flags. This is the default if the '-x´ option is specified.
|
-l TYPE, --log=TYPE
Prints either the SMART Error Log, the SMART Self-Test Log, the SMART Selective Self-Test Log [ATA
only], the Log Directory [ATA only], or the Background Scan Results Log [SCSI only]. The valid
arguments to this option are:
|
-v ID,FORMAT[:BYTEORDER][,NAME], --vendorattribute=ID,FORMAT[:BYTEORDER][,NAME]
[ATA only] Sets a vendor-specific raw value print FORMAT, an optional BYTEORDER and an optional
NAME for Attribute ID. This option may be used multiple times.
|
-F TYPE, --firmwarebug=TYPE
[ATA only] Modifies the behavior of smartctl to compensate for some known and understood device
firmware or driver bug. Except ´swapid´, the arguments to this option are exclusive, so that only
the final option given is used. The valid values are:
|
-P TYPE, --presets=TYPE
[ATA only] Specifies whether smartctl should use any preset options that are available for this
drive. By default, if the drive is recognized in the smartmontools database, then the presets are
used.
|
-B [+]FILE, --drivedb=[+]FILE
[ATA only] Read the drive database from FILE. The new database replaces the built in database by
default. If ´+´ is specified, then the new entries prepend the built in entries.
|
-t TEST, --test=TEST
Executes TEST immediately. The ´-C´ option can be used in conjunction with this option to run the
short or long (and also for ATA devices, selective or conveyance) self-tests in captive mode
(known as "foreground mode" for SCSI devices). Note that only one test type can be run at a time,
so only one test type should be specified per command line. Note also that if a computer is
shutdown or power cycled during a self-test, no harm should result. The self-test will either be
aborted or will resume automatically.
|
-C, --captive
[ATA] Runs self-tests in captive mode. This has no effect with ´-t offline´ or if the ´-t´ option
is not used.
WARNING: Tests run in captive mode may busy out the drive for the length of the test. Only run
captive tests on drives without any mounted partitions!
[SCSI] Runs the self-test in "Foreground" mode.
|
-X, --abort
Aborts non-captive SMART Self Tests. Note that this command will abort the Offline Immediate Test
routine only if your disk has the "Abort Offline collection upon new command" capability.
|