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 Ran Benita <ran234@gmail.com>
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.
50 #include "xkbcomp-priv.h"
58 SI_FIELD_VIRTUAL_MOD = (1 << 0),
59 SI_FIELD_ACTION = (1 << 1),
60 SI_FIELD_AUTO_REPEAT = (1 << 2),
61 SI_FIELD_LEVEL_ONE_ONLY = (1 << 3),
65 enum si_field defined;
66 enum merge_mode merge;
68 struct xkb_sym_interpret interp;
72 LED_FIELD_MODS = (1 << 0),
73 LED_FIELD_GROUPS = (1 << 1),
74 LED_FIELD_CTRLS = (1 << 2),
78 enum led_field defined;
79 enum merge_mode merge;
87 SymInterpInfo default_interp;
88 darray(SymInterpInfo) interps;
92 struct xkb_mod_set mods;
94 struct xkb_context *ctx;
98 siText(SymInterpInfo *si, CompatInfo *info)
100 char *buf = xkb_context_get_buffer(info->ctx, 128);
102 if (si == &info->default_interp)
105 snprintf(buf, 128, "%s+%s(%s)",
106 KeysymText(info->ctx, si->interp.sym),
107 SIMatchText(si->interp.match),
108 ModMaskText(info->ctx, &info->mods, si->interp.mods));
114 ReportSINotArray(CompatInfo *info, SymInterpInfo *si, const char *field)
116 return ReportNotArray(info->ctx, "symbol interpretation", field,
121 ReportSIBadType(CompatInfo *info, SymInterpInfo *si, const char *field,
124 return ReportBadType(info->ctx, "symbol interpretation", field,
125 siText(si, info), wanted);
129 ReportLedBadType(CompatInfo *info, LedInfo *ledi, const char *field,
132 return ReportBadType(info->ctx, "indicator map", field,
133 xkb_atom_text(info->ctx, ledi->led.name),
138 ReportLedNotArray(CompatInfo *info, LedInfo *ledi, const char *field)
140 return ReportNotArray(info->ctx, "indicator map", field,
141 xkb_atom_text(info->ctx, ledi->led.name));
145 InitCompatInfo(CompatInfo *info, struct xkb_context *ctx,
146 ActionsInfo *actions, const struct xkb_mod_set *mods)
148 memset(info, 0, sizeof(*info));
150 info->actions = actions;
151 CopyModSet(&info->mods, mods);
152 info->default_interp.merge = MERGE_OVERRIDE;
153 info->default_interp.interp.virtual_mod = XKB_MOD_INVALID;
154 info->default_led.merge = MERGE_OVERRIDE;
158 ClearCompatInfo(CompatInfo *info)
161 ClearModSet(&info->mods);
162 darray_free(info->interps);
163 darray_free(info->leds);
166 static SymInterpInfo *
167 FindMatchingInterp(CompatInfo *info, SymInterpInfo *new)
171 darray_foreach(old, info->interps)
172 if (old->interp.sym == new->interp.sym &&
173 old->interp.mods == new->interp.mods &&
174 old->interp.match == new->interp.match)
181 UseNewInterpField(enum si_field field, SymInterpInfo *old, SymInterpInfo *new,
182 bool report, enum si_field *collide)
184 if (!(old->defined & field))
187 if (new->defined & field) {
191 if (new->merge != MERGE_AUGMENT)
199 AddInterp(CompatInfo *info, SymInterpInfo *new, bool same_file)
201 SymInterpInfo *old = FindMatchingInterp(info, new);
203 const int verbosity = xkb_context_get_log_verbosity(info->ctx);
204 const bool report = (same_file && verbosity > 0) || verbosity > 9;
205 enum si_field collide = 0;
207 if (new->merge == MERGE_REPLACE) {
210 "Multiple definitions for \"%s\"; "
211 "Earlier interpretation ignored\n",
217 if (UseNewInterpField(SI_FIELD_VIRTUAL_MOD, old, new, report,
219 old->interp.virtual_mod = new->interp.virtual_mod;
220 old->defined |= SI_FIELD_VIRTUAL_MOD;
222 if (UseNewInterpField(SI_FIELD_ACTION, old, new, report,
224 old->interp.action = new->interp.action;
225 old->defined |= SI_FIELD_ACTION;
227 if (UseNewInterpField(SI_FIELD_AUTO_REPEAT, old, new, report,
229 old->interp.repeat = new->interp.repeat;
230 old->defined |= SI_FIELD_AUTO_REPEAT;
232 if (UseNewInterpField(SI_FIELD_LEVEL_ONE_ONLY, old, new, report,
234 old->interp.level_one_only = new->interp.level_one_only;
235 old->defined |= SI_FIELD_LEVEL_ONE_ONLY;
240 "Multiple interpretations of \"%s\"; "
241 "Using %s definition for duplicate fields\n",
243 (new->merge != MERGE_AUGMENT ? "last" : "first"));
249 darray_append(info->interps, *new);
253 /***====================================================================***/
256 ResolveStateAndPredicate(ExprDef *expr, enum xkb_match_operation *pred_rtrn,
257 xkb_mod_mask_t *mods_rtrn, CompatInfo *info)
260 *pred_rtrn = MATCH_ANY_OR_NONE;
261 *mods_rtrn = MOD_REAL_MASK_ALL;
265 *pred_rtrn = MATCH_EXACTLY;
266 if (expr->expr.op == EXPR_ACTION_DECL) {
267 const char *pred_txt = xkb_atom_text(info->ctx, expr->action.name);
268 if (!LookupString(symInterpretMatchMaskNames, pred_txt, pred_rtrn)) {
270 "Illegal modifier predicate \"%s\"; Ignored\n", pred_txt);
273 expr = expr->action.args;
275 else if (expr->expr.op == EXPR_IDENT) {
276 const char *pred_txt = xkb_atom_text(info->ctx, expr->ident.ident);
277 if (pred_txt && istreq(pred_txt, "any")) {
278 *pred_rtrn = MATCH_ANY;
279 *mods_rtrn = MOD_REAL_MASK_ALL;
284 return ExprResolveModMask(info->ctx, expr, MOD_REAL, &info->mods,
288 /***====================================================================***/
291 UseNewLEDField(enum led_field field, LedInfo *old, LedInfo *new,
292 bool report, enum led_field *collide)
294 if (!(old->defined & field))
297 if (new->defined & field) {
301 if (new->merge != MERGE_AUGMENT)
309 AddLedMap(CompatInfo *info, LedInfo *new, bool same_file)
312 enum led_field collide;
313 const int verbosity = xkb_context_get_log_verbosity(info->ctx);
314 const bool report = (same_file && verbosity > 0) || verbosity > 9;
316 darray_foreach(old, info->leds) {
317 if (old->led.name != new->led.name)
320 if (old->led.mods.mods == new->led.mods.mods &&
321 old->led.groups == new->led.groups &&
322 old->led.ctrls == new->led.ctrls &&
323 old->led.which_mods == new->led.which_mods &&
324 old->led.which_groups == new->led.which_groups) {
325 old->defined |= new->defined;
329 if (new->merge == MERGE_REPLACE) {
332 "Map for indicator %s redefined; "
333 "Earlier definition ignored\n",
334 xkb_atom_text(info->ctx, old->led.name));
340 if (UseNewLEDField(LED_FIELD_MODS, old, new, report, &collide)) {
341 old->led.which_mods = new->led.which_mods;
342 old->led.mods = new->led.mods;
343 old->defined |= LED_FIELD_MODS;
345 if (UseNewLEDField(LED_FIELD_GROUPS, old, new, report, &collide)) {
346 old->led.which_groups = new->led.which_groups;
347 old->led.groups = new->led.groups;
348 old->defined |= LED_FIELD_GROUPS;
350 if (UseNewLEDField(LED_FIELD_CTRLS, old, new, report, &collide)) {
351 old->led.ctrls = new->led.ctrls;
352 old->defined |= LED_FIELD_CTRLS;
357 "Map for indicator %s redefined; "
358 "Using %s definition for duplicate fields\n",
359 xkb_atom_text(info->ctx, old->led.name),
360 (new->merge == MERGE_AUGMENT ? "first" : "last"));
366 darray_append(info->leds, *new);
371 MergeIncludedCompatMaps(CompatInfo *into, CompatInfo *from,
372 enum merge_mode merge)
377 if (from->errorCount > 0) {
378 into->errorCount += from->errorCount;
382 MoveModSet(&into->mods, &from->mods);
384 if (into->name == NULL) {
385 into->name = from->name;
389 if (darray_empty(into->interps)) {
390 into->interps = from->interps;
391 darray_init(from->interps);
394 darray_foreach(si, from->interps) {
395 si->merge = (merge == MERGE_DEFAULT ? si->merge : merge);
396 if (!AddInterp(into, si, false))
401 if (darray_empty(into->leds)) {
402 into->leds = from->leds;
403 darray_init(from->leds);
406 darray_foreach(ledi, from->leds) {
407 ledi->merge = (merge == MERGE_DEFAULT ? ledi->merge : merge);
408 if (!AddLedMap(into, ledi, false))
415 HandleCompatMapFile(CompatInfo *info, XkbFile *file, enum merge_mode merge);
418 HandleIncludeCompatMap(CompatInfo *info, IncludeStmt *include)
422 InitCompatInfo(&included, info->ctx, info->actions, &info->mods);
423 included.name = include->stmt;
424 include->stmt = NULL;
426 for (IncludeStmt *stmt = include; stmt; stmt = stmt->next_incl) {
427 CompatInfo next_incl;
430 file = ProcessIncludeFile(info->ctx, stmt, FILE_TYPE_COMPAT);
432 info->errorCount += 10;
433 ClearCompatInfo(&included);
437 InitCompatInfo(&next_incl, info->ctx, info->actions, &included.mods);
438 next_incl.default_interp = info->default_interp;
439 next_incl.default_interp.merge = stmt->merge;
440 next_incl.default_led = info->default_led;
441 next_incl.default_led.merge = stmt->merge;
443 HandleCompatMapFile(&next_incl, file, MERGE_OVERRIDE);
445 MergeIncludedCompatMaps(&included, &next_incl, stmt->merge);
447 ClearCompatInfo(&next_incl);
451 MergeIncludedCompatMaps(info, &included, include->merge);
452 ClearCompatInfo(&included);
454 return (info->errorCount == 0);
458 SetInterpField(CompatInfo *info, SymInterpInfo *si, const char *field,
459 ExprDef *arrayNdx, ExprDef *value)
463 if (istreq(field, "action")) {
465 return ReportSINotArray(info, si, field);
467 if (!HandleActionDef(info->ctx, info->actions, &info->mods,
468 value, &si->interp.action))
471 si->defined |= SI_FIELD_ACTION;
473 else if (istreq(field, "virtualmodifier") ||
474 istreq(field, "virtualmod")) {
476 return ReportSINotArray(info, si, field);
478 if (!ExprResolveMod(info->ctx, value, MOD_VIRT, &info->mods, &ndx))
479 return ReportSIBadType(info, si, field, "virtual modifier");
481 si->interp.virtual_mod = ndx;
482 si->defined |= SI_FIELD_VIRTUAL_MOD;
484 else if (istreq(field, "repeat")) {
488 return ReportSINotArray(info, si, field);
490 if (!ExprResolveBoolean(info->ctx, value, &set))
491 return ReportSIBadType(info, si, field, "boolean");
493 si->interp.repeat = set;
495 si->defined |= SI_FIELD_AUTO_REPEAT;
497 else if (istreq(field, "locking")) {
499 "The \"locking\" field in symbol interpretation is unsupported; "
502 else if (istreq(field, "usemodmap") ||
503 istreq(field, "usemodmapmods")) {
507 return ReportSINotArray(info, si, field);
509 if (!ExprResolveEnum(info->ctx, value, &val, useModMapValueNames))
510 return ReportSIBadType(info, si, field, "level specification");
512 si->interp.level_one_only = !!val;
513 si->defined |= SI_FIELD_LEVEL_ONE_ONLY;
516 return ReportBadField(info->ctx, "symbol interpretation", field,
524 SetLedMapField(CompatInfo *info, LedInfo *ledi, const char *field,
525 ExprDef *arrayNdx, ExprDef *value)
529 if (istreq(field, "modifiers") || istreq(field, "mods")) {
531 return ReportLedNotArray(info, ledi, field);
533 if (!ExprResolveModMask(info->ctx, value, MOD_BOTH,
534 &info->mods, &ledi->led.mods.mods))
535 return ReportLedBadType(info, ledi, field, "modifier mask");
537 ledi->defined |= LED_FIELD_MODS;
539 else if (istreq(field, "groups")) {
543 return ReportLedNotArray(info, ledi, field);
545 if (!ExprResolveMask(info->ctx, value, &mask, groupMaskNames))
546 return ReportLedBadType(info, ledi, field, "group mask");
548 ledi->led.groups = mask;
549 ledi->defined |= LED_FIELD_GROUPS;
551 else if (istreq(field, "controls") || istreq(field, "ctrls")) {
555 return ReportLedNotArray(info, ledi, field);
557 if (!ExprResolveMask(info->ctx, value, &mask, ctrlMaskNames))
558 return ReportLedBadType(info, ledi, field, "controls mask");
560 ledi->led.ctrls = mask;
561 ledi->defined |= LED_FIELD_CTRLS;
563 else if (istreq(field, "allowexplicit")) {
565 "The \"allowExplicit\" field in indicator statements is unsupported; "
568 else if (istreq(field, "whichmodstate") ||
569 istreq(field, "whichmodifierstate")) {
573 return ReportLedNotArray(info, ledi, field);
575 if (!ExprResolveMask(info->ctx, value, &mask,
576 modComponentMaskNames))
577 return ReportLedBadType(info, ledi, field,
578 "mask of modifier state components");
580 ledi->led.which_mods = mask;
582 else if (istreq(field, "whichgroupstate")) {
586 return ReportLedNotArray(info, ledi, field);
588 if (!ExprResolveMask(info->ctx, value, &mask,
589 groupComponentMaskNames))
590 return ReportLedBadType(info, ledi, field,
591 "mask of group state components");
593 ledi->led.which_groups = mask;
595 else if (istreq(field, "driveskbd") ||
596 istreq(field, "driveskeyboard") ||
597 istreq(field, "leddriveskbd") ||
598 istreq(field, "leddriveskeyboard") ||
599 istreq(field, "indicatordriveskbd") ||
600 istreq(field, "indicatordriveskeyboard")) {
602 "The \"%s\" field in indicator statements is unsupported; "
605 else if (istreq(field, "index")) {
606 /* Users should see this, it might cause unexpected behavior. */
608 "The \"index\" field in indicator statements is unsupported; "
613 "Unknown field %s in map for %s indicator; "
614 "Definition ignored\n",
615 field, xkb_atom_text(info->ctx, ledi->led.name));
623 HandleGlobalVar(CompatInfo *info, VarDef *stmt)
625 const char *elem, *field;
629 if (!ExprResolveLhs(info->ctx, stmt->name, &elem, &field, &ndx))
631 else if (elem && istreq(elem, "interpret"))
632 ret = SetInterpField(info, &info->default_interp, field, ndx,
634 else if (elem && istreq(elem, "indicator"))
635 ret = SetLedMapField(info, &info->default_led, field, ndx,
638 ret = SetActionField(info->ctx, info->actions, &info->mods,
639 elem, field, ndx, stmt->value);
644 HandleInterpBody(CompatInfo *info, VarDef *def, SymInterpInfo *si)
647 const char *elem, *field;
650 for (; def; def = (VarDef *) def->common.next) {
651 if (def->name && def->name->expr.op == EXPR_FIELD_REF) {
653 "Cannot set a global default value from within an interpret statement; "
654 "Move statements to the global file scope\n");
659 ok = ExprResolveLhs(info->ctx, def->name, &elem, &field, &arrayNdx);
663 ok = SetInterpField(info, si, field, arrayNdx, def->value);
670 HandleInterpDef(CompatInfo *info, InterpDef *def, enum merge_mode merge)
672 enum xkb_match_operation pred;
676 if (!ResolveStateAndPredicate(def->match, &pred, &mods, info)) {
678 "Couldn't determine matching modifiers; "
679 "Symbol interpretation ignored\n");
683 si = info->default_interp;
684 si.merge = merge = (def->merge == MERGE_DEFAULT ? merge : def->merge);
685 si.interp.sym = def->sym;
686 si.interp.match = pred;
687 si.interp.mods = mods;
689 if (!HandleInterpBody(info, def->def, &si)) {
694 if (!AddInterp(info, &si, true)) {
703 HandleLedMapDef(CompatInfo *info, LedMapDef *def, enum merge_mode merge)
709 if (def->merge != MERGE_DEFAULT)
712 ledi = info->default_led;
714 ledi.led.name = def->name;
717 for (var = def->body; var != NULL; var = (VarDef *) var->common.next) {
718 const char *elem, *field;
720 if (!ExprResolveLhs(info->ctx, var->name, &elem, &field, &arrayNdx)) {
727 "Cannot set defaults for \"%s\" element in indicator map; "
728 "Assignment to %s.%s ignored\n", elem, elem, field);
732 ok = SetLedMapField(info, &ledi, field, arrayNdx, var->value) && ok;
737 return AddLedMap(info, &ledi, true);
743 HandleCompatMapFile(CompatInfo *info, XkbFile *file, enum merge_mode merge)
747 merge = (merge == MERGE_DEFAULT ? MERGE_AUGMENT : merge);
750 info->name = strdup_safe(file->name);
752 for (ParseCommon *stmt = file->defs; stmt; stmt = stmt->next) {
753 switch (stmt->type) {
755 ok = HandleIncludeCompatMap(info, (IncludeStmt *) stmt);
758 ok = HandleInterpDef(info, (InterpDef *) stmt, merge);
760 case STMT_GROUP_COMPAT:
762 "The \"group\" statement in compat is unsupported; "
767 ok = HandleLedMapDef(info, (LedMapDef *) stmt, merge);
770 ok = HandleGlobalVar(info, (VarDef *) stmt);
773 ok = HandleVModDef(info->ctx, &info->mods, (VModDef *) stmt, merge);
777 "Compat files may not include other types; "
778 "Ignoring %s\n", stmt_type_to_string(stmt->type));
786 if (info->errorCount > 10) {
788 "Abandoning compatibility map \"%s\"\n", file->topName);
794 /* Temporary struct for CopyInterps. */
796 darray(struct xkb_sym_interpret) sym_interprets;
800 CopyInterps(CompatInfo *info, bool needSymbol, enum xkb_match_operation pred,
801 struct collect *collect)
805 darray_foreach(si, info->interps)
806 if (si->interp.match == pred &&
807 (si->interp.sym != XKB_KEY_NoSymbol) == needSymbol)
808 darray_append(collect->sym_interprets, si->interp);
812 CopyLedMapDefsToKeymap(struct xkb_keymap *keymap, CompatInfo *info)
818 darray_foreach(ledi, info->leds) {
820 * Find the LED with the given name, if it was already declared
823 darray_enumerate(i, led, keymap->leds)
824 if (led->name == ledi->led.name)
827 /* Not previously declared; create it with next free index. */
828 if (i >= darray_size(keymap->leds)) {
830 "Indicator name \"%s\" was not declared in the keycodes section; "
831 "Adding new indicator\n",
832 xkb_atom_text(keymap->ctx, ledi->led.name));
834 darray_enumerate(i, led, keymap->leds)
835 if (led->name == XKB_ATOM_NONE)
838 if (i >= darray_size(keymap->leds)) {
839 /* Not place to put it; ignore. */
840 if (i >= XKB_MAX_LEDS) {
842 "Too many indicators (maximum is %d); "
843 "Indicator name \"%s\" ignored\n",
845 xkb_atom_text(keymap->ctx, ledi->led.name));
849 darray_resize(keymap->leds, i + 1);
850 led = &darray_item(keymap->leds, i);
855 if (led->groups != 0 && led->which_groups == 0)
856 led->which_groups = XKB_STATE_LAYOUT_EFFECTIVE;
857 if (led->mods.mods != 0 && led->which_mods == 0)
858 led->which_mods = XKB_STATE_MODS_EFFECTIVE;
863 CopyCompatToKeymap(struct xkb_keymap *keymap, CompatInfo *info)
865 keymap->compat_section_name = strdup_safe(info->name);
866 XkbEscapeMapName(keymap->compat_section_name);
868 MoveModSet(&keymap->mods, &info->mods);
870 if (!darray_empty(info->interps)) {
871 struct collect collect;
872 darray_init(collect.sym_interprets);
874 /* Most specific to least specific. */
875 CopyInterps(info, true, MATCH_EXACTLY, &collect);
876 CopyInterps(info, true, MATCH_ALL, &collect);
877 CopyInterps(info, true, MATCH_NONE, &collect);
878 CopyInterps(info, true, MATCH_ANY, &collect);
879 CopyInterps(info, true, MATCH_ANY_OR_NONE, &collect);
880 CopyInterps(info, false, MATCH_EXACTLY, &collect);
881 CopyInterps(info, false, MATCH_ALL, &collect);
882 CopyInterps(info, false, MATCH_NONE, &collect);
883 CopyInterps(info, false, MATCH_ANY, &collect);
884 CopyInterps(info, false, MATCH_ANY_OR_NONE, &collect);
886 keymap->num_sym_interprets = darray_size(collect.sym_interprets);
887 keymap->sym_interprets = darray_mem(collect.sym_interprets, 0);
890 CopyLedMapDefsToKeymap(keymap, info);
896 CompileCompatMap(XkbFile *file, struct xkb_keymap *keymap,
897 enum merge_mode merge)
900 ActionsInfo *actions;
902 actions = NewActionsInfo();
906 InitCompatInfo(&info, keymap->ctx, actions, &keymap->mods);
907 info.default_interp.merge = merge;
908 info.default_led.merge = merge;
910 HandleCompatMapFile(&info, file, merge);
911 if (info.errorCount != 0)
914 if (!CopyCompatToKeymap(keymap, &info))
917 ClearCompatInfo(&info);
918 FreeActionsInfo(actions);
922 ClearCompatInfo(&info);
923 FreeActionsInfo(actions);