 |
Index for Section 8 |
|
 |
Alphabetical listing for A |
|
 |
Bottom of page |
|
acctcon(8)
NAME
acctcon1, acctcon2 - Display connect-time accounting summaries
SYNOPSIS
acctcon1 [-l file] [-o file] [-p] [-t]
acctcon2
OPTIONS
-l file
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
format:
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 terminations 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.
-o file
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 following 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.
-p 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.
-t 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 timestamps
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 converts
a sequence of login session records produced by the acctcon1 command into
connect-time total accounting records. These records are often merged with
other total accounting records with the acctmerg command to produce a daily
report.
EXAMPLES
1. 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.
2. 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
/usr/sbin/acct/acctcon1
Specifies command path.
/usr/sbin/acct/acctcon2
Specifies command path.
/var/adm/wtmp
The active login/logout database file.
/usr/include/sys/acct.h, /usr/include/utmp.h
Accounting header files that define formats for writing accounting
files.
SEE ALSO
Commands: login(1), acct(8), acctmerg(8), fwtmp(8), init(8), wtmpconvert(8)
Functions: acct(2)
 |
Index for Section 8 |
|
 |
Alphabetical listing for A |
|
 |
Top of page |
|