1fi_control(3) Libfabric v1.17.0 fi_control(3)
2
3
4
6 fi_control - Perform an operation on a fabric resource.
7
9 #include <rdma/fabric.h>
10
11 int fi_control(struct fid *fid, int command, void *arg);
12 int fi_alias(struct fid *fid, struct fid **alias_fid, uint64_t flags);
13 int fi_get_val(struct fid *fid, int name, void *val);
14 int fi_set_val(struct fid *fid, int name, void *val);
15
17 fid Fabric resource
18
19 command
20 Operation to perform
21
22 arg Optional argument to the command
23
25 The fi_control operation is used to perform one or more operations on a
26 fabric resource. Conceptually, fi_control is similar to the POSIX fc‐
27 ntl routine. The exact behavior of using fi_control depends on the
28 fabric resource being operated on, the specified command, and any pro‐
29 vided arguments for the command. For specific details, see the fabric
30 resource specific help pages noted below.
31
32 fi_alias, fi_get_val, and fi_set_val are wrappers for fi_control with
33 commands FI_ALIAS, FI_GET_VAL, FI_SET_VAL, respectively. fi_alias cre‐
34 ates an alias of the specified fabric resource. fi_get_val reads the
35 value of the named parameter associated with the fabric resource, while
36 fi_set_val updates that value. Available parameter names depend on the
37 type of the fabric resource and the provider in use. Providers may de‐
38 fine provider specific names in the provider extension header files
39 (’rdma/fi_ext_*.h’). Please refer to the provider man pages for de‐
40 tails.
41
43 fi_endpoint(3), fi_cm(3), fi_cntr(3), fi_cq(3), fi_eq(3),
44
46 OpenFabrics.
47
48
49
50Libfabric Programmer’s Manual 2022-12-11 fi_control(3)