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
-iid...
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.
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.