HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

e
EvmEventRead(3) EvmEventRead(3)
NAME
EvmEventRead(), EvmEventWrite() - perform I/O of EVM events to and from a file
SYNOPSIS
#include <evm/evm.h>
EvmStatus_t EvmEventRead(
EvmFd_t
fd,
EvmEvent_t *
event );
EvmStatus_t EvmEventWrite(
EvmFd_t
fd,
const EvmEvent_t
event );
Library
EVM Support Library (libevm.so).
Parameters
event For EvmEventRead()
, the return operand created for the event read. For
EvmEventWrite(), the event to be written.
fd The file descriptor to which the event is written, or from which it is 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, call
EvmEventDestroy()
.
RETURN VALUE
EvmERROR_NONE The operation completed without error.
EvmERROR_EOF An end-of-file condition was encountered while reading.
EvmERROR_INVALID_ARGUMENT
One of the arguments to the function is invalid.
EvmERROR_NO_MEMORY
An operation failed because an attempt to acquire heap memory
failed.
EvmERROR_READ An error occurred while reading an event.
EvmERROR_WRITE An error occurred while writing an event.
ERRORS
The value of
errno is not set.
SEE ALSO
Routines
EvmEventDestroy(3).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
392 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007