acctcon(ADM)                    19 June 1992                    acctcon(ADM)


 Name

    acctcon: acctcon1, acctcon2 - connect-time accounting

 Syntax

    /usr/lib/acct/acctcon1 [ options ]

    /usr/lib/acct/acctcon2

 Description

    acctcon1 converts a sequence of login/logoff records read from its stan-
    dard input to a sequence of records, one per login session.  Its input
    should normally be redirected from /etc/wtmp.  Its output is ASCII giving
    device, user IDs, login name, prime connect time (seconds), non-prime
    connect time (seconds), session starting time (numeric), and starting
    date and time.  The options are:

    -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 creates 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 pro-
            gress.  The -t flag causes it to use, instead, the last time
            found in its input, thus assuring reasonable and repeatable num-
            bers for non-current files.

    -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(M) 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(M) and utmp(F).

    -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.

    acctcon2 expects as input a sequence of login session records and con-
    verts them into total accounting records (see tacct format in acct(FP)).

 Examples

    These commands are typically used as shown below.  The file ctmp is cre-
    ated only for the use of acctprc(ADM) commands:

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

 File

    /etc/wtmp

 See also

    acct(ADM), acct(FP), acct(S), acctcms(ADM), acctcom(ADM), acctmerg(ADM),
    acctprc(ADM), acctsh(ADM), fwtmp(ADM), init(M), runacct(ADM), utmp(F)

 Note

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

    At the beginning of every year, the file /usr/lib/acct/holidays should be
    updated with the appropriate holidays for the new year, or acctcon1 will
    become confused when attempting to report on prime/non-prime connect
    times.

 Standards conformance

    acctcon1 and acctcon2 are conformant with:

    AT&T SVID Issue 2.