evmeventread.3 (2010 09)

EvmEventRead(3) EvmEventRead(3)

NAME

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

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 ﬁle 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 ﬁle 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 speciﬁed ﬁle 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-ﬁle 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.

PAGE 1
EvmEventRead(3) EvmEventRead(3) NAME EvmEventRead(), EvmEventWrite() - perform I/O of EVM events to and from a file SYNOPSIS #include 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 fd For EvmEventRead(), the return operand EvmEventWrite(), the event to be written. created for the event read.
PAGE 2
(Notes) A (Notes) eA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010