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

FreeBSD Manual Pages

  
 
  

home | help
fi_info(1)		       Libfabric v1.15.1		    fi_info(1)

NAME
       fi_info - Simple	utility	to query for fabric interfaces

SYNOPSIS
	       fi_info [OPTIONS]

DESCRIPTION
       The  fi_info  utility  can be used to query for available fabric	inter-
       faces.  The utility supports filtering based on	a  number  of  options
       such  as	endpoint type, provider	name, or supported modes.  Additional-
       ly, fi_info can also be used to discover	the environment	variables that
       can be used to tune provider specific parameters.  If  no  filters  are
       specified,  then	 all available fabric interfaces for all providers and
       endpoint	types will be returned.

OPTIONS
   Filtering
       -n, -node=<NAME>
	      Node name	or address used	to filter interfaces.  Only interfaces
	      which can	reach the given	node or	address	will respond.

       -P, -port=<PORT>
	      Port number used to filter interfaces.

       -c, -caps=<CAP1|CAP2>..
	      Pipe separated list of capabilities used to  filter  interfaces.
	      Only  interfaces	supporting  all	of the given capabilities will
	      respond.	For more  information  on  capabilities,  see  fi_get-
	      info(3).

       -m, -mode=<MOD1|MOD2>..
	      Pipe  separated  list  of	modes used to filter interfaces.  Only
	      interfaces supporting all	of the given modes will	respond.   For
	      more information on, modes see fi_getinfo(3).

       -t, -ep_type=<EPTYPE>
	      Specifies	 the  type  of fabric interface	communication desired.
	      For example, specifying FI_EP_DGRAM would	return only interfaces
	      which support unreliable datagram.  For more information on end-
	      point types, see fi_endpoint(3).

       -a, -addr_format=<FMT>
	      Filter fabric interfaces by their	address	format.	 For  example,
	      specifying FI_SOCKADDR_IN	would return only interfaces which use
	      sockaddr_in  structures for addressing.  For more	information on
	      address formats, see fi_getinfo(3).

       -p, -provider=<PROV>
	      Filter fabric interfaces by the provider implementation.	For  a
	      list of providers, see the --list	option.

       -d, -domain=<DOMAIN>
	      Filter interfaces	to only	those with the given domain name.

       -f, -fabric=<FABRIC>
	      Filter interfaces	to only	those with the given fabric name.

   Discovery
       -e, -env
	      List  libfabric  related environment variables which can be used
	      to enable	extra configuration or tuning.

       *-g [filter]
	      Same as -e option, with output limited to	environment  variables
	      containing filter	as a substring.

       -l, -list
	      List available libfabric providers.

       -v, -verbose
	      By default, fi_info will display a summary of each of the	inter-
	      faces discovered.	 If the	verbose	option is enabled, then	all of
	      the  contents  of	the fi_info structure are displayed.  For more
	      information on the data contained	in the fi_info structure,  see
	      fi_getinfo(3).

       -version
	      Display versioning information.

USAGE EXAMPLES
	      $	fi_info	-n 30.0.11.1 -p	usnic -t FI_EP_DGRAM

       This  will  respond  with  all fabric interfaces	that can reach address
       30.0.11.1 using endpoint	type FI_EP_DGRAM with the usNIC	provider.

OUTPUT
       By default fi_info will output a	summary	of the fabric interfaces  dis-
       covered:

	      $	./fi_info -n 30.0.11.1 -p usnic	-t FI_EP_DGRAM
	      provider:	usnic
		  fabric: 30.0.11.0/24
		  domain: usnic_2
		  version: 1.0
		  type:	FI_EP_DGRAM
		  protocol: FI_PROTO_UDP

       To see the full fi_info structure, specify the -v option.

SEE ALSO
       fi_getinfo(3), fi_endpoint(3)

AUTHORS
       OpenFabrics.

Libfabric Programmer's Manual	  2021-03-22			    fi_info(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=fi_info&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help