evmeventread(3) [hpux man page]

EvmEventRead(3) 					     Library Functions Manual						   EvmEventRead(3)

NAME

       EvmEventRead(), EvmEventWrite() - perform I/O of EVM events to and from a file

SYNOPSIS

   Library
       EVM Support Library

   Parameters
       event	     For the return operand created for the event read. For the event to be written.

       fd	     The file descriptor to which the event is written, or from which it is read.

DESCRIPTION

       The routine creates a new event structure and populates it with an event read from the supplied file descriptor

       The routine must be used to destroy the new event when it is no longer needed.

       The  routine  writes  the  supplied event to the specified file descriptor It does not destroy the event. If the event is no longer needed,
       call

RETURN VALUE

       The operation completed without error.

       An end-of-file condition was encountered while reading.

       One of the arguments to the function is invalid.

       An operation failed because an attempt to acquire heap memory failed.

       An error occurred while reading an event.

       An error occurred while writing an event.

ERRORS

       The value of is not set.

SEE ALSO

   Routines
       EvmEventDestroy(3).

   Event Management
       EVM(5).

   EVM Events
       EvmEvent(5).

																   EvmEventRead(3)

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)