acctcon(1m) [hpux man page]

acctcon(1M)															       acctcon(1M)

NAME

       acctcon, acctcon1, acctcon2 - connect-time accounting

SYNOPSIS

       [options]

       [options]

DESCRIPTION

       The  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 or 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

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

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

       recognizes the following options:

	      Print input only, showing line name, login name,
			     and time (in both numeric and date/time formats).

	      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  ses-
			     sion  still in progress.  The flag causes it to use, instead, the last time found in its input, thus ensuring reason-
			     able and repeatable numbers for non-current files.

       and recognize the following options:

	      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 (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 num-
			     ber of sessions.  See init(1M) and utmp(4).

	      file	     is filled with an overall record for the accounting period, giving starting time, ending time, number of reboots, and
			     number of date changes.

	      When this option is used, the records of the type found in
			     are read from the specified input.

EXAMPLES

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

       or

       With option:

       or

Note:
       The file can be either or a file containing records of the type found in

WARNINGS

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

FILES

SEE ALSO

       login(1), acct(1M), acctcms(1M), acctcom(1M), acctmerg(1M), acctprc(1M), acctsh(1M), fwtmp(1M), init(1M), utmpd(1M), runacct(1M),  acct(2),
       getbwent(3C), acct(4), utmp(4).

STANDARDS CONFORMANCE

																       acctcon(1M)

acctcon(1M)						  System Administration Commands					       acctcon(1M)

NAME

       acctcon, acctcon1, acctcon2 - connect-time accounting

SYNOPSIS

       /usr/lib/acct/acctcon [-l lineuse] [-o reboot]

       /usr/lib/acct/acctcon1 [-p] [-t] [-l lineuse] [-o reboot]

       /usr/lib/acct/acctcon2

DESCRIPTION

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

       acctcon is a combination of the programs acctcon1 and acctcon2. acctcon1 converts login/logoff records, taken from the fixed /var/adm/wtmpx
       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 below, as well as with the -p and -t options.

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 non-current files.

       -l lineuse    lineuse  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
		     utmpx(4).

       -o reboot     reboot  is filled with an overall record for the accounting period, giving starting time, ending time, number of reboots, and
		     number of date changes.

EXAMPLES

       Example 1 Using the acctcon command.

       The acctcon command is typically used as follows:

	 example% acctcon -l lineuse -o reboots < tmpwtmp > ctacct

       The acctcon1 and acctcon2 commands are typically used as follows:

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

FILES

       /var/adm/wtmpx	 History of user access and administration information

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWaccu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       acctcom(1),  login(1),  acct(1M),  acctcms(1M),	acctmerg(1M),  acctprc(1M),  acctsh(1M),  fwtmp(1M),   init(1M),   runacct(1M),   acct(2),
       acct.h(3HEAD), utmpx(4), attributes(5)

NOTES

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

       During a single invocation of any given command, the acctcon, acctcon1, and acctcon2 commands can process a maximum of:

	   o	  6000 distinct session

	   o	  1000 distinct terminal lines

	   o	  2000 distinct login names

       If at some point the actual  number of any one of these items exceeds the maximum, the command will not succeed.

SunOS 5.11							    22 Feb 1999 						       acctcon(1M)