FreeBSD manual
download PDF document: XkbLibraryVersion.3.pdf
XkbLibraryVersion(3) XKB FUNCTIONS XkbLibraryVersion(3)
NAME
XkbLibraryVersion - Determines the compatibility of a library at
runtime.
SYNOPSIS
Bool XkbLibraryVersion (int *lib_major_in_out, int *lib_minor_in_out);
ARGUMENTS
lib_major_in_out
Specifies and returns the major Xkb library version.
lib_minor_in_out
Specifies and returns the minor Xkb library version.
DESCRIPTION
If an application is dynamically linked, both the X server and the
client-side X library must contain the Xkb extension in order for the
client to use the Xkb extension capabilities. Therefore a dynamically
linked application must check both the library and the server for
compatibility before using Xkb function calls. A properly written
program must check for compatibility between the version of the Xkb
library that is dynamically loaded and the one used when the
application was built. It must then check the server version for
compatibility with the version of Xkb in the library.
If your application is statically linked, you must still check for
server compatibility and may check library compatibility. (It is
possible to compile against one set of header files and link against a
different, incompatible, version of the library, although this should
not normally occur.)
Pass the symbolic value XkbMajorVersion in lib_major_in_out and
XkbMinorVersion in lib_minor_in_out. These arguments represent the
version of the library used at compile time. The XkbLibraryVersion
function backfills the major and minor version numbers of the library
used at run time in lib_major_in_out and lib_minor_in_out. If the
versions of the compile time and run time libraries are compatible,
XkbLibraryVersion returns True, otherwise, it returns False.
In addition, in order to use the Xkb extension, you must ensure that
the extension is present in the server and that the server supports the
version of the extension expected by the client. Use XkbQueryExtension
to do this, as described in the next section.
RETURN VALUES
True The XkbLibraryVersion returns True if the versions of
the compile time and run time libraries are compatible.
False The XkbLibraryVersion returns False if the versions of
the compile time and run time libraries are not
compatible.
SEE ALSO
XkbMajorVersion(3), XkbMinorVersion(3), XkbQueryExtension(3)
X Version 11 libX11 1.8.7 XkbLibraryVersion(3)