1. NAME

XkbGetNames - Obtain symbolic names from the server

2. SYNOPSIS

Status XkbGetNames (Display * dpy , unsigned int which , XkbDescPtr Xkb );

3. ARGUMENTS

  • - dpy
        connection to the X server
  • - which
        mask of names or map components to be updated
  • - Xkb
        keyboard description to be updated

4. DESCRIPTION

XkbGetNamesretrieves symbolic names for the components of the keyboard extension from the X server. The whichparameter specifies the name components to be updated in the xkbparameter, and is the bitwise inclusive OR of the valid names mask bits defined in Table 1.

c s s s
Table 1 Symbolic Names Masks
_
Mask Bit Value Keyboard Field
Component
_
XkbKeycodesNameMask (1<<0) Xkb->names keycodes
XkbGeometryNameMask (1<<1) Xkb->names geometry
XkbSymbolsNameMask (1<<2) Xkb->names symbols
XkbPhysSymbolsNameMask (1<<3) Xkb->names phys_symbols
XkbTypesNameMask (1<<4) Xkb->names type
XkbCompatNameMask (1<<5) Xkb->names compat
XkbKeyTypeNamesMask (1<<6) Xkb->map type[*].name
XkbKTLevelNamesMask (1<<7) Xkb->map type[*].lvl_names[*]
XkbIndicatorNamesMask (1<<8) Xkb->names indicators[*]
XkbKeyNamesMask (1<<9) Xkb->names keys[*], num_keys
XkbKeyAliasesMask (1<<10) Xkb->names key_aliases[*], num_key_aliases
XkbVirtualModNamesMask (1<<11) Xkb->names vmods[*]
XkbGroupNamesMask (1<<12) Xkb->names groups[*]
XkbRGNamesMask (1<<13) Xkb->names radio_groups[*], num_rg
XkbComponentNamesMask (0x3f) Xkb->names keycodes,
geometry,
symbols,
physical symbols,
types, and
compatibility map
XkbAllNamesMask (0x3fff) Xkb->names all name components

If the namesfield of the keyboard description xkbis NULL, XkbGetNamesallocates and initializes the namescomponent of the keyboard description before obtaining the values specified by which.If the names field ofxkbis not NULL, XkbGetNamesobtains the values specified by whichand copies them into the keyboard description Xkb. If the mapcomponent of the xkbparameter is NULL, XkbGetNamesdoes not retrieve type or shift level names, even if XkbKeyTypeNamesMask or XkbKTLevelNamesMask are set in which. XkbGetNamescan return Success, or BadAlloc, BadLength, BadMatch, and BadImplementation errors. To free symbolic names, use XkbFreeNames.

5. DIAGNOSTICS

BadAlloc

               Unable to allocate storage

BadImplementation

               Invalid reply from server

BadLength

               The length of a request is shorter or longer than that required 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

6. SEE ALSO

R XkbFreeNames (3)