noble (7) manadv.7.gz

Provided by: libibverbs-dev_50.0-2build2_amd64 bug

NAME

       manadv - Direct verbs for mana devices

       This  provides  low  level access to mana devices to perform direct operations, without general branching
       performed by libibverbs.

DESCRIPTION

       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.

       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.

       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.

       The  direct  include  of  manadv.h  together  with  linkage  to mana library will allow usage of this new
       interface.

SEE ALSO

       verbs(7)

AUTHORS

       Long Li <longli@microsoft.com>