1 /************************************************************
2 * Copyright (c) 1994 by Silicon Graphics Computer Systems, Inc.
4 * Permission to use, copy, modify, and distribute this
5 * software and its documentation for any purpose and without
6 * fee is hereby granted, provided that the above copyright
7 * notice appear in all copies and that both that copyright
8 * notice and this permission notice appear in supporting
9 * documentation, and that the name of Silicon Graphics not be
10 * used in advertising or publicity pertaining to distribution
11 * of the software without specific prior written permission.
12 * Silicon Graphics makes no representation about the suitability
13 * of this software for any purpose. It is provided "as is"
14 * without any express or implied warranty.
16 * SILICON GRAPHICS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
17 * SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
18 * AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SILICON
19 * GRAPHICS BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
20 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
21 * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
22 * OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH
23 * THE USE OR PERFORMANCE OF THIS SOFTWARE.
25 ********************************************************/
28 * Copyright © 2012 Intel Corporation
30 * Permission is hereby granted, free of charge, to any person obtaining a
31 * copy of this software and associated documentation files (the "Software"),
32 * to deal in the Software without restriction, including without limitation
33 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
34 * and/or sell copies of the Software, and to permit persons to whom the
35 * Software is furnished to do so, subject to the following conditions:
37 * The above copyright notice and this permission notice (including the next
38 * paragraph) shall be included in all copies or substantial portions of the
41 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
42 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
43 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
44 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
45 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
46 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
47 * DEALINGS IN THE SOFTWARE.
49 * Author: Daniel Stone <daniel@fooishbar.org>
60 #define VMOD_HIDE_VALUE 0
61 #define VMOD_SHOW_VALUE 1
62 #define VMOD_COMMENT_VALUE 2
64 #define BUF_CHUNK_SIZE 4096
73 do_realloc(struct buf *buf, size_t at_least)
77 buf->alloc += BUF_CHUNK_SIZE;
78 if (at_least >= BUF_CHUNK_SIZE)
79 buf->alloc += at_least;
81 new = realloc(buf->buf, buf->alloc);
89 ATTR_PRINTF(2, 3) static bool
90 check_write_buf(struct buf *buf, const char *fmt, ...)
96 available = buf->alloc - buf->size;
98 printed = vsnprintf(buf->buf + buf->size, available, fmt, args);
104 if (printed >= available)
105 if (!do_realloc(buf, printed))
108 /* The buffer has enough space now. */
110 available = buf->alloc - buf->size;
112 printed = vsnprintf(buf->buf + buf->size, available, fmt, args);
115 if (printed >= available || printed < 0)
118 buf->size += printed;
127 #define write_buf(buf, ...) do { \
128 if (!check_write_buf(buf, __VA_ARGS__)) \
133 write_vmods(struct xkb_keymap *keymap, struct buf *buf)
138 for (i = 0; i < XkbNumVirtualMods; i++) {
139 if (!keymap->vmod_names[i])
142 write_buf(buf, "\t\tvirtual_modifiers ");
145 write_buf(buf, "%s", keymap->vmod_names[i]);
150 write_buf(buf, ";\n\n");
155 #define GET_TEXT_BUF_SIZE 512
157 #define append_get_text(...) do { \
158 int _size = snprintf(ret, GET_TEXT_BUF_SIZE, __VA_ARGS__); \
159 if (_size >= GET_TEXT_BUF_SIZE) \
163 /* FIXME: Merge with src/xkbcomp/expr.c::modIndexNames. */
164 static const char *core_mod_names[] = {
176 get_mod_index_text(uint8_t real_mod)
178 return core_mod_names[real_mod];
182 get_mod_mask_text(struct xkb_keymap *keymap, uint8_t real_mods,
185 static char ret[GET_TEXT_BUF_SIZE], ret2[GET_TEXT_BUF_SIZE];
188 memset(ret, 0, GET_TEXT_BUF_SIZE);
190 if (real_mods == 0 && vmods == 0) {
195 /* This is so broken. If we have a real modmask of 0xff and a
196 * vmodmask, we'll get, e.g., all+RightControl. But, it's what xkbfile
198 if (real_mods == 0xff) {
201 else if (real_mods) {
202 for (i = 0; i < XkbNumModifiers; i++) {
203 if (!(real_mods & (1 << i)))
205 if (ret[0] != '\0') {
207 append_get_text("%s+%s", ret2, core_mod_names[i]);
210 append_get_text("%s", core_mod_names[i]);
218 for (i = 0; i < XkbNumVirtualMods; i++) {
219 if (!(vmods & (1 << i)))
221 if (ret[0] != '\0') {
223 append_get_text("%s+%s", ret2, keymap->vmod_names[i]);
226 append_get_text("%s", keymap->vmod_names[i]);
234 get_indicator_state_text(uint8_t which)
237 static char ret[GET_TEXT_BUF_SIZE];
238 /* FIXME: Merge with ... something ... in xkbcomp? */
239 static const char *state_names[] = {
247 memset(ret, 0, GET_TEXT_BUF_SIZE);
249 which &= XkbIM_UseAnyMods;
256 for (i = 0; which != 0; i++) {
257 if (!(which & (1 << i)))
262 append_get_text("%s+%s", ret, state_names[i]);
264 append_get_text("%s", state_names[i]);
271 get_control_mask_text(uint32_t control_mask)
274 static char ret[GET_TEXT_BUF_SIZE];
275 /* FIXME: Merge with ... something ... in xkbcomp. */
276 static const char *ctrl_names[] = {
292 memset(ret, 0, GET_TEXT_BUF_SIZE);
294 control_mask &= XkbAllBooleanCtrlsMask;
296 if (control_mask == 0) {
300 else if (control_mask == XkbAllBooleanCtrlsMask) {
305 for (i = 0; control_mask; i++) {
306 if (!(control_mask & (1 << i)))
308 control_mask &= ~(1 << i);
311 append_get_text("%s+%s", ret, ctrl_names[i]);
313 append_get_text("%s", ctrl_names[i]);
320 write_keycodes(struct xkb_keymap *keymap, struct buf *buf)
323 struct xkb_key_alias *alias;
326 if (keymap->keycodes_section_name)
327 write_buf(buf, "\txkb_keycodes \"%s\" {\n",
328 keymap->keycodes_section_name);
330 write_buf(buf, "\txkb_keycodes {\n");
332 write_buf(buf, "\t\tminimum = %d;\n",
333 keymap->min_key_code);
334 write_buf(buf, "\t\tmaximum = %d;\n",
335 keymap->max_key_code);
337 xkb_foreach_key(key, keymap) {
338 if (key->name[0] == '\0')
341 write_buf(buf, "\t\t%6s = %d;\n",
342 KeyNameText(key->name), XkbKeyGetKeycode(keymap, key));
345 for (i = 0; i < XkbNumIndicators; i++) {
346 if (!keymap->indicator_names[i])
348 write_buf(buf, "\t\tindicator %d = \"%s\";\n",
349 i + 1, keymap->indicator_names[i]);
353 darray_foreach(alias, keymap->key_aliases)
354 write_buf(buf, "\t\talias %6s = %6s;\n",
355 KeyNameText(alias->alias),
356 KeyNameText(alias->real));
358 write_buf(buf, "\t};\n\n");
363 write_types(struct xkb_keymap *keymap, struct buf *buf)
366 struct xkb_key_type *type;
368 if (keymap->types_section_name)
369 write_buf(buf, "\txkb_types \"%s\" {\n\n",
370 keymap->types_section_name);
372 write_buf(buf, "\txkb_types {\n\n");
374 write_vmods(keymap, buf);
376 darray_foreach(type, keymap->types) {
377 write_buf(buf, "\t\ttype \"%s\" {\n",
379 write_buf(buf, "\t\t\tmodifiers= %s;\n",
380 get_mod_mask_text(keymap, type->mods.real_mods,
383 for (n = 0; n < darray_size(type->map); n++) {
384 struct xkb_kt_map_entry *entry = &darray_item(type->map, n);
387 str = get_mod_mask_text(keymap, entry->mods.real_mods,
389 write_buf(buf, "\t\t\tmap[%s]= Level%d;\n",
390 str, entry->level + 1);
392 if (!type->preserve || (!type->preserve[n].real_mods &&
393 !type->preserve[n].vmods))
395 write_buf(buf, "\t\t\tpreserve[%s]= ", str);
396 write_buf(buf, "%s;\n",
397 get_mod_mask_text(keymap, type->preserve[n].real_mods,
398 type->preserve[n].vmods));
401 if (type->level_names) {
402 for (n = 0; n < type->num_levels; n++) {
403 if (!type->level_names[n])
405 write_buf(buf, "\t\t\tlevel_name[Level%d]= \"%s\";\n", n + 1,
406 type->level_names[n]);
409 write_buf(buf, "\t\t};\n");
412 write_buf(buf, "\t};\n\n");
417 write_indicator_map(struct xkb_keymap *keymap, struct buf *buf, int num)
419 struct xkb_indicator_map *led = &keymap->indicators[num];
421 write_buf(buf, "\t\tindicator \"%s\" {\n",
422 keymap->indicator_names[num]);
424 if (led->which_groups) {
425 if (led->which_groups != XkbIM_UseEffective) {
426 write_buf(buf, "\t\t\twhichGroupState= %s;\n",
427 get_indicator_state_text(led->which_groups));
429 write_buf(buf, "\t\t\tgroups= 0x%02x;\n",
433 if (led->which_mods) {
434 if (led->which_mods != XkbIM_UseEffective) {
435 write_buf(buf, "\t\t\twhichModState= %s;\n",
436 get_indicator_state_text(led->which_mods));
438 write_buf(buf, "\t\t\tmodifiers= %s;\n",
439 get_mod_mask_text(keymap, led->mods.real_mods,
444 write_buf(buf, "\t\t\tcontrols= %s;\n",
445 get_control_mask_text(led->ctrls));
448 write_buf(buf, "\t\t};\n");
453 get_interp_match_text(uint8_t type)
457 switch (type & XkbSI_OpMask) {
459 sprintf(ret, "NoneOf");
462 case XkbSI_AnyOfOrNone:
463 sprintf(ret, "AnyOfOrNone");
467 sprintf(ret, "AnyOf");
471 sprintf(ret, "AllOf");
475 sprintf(ret, "Exactly");
479 sprintf(ret, "0x%x", type & XkbSI_OpMask);
487 write_action(struct xkb_keymap *keymap, struct buf *buf,
488 union xkb_action *action, const char *prefix, const char *suffix)
490 const char *type = NULL;
491 const char *args = NULL;
498 switch (action->any.type) {
502 case XkbSA_LatchMods:
508 if (action->mods.flags & XkbSA_UseModMapMods)
511 args = get_mod_mask_text(keymap, action->mods.real_mods,
513 write_buf(buf, "%s%s(modifiers=%s%s%s)%s",
515 (action->any.type != XkbSA_LockGroup &&
516 (action->mods.flags & XkbSA_ClearLocks)) ?
518 (action->any.type != XkbSA_LockGroup &&
519 (action->mods.flags & XkbSA_LatchToLock)) ?
527 case XkbSA_LatchGroup:
530 case XkbSA_LockGroup:
533 write_buf(buf, "%s%s(group=%s%d%s%s)%s",
535 (!(action->group.flags & XkbSA_GroupAbsolute) &&
536 action->group.group > 0) ? "+" : "",
537 (action->group.flags & XkbSA_GroupAbsolute) ?
538 action->group.group + 1 : action->group.group,
539 (action->any.type != XkbSA_LockGroup &&
540 (action->group.flags & XkbSA_ClearLocks)) ?
542 (action->any.type != XkbSA_LockGroup &&
543 (action->group.flags & XkbSA_LatchToLock)) ?
548 case XkbSA_Terminate:
549 write_buf(buf, "%sTerminate()%s", prefix,
554 write_buf(buf, "%sMovePtr(x=%s%d,y=%s%d%s)%s",
556 (!(action->ptr.flags & XkbSA_MoveAbsoluteX) &&
557 action->ptr.x >= 0) ? "+" : "",
559 (!(action->ptr.flags & XkbSA_MoveAbsoluteY) &&
560 action->ptr.y >= 0) ? "+" : "",
562 (action->ptr.flags & XkbSA_NoAcceleration) ? ",!accel" : "",
569 case XkbSA_LockPtrBtn:
572 switch (action->btn.flags &
573 (XkbSA_LockNoUnlock | XkbSA_LockNoLock)) {
574 case XkbSA_LockNoUnlock:
575 args = ",affect=lock";
578 case XkbSA_LockNoLock:
579 args = ",affect=unlock";
582 case XkbSA_LockNoLock | XkbSA_LockNoUnlock:
583 args = ",affect=neither";
587 args = ",affect=both";
594 write_buf(buf, "%s%s(button=", prefix, type);
595 if (action->btn.button > 0 && action->btn.button <= 5)
596 write_buf(buf, "%d", action->btn.button);
598 write_buf(buf, "default");
599 if (action->btn.count)
600 write_buf(buf, ",count=%d", action->btn.count);
602 write_buf(buf, "%s", args);
603 write_buf(buf, ")%s", suffix);
606 case XkbSA_SetPtrDflt:
607 write_buf(buf, "%sSetPtrDflt(", prefix);
608 if (action->dflt.affect == XkbSA_AffectDfltBtn)
609 write_buf(buf, "affect=button,button=%s%d",
610 (!(action->dflt.flags & XkbSA_DfltBtnAbsolute) &&
611 action->dflt.value >= 0) ? "+" : "",
613 write_buf(buf, ")%s", suffix);
616 case XkbSA_SwitchScreen:
617 write_buf(buf, "%sSwitchScreen(screen=%s%d,%ssame)%s", prefix,
618 (!(action->screen.flags & XkbSA_SwitchAbsolute) &&
619 action->screen.screen >= 0) ? "+" : "",
620 action->screen.screen,
621 (action->screen.flags & XkbSA_SwitchApplication) ? "!" : "",
625 /* Deprecated actions below here */
626 case XkbSA_SetControls:
628 type = "SetControls";
629 case XkbSA_LockControls:
631 type = "LockControls";
632 write_buf(buf, "%s%s(controls=%s)%s",
633 prefix, type, get_control_mask_text(action->ctrls.ctrls),
638 case XkbSA_ActionMessage:
639 case XkbSA_RedirectKey:
640 case XkbSA_DeviceBtn:
641 case XkbSA_LockDeviceBtn:
644 write_buf(buf, "%sNoAction()%s", prefix, suffix);
647 case XkbSA_XFree86Private:
650 "%sPrivate(type=0x%02x,data[0]=0x%02x,data[1]=0x%02x,data[2]=0x%02x,data[3]=0x%02x,data[4]=0x%02x,data[5]=0x%02x,data[6]=0x%02x)%s",
651 prefix, action->any.type, action->any.data[0],
652 action->any.data[1], action->any.data[2],
653 action->any.data[3], action->any.data[4],
654 action->any.data[5], action->any.data[6],
663 write_compat(struct xkb_keymap *keymap, struct buf *buf)
666 struct xkb_sym_interpret *interp;
668 if (keymap->compat_section_name)
669 write_buf(buf, "\txkb_compatibility \"%s\" {\n\n",
670 keymap->compat_section_name);
672 write_buf(buf, "\txkb_compatibility {\n\n");
674 write_vmods(keymap, buf);
676 write_buf(buf, "\t\tinterpret.useModMapMods= AnyLevel;\n");
677 write_buf(buf, "\t\tinterpret.repeat= False;\n");
678 write_buf(buf, "\t\tinterpret.locking= False;\n");
680 darray_foreach(interp, keymap->sym_interpret) {
681 char keysym_name[64];
683 if (interp->sym == XKB_KEY_NoSymbol)
684 sprintf(keysym_name, "Any");
686 xkb_keysym_get_name(interp->sym, keysym_name, sizeof(keysym_name));
688 write_buf(buf, "\t\tinterpret %s+%s(%s) {\n",
690 get_interp_match_text(interp->match),
691 get_mod_mask_text(keymap, interp->mods, 0));
693 if (interp->virtual_mod != XkbNoModifier) {
694 write_buf(buf, "\t\t\tvirtualModifier= %s;\n",
695 keymap->vmod_names[interp->virtual_mod]);
698 if (interp->match & XkbSI_LevelOneOnly)
700 "\t\t\tuseModMapMods=level1;\n");
701 if (interp->flags & XkbSI_LockingKey)
702 write_buf(buf, "\t\t\tlocking= True;\n");
703 if (interp->flags & XkbSI_AutoRepeat)
704 write_buf(buf, "\t\t\trepeat= True;\n");
706 write_action(keymap, buf, &interp->act, "\t\t\taction= ", ";\n");
707 write_buf(buf, "\t\t};\n");
710 for (i = 0; i < XkbNumKbdGroups; i++) {
713 gc = &keymap->groups[i];
714 if (gc->real_mods == 0 && gc->vmods == 0)
716 write_buf(buf, "\t\tgroup %d = %s;\n", i + 1,
717 get_mod_mask_text(keymap, gc->real_mods, gc->vmods));
720 for (i = 0; i < XkbNumIndicators; i++) {
721 struct xkb_indicator_map *map = &keymap->indicators[i];
722 if (map->flags == 0 && map->which_groups == 0 &&
723 map->groups == 0 && map->which_mods == 0 &&
724 map->mods.real_mods == 0 && map->mods.vmods == 0 &&
727 write_indicator_map(keymap, buf, i);
730 write_buf(buf, "\t};\n\n");
736 write_keysyms(struct xkb_keymap *keymap, struct buf *buf,
737 struct xkb_key *key, xkb_group_index_t group)
739 const xkb_keysym_t *syms;
741 #define OUT_BUF_LEN 128
742 char out_buf[OUT_BUF_LEN];
744 for (level = 0; level < XkbKeyGroupWidth(keymap, key, group); level++) {
746 write_buf(buf, ", ");
747 num_syms = xkb_key_get_syms_by_level(keymap, key, group, level,
750 write_buf(buf, "%15s", "NoSymbol");
752 else if (num_syms == 1) {
753 xkb_keysym_get_name(syms[0], out_buf, OUT_BUF_LEN);
754 write_buf(buf, "%15s", out_buf);
758 write_buf(buf, "{ ");
759 for (s = 0; s < num_syms; s++) {
761 write_buf(buf, ", ");
762 xkb_keysym_get_name(syms[s], out_buf, OUT_BUF_LEN);
763 write_buf(buf, "%15s", out_buf);
765 write_buf(buf, " }");
774 write_symbols(struct xkb_keymap *keymap, struct buf *buf)
777 xkb_group_index_t group, tmp;
780 if (keymap->symbols_section_name)
781 write_buf(buf, "\txkb_symbols \"%s\" {\n\n",
782 keymap->symbols_section_name);
784 write_buf(buf, "\txkb_symbols {\n\n");
786 for (tmp = group = 0; group < XkbNumKbdGroups; group++) {
787 if (!keymap->group_names[group])
790 "\t\tname[group%d]=\"%s\";\n", group + 1,
791 keymap->group_names[group]);
795 write_buf(buf, "\n");
797 xkb_foreach_key(key, keymap) {
800 if (key->num_groups == 0)
803 write_buf(buf, "\t\tkey %6s {", KeyNameText(key->name));
805 if (key->explicit & XkbExplicitKeyTypesMask) {
806 bool multi_type = false;
807 int type = XkbKeyTypeIndex(key, 0);
811 for (group = 0; group < key->num_groups; group++) {
812 if (XkbKeyTypeIndex(key, group) != type) {
819 for (group = 0; group < key->num_groups; group++) {
820 if (!(key->explicit & (1 << group)))
822 type = XkbKeyTypeIndex(key, group);
823 write_buf(buf, "\n\t\t\ttype[group%u]= \"%s\",",
825 darray_item(keymap->types, type).name);
829 write_buf(buf, "\n\t\t\ttype= \"%s\",",
830 darray_item(keymap->types, type).name);
834 if (key->explicit & XkbExplicitAutoRepeatMask) {
836 write_buf(buf, "\n\t\t\trepeat= Yes,");
838 write_buf(buf, "\n\t\t\trepeat= No,");
842 if (key->vmodmap && (key->explicit & XkbExplicitVModMapMask)) {
843 write_buf(buf, "\n\t\t\tvirtualMods= %s,",
844 get_mod_mask_text(keymap, 0, key->vmodmap));
847 switch (key->out_of_range_group_action) {
848 case XkbClampIntoRange:
849 write_buf(buf, "\n\t\t\tgroupsClamp,");
852 case XkbRedirectIntoRange:
853 write_buf(buf, "\n\t\t\tgroupsRedirect= Group%u,",
854 key->out_of_range_group_number + 1);
858 if (key->explicit & XkbExplicitInterpretMask)
859 showActions = XkbKeyHasActions(key);
863 if (key->num_groups > 1 || showActions)
867 write_buf(buf, "\t[ ");
868 if (!write_keysyms(keymap, buf, key, 0))
870 write_buf(buf, " ] };\n");
873 union xkb_action *acts;
876 acts = XkbKeyActionsPtr(keymap, key);
877 for (group = 0; group < key->num_groups; group++) {
880 write_buf(buf, "\n\t\t\tsymbols[Group%u]= [ ", group + 1);
881 if (!write_keysyms(keymap, buf, key, group))
883 write_buf(buf, " ]");
885 write_buf(buf, ",\n\t\t\tactions[Group%u]= [ ",
888 level < XkbKeyGroupWidth(keymap, key, group);
891 write_buf(buf, ", ");
892 write_action(keymap, buf, &acts[level], NULL, NULL);
894 write_buf(buf, " ]");
898 write_buf(buf, "\n\t\t};\n");
902 xkb_foreach_key(key, keymap) {
905 if (key->modmap == 0)
908 for (mod = 0; mod < XkbNumModifiers; mod++) {
909 if (!(key->modmap & (1 << mod)))
912 write_buf(buf, "\t\tmodifier_map %s { %s };\n",
913 get_mod_index_text(mod), KeyNameText(key->name));
917 write_buf(buf, "\t};\n\n");
922 xkb_map_get_as_string(struct xkb_keymap *keymap)
925 struct buf buf = { NULL, 0, 0 };
927 ok = (check_write_buf(&buf, "xkb_keymap {\n") &&
928 write_keycodes(keymap, &buf) &&
929 write_types(keymap, &buf) &&
930 write_compat(keymap, &buf) &&
931 write_symbols(keymap, &buf) &&
932 check_write_buf(&buf, "};\n"));
934 return (ok ? buf.buf : NULL);