EvmItemGet(3)EvmItemGet(3)NAMEEvmItemGet(), EvmItemListFree(), EvmItemListGet(), EvmItemRelease(),
EvmItemSet(), EvmItemSetVa() - create and manipulate event items
SYNOPSIS
Library
EVM Support Library
Parameters
event The event containing the item to be manipulated.
item_id The identifier for the event data item to be set,
obtained, or released by the called routine. Possible
values for this operand, and the data contained by the
data item are identified in the following list. See the
EvmEvent(5) manpage for a description of the event data
items.
Identifier Data Item
─────────────────────────────────────────────────────
EvmITEM_NONE None (Control use)
EvmITEM_NAME Event name
EvmITEM_PRIORITY Priority
EvmITEM_PID Process identifier
EvmITEM_PPID Parent process identifier
EvmITEM_EVENT_ID Event identifier
EvmITEM_TIMESTAMP Time posted
EvmITEM_REPEAT_COUNT Repeat count
EvmITEM_LAST_TIMESTAMP Last timestamp
EvmITEM_I18N_MSG_ID I18N message identifier
EvmITEM_I18N_SET_ID I18N message set identifier
EvmITEM_I18N_CATALOG I18N catalog
EvmITEM_HOST_IP Host IP address
EvmITEM_HOST_NAME Host name
EvmITEM_USER_NAME User name
EvmITEM_FORMAT Event format
EvmITEM_REF Reference
EvmITEM_VAR Variables
EvmITEM_KERNEL_ONLY Kernel distribution Only
─────────────────────────────────────────────────────
It is also possible to supply a separate item_id for each of the
supported variable types. In these cases, an extra one or two
operands (depending on the type) must be supplied in addition to
the item_value. See the description below for more information.
The following extended variable item IDs are supported:
Identifier Variable Type Parameters
───────────────────────────────────────────────────────────────────
EvmITEM_VAR_CHAR EvmTYPE_CHAR Name, value
EvmITEM_VAR_INT16 EvmTYPE_INT16 Name, value
EvmITEM_VAR_INT32 EvmTYPE_INT32 Name, value
EvmITEM_VAR_INT64 EvmTYPE_INT64 Name, value
EvmITEM_VAR_UINT8 EvmTYPE_UINT8 Name, value
EvmITEM_VAR_UINT16 EvmTYPE_UINT16 Name, value
EvmITEM_VAR_UINT32 EvmTYPE_UINT32 Name, value
EvmITEM_VAR_UINT64 EvmTYPE_UINT64 Name, value
EvmITEM_VAR_FLOAT EvmTYPE_FLOAT Name, value
EvmITEM_VAR_DOUBLE EvmTYPE_DOUBLE Name, value
EvmITEM_VAR_STRING EvmTYPE_STRING Name, value
EvmITEM_VAR_STRING_I18N EvmTYPE_STRING Name, value, I18N msgid
EvmITEM_VAR_OPAQUE EvmTYPE_OPAQUE Name, value, size
───────────────────────────────────────────────────────────────────
item_value The value stored into the item indicated by the associ‐
ated item_id. For this is the location where the value
extracted from the event is stored.
item_count This is the return operand. It is the number of entries
in item_list, exclusive of the terminating entry.
DESCRIPTION
These routines manipulate data in the standard items in an event.
The routine sets the value of the event data item specified by item_id
to the item_value supplied by the caller.
The routine sets item values in the event. The list of item_id and
item_value operands is terminated by an instance of item_id of
The inclusion of extended variable item-IDs simplifies programming by
allowing variable items to be added to an event without first having to
set up an structure, or to release it afterwards. To use these
extended item-IDs, follow each with the name of the variable, then a
value of the appropriate type. In addition, an value must be followed
by an I18N message ID, and an value must be followed by a size.
The routine returns, in the item_value reference argument, the value of
the event data item specified by item_id. The caller must use to free
any space allocated for the item.
The routine releases any storage space that was allocated when the data
item named by item_id was retrieved from an event using
The routine returns, in the itemList reference argument, a list of all
of the items, which are currently defined for the event. The last item
in the list has an item_id value of The number of items in the list,
not including the terminating null identifier, is returned in
item_count. The caller is responsible for freeing the memory used by
the list by calling
The routine frees the memory used by an item list. The itemList oper‐
and is a list of items in an event generated by
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.
A request specified an item or variable name component in an
itemList or a varList that is not part of the event being pro‐
cessed.
ERRORS
The value of is not set.
SEE ALSO
Commands
evmshow(1).
Routines
EvmEventCreate(3), EvmEventDestroy(3), EvmEventFormat(3), EvmEvent‐
Post(3).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
EvmItemGet(3)