1SM(1)                     InterNetNews Documentation                     SM(1)
2
3
4

NAME

6       sm - Command-line interface to the INN storage manager
7

SYNOPSIS

9       sm [-dHiqRrS] [token ...]
10

DESCRIPTION

12       The INN storage manager is the subsystesm that stores and keeps track
13       of all of the articles and what storage backend they're in.  All stored
14       articles are assigned a storage API token.  sm is a command-line inter‐
15       face to that storage manager, primarily used to retrieve articles by
16       those tokens but also to perform other operations on the storage sub‐
17       system.
18
19       token is the token of an article (the same thing that's returned by
20       grephistory or stored in the history file).  It looks something like:
21
22           @0502000005A4000000010000000000000000@
23
24       Any number of tokens can be given on the command line.  If none are, sm
25       reads tokens from standard input, one per line.  The default operation
26       is to retrieve and write to standard output the corresponding article
27       for each token given.
28

OPTIONS

30       -d, -r
31           Rather than retrieving the specified article, remove the article.
32           This will delete the article out of the news spool and it will not
33           subsequently be retrievable by any part of INN.  It's equivalent to
34           "ctlinnd cancel" except it takes a storage API token instead of a
35           message ID.
36
37       -H  Retrieve only the header of the article rather than the entire
38           article.  This option cannot be used with -d, -r, -i, or -S.
39
40       -i  Show the newsgroup name and article number associated with the
41           token rather than the article itself.  Note that for crossposted
42           articles, only the first newsgroup and article number to which the
43           article is associated will be returned.
44
45       -q  Suppress all error messages except usage errors.
46
47       -R  Display the raw article.  This means that line endings won't be
48           converted to native line endings and will be left as CRLF
49           sequences, leading periods will still be escaped for sending over
50           NNTP, and the article will end in a CRLF.CRLF sequence.
51
52       -S  Write the article to standard output in the format used by rnews
53           spool files.  Multiple articles can be written in this format, and
54           the resulting output can be fed to rnews (on another system, for
55           example) to inject those articles into INN.  This option cannot be
56           used with -d, -r, -H, -i, or -R.
57

EXIT STATUS

59       If all operations were successful, sm exits with status 0.  If an oper‐
60       ation on any of the provided tokens fails, sm will exit with status 1,
61       even if the operations on other tokens were successful.  In other
62       words, if twenty tokens are fed to "sm -r" on stdin, 19 articles were
63       successfully removed, but the sixth article couldn't be found, sm will
64       still exit with status 1.
65
66       This means that if you need to be sure whether a particular operation
67       succeeded, you should run sm on one token at a time.
68

HISTORY

70       Written by Katsuhiro Kondou <kondou@nec.co.jp> for InterNetNews.
71       Rewritten in POD by Russ Allbery <rra@stanford.edu>.
72
73       $Id: sm.1 6683 2004-03-06 18:31:58Z rra $
74

SEE ALSO

76       ctlinnd(8), grephistory(1), history(5), rnews(1), storage.conf(5).
77
78
79
80INN 2.4.2                         2004-03-06                             SM(1)
Impressum