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 ********************************************************/
27 #include "xkbcomp-priv.h"
34 TYPE_FIELD_MASK = (1 << 0),
35 TYPE_FIELD_MAP = (1 << 1),
36 TYPE_FIELD_PRESERVE = (1 << 2),
37 TYPE_FIELD_LEVEL_NAME = (1 << 3),
41 enum type_field defined;
42 enum merge_mode merge;
46 xkb_level_index_t num_levels;
47 darray(struct xkb_key_type_entry) entries;
48 darray(xkb_atom_t) level_names;
55 darray(KeyTypeInfo) types;
56 struct xkb_context *ctx;
57 struct xkb_keymap *keymap;
60 /***====================================================================***/
62 static inline const char *
63 MapEntryTxt(KeyTypesInfo *info, struct xkb_key_type_entry *entry)
65 return ModMaskText(info->ctx, &info->keymap->mods, entry->mods.mods);
68 static inline const char *
69 TypeTxt(KeyTypesInfo *info, KeyTypeInfo *type)
71 return xkb_atom_text(info->ctx, type->name);
74 static inline const char *
75 TypeMaskTxt(KeyTypesInfo *info, KeyTypeInfo *type)
77 return ModMaskText(info->ctx, &info->keymap->mods, type->mods);
81 ReportTypeShouldBeArray(KeyTypesInfo *info, KeyTypeInfo *type,
84 return ReportShouldBeArray(info->ctx, "key type", field,
89 ReportTypeBadType(KeyTypesInfo *info, KeyTypeInfo *type,
90 const char *field, const char *wanted)
92 return ReportBadType(info->ctx, "key type", field,
93 TypeTxt(info, type), wanted);
96 /***====================================================================***/
99 InitKeyTypesInfo(KeyTypesInfo *info, struct xkb_keymap *keymap)
101 memset(info, 0, sizeof(*info));
102 info->keymap = keymap;
103 info->ctx = keymap->ctx;
107 ClearKeyTypeInfo(KeyTypeInfo *type)
109 darray_free(type->entries);
110 darray_free(type->level_names);
114 ClearKeyTypesInfo(KeyTypesInfo *info)
117 darray_free(info->types);
121 FindMatchingKeyType(KeyTypesInfo *info, xkb_atom_t name)
125 darray_foreach(old, info->types)
126 if (old->name == name)
133 AddKeyType(KeyTypesInfo *info, KeyTypeInfo *new, bool same_file)
136 const int verbosity = xkb_context_get_log_verbosity(info->ctx);
138 old = FindMatchingKeyType(info, new->name);
140 if (new->merge == MERGE_REPLACE || new->merge == MERGE_OVERRIDE) {
141 if ((same_file && verbosity > 0) || verbosity > 9) {
143 "Multiple definitions of the %s key type; "
144 "Earlier definition ignored\n",
145 xkb_atom_text(info->ctx, new->name));
148 ClearKeyTypeInfo(old);
150 darray_init(new->entries);
151 darray_init(new->level_names);
156 log_vrb(info->ctx, 4,
157 "Multiple definitions of the %s key type; "
158 "Later definition ignored\n",
159 xkb_atom_text(info->ctx, new->name));
161 ClearKeyTypeInfo(new);
165 darray_append(info->types, *new);
169 /***====================================================================***/
172 MergeIncludedKeyTypes(KeyTypesInfo *into, KeyTypesInfo *from,
173 enum merge_mode merge)
177 if (from->errorCount > 0) {
178 into->errorCount += from->errorCount;
182 if (into->name == NULL) {
183 into->name = from->name;
187 if (darray_empty(into->types)) {
188 into->types = from->types;
189 darray_init(from->types);
192 darray_foreach(type, from->types) {
193 type->merge = (merge == MERGE_DEFAULT ? type->merge : merge);
194 if (!AddKeyType(into, type, false))
201 HandleKeyTypesFile(KeyTypesInfo *info, XkbFile *file, enum merge_mode merge);
204 HandleIncludeKeyTypes(KeyTypesInfo *info, IncludeStmt *include)
206 KeyTypesInfo included;
208 InitKeyTypesInfo(&included, info->keymap);
209 included.name = include->stmt;
210 include->stmt = NULL;
212 for (IncludeStmt *stmt = include; stmt; stmt = stmt->next_incl) {
213 KeyTypesInfo next_incl;
216 file = ProcessIncludeFile(info->ctx, stmt, FILE_TYPE_TYPES);
218 info->errorCount += 10;
219 ClearKeyTypesInfo(&included);
223 InitKeyTypesInfo(&next_incl, info->keymap);
225 HandleKeyTypesFile(&next_incl, file, stmt->merge);
227 MergeIncludedKeyTypes(&included, &next_incl, stmt->merge);
229 ClearKeyTypesInfo(&next_incl);
233 MergeIncludedKeyTypes(info, &included, include->merge);
234 ClearKeyTypesInfo(&included);
236 return (info->errorCount == 0);
239 /***====================================================================***/
242 SetModifiers(KeyTypesInfo *info, KeyTypeInfo *type, ExprDef *arrayNdx,
249 "The modifiers field of a key type is not an array; "
250 "Illegal array subscript ignored\n");
252 if (!ExprResolveModMask(info->ctx, value, MOD_BOTH, &info->keymap->mods,
255 "Key type mask field must be a modifier mask; "
256 "Key type definition ignored\n");
260 if (type->defined & TYPE_FIELD_MASK) {
262 "Multiple modifier mask definitions for key type %s; "
263 "Using %s, ignoring %s\n",
264 xkb_atom_text(info->ctx, type->name),
265 TypeMaskTxt(info, type),
266 ModMaskText(info->ctx, &info->keymap->mods, mods));
274 /***====================================================================***/
276 static struct xkb_key_type_entry *
277 FindMatchingMapEntry(KeyTypeInfo *type, xkb_mod_mask_t mods)
279 struct xkb_key_type_entry *entry;
281 darray_foreach(entry, type->entries)
282 if (entry->mods.mods == mods)
289 AddMapEntry(KeyTypesInfo *info, KeyTypeInfo *type,
290 struct xkb_key_type_entry *new, bool clobber, bool report)
292 struct xkb_key_type_entry *old;
294 old = FindMatchingMapEntry(type, new->mods.mods);
296 if (report && old->level != new->level) {
298 "Multiple map entries for %s in %s; "
299 "Using %d, ignoring %d\n",
300 MapEntryTxt(info, new), TypeTxt(info, type),
301 (clobber ? new->level : old->level) + 1,
302 (clobber ? old->level : new->level) + 1);
305 log_vrb(info->ctx, 10,
306 "Multiple occurrences of map[%s]= %d in %s; Ignored\n",
307 MapEntryTxt(info, new), new->level + 1,
308 TypeTxt(info, type));
313 if (new->level >= type->num_levels)
314 type->num_levels = new->level + 1;
315 old->level = new->level;
321 if (new->level >= type->num_levels)
322 type->num_levels = new->level + 1;
324 darray_append(type->entries, *new);
329 SetMapEntry(KeyTypesInfo *info, KeyTypeInfo *type, ExprDef *arrayNdx,
332 struct xkb_key_type_entry entry;
334 if (arrayNdx == NULL)
335 return ReportTypeShouldBeArray(info, type, "map entry");
337 if (!ExprResolveModMask(info->ctx, arrayNdx, MOD_BOTH,
338 &info->keymap->mods, &entry.mods.mods))
339 return ReportTypeBadType(info, type, "map entry", "modifier mask");
341 if (entry.mods.mods & (~type->mods)) {
342 log_vrb(info->ctx, 1,
343 "Map entry for unused modifiers in %s; "
344 "Using %s instead of %s\n",
346 ModMaskText(info->ctx, &info->keymap->mods,
347 entry.mods.mods & type->mods),
348 MapEntryTxt(info, &entry));
349 entry.mods.mods &= type->mods;
352 if (!ExprResolveLevel(info->ctx, value, &entry.level)) {
354 "Level specifications in a key type must be integer; "
355 "Ignoring malformed level specification\n");
359 entry.preserve.mods = 0;
361 return AddMapEntry(info, type, &entry, true, true);
364 /***====================================================================***/
367 AddPreserve(KeyTypesInfo *info, KeyTypeInfo *type,
368 xkb_mod_mask_t mods, xkb_mod_mask_t preserve_mods)
370 struct xkb_key_type_entry *entry;
371 struct xkb_key_type_entry new;
373 darray_foreach(entry, type->entries) {
374 if (entry->mods.mods != mods)
377 /* Map exists without previous preserve (or "None"); override. */
378 if (entry->preserve.mods == 0) {
379 entry->preserve.mods = preserve_mods;
383 /* Map exists with same preserve; do nothing. */
384 if (entry->preserve.mods == preserve_mods) {
385 log_vrb(info->ctx, 10,
386 "Identical definitions for preserve[%s] in %s; "
388 ModMaskText(info->ctx, &info->keymap->mods, mods),
389 TypeTxt(info, type));
393 /* Map exists with different preserve; latter wins. */
394 log_vrb(info->ctx, 1,
395 "Multiple definitions for preserve[%s] in %s; "
396 "Using %s, ignoring %s\n",
397 ModMaskText(info->ctx, &info->keymap->mods, mods),
399 ModMaskText(info->ctx, &info->keymap->mods, preserve_mods),
400 ModMaskText(info->ctx, &info->keymap->mods, entry->preserve.mods));
402 entry->preserve.mods = preserve_mods;
407 * Map does not exist, i.e. preserve[] came before map[].
408 * Create a map with the specified mask mapping to Level1. The level
409 * may be overridden later with an explicit map[] statement.
412 new.mods.mods = mods;
413 new.preserve.mods = preserve_mods;
414 darray_append(type->entries, new);
419 SetPreserve(KeyTypesInfo *info, KeyTypeInfo *type, ExprDef *arrayNdx,
422 xkb_mod_mask_t mods, preserve_mods;
424 if (arrayNdx == NULL)
425 return ReportTypeShouldBeArray(info, type, "preserve entry");
427 if (!ExprResolveModMask(info->ctx, arrayNdx, MOD_BOTH, &info->keymap->mods,
429 return ReportTypeBadType(info, type, "preserve entry",
432 if (mods & ~type->mods) {
433 const char *before, *after;
435 before = ModMaskText(info->ctx, &info->keymap->mods, mods);
437 after = ModMaskText(info->ctx, &info->keymap->mods, mods);
439 log_vrb(info->ctx, 1,
440 "Preserve for modifiers not used by the %s type; "
441 "Index %s converted to %s\n",
442 TypeTxt(info, type), before, after);
445 if (!ExprResolveModMask(info->ctx, value, MOD_BOTH, &info->keymap->mods,
448 "Preserve value in a key type is not a modifier mask; "
449 "Ignoring preserve[%s] in type %s\n",
450 ModMaskText(info->ctx, &info->keymap->mods, mods),
451 TypeTxt(info, type));
455 if (preserve_mods & ~mods) {
456 const char *before, *after;
458 before = ModMaskText(info->ctx, &info->keymap->mods, preserve_mods);
459 preserve_mods &= mods;
460 after = ModMaskText(info->ctx, &info->keymap->mods, preserve_mods);
462 log_vrb(info->ctx, 1,
463 "Illegal value for preserve[%s] in type %s; "
464 "Converted %s to %s\n",
465 ModMaskText(info->ctx, &info->keymap->mods, mods),
466 TypeTxt(info, type), before, after);
469 return AddPreserve(info, type, mods, preserve_mods);
472 /***====================================================================***/
475 AddLevelName(KeyTypesInfo *info, KeyTypeInfo *type,
476 xkb_level_index_t level, xkb_atom_t name, bool clobber)
479 if (level >= darray_size(type->level_names)) {
480 darray_resize0(type->level_names, level + 1);
484 /* Same level, same name. */
485 if (darray_item(type->level_names, level) == name) {
486 log_vrb(info->ctx, 10,
487 "Duplicate names for level %d of key type %s; Ignored\n",
488 level + 1, TypeTxt(info, type));
492 /* Same level, different name. */
493 if (darray_item(type->level_names, level) != XKB_ATOM_NONE) {
494 const char *old, *new;
495 old = xkb_atom_text(info->ctx,
496 darray_item(type->level_names, level));
497 new = xkb_atom_text(info->ctx, name);
498 log_vrb(info->ctx, 1,
499 "Multiple names for level %d of key type %s; "
500 "Using %s, ignoring %s\n",
501 level + 1, TypeTxt(info, type),
502 (clobber ? new : old), (clobber ? old : new));
508 /* XXX: What about different level, same name? */
511 darray_item(type->level_names, level) = name;
516 SetLevelName(KeyTypesInfo *info, KeyTypeInfo *type, ExprDef *arrayNdx,
519 xkb_level_index_t level;
520 xkb_atom_t level_name;
522 if (arrayNdx == NULL)
523 return ReportTypeShouldBeArray(info, type, "level name");
525 if (!ExprResolveLevel(info->ctx, arrayNdx, &level))
526 return ReportTypeBadType(info, type, "level name", "integer");
528 if (!ExprResolveString(info->ctx, value, &level_name)) {
530 "Non-string name for level %d in key type %s; "
531 "Ignoring illegal level name definition\n",
532 level + 1, xkb_atom_text(info->ctx, type->name));
536 return AddLevelName(info, type, level, level_name, true);
539 /***====================================================================***/
542 SetKeyTypeField(KeyTypesInfo *info, KeyTypeInfo *type,
543 const char *field, ExprDef *arrayNdx, ExprDef *value)
546 enum type_field type_field = 0;
548 if (istreq(field, "modifiers")) {
549 type_field = TYPE_FIELD_MASK;
550 ok = SetModifiers(info, type, arrayNdx, value);
552 else if (istreq(field, "map")) {
553 type_field = TYPE_FIELD_MAP;
554 ok = SetMapEntry(info, type, arrayNdx, value);
556 else if (istreq(field, "preserve")) {
557 type_field = TYPE_FIELD_PRESERVE;
558 ok = SetPreserve(info, type, arrayNdx, value);
560 else if (istreq(field, "levelname") || istreq(field, "level_name")) {
561 type_field = TYPE_FIELD_LEVEL_NAME;
562 ok = SetLevelName(info, type, arrayNdx, value);
565 "Unknown field %s in key type %s; Definition ignored\n",
566 field, TypeTxt(info, type));
569 type->defined |= type_field;
574 HandleKeyTypeBody(KeyTypesInfo *info, VarDef *def, KeyTypeInfo *type)
577 const char *elem, *field;
580 for (; def; def = (VarDef *) def->common.next) {
581 ok = ExprResolveLhs(info->ctx, def->name, &elem, &field,
586 if (elem && istreq(elem, "type")) {
588 "Support for changing the default type has been removed; "
589 "Statement ignored\n");
593 ok = SetKeyTypeField(info, type, field, arrayNdx, def->value);
600 HandleKeyTypeDef(KeyTypesInfo *info, KeyTypeDef *def, enum merge_mode merge)
604 .merge = (def->merge == MERGE_DEFAULT ? merge : def->merge),
608 .entries = darray_new(),
609 .level_names = darray_new(),
612 if (!HandleKeyTypeBody(info, def->body, &type)) {
617 if (!AddKeyType(info, &type, true)) {
626 HandleKeyTypesFile(KeyTypesInfo *info, XkbFile *file, enum merge_mode merge)
631 info->name = strdup_safe(file->name);
633 for (ParseCommon *stmt = file->defs; stmt; stmt = stmt->next) {
634 switch (stmt->type) {
636 ok = HandleIncludeKeyTypes(info, (IncludeStmt *) stmt);
639 ok = HandleKeyTypeDef(info, (KeyTypeDef *) stmt, merge);
643 "Support for changing the default type has been removed; "
644 "Statement ignored\n");
648 ok = HandleVModDef(info->keymap, (VModDef *) stmt, merge);
652 "Key type files may not include other declarations; "
653 "Ignoring %s\n", stmt_type_to_string(stmt->type));
661 if (info->errorCount > 10) {
663 "Abandoning keytypes file \"%s\"\n", file->topName);
669 /***====================================================================***/
672 CopyKeyTypesToKeymap(struct xkb_keymap *keymap, KeyTypesInfo *info)
674 keymap->types_section_name = strdup_safe(info->name);
675 XkbEscapeMapName(keymap->types_section_name);
677 keymap->num_types = darray_size(info->types);
678 if (keymap->num_types == 0)
679 keymap->num_types = 1;
681 keymap->types = calloc(keymap->num_types, sizeof(*keymap->types));
684 * If no types were specified, a default unnamed one-level type is
687 if (darray_empty(info->types)) {
688 struct xkb_key_type *type = &keymap->types[0];
691 type->num_levels = 1;
692 type->entries = NULL;
693 type->num_entries = 0;
694 type->name = xkb_atom_intern_literal(keymap->ctx, "default");
695 type->level_names = NULL;
700 for (unsigned i = 0; i < keymap->num_types; i++) {
701 KeyTypeInfo *def = &darray_item(info->types, i);
702 struct xkb_key_type *type = &keymap->types[i];
704 type->mods.mods = def->mods;
705 type->num_levels = def->num_levels;
706 type->entries = darray_mem(def->entries, 0);
707 type->num_entries = darray_size(def->entries);
708 darray_init(def->entries);
709 type->name = def->name;
710 type->level_names = darray_mem(def->level_names, 0);
711 darray_init(def->level_names);
717 /***====================================================================***/
720 CompileKeyTypes(XkbFile *file, struct xkb_keymap *keymap,
721 enum merge_mode merge)
725 InitKeyTypesInfo(&info, keymap);
727 HandleKeyTypesFile(&info, file, merge);
728 if (info.errorCount != 0)
731 if (!CopyKeyTypesToKeymap(keymap, &info))
734 ClearKeyTypesInfo(&info);
738 ClearKeyTypesInfo(&info);