#include <infodrom.style>
#include <projects.style>
#include <addresses.inc>

<projectpg project="uucpsend" maxnews=0 maxcontrib=5>

<h3 align=center>Alternative Frontend for UUCP Batching</h3>

<h1>Manual page for uucpsend</h1>

<A HREF="#toc">Table of Contents</A><P>

<H2><A NAME="sect0" HREF="#toc0">Name</A></H2>

<P>
uucpsend - Additional frontend for uucp batching

<H2><A NAME="sect1" HREF="#toc1"><B>Synopsys</B></A></H2>

<P>
<B>uucpsend</B> [ <B>-f</B> <I>config</I> ] <I>sitename</I> [ <I>sitename</I> <I>...</I> ]
<P>
This program offers a comfortable way to do news batching
with the INN news system. Like the name assumes it is
used for sites that are connected via UUCP. The idea
behind the mechanism is taken from the <B>nntpsend</B> program
which is already included in distributions of INN.
<P>
The program does not do the batching itself. Instead it
lets commonly used tools do the work. However it controls
their behaviour. Using <B>uucpsend</B> you can define detailed
how batching for each site shall take place in an easy
fashion.
<P>
In the file <A HREF="/cgi-bin/man2html?uucpsend.ctl&5">uucpsend.ctl(5)</A>
 for each site your server
feeds you can specify the size of batches, the maximal
disk space that may be used by the uucp site, the header
that should be written in the batch (e.g. funbatch, cunbatch,
gunbatch etc.), the compression program to use as
well as additional arguments passed to <A HREF="/cgi-bin/man2html?uux&8">uux(8)</A>
.
<P>
With the parameter ``<B>-f</B>'' you may specify another
<A HREF="/cgi-bin/man2html?uucpsend.ctl&5">uucpsend.ctl(5)</A>
 file. Information with regard to also
given sitenames are read from the <I>uucpsend.ctl</I>-file.
Please keep in mind that all default values are still read
from the main <I>uucpsend.ctl</I> file. This feature has been
added to let big sites easily specify a different batching
behaviour.
<P>
The <I>sitename</I> should be the name of the site as specified
in the <A HREF="/cgi-bin/man2html?newsfeeds&5">newsfeeds(5)</A>
 file. If no sitenames are passed to
the program it will loop over all sites that described in
the configuration file. This makes it easy to maintain
sets of sites that are to be batched one after the other contrary
to batching through the whole day.
<P>
A <A HREF="/cgi-bin/man2html?batcher&8">batcher(8)</A>
 is launched for sites with queued news. Output
is sent to the file <I>/var/log/news/uucpsend.log</I>. In
order to keep from overwhelming the local system, <B>uucpsend</B>
waits five seconds before the next site is fed. <B>Uucpsend</B>
expects that the batchfile for a site is named
<I>/var/spool/news/out.going/sitename</I>. To prevent batchfile
corruption, <A HREF="/cgi-bin/man2html?shlock&1">shlock(1)</A>
 is used to ``lock'' these files.
<P>
It is useful to have <A HREF="/cgi-bin/man2html?cron&8">cron(8)</A>
 invoke <I>uucpsend.</I>
<P>
When no <I>sites</I> are given on the command line, any flags
given on the command completely describe how <B>batcher</B> operate.
When no sites are given on the command line, then
the information found in <B>uucpsend.ctl</B> becomes the default
flags for that sites.

<H2><A NAME="sect2" HREF="#toc2"><B>History</B></A></H2>

<P>
Written by Martin Schulze &lt;joey@infodrom.north.de&gt;,
derived mostly from <A HREF="/cgi-bin/man2html?nntpsend&8">nntpsend(8)</A>
 by Landon Curt Noll
&lt;chongo@toad.com&gt; and Rich $alz &lt;rsalz@uunet.uu.net&gt; for
InterNetNews.

<H2><A NAME="sect3" HREF="#toc3"><B>See</B> <B>Also</B></A></H2>

<P>
<A HREF="/cgi-bin/man2html?innxmit&1">innxmit(1)</A>
, <A HREF="/cgi-bin/man2html?newsfeeds&5">newsfeeds(5)</A>
, <A HREF="/cgi-bin/man2html?uucpsend.ctl&5">uucpsend.ctl(5)</A>
, <A HREF="/cgi-bin/man2html?nntppsend&8">nntppsend(8)</A>
,
<A HREF="/cgi-bin/man2html?nntppsend.ctl&5">nntppsend.ctl(5)</A>
, <A HREF="/cgi-bin/man2html?shrinkfile&1">shrinkfile(1)</A>
.
<P>

<HR><P>
<A NAME="toc"><B>Table of Contents</B></A><P>
<UL>
<LI><A NAME="toc0" HREF="#sect0">Name</A></LI>
<LI><A NAME="toc1" HREF="#sect1">Synopsys</A></LI>
<LI><A NAME="toc2" HREF="#sect2">History</A></LI>
<LI><A NAME="toc3" HREF="#sect3">See Also</A></LI>
</UL>

</projectpg>

