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).