Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
IBV_OPEN_XRCD(3)	Libibverbs Programmer's	Manual	      IBV_OPEN_XRCD(3)

NAME
       ibv_open_xrcd,  ibv_close_xrcd -	open or	close an XRC protection	domain
       (XRCDs)

SYNOPSIS
       #include	<infiniband/verbs.h>

       struct ibv_xrcd *ibv_open_xrcd(struct ibv_context *context,
				      struct ibv_xrcd_init_attr	*xrcd_init_attr);

       int ibv_close_xrcd(struct ibv_xrcd *xrcd);

DESCRIPTION
       ibv_open_xrcd() open an XRC domain for the RDMA device context  context
       xrcd_init_attr  is an ibv_xrcd_init_attr	struct,	as defined in <infini-
       band/verbs.h>.

       struct ibv_xrcd_init_attr {
	       uint32_t		comp_mask;  /* Identifies valid	fields */
	       int		fd;
	       int		oflag;

       fd is the file descriptor to associate with the XRCD.  oflag  describes
       the desired creation attributes.	 It is a bitwise OR of zero or more of
       the following flags:

       O_CREAT
	      Indicates	that an	XRCD should be created and associated with the
	      inode referenced by the given fd.	 If the	XRCD exists, this flag
	      has no effect except as noted under O_EXCL below.

       O_EXCL If O_EXCL	and O_CREAT are	set, open will fail if an XRCD associ-
	      ated with	the inode exists.

       If fd equals -1,	no inode is associated with the	XRCD. To indicate that
       XRCD should be created, use oflag = O_CREAT.

       ibv_close_xrcd()	closes the XRCD	xrcd.  If this is the last  reference,
       the XRCD	will be	destroyed.

RETURN VALUE
       ibv_open_xrcd()	returns	 a  pointer to the opened XRCD,	or NULL	if the
       request fails.

       ibv_close_xrcd()	returns	0 on success, or the value of errno on failure
       (which indicates	the failure reason).

NOTES
       ibv_close_xrcd()	 may  fail  if	any other resource is still associated
       with the	XRCD being closed.

SEE ALSO
       ibv_create_srq_ex(3), ibv_create_qp_ex(3),

AUTHORS
       Sean Hefty <sean.hefty@intel.com>

libibverbs			  2011-06-17		      IBV_OPEN_XRCD(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ibv_open_xrcd&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help