1NNTPSEND(8)               InterNetNews Documentation               NNTPSEND(8)
2
3
4

NAME

6       nntpsend - Send Usenet articles to remote sites
7

SYNOPSIS

9       nntpsend [-acDdlNnpr] [-P portnum] [-s size] [-T timelimit] [-t
10       timeout] [-w delay] [sitename fqdn] ...
11

DESCRIPTION

13       nntpsend is a front-end that invokes innxmit to send Usenet articles to
14       a remote NNTP site.  The sites to be fed may be specified by giving
15       sitename fqdn pairs on the command line.  If no such pairs are given,
16       nntpsend defaults to the information given in the nntpsend.ctl config
17       file.  The sitename should be the name of the site as specified in the
18       newsfeeds file.  The fqdn should be the hostname or IP address of the
19       remote site.  An innxmit is launched for sites with queued news.  All
20       innxmit processes are spawned in the background and the script waits
21       for them all to finish before returning.  Output is sent to the file
22       nntpsend.log in pathlog.  In order to keep from overwhelming the local
23       system, nntpsend waits five seconds before spawning each child.
24
25       nntpsend expects that the batch file for a site is named sitename in
26       pathoutgoing.  To prevent batch files corruption, shlock is used to
27       "lock" these files.  When sitename fqdn pairs are given on the command
28       line, any flags given on the command completely describe how innxmit
29       and shrinkfile operate.  When no such pairs are given on the command
30       line, then the information found in nntpsend.ctl becomes the default
31       flags for that site.  Any flags given on the command line override the
32       default flags for the site.
33
34       An alternative to nntpsend can be innduct, mentioned in the innfeed(8)
35       man page.
36

OPTIONS

38       -D, -d
39         The -D flag causes nntpsend to send output to stdout rather than the
40         log file nntpsend.log in pathlog.  The -d flag does the same and it
41         passes -d to all innxmit invocations, which in turn causes innxmit to
42         go into debug mode.
43
44       -n
45         If the -n flag is used, then nntpsend does not use shlock to lock the
46         use of nntpsend.  Batch files will still be locked.
47
48       -s size
49         If the -s flag is used, then shrinkfile will be invoked to perform a
50         head truncation of size bytes on the batch file and the flag will be
51         passed to it.
52
53       -w delay
54         If the -w flag is used, then nntpsend waits for delay seconds after
55         flushing the site before launching innxmit.
56
57       -a, -c, -l, -N, -P portnum, -p, -r, -T timelimit, -t timeout
58         The -a, -c, -l, -P portnum, -p, -r, -T timelimit and -t timeout flags
59         are passed on to the child innxmit program.  The -N flag is passed as
60         -s flag to the child innxmit program.  See innxmit(8) for more
61         details.
62
63         Note that if the -p flag is used, then no connection is made and no
64         articles are fed to the remote site.  It is useful to have cron(8)
65         invoke nntpsend with this flag in case a site cannot be reached for
66         an extended period of time.
67

EXAMPLES

69       With the following nntpsend.ctl config file:
70
71           nsavax:erehwon.nsavax.gov::-t60
72           group70:group70.org::
73           walldrug:walldrug.com:4m-1m:-T1800 -t300
74           kremvax:kremvax.cis:2m:
75
76       the command "nntpsend" will result in the following:
77
78           Sitename        Truncation      innxmit flags
79           nsavax          (none)          -a -t60
80           group70         (none)          -a -t180
81           walldrug        1m if >4m       -T1800 -t300
82           kremvax         2m              -t180
83
84       The command "nntpsend -d -T1200" will result in the following:
85
86           Sitename        Truncation      innxmit flags
87           nsavax          (none)          -a -d -T1200 -t60
88           group70         (none)          -a -d -T1200 -t180
89           walldrug        1m if >4m       -d -T1200 -t300
90           kremvax         2m              -d -T1200 -t180
91
92       The command "nntpsend -s 5m -T1200 nsavax erehwon.nsavax.gov group70
93       group70.org" will result in the following:
94
95           Sitename        Truncation      innxmit flags
96           nsavax          5m              -T1200 -t180
97           group70         5m              -T1200 -t180
98
99       Remember that -a is always given when there is no size limit, and -t
100       defaults to 180.
101

HISTORY

103       Written by Landon Curt Noll <chongo@toad.com> and Rich $alz
104       <rsalz@uunet.uu.net> for InterNetNews.  Converted to POD by Julien
105       Elie.
106
107       $Id: nntpsend.pod 9588 2013-12-19 17:46:41Z iulius $
108

SEE ALSO

110       inn.conf(5), innxmit(1), newsfeeds(5), nntpsend.ctl(5), shlock(1),
111       shrinkfile(1).
112
113
114
115INN 2.6.4                         2015-09-12                       NNTPSEND(8)
Impressum