fi_info(1) @VERSION@ fi_info(1)NAMEfi_info - Simple utility to query for fabric interfaces
SYNOPSISfi_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. Addition‐
ally, 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 capa‐
bilities 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 commu‐
nication desired. For example, specifying FI_EP_DGRAM would return
only interfaces which support unreliable datagram. For more informa‐
tion 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 imple‐
mentation. 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 levels which can be used
to enable extra configuration or tuning.
-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
information on the data contained in the fi_info structure, see fi_get‐
info(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 ALSOfi_getinfo(3), fi_endpoint(3)AUTHORS
OpenFabrics.
Libfabric Programmer's Manual 2016-09-12 fi_info(1)