LGRP_VERSION(3LGRP) Locality Group Library Functions LGRP_VERSION(3LGRP)

NAME

lgrp_version - coordinate library and application versions

SYNOPSIS

cc [ flag ... ] file... -llgrp [ library ... ]
#include <sys/lgrp_user.h>

int lgrp_version(const int version);

DESCRIPTION

The lgrp_version() function takes an interface version number,
version, as an argument and returns an lgroup interface version. The
version argument should be the value of LGRP_VER_CURRENT bound to the
application when it was compiled or LGRP_VER_NONE to find out the
current lgroup interface version on the running system.

RETURN VALUES

If version is still supported by the implementation, then
lgrp_version() returns the requested version. If LGRP_VER_NONE is
returned, the implementation cannot support the requested version.
The application should be recompiled and might require further
changes.


If version is LGRP_VER_NONE, lgrp_version() returns the current
version of the library.

EXAMPLES

Example 1: Test whether the version of the interface used by the

caller is supported.


The following example tests whether the version of the interface used
by the caller is supported:


#include <sys/lgrp_user.h>

if (lgrp_version(LGRP_VER_CURRENT) != LGRP_VER_CURRENT) {
fprintf(stderr, "Built with unsupported lgroup interface %d\n",
LGRP_VER_CURRENT);
exit (1);
}

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

lgrp_init(3LGRP), liblgrp(3LIB), attributes(7)

April 16, 2003 LGRP_VERSION(3LGRP)