/usr.bin/lastcomm/lastcomm.1

https://bitbucket.org/freebsd/freebsd-head/ · Unknown · 185 lines · 185 code · 0 blank · 0 comment · 0 complexity · 87668f6a9d931140b01153c987971555 MD5 · raw file

  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. .\" 4. 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. .\" From: @(#)lastcomm.1 8.1 (Berkeley) 6/6/93
  29. .\" $FreeBSD$
  30. .\"
  31. .Dd May 17, 2012
  32. .Dt LASTCOMM 1
  33. .Os
  34. .Sh NAME
  35. .Nm lastcomm
  36. .Nd show last commands executed
  37. .Sh SYNOPSIS
  38. .Nm
  39. .Op Fl EScesu
  40. .Op Fl f Ar file
  41. .Op Cm + Ns Ar format
  42. .Op Ar command ...\&
  43. .Op Ar user ...\&
  44. .Op Ar terminal ...\&
  45. .Sh DESCRIPTION
  46. The
  47. .Nm
  48. utility gives information on previously executed commands.
  49. With no arguments,
  50. .Nm
  51. prints information about all the commands recorded
  52. during the current accounting file's lifetime.
  53. .Pp
  54. The following options are available:
  55. .Bl -tag -width indent
  56. .It Fl E
  57. Print the time the process exited.
  58. .It Fl S
  59. Print the time the process started.
  60. .It Fl c
  61. Print the amount of cpu time used by the process.
  62. .It Fl e
  63. Print the amount of elapsed time used by the process.
  64. .It Fl s
  65. Print the amount of system time used by the process.
  66. .It Fl u
  67. Print the amount of user time used by the process.
  68. .It Fl f Ar file
  69. Read from
  70. .Ar file
  71. rather than the default
  72. .Pa /var/account/acct .
  73. If
  74. .Ar file
  75. is a single dash
  76. .Pq Sq \&-
  77. .Nm
  78. reads accounting entries from the standard input.
  79. .El
  80. .Pp
  81. An operand with a leading plus sign
  82. .Pq Sq +
  83. is followed a user-defined format string which specifies the format
  84. in which to display the process's start or exit date and time.
  85. The format string may contain any of the conversion specifications
  86. described in the
  87. .Xr strftime 3
  88. manual page, as well as arbitrary text.
  89. .Pp
  90. If no options are specified,
  91. .Fl cS
  92. is assumed.
  93. If
  94. .Nm
  95. is invoked with arguments, only accounting entries with a
  96. matching
  97. .Ar command
  98. name,
  99. .Ar user
  100. name,
  101. or
  102. .Ar terminal
  103. name
  104. are printed.
  105. For example:
  106. .Pp
  107. .Dl lastcomm a.out root ttyd0
  108. .Pp
  109. would produce a listing of all the
  110. executions of commands named
  111. .Pa a.out
  112. by user
  113. .Ar root
  114. on the terminal
  115. .Ar ttyd0 .
  116. .Pp
  117. For each process entry, the following are printed.
  118. .Pp
  119. .Bl -bullet -offset indent -compact
  120. .It
  121. The name of the user who ran the process.
  122. .It
  123. Flags, as accumulated by the accounting facilities in the system.
  124. .It
  125. The command name under which the process was called.
  126. .It
  127. The amount of
  128. CPU
  129. .Pq Fl c ,
  130. wall
  131. .Pq Fl e ,
  132. system
  133. .Pq Fl s ,
  134. or user
  135. .Pq Fl u
  136. time used by the process (in seconds).
  137. .It
  138. The time the process started
  139. .Pq Fl S
  140. or exited
  141. .Pq Fl E .
  142. .El
  143. .Pp
  144. The flags are encoded as follows: ``S'' indicates the command was
  145. executed by the super-user, ``F'' indicates the command ran after
  146. a fork, but without a following
  147. .Xr exec 3 ,
  148. .\" ``C'' indicates the command was run in PDP-11 compatibility mode
  149. .\" (VAX only),
  150. ``D'' indicates the command terminated with the generation of a
  151. .Pa core
  152. file, and ``X'' indicates the command was terminated with a signal.
  153. .Pp
  154. By default, accounting entries are printed going backwards in time,
  155. starting from the time
  156. .Nm
  157. was executed.
  158. However, if
  159. .Nm
  160. reads entries from its standard input, then entries are printed in
  161. the order they are read.
  162. .Sh FILES
  163. .Bl -tag -width /var/account/acct -compact
  164. .It Pa /var/account/acct
  165. default accounting file
  166. .El
  167. .Sh EXAMPLES
  168. The command
  169. .Dl lastcomm -Ee
  170. will print the exit time and elapsed time of each command logged in
  171. .Pa /var/account/acct ,
  172. while
  173. .Dl tail -f -c 0 /var/account/acct | lastcomm -f -
  174. will print details of each terminating command.
  175. .Sh SEE ALSO
  176. .Xr last 1 ,
  177. .Xr sigaction 2 ,
  178. .Xr strftime 3 ,
  179. .Xr acct 5 ,
  180. .Xr core 5
  181. .Sh HISTORY
  182. The
  183. .Nm
  184. command appeared in
  185. .Bx 3.0 .