evmeventwrite(3) [osf1 man page]

EvmEventRead(3) 					     Library Functions Manual						   EvmEventRead(3)

NAME

       EvmEventRead, EvmEventWrite - Performs I/O of events to and from a file

LIBRARY

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

SYNOPSIS

       #include <evm/evm.h>

       EvmStatus_t EvmEventRead(
	       EvmFd_t fd,
	       EvmEvent_t *event);

       EvmStatus_t EvmEventWrite(
	       EvmFd_t fd,
	       const EvmEvent_t event);

OPERANDS

       For EvmEventRead(), the return parameter created for the event read.  For EvmEventWrite(), the event to be written.  The file descriptor to
       which the event should be written, or from which it should be read.

DESCRIPTION

       The EvmEventRead() routine creates a new event structure and populates it with an event read from the supplied file descriptor  (fd).   The
       EvmEventDestroy() routine must be used to destroy the new event when it is no longer needed.

       The  EvmEventWrite() routine writes the supplied event to the specified file descriptor (fd).  It does not destroy the event.  If the event
       is no longer needed, the caller should call EvmEventDestroy().

RESTRICTIONS

       None

RETURN VALUES

       The operation was completed without error.  En end-of-file condition was encountered while reading.  One of the arguments to  the  function
       was  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

       None

FILES

       None

SEE ALSO

       Routines: EvmEventDestroy(3)

       Event Management: EVM(5)

       EVM Events: EvmEvent(5)
       delim off

																   EvmEventRead(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)