NAME
snscan - display information on articles in the spool
sncat - display articles in the spool
sncancel - cancel articles in the spool
SYNOPSIS
snscan [options] articlespec...
sncat [options] articlespec...
sncancel [options] articlespec...
options: [-n] [-s since] [-o outputfile]
DESCRIPTION
snscan displays information on all articles specified by articlespec,
in the form
newsgroup serial id
on a line, one line per article matched. This output is
suitable for feeding to snprimedb.
sncat displays the articles specified by articlespec.
sncancel
marks articles specified by articlespec as canceled, so they
become unavailable to sn programs.
ARGUMENTS
articlespec defines a broad pattern for articles. It takes two
mutually exclusive forms.
Specify by newsgroup and serial number
Here articlespec is
newsgroup[:range[,range]...]
where each range is
serial[-[toserial]]
(where toserial is greater than serial). If toserial is
omitted, then all articles after serial are matched. If both
serial and toserial are empty, then only the first and last
articles are matched.
Specify by articles message ID
Here articlespec is -i id...
where each id is a message ID, angle brackets optional.
OPTIONS
-n This option weeds out articles that are aliases. If an article
is crossposted, there will be an original copy, the others will
be aliases to it. This option prevents information being
displayed if it is not from the original copy.
-ssince
This option weeds out articles that were obtained before since.
since is in the format year/month/day[:hour:minute] where each
is a number. year may be 2 or 4 digits, and / and : can be any
non-digit character.
-ooutputfile
Write output to outputfile instead of descriptor 1. Sometimes
you just don’t feel like using the shell.
EXAMPLES
sncancel linux.lemmings:12
Cancel article 12 from linux.lemmings.
snscan linux.lemmings:4,12-
Display information on article 4, and also articles 12 to the
most recent article, from linux.lemmings.
sncat -n -s 1998/4/1 linux.lemmings
Display all articles that are not aliases, and which were
entered after April 1 1998, from linux.lemmings.
snscan -i ’123@myhost’
Display information on the article whose ID is <123@myhost>, in
whichever newsgroup it is found.
FILES
Each articlespec or id on the command line refers to articles in the
news spool located in /var/spool/sn.
ENVIRONMENT VARIABLES
SNROOT If this is set and is not empty, the value is used in place of
/var/spool/sn, the default news spool directory.
EXIT CODES
snscan exits 0 on success, 1 on usage error, 2 on system error, and 3
on other errors. It is not an error to specify an article that does
not exist, or which does not meet the since criterion.
SEE ALSO
snprimedb(8)