flux_core_version(3)

SYNOPSIS

#include <flux/core.h>

int flux_core_version (int *major, int *minor, int *patch);

const char *flux_core_version_string (void);

Link with -lflux-core.

DESCRIPTION

flux-core defines several macros and functions to let API users determine the version they are working with. A version has three components (major, minor, patch), accessible with the following macros:

FLUX_CORE_VERSION_MAJOR

(integer) incremented when there are incompatible API changes

FLUX_CORE_VERSION_MINOR

(integer) incremented when functionality is added in a backwards-compatible manner

FLUX_CORE_VERSION_PATCH

(integer) incremented when bug fixes are added in a backwards-compatible manner

These definitions conform to the semantic versioning standard (see below). In addition, the following convenience macros are available:

FLUX_CORE_VERSION_HEX

(hex) the three versions combined into a three-byte integer value, useful for comparing versions with <, =, and > operators.

FLUX_CORE_VERSION_STRING

(string) the three versions above separated by periods, with optional git-describe(1) suffix preceded by a hyphen, if the version is a development snapshot.

Note that major version zero (0.y.z) is for initial development. Under version zero, the public API should not be considered stable.

Functions are also available to access the same values. While the header macros tell what version of flux-core your program was compiled against, the functions tell what version your program is dynamically linked with.

flux_core_version() sets major, minor, and patch to the values of the macros above. If any parameters are NULL, no assignment is attempted.

flux_core_version_string() returns the string value.

RETURN VALUE

flux_core_version() returns the hex version.

flux_core_version_string() returns the version string

ERRORS

These functions cannot fail.

RESOURCES

Flux: http://flux-framework.org

Flux RFC: https://flux-framework.readthedocs.io/projects/flux-rfc

Semantic Versioning 2.0.0: http://semver.org