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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# Copyright (C) 2004 Stanislav Sinyagin
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
# $Id: torrus_action_printemail.pod.in,v 1.1 2010-12-27 00:04:38 ivan Exp $
# Stanislav Sinyagin <ssinyagin@yahoo.com>
#
#
=head1 NAME
action_printemail - A script for sending email from monitor action.
=head1 SYNOPSIS
<action name="report-email">
<param name="action-type" value="exec" />
<param name="command">
$TORRUS_BIN/action_printemail | mail alarms@example.com
</param>
<param name="launch-when" value="set, clear" />
</action>
=head1 DESCRIPTION
This program is designed for usage from a monitor action only. It takes
the arguments from environment variables, as described in action-type
C<exec> in B<Torrus XML Configuration Guide>. In addition, some values
may be supplied via command-line arguments (see section OPTIONS below).
Site-specific variables must be specified in the file F<email-siteconfig.pl>.
Default values are installed by the first run of C<make install>. Subsequent
runs of C<make install> do not override this file.
=head1 OPTIONS
=over 4
=item B<--url>=I<GRAPHER-URL>
Sets the URL of the grapher CGI script.
=item B<--template>=I<TEMPLATE-FILE>
Uses given file as a template. The template file must reside in @tmpldir@
directory. It must be a Template-toolkit file, with the following variables
defined:
tree Tree name
token Leaf token
path Leaf path
url URL for browsing this leaf
ncomment This leaf comment
npcomment Leaf's parent comment
event Event type
monitor Monitor name
mcomment Monitor comment
timestamp Time and date of the event
env(VAR) Environment variable VAR
=back
=head1 FILES
=over 4
=item F<@siteconfdir@/email-siteconfig.pl>
Torrus site email configuration script.
=item F<@tmpldir@>
=item F<@tmpluserdir@>
Torrus template directories.
=back
=head1 SEE ALSO
L<torrus(@mansec_usercmd@)>
=head1 NOTES
See more documentation at Torrus home page: http://torrus.org
=head1 AUTHOR
Stanislav Sinyagin E<lt>ssinyagin@yahoo.comE<gt>
|