acctcon(8)acctcon(8)NAME
acctcon1, acctcon2 - Display connect-time accounting summaries
SYNOPSIS
acctcon1 [-l file] [-o file] [-p] [-t]
acctcon2
OPTIONS
Writes line-usage format from the input file (usually /var/adm/wtmp) to
file for the accounting period during which the file /var/adm/wtmp is
active. The following example shows the ASCII line-usage heading for‐
mat:
TOTAL DURATION: 57 MINUTES LINE MINUTES PERCENT
# SESS # ON # OFF pty/ttyp4 37 64
3 3 7 console 26 45 2
2 4 pty/ttyp5 7 11 1 1
3 pty/ttyp6 0 0 0 0 2
TOTALS 69 - 6 6 16
TOTAL DURATION specifies the total number of minutes used for
connect sessions during the accounting period during which the
/var/adm/wtmp file is active. The columns specify the line name,
the number of session minutes used, the percentage of total
elapsed time used for the sessions, the number of sessions
charged, the number of logins, and the number of logouts. The
last line in the line-usage file totals the entries for each
column.
The line-usage format helps to track line usage and identify bad
lines. All hangups, terminations of the login command, and ter‐
minations of the login shell cause the system to write logout
records, so that the number of logouts is often greater than the
number of sessions. Writes an overall-record format to file
from the input file (usually /var/adm/wtmp) for the accounting
period during which the /var/adm/wtmp file is active. The fol‐
lowing example shows the overall-record format:
from mon day date hh:mm:ss yyyy tz to mon day date hh:mm:ss
yyyy tz 2 date changes Number of times the date was changed.
21 acctg off Number of times accounting functions
were turned off. 25 run-level S Number
of times accounting functions
ran in single-user mode. 108 system boot
Number of times the system was rebooted. 21 acctg on
Number of times accounting functions
were turned on. 21 acctcon1 Number of
times the acctcon1 command
was issued.
The first lines specify the date and time stamp, including time
zone, of the accounting period start time and end time. Writes
the input file (usually /var/adm/wtmp) to the default output
device. For example:
pty/ttyp1 hoff 616883748 Jul 19 16:35:48 1990 EST
pty/ttyp1 hoff 616883825 Jul 19 16:37:05 1990 EST
pty/ttyp1 LOGIN 616883833 Jul 19 16:37:13 1990 EST
pty/ttyp1 tom 616883837 Jul 19 16:37:17 1990 EST
The output columnar format lists the line reference name, the
login name, the time in seconds since January 1, 1970, 0 hours,
0 minutes, 0 seconds, the date, the 24-hour clock time, the
year, and the time zone. Uses the last time found in the input
file as the ending time for any current processes. This time,
rather than current time, is necessary to have reasonable and
repeatable values for noncurrent files. The output format is the
same as the default output format.
The acctcon1 command also maintains a list of ports on which
users are logged in. When the acctcon1 command reaches the end
of its input, a session record is written for each port that
still appears to be active. The acctcon1 command assumes that
the input source is the current file and uses current time as
the ending time for each session still in progress.
DESCRIPTION
The acctcon1 and acctcon2 commands are described separately.
acctcon1
The acctcon1 command is invoked by the runacct shell procedure to write
a sequence of login and logout records. One record for each connect
session is written to the specified destination as a sequence of login
session records. The /var/adm/wtmp source file should be directed as
input to the command.
The following example shows the default ASCII columnar output format:
285212673 1192 hoff 85 0 616883748 Jul 19 16:35:48 1990 EST
285212673 1033 tom 10 0 616883837 Jul 19 16:37:17 1990 EST
285212673 0 root 1345 2852 616883855 Jul 19 16:37:35 1990 EST
285212673 1120 jim 0 62 616888058 Jul 19 17:47:38 1990 EST
The columns contain the following information: Device address,
expressed as a decimal equivalent of the major/minor device address at
which the connection was activated. User ID assigned for the connect-
session record. Login name under which the session took place. Total
number of prime-time seconds for the connect session. Total number of
nonprime-time seconds for the connect session. Seconds since the date
0 hours, 0 minutes 0 seconds, 1 January 1970. Month, day of the month,
connect-session starting time, year, and time zone.
The order of date and time information is locale dependent. The time‐
stamps shown use the default format for date and time values; however,
you can define the NLTIME environment variable to change this format.
acctcon2
The acctcon2 command is invoked by the runacct shell procedure. It con‐
verts a sequence of login session records produced by the acctcon1 com‐
mand into connect-time total accounting records. These records are
often merged with other total accounting records with the acctmerg com‐
mand to produce a daily report.
EXAMPLES
The following example converts login records to a default format login
session record report:
acctcon1 -t /var/adm/lineuse -o /var/adm/reboots \
< /var/adm/wtmp > /var/adm/logsess
This example generates three files. The /var/adm/logsess file
lists ending date and 24-hour timestamp records that correspond
with the last time that input was obtained with the -t option.
For the accounting period covered by the /var/adm/wtmp file, the
/var/adm/lineuse line-usage summary file is generated by the -l
option, and the /var/adm/reboots overall record file is obtained
with the -o option. The following example converts a series of
login session records in the /var/adm/logsess file to a total
accounting record in the /var/adm/logacct binary file: acctcon2
< /var/adm/logsess > /var/adm/logacct
FILES
Specifies command path. Specifies command path. The active
login/logout database file. Accounting header files that define for‐
mats for writing accounting files.
SEE ALSO
Commands: login(1), acct(8), acctmerg(8), fwtmp(8), init(8), wtmpcon‐
vert(8)
Functions: acct(2)acctcon(8)