XkbAllocServerMap(3)		 XKB FUNCTIONS		  XkbAllocServerMap(3)



NAME
       XkbAllocServerMap  -  Allocate  and  initialize	an  empty  server  map
       description record

SYNOPSIS
       Status XkbAllocServerMap ( xkb, which, count_acts )

	     XkbDescPtr xkb;
	     unsigned int which;
	     unsigned int count_acts;

ARGUMENTS
       - xkb  keyboard description in which to allocate server map

       - which
	      mask selecting map components to allocate

       - count_acts
	      value of num_acts field in map to be allocated

DESCRIPTION
       XkbAllocServerMap allocates and initializes an empty server map in  the
       server  field  of the keyboard description specified by xkb.  The which
       parameter specifies the particular components of the server map	struc-
       ture to allocate, as specified in Table 1.


			 Table 1 XkbAllocServerMap Masks
       ---------------------------------------------------------------------
       Mask			   Effect
       ---------------------------------------------------------------------
       XkbExplicitComponentsMask   The min_key_code and max_key_code fields
				   of the xkb parameter are used  to  allo-
				   cate  the  explicit	field of the server
				   map.

       XkbKeyActionsMask	   The min_key_code and max_key_code fields
				   of  the  xkb parameter are used to allo-
				   cate the key_acts field  of	the  server
				   map. The count_acts parameter is used to
				   allocate the acts field  of	the  server
				   map.

       XkbKeyBehaviorsMask	   The min_key_code and max_key_code fields
				   of the xkb parameter are used  to  allo-
				   cate  the  behaviors field of the server
				   map.

       XkbVirtualModMapMask	   The min_key_code and max_key_code fields
				   of  the  xkb parameter are used to allo-
				   cate the vmodmap  field  of	the  server
				   map.


       If  the	server	map  of  the  keyboard description is not NULL and any
       fields are already allocated in the server map, XkbAllocServerMap  does
       not  overwrite the existing values. The only exception is with the acts
       array. If the count_acts parameter is greater than the current num_acts
       field  of  the server map, XkbAllocServerMap resizes the acts array and
       resets the num_acts field accordingly.

       If XkbAllocServerMap is successful, it returns Success.	Otherwise,  it
       can return either BadMatch or BadAlloc errors.

DIAGNOSTICS
       BadAlloc       Unable to allocate storage

       BadMatch       A  compatible  version  of  Xkb was not available in the
		      server or an argument has correct type and range, but is
		      otherwise invalid

       BadValue       An argument is out of range

NOTES
       The  min_key_code  and max_key_code fields of the xkb parameter must be
       legal values. If they are not  valid,  XkbAllocServerMap  returns  Bad-
       Value.



X Version 11			 libX11 1.2.1		  XkbAllocServerMap(3)

NAME - SYNOPSIS - ARGUMENTS - DESCRIPTION - DIAGNOSTICS - NOTES -