acctcon(1M)                                                        acctcon(1M)


NAME
     acctcon, acctcon1, acctcon2 - connect-time accounting

SYNOPSIS
     /usr/lib/acct/acctcon [options]
     /usr/lib/acct/acctcon1 [options]
     /usr/lib/acct/acctcon2

DESCRIPTION
     acctcon converts a sequence of login/logoff records to total accounting
     records (see the tacct format in acct(4)).  Login/logoff records are read
     from standard input.  The file /var/adm/wtmp is usually the source of the
     login/logoff records; however, because it may contain corrupted records
     or system date changes, it should first be fixed using wtmpfix.  The
     fixed version of file /var/adm/wtmp can then be redirected to acctcon.
     The tacct records are written to standard output.  Here are the options
     for acctcon:

     -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.  Hangup,
               termination of 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.

     acctcon is a combination of the programs acctcon1 and acctcon2.  acctcon1
     converts login/logoff records, taken from the fixed /var/adm/wtmp file,
     to ASCII output.  acctcon2 reads the ASCII records produced by acctcon1
     and converts them to tacct records.  acctcon1 can be used with the -l and
     -o options, described above, as well as with 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 assuring reasonable and
               repeatable numbers for noncurrent files.


     acctcon1 and acctcon check the environment variable ACCT_A_TSIZE to
     figure out the maximum number of login lines that it might need to
     report.  acctcon checks the environment variable ACCT_A_USIZE to figure
     out the maximum number of distinct login names it might need to report.

EXAMPLES
     The acctcon command is typically used as follows:

          acctcon -l lineuse -o reboots < tmpwtmp > ctacct

     The acctcon1 and acctcon2 commands are typically used as follows:

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


FILES
     /var/adm/wtmp

REFERENCES
     acct(1M), acctcms(1M), acctcom(1), acctmerg(1M), acctprc(1M), acctsh(1M),
     fwtmp(1M), init(1M), login(1), runacct(1M), acct(2), acct(4), utmp(4).

NOTICES
     The line-usage report is confused by date changes.  Use wtmpfix (see
     fwtmp(1M)), with the /var/adm/wtmp file as an argument, to correct this
     situation.


                                                                        Page 2