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

FreeBSD Manual Pages

  
 
  

home | help
IBND_DISCOVER_FABRIC(3)	  OpenIB Programmer's Manual   IBND_DISCOVER_FABRIC(3)

NAME
       ibnd_discover_fabric,	      ibnd_destroy_fabric,	    ibnd_debug
       ibnd_show_progress - initialize ibnetdiscover library.

SYNOPSIS
       #include	<infiniband/ibnetdisc.h>

       void ibnd_destroy_fabric(ibnd_fabric_t *fabric)
       void ibnd_debug(int i)
       void ibnd_show_progress(int i)
       int ibnd_set_max_smps_on_wire(int i)

DESCRIPTION
       ibnd_discover_fabric() Discover the fabric connected to the port	speci-
       fied  by	 ibmad_port, using a timeout specified.	 The "from" and	"hops"
       parameters are optional and allow one to	scan part of a fabric by spec-
       ifying  a node "from" and a number of hops away from that node to scan,
       "hops".	This gives the user a "sub-fabric" which  is  "centered"  any-
       where they chose.

       ibmad_port  must	 be  opened  with at least IB_SMI_CLASS	and IB_SMI_DI-
       RECT_CLASS classes for ibnd_discover_fabric to work.

       ibnd_destroy_fabric() free all memory and resources associated with the
       fabric.

       ibnd_debug()  Set  the  debug level to be printed as library operations
       take place.

       ibnd_show_progress() Indicate that the library should print debug  out-
       put which shows it's progress through the fabric.

       ibnd_set_max_smps_on_wire()  Set	 the number of SMP's which will	be is-
       sued on the wire	simultaneously.

RETURN VALUE
       ibnd_discover_fabric()  return  NULL  on	 failure,  otherwise  a	 valid
       ibnd_fabric_t object.

       ibnd_destory_fabric(), ibnd_debug() NONE

       ibnd_set_max_smps_on_wire() The previous	value is returned

EXAMPLES
       Discover	the entire fabric connected to device mthca0 , port 1.

	    int	  mgmt_classes[2]   =	{IB_SMI_CLASS,	 IB_SMI_DIRECT_CLASS};
	    struct ibmad_port  *ibmad_port  =  mad_rpc_open_port(ca,  ca_port,
       mgmt_classes, 2);      ibnd_fabric_t *fabric = ibnd_discover_fabric(ib-
       mad_port, 100, NULL,  0);       ...	  ibnd_destroy_fabric(fabric);
	    mad_rpc_close_port(ibmad_port);

       Discover	only a single node and those nodes connected to	it.

	    ...	       str2drpath(&(port_id.drpath),  from,  0,	 0);	   ...
	    ibnd_discover_fabric(ibmad_port, 100, &port_id, 1);	     ...

SEE ALSO
	    libibmad, mad_rpc_open_port

AUTHORS
       Ira Weiny <weiny2@llnl.gov>

OpenIB				 July 25, 2008	       IBND_DISCOVER_FABRIC(3)

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

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

home | help