#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.ctl</h1>

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

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

<P>
uucpsend.ctl - list of sites to feed via uucpsend

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

<P>
The file <I>/etc/news/uucpsend.ctl</I> specifies the default list
of sites to be fed by <A HREF="/cgi-bin/man2html?uucpsend&8">uucpsend(8)</A>
. The program is able to
read site information from other related configuration
files as well.
<P>
Comments begin with a number sign (``#'') and continue
through the end of the line. Blank lines and comments are
ignored. All other lines should consist of six fields
separated by a colon. Each line looks like
<P>
<I>site</I>:<I>max</I><B>_</B><I>size</I>:<I>queue</I><B>_</B><I>size</I>:<I>header</I>:<I>compressor</I>:<I>args</I>
<P>
The first field <I>site</I> is the name of the site as specified
in the <A HREF="/cgi-bin/man2html?newsfeeds&5">newsfeeds(5)</A>
 file. This is also the name of the
UUCP system connected to this site.
<P>
The second field <I>max</I><B>_</B><I>size</I> describes the maximum size of
all batches in kbytes that may be sent to this site. If
this amount of batches is reached, this site will not be
batched with this run and a reason will be logged into the
logfile. This test includs all UUCP jobs, not only the
ones sent to rnews (performing ``du -s'').
<P>
The third field <I>queue</I><B>_</B><I>size</I> specifies the maximum size in
kbytes of one batch. This argument is passed directly to
<A HREF="/cgi-bin/man2html?batcher&8">batcher(8)</A>
.
<P>
The fourth field <I>header</I> defines the text that shall appear
in the command header of every batch file. `#! ` is prefixed
each batch. Normally you'll need <B>cunbatch</B> for compress,
<B>gunbatch</B> or <B>zunbatch</B> for gzip. This header is
important since there is not standard way to handle
gzip'ed batches. Using this and the next argument you're
also able to use any compressor you like. So you receive
a certain amount of flexibility by using <B>uucpsend</B>. If you
don't want to have any compression leave the field empty.
<P>
The fifth field <I>compressor</I> names a program that reads from
stdin and writes to stdout. Normally it modifies the
input stream by compressing it, such as <A HREF="/cgi-bin/man2html?compress&1">compress(1)</A>
 or
<A HREF="/cgi-bin/man2html?gzip&1">gzip(1)</A>
.
<P>
The sixth field <I>args</I> consists of additional arguments that
are passed directly to uux when sending the batch.
<P>
One entry in the main configuration file is mandatory.
There must exist a line containing the default values for
all these variables. To achieve this the pseudo site
<I>/default/</I> is used.
<P>
One default entry could look like this:
<P>
/default/:2000:200:cunbatch:compress:-r -n
<P>
This reflects a minimal setup. The maximal size that may
be used by the UUCP spool directory is 2MB. Each batch
will be max. 200 kBytes big. The header of each batch
will contain the string `cunbatch' and <A HREF="/cgi-bin/man2html?compress&1">compress(1)</A>
 is used
to compress the batches. `-r -n' is passed to <A HREF="/cgi-bin/man2html?uux&1">uux(1)</A>
 which
means no notification will be sent if uux was successful
and uux won't start the <A HREF="/cgi-bin/man2html?uucico&8">uucico(8)</A>
 program when spooling
the file.

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

<P>
Written by Martin Schulze &lt;joey@infodrom.north.de&gt; for
InterNetNews. Most of the work is derived from
<A HREF="/cgi-bin/man2html?nncpsend.ctl&5">nncpsend.ctl(5)</A>
 by Landon Curt Noll &lt;chongo@toad.com&gt; for
InterNetNews.

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

<P>
<A HREF="/cgi-bin/man2html?batcher&8">batcher(8)</A>
, <A HREF="/cgi-bin/man2html?newsfeeds&5">newsfeeds(5)</A>
, <A HREF="/cgi-bin/man2html?uucpsend&8">uucpsend(8)</A>
, <A HREF="/cgi-bin/man2html?uux&1">uux(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">Description</A></LI>
<LI><A NAME="toc2" HREF="#sect2">History</A></LI>
<LI><A NAME="toc3" HREF="#sect3">See Also</A></LI>
</UL>

</projectpg>

