fi_info(1)

1fi_info(1)                     Libfabric v1.15.1                    fi_info(1)
2
3
4

NAME

6       fi_info - Simple utility to query for fabric interfaces
7

SYNOPSIS

9               fi_info [OPTIONS]
10

DESCRIPTION

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

OPTIONS

21   Filtering
22       -n, –node=<NAME>
23              Node name or address used to filter interfaces.  Only interfaces
24              which can reach the given node or address will respond.
25
26       -P, –port=<PORT>
27              Port number used to filter interfaces.
28
29       -c, –caps=<CAP1|CAP2>..
30              Pipe separated list of capabilities used to  filter  interfaces.
31              Only  interfaces  supporting  all of the given capabilities will
32              respond.  For more  information  on  capabilities,  see  fi_get‐
33              info(3).
34
35       -m, –mode=<MOD1|MOD2>..
36              Pipe  separated  list  of modes used to filter interfaces.  Only
37              interfaces supporting all of the given modes will respond.   For
38              more information on, modes see fi_getinfo(3).
39
40       -t, –ep_type=<EPTYPE>
41              Specifies  the  type  of fabric interface communication desired.
42              For example, specifying FI_EP_DGRAM would return only interfaces
43              which support unreliable datagram.  For more information on end‐
44              point types, see fi_endpoint(3).
45
46       -a, –addr_format=<FMT>
47              Filter fabric interfaces by their address format.  For  example,
48              specifying FI_SOCKADDR_IN would return only interfaces which use
49              sockaddr_in structures for addressing.  For more information  on
50              address formats, see fi_getinfo(3).
51
52       -p, –provider=<PROV>
53              Filter  fabric interfaces by the provider implementation.  For a
54              list of providers, see the --list option.
55
56       -d, –domain=<DOMAIN>
57              Filter interfaces to only those with the given domain name.
58
59       -f, –fabric=<FABRIC>
60              Filter interfaces to only those with the given fabric name.
61
62   Discovery
63       -e, –env
64              List libfabric related environment variables which can  be  used
65              to enable extra configuration or tuning.
66
67       *-g [filter]
68              Same  as -e option, with output limited to environment variables
69              containing filter as a substring.
70
71       -l, –list
72              List available libfabric providers.
73
74       -v, –verbose
75              By default, fi_info will display a summary of each of the inter‐
76              faces discovered.  If the verbose option is enabled, then all of
77              the contents of the fi_info structure are displayed.   For  more
78              information  on the data contained in the fi_info structure, see
79              fi_getinfo(3).
80
81       –version
82              Display versioning information.
83

USAGE EXAMPLES

85              $ fi_info -n 30.0.11.1 -p usnic -t FI_EP_DGRAM
86
87       This will respond with all fabric interfaces  that  can  reach  address
88       30.0.11.1 using endpoint type FI_EP_DGRAM with the usNIC provider.
89

OUTPUT

91       By  default fi_info will output a summary of the fabric interfaces dis‐
92       covered:
93
94              $ ./fi_info -n 30.0.11.1 -p usnic -t FI_EP_DGRAM
95              provider: usnic
96                  fabric: 30.0.11.0/24
97                  domain: usnic_2
98                  version: 1.0
99                  type: FI_EP_DGRAM
100                  protocol: FI_PROTO_UDP
101
102       To see the full fi_info structure, specify the -v option.
103

AUTHORS

108       OpenFabrics.
109
110
111
112Libfabric Programmer’s Manual     2021-03-22                        fi_info(1)