Version Information

Version Information — variables and functions to check the GOA version

Synopsis

extern const guint  goa_major_version;
extern const guint  goa_minor_version;
extern const guint  goa_micro_version;
const gchar *       goa_check_version                   (guint required_major,
                                                         guint required_minor,
                                                         guint required_micro);

#define             GOA_MAJOR_VERSION
#define             GOA_MINOR_VERSION
#define             GOA_MICRO_VERSION
#define             GOA_CHECK_VERSION                   (major,
                                                         minor,
                                                         micro)

Description

GOA provides version information, primarily useful in configure checks for builds that have a configure script. Applications will not typically use the features described here.

Details

goa_major_version

extern const guint goa_major_version;


goa_minor_version

extern const guint goa_minor_version;


goa_micro_version

extern const guint goa_micro_version;


goa_check_version ()

const gchar *       goa_check_version                   (guint required_major,
                                                         guint required_minor,
                                                         guint required_micro);

Checks that the GOA library in use is compatible with the given version. Generally you would pass in the constants GOA_MAJOR_VERSION, GOA_MINOR_VERSION, GOA_MICRO_VERSION as the three arguments to this function; that produces a check that the library in use is compatible with the version of GOA the application or module was compiled against.

Compatibility is defined by two things: first the version of the running library is newer than the version required_major.required_minor.required_micro. Second the running library must be binary compatible with the version required_major.required_minor.required_micro (same major and minor version).

required_major :

the required major version.

required_minor :

the required minor version.

required_micro :

the required micro version.

Returns :

NULL if the GOA library is compatible with the given version, or a string describing the version mismatch. The returned string is owned by GOA and must not be modified or freed.

Since 3.8


GOA_MAJOR_VERSION

#define GOA_MAJOR_VERSION 3

The major version number of the GOA daemon and library.

Like goa_major_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 3.8


GOA_MINOR_VERSION

#define GOA_MINOR_VERSION 7

The minor version number of the GOA daemon and library.

Like goa_minor_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 3.8


GOA_MICRO_VERSION

#define GOA_MICRO_VERSION 90

The micro version number of the GOA daemon and library.

Like goa_micro_version, but from the headers used at application compile time, rather than from the library linked against at application run time.

Since 3.8


GOA_CHECK_VERSION()

#define             GOA_CHECK_VERSION(major,minor,micro)

Checks the version of the GOA library that is being compiled against.

Example 1. Checking the version of the GOA library

1
2
if (!GOA_CHECK_VERSION (3, 8, 0))
  g_error ("GOA version 3.8.0 or above is needed");


See goa_check_version() for a runtime check.

major :

the major version to check for

minor :

the minor version to check for

micro :

the micro version to check for

Returns :

TRUE if the version of the GOA header files is the same as or newer than the passed-in version.

Since 3.8