expr.h 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329
  1. /*
  2. * Copyright (C) 2002 Roman Zippel <zippel@linux-m68k.org>
  3. * Released under the terms of the GNU GPL v2.0.
  4. */
  5. #ifndef EXPR_H
  6. #define EXPR_H
  7. #ifdef __cplusplus
  8. extern "C" {
  9. #endif
  10. #include <assert.h>
  11. #include <stdio.h>
  12. #include "list.h"
  13. #ifndef __cplusplus
  14. #include <stdbool.h>
  15. #endif
  16. struct file {
  17. struct file *next;
  18. struct file *parent;
  19. const char *name;
  20. int lineno;
  21. };
  22. typedef enum tristate {
  23. no, mod, yes
  24. } tristate;
  25. enum expr_type {
  26. E_NONE, E_OR, E_AND, E_NOT,
  27. E_EQUAL, E_UNEQUAL, E_LTH, E_LEQ, E_GTH, E_GEQ,
  28. E_LIST, E_SYMBOL, E_RANGE
  29. };
  30. union expr_data {
  31. struct expr *expr;
  32. struct symbol *sym;
  33. };
  34. struct expr {
  35. enum expr_type type;
  36. union expr_data left, right;
  37. };
  38. #define EXPR_OR(dep1, dep2) (((dep1)>(dep2))?(dep1):(dep2))
  39. #define EXPR_AND(dep1, dep2) (((dep1)<(dep2))?(dep1):(dep2))
  40. #define EXPR_NOT(dep) (2-(dep))
  41. #define expr_list_for_each_sym(l, e, s) \
  42. for (e = (l); e && (s = e->right.sym); e = e->left.expr)
  43. struct expr_value {
  44. struct expr *expr;
  45. tristate tri;
  46. };
  47. struct symbol_value {
  48. void *val;
  49. tristate tri;
  50. };
  51. enum symbol_type {
  52. S_UNKNOWN, S_BOOLEAN, S_TRISTATE, S_INT, S_HEX, S_STRING, S_OTHER
  53. };
  54. /* enum values are used as index to symbol.def[] */
  55. enum {
  56. S_DEF_USER, /* main user value */
  57. S_DEF_AUTO, /* values read from auto.conf */
  58. S_DEF_DEF3, /* Reserved for UI usage */
  59. S_DEF_DEF4, /* Reserved for UI usage */
  60. S_DEF_COUNT
  61. };
  62. /*
  63. * Represents a configuration symbol.
  64. *
  65. * Choices are represented as a special kind of symbol and have the
  66. * SYMBOL_CHOICE bit set in 'flags'.
  67. */
  68. struct symbol {
  69. /* The next symbol in the same bucket in the symbol hash table */
  70. struct symbol *next;
  71. /* The name of the symbol, e.g. "FOO" for 'config FOO' */
  72. char *name;
  73. /* S_BOOLEAN, S_TRISTATE, ... */
  74. enum symbol_type type;
  75. /*
  76. * The calculated value of the symbol. The SYMBOL_VALID bit is set in
  77. * 'flags' when this is up to date. Note that this value might differ
  78. * from the user value set in e.g. a .config file, due to visibility.
  79. */
  80. struct symbol_value curr;
  81. /*
  82. * Values for the symbol provided from outside. def[S_DEF_USER] holds
  83. * the .config value.
  84. */
  85. struct symbol_value def[S_DEF_COUNT];
  86. /*
  87. * An upper bound on the tristate value the user can set for the symbol
  88. * if it is a boolean or tristate. Calculated from prompt dependencies,
  89. * which also inherit dependencies from enclosing menus, choices, and
  90. * ifs. If 'n', the user value will be ignored.
  91. *
  92. * Symbols lacking prompts always have visibility 'n'.
  93. */
  94. tristate visible;
  95. /* SYMBOL_* flags */
  96. int flags;
  97. /* List of properties. See prop_type. */
  98. struct property *prop;
  99. /* Dependencies from enclosing menus, choices, and ifs */
  100. struct expr_value dir_dep;
  101. /* Reverse dependencies through being selected by other symbols */
  102. struct expr_value rev_dep;
  103. /*
  104. * "Weak" reverse dependencies through being implied by other symbols
  105. */
  106. struct expr_value implied;
  107. };
  108. #define for_all_symbols(i, sym) for (i = 0; i < SYMBOL_HASHSIZE; i++) for (sym = symbol_hash[i]; sym; sym = sym->next) if (sym->type != S_OTHER)
  109. #define SYMBOL_CONST 0x0001 /* symbol is const */
  110. #define SYMBOL_CHECK 0x0008 /* used during dependency checking */
  111. #define SYMBOL_CHOICE 0x0010 /* start of a choice block (null name) */
  112. #define SYMBOL_CHOICEVAL 0x0020 /* used as a value in a choice block */
  113. #define SYMBOL_VALID 0x0080 /* set when symbol.curr is calculated */
  114. #define SYMBOL_OPTIONAL 0x0100 /* choice is optional - values can be 'n' */
  115. #define SYMBOL_WRITE 0x0200 /* write symbol to file (KCONFIG_CONFIG) */
  116. #define SYMBOL_CHANGED 0x0400 /* ? */
  117. #define SYMBOL_AUTO 0x1000 /* value from environment variable */
  118. #define SYMBOL_CHECKED 0x2000 /* used during dependency checking */
  119. #define SYMBOL_WARNED 0x8000 /* warning has been issued */
  120. /* Set when symbol.def[] is used */
  121. #define SYMBOL_DEF 0x10000 /* First bit of SYMBOL_DEF */
  122. #define SYMBOL_DEF_USER 0x10000 /* symbol.def[S_DEF_USER] is valid */
  123. #define SYMBOL_DEF_AUTO 0x20000 /* symbol.def[S_DEF_AUTO] is valid */
  124. #define SYMBOL_DEF3 0x40000 /* symbol.def[S_DEF_3] is valid */
  125. #define SYMBOL_DEF4 0x80000 /* symbol.def[S_DEF_4] is valid */
  126. /* choice values need to be set before calculating this symbol value */
  127. #define SYMBOL_NEED_SET_CHOICE_VALUES 0x100000
  128. /* Set symbol to y if allnoconfig; used for symbols that hide others */
  129. #define SYMBOL_ALLNOCONFIG_Y 0x200000
  130. #define SYMBOL_MAXLENGTH 256
  131. #define SYMBOL_HASHSIZE 9973
  132. /* A property represent the config options that can be associated
  133. * with a config "symbol".
  134. * Sample:
  135. * config FOO
  136. * default y
  137. * prompt "foo prompt"
  138. * select BAR
  139. * config BAZ
  140. * int "BAZ Value"
  141. * range 1..255
  142. */
  143. enum prop_type {
  144. P_UNKNOWN,
  145. P_PROMPT, /* prompt "foo prompt" or "BAZ Value" */
  146. P_COMMENT, /* text associated with a comment */
  147. P_MENU, /* prompt associated with a menu or menuconfig symbol */
  148. P_DEFAULT, /* default y */
  149. P_CHOICE, /* choice value */
  150. P_SELECT, /* select BAR */
  151. P_IMPLY, /* imply BAR */
  152. P_RANGE, /* range 7..100 (for a symbol) */
  153. P_ENV, /* value from environment variable */
  154. P_SYMBOL, /* where a symbol is defined */
  155. };
  156. struct property {
  157. struct property *next; /* next property - null if last */
  158. struct symbol *sym; /* the symbol for which the property is associated */
  159. enum prop_type type; /* type of property */
  160. const char *text; /* the prompt value - P_PROMPT, P_MENU, P_COMMENT */
  161. struct expr_value visible;
  162. struct expr *expr; /* the optional conditional part of the property */
  163. struct menu *menu; /* the menu the property are associated with
  164. * valid for: P_SELECT, P_RANGE, P_CHOICE,
  165. * P_PROMPT, P_DEFAULT, P_MENU, P_COMMENT */
  166. struct file *file; /* what file was this property defined */
  167. int lineno; /* what lineno was this property defined */
  168. };
  169. #define for_all_properties(sym, st, tok) \
  170. for (st = sym->prop; st; st = st->next) \
  171. if (st->type == (tok))
  172. #define for_all_defaults(sym, st) for_all_properties(sym, st, P_DEFAULT)
  173. #define for_all_choices(sym, st) for_all_properties(sym, st, P_CHOICE)
  174. #define for_all_prompts(sym, st) \
  175. for (st = sym->prop; st; st = st->next) \
  176. if (st->text)
  177. /*
  178. * Represents a node in the menu tree, as seen in e.g. menuconfig (though used
  179. * for all front ends). Each symbol, menu, etc. defined in the Kconfig files
  180. * gets a node. A symbol defined in multiple locations gets one node at each
  181. * location.
  182. */
  183. struct menu {
  184. /* The next menu node at the same level */
  185. struct menu *next;
  186. /* The parent menu node, corresponding to e.g. a menu or choice */
  187. struct menu *parent;
  188. /* The first child menu node, for e.g. menus and choices */
  189. struct menu *list;
  190. /*
  191. * The symbol associated with the menu node. Choices are implemented as
  192. * a special kind of symbol. NULL for menus, comments, and ifs.
  193. */
  194. struct symbol *sym;
  195. /*
  196. * The prompt associated with the node. This holds the prompt for a
  197. * symbol as well as the text for a menu or comment, along with the
  198. * type (P_PROMPT, P_MENU, etc.)
  199. */
  200. struct property *prompt;
  201. /*
  202. * 'visible if' dependencies. If more than one is given, they will be
  203. * ANDed together.
  204. */
  205. struct expr *visibility;
  206. /*
  207. * Ordinary dependencies from e.g. 'depends on' and 'if', ANDed
  208. * together
  209. */
  210. struct expr *dep;
  211. /* MENU_* flags */
  212. unsigned int flags;
  213. /* Any help text associated with the node */
  214. char *help;
  215. /* The location where the menu node appears in the Kconfig files */
  216. struct file *file;
  217. int lineno;
  218. /* For use by front ends that need to store auxiliary data */
  219. void *data;
  220. };
  221. /*
  222. * Set on a menu node when the corresponding symbol changes state in some way.
  223. * Can be checked by front ends.
  224. */
  225. #define MENU_CHANGED 0x0001
  226. #define MENU_ROOT 0x0002
  227. struct jump_key {
  228. struct list_head entries;
  229. size_t offset;
  230. struct menu *target;
  231. int index;
  232. };
  233. #define JUMP_NB 9
  234. extern struct file *file_list;
  235. extern struct file *current_file;
  236. struct file *lookup_file(const char *name);
  237. extern struct symbol symbol_yes, symbol_no, symbol_mod;
  238. extern struct symbol *modules_sym;
  239. extern struct symbol *sym_defconfig_list;
  240. extern int cdebug;
  241. struct expr *expr_alloc_symbol(struct symbol *sym);
  242. struct expr *expr_alloc_one(enum expr_type type, struct expr *ce);
  243. struct expr *expr_alloc_two(enum expr_type type, struct expr *e1, struct expr *e2);
  244. struct expr *expr_alloc_comp(enum expr_type type, struct symbol *s1, struct symbol *s2);
  245. struct expr *expr_alloc_and(struct expr *e1, struct expr *e2);
  246. struct expr *expr_alloc_or(struct expr *e1, struct expr *e2);
  247. struct expr *expr_copy(const struct expr *org);
  248. void expr_free(struct expr *e);
  249. void expr_eliminate_eq(struct expr **ep1, struct expr **ep2);
  250. tristate expr_calc_value(struct expr *e);
  251. struct expr *expr_trans_bool(struct expr *e);
  252. struct expr *expr_eliminate_dups(struct expr *e);
  253. struct expr *expr_transform(struct expr *e);
  254. int expr_contains_symbol(struct expr *dep, struct symbol *sym);
  255. bool expr_depends_symbol(struct expr *dep, struct symbol *sym);
  256. struct expr *expr_trans_compare(struct expr *e, enum expr_type type, struct symbol *sym);
  257. void expr_fprint(struct expr *e, FILE *out);
  258. struct gstr; /* forward */
  259. void expr_gstr_print(struct expr *e, struct gstr *gs);
  260. void expr_gstr_print_revdep(struct expr *e, struct gstr *gs,
  261. tristate pr_type, const char *title);
  262. static inline int expr_is_yes(struct expr *e)
  263. {
  264. return !e || (e->type == E_SYMBOL && e->left.sym == &symbol_yes);
  265. }
  266. static inline int expr_is_no(struct expr *e)
  267. {
  268. return e && (e->type == E_SYMBOL && e->left.sym == &symbol_no);
  269. }
  270. #ifdef __cplusplus
  271. }
  272. #endif
  273. #endif /* EXPR_H */