ibnd_destroy_fabric(3) [centos man page]

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 specified by ibmad_port, using a timeout specified.  The "from" and "hops"
       parameters are optional and allow one to scan part of a fabric by specifying 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" anywhere they chose.

       ibmad_port must be opened with at least IB_SMI_CLASS and IB_SMI_DIRECT_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 output which shows it's progress through the fabric.

       ibnd_set_max_smps_on_wire() Set the number of SMP's which will be issued 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(ibmad_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)

Check Out this Related Man Page

IBQUERYERRORS(8)						OpenIB Diagnostics						  IBQUERYERRORS(8)

NAME

       ibqueryerrors.pl - query and report non-zero IB port counters

SYNOPSIS

       ibqueryerrors.pl [-a -c -r -R -C <ca_name> -P <ca_port> -s <err1,err2,...> -S <switch_guid> -D <direct_route> -d]

DESCRIPTION

       ibqueryerrors.pl  reports  the  port  counters  of  switches.   This  is similar to ibcheckerrors with the additional ability to filter out
       selected errors, include the optional transmit and receive data counters, report actions to remedy a non-zero count, and report	full  link
       information for the link reported.

OPTIONS

       -a     Report an action to take.  Some of the counters are not errors in and of themselves.  This reports some more information on what the
	      counters mean and what actions can/should be taken if they are non-zero.

       -c     Suppress some of the common "side effect" counters.  These counters usually do not indicate an error condition and can be usually be
	      safely ignored.

       -r     Report  the port information.  This includes LID, port, external port (if applicable), link speed setting, remote GUID, remote port,
	      remote external port (if applicable), and remote node description information.

       -R     Recalculate the ibnetdiscover information, ie do not use the cached information.	This option is slower but should be  used  if  the
	      diag tools have not been used for some time or if there are other reasons to believe that the fabric has changed.

       -s <err1,err2,...>
	      Suppress the errors listed in the comma separated list provided.

       -S <switch_guid>
	      Report results only for the switch specified. (hex format)

       -D <direct_route>
	      Report results only for the switch specified by the direct route path.

       -d     Include the optional transmit and receive data counters.

       -C <ca_name>    use the specified ca_name for the search.

       -P <ca_port>    use the specified ca_port for the search.

AUTHOR

       Ira Weiny
	      <weiny2@llnl.gov>

OpenIB								   Jan 24, 2008 						  IBQUERYERRORS(8)

Linux and UNIX Man Pages

ibnd_destroy_fabric(3) [centos man page]

Check Out this Related Man Page