Provided by: rush_1.8+dfsg-1.1_amd64 
NAME
rushwho - show who is logged on by rush(1)
SYNOPSIS
rushwho [-Hh] [-F STRING] [-f DIR] [--file=DIR] [--format=STRING] [--help] [--no-header] [--usage]
[--version]
NOTE
This manpage is a short description of rushwho. For a detailed discussion, including examples and usage
recommendations, refer to the manual GNU Rush -- a restricted user shell, available in texinfo format.
If the info reader and the rush documentation are properly installed on your system, the command
info rushwho
should give you access to the complete manual.
You can also view the manual using the info mode in emacs(1), or find it in various formats online at
http://www.gnu.org.ua/software/rush/manual
If any discrepancies occur between this manpage and the Manual, the later shall be considered the
authoritative source.
DESCRIPTION
Displays a list of users who are currently logged in by rush(1). The utility operates on the default accounting database, which is maintained if rush(1) runs in accounting mode.
OPTIONS
-F, --format=STRING
Use STRING instead of the default format. See the section FORMAT, for a detailed discussion of
the format syntax. If the STRING begins with a @, then this character is removed from it, and the
resulting string is regarded as a name of the file to read. The file is read literally, except
that lines beginning with a semicolon are ignored.
-f, --file=DIR
Look for database files in DIR.
-n, --count=NUMBER
Show at most NUMBER records.
Other options
-h, --help
Give this help list.
--usage
Give a short usage message.
--version
Print program version.
ENVIRONMENT
RUSHWHO_FORMAT
When set, supplies a format string to use instead of the built-in format. If the value begins
with a @ sign, rest of characters is treated as the name of file to read the format from,
similarly to the --format option, which see.
The precedence rule for format selection is:
1. The --format option.
2. The RUSHWHO_FORMAT environment variable.
3. Built-in format.
FORMAT
The format string supplied with the -F (--format) option controls the output of every record from the GNU
Rush accounting database. It consists of the following classes of objects:
Ordinary characters
These are copied to the output verbatim.
Escapes
An escape is a backslash, followed by a single character. It is interpreted according to the
following table:
Sequence Replaced with
\a Audible bell character (ASCII 7)
\b Backspace character (ASCII 8)
\e Escape character (ASCII 27)
\f Form-feed character (ASCII 12)
\n Newline character (ASCII 10)
\r Carriage return character (ASCII 13)
\t Horizontal tabulation character (ASCII 9)
\v Vertical tabulation character (ASCII 11)
\\ A single backslash
\" A double-quote.
Any escape not listed in the table above results in its second character being output.
Quoted strings
Strings are delimited by single or double quotes. Within a string escape sequences are
interpreted as described above.
Format specifications
Format specification can be regarded as a kind of function, which outputs a particular piece of
information from the database record. Syntactically, format specification starts with an opening
brace and ends with a closing brace. The first word after the brace is the name of the
specification. The rest of words are positional arguments followed by keyword arguments. Both
are optional. A keyword argument begins with a colon.
The available format specifications are:
(newline [COUNT])
Causes the newline character to be output. If the optional count is supplied, that many newlines
will be printed
(tab [COUNT])
Advance to the next tab stop in the output stream. If optional COUNT is present, then skip that
many tab stops. Each tab stop is eight characters long.
The following specifications output particular fields of a database record. They all take two positional
arguments: WIDTH and TITLE.
The first argument, WIDTH sets the maximum output length for this specification. If the number of
characters actually output is less than the width, they will be padded with whitespace either to the left
or to the right, depending on the presence of the :right keyword argument. If the number of characters
is greater than WIDTH, they will be truncated to fit. If WIDTH is not given, the exact data are output
as is.
The second argument, TITLE, gives the title of this column for the heading line. By default no title is
output.
Every field specification accepts at least two keyword arguments. The keyword :right may be used to
request alignment to the right for the data. This keyword is ignored if WIDTH is not given.
The keyword :empty followed by a string causes the program to output that string if the resulting value
for this specification would otherwise be empty.
(user WIDTH TITLE [:empty REPL][:right])
Print the user login name.
(time WIDTH TITLE [:empty REPL][:right][:format DATE-FORMAT])
Date and time when the session started. The word start-time can be used instead of time.
The :format keyword introduces the strftime(3) format string to be used when converting the date
for printing. The default value is "%a %H:%M".
(duration WIDTH TITLE [:empty REPL][:right])
Total time of the session duration.
(rule WIDTH TITLE [:right])
The tag of the rule that was used to serve the user.
(command WIDTH TITLE [:empty REPL][:right])
Command line being executed.
(pid WIDTH TITLE [:right])
PID of the process.
For example, the following is the default format for rushwho. It is written in a form, suitable for use
in a file supplied with the --format=@FILE option:
(user 10 Login)" "
(rule 8 Rule)" "
(start-time 0 Start)" "
(duration 9 Time)" "
(pid 10 PID)" "
(command 28 Command)
SEE ALSO
rush(1), rushwho(1).
AUTHORS
Sergey Poznyakoff
BUG REPORTS
Report bugs to <bug-rush@gnu.org.ua>.
COPYRIGHT
Copyright © 2016 Sergey Poznyakoff
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent
permitted by law.