.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "MANADV" "7" "2022-05-16" "mana" "MANA Direct Verbs Manual"
.hy
.SH NAME
.PP
manadv - Direct verbs for mana devices
.PP
This provides low level access to mana devices to perform direct
operations, without general branching performed by libibverbs.
.SH DESCRIPTION
.PP
The libibverbs API is an abstract one.
It is agnostic to any underlying provider specific implementation.
While this abstraction has the advantage of user applications
portability, it has a performance penalty.
For some applications optimizing performance is more important than
portability.
.PP
The mana direct verbs API is intended for such applications.
It exposes mana specific low level operations, allowing the application
to bypass the libibverbs API.
.PP
This version of the driver supports one QP type: IBV_QPT_RAW_PACKET.
To use this QP type, the application is required to use
manadv_set_context_attr() to set external buffer allocators for
allocating queues, and use manadv_init_obj() to obtain all the queue
information.
The application implements its own queue operations, bypassing
libibverbs API for sending/receiving traffic over the queues.
At hardware layer, IBV_QPT_RAW_PACKET QP shares the same hardware
resource as the Ethernet port used in the kernel.
The software checks for exclusive use of the hardware Ethernet port, and
will fail the QP creation if the port is already in use.
To create a IBV_QPT_RAW_PACKET on a specified port, the user needs to
configure the system in such a way that this port is not used by any
other software (including the Kernel).
If the port is used, ibv_create_qp() will fail with errno set to EBUSY.
.PP
The direct include of manadv.h together with linkage to mana library
will allow usage of this new interface.
.SH SEE ALSO
.PP
\f[B]verbs\f[R](7)
.SH AUTHORS
.PP
Long Li <longli@microsoft.com>