usr/src/man/man1/acctcom.1

   1 '\" te
   2 .\"  Copyright 1989 AT&T
   3 .\" Copyright (c) 1996, Sun Microsystems, Inc.  All Rights Reserved
   4 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   5 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   6 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   7 .TH ACCTCOM 1 "Jan 11, 1996"
   8 .SH NAME
   9 acctcom \- search and print process accounting files
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fBacctcom\fR [\fB-abfhikmqrtv\fR] [\fB-C\fR \fIsec\fR] [\fB-e\fR \fItime\fR] [\fB-E\fR \fItime\fR]
  14      [\fB-g\fR \fIgroup\fR] [\fB-H\fR \fIfactor\fR] [\fB-I\fR \fIchars\fR] [\fB-l\fR \fIline\fR]
  15      [\fB-n\fR \fIpattern\fR] [\fB-o\fR \fIoutput-file\fR] [\fB-O\fR \fIsec\fR] [\fB-s\fR \fItime\fR]
  16      [\fB-S\fR \fItime\fR] [\fB-u\fR \fIuser\fR] [\fIfilename\fR]...
  17 .fi
  18
  19 .SH DESCRIPTION
  20 .sp
  21 .LP
  22 The \fBacctcom\fR utility reads \fIfilename\fRs, the standard input, or
  23 \fB/var/adm/pacct\fR, in the form described by \fBacct.h\fR(3HEAD) and writes
  24 selected records to standard output. Each record represents the execution of
  25 one process. The output shows the \fBCOMMAND NAME\fR, \fBUSER\fR,
  26 \fBTTYNAME\fR, \fBSTART TIME\fR, \fBEND TIME\fR, \fBREAL (SEC)\fR, \fBCPU
  27 (SEC)\fR, \fBMEAN SIZE (K)\fR, and optionally, \fBF\fR (the
  28 \fBfork()\fR/\fBexec()\fR flag: \fB1\fR for \fBfork()\fR without \fBexec()\fR),
  29 \fBSTAT\fR (the system exit status), \fBHOG FACTOR\fR, \fBKCORE MIN\fR, \fBCPU
  30 FACTOR\fR, \fBCHARS TRNSFD\fR, and  \fBBLOCKS\fR \fBREAD\fR (total blocks read
  31 and written).
  32 .sp
  33 .LP
  34 A  `\fB#\fR' is prepended to the command name if the command was executed with
  35 super-user privileges. If a process is not associated with a known terminal, a
  36 `\fB?\fR' is printed in the \fBTTYNAME\fR field.
  37 .sp
  38 .LP
  39 If no  \fIfilename\fR is specified, and if the standard input is associated
  40 with a terminal or \fB/dev/null\fR (as is the case when using `\fB&\fR\&' in
  41 the shell), \fB/var/adm/pacct\fR is read; otherwise, the standard input is
  42 read.
  43 .sp
  44 .LP
  45 If any \fIfilename\fR arguments are given, they are read in their respective
  46 order. Each file is normally read forward, that is, in chronological order by
  47 process completion time. The file \fB/var/adm/pacct\fR is usually the current
  48 file to be examined; a busy system may need several such files of which all but
  49 the current file are found in \fB/var/adm/pacct\fIincr\fR\fR.
  50 .SH OPTIONS
  51 .sp
  52 .LP
  53 The following options are supported:
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-a\fR\fR
  58 .ad
  59 .RS 18n
  60 Show some average statistics about the processes selected. The statistics will
  61 be printed after the output records.
  62 .RE
  63
  64 .sp
  65 .ne 2
  66 .na
  67 \fB\fB-b\fR\fR
  68 .ad
  69 .RS 18n
  70 Read backwards, showing latest commands first. This option has no effect when
  71 standard input is read.
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB-f\fR\fR
  78 .ad
  79 .RS 18n
  80 Print the \fBfork()\fR/\fBexec()\fR flag and system exit status columns in the
  81 output. The numeric output for this option will be in octal.
  82 .RE
  83
  84 .sp
  85 .ne 2
  86 .na
  87 \fB\fB-h\fR\fR
  88 .ad
  89 .RS 18n
  90 Instead of mean memory size, show the fraction of total available \fBCPU\fR
  91 time consumed by the process during its execution. This "hog factor" is
  92 computed as (total \fBCPU\fR time)/(elapsed time).
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fB-i\fR\fR
  99 .ad
 100 .RS 18n
 101 Print columns containing the \fBI/O\fR counts in the output.
 102 .RE
 103
 104 .sp
 105 .ne 2
 106 .na
 107 \fB\fB-k\fR\fR
 108 .ad
 109 .RS 18n
 110 Instead of memory size, show total kcore-minutes.
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB-m\fR\fR
 117 .ad
 118 .RS 18n
 119 Show mean core size (the default).
 120 .RE
 121
 122 .sp
 123 .ne 2
 124 .na
 125 \fB\fB-q\fR\fR
 126 .ad
 127 .RS 18n
 128 Do not print any output records, just print the average statistics as with the
 129 \fB-a\fR option.
 130 .RE
 131
 132 .sp
 133 .ne 2
 134 .na
 135 \fB\fB-r\fR\fR
 136 .ad
 137 .RS 18n
 138 Show \fBCPU\fR factor (user-time/(system-time + user-time)).
 139 .RE
 140
 141 .sp
 142 .ne 2
 143 .na
 144 \fB\fB-t\fR\fR
 145 .ad
 146 .RS 18n
 147 Show separate system and user \fBCPU\fR times.
 148 .RE
 149
 150 .sp
 151 .ne 2
 152 .na
 153 \fB\fB-v\fR\fR
 154 .ad
 155 .RS 18n
 156 Exclude column headings from the output.
 157 .RE
 158
 159 .sp
 160 .ne 2
 161 .na
 162 \fB\fB-C\fR \fIsec\fR\fR
 163 .ad
 164 .RS 18n
 165 Show only processes with total \fBCPU\fR time (system-time + user-time)
 166 exceeding \fIsec\fR seconds.
 167 .RE
 168
 169 .sp
 170 .ne 2
 171 .na
 172 \fB\fB-e\fR \fItime\fR\fR
 173 .ad
 174 .RS 18n
 175 Select processes existing at or before \fItime\fR.
 176 .RE
 177
 178 .sp
 179 .ne 2
 180 .na
 181 \fB\fB-E\fR \fItime\fR\fR
 182 .ad
 183 .RS 18n
 184 Select processes ending at or before \fItime\fR. Using the same \fItime\fR for
 185 both \fB-S\fR and \fB-E\fR shows the processes that existed at \fItime\fR.
 186 .RE
 187
 188 .sp
 189 .ne 2
 190 .na
 191 \fB\fB-g\fR \fIgroup\fR\fR
 192 .ad
 193 .RS 18n
 194 Show only processes belonging to \fIgroup\fR. The \fIgroup\fR may be designated
 195 by either the group \fBID\fR or group name.
 196 .RE
 197
 198 .sp
 199 .ne 2
 200 .na
 201 \fB\fB-H\fR \fIfactor\fR\fR
 202 .ad
 203 .RS 18n
 204 Show only processes that exceed \fBfactor\fR, where factor is the "hog factor"
 205 as explained in option \fB-h\fR above.
 206 .RE
 207
 208 .sp
 209 .ne 2
 210 .na
 211 \fB\fB-I\fR \fIchars\fR\fR
 212 .ad
 213 .RS 18n
 214 Show only processes transferring more characters than the cutoff number given
 215 by \fIchars\fR.
 216 .RE
 217
 218 .sp
 219 .ne 2
 220 .na
 221 \fB\fB-l\fR \fIline\fR\fR
 222 .ad
 223 .RS 18n
 224 Show only processes belonging to terminal \fB/dev/term/line\fR.
 225 .RE
 226
 227 .sp
 228 .ne 2
 229 .na
 230 \fB\fB-n\fR \fIpattern\fR\fR
 231 .ad
 232 .RS 18n
 233 Show only commands matching \fIpattern\fR that may be a regular expression as
 234 in \fBregcmp\fR(3C), except \fB+\fR means one or more occurrences.
 235 .RE
 236
 237 .sp
 238 .ne 2
 239 .na
 240 \fB\fB-o\fR \fIoutput-file\fR\fR
 241 .ad
 242 .RS 18n
 243 Copy selected process records in the input data format to \fIoutput-file\fR;
 244 suppress printing to standard output.
 245 .RE
 246
 247 .sp
 248 .ne 2
 249 .na
 250 \fB\fB-O\fR \fIsec\fR\fR
 251 .ad
 252 .RS 18n
 253 Show only processes with \fBCPU\fR system time exceeding \fIsec\fR seconds.
 254 .RE
 255
 256 .sp
 257 .ne 2
 258 .na
 259 \fB\fB-s\fR \fItime\fR\fR
 260 .ad
 261 .RS 18n
 262 Select processes existing at or after \fItime\fR, given in the format
 263 \fIhr\fR\|[\|:\fImin\fR\|[\|:\fIsec\fR\|]\|].
 264 .RE
 265
 266 .sp
 267 .ne 2
 268 .na
 269 \fB\fB-S\fR \fItime\fR\fR
 270 .ad
 271 .RS 18n
 272 Select processes starting at or after \fItime\fR.
 273 .RE
 274
 275 .sp
 276 .ne 2
 277 .na
 278 \fB\fB-u\fR \fIuser\fR\fR
 279 .ad
 280 .RS 18n
 281 Show only processes belonging to \fIuser\fR. The user may be specified by a
 282 user \fBID\fR, a login name that is then converted to a user \fBID\fR,
 283 `\fB#\fR' (which designates only those processes executed with superuser
 284 privileges), or `\fB?\fR' (which designates only those processes associated
 285 with unknown user \fBID\fRs).
 286 .RE
 287
 288 .SH FILES
 289 .sp
 290 .ne 2
 291 .na
 292 \fB\fB/etc/group\fR\fR
 293 .ad
 294 .RS 22n
 295 system group file
 296 .RE
 297
 298 .sp
 299 .ne 2
 300 .na
 301 \fB\fB/etc/passwd\fR\fR
 302 .ad
 303 .RS 22n
 304 system password file
 305 .RE
 306
 307 .sp
 308 .ne 2
 309 .na
 310 \fB\fB/var/adm/pacct\fIincr\fR\fR\fR
 311 .ad
 312 .RS 22n
 313 active processes accounting file
 314 .RE
 315
 316 .SH ATTRIBUTES
 317 .sp
 318 .LP
 319 See \fBattributes\fR(5) for descriptions of the following attributes:
 320 .sp
 321
 322 .sp
 323 .TS
 324 box;
 325 c | c
 326 l | l .
 327 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 328 _
 329 CSI     Enabled
 330 .TE
 331
 332 .SH SEE ALSO
 333 .sp
 334 .LP
 335 \fBps\fR(1), \fBacct\fR(1M), \fBacctcms\fR(1M), \fBacctcon\fR(1M),
 336 \fBacctmerg\fR(1M), \fBacctprc\fR(1M), \fBacctsh\fR(1M), \fBfwtmp\fR(1M),
 337 \fBrunacct\fR(1M), \fBsu\fR(1M), \fBacct\fR(2), \fBregcmp\fR(3C),
 338 \fBacct.h\fR(3HEAD), \fButmp\fR(4), \fBattributes\fR(5)
 339 .sp
 340 .LP
 341 \fISystem Administration Guide: Basic Administration\fR
 342 .SH NOTES
 343 .sp
 344 .LP
 345 \fBacctcom\fR reports only on processes that have terminated; use \fBps\fR(1)
 346 for active processes.