Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xkbfreenames(3) [x11r4 man page]

XkbFreeNames(3) 						   XKB FUNCTIONS						   XkbFreeNames(3)

NAME

       XkbFreeNames - Free symbolic names structures

SYNOPSIS

       void XkbFreeNames ( xkb, which, free_map )
	     XkbDescPtr xkb;
	     unsigned int which;
	     Bool free_map;

ARGUMENTS

       - xkb  keyboard description for which names are to be freed

       - which
	      mask of names components to be freed

       - free_map
	      True => XkbNamesRec structure itself should be freed

DESCRIPTION

       Do not free symbolic names structures directly using free or XFree.  Use XkbFreeNames instead.

       The which parameter is the bitwise inclusive OR of the valid names mask bits defined in Table 1.

       Xkb  provides  several  functions  that	work  with symbolic names. Each of these functions uses a mask to specify individual fields of the
       structures described above. These masks and their relationships to the fields in a keyboard description are shown in Table 1.

				 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

X Version 11							   libX11 1.2.1 						   XkbFreeNames(3)

Check Out this Related Man Page

XkbNoteNameChanges(3)						   XKB FUNCTIONS					     XkbNoteNameChanges(3)

NAME

       XkbNoteNameChanges - Note the changed names in a changes structure

SYNOPSIS

       void XkbNoteNameChanges (XkbNameChangesPtr old, XkbNamesNotifyEvent *new, unsigned int wanted);

ARGUMENTS

       - old  XkbNameChanges structure to be updated

       - new  event from which changes are to be copied

       - wanted
	      types of names for which changes are to be noted

DESCRIPTION

       When your application receives a XkbNamesNotify event, you can note the changed names in a changes structure using XkbNoteNameChanges.

       The wanted parameter is the bitwise inclusive OR of the valid names mask bits shown in Table 1.	XkbNoteNameChanges copies any changes that
       are reported in new and specified in wanted into the changes record specified by old.

				 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

X Version 11							   libX11 1.5.0 					     XkbNoteNameChanges(3)
Man Page