Logtool Specifications

Hewlett-Packard STM: Logtool ERS * Revision 1.17
- Page 8 - Printed: 02/04/99 3:38 PM
entry consists of a header that is generated by Logtool and a series of language
localized message descriptors that are generated by log decoding programs associated
with each logging entity (e.g. i/o driver) or entry type (e.g. lpmc entry). The contents
of the formatted log can then be displayed to the user by retrieving message text from
catalogs associated with each message specifier and displaying it. If no decoding
routine is installed for a particular logging entity, Logtool will provide only the
header information for entries associated with it and a hex display of the raw data for
those entries.
The following figure shows an example of how a raw log file whose first entry is an
I/O error is formatted. Refer to Appendix A for the contents of other entry types.
Logtool provides commands to view either the raw log file data (in hex), or the
formatted output (in text).
Data Length
Log Formatting
Raw Log
Entry #1 Header
Entry Length
Time Stamp
Device Path
Product
Logger ID
Data Length
Entry Data
(raw entry data)
Entry #2 Header
Decoder cross-
reference file
Logtool
Formatter
product cross-
reference file
i/o decode
routines
Formatted Log
Log Header
Entry #1 Header
Entry Length
Time Stamp
Device Path
Product
Logger ID
Product Qualifier
Device Type
Device Qualifier
Entry Data
(formatted entry data)
Entry #2 Header
Format Filter
Raw file name
Entry Type
Entry Type
Product Qualifier
Entry Version
IO System
Entry Version
IO System