sm - Command-line interface to the INN storage manager
sm [-cdHiqRrSs] [token ...]
The INN storage manager is the subsystem that stores and keeps track of all of the articles and what storage backend they're in. All stored articles are assigned a storage API token. sm is a command-line interface to that storage manager, primarily used to retrieve articles by those tokens but also to perform other operations on the storage subsystem. token is the token of an article (the same thing that's returned by grephistory or stored in the history file). It looks something like: @0502000005A4000000010000000000000000@ Any number of tokens can be given on the command-line for any function other than -s. If none are, sm normally reads tokens from standard input, one per line. The default operation is to retrieve and write to standard output the corresponding article for each token given. If -s is given, sm instead stores the article given on standard input (in native format, not wire format) using the standard rules of the storage subsystem. If the article is stored successfully, the token of the article is printed to standard output. Please note that this does not make any attempt to write a history entry or any overview data, and is therefore only useful under very specific circumstances.
-c Show a clear, decoded form of the storage API token. Each part of the token is explained, in a human-readable string. Amongst other elements, this command gives the path to where the corresponding article is supposed to be stored. -d, -r Rather than retrieving the specified article, remove the article. This will delete the article out of the news spool and it will not subsequently be retrievable by any part of INN. It's equivalent to "ctlinnd cancel" except it takes a storage API token instead of a message-ID. -H Retrieve only the headers of the article rather than the entire article. This option cannot be used with -d, -r, -i, or -S. -i Show the newsgroup name and article number associated with the token rather than the article itself. Note that for crossposted articles, only the first newsgroup and article number to which the article is associated will be returned. -q Suppress all error messages except usage errors. -R Display the raw article. This means that line endings won't be converted to native line endings and will be left as CRLF sequences; leading periods will still be escaped for sending over NNTP, and the article will end in a CRLF.CRLF sequence. -S Write the article to standard output in the format used by rnews spool files. Multiple articles can be written in this format, and the resulting output can be fed to rnews (on another system, for example) to inject those articles into INN. This option cannot be used with -d, -r, -H, -i, or -R. -s Store the article given on standard input using the normal storage rules for articles as configured in storage.conf(5). Print the new token for the message to standard output if it is stored successfully. If this option is given, no other options except possibly -q should be given.
If all operations were successful, sm exits with status 0. If an operation on any of the provided tokens fails, sm will exit with status 1, even if the operations on other tokens were successful. In other words, if twenty tokens are fed to "sm -r" on stdin, 19 articles were successfully removed, but the sixth article couldn't be found, sm will still exit with status 1. This means that if you need to be sure whether a particular operation succeeded, you should run sm on one token at a time.
Written by Katsuhiro Kondou <firstname.lastname@example.org> for InterNetNews. Rewritten in POD by Russ Allbery <email@example.com>. $Id: sm.pod 9767 2014-12-07 21:13:43Z iulius $
ctlinnd(8), grephistory(1), history(5), rnews(1), storage.conf(5).
More Linux Commands
Tcl_DeleteThreadExitHandler(3) - end the application or thre
The procedures described here provide a graceful mechanism to end the execution of a Tcl application. Exit handlers are invoked to cleanup the applications stat
FcStrPlus(3) - concatenate two strings - Linux manual page
This function allocates new storage and places the concatenation of s1 and s2 there, returning the new string. VERSION Fontconfig version 2.8.0 FcStrPlus.3 (Lib
pam_sm_setcred(3) - PAM service function to alter credential
The pam_sm_setcred function is the service modules implementation of the pam_setcred(3) interface. This function performs the task of altering the credentials o
menu_userptr(3menu) - associate application data with a menu
Every menu item has a field that can be used to hold application-specific data (that is, the menu-driver code leaves it alone). These functions get and set that
chage(1) - change user password expiry information (ManPage)
The chage command changes the number of days between password changes and the date of the last password change. This information is used by the system to determ
systemd-ask-password(1) - Query the user for a system passwo
systemd-ask-password may be used to query a system password or passphrase from the user, using a question message specified on the command line. When run from a
snmp_api_errstring(3) - netsnmp_session_api functions.......
Snmp_sess_init prepares a netsnmp_session that sources transport characteristics and common information that will be used for a set of SNMP transactions. After
sane(7) - Scanner Access Now Easy: API for accessing scanner
SANE is an application programming interface (API) that provides standardized access to any raster image scanner hardware. The standardized interface makes it p
gnutls_pubkey_import_openpgp(3) - API function (Man Page)...
Imports a public key from an openpgp key. This function will import the given public key to the abstract gnutls_pubkey_t structure. The subkey set as preferred
Tcl_SetVar2(3) - manipulate Tcl variables - Linux man page
These procedures are used to create, modify, read, and delete Tcl variables from C code. Tcl_SetVar2Ex, Tcl_SetVar, Tcl_SetVar2, and Tcl_ObjSetVar2 will create
XShapeCombineRegion(3) - X nonrectangular shape functions...
The X11 Nonrectangular Window Shape Extension adds nonrectangular windows to the X Window System. PREDEFINED VALUES Operations: ShapeSet ShapeUnion ShapeInterse
zshroadmap(1) - informal introduction to the zsh manual.....
The Zsh Manual, like the shell itself, is large and often complicated. This section of the manual provides some pointers to areas of the shell that are likely..