share/man/man8/acctcms.8

   1 '\" te
   2 .\"  Copyright 1989 AT&T Copyright (c) 1999, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" 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.
   4 .\" 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.
   5 .\" 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]
   6 .TH ACCTCMS 8 "Feb 22, 1999"
   7 .SH NAME
   8 acctcms \- command summary from process accounting records
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/acct/acctcms\fR [\fB-a\fR [\fB-o\fR] [\fB-p\fR]] [\fB-c\fR] [\fB-j\fR] [\fB-n\fR] [\fB-s\fR]
  13      [\fB-t\fR] \fIfilename\fR...
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 \fBacctcms\fR reads one or more \fIfilename\fRs, normally in the form described
  20 in \fBacct.h\fR(3HEAD). It adds all records for processes that executed
  21 identically named commands, sorts them, and writes them to the standard output,
  22 normally using an internal summary format.
  23 .SH OPTIONS
  24 .sp
  25 .ne 2
  26 .na
  27 \fB\fB-a\fR\fR
  28 .ad
  29 .RS 6n
  30 Print output in \fBASCII\fR rather than in the internal summary format. The
  31 output includes command name, number of times executed, total kcore-minutes,
  32 total \fBCPU\fR minutes, total real minutes, mean size (in K), mean \fBCPU\fR
  33 minutes per invocation, "hog factor," characters transferred, and blocks read
  34 and written, as in \fBacctcom\fR(1). Output is normally sorted by total
  35 kcore-minutes.
  36 .sp
  37 Use the following options only with the \fB-a\fR option:
  38 .sp
  39 .ne 2
  40 .na
  41 \fB\fB-o\fR\fR
  42 .ad
  43 .RS 6n
  44 Output a (non-prime) offshift-time-only command summary.
  45 .RE
  46
  47 .sp
  48 .ne 2
  49 .na
  50 \fB\fB-p\fR\fR
  51 .ad
  52 .RS 6n
  53 Output a prime-time-only command summary.
  54 .RE
  55
  56 When \fB-o\fR and \fB-p\fR are used together, a combination prime-time and
  57 non-prime-time report is produced.  All the output summaries are total usage
  58 except number of times executed, CPU minutes, and real minutes, which are split
  59 into prime and non-prime.
  60 .RE
  61
  62 .sp
  63 .ne 2
  64 .na
  65 \fB\fB-c\fR\fR
  66 .ad
  67 .RS 6n
  68 Sort by total \fBCPU\fR time, rather than total kcore-minutes.
  69 .RE
  70
  71 .sp
  72 .ne 2
  73 .na
  74 \fB\fB-j\fR\fR
  75 .ad
  76 .RS 6n
  77 Combine all commands invoked only once under "***other".
  78 .RE
  79
  80 .sp
  81 .ne 2
  82 .na
  83 \fB\fB-n\fR\fR
  84 .ad
  85 .RS 6n
  86 Sort by number of command invocations.
  87 .RE
  88
  89 .sp
  90 .ne 2
  91 .na
  92 \fB\fB-s\fR\fR
  93 .ad
  94 .RS 6n
  95 Any file names encountered hereafter are already in internal summary format.
  96 .RE
  97
  98 .sp
  99 .ne 2
 100 .na
 101 \fB\fB-t\fR\fR
 102 .ad
 103 .RS 6n
 104 Process all records as total accounting records. The default internal summary
 105 format splits each field into prime and non-prime-time parts. This option
 106 combines the prime and non-prime time parts into a single field that is the
 107 total of both, and provides upward compatibility with old style \fBacctcms\fR
 108 internal summary format records.
 109 .RE
 110
 111 .SH EXAMPLES
 112 .LP
 113 \fBExample 1 \fRUsing the \fBacctcms\fR command.
 114 .sp
 115 .LP
 116 A typical sequence for performing daily command accounting and for maintaining
 117 a running total is:
 118
 119 .sp
 120 .in +2
 121 .nf
 122 example%\fB acctcms filename ... > today\fR
 123 example% \fBcp total previoustotal\fR
 124 example% \fBacctcms \fR\fB-s\fR\fB today previoustotal > total\fR
 125 example% \fBacctcms \fR\fB-a\fR\fB \fR\fB-s\fR\fB today\fR
 126 .fi
 127 .in -2
 128 .sp
 129
 130 .SH SEE ALSO
 131 .sp
 132 .LP
 133 \fBacctcom\fR(1), \fBacct\fR(8), \fBacctcon\fR(8), \fBacctmerg\fR(8),
 134 \fBacctprc\fR(8), \fBacctsh\fR(8), \fBfwtmp\fR(8), \fBrunacct\fR(8),
 135 \fBacct\fR(2), \fBacct.h\fR(3HEAD), \fButmpx\fR(4), \fBattributes\fR(5)
 136 .SH NOTES
 137 .sp
 138 .LP
 139 Unpredictable output results if \fB-t\fR is used on new style internal summary
 140 format files, or if it is not used with old style internal summary format
 141 files.