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 interfaces.  The utility supports filtering
       based  on  a  number  of options such as endpoint type, provider name, or supported modes.  Additionally,
       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 end‐
       point 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_getinfo(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  endpoint
              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 interfaces discovered.  If the verbose
              option is enabled, then all of the contents of the fi_info structure are displayed.  For more  in‐
              formation 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 discovered:

              $ ./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                      2020-01-30                                         fi_info(1)