manpages.info - online man pages   

SunOS man pages : runacct (1)

Maintenance Commands                                  runacct(1M)

NAME

runacct - run daily accounting

SYNOPSIS

/usr/lib/acct/runacct [ mmdd [ state ] ]

DESCRIPTION

runacct is the main daily accounting shell procedure. It is normally initiated using cron. runacct processes connect, fee, disk, and process accounting files. It also prepares summary files for prdaily or billing purposes. runacct is distributed only to source code licensees. runacct takes care not to damage active accounting files or summary files in the event of errors. It records its pro- gress by writing descriptive diagnostic messages into active. When an error is detected, a message is written to /dev/console, mail (see mail(1)) is sent to root and adm, and runacct terminates. runacct uses a series of lock files to protect against re-invocation. The files lock and lock1 are used to prevent simultaneous invocation, and lastdate is used to prevent more than one invocation per day. runacct breaks its processing into separate, restartable states using statefile to remember the last state completed. It accomplishes this by writing the state name into sta- tefile. runacct then looks in statefile to see what it has done and to determine what to process next. states are exe- cuted in the following order: SETUP Move active accounting files into working files. WTMPFIX Verify integrity of wtmpx file, correcting date changes if necessary. CONNECT Produce connect session records in tacct.h format. PROCESS Convert process accounting records into tacct.h for- mat. MERGE Merge the connect and process accounting records. FEES Convert output of chargefee into tacct.h format, merge with connect, and process accounting records. DISK Merge disk accounting records with connect, process, and fee accounting records. MERGETACCT SunOS 5.8 Last change: 11 May 1999 1 Maintenance Commands runacct(1M) Merge the daily total accounting records in daytacct with the summary total accounting records in /var/adm/acct/sum/tacct. CMS Produce command summaries. USEREXIT Any installation dependent accounting programs can be included here. CLEANUP Clean up temporary files and exit. To restart runacct after a failure, first check the active file for diagnostics, then fix any corrupted data files, such as pacct or wtmpx. The lock, lock1, and lastdate files must be removed before runacct can be restarted. The argument mmdd is necessary if runacct is being res- tarted. mmdd specifies the month and day for which runacct will rerun the accounting. The entry point for processing is based on the contents of statefile; to override this, include the desired state on the com- mand line to designate where processing should begin.

EXAMPLES

Example 1: A sample display of using runacct command. The following example starts runacct: example% nohup runacct 2> /var/adm/acct/nite/fd2log & The following example restarts runacct: example% nohup runacct 0601 2>> /var/adm/acct/nite/fd2log & The following example restarts runacct at a specific state: example% nohup runacct 0601 MERGE 2>> /var/adm/acct/nite/fd2log &

FILES

/var/adm/wtmpx histroy of user access and administration information /var/adm/pacctincr /var/adm/acct/nite/active /var/adm/acct/nite/daytacct /var/adm/acct/nite/lock SunOS 5.8 Last change: 11 May 1999 2 Maintenance Commands runacct(1M) /var/adm/acct/nite/lock1 /var/adm/acct/nite/lastdate /var/adm/acct/nite/statefile

ATTRIBUTES

See attributes(5) for descriptions of the following attri- butes: ____________________________________________________________ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | |_____________________________|_____________________________| | Availability | SUNWaccu | |_____________________________|_____________________________|

SEE ALSO

acctcom(1), mail(1), acct(1M), acctcms(1M), acctcon(1M), acctmerg(1M), acctprc(1M), acctsh(1M), cron(1M), fwtmp(1M), acct(2), acct(4), utmpx(4), attributes(5)

NOTES

It is not recommended to restart runacct in the SETUP state. Run SETUP manually and restart using: runacct mmdd WTMPFIX If runacct failed in the PROCESS state, remove the last ptacct file because it will not be complete. The runacct command can process a maximum of 6000 distinct sessions 1000 distinct terminal lines 2000 distinct login names during a single invocation of the command. If at some point the actual number of any one of these items exceeds the max- imum, the command will not succeed. Do not invoke runacct at the same time as ckpacct, as there may be a conflict if both scripts attempt to execute tur- nacct switch simultaneously. SunOS 5.8 Last change: 11 May 1999 3