1INNMAIL(1) InterNetNews Documentation INNMAIL(1)
2
3
4
6 innmail - Simple mail-sending program
7
9 innmail [-h] [-a header] [-s subject] address [address ...]
10
12 innmail is a Perl script intended to provide the non-interactive mail-
13 sending functionality of mail(1) while avoiding nasty security
14 problems. It takes the body of a mail message on standard input and
15 sends it to the specified addresses by invoking the value of mta in
16 inn.conf.
17
18 At least one address (formatted for the MTA specified in inn.conf, if
19 it matters) is required. innmail will sanitize the addresses so that
20 they contain only alphanumerics and the symbols "@", ".", "-", "+",
21 "_", and "%".
22
23 innmail was written to be suitable for the mailcmd setting in inn.conf.
24
26 -a header
27 Specifies an additional header field to add in the headers of the
28 message. It should be a well-formed header field surrounded by
29 quotes, consisting of a name and a body separated with a colon and
30 a space. For instance, "Auto-Submitted: auto-generated" is used by
31 some programs invoking innmail.
32
33 You may provide more than one header field if header is a multi-
34 line string, which can for instance be done with these commands:
35
36 HEADERS=$(echo -e "Hdr1: Body1\nHdr2: Body2")
37 echo "test" | innmail -a "$HEADERS" -s Test joe
38
39 -h Gives usage information.
40
41 -s subject
42 Sets the Subject header field body of the message. A warning is
43 issued if this option is omitted.
44
46 This sends a one-line message to the local user "joe":
47
48 echo "A one-line message." | innmail -s "Simple message" joe
49
50 innmail by default is used by INN for sending nightly reports to the
51 news administrator, as well as errors during the execution of a few
52 programs.
53
55 innmail fails on addresses that begin with "-", although one might hope
56 that the news server will not need to contact any such addresses.
57
58 There are many "correct" addresses that will be silently modified by
59 the sanitization process. A news administrator should be careful to
60 use particularly sane addresses if they may be passed to innmail.
61
63 innmail was written by James Brister <brister@vix.com> for
64 InterNetNews. This manual page was originally written by Jeffrey M.
65 Vinocur.
66
68 inn.conf(5), mail(1).
69
70
71
72INN 2.7.1 2023-03-07 INNMAIL(1)