Manualshelf

evmconncreate.3 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages
1234
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
function may result either from preliminary validation or from validation by the dae-
mon. 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,
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)