summaryrefslogtreecommitdiffstats
path: root/examplescripts/README
blob: bf67b545fbe2f90a175b73a2067fed55321ff6ee (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
# Home page: http://www.smartmontools.org
#
# $Id: README 4937 2019-08-04 15:29:43Z chrfranke $
#
# Copyright (C) 2003-08 Bruce Allen
# Copyright (C) 2009-18 Christian Franke
# 
# SPDX-License-Identifier: GPL-2.0-or-later
#

This directory contains executable shell scripts, that are intended for
use with the
  -m address -M exec /path/to/an/executable
Directive in /etc/smartd.conf.

Details about how to use this Directive may be found in the man pages for
smartd and smartd.conf.
  man 8 smartd
  man 5 smartd.conf
should display those pages on your system.

If you wish to contribute additional scripts to this collection,
please email them to <smartmontools-support@listi.jpberlin.de>,
and include a brief description to use below.

The files contained in this directory are:

Example1: Appends values of $SMARTD_* environment variables and the output
          of smartctl -a to the normal email message, and sends that
          to the email address listed as the argument to the -m
          Directive.

Example2: Appends output of smartctl -a to the normal email message
          and sends that to the email address listed as the argument
          to the -m Directive.

Example3: Uses wall(1) to send a warning message to all users, then powers
          down the machine.

Example4: Uses powersave-notify to issue a desktop neutral warning.
          (/etc/smartmontools/run.d/10powersave-notify from Debian package)

Example5: Uses run-parts(8) to run scripts from /etc/smartmontools/run.d/.
          (/usr/share/smartmontools/smartd-runner from Debian package)

Example6: Sends a warning mail and then notifies the users by direct write
          to terminals.
          (/usr/libexec/smartmontools/smartdnotify from Fedora package)

Example7: Sends an email using /usr/sbin/sendmail mail transfer agent.
          May be useful if there is no other mail(1) compatible mailer
          available.

Example8: Sends an email using mail, mailx or sendmail mail transfer agent,
          whichever is found first.  This script uses SMARTD_* environment
          variables and could therefore also be used in a run-parts(8)
          context like Example5.