fi_info(1)

1fi_info(1)                     Libfabric v1.7.0                     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 levels which can be  used  to
65              enable extra configuration or tuning.
66
67       -l, --list
68              List available libfabric providers.
69
70       -v, --verbose
71              By default, fi_info will display a summary of each of the inter‐
72              faces discovered.  If the verbose option is enabled, then all of
73              the  contents  of the fi_info structure are displayed.  For more
74              information on the data contained in the fi_info structure,  see
75              fi_getinfo(3).
76
77       --version
78              Display versioning information.
79

USAGE EXAMPLES

81              $ fi_info -n 30.0.11.1 -p usnic -t FI_EP_DGRAM
82
83       This  will  respond  with  all fabric interfaces that can reach address
84       30.0.11.1 using endpoint type FI_EP_DGRAM with the usNIC provider.
85

OUTPUT

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

AUTHORS

104       OpenFabrics.
105
106
107
108Libfabric Programmer's Manual     2018-10-05                        fi_info(1)