share/man/man8/runacct.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 RUNACCT 8 "May 11, 1999"
   7 .SH NAME
   8 runacct \- run daily accounting
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fB/usr/lib/acct/runacct\fR [\fImmdd\fR [\fIstate\fR]]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 \fBrunacct\fR is the main daily accounting shell procedure. It is normally
  19 initiated using  \fBcron\fR. \fBrunacct\fR processes connect, fee, disk, and
  20 process accounting files. It also prepares summary files for \fBprdaily\fR or
  21 billing purposes. \fBrunacct\fR is distributed only to source code licensees.
  22 .sp
  23 .LP
  24 \fBrunacct\fR takes care not to damage active accounting files or summary files
  25 in the event of errors. It records its progress by writing descriptive
  26 diagnostic messages into \fBactive\fR. When an error is detected, a message is
  27 written to \fB/dev/console\fR, mail (see \fBmail\fR(1)) is sent to \fBroot\fR
  28 and \fBadm\fR, and \fBrunacct\fR terminates. \fBrunacct\fR uses a series of
  29 lock files to protect against re-invocation. The files \fBlock\fR and
  30 \fBlock1\fR are used to prevent simultaneous invocation, and \fBlastdate\fR is
  31 used to prevent more than one invocation per day.
  32 .sp
  33 .LP
  34 \fBrunacct\fR breaks its processing into separate, restartable \fIstates\fR
  35 using \fBstatefile\fR to remember the last \fIstate\fR completed. It
  36 accomplishes this by writing the \fIstate\fR name into \fBstatefile\fR.
  37 \fBrunacct\fR then looks in \fBstatefile\fR to see what it has done and to
  38 determine what to process next. \fIstates\fR are executed in the following
  39 order:
  40 .sp
  41 .ne 2
  42 .na
  43 \fB\fBSETUP\fR\fR
  44 .ad
  45 .RS 14n
  46 Move active accounting files into working files.
  47 .RE
  48
  49 .sp
  50 .ne 2
  51 .na
  52 \fB\fBWTMPFIX\fR\fR
  53 .ad
  54 .RS 14n
  55 Verify integrity of \fBwtmpx\fR file, correcting date changes if necessary.
  56 .RE
  57
  58 .sp
  59 .ne 2
  60 .na
  61 \fB\fBCONNECT\fR\fR
  62 .ad
  63 .RS 14n
  64 Produce connect session records in \fBtacct.h\fR format.
  65 .RE
  66
  67 .sp
  68 .ne 2
  69 .na
  70 \fB\fBPROCESS\fR\fR
  71 .ad
  72 .RS 14n
  73 Convert process accounting records into \fBtacct.h\fR format.
  74 .RE
  75
  76 .sp
  77 .ne 2
  78 .na
  79 \fB\fBMERGE\fR\fR
  80 .ad
  81 .RS 14n
  82 Merge the connect and process accounting records.
  83 .RE
  84
  85 .sp
  86 .ne 2
  87 .na
  88 \fB\fBFEES\fR\fR
  89 .ad
  90 .RS 14n
  91 Convert output of \fBchargefee\fR into \fBtacct.h\fR format, merge with
  92 connect, and process accounting records.
  93 .RE
  94
  95 .sp
  96 .ne 2
  97 .na
  98 \fB\fBDISK\fR\fR
  99 .ad
 100 .RS 14n
 101 Merge disk accounting records with connect, process, and fee accounting
 102 records.
 103 .RE
 104
 105 .sp
 106 .ne 2
 107 .na
 108 \fB\fBMERGETACCT\fR\fR
 109 .ad
 110 .RS 14n
 111 Merge the daily total accounting records in \fBdaytacct\fR with the summary
 112 total accounting records in \fB/var/log/acct/sum/tacct\fR.
 113 .RE
 114
 115 .sp
 116 .ne 2
 117 .na
 118 \fB\fBCMS\fR\fR
 119 .ad
 120 .RS 14n
 121 Produce command summaries.
 122 .RE
 123
 124 .sp
 125 .ne 2
 126 .na
 127 \fB\fBUSEREXIT\fR\fR
 128 .ad
 129 .RS 14n
 130 Any installation dependent accounting programs can be included here.
 131 .RE
 132
 133 .sp
 134 .ne 2
 135 .na
 136 \fB\fBCLEANUP\fR\fR
 137 .ad
 138 .RS 14n
 139 Clean up temporary files and exit. To restart \fBrunacct\fR after a failure,
 140 first check the \fBactive\fR file for diagnostics, then fix any corrupted data
 141 files, such as \fBpacct\fR or \fBwtmpx\fR. The \fBlock\fR, \fBlock1\fR, and
 142 \fBlastdate\fR files must be removed  before \fBrunacct\fR can be restarted.
 143 The argument \fImmdd\fR is necessary if \fBrunacct\fR is being restarted.
 144 \fImmdd\fR specifies the month and day for which \fBrunacct\fR will rerun the
 145 accounting. The entry point for processing is based on the contents of \fB
 146 statefile\fR; to override this, include the desired \fIstate\fR on the command
 147 line to designate where processing should begin.
 148 .RE
 149
 150 .SH EXAMPLES
 151 .LP
 152 \fBExample 1 \fRStarting \fBrunacct\fR
 153 .sp
 154 .LP
 155 The following example starts \fBrunacct\fR:
 156
 157 .sp
 158 .in +2
 159 .nf
 160 example% nohup runacct 2> /var/log/acct/nite/fd2log &
 161 .fi
 162 .in -2
 163 .sp
 164
 165 .LP
 166 \fBExample 2 \fRRestarting \fBrunacct\fR
 167 .sp
 168 .LP
 169 The following example restarts \fBrunacct\fR:
 170
 171 .sp
 172 .in +2
 173 .nf
 174 example% nohup runacct 0601 2>> /var/log/acct/nite/fd2log &
 175 .fi
 176 .in -2
 177 .sp
 178
 179 .LP
 180 \fBExample 3 \fRRestarting \fBrunacct\fR at a Specific State
 181 .sp
 182 .LP
 183 The following example restarts \fBrunacct\fR at a specific state:
 184
 185 .sp
 186 .in +2
 187 .nf
 188 example% nohup runacct 0601 MERGE 2>> /var/log/acct/nite/fd2log &
 189 .fi
 190 .in -2
 191 .sp
 192
 193 .SH FILES
 194 .sp
 195 .ne 2
 196 .na
 197 \fB\fB/var/log/wtmpx\fR\fR
 198 .ad
 199 .sp .6
 200 .RS 4n
 201 History of user access and administration information
 202 .RE
 203
 204 .sp
 205 .ne 2
 206 .na
 207 \fB\fB/var/log/pacct\fR\fIincr\fR\fR
 208 .ad
 209 .sp .6
 210 .RS 4n
 211
 212 .RE
 213
 214 .sp
 215 .ne 2
 216 .na
 217 \fB\fB/var/log/acct/nite/active\fR\fR
 218 .ad
 219 .sp .6
 220 .RS 4n
 221
 222 .RE
 223
 224 .sp
 225 .ne 2
 226 .na
 227 \fB\fB/var/log/acct/nite/daytacct\fR\fR
 228 .ad
 229 .sp .6
 230 .RS 4n
 231
 232 .RE
 233
 234 .sp
 235 .ne 2
 236 .na
 237 \fB\fB/var/log/acct/nite/lock\fR\fR
 238 .ad
 239 .sp .6
 240 .RS 4n
 241
 242 .RE
 243
 244 .sp
 245 .ne 2
 246 .na
 247 \fB\fB/var/log/acct/nite/lock1\fR\fR
 248 .ad
 249 .sp .6
 250 .RS 4n
 251
 252 .RE
 253
 254 .sp
 255 .ne 2
 256 .na
 257 \fB\fB/var/log/acct/nite/lastdate\fR\fR
 258 .ad
 259 .sp .6
 260 .RS 4n
 261
 262 .RE
 263
 264 .sp
 265 .ne 2
 266 .na
 267 \fB\fB/var/log/acct/nite/statefile\fR\fR
 268 .ad
 269 .sp .6
 270 .RS 4n
 271
 272 .RE
 273
 274 .SH SEE ALSO
 275 .sp
 276 .LP
 277 \fBacctcom\fR(1), \fBmail\fR(1), \fBacct\fR(8), \fBacctcms\fR(8),
 278 \fBacctcon\fR(8), \fBacctmerg\fR(8), \fBacctprc\fR(8), \fBacctsh\fR(8),
 279 \fBcron\fR(8), \fBfwtmp\fR(8), \fBacct\fR(2), \fBacct.h\fR(3HEAD),
 280 \fButmpx\fR(4), \fBattributes\fR(5)
 281 .SH NOTES
 282 .sp
 283 .LP
 284 It is not recommended to restart \fBrunacct\fR in the \fBSETUP\fR \fIstate\fR.
 285 Run \fBSETUP\fR manually and restart using:
 286 .sp
 287 .LP
 288 \fBrunacct\fR \fImmdd\fR \fBWTMPFIX\fR
 289 .sp
 290 .LP
 291 If \fBrunacct\fR failed in the \fBPROCESS\fR \fIstate,\fR remove the last
 292 \fBptacct\fR file because it will not be complete.
 293 .sp
 294 .LP
 295 The \fBrunacct\fR command can process a maximum of
 296 .RS +4
 297 .TP
 298 .ie t \(bu
 299 .el o
 300 6000 distinct sessions
 301 .RE
 302 .RS +4
 303 .TP
 304 .ie t \(bu
 305 .el o
 306 1000 distinct terminal lines
 307 .RE
 308 .RS +4
 309 .TP
 310 .ie t \(bu
 311 .el o
 312 2000 distinct login names
 313 .RE
 314 .sp
 315 .LP
 316 during a single invocation of the command.  If at some point the actual number
 317 of any one of these items exceeds the maximum, the command will not succeed.
 318 .sp
 319 .LP
 320 Do not invoke \fBrunacct\fR at the same time as \fBckpacct\fR, as there may be
 321 a conflict if both scripts attempt to execute \fBturnacct switch\fR
 322 simultaneously.