blob: 91f390d9e96eba02d554c6fa74f125ecad973e95 [file] [log] [blame] [view] [edit]
---
date: 2019-01-16
footer: librdmacm
header: "Librdmacm Programmer's Manual"
layout: page
license: 'Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md'
section: 3
title: RDMA_ESTABLISH
---
# NAME
rdma_establish - Complete an active connection request.
# SYNOPSIS
```c
#include <rdma/rdma_cma.h>
int rdma_establish(struct rdma_cm_id *id);
```
# DESCRIPTION
**rdma_establish()** Acknowledge an incoming connection response event and complete the connection establishment.
Notes:
If a QP has not been created on the rdma_cm_id, this function should be called by the active side to complete the connection,
after getting connect response event.
This will trigger a connection established event on the passive side.
This function should not be used on an rdma_cm_id on which a QP has been created.
# ARGUMENTS
*id*
: RDMA identifier.
# RETURN VALUE
**rdma_establish()** returns 0 on success, or -1 on error. If an error occurs, errno will be set to indicate the failure reason.
# SEE ALSO
**rdma_connect**(3),
**rdma_disconnect**(3)
**rdma_get_cm_event**(3)
# AUTHORS
Danit Goldberg <danitg@mellanox.com>
Yossi Itigin <yosefe@mellanox.com>