OS Manuals

/usr/bin/smartctl

Control and monitor S.M.A.R.T. enabled hard drives

From smartmontools 7.5-r4 (os), captured 2026-11-05 by running smartctl --help (exit 0). permalink

smartctl 7.5 (build date Aug 31 2026) [x86_64-linux-6.18.60-r0-gcp-6.18] (local build)
Copyright (C) 2002-25, Bruce Allen, Christian Franke, www.smartmontools.org

Usage: smartctl [options] device

============================================ SHOW INFORMATION OPTIONS =====

  -h, --help, --usage
         Display this help and exit

  -V, --version, --copyright, --license
         Print license, copyright, and version information and exit

  -i, --info
         Show identity information for device

  --identify[=[w][nvb]]
         Show words and bits from IDENTIFY DEVICE data                (ATA)

  -g NAME, --get=NAME
        Get device setting: all, aam, apm, dsn, lookahead, security,
        wcache, rcache, wcreorder, wcache-sct

  -a, --all
         Show all SMART information for device

  -x, --xall
         Show all information for device

  --scan
         Scan for devices

  --scan-open
         Scan for devices and try to open each device

================================== SMARTCTL RUN-TIME BEHAVIOR OPTIONS =====

  -j, --json[=cgiosuvy]
         Print output in JSON or YAML format

  -q TYPE, --quietmode=TYPE                                           (ATA)
         Set smartctl quiet mode to one of: errorsonly, silent, noserial

  -d TYPE, --device=TYPE
         Specify device type to one of:
         ata, scsi[+TYPE], nvme[,NSID], sat[,auto][,N][+TYPE], usbasm1352r,N, usbcypress[,X], usbjmicron[,p][,x][,N], usbprolific, usbsunplus[/sat], sntasmedia[/sat], sntjmicron[,NSID][/sat], sntrealtek[/sat], jmb39x[-q[2]],N[,sLBA][,force][+TYPE], jms56x,N[,sLBA][,force][+TYPE], areca,N/E, 3ware,N, hpt,L/M/N, megaraid,N, aacraid,H,L,ID, sssraid,E,S, cciss,N, auto, test

  -T TYPE, --tolerance=TYPE                                           (ATA)
         Tolerance: normal, conservative, permissive, verypermissive

  -b TYPE, --badsum=TYPE                                              (ATA)
         Set action on bad checksum to one of: warn, exit, ignore

  -r TYPE, --report=TYPE
         Report transactions (see man page)

  -n MODE[,STATUS[,STATUS2]], --nocheck=MODE[,STATUS[,STATUS2]] (ATA, SCSI)
         No check if: never, sleep, standby, idle (see man page)

============================== DEVICE FEATURE ENABLE/DISABLE COMMANDS =====

  -s VALUE, --smart=VALUE
        Enable/disable SMART on device (on/off)

  -o VALUE, --offlineauto=VALUE                                       (ATA)
        Enable/disable automatic offline testing on device (on/off)

  -S VALUE, --saveauto=VALUE                                          (ATA)
        Enable/disable Attribute autosave on device (on/off)

  -s NAME[,VALUE], --set=NAME[,VALUE]
        Enable/disable/change device setting: aam,[N|off], apm,[N|off],
        dsn,[on|off], lookahead,[on|off], security-freeze,
        standby,[N|off|now], wcache,[on|off], rcache,[on|off],
        wcreorder,[on|off[,p]], wcache-sct,[ata|on|off[,p]]

======================================= READ AND DISPLAY DATA OPTIONS =====

  -H, --health
        Show device SMART health status

  -c, --capabilities                                            (ATA, NVMe)
        Show device SMART capabilities

  -A, --attributes
        Show device SMART vendor-specific Attributes and values

  -f FORMAT, --format=FORMAT                                          (ATA)
        Set output format for attributes: old, brief, hex[,id|val]

  -l TYPE, --log=TYPE
        Show device log. TYPE: error, selftest, selective, directory[,g|s],
        xerror[,N][,error], xselftest[,N][,selftest], background,
        sasphy[,reset], sataphy[,reset], scttemp[sts,hist],
        scttempint,N[,p], scterc[,N,M][,p|reset], devstat[,N], defects[,N],
        ssd, gplog,N[,RANGE], smartlog,N[,RANGE], nvmelog,N,SIZE
        tapedevstat, zdevstat, envrep, farm

  -v N,OPTION , --vendorattribute=N,OPTION                            (ATA)
        Set display OPTION for vendor Attribute N (see man page)

  -F TYPE, --firmwarebug=TYPE                                         (ATA)
        Use firmware bug workaround:
        none, nologdir, samsung, samsung2, samsung3, xerrorlba, swapid

  -P TYPE, --presets=TYPE                                             (ATA)
        Drive-specific presets: use, ignore, show, showall

  -B [+]FILE, --drivedb=[+]FILE                                       (ATA)
        Read and replace [add] drive database from FILE
        [default is +/etc/smart_drivedb.h
         and then    /usr/share/smartmontools/drivedb.h]

============================================ DEVICE SELF-TEST OPTIONS =====

  -t TEST, --test=TEST
        Run test. TEST: offline, short, long, conveyance, force, vendor,N,
                        select,M-N, pending,N, afterselect,[on|off]

  -C, --captive
        Do test in captive mode (along with -t)

  -X, --abort
        Abort any non-captive test on device

=================================================== SMARTCTL EXAMPLES =====

  smartctl --all /dev/sda                    (Prints all SMART information)

  smartctl --smart=on --offlineauto=on --saveauto=on /dev/sda
                                              (Enables SMART on first disk)

  smartctl --test=long /dev/sda          (Executes extended disk self-test)

  smartctl --attributes --log=selftest --quietmode=errorsonly /dev/sda
                                      (Prints Self-Test & Attribute errors)
  smartctl --all --device=3ware,2 /dev/sda
  smartctl --all --device=3ware,2 /dev/twe0
  smartctl --all --device=3ware,2 /dev/twa0
  smartctl --all --device=3ware,2 /dev/twl0
          (Prints all SMART info for 3rd ATA disk on 3ware RAID controller)
  smartctl --all --device=hpt,1/1/3 /dev/sda
          (Prints all SMART info for the SATA disk attached to the 3rd PMPort
           of the 1st channel on the 1st HighPoint RAID controller)
  smartctl --all --device=areca,3/1 /dev/sg2
          (Prints all SMART info for 3rd ATA disk of the 1st enclosure
           on Areca RAID controller)
Options (30)
OptionDescriptionSource
-h, --help, --usagePrints a usage message to STDOUT and exits.help + man
-V, --version, --copyright, --licensePrints version, copyright, license, home page and SVN revision information for your copy of smartctl to STDOUT and then exits.help + man
-i, --infoPrints the device model number, serial number, firmware version, and ATA Standard version/revision information.help + man
--identify w][nvbShow words and bits from IDENTIFY DEVICE data (ATA)help
-g, --get NAMEGet device setting: all, aam, apm, dsn, lookahead, security, wcache, rcache, wcreorder, wcache-scthelp + man
-a, --allPrints all SMART information about the device.help + man
-x, --xallPrints all SMART and non-SMART information about the device.help + man
--scanScans for devices and prints each device name, device type and protocol ([ATA] or [SCSI]) info.help + man
--scan-openSame as --scan, but also tries to open each device before printing device info.help + man
-j, --json cgiosuvyPrint output in JSON or YAML formathelp
-q, --quietmode TYPESpecifies that smartctl should run in one of the quiet modes described here.help + man
-d, --device TYPESpecify device type to one of: ata, scsi[+TYPE], nvme[,NSID], sat[,auto][,N][+TYPE], usbasm1352r,N, usbcypress[,X], usbjmicron[,p][,x][,N], usbprolific, usbsunplus[/sat], sntasmedia[/sat],…help + man
-T, --tolerance TYPE[ATA only] Specifies how tolerant smartctl should be of ATA and SMART command failures.help + man
-b, --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)…help + man
-r, --report TYPEIntended primarily to help smartmontools developers understand the behavior of smartmontools on non-conforming or poorly conforming hardware.help + man
-s, --smart VALUEEnable/disable SMART on device (on/off)help + man
-o, --offlineauto VALUE[ATA only] Enables or disables SMART automatic offline test, which scans the drive every four hours for disk defects.help + man
-S, --saveauto VALUE[ATA] Enables or disables SMART autosave of device vendor-specific Attributes.help + man
-H, --healthPrints the health status of the device.help + man
-c, --capabilities[ATA] Prints only the generic SMART capabilities.help + man
-A, --attributesShow device SMART vendor-specific Attributes and valueshelp + man
-f, --format FORMAT(ATA) Set output format for attributes: old, brief, hex[,id|val]help + man
-l, --log TYPEPrints various device logs.help + man
-v, --vendorattribute N(ATA) Set display OPTION for vendor Attribute N (see man page)help + man
-F, --firmwarebug TYPE[ATA only] Modifies the behavior of smartctl to compensate for some known and understood device firmware or driver bug.help + man
-P, --presets TYPE[ATA only] Specifies whether smartctl should use any preset options that are available for this drive.help + man
-B, --drivedb +]FILE(ATA) Read and replace [add] drive database from FILE [default is +/etc/smart_drivedb.h and then /usr/share/smartmontools/drivedb.h]help
-t, --test TESTExecutes TEST immediately.help + man
-C, --captiveDo test in captive mode (along with -t)help + man
-X, --abortAbort any non-captive test on devicehelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.