expr.h 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331
  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_NO_WRITE 0x1000 /* Symbol for internal use only; it will not be written */
  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. * Please, also check zconf.y:print_symbol() when modifying the
  144. * list of property types!
  145. */
  146. enum prop_type {
  147. P_UNKNOWN,
  148. P_PROMPT, /* prompt "foo prompt" or "BAZ Value" */
  149. P_COMMENT, /* text associated with a comment */
  150. P_MENU, /* prompt associated with a menu or menuconfig symbol */
  151. P_DEFAULT, /* default y */
  152. P_CHOICE, /* choice value */
  153. P_SELECT, /* select BAR */
  154. P_IMPLY, /* imply BAR */
  155. P_RANGE, /* range 7..100 (for a symbol) */
  156. P_SYMBOL, /* where a symbol is defined */
  157. };
  158. struct property {
  159. struct property *next; /* next property - null if last */
  160. struct symbol *sym; /* the symbol for which the property is associated */
  161. enum prop_type type; /* type of property */
  162. const char *text; /* the prompt value - P_PROMPT, P_MENU, P_COMMENT */
  163. struct expr_value visible;
  164. struct expr *expr; /* the optional conditional part of the property */
  165. struct menu *menu; /* the menu the property are associated with
  166. * valid for: P_SELECT, P_RANGE, P_CHOICE,
  167. * P_PROMPT, P_DEFAULT, P_MENU, P_COMMENT */
  168. struct file *file; /* what file was this property defined */
  169. int lineno; /* what lineno was this property defined */
  170. };
  171. #define for_all_properties(sym, st, tok) \
  172. for (st = sym->prop; st; st = st->next) \
  173. if (st->type == (tok))
  174. #define for_all_defaults(sym, st) for_all_properties(sym, st, P_DEFAULT)
  175. #define for_all_choices(sym, st) for_all_properties(sym, st, P_CHOICE)
  176. #define for_all_prompts(sym, st) \
  177. for (st = sym->prop; st; st = st->next) \
  178. if (st->text)
  179. /*
  180. * Represents a node in the menu tree, as seen in e.g. menuconfig (though used
  181. * for all front ends). Each symbol, menu, etc. defined in the Kconfig files
  182. * gets a node. A symbol defined in multiple locations gets one node at each
  183. * location.
  184. */
  185. struct menu {
  186. /* The next menu node at the same level */
  187. struct menu *next;
  188. /* The parent menu node, corresponding to e.g. a menu or choice */
  189. struct menu *parent;
  190. /* The first child menu node, for e.g. menus and choices */
  191. struct menu *list;
  192. /*
  193. * The symbol associated with the menu node. Choices are implemented as
  194. * a special kind of symbol. NULL for menus, comments, and ifs.
  195. */
  196. struct symbol *sym;
  197. /*
  198. * The prompt associated with the node. This holds the prompt for a
  199. * symbol as well as the text for a menu or comment, along with the
  200. * type (P_PROMPT, P_MENU, etc.)
  201. */
  202. struct property *prompt;
  203. /*
  204. * 'visible if' dependencies. If more than one is given, they will be
  205. * ANDed together.
  206. */
  207. struct expr *visibility;
  208. /*
  209. * Ordinary dependencies from e.g. 'depends on' and 'if', ANDed
  210. * together
  211. */
  212. struct expr *dep;
  213. /* MENU_* flags */
  214. unsigned int flags;
  215. /* Any help text associated with the node */
  216. char *help;
  217. /* The location where the menu node appears in the Kconfig files */
  218. struct file *file;
  219. int lineno;
  220. /* For use by front ends that need to store auxiliary data */
  221. void *data;
  222. };
  223. /*
  224. * Set on a menu node when the corresponding symbol changes state in some way.
  225. * Can be checked by front ends.
  226. */
  227. #define MENU_CHANGED 0x0001
  228. #define MENU_ROOT 0x0002
  229. struct jump_key {
  230. struct list_head entries;
  231. size_t offset;
  232. struct menu *target;
  233. int index;
  234. };
  235. #define JUMP_NB 9
  236. extern struct file *file_list;
  237. extern struct file *current_file;
  238. struct file *lookup_file(const char *name);
  239. extern struct symbol symbol_yes, symbol_no, symbol_mod;
  240. extern struct symbol *modules_sym;
  241. extern struct symbol *sym_defconfig_list;
  242. extern int cdebug;
  243. struct expr *expr_alloc_symbol(struct symbol *sym);
  244. struct expr *expr_alloc_one(enum expr_type type, struct expr *ce);
  245. struct expr *expr_alloc_two(enum expr_type type, struct expr *e1, struct expr *e2);
  246. struct expr *expr_alloc_comp(enum expr_type type, struct symbol *s1, struct symbol *s2);
  247. struct expr *expr_alloc_and(struct expr *e1, struct expr *e2);
  248. struct expr *expr_alloc_or(struct expr *e1, struct expr *e2);
  249. struct expr *expr_copy(const struct expr *org);
  250. void expr_free(struct expr *e);
  251. void expr_eliminate_eq(struct expr **ep1, struct expr **ep2);
  252. tristate expr_calc_value(struct expr *e);
  253. struct expr *expr_trans_bool(struct expr *e);
  254. struct expr *expr_eliminate_dups(struct expr *e);
  255. struct expr *expr_transform(struct expr *e);
  256. int expr_contains_symbol(struct expr *dep, struct symbol *sym);
  257. bool expr_depends_symbol(struct expr *dep, struct symbol *sym);
  258. struct expr *expr_trans_compare(struct expr *e, enum expr_type type, struct symbol *sym);
  259. void expr_fprint(struct expr *e, FILE *out);
  260. struct gstr; /* forward */
  261. void expr_gstr_print(struct expr *e, struct gstr *gs);
  262. void expr_gstr_print_revdep(struct expr *e, struct gstr *gs,
  263. tristate pr_type, const char *title);
  264. static inline int expr_is_yes(struct expr *e)
  265. {
  266. return !e || (e->type == E_SYMBOL && e->left.sym == &symbol_yes);
  267. }
  268. static inline int expr_is_no(struct expr *e)
  269. {
  270. return e && (e->type == E_SYMBOL && e->left.sym == &symbol_no);
  271. }
  272. #ifdef __cplusplus
  273. }
  274. #endif
  275. #endif /* EXPR_H */