SIMPLE SOLUTIONS

EXTSMAIL.CONF(5) - Linux man page online | File formats

Configure robust sending of e-mail to external commands.

Chapter
OR
EXTSMAIL.CONF(5) BSD File Formats Manual EXTSMAIL.CONF(5)

NAME

extsmail.conf — configure robust sending of e-mail to external commands

DESCRIPTION

extsmail.conf is used to configure extsmail(1) and extsmaild(1). It consists of one or more key = value pairs. The following variables are defined: spool_dir Sets the location of the spool directory used by extsmail(1) and extsmaild(1). This is the only variable which must be set in every configuration file. notify_failure_interval Specifies how often notifications of unsucessful deliveries should be made. If unspecified, or set to 0, notifications will never be made. Times are specified as a number followed by d (days), h (hours), m (minutes), or s (seconds). notify_failure_cmd The shell command to be executed when notify_failure_interval seconds / minutes / hours / days have elapsed since the last fully successful send cycle. If the string ${TIME} exists in the command, it is replaced with a pretty printed string detailing how much time has elapsed since the last fully successfuly send cycle. The result‐ ing string is then passed to system(3). Note that no security checking is (or can be) done on the command, so this option should be used with caution if a single con‐ figuration file serves multiple users. Please check the warnings that come with system(3). notify_success_cmd The shell command to be executed when 1 or more messages have been successfully sent. If the string ${SUCCESSES} exists in the command, it is replaced with a string representing the number of successfully sent messages. The same warnings that apply to notify_failure_cmd also apply to this command.

FILES

The extsmail configuration file is searched for, in order, in the following locations: ~/.extsmail/conf Per-user extsmail configuration. /etc/extsmail/conf System-wide extsmail configuration.

EXAMPLES

The simplest configuration file looks as follows: spool_dir = "~/somewhere" A more complex configuration which uses a notification framework to inform the user of mail sending and failure looks as follows: spool_dir = "~/somewhere" notify_failure_interval = 30m notify_failure_cmd = "notify-send -a extsmaild -c email -i mail-send -u critical 'extsmaild: ${TIME} since a fully successful send cycle'" notify_success_cmd = "notify-send -a extsmaild -c email -i mail-send -u low 'extsmaild: ${SUCCESSES} messages successfully sent'"

SEE ALSO

extsmail(1), extsmail.externals(5), extsmaild(1)

AUTHORS

Laurence Tratt <http://tratt.net/laurie/>
BSD November 2, 2008 BSD
This manual Reference Other manuals
extsmail.conf(5) referred by extsmail(1) | extsmail.externals(5) | extsmaild(1)
refer to extsmail(1) | extsmail.externals(5) | extsmaild(1) | system(3)
Download raw manual
Main page USE (+1271) THE (+1276) № 5 (+2141)
Go top