Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

rdma_get_request(3) [debian man page]

RDMA_GET_REQUEST(3)					   Librdmacm Programmer's Manual				       RDMA_GET_REQUEST(3)

NAME
rdma_get_request - Retrieves the next pending connection request event. SYNOPSIS
#include <rdma/rdma_cma.h> int rdma_get_request (struct rdma_cm_id *listen, struct rdma_cm_id **id); ARGUMENTS
listen Listening rdma_cm_id. id rdma_cm_id associated with the new connection. DESCRIPTION
Retrieves a connection request event. If no requests are pending, the call will block until an event is received. RETURN VALUE
Returns 0 on success, or -1 on error. If an error occurs, errno will be set to indicate the failure reason. NOTES
This call may only be used on listening rdma_cm_id's operating synchronously. On success, a new rdma_cm_id representing the connection request will be returned to the user. The new rdma_cm_id will reference event information associated with the request until the user calls rdma_reject, rdma_accept, or rdma_destroy_id on the newly created identifier. For a description of the event data, see rdma_get_cm_event. If QP attributes are associated with the listening endpoint, the returned rdma_cm_id will also reference an allocated QP. SEE ALSO
rdma_get_cm_event(3), rdma_accept(3), rdma_reject(3), rdma_connect(3), rdma_listen(3), rdma_destroy_id(3) librdmacm 2007-10-31 RDMA_GET_REQUEST(3)

Check Out this Related Man Page

RDMA_CREATE_EP(3)					   Librdmacm Programmer's Manual					 RDMA_CREATE_EP(3)

NAME
rdma_create_ep - Allocate a communication identifier and optional QP. SYNOPSIS
#include <rdma/rdma_cma.h> int rdma_create_ep (struct rdma_cm_id **id, struct rdma_addrinfo *res, struct ibv_pd *pd, struct ibv_qp_init_attr *qp_init_attr); ARGUMENTS
id A reference where the allocated communication identifier will be returned. res Address information associated with the rdma_cm_id returned from rdma_getaddrinfo. pd Optional protection domain if a QP is associated with the rdma_cm_id. qp_init_attr Optional initial QP attributes. DESCRIPTION
Creates an identifier that is used to track communication information. RETURN VALUE
Returns 0 on success, or -1 on error. If an error occurs, errno will be set to indicate the failure reason. NOTES
After resolving address information using rdma_getaddrinfo, a user may use this call to allocate an rdma_cm_id based on the results. If the rdma_cm_id will be used on the active side of a connection, meaning that res->ai_flag does not have RAI_PASSIVE set, rdma_create_ep will automatically create a QP on the rdma_cm_id if qp_init_attr is not NULL. The QP will be associated with the specified protection domain, if provided, or a default protection domain if not. Users should see rdma_create_qp for details on the use of the pd and qp_init_attr parameters. After calling rdma_create_ep, the returned rdma_cm_id may be connected by calling rdma_connect. The active side calls rdma_resolve_addr and rdma_resolve_route are not necessary. If the rdma_cm_id will be used on the passive side of a connection, indicated by having res->ai_flag RAI_PASSIVE set, this call will save the provided pd and qp_init_attr parameters. When a new connection request is retrieved by calling rdma_get_request, the rdma_cm_id asso- ciated with the new connection will automatically be associated with a QP using the pd and qp_init_attr parameters. After calling rdma_create_ep, the returned rdma_cm_id may be placed into a listening state by immediately calling rdma_listen. The passive side call rdma_bind_addr is not necessary. Connection requests may then be retrieved by calling rdma_get_request. The newly created rdma_cm_id will be set to use synchronous operation. Users that wish asynchronous operation must migrate the rdma_cm_id to a user created event channel using rdma_migrate_id. Users must release the created rdma_cm_id by calling rdma_destroy_ep. SEE ALSO
rdma_cm(7), rdma_getaddrinfo(3), rdma_create_event_channel(3), rdma_connect(3), rdma_listen(3), rdma_destroy_ep(3), rdma_migrate_id(3) librdmacm 2010-07-19 RDMA_CREATE_EP(3)
Man Page

Featured Tech Videos