INNXBATCH(8) | System Manager's Manual | INNXBATCH(8) |
innxbatch - send xbatched Usenet articles to a remote NNTP server
innxbatch [ -D ] [ -t timeout ] [ -T timeout ] [ -v ] host file ...
Innxbatch connects to the NNTP server at the specified host and sends it the specified xbatch files, using the XBATCH extension to the NNTP protocol. It is normally invoked by a script run out of cron(8) that uses shlock(1) to lock the host name, followed by a ctlinnd(8) command to flush the batchfile.
Each file is removed after it has been successfully transferred.
If a communication error such as a write(2) failure, or an unexpected reply from the remote server occurs, innxbatch will stop sending and leave all remaining files untouched for later retry.
A sample newsfeeds(5) entry to produce appropriate xbatch files (thanks to Karsten Leipold <poldi@dfn.de>):
nase\
:*\
:Tc,Wnb\
:<pathbin in inn.conf>/batcher \
-p "(<$ac_cv_path_COMPRESS in config.cache> >\
<pathoutgoing in inn.conf>/nase.\$\$)" \
nase.do.main
A sample script to invoke innxbatch(8) is:
#!/bin/sh
## SH script to send xbatches for a site, wrapped around innxbatch
## Invocation:
## sendxbatches.sh <sitename> <hostname> <xbatch file name> ...
if [ $# -le 3 ]
then echo "usage: $0 <sitename> <hostname> <xbatch file name>" exit 1
fi
. <pathbin in inn.conf>/innshellvars
site="$1"; host="$2"; shift; shift
ctlinnd flush "$site" \
&& sleep 5 \
&& exec $NEWSBIN/innxbatch -v -D "$host" $*
Written by Stefan Petri <petri@ibr.cs.tu-bs.de>, modelled after innxmit(8) and the XBATCH patch for the nntp reference implementation.
ctlinnd(8), inn.conf(5), innd(8), innxmit(8), newsfeeds(5), nntpsend(8), shlock(1).