XkbGetUpdatedMap − Update the client or server map information in an existing keyboard description


Status XkbGetUpdatedMap

(Display *display, unsigned int which,

XkbDescPtr xkb);


− display

connection to X server

− which

mask selecting subcomponents to populate

− xkb

keyboard description to be updated


The which parameter is a bitwise inclusive OR of the masks in Table 1. If the needed components of the xkb structure are not already allocated, XkbGetUpdatedMap allocates them. XkbGetUpdatedMap fetches the requested information for the device specified in the XkbDescRec passed in the xkb parameter.

XkbGetUpdatedMap is synchronous; it queries the server for the desired information, waits for a reply, and then returns. If successful, XkbGetUpdatedMap returns Success. If unsuccessful, XkbGetUpdatedMap returns one of the following: BadAlloc (unable to allocate a component in the XkbDescRec structure), BadValue (some mask bits in which are undefined), BadImplementation (a compatible version of the Xkb extension is not available in the server or the reply from the server was invalid).



The XkbGetUpdatedMap function returns Success if a reply is received to the server query for the desired information.


The complete description of an Xkb keyboard is given by an XkbDescRec. The component structures in the XkbDescRec represent the major Xkb components.

typedef struct {
struct _XDisplay * display; /∗ connection to X server */
unsigned short flags; /∗ private to Xkb, do not modify */
unsigned short device_spec; /∗ device of interest */
KeyCode min_key_code; /∗ minimum keycode for device */
KeyCode max_key_code; /∗ maximum keycode for device */
XkbControlsPtr ctrls; /∗ controls */
XkbServerMapPtr server; /∗ server keymap */
XkbClientMapPtr map; /∗ client keymap */
XkbIndicatorPtr indicators; /∗ indicator map */
XkbNamesPtr names; /∗ names for all components */
XkbCompatMapPtr compat; /∗ compatibility map */
XkbGeometryPtr geom; /∗ physical geometry of keyboard */
} XkbDescRec, *XkbDescPtr;

The display field points to an X display structure. The flags field is private to the library: modifying flags may yield unpredictable results. The device_spec field specifies the device identifier of the keyboard input device, or XkbUseCoreKeyboard, which specifies the core keyboard device. The min_key_code and max_key_code fields specify the least and greatest keycode that can be returned by the keyboard.

Each structure component has a corresponding mask bit that is used in function calls to indicate that the structure should be manipulated in some manner, such as allocating it or freeing it. These masks and their relationships to the fields in the XkbDescRec are shown in Table 2.



Unable to allocate storage


Invalid reply from server


An argument is out of range


XkbChangeTypesOfKey(3), XkbCopyKeyType(3), XkbCopyKeyTypes(3), XkbGetKeyActions(3), XkbGetKeyBehaviors(3), XkbGetKeyExplicitComponents(3), XkbGetKeyModifierMap(3), XkbGetKeySyms(3), XkbGetKeyTypes(3), XkbResizeKeyActions(3), XkbResizeKeySyms(3), XkbResizeKeyType(3), XkbGetVirtualModMap(3), XkbGetVirtualMods(3)

More Linux Commands

mytool(1) - manipulate map files for yudit, uniconv and unip
mytool is a my map file manipulation program in the yudit distribution. It can generates so-called binary nbit ( my ) map file that can map any sequences of byt

ObjCmdWrite(3) - Writing C language extensions to Tcl. '....
ObjCmdWrite.3 - This document is intended to help the programmer who wishes to extend Tcl with C language routines. It should also be useful to someone wishing

clear(3ncurses) - clear all or part of a curses window......
The erase and werase routines copy blanks to every position in the window, clearing the screen. The clear and wclear routines are like erase and werase, but the

SDL_SetGamma(3) - Sets the color gamma function for the disp
Sets the gamma function for the display of each color component. Gamma controls the brightness/contrast of colors displayed on the screen. A gamma value of 1.0

immedok(3ncurses) - curses output options - Linux man page
These routines set options that change the style of output within curses. All options are initially FALSE, unless otherwise stated. It is not necessary to turn

perlfaq(1) - frequently asked questions about Perl (ManPage)
The perlfaq comprises several documents that answer the most commonly asked questions about Perl and Perl programming. Its divided by topic into nine major sect

Tcl_WaitForEvent(3) - the event queue and notifier interface
The interfaces described here are used to customize the Tcl event loop. The two most common customizations are to add new sources of events and to merge Tcls ev

Tcl_GetObjResult(3) - manipulate Tcl result - Linux man page
The procedures described here are utilities for manipulating the result value in a Tcl interpreter. The interpreter result may be either a Tcl object or a strin

gnutls_pubkey_get_key_usage(3) - API function (Man Page)....
This function will return the key usage of the public key. RETURNS On success, GNUTLS_E_SUCCESS (0) is returned, otherwise a negative error value. SINCE 2.12.0

xgi(4) - XGI video driver (Special files - Linux man page)
xgi is an XFree86 driver for XGI video chips. The driver is accelerated, and provides support for colordepths of 8, 16 and 24 bpp. XVideo, Render and other exte

tsort(1) - perform topological sort - Linux manual page.....
Write totally ordered list consistent with the partial ordering in FILE. With no FILE, or when FILE is -, read standard input. --help display this help and exit

Tcl_RegExpGetInfo(3) - Pattern matching with regular express
Tcl_RegExpMatch determines whether its pattern argument matches regexp, where regexp is interpreted as a regular expression using the rules in the re_syntax ref

We can't live, work or learn in freedom unless the software we use is free.