Content-type: text/html Man page of LOGTIME

LOGTIME

Section: User Commands (1)
Updated: April 7, 2008
Index Return to Main Contents
 

NAME

logtime - system availability logger  

SYNOPSIS


  logtime -M <string>

 

DESCRIPTION

This simple utility tracks boot, halt, and panic events. logtime is primarily run by the system [no tty assigned]. However it may also be used as an interface to modify event cause codes, and change a downing event to undefined/planned/unplanned.

When a system transitions from run-level 2 to run-level 3, the UTC is stored to the log file as a boot event. When leaving run-level 3 to any other run-level, a halt event is recorded with the current UTC. If a system should encounter an unnatural downing (any downing which involves a crash dump) the system will record the UTC at the point at which the tictimed daemon stopped running as a panic event on the subsequent boot.

By default halt events are recorded as an Planned event since these events are user initiated. panic events will always be logged as Unplanned. Furthermore, the default L2, L3 cause codes of undefined,undefined will be assigned to both type of events. For both the events, the cause codes may be modified, after the occurrence of the event.

logtime tracks events to a granularity of one second.

 

INVOCATION OPTIONS

Only the -M option may be used from an active terminal (tty), and execution is limited to the super-user. All other invocations are controled by the system.
-M string The -M option may be run either interactively or non-interactively. In interactive mode, the user will be displayed with a list of valid codes for each of the three cause code levels. In non-interactive mode a modification string is expected. Modification strings are formed as a comma separated list where the fields are: the event number to modify, the level-1 cause code, level-2 cause code, and level-3 cause code. The string must be quoted so that spaces are not interpreted as command line arguments. Further more the non-interactive mode allows for verbose or terse input. In verbose mode each cause code is entered in plain text. In terse mode a numeric index to the codes are used. -M by itself will cause logtime to print an indexed list of available cause codes.

There is one special invocation of -M where the event number is provided as 'L' for last downing event. When 'L' is used the last halt or panic event will be modified. The 'L' may only be used in non-interactive mode; cause codes must be provided when using the -L modifier. This feature was designed to provide a common interface for an automated enterprise cause code update process. See the tictimed(1) man page for more information on this feature.


    Prints Cause Code hierarchy
    ---------------------------
    #logtime -M


    Modify (specific) event #4 in Interactive Mode
    ----------------------------------------------
    #logtime -M 4


    Modify (specific) event #4 in Non-Interactive Mode
    --------------------------------------------------
    #logtime -M 4,1,2,1
    #logtime -M "4,Planned,System Hardware,CPU Module"


    Modify last event in Non-Interactive Mode
    -----------------------------------------
    #logtime -M L,1,2,1

 

RETURN VALUES

On a successful event modification logtime will return an exit status of 0 and a syslog entry containing the modified event number is created. If an error occured, the exit status will be 1. In both cases a user notification will also be printed on stdout.

 

FILES

/etc/default/lwact - Configuration file of light weight availability collection tool. $LOGDIR/hostid.lwact.xml - Availability data file generated by light weight availability collection tool. The recorded outage events are written into this file by logtime. LOGDIR is a configurable variable defined in the /etc/default/lwact file. It holds the directory path to the corresponding file.

 

SEE ALSO

tictimed(1) ltreport(1)

 

NOTES

Use ltreport -v to display an indexed list of events.

Use logtime -M to display an indexed list of cause codes.


 

Index

NAME
SYNOPSIS
DESCRIPTION
INVOCATION OPTIONS
RETURN VALUES
FILES
SEE ALSO
NOTES

This document was created by man2html, using the manual pages.
Time: 02:39:30 GMT, October 02, 2010