fi_info(1)

1fi_info(1)                     Libfabric v1.6.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.  Addition‐
15       ally, fi_info can also be used to discover  the  environment  variables
16       that  can  be used to tune provider specific parameters.  If no filters
17       are specified, then all available fabric interfaces for  all  providers
18       and endpoint types will be returned.
19

OPTIONS

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

USAGE EXAMPLES

70              $ fi_info -n 30.0.11.1 -p usnic -t FI_EP_DGRAM
71
72       This  will  respond  with  all fabric interfaces that can reach address
73       30.0.11.1 using endpoint type FI_EP_DGRAM with the usNIC provider.
74

OUTPUT

76       By default fi_info will output a summary of the fabric interfaces  dis‐
77       covered:
78
79              $ ./fi_info -n 30.0.11.1 -p usnic -t FI_EP_DGRAM
80              provider: usnic
81                  fabric: 30.0.11.0/24
82                  domain: usnic_2
83                  version: 1.0
84                  type: FI_EP_DGRAM
85                  protocol: FI_PROTO_UDP
86
87       To see the full fi_info structure, specify the -v option.
88

AUTHORS

93       OpenFabrics.
94
95
96
97Libfabric Programmer's Manual     2017-12-01                        fi_info(1)