Filewatcher File Search File Search
Catalog
Content Search
» » » » » librdmacm-dev_1.0.15-1+deb7u1_armhf.deb » Content »
pkg://librdmacm-dev_1.0.15-1+deb7u1_armhf.deb:68354/usr/share/man/man3/  info  control  downloads

librdmacm-dev - Development files for the librdmacm library…  more info»

rdma_create_ep.3.gz

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 con‐
       nection, 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 asso‐
       ciated  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 con‐
       nection, indicated by having  res->ai_flag  RAI_PASSIVE  set,
       this  call will save the provided pd and qp_init_attr parame‐
       ters.  When a new connection request is retrieved by  calling
       rdma_get_request, the rdma_cm_id associated with the new con‐
       nection will automatically be associated with a QP using  the
       pd  and  qp_init_attr  parameters.   After  calling rdma_cre‐
       ate_ep, the returned rdma_cm_id may be placed into a  listen‐
       ing  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_chan‐
       nel(3), rdma_connect(3), rdma_listen(3),  rdma_destroy_ep(3),
       rdma_migrate_id(3)



librdmacm                    2010-07-19            RDMA_CREATE_EP(3)
Results 1 - 1 of 1
Help - FTP Sites List - Software Dir.
Search over 15 billion files
© 1997-2017 FileWatcher.com