acctcon(1M)

NAME

acctcon, acctcon1, acctcon2 — connect-time accounting

SYNOPSIS

/usr/sbin/acct/acctcon [options]

/usr/sbin/acct/acctcon1 [options]

/usr/sbin/acct/acctcon2

DESCRIPTION

The acctcon1 command converts a sequence of login/logoff records read from its standard input to a sequence of records, one per login session. Its input should normally be redirected from /var/adm/wtmp or /var/adm/wtmps. Its output is ASCII, giving device, user ID, login name, prime connect time (seconds), non-prime connect time (seconds), session starting time (numeric), and starting date and time. Prime connect time is defined as the connect time within a specific prime period on a non-holiday weekday (Monday through Friday). The starting and ending time of the prime period and the year's holidays are defined in file /etc/acct/holidays.

acctcon2 expects as input a sequence of login session records, produced by acctcon1, and converts them into total accounting records (see tacct format in acct(4)).

acctcon combines the functionality of acctcon1 and acctcon2 into one program. It takes the same input format as acctcon1 and writes the same output as acctcon2.

acctcon1 recognizes the following options:

-p: Print input only, showing line name, login name, and time (in both numeric and date/time formats).
-t: acctcon1 maintains a list of lines on which users are logged in. When it reaches the end of its input, it emits a session record for each line that still appears to be active. It normally assumes that its input is a current file, so that it uses the current time as the ending time for each session still in progress. The -t flag causes it to use, instead, the last time found in its input, thus ensuring reasonable and repeatable numbers for non-current files.

acctcon1 and acctcon recognize the following options:

-l file: file is created to contain a summary of line usage showing line name, number of minutes used, percentage of total elapsed time used, number of sessions charged, number of logins, and number of logoffs. This file helps track line usage, identify bad lines, and find software and hardware oddities. Hang-up, termination of login (see login(1)), and termination of the login shell each generate logoff records, so that the number of logoffs is often three to four times the number of sessions. See init(1M) and utmp(4).
-o file: file is filled with an overall record for the accounting period, giving starting time, ending time, number of reboots, and number of date changes.
-W: When this option is used, the records of the type found in /var/adm/wtmps, are read from the specified input.

EXAMPLES

These commands are typically used as shown below. The file ctmp is created only for the use of commands described by the acctprc(1M) manual entry:

acctcon1 -t -l lineuse -o reboots < wtmp | sort +1n +2 > ctmp 
acctcon2 < ctmp | acctmerg > ctacct 

acctcon -t -l lineuse -o reboots < wtmp | acctmerg > ctacct 

With -W option:

acctcon1 -W -t -l lineuse -o reboots < wtmps | sort +1n +2 > ctmp 
acctcon2 < ctmp | acctmerg > ctacct 

acctcon -W -t -l lineuse -o reboots < wtmps | acctmerg > ctacct 

Note:

The file wtmps can be either /var/adm/wtmps or a file containing records of the type found in /var/adm/wtmps.

WARNINGS

The line usage report is confused by date changes. Use wtmpfix (see fwtmp(1M)) to correct this situation.

FILES

/var/adm/wtmp 
/var/adm/wtmps 
/etc/acct/holidays 

STANDARDS CONFORMANCE

acctcon1: SVID2, SVID3

acctcon2: SVID2, SVID3

acctcon(1M)

Technical documentation

» Table of Contents

» Index