ABI Versions

Terminology

• API version: the version defined by FI_MAJOR_VERSION and FI_MINOR_VERSION in <rdma/fabric.h>
• ABI version: the version of global symbols, as defined in libfabric.map

Rule for runtime compatibility

(va1 <= va2 <= va3) && (vb1 <= vb2 <= vb3)

Where:

• va1: API version passed to fi_getinfo()
• va2: API version of the provider used at runtime (same as va3 for built-in providers)
• va3: API version of the libfabric core used at runtime
• vb1: ABI version of the libfabric library the application is linked with
• vb2: ABI version of the provider used at runtime (same as vb3 for built-in providers)
• vb3: ABI version of the libfabric core used at runtime

Version history

API	ABI	Updated (+New) Symbols
1.4	1.0
1.5	1.1	fi_getinfo, fi_freeinfo, fi_dupinfo, fi_fabric
1.6	1.1
1.7	1.2	fi_getinfo, fi_freeinfo, fi_dupinfo
1.8	1.2
1.9	1.3	fi_getinfo, fi_freeinfo, fi_dupinfo
1.10	1.3
1.11	1.3
1.12	1.4	+fi_tostr_r
1.13	1.5	+fi_open
1.14	1.6	+fi_log_ready
1.15	1.6
1.16	1.6
1.17	1.6
1.18	1.6
1.19	1.6
1.20	1.7	fi_getinfo, fi_freeinfo, fi_dupinfo