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

NAME

6       innxbatch - send xbatched Usenet articles to a remote NNTP server
7

SYNOPSIS

9       innxbatch [ -D ] [ -t timeout ] [ -T timeout ] [ -v ] host file ...
10

DESCRIPTION

12       Innxbatch  connects  to the NNTP server at the specified host and sends
13       it the specified xbatch files, using the XBATCH extension to  the  NNTP
14       protocol.  It  is  normally invoked by a script run out of cron(8) that
15       uses shlock(1) to lock the host name, followed by a ctlinnd(8)  command
16       to flush the batchfile.
17
18       Each file is removed after it has been successfully transferred.
19
20       If  a  communication error such as a write(2) failure, or an unexpected
21       reply from the remote server occurs, innxbatch will  stop  sending  and
22       leave all remaining files untouched for later retry.
23
24
25

OPTIONS

27       -t seconds
28              Innxbatch  normally  blocks  until  the  connection is made.  To
29              specify a timeout on how long to try to make the connection, use
30              the ``-t'' flag.
31
32       -T seconds
33              To  specify  the total amount of time that should be allowed for
34              article transfers, use the ``-T'' flag.
35              The default is to wait until an I/O error  occurs,  or  all  the
36              articles  have been transferred. If the ``-T'' flag is used, the
37              time is checked just before each article is started; it will not
38              abort a transfer that is in progress.
39
40       -v     Upon  exit,  innxbatch reports transfer and CPU usage statistics
41              via syslog(3).  If the ``-v'' flag is used, they  will  also  be
42              printed on the standard output.
43
44       -D     Use  the  ``-D'' flag to print debugging information on standard
45              error.  This will show the protocol transactions  between  innx‐
46              batch and the NNTP server on the remote host.
47

EXAMPLES

49       A sample newsfeeds(5) entry to produce appropriate xbatch files (thanks
50       to Karsten Leipold <poldi@dfn.de>):
51
52         nase\
53           :*\
54           :Tc,Wnb\
55           :<pathbin in inn.conf>/batcher \
56              -p "(<$ac_cv_path_COMPRESS in config.cache> >\
57              <pathoutgoing in inn.conf>/nase.\$\$)" \
58              nase.do.main
59
60       A sample script to invoke innxbatch(8) is:
61
62         #!/bin/sh
63         ##  SH script to send xbatches for a site, wrapped around innxbatch
64         ##  Invocation:
65         ##     sendxbatches.sh <sitename> <hostname> <xbatch file name> ...
66
67         if [ $# -le 3 ]
68         then
69            echo "usage: $0 <sitename> <hostname> <xbatch file name>"
70            exit 1
71         fi
72
73         . <pathbin in inn.conf>/innshellvars
74
75         site="$1"; host="$2"; shift; shift
76
77         ctlinnd flush "$site" \
78         && sleep 5 \
79         && exec $NEWSBIN/innxbatch -v -D "$host" $*
80

HISTORY

82       Written  by  Stefan  Petri  <petri@ibr.cs.tu-bs.de>,   modelled   after
83       innxmit(8) and the XBATCH patch for the nntp reference implementation.
84

SEE ALSO

86       ctlinnd(8),    inn.conf(5),    innd(8),    innxmit(8),    newsfeeds(5),
87       nntpsend(8), shlock(1).
88
89
90
91                                                                  INNXBATCH(8)