Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

NEWSSTAR(1)			[FIXME: manual]			   NEWSSTAR(1)

NAME
       newsstar - NNTP news fetcher

SYNOPSIS
       newsstar [-A NUM] [-a] [-b] [-f] [-m] [-o SERVER] [--overview=PATH]
		[-q] [-r] [-s] [-sn | -snews] [--snstore=PATH] [-v] [-vv] [-w]
		[--preprocess] [--postprocess]

DESCRIPTION
       Newsstar(TM) fetches news from a number of remote NNTP servers and
       posts it to a local server (INN, s-news or sn), and also posts outgoing
       articles from the local server to the remote ones. It uses a
       configurable number of multiple processes or "threads" to maximise
       bandwidth utilisation. The threads are coordinated to avoid downloading
       multiple copies of the same article.

       This man page is just a summary. For more information see the README
       file and/or HTML documentation provided with the package.

OPTIONS
       A summary of options is included below.

       -A [NUM]
	   Scan the local server's active or .newsgroups file and ensure that
	   newsstar's newsrc files contain the same groups. If the optional
	   NUM parameter is specified, this is the number of the last article
	   fetched to be inserted for any newly created groups. Usually it
	   only makes sense to use a negative number to indicate the maximum
	   number of articles to download when the group is new.

       -a
	   In conjunction with -A this causes the newsrc files to be sorted by
	   newsgroup order.

       -b
	   Minimise the number of messages sent to STDOUT (brief).

       -f
	   Use full-screen mode with the curses library.

       -m
	   Articles that can't be posted are mailed back to the sender.

       -o SERVER
	   Only the named server is processed, all other newsrc files are
	   ignored.

       --overview PATH
	   s-news' overview binary is at PATH.

       -q
	   The running display of articles transferred etc is disabled if not
	   in full-screen mode.

       -r
	   If newsstar is maintaining its own history database, this option
	   makes it reorganize the database to free up unused space whenever
	   items are expired.

       -s
	   Standard messages (on STDOUT) are separated from debugging messages
	   on STDERR ie newsstar assumes each stream is sent to a separate
	   file or device.

       -sn
	   Use sn as server instead of INN.

       -snews
	   Use s-news as server instead of INN.

       --snstore=PATH
	   sn's snstore binary is at PATH.

       -v
	   Prints extra information useful for debugging on STDERR.

       -vv
	   Prints even more information on STDERR.

       -wWRAPPER
	   Specify a wrapper program to run the binary in, for example a
	   debugger. Note the lack of a space between -w and WRAPPER.

       --preprocess --postprocess
	   For debugging, these instruct the perl script just to perform its
	   functions prior to or after running the binary respectively,
	   without actually running the binary.

FILES
       /usr/local/etc/newsstar
	   Directory where static configuration files are stored.

       /usr/local/etc/newsstar/main.cf
	   Main configuration file.

       /usr/local/etc/newsstar/curses.cf
	   Configuration file for full-screen options.

       /usr/local/etc/newsstar/master.ignore
	   Perl regexps of newsgroups to ignore, common to every remote
	   server.

       /usr/local/etc/newsstar/cf.SERVER
	   Configuration file for each remote server.

       /usr/local/etc/newsstar/ignore.SERVER
	   Perl regexps of newsgroups to ignore, specific to each remote
	   server.

       /var/spool/newsstar/lib
	   Directory where data updated by newsstar is stored.

       /var/spool/newsstar/lib/newsrc.SERVER
	   List of newsgroups, with last article downloaded, for each remote
	   server. The presence of these files also controls which servers
	   newsstar connects to.

       /var/spool/newsstar/lib/history
	   GDBM history database.

       /var/spool/newsstar/incoming
	   Where downloaded articles are temporarily held.

       /var/spool/news/ /var/spool/sn/
	   The usual, and therefore default for newsstar, spool directories
	   used by INN and sn respectively.

SEE ALSO
       The program is documented fully by the HTML files starting at
       /usr/local/share/doc/newsstar/index.html. You should also read the
       README file in the same directory first.

AUTHOR
       Tony Houghton
	   Author.

COPYRIGHT
       Copyright © 2003 Tony Houghton

[FIXME: source]			 June 23, 2008			   NEWSSTAR(1)

Vote for polarhome