vipconnectpeerwait.c File Reference

#include <stdlib.h>
#include "vipl_priv.h"

Go to the source code of this file.

Functions
VIP_ENTRY_POINT VIP_RETURN	VipConnectPeerWait (VIP_VI_HANDLE ViHandle, VIP_VI_ATTRIBUTES *RemoteViAttribs)

---

Detailed Description

The VI-GM function VipConnectPeerWait implementation.

Definition in file vipconnectpeerwait.c.

---

Function Documentation

VIP_ENTRY_POINT VIP_RETURN VipConnectPeerWait (  VIP_VI_HANDLE  ViHandle, VIP_VI_ATTRIBUTES *  RemoteViAttribs )

VipConnectPeerWait is used by a client to determine the results of a previously posted VipConnectPeerRequest call on the specified VI handle, blocking the calling thread until the result of the connection request is available. If a connection is successfully established, the attributes of the remote endpoint are returned to the caller. The attributes of the remote endpoint allow the caller to determine whether/which RDMA operations can be executed on the resulting connection. Note: The VI attributes that must match when establishing a connection are ReliabilityLevel, MaxTransferSize and QoS. If the connection was not successfully established within the Timeout period specified in VipConnectPeerRequest, a VIP_TIMEOUT error is returned. VipConnectPeerWait blocks until a connection is established, the timeout expires or an error is detected. Return values: VIP_SUCCESS  The connection completed successfully. Attributes of the remote endpoint are returned through the second function parameter. VIP_INVALID_PARAMETER  One of the parameters was invalid. VIP_INVALID_RELIABILITY_LEVEL  The reliability level attribute of the local endpoint conflicted with the reliability level of the remote VI. VIP_INVALID_MTU  The maximum transfer size attribute of the local endpoint conflicted with the maximum transfer size of the remote endpoint. VIP_INVALID_QOS  The quality of service attribute was invalid, or conflicted with the remote endpoint. VIP_TIMEOUT  The connection request timeout expired before a successful connection completion. VIP_ERROR_RESOURCE  The operation failed due to insufficient resources. VIP_INVALID_STATE  The specified VI endpoint is not in the Pending Connect state. Parameters: ViHandle  Handle for the local VI endpoint (IN). RemoteViAttribs  The attributes of the remote VI endpoint if the connection was successfully completed (OUT). See also: VipConnectPeerRequest VipConnectPeerDone Author: Patrick Geoffray Version: 1.0 Definition at line 64 of file vipconnectpeerwait.c. References VIP_NIC::lock, VIP_GM::lock, VIP_ABORT, VIP_ASSERT, VIP_NIC::vip_conn_set, VIP_CONN_TYPE_PEER, VIP_DEBUG, VIP_DEBUG_LABEL, vip_free_handle(), VIP_NIC::vip_gm_ptr, VIP_INFINITE, VIP_INVALID_CONN_HANDLE, VIP_INVALID_MTU, VIP_INVALID_PARAMETER, VIP_INVALID_QOS, VIP_INVALID_RELIABILITY_LEVEL, VIP_INVALID_STATE, VIP_INVALID_VI_HANDLE, vip_is_conn_notified(), VIP_MUTEX_LOCK, VIP_MUTEX_UNLOCK, VIP_NOT_DONE, VIP_PROGRESSION, vip_remove_conn_waiting_list(), VIP_STATE_CONNECT_PENDING, VIP_STATE_CONNECTED, VIP_STATE_IDLE, VIP_SUCCESS, VIP_TIMEOUT, and vip_wait_for_notification().