Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XkbGetCompatMap(3)		  XKB FUNCTIONS 	      XkbGetCompatMap(3)

NAME
     XkbGetCompatMap  -  Fetch	any combination of the current compatibility map
     components from the server

SYNOPSIS
     Status XkbGetCompatMap (Display *display, unsigned  int  which,  XkbDescRec
	    *xkb);

ARGUMENTS
     display
	    connection to server

     which  mask of compatibility map components to fetch

     xkb    keyboard description where results placed

DESCRIPTION
     When another client modifies the compatibility map, you are notified if you
     have  selected  for XkbCompatMapNotify events.  XkbGetCompatMap is particu-
     larly useful when you receive an event of this type, as it  allows  you  to
     update  your  program's version of the compatibility map to match the modi-
     fied version now in the server. If your program is  dealing  with	multiple
     servers  and  needs  to configure them all in a similar manner, the updated
     compatibility map may be used to reconfigure other servers.

     XkbGetCompatMap fetches the components of the compatibility  map  specified
     in which from the server specified by display and places them in the compat
     structure	of  the keyboard description xkb.  Valid values for which are an
     inclusive OR of the values shown in Table 1.

	       Table 1 Compatibility Map Component Masks
     ---------------------------------------------------------------
     Mask		  Value    Affecting
     ---------------------------------------------------------------
     XkbSymInterpMask	  (1<<0)   Symbol interpretations
     XkbGroupCompatMask   (1<<1)   Group maps
     XkbAllCompatMask	  (0x3)    All compatibility map components

     If no compatibility map structure is allocated in xkb upon  entry,  XkbGet-
     CompatMap	allocates one. If one already exists, its contents are overwrit-
     ten with the returned results.

     XkbGetCompatMap fetches compatibility map information for the device speci-
     fied by the device_spec field of xkb.  Unless you have  specifically  modi-
     fied  this  field,  it is the default keyboard device.  XkbGetCompatMap re-
     turns Success if successful, BadAlloc if it is unable to  obtain  necessary
     storage  for  either  the	return values or work space, BadMatch if the dpy
     field of the xkb argument is non-NULL and does not match the display  argu-
     ment, and BadLength under certain conditions caused by server or Xkb imple-
     mentation errors.

DIAGNOSTICS
     BadAlloc	    Unable to allocate storage

     BadLength	    The  length  of a request is shorter or longer than that re-
		    quired to minimally contain the arguments

     BadMatch	    A compatible version of Xkb was not available in the  server
		    or	an argument has correct type and range, but is otherwise
		    invalid

X Version 11			  libX11 1.8.13 	      XkbGetCompatMap(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XkbGetCompatMap&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help