tinews.pl(1)

1TINEWS(1)              Post and sign an article via NNTP             TINEWS(1)
2
3
4

NAME

6       tinews.pl - Post and sign an article via NNTP
7

SYNOPSIS

9       tinews.pl [OPTIONS] < input
10

DESCRIPTION

12       tinews.pl reads an article on STDIN, signs it via pgp(1) or gpg(1) and
13       posts it to a newsserver.
14
15       If the article contains To:, Cc: or Bcc: headers and mail-actions are
16       configured it will automatically add a "Posted-And-Mailed: yes" header
17       to the article and send out the mail-copies.
18

OPTIONS

20       -a "Approved" ⎪ --approved "Approved"
21           Set the article header field Approved: to the given value.
22
23       -c "Control" ⎪ --control "Control"
24           Set the article header field Control: to the given value.
25
26       -d "Distribution" ⎪ --distribution "Distribution"
27           Set the article header field Distribution: to the given value.
28
29       -e "Expires" ⎪ --expires "Expires"
30           Set the article header field Expires: to the given value.
31
32       -f "From" ⎪ --from "From"
33           Set the article header field From: to the given value.
34
35       -n "Newsgroups" ⎪ --newsgroups "Newsgroups"
36           Set the article header field Newsgroups: to the given value.
37
38       -o "Organization" ⎪ --organization "Organization"
39           Set the article header field Organization: to the given value.
40
41       -p "port" ⎪ --port "port"
42           use "port" as NNTP-port
43
44       -r "Reply-To" ⎪ --replyto "Reply-To"
45           Set the article header field Reply-To: to the given value.
46
47       -t "Subject" ⎪ --subject "Subject"
48           Set the article header field Subject: to the given value.
49
50       -w "Followup-To" ⎪ --followupto "Followup-To"
51           Set the article header field Followup-To: to the given value.
52
53       -x "Path" ⎪ --path "Path"
54           Set the article header field Path: to the given value.
55
56       -H ⎪ --help
57           Show help-page.
58
59       -R ⎪ --no-control
60           Restricted mode, disallow control-messages.
61
62       -S ⎪ --no-signature
63           Do not append $HOME/.signature
64
65       -X ⎪ --no-sign
66           Do not sign the article.
67
68       -A -V -W
69           These options are accepted for compatibility reasons but ignored.
70
71       -h ⎪ --headers
72           These options are accepted for compatibility reasons but ignored.
73
74       -O ⎪ --no-organization
75           These options are accepted for compatibility reasons but ignored.
76
77       -D ⎪ -N ⎪ --debug
78           These options are accepted but do not have any functionality yet.
79

EXIT STATUS

81       The following exit values are returned:
82
83            0  Successful completion.
84
85           !=0 An error occurred.
86

ENVIRONMENT

88       $NNTPSERVER
89           Set to override the NNTP server configured in the source.
90
91       $NNTPPORT
92           The NNTP TCP-port to post news to. This variable only needs to be
93           set if the TCP-port is not 119 (the default). The '-p' command-line
94           option overrides $NNTPPORT.
95
96       $PGPPASS
97           Set to override the passphrase configured in the source (used for
98           pgp(1)-2.6.3).
99
100       $PGPPASSFILE
101           Passphrase file used for pgp(1) or gpg(1).
102
103       $SIGNER
104           Set to override the user-id for signing configured in the source.
105           If you neither set $SIGNER nor configure it in the source the con‐
106           tents of the From:-field will be used.
107
108       $REPLYTO
109           Set the article header field Reply-To: to the return address speci‐
110           fied by the variable if there isn't already a Reply-To: header in
111           the article.  The '-r' command-line option overrides $REPLYTO.
112
113       $ORGANIZATION
114           Set the article header field Organization: to the contents of the
115           variable if there isn't already a Organization: header in the arti‐
116           cle. The '-o' command-line option overrides $ORGANIZATION.
117
118       $DISTRIBUTION
119           Set the article header field Distribution: to the contents of the
120           variable if there isn't already a Distribution: header in the arti‐
121           cle. The '-d' command-line option overrides $DISTRIBUTION.
122

FILES

124       pgptmp.txt
125           Temporary file used to store the reformatted article
126
127       pgptmp.txt.asc
128           Temporary file used to store the reformatted and signed article
129
130       $PGPPASSFILE
131           The passphrase file to be used for pgp(1) or gpg(1).
132
133       $HOME/.signature
134           Signature-file which will be automatically included.
135

SECURITY

137       If you've configured or entered a password, even if the variable that
138       contained that password has been erased, it may be possible for someone
139       to find that password, in plaintext, in a core dump. In short, if seri‐
140       ous security is an issue, don't use this script.
141

NOTES

143       tinews.pl is designed to be used with pgp(1)-2.6.3, pgp(1)-5 and
144       gpg(1).
145
146       tinews.pl requires the following standard modules to be installed:
147       Getopt::Long(3pm), Net::NNTP(3pm), Time::Local(3pm) and Term::Read‐
148       line(3pm).
149

AUTHOR

151       Urs Janssen <urs@tin.org>, Marc Brockschmidt <marc@marcbrockschmidt.de>
152