XkbAllocClientMap(3)
NAME
XkbAllocClientMap - Allocate and initialize an empty client map description record
SYNOPSIS
Status XkbAllocClientMap (XkbDescPtr xkb, unsigned int which, unsigned
int type_count);
ARGUMENTS
- xkb keyboard description in which to allocate client map
- which
mask selecting map components to allocate
- type_count
value of num_types field in map to be allocated
DESCRIPTION
Calling XkbGetMap should be sufficient for most applications to get
client and server maps. As a result, most applications do not need to
directly allocate client and server maps.
If you change the number of key types or construct map components
without loading the necessary components from the X server, do not
allocate any map components directly using malloc or Xmalloc. Instead,
use the Xkb allocators, XkbAllocClientMap, and XkbAllocServerMap.
Similarly, use the Xkb destructors, XkbFreeClientMap, and
XkbFreeServerMap instead of free or Xfree.
XkbAllocClientMap allocates and initializes an empty client map in the
map field of the keyboard description specified by xkb. The which
parameter specifies the particular components of the client map
structure to allocate and is a mask composed by a bitwise inclusive OR
of one or more of the masks shown in Table 1.
Table 1 XkbAllocClientMap Masks
Mask Effect
XkbKeyTypesMask The type_count field specifies the
number of entries to preallocate for the
types field of the client map. If the
type_count field is less than
XkbNumRequiredTypes returns BadValue.
XkbKeySymsMask The min_key_code and max_key_code fields
of the xkb parameter are used to
allocate the syms and key_sym_map fields
of the client map. The fields are
allocated to contain the maximum number
of entries necessary for max_key_code -
min_key_code + 1 keys.
XkbModifierMapMask The min_key_code and max_key_code fields
of the xkb parameter are used to
allocate the modmap field of the client
map. The field is allocated to contain
the maximum number of entries necessary
for max_key_code - min_key_code + 1
keys.
NOTE: The min_key_code and max_key_code fields of the xkb parameter
must be legal values if the XkbKeySymsMask or XkbModifierMapMask masks
are set in the which parameter. If they are not valid,
XkbAllocClientMap returns BadValue.
If the client map of the keyboard description is not NULL, and any
fields are already allocated in the client map, XkbAllocClientMap does
not overwrite the existing values; it simply ignores that part of the
request. The only exception is the types array. If type_count is
greater than the current num_types field of the client map,
XkbAllocClientMap resizes the types array and resets the num_types
field accordingly.
If XkbAllocClientMap is successful, it returns Success. Otherwise, it
can return either BadMatch, BadAlloc, or BadValue 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
SEE ALSO
XkbAllocClientMap(3), XkbAllocServerMap(3), XkbFreeClientMap,(3), XkbFreeServerMap(3), XkbGetMap(3)
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
