File: snscan.8.in

package info (click to toggle)
sn 0.3.8-12
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 976 kB
  • sloc: ansic: 9,255; sh: 467; makefile: 210
file content (172 lines) | stat: -rw-r--r-- 3,189 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
.TH snscan,v!!VERSION!! 8 "Harold Tay" "N.B." \" -*- nroff -*-
.SH NAME
snscan \- display information on articles in the spool
.br
sncat \- display articles in the spool
.br
sncancel \- cancel articles in the spool

.SH SYNOPSIS
.B snscan
.RI [ options ]
.IR articlespec ...
.br
.B sncat
.RI [ options ]
.IR articlespec ...
.br
.B sncancel
.RI [ options ]
.IR articlespec ...
.br
.IR options :
.RI [- n ]
.RI [- s
.IR since ]
.RI [- o
.IR outputfile ]
.br
.SH DESCRIPTION
.TP
.B snscan
displays information on all articles specified by
.IR articlespec ,
in the form
.br
.I newsgroup serial id
.br
on a line, one line per article matched.  This output is suitable
for feeding to
.BR snprimedb .
.TP
.B sncat
displays the articles specified by
.IR articlespec .
.TP
.B sncancel
marks articles specified by
.I articlespec
as canceled, so they become unavailable to
.B sn
programs.


.SH ARGUMENTS
.I articlespec
defines a broad pattern for articles.  It takes two mutually exclusive
forms.
.TP
.B Specify by newsgroup and serial number
Here
.I articlespec
is
.br
.IR newsgroup [: range [, range ]...]
.br
where each
.I range
is
.br
.IR serial [-[ toserial ]]
.br
(where
.I toserial
is greater than
.IR serial ).
If
.I toserial
is omitted, then all articles after
.I serial
are matched.  If both
.I serial
and
.I toserial
are empty, then only the first and last articles are matched.

.TP
.B Specify by articles message ID
Here
.I articlespec is
.RI - i
.IR id ...
.br
where each
.I id
is a message ID, angle brackets optional.

.SH OPTIONS
.TP
.RB - 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.

.TP
.IB - s since
This option weeds out articles that were obtained before
.IR since .
.I since
is in the format
.IR year / month / day [: hour : minute ]
where each is a number.
.I year
may be 2 or 4 digits, and
.B /
and
.B :
can be any non-digit character.

.TP
.IB - o outputfile
Write output to
.I outputfile
instead of descriptor 1.  Sometimes you just don't feel like using
the shell.

.SH EXAMPLES
.TP
sncancel linux.lemmings:12
Cancel article 12 from linux.lemmings.
.TP
snscan linux.lemmings:4,12-
Display information on article 4, and also articles 12 to the most
recent article, from linux.lemmings.
.TP
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.
.TP
snscan -i '123@myhost'
Display information on the article whose ID is
.BR <123@myhost> ,
in whichever newsgroup it is found.

.SH FILES
Each
.I articlespec
or
.I id
on the command line refers to articles in the news spool
located in
.BR !!SNROOT!!.

.SH ENVIRONMENT VARIABLES
.TP
.B SNROOT
If this is set and is not empty, the value is used in place of
.BR !!SNROOT!! ,
the default news spool directory.

.SH EXIT CODES
.B 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
.I since
criterion.

.SH SEE ALSO
snprimedb(8)