batcher(8)
NAME
batcher - article batching backend for InterNetNews
SYNOPSIS
batcher [ -a arts ] [ -A total_arts ] [ -b size ] [ -B total_size ] [ -i string ] [ -N num_batches ] [ -p process ] [ -r ] [ -s separator ] [ -S alt_spool ] [ -v ] host [ input ]
DESCRIPTION
Batcher reads uses a list of files to prepare news batches for the specified host. 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. Batcher reads the named input file, or standard input if no file is given. Relative pathnames are interpreted from the /var/spool/news/out.going directory. The input is taken as a set of lines. Blank lines and lines starting with a number sign (``#'') are ignored. All other lines should consist of one or two fields separated by a single space. The first field is the name of a file holding an article; if it is not an an absolute pathname it is taken relative to the news spool directory, /var/spool/news. The second field, if present, specifies the size of the article in bytes.
OPTIONS
-S The ``-S'' flag may be used to specify an alternate spool
directory to use if the article is not found; this would
normally be an NFS-mounted spool directory of a master server
with longer expiration times.
-r By default, the program sets its standard error to
/var/log/news/errlog. To suppress this redirection, use the
``-r'' flag.
-v Upon exit, batcher reports statistics via syslog(3). If the
``-v'' flag is used, they will also be printed on the standard
output.
-b Batcher collects the text of the named articles into batches.
To limit the size of each batch, use the ``-b'' flag. The
default size is 60 kilobytes. Using ``-b0'' allows unlimited
batch sizes.
-a To limit the number of articles in each batch, use the ``-a''
flag. The default is no limit. A new batch will be started
when either the byte count or number of articles written exceeds
the specified limits.
-B To limit the total number of bytes written for all batches, use
the ``-B'' flag.
-A To limit the total number of articles that can be batched use
the ``-A'' flag.
-N To limit the total number of batches that should be created use
the ``-N'' flag.
In all three cases, the default is zero, which is taken to mean
no limit.
-i string
A batch starts with an identifying line to specify the unpacking
method to be used on the receiving end. When the ``-i'' flag is
used, the initial string, string, followed by a newline, will be
output at the start of every batch. The default is to have no
initial string.
-s Each article starts with a separator line to indicate the size
of the article. To specify the separator use the ``-s'' flag.
This is a sprintf(3) format string which can have a single
``%ld'' parameter which will be given the size of the article.
If the separator is not empty, then the string and a newline
will be output before every article. The default separator is
``#! rnews %ld''.
-p By default, batches are written to standard output, which is not
useful when more than one output batch is created. Use the
``-p'' flag to specify the shell command that should be created
(via popen(3)) whenever a new batch is started. The process is
a sprintf format string which can have a single ``%s'' parameter
which will be given the host name. A common value is:
( echo '#! cunbatch' ; exec compress ) | uux - -r -z %s!rnews
EXIT STATUS
If the input is exhausted, batcher will exit with a zero status. If any of the limits specified with the ``-B,'' ``-A,'' or ``-N'' flags is reached, or if there is an error writing the batch, then batcher will try to spool the input, copying it to a file. If there was no input filename, the standard input will be copied to /var/spool/news/out.going/host and the program will exit. If an input filename was given, a temporary file named input.bch (if input is an absolute pathname) or /var/spool/news/out.going/input.bch (if the filename does not begin with a slash) is created. Once the input is copied, batcher will try to rename this temporary file to be the name of the input file, and then exit. Upon receipt of an interrupt or termination signal, batcher will finish sending the current article, close the batch, and then rewrite the batchfile according as described in the previous paragraph.
HISTORY
Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. This is revision 1.18, dated 1996/10/29.
SEE ALSO
ctlinnd(8), newsfeeds(5), shlock(1). BATCHER(8)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
