Man Linux: Main Page and Category List

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)