XkbGetKeyboard(3) Retrieves one or more components of a keyboard device

SYNOPSIS

XkbDescPtr XkbGetKeyboard (Display *display, unsigned int which, unsigned int device_spec);
     

ARGUMENTS

display
connection to the X server
device_spec
device ID, or XkbUseCoreKbd
bits_to_change
determines events to be selected / deselected
values_for_bits
1=>select, 0->deselect; for events in bits_to_change

DESCRIPTION

XkbGetKeyboard allocates and returns a pointer to a keyboard description. It queries the server for those components specified in the which parameter for device device_spec and copies the results to the XkbDescRec it allocated. The remaining fields in the keyboard description are set to NULL. The valid masks for which are those listed in Table 1.

Table 1 Mask Bits for XkbDescRec

Mask BitXkbDescRec FieldValue

XkbControlsMaskctrls(1L<<0)
XkbServerMapMaskserver(1L<<1)
XkbIClientMapMaskmap(1L<<2)
XkbIndicatorMapMaskindicators(1L<<3)
XkbNamesMasknames(1L<<4)
XkbCompatMapMaskcompat(1L<<5)
XkbGeometryMaskgeom(1L<<6)
XkbAllComponentsMaskAll Fields(1L<<7)

XkbGetKeyboard is used to read the current description for one or more components of a keyboard device. It calls XkbGetKeyboardByName as follows:

XkbGetKeyboardByName(dpy, device_spec, NULL, which, which, False).

DIAGNOSTICS

BadAlloc
Unable to allocate storage