fwtmp, wtmpfix, acctwtmp(8,C)                     fwtmp, wtmpfix, acctwtmp(8,C)



-------------------------------------------------------------------------------
fwtmp, wtmpfix, acctwtmp



PURPOSE

Manipulates connect accounting records.

SYNTAX


                       +--------+
/usr/lib/acct/fwtmp ---| +----+ |---|
                       +-| -i |-+
                        ^| -c ||
                        |+----+|
                        +------+

                         +------------+
/usr/lib/acct/wtmpfix ---|            |---|
                         +--- file ---+
                           ^        |
                           +--------+

/usr/lib/acct/acctwtmp --- "reason" ---|


DESCRIPTION

fwtmp

The fwtmp command reads wtmp records from standard input and converts them to
formatted ASCII records, which it writes to standard output.

FLAGS

-i  Reads ASCII.

-c  Writes binary output.

acctwtmp

The acctwtmp command writes to standard output a utmp record containing the
string reason and the current date and time.  The string reason can contain 11
characters or less.

wtmpfix

The wtmpfix command examines standard input or the named files containing
records in wtmp format, corrects the date and time stamps to make the entries
consistent, and writes the corrected input to standard output.  (It is



Processed Nov. 8, 1990   fwtmp, wtmpfix, acctwtmp(8,C)                        1

fwtmp, wtmpfix, acctwtmp(8,C)                     fwtmp, wtmpfix, acctwtmp(8,C)



necessary that date and time stamps be consistent because acctcon1 generates an
error and stops when it encounters inconsistent date change records.)

Each time the date is set (on system startup or with the date command) a pair
of date change records is written to the file /usr/adm/wtmp.  The first record
is the old date, denoted by the string old time placed in the line field and
the flag OLD_TIME placed in the type field.  The second record is the new date,
denoted by the string new time placed in the line field and the flag NEW_TIME
placed in the type field.  The wtmpfix command uses these records to
synchronize all date and time stamps in the file.

In addition to correcting date and time stamps, the wtmpfix command checks the
validity of the name field to ensure that it consists solely of alphanumeric
characters, a dollar sign ("$"), or spaces.  If it encounters an invalid name,
it changes the login name to INVALID and writes a diagnostic to standard error.
In this way, the wtmpfix command reduces the chance that the accton2 command
will fail when it processes connect accounting records.

FILES

/usr/adm/wtmp          Contains records of date changes that include an old
                       date and a new date.
/usr/include/utmp.h    Data structure for /etc/utmp and /usr/adm/utmp entries.

RELATED INFORMATION

See the following commands:  "acct/*,"  "acctcms,"  "acctcom," "acctcon1,
acctcon2,"  "acctdisk, acctdusg," "acctmerg" and "runacct."

See the acct system call and the acct and utmp files in AIX Operating System
Technical Reference.
























Processed Nov. 8, 1990   fwtmp, wtmpfix, acctwtmp(8,C)                        2