Movatterモバイル変換

rdma_post_readv(3) — Linux manual page

RDMA_POST_READV(3)    Librdmacm Programmer's ManualRDMA_POST_READV(3)

NAME        top

       rdma_post_readv - post an RDMA read work request.

SYNOPSIS        top

#include <rdma/rdma_verbs.h>int rdma_post_readv (struct rdma_cm_id *id, void *context, structibv_sge *sgl, intnsge, intflags, uint64_tremote_addr, uint32_trkey);

ARGUMENTS        top

       id          A reference to a communication identifier where the                   request will be posted.       context     User-defined context associated with the request.       sgl         A scatter-gather list of the destination buffers of                   the read.       nsge        The number of scatter-gather array entries.       flags       Optional flags used to control the read operation.       remote_addr The address of the remote registered memory to read                   from.       rkey        The registered memory key associated with the remote                   address.

DESCRIPTION        top

       Posts a work request to the send queue of the queue pair       associated with the rdma_cm_id.  The contents of the remote memory       region will be read into the local data buffers.

RETURN VALUE        top

       Returns 0 on success, or -1 on error.  If an error occurs, errno       will be set to indicate the failure reason.

NOTES        top

       For a list of supported flags, see ibv_post_send.  Both the remote       and local data buffers must have been registered before the read       is issued, and the buffers must remain registered until the read       completes.       Read operations may not be posted to an rdma_cm_id or the       corresponding queue pair until it has been connected.       The user-defined context associated with the read request will be       returned to the user through the work completion wr_id, work       request identifier, field.

SEE ALSO        top

rdma_cm(7),rdma_connect(3),rdma_accept(3),ibv_post_send(3),rdma_post_read(3),rdma_reg_read(3),rdma_reg_msgs(3)

COLOPHON        top

       This page is part of therdma-core (RDMA Core Userspace Libraries       and Daemons) project.  Information about the project can be found       at ⟨https://github.com/linux-rdma/rdma-core⟩.  If you have a bug       report for this manual page, send it to       linux-rdma@vger.kernel.org.  This page was obtained from the       project's upstream Git repository       ⟨https://github.com/linux-rdma/rdma-core.git⟩ on 2025-08-11.  (At       that time, the date of the most recent commit that was found in       the repository was 2025-08-04.)  If you discover any rendering       problems in this HTML version of the page, or you believe there is       a better or more up-to-date source for the page, or you have       corrections or improvements to the information in this COLOPHON       (which isnot part of the original manual page), send a mail to       man-pages@man7.orglibrdmacm                       2010-07-19RDMA_POST_READV(3)

Pages that refer to this page:rdma_post_read(3), rdma_reg_msgs(3), rdma_cm(7)

HTML rendering created 2025-09-06 byMichael Kerrisk, author ofThe Linux Programming Interface. For details of in-depthLinux/UNIX system programming training courses that I teach, lookhere. Hosting byjambit GmbH.