usr.bin/lastcomm/lastcomm.1

   1 .\" Copyright (c) 1980, 1990, 1993
   2 .\"     The Regents of the University of California.  All rights reserved.
   3 .\"
   4 .\" Redistribution and use in source and binary forms, with or without
   5 .\" modification, are permitted provided that the following conditions
   6 .\" are met:
   7 .\" 1. Redistributions of source code must retain the above copyright
   8 .\"    notice, this list of conditions and the following disclaimer.
   9 .\" 2. Redistributions in binary form must reproduce the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer in the
  11 .\"    documentation and/or other materials provided with the distribution.
  12 .\" 3. Neither the name of the University nor the names of its contributors
  13 .\"    may be used to endorse or promote products derived from this software
  14 .\"    without specific prior written permission.
  15 .\"
  16 .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  19 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  26 .\" SUCH DAMAGE.
  27 .\"
  28 .Dd May 17, 2012
  29 .Dt LASTCOMM 1
  30 .Os
  31 .Sh NAME
  32 .Nm lastcomm
  33 .Nd show last commands executed
  34 .Sh SYNOPSIS
  35 .Nm
  36 .Op Fl EScesu
  37 .Op Fl f Ar file
  38 .Op Cm + Ns Ar format
  39 .Op Ar command ...\&
  40 .Op Ar user ...\&
  41 .Op Ar terminal ...\&
  42 .Sh DESCRIPTION
  43 The
  44 .Nm
  45 utility gives information on previously executed commands.
  46 With no arguments,
  47 .Nm
  48 prints information about all the commands recorded
  49 during the current accounting file's lifetime.
  50 .Pp
  51 The following options are available:
  52 .Bl -tag -width indent
  53 .It Fl E
  54 Print the time the process exited.
  55 .It Fl S
  56 Print the time the process started.
  57 .It Fl c
  58 Print the amount of cpu time used by the process.
  59 .It Fl e
  60 Print the amount of elapsed time used by the process.
  61 .It Fl s
  62 Print the amount of system time used by the process.
  63 .It Fl u
  64 Print the amount of user time used by the process.
  65 .It Fl f Ar file
  66 Read from
  67 .Ar file
  68 rather than the default
  69 .Pa /var/account/acct .
  70 If
  71 .Ar file
  72 is a single dash
  73 .Pq Sq \&-
  74 .Nm
  75 reads accounting entries from the standard input.
  76 .El
  77 .Pp
  78 An operand with a leading plus sign
  79 .Pq Sq +
  80 is followed a user-defined format string which specifies the format
  81 in which to display the process's start or exit date and time.
  82 The format string may contain any of the conversion specifications
  83 described in the
  84 .Xr strftime 3
  85 manual page, as well as arbitrary text.
  86 .Pp
  87 If no options are specified,
  88 .Fl cS
  89 is assumed.
  90 If
  91 .Nm
  92 is invoked with arguments, only accounting entries with a
  93 matching
  94 .Ar command
  95 name,
  96 .Ar user
  97 name,
  98 or
  99 .Ar terminal
 100 name
 101 are printed.
 102 For example:
 103 .Pp
 104 .Dl lastcomm a.out root ttyd0
 105 .Pp
 106 would produce a listing of all the
 107 executions of commands named
 108 .Pa a.out
 109 by user
 110 .Ar root
 111 on the terminal
 112 .Ar ttyd0 .
 113 .Pp
 114 For each process entry, the following are printed.
 115 .Pp
 116 .Bl -bullet -offset indent -compact
 117 .It
 118 The name of the user who ran the process.
 119 .It
 120 Flags, as accumulated by the accounting facilities in the system.
 121 .It
 122 The command name under which the process was called.
 123 .It
 124 The amount of
 125 CPU
 126 .Pq Fl c ,
 127 wall
 128 .Pq Fl e ,
 129 system
 130 .Pq Fl s ,
 131 or user
 132 .Pq Fl u
 133 time used by the process (in seconds).
 134 .It
 135 The time the process started
 136 .Pq Fl S
 137 or exited
 138 .Pq Fl E .
 139 .El
 140 .Pp
 141 The flags are encoded as follows: ``S'' indicates the command was
 142 executed by the super-user, ``F'' indicates the command ran after
 143 a fork, but without a following
 144 .Xr exec 3 ,
 145 .\" ``C'' indicates the command was run in PDP-11 compatibility mode
 146 .\" (VAX only),
 147 ``D'' indicates the command terminated with the generation of a
 148 .Pa core
 149 file, and ``X'' indicates the command was terminated with a signal.
 150 .Pp
 151 By default, accounting entries are printed going backwards in time,
 152 starting from the time
 153 .Nm
 154 was executed.
 155 However, if
 156 .Nm
 157 reads entries from its standard input, then entries are printed in
 158 the order they are read.
 159 .Sh FILES
 160 .Bl -tag -width /var/account/acct -compact
 161 .It Pa /var/account/acct
 162 default accounting file
 163 .El
 164 .Sh EXAMPLES
 165 The command
 166 .Dl lastcomm -Ee
 167 will print the exit time and elapsed time of each command logged in
 168 .Pa /var/account/acct ,
 169 while
 170 .Dl tail -f -c 0 /var/account/acct | lastcomm -f -
 171 will print details of each terminating command.
 172 .Sh SEE ALSO
 173 .Xr last 1 ,
 174 .Xr sigaction 2 ,
 175 .Xr strftime 3 ,
 176 .Xr acct 5 ,
 177 .Xr core 5
 178 .Sh HISTORY
 179 The
 180 .Nm
 181 command appeared in
 182 .Bx 3.0 .