1NNTPSEND(8)                 System Manager's Manual                NNTPSEND(8)
2
3
4

NAME

6       nntpsend - send Usenet articles to remote site
7

SYNOPSIS

9       nntpsend  [ -a ] [ -c ] [ -D ] [ -d ] [ -l ] [ -N ] [ -n ] [ -P portnum
10       ] [ -p ] [ -r ] [ -S ] [ -s size ] [ -T timelimit ] [ -t timeout ] [ -w
11       delay ] [ sitename fqdn ] ...
12

DESCRIPTION

14       Nntpsend is a front-end that invokes innxmit(1) to send Usenet articles
15       to a remote NNTP site.
16
17       The sites to be fed may be specified by giving sitename fqdn  pairs  on
18       the command line.  If no such pairs are given, nntpsend defaults to the
19       information given in the nntpsend.ctl config file.
20
21       The sitename should be the name of the site as specified in  the  news‐
22       feeds(5)  file.   The  fqdn should be the hostname or IP address of the
23       remote site.
24
25       An innxmit is launched for sites with queued news.   All  innxmit  pro‐
26       cesses  are spawned in the background and the script waits for them all
27       to  finish  before   returning.    Output   is   sent   to   the   file
28       <pathlog in inn.conf>/nntpsend.log.  In order to keep from overwhelming
29       the local system, nntpsend waits  five  seconds  before  spawning  each
30       child.
31
32       Nntpsend  expects  that  the  batchfile for a site is named <pathoutgo‐
33       ing in inn.conf>/sitename.  To prevent batchfile corruption,  shlock(1)
34       is used to ``lock'' these files.
35
36       When sitename fqdn pairs are given on the command line, any flags given
37       on the command completely describe how innxmit and shrinkfile  operate.
38       When  no such pairs are given on the command line, then the information
39       found in nntpsend.ctl becomes the default flags  for  that  site.   Any
40       flags  given  on  the  command  line override the default flags for the
41       site.
42

OPTIONS

44       -d -D  The ``-d'' flag causes nntpsend to send output to stdout  rather
45              than   the  log  file  <pathlog in inn.conf>/nntpsend.log.   The
46              ``-D'' flag does the same and it passes ``-d''  to  all  innxmit
47              invocations, which in turn causes innxmit to go into debug mode.
48
49       -n     If the ``-n'' flag is used, then nntpsend does not use shlock(1)
50              and does not lock batch files.
51
52       -s size
53              If the ``-s'' flag is used, then shrinkfile(1) will  be  invoked
54              to  perform a head truncation on the batchfile and the flag will
55              be passed to it.
56
57       -w delay
58              If the ``-w'' flag is used, then nntpsend waits for  delay  sec‐
59              onds after flushing the site before launching innxmit.
60
61       -a -c -l -N -P -p -r -S -T -t
62              The  ``-a'',  ``-c'',  ``-l'',  ``-P'',  ``-p'', ``-r'', ``-S'',
63              ``-T'' and ``-t'' flags are passed on to the child innxmit  pro‐
64              gram.  The  ``-N''  flag  is  passed as ``-s'' flag to the child
65              innxmit program.  See innxmit(8) for more details.  Note that if
66              the  ``-p'' flag is used then no connection is made and no arti‐
67              cles are fed to the remote site.  It is useful to  have  cron(8)
68              invoke  nntpsend with this flag in case a site cannot be reached
69              for an extended period of time.
70

EXAMPLES

72       With the following nntpsend.ctl(5) control file:
73
74              nsavax:erehwon.nsavax.gov::-S -t60
75              group70:group70.org::
76              walldrug:walldrug.com:4m-1m:-T1800 -t300
77              kremvax:kremvax.cis:2m:
78
79       The command:
80
81              nntpsend
82
83       will result in the following:
84
85              Sitename        Truncation      Innxmit flags
86              nsavax          (none)          -a -S -t60
87              group70         (none)          -a -t180
88              walldrug        1m if >4m       -a -T1800 -t300
89              kremvax         2m              -a -t180
90
91       The command:
92
93              nntpsend -d -T1200
94
95       will result in the following:
96
97              Sitename        Truncation      Innxmit flags
98              nsavax          (none)          -a -d -S -T1200 -t60
99              group70         (none)          -a -d -T1200 -t180
100              walldrug        1m if >4m       -a -d -T1200 -t300
101              kremvax         2m              -a -d -T1200 -t180
102
103       The command:
104
105              nntpsend  -s  5m  -T1200   nsavax   erehwon.nsavax.gov   group70
106              group70.org
107
108       will result in the following:
109
110              Sitename        Truncation      Innxmit flags
111              nsavax          5m              -a -T1200 -t180
112              group70         5m              -a -T1200 -t180
113
114       Remember that ``-a'' is always given, and ``-t'' defaults to 180.
115

HISTORY

117       Written   by   Landon   Curt   Noll  <chongo@toad.com>  and  Rich  $alz
118       <rsalz@uunet.uu.net> for InterNetNews.  This is  revision  5909,  dated
119       2002-12-03.
120

SEE ALSO

122       inn.conf(5), innxmit(1), newsfeeds(5), nntpsend.ctl(5), shrinkfile(1).
123
124
125
126                                                                   NNTPSEND(8)
Impressum