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