xkballockeyboard(3) [x11r4 man page]

XkbAllocKeyboard(3)						   XKB FUNCTIONS					       XkbAllocKeyboard(3)

NAME

       XkbAllocKeyboard -  Creates a keyboard description from scratch

SYNOPSIS

       XkbDescRec XkbAllocKeyboard ( void )

DESCRIPTION

       Applications  seldom  need  to  directly allocate a keyboard description; calling XkbGetKeyboard usually suffices. In the event you need to
       create a keyboard description from scratch, however, use XkbAllocKeyboard rather than directly calling malloc.

       If XkbAllocKeyboard fails to allocate the keyboard description, it returns NULL.  Otherwise, it returns a  pointer  to  an  empty  keyboard
       description  structure. The device_spec field will have been initialized to XkbUseCoreKbd. You may then either fill in the structure compo-
       nents or use Xkb functions to obtain values for the structure components from a keyboard device.

SEE ALSO

       malloc(3F), XkbUseCoreKbd(3), XkbGetKeyboard(3)

X Version 11							   libX11 1.2.1 					       XkbAllocKeyboard(3)

XkbGetKeyboard(3)						   XKB FUNCTIONS						 XkbGetKeyboard(3)

NAME

       XkbGetKeyboard -   Retrieves one or more components of a keyboard device description

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 Bit 	      XkbDescRec Field	 Value
       --------------------------------------------------
       XkbControlsMask	      ctrls		 (1L<<0)
       XkbServerMapMask       server		 (1L<<1)
       XkbIClientMapMask      map		 (1L<<2)
       XkbIndicatorMapMask    indicators	 (1L<<3)
       XkbNamesMask	      names		 (1L<<4)
       XkbCompatMapMask       compat		 (1L<<5)
       XkbGeometryMask	      geom		 (1L<<6)
       XkbAllComponentsMask   All 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

X Version 11							   libX11 1.5.0 						 XkbGetKeyboard(3)