evmeventdup(3) [hpux man page]

EvmEventCreate(3)					     Library Functions Manual						 EvmEventCreate(3)

NAME

       EvmEventCreate(), EvmEventCreateVa(), EvmEventDestroy(), EvmEventDup() - create and destroy events

SYNOPSIS

   Notes
       Brackets [ ] are not part of the syntax; they denote optional parameters.

   Library
       EVM Support Library

   Parameters
       event	     The event to be created, copied, or destroyed.

       item_id	     The  identifier  for  the Event Data Item to be set.  See the EvmItemSet(3) manpage for possible values for this operand, and
		     the data contained by the data item.

       item_value    The value to be stored in the associated item indicated by item_id.

       dupev	     The return location where the duplicate (new) event is stored.

DESCRIPTION

       The routine creates an empty event.  The newly created event is returned in the event reference argument.

       The routine creates an event and adds the supplied items in a single call.  The item list is terminated by an instance of the item_id oper-
       and set to The newly created event is returned in the event reference argument.

       The  routine destroys a previously created event, freeing its memory.  This function must be used if it is necessary to destroy an event to
       ensure that all associated memory is freed.

       The routine creates a copy of the supplied event and returns the new event in the dupev reference argument.

   Notes
       To avoid memory leakage, all structures that are supplied to the caller from API routines must be freed with the appropriate EVM  API  free
       routine.

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
       evmpost(1).

   Routines
       EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3) EvmEventWrite(3).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

																 EvmEventCreate(3)

EvmEventCreate(3)					     Library Functions Manual						 EvmEventCreate(3)

NAME

       EvmEventCreate, EvmEventCreateVa, EvmEventDup, EvmEventDestroy - Creates and destroys events

LIBRARY

       EVM Support Library (libevm.so, libevm.a)

SYNOPSIS

       #include <evm/evm.h>

       EvmStatus_t EvmEventCreate(
	       EvmEvent_t *event);

       EvmStatus_t EvmEventCreateVa(
	       EvmEvent_t *event,
	       [EvmItemId_t item_id,
	       const EvmItemValue_t item_value,]
	       ...
	       EvmITEM_NONE);

       EvmStatus_t EvmEventDup(
	       EvmEvent_t *dupev,
	       EvmEvent_t event);

       EvmStatus_t EvmEventDestroy(
	       EvmEvent_t event);

OPERANDS

       The event to be created, copied, or destroyed.  The identifier for the Event Data Item to be set.  See the EvmItemSet(3) reference page for
       possible values for this parameter, and the data contained by the data item.  The value to be stored in the associated  item  indicated	by
       item_id.  The return location where the duplicate (new) event is stored.

DESCRIPTION

       The EvmEventCreate() routine creates an empty event.  The newly created event is returned in the event reference argument.

       The  EvmEventCreateVa()	routine creates an event and adds the supplied items in a single call.	The item list is terminated by an instance
       of the item_id parameter set to EvmITEM_NONE.  The newly created event is returned in the event reference argument.

       The EvmEventDup() routine creates a copy of the supplied event and returns the new event in the dupev reference argument.

       The EvmEventDestroy() routine destroys a previously created event, freeing its memory. This function must be used if  it  is  necessary	to
       destroy an event, to ensure that all associated memory is freed.

RESTRICTIONS

       To  avoid  memory leakage, all structures that are supplied to the caller from API routines must be freed with the appropriate EVM API free
       routine.

RETURN VALUES

       The operation was completed without error.  One of the arguments to the function was invalid.  A value in a structure  member  is  invalid.
       An operation failed because an attempt to acquire heap memory failed.

ERRORS

       None

FILES

       None

SEE ALSO

       Commands: evmpost(1)

       Routines: EvmConnCreate(3) EvmEventPost(3) EvmItemSet(3) EvmEventWrite(3)

       Event Management: EVM(5)

       EVM Events: EvmEvent(5)
       delim off

																 EvmEventCreate(3)