rushlast - show listing of last Rush logins
rushlast [-Hh] [-F STRING] [-f DIR]
[-n NUMBER] [--file=DIR]
[--format=STRING] [--forward] [--help]
[--no-header] [--number=NUMBER] [--usage]
[--version] [USER...]
This manpage is a short description of rushlast. 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 rushlast
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.
Searches back through the GNU Rush database and displays a list of all user
sessions since the database was created.
The utility operates on the default accounting database, which is
maintained only if rush(1) runs in accounting mode.
- -F, --format=STRING
- Use STRING instead of the default format. 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.
- --forward
- Show entries in chronological order.
- -H, --no-header
- Do not display header line.
- -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.
- RUSHLAST_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 RUSHLAST_FORMAT environment variable.
- 3.
- Built-in 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.
- (start-time WIDTH TITLE [:empty
REPL][:right][:format
DATE-FORMAT])
- Date and time when the session started.
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".
- (stop-time WIDTH TITLE [:empty
REPL][:right][:format
DATE-FORMAT])
- Time when the command finished. If it is still running, the word
running is output.
- (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.
The default format is:
(user 10 Login)" "
(rule 8 Rule)" "
(start-time 0 Start)" "
(stop-time 0 Stop)" "
(duration 7 Time)" "
(command 32 Command)
Report bugs to <bug-rush@gnu.org.ua>.
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.