Manual Pages for UNIX Operating System command usage for man XkbAllocServerMap

XKB FUNCTIONS                             XkbAllocServerMap(3x11)



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

SYNOPSIS
     cc [ flag... ] file... -lX11 [ library... ]

     Status  XkbAllocServerMap  (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 speci-
     fied by xkb. The which parameter  specifies  the  particular
     components  of  the  server  map  structure  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.








X Version 11        Last change: libX11 1.3.5                   1






XKB FUNCTIONS                             XkbAllocServerMap(3x11)



     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. Oth-
     erwise, 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  parame-
     ter  must  be  legal  values.  If they are not valid, XkbAl-
     locServerMap returns BadValue.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|










X Version 11        Last change: libX11 1.3.5                   2