bionic (1) rushlast.1.gz

Provided by: rush_1.8+dfsg-1.1_amd64 bug

NAME

       rushlast - show listing of last Rush logins

SYNOPSIS

       rushlast  [-Hh]  [-F  STRING]  [-f  DIR]  [-n NUMBER] [--file=DIR] [--format=STRING] [--forward] [--help]
       [--no-header] [--number=NUMBER] [--usage] [--version] [USER...]

NOTE

       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.

DESCRIPTION

       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.

OPTIONS

       -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.

ENVIRONMENT

       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.

FORMATS

       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)

SEE ALSO

       rush(1), rushwho(1).

AUTHORS

       Sergey Poznyakoff

BUG REPORTS

       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.