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

e
EvmConnCreate(3) EvmConnCreate(3)
NAME
EvmConnCreate(), EvmConnCreatePoster(), EvmConnCreateSubscriber(), EvmConnDestroy(),
EvmConnFdGet() - establish or destroy connection with the EVM daemon
SYNOPSIS
#include <evm/evm.h>
EvmStatus_t EvmConnCreate(
EvmConnectionType_t
type,
EvmResponseMode_t
responseMode,
const EvmTransport_t
transport,
EvmCallback_t
callback,
EvmCallbackArg_t
callbackArg,
EvmConnection_t *
connection );
EvmStatus_t EvmConnCreatePoster(
EvmConnection_t *
connection );
EvmStatus_t EvmConnCreateSubscriber(
EvmCallback_t
callback,
EvmCallbackArg_t
callbackArg
,
EvmConnection_t *
connection
);
EvmStatus_t EvmConnDestroy(
EvmConnection_t
connection );
EvmStatus_t EvmConnFdGet(
EvmConnection_t
connection,
EvmFd_t *
fd );
Library
EVM Support Library (libevm.so).
Parameters
type Establishes the function of the connection. Possible values are as follows:
EvmCONNECTION_POST
Creates a connection for use by posting clients.
EvmCONNECTION_LISTEN
Creates a connection for use by subscribing clients. The responseMode operand must
be set to EvmRESPONSE_CALLBACK
.
responseMode Establishes the behavior of certain connection-oriented API functions when requests are
made to the EVM daemon. If a function call results in such a request, the function returns a
response according to the value of this operand, as follows:
EvmRESPONSE_IGNORE
The function returns without waiting for the daemon’s response. In this mode, any
return status other than EvmERROR_NONE
indicates that a problem was detected in
preliminary validation. A response of
EvmERROR_NONE signifies only that the
request was sent to the daemon. An EvmERROR_NONE response cannot determine if
the request was received or accepted.
EvmRESPONSE_WAIT
The function does preliminary validation, returning a status reflecting any error it
finds. If the function finds no error, it passes the request to the EVM daemon and
blocks until a response is received from the daemon. The status returned by the func-
tion may result either from preliminary validation or from validation by the daemon.
If no error is returned by the function, the request has been accepted by the daemon.
EvmRESPONSE_CALLBACK
The function returns without waiting for a response. Any return status other than
EvmERROR_NONE indicates that a problem was detected in preliminary validation.
If no error is found, the function passes the request to the EVM daemon, and returns
immediately with a status of EvmERROR_NONE. The calling process must use
EvmConnWait() or a related function to watch for I/O activity on the connection,
378 Hewlett-Packard Company − 1 − HP-UX 11i Version 3: February 2007