OS Manuals

/usr/bin/smartd

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

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

smartd 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: smartd [options]

  -A PREFIX, --attributelog=PREFIX
        Log attribute information to {PREFIX}MODEL-SERIAL.TYPE.csv

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

  -c NAME|-, --configfile=NAME|-
        Read configuration file NAME or stdin
        [default is /etc/smartd.conf]

  -C, --capabilities[=mail]
        Drop unneeded Linux process capabilities.
        Warning: Mail notification may not work when used.

  -d, --debug
        Start smartd in debug mode

  -D, --showdirectives
        Print the configuration file Directives and exit

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

  -i N, --interval=N
        Set interval between disk checks to N seconds, where N >= 10

  -l local[0-7], --logfacility=local[0-7]
        Use syslog facility local0 - local7 or daemon [default]

  -n, --no-fork
        Do not fork into background
        (systemd 'Type=notify' is assumed if $NOTIFY_SOCKET is set)

  -p NAME, --pidfile=NAME
        Write PID file NAME

  -q WHEN, --quit=WHEN
        Quit on one of: nodev[0], errors[,nodev0], nodev[0]startup, never, onecheck, showtests

  -r, --report=TYPE
        Report transactions for one of: ioctl[,N], ataioctl[,N], scsiioctl[,N], nvmeioctl[,N]

  -s PREFIX, --savestates=PREFIX
        Save disk states to {PREFIX}MODEL-SERIAL.TYPE.state

  -w NAME, --warnexec=NAME
        Run executable NAME on warnings
        [default is /etc/smartd_warning.sh]

  -u USER[:GROUP], --warn-as-user=USER[:GROUP]
        Run warning script as non-privileged USER

  -V, --version, --license, --copyright
        Print License, Copyright, and version information
Options (17)
OptionDescriptionSource
-A, --attributelog PREFIXWrites drive attribute information to files 'PREFIX''MODEL-SERIAL[-NSID].PRT.csv'.help + man
-B, --drivedb +]FILERead and replace [add] drive database from FILE [default is +/etc/smart_drivedb.h and then /usr/share/smartmontools/drivedb.h]help
-c, --configfile NAME|-Read smartd configuration Directives from FILE, instead of from the default location /etc/smartd.conf (Windows: EXEDIR/smartd.conf).help + man
-C, --capabilities mailDrop unneeded Linux process capabilities.help
-d, --debugRuns smartd in "debug" mode.help + man
-D, --showdirectivesPrints a list (to STDOUT) of all the possible Directives which may appear in the configuration file /etc/smartd.conf, and then exits.help + man
-h, --help, --usagePrints usage message to STDOUT and exits.help + man
-i, --interval NSets the interval between disk checks to N seconds, where N is a decimal integer.help + man
-l, --logfacility local[0-7Uses syslog facility FACILITY to log the messages from smartd.help + man
-n, --no-forkDo not fork into background (systemd 'Type=notify' is assumed if $NOTIFY_SOCKET is set)help + man
-p, --pidfile NAMEWrites pidfile NAME containing the smartd Process ID number (PID).help + man
-q, --quit WHENQuit on one of: nodev[0], errors[,nodev0], nodev[0]startup, never, onecheck, showtestshelp + man
-r, --report TYPEIntended primarily to help smartmontools developers understand the behavior of smartmontools on non-conforming or poorly-conforming hardware.help + man
-s, --savestates PREFIXReads/writes smartd state information from/to files 'PREFIX''MODEL-SERIAL[-NSID].PRT.state'.help + man
-w, --warnexec NAMERun the executable PATH instead of the default script when smartd needs to send warning messages.help + man
-u, --warn-as-user USER[:GROUPRun warning script as non-privileged USERhelp
-V, --version, --license, --copyrightPrints version, copyright, license, home page and SVN revision information for your copy of smartd to STDOUT and then exits.help + man
Exit status (12) from the manual page
0Daemon startup successful, or smartd was killed by a SIGTERM (or in debug mode, a SIGQUIT).
1Commandline did not parse.
2There was a syntax error in the config file.
3Forking the daemon failed.
4Couldn't create PID file.
5Config file does not exist (only returned in conjunction with the '-c' option).
6Config file exists, but cannot be read.
8smartd ran out of memory during startup.
10An inconsistency was found in smartd's internal data structures.
16A device explicitly listed in /etc/smartd.conf can't be monitored.
17smartd didn't find any devices to monitor.
254When in daemon mode, smartd received a SIGINT or SIGQUIT.

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