xkblibraryversion(3) [centos man page]

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 possi-
       ble 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, XkbLi-
       braryVersion 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.6.0 					      XkbLibraryVersion(3)

XkbQueryExtension(3)						   XKB FUNCTIONS					      XkbQueryExtension(3)

NAME

       XkbQueryExtension -  Determines the compatibility of a library at runtime.

SYNOPSIS

       Bool XkbQueryExtension (Display *dpy, int *opcode_rtrn, int *event_rtrn, int *error_rtrn, int *major_in_out, int *minor_in_out);

ARGUMENTS

       dpy    connection to the X server

       opcode_rtrn
	      backfilled with the major extension opcode

       event_rtrn
	      backfilled with the extension base event code

       error_rtrn
	      backfilled with the extension base error code

       major_in_out
	      compile time lib major version in, server major version out

       minor_in_out
	      compile time lib min version in, server minor version out

DESCRIPTION

       Call  XkbQueryExtension to check for the presence and compatibility of the extension in the server and to initialize the extension. Because
       of potential version mismatches, you cannot use the generic extension mechanism functions ( XQueryExtension and XInitExtension ) for check-
       ing for the presence of, and initializing the Xkb extension.

       You must call XkbQueryExtension or XkbOpenDisplay before using any other Xkb library interfaces, unless such usage is explicitly allowed in
       the interface description in this document. The exceptions are: XkbIgnoreExtension, XkbLibraryVersion, and a handful of audible-bell  func-
       tions.  You  should  not  use any other Xkb functions if the extension is not present or is uninitialized. In general, calls to Xkb library
       functions made prior to initializing the Xkb extension cause BadAccess protocol errors.

       XkbQueryExtension both determines whether a compatible Xkb extension is present in the X server and initializes the extension  when  it	is
       present.

       The  XkbQueryExtension function determines whether a compatible version of the X Keyboard Extension is present in the server. If a compati-
       ble extension is present, XkbQueryExtension returns True; otherwise, it returns False.

       If a compatible version of Xkb is present, XkbQueryExtension initializes the extension. It backfills the  major	opcode	for  the  keyboard
       extension  in opcode_rtrn, the base event code in event_rtrn, the base error code in error_rtrn, and the major and minor version numbers of
       the extension in major_in_out and minor_in_out.	The major opcode is reported in the req_major fields of some Xkb events. For a	discussion
       of the base event code.

RETURN VALUES

       True	      The  XkbQueryExtension function returns True if it determines a compatible version of the X Keyboard Extension is present in
		      the server.

       False	      The XkbQueryExtension function returns False if it determines a compatible version  of  the  X  Keyboard	Extension  is  not
		      present in the server.

SEE ALSO

       XkbIgnoreExtension(3), XkbLibraryVersion(3), XkbOpenDisplay(3)

X Version 11							   libX11 1.5.0 					      XkbQueryExtension(3)