EvmEventDump(3) Library Functions Manual EvmEventDump(3)NAME
EvmEventDump() - dump an event in displayable form
SYNOPSIS
Library
EVM Support Library
Parameters
event The event for which a formatted dump is requested. All data items and variables contained in the event are displayed.
fd Points to a FILE structure where the formatted event is to be dumped. This is usually stdout or stderr.
DESCRIPTION
The routine dumps an event in display format. All data items and variables contained in the event are displayed.
Notes
The format of the output is not guaranteed to be consistent between releases. Do not rely on the output for any standard processing.
RETURN VALUE
The operation completed without error.
One of the arguments to the function was invalid.
A value in a structure member was invalid.
An operation failed because an attempt to acquire heap memory failed.
ERRORS
The value of is not set.
SEE ALSO
Commands
evmshow(1).
Routines
EvmEventFormat(3).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
EvmEventDump(3)
Check Out this Related Man Page
EvmEventFormat(3) Library Functions Manual EvmEventFormat(3)NAME
EvmEventFormat(), EvmEventFormatFromTemplate(), EvmVarFormat() - format events for display
SYNOPSIS
Library
EVM Support Library
Parameters
buffer A pointer to a character string to receive the formatted event data. The stored string is null-terminated, even if trun-
cated, unless the length operand is zero(0).
length The maximum length (number of characters) of the output string. If the formatted event is longer than length, the output is
truncated.
event The event to be formatted.
show_template The primary template for formatting the output.
var_name The name of a variable data item of the event whose value is to be formatted.
translate A Boolean value indicating whether I18N (internationalization) translation is to be attempted on the variable data item
(var_name). If the translate operand is translation is attempted. In addition, the following conditions must be met:
o The variable is of type string and includes an I18N (internationalization) message identifier
o The event contains I18N (internationalization) catalog information.
DESCRIPTION
Information contained in an event must be formatted into a readable format. The software which posts the event (event poster) supplies
formatting information through the event's format data item. The routines described here explain the event formatting capabilities.
The routine combines the supplied event's format data item with any data items or variables specified in the event's format item that are
available in the event. returns a formatted version of the event in buffer.
If the event contains I18N message catalog information, and the catalog is available in the user's locale, the format string is retrieved
from the message catalog if possible. If no translation is possible, the format string from the event is used.
If the event does not contain format information, produces a generic display of the event's name and any variables.
The routine also formats the supplied event. uses the supplied show_template string as its primary formatting template. Literal charac-
ters in show_template are transferred to the buffer unchanged.
Any token of the form or is replaced by the value of the corresponding data item from the supplied event, if it is present. item_name is
the name of the item stored in the event. If width is supplied, the value occupies a minimum of width character positions. width is an
integer number specifying the size of the value stored in item_name. The item_name is the name of a standard event data item. The special
string is replaced by the results of applying to the event.
Refer to evmshow(1) and EvmEvent(5) for more information about formatting events for display.
retrieves a variable called var_name from the supplied event, and returns a formatted version of its value in buffer.
If translate is I18N translation is applied as appropriate.
Notes
Floating point values are formatted using the format specifier.
RETURN VALUE
The operation completed without error.
One of the arguments to the function is invalid.
A value in a structure member is invalid.
An operation failed because an attempt to acquire heap memory failed.
ERRORS
The value of is not set.
SEE ALSO
Commands
evmshow(1), locale(1).
Routines
EvmEventDump(3), printf(3S), setlocale(3C).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
EvmEventFormat(3)