kconfig: explain symbol value defaults
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / scripts / kconfig / expr.h
CommitLineData
1da177e4
LT
1/*
2 * Copyright (C) 2002 Roman Zippel <zippel@linux-m68k.org>
3 * Released under the terms of the GNU GPL v2.0.
4 */
5
6#ifndef EXPR_H
7#define EXPR_H
8
9#ifdef __cplusplus
10extern "C" {
11#endif
12
13#include <stdio.h>
14#ifndef __cplusplus
15#include <stdbool.h>
16#endif
17
18struct file {
19 struct file *next;
20 struct file *parent;
21 char *name;
22 int lineno;
23 int flags;
24};
25
26#define FILE_BUSY 0x0001
27#define FILE_SCANNED 0x0002
1da177e4
LT
28
29typedef enum tristate {
30 no, mod, yes
31} tristate;
32
33enum expr_type {
7a962923 34 E_NONE, E_OR, E_AND, E_NOT, E_EQUAL, E_UNEQUAL, E_LIST, E_SYMBOL, E_RANGE
1da177e4
LT
35};
36
37union expr_data {
38 struct expr *expr;
39 struct symbol *sym;
40};
41
42struct expr {
43 enum expr_type type;
44 union expr_data left, right;
45};
46
d6ee3576
SR
47#define EXPR_OR(dep1, dep2) (((dep1)>(dep2))?(dep1):(dep2))
48#define EXPR_AND(dep1, dep2) (((dep1)<(dep2))?(dep1):(dep2))
49#define EXPR_NOT(dep) (2-(dep))
1da177e4 50
7a962923
RZ
51#define expr_list_for_each_sym(l, e, s) \
52 for (e = (l); e && (s = e->right.sym); e = e->left.expr)
53
1da177e4
LT
54struct expr_value {
55 struct expr *expr;
56 tristate tri;
57};
58
59struct symbol_value {
60 void *val;
61 tristate tri;
62};
63
64enum symbol_type {
65 S_UNKNOWN, S_BOOLEAN, S_TRISTATE, S_INT, S_HEX, S_STRING, S_OTHER
66};
67
eaa2a874 68/* enum values are used as index to symbol.def[] */
0c1822e6
RZ
69enum {
70 S_DEF_USER, /* main user value */
eaa2a874
SR
71 S_DEF_AUTO, /* values read from auto.conf */
72 S_DEF_DEF3, /* Reserved for UI usage */
73 S_DEF_DEF4, /* Reserved for UI usage */
74 S_DEF_COUNT
0c1822e6
RZ
75};
76
1da177e4
LT
77struct symbol {
78 struct symbol *next;
79 char *name;
1da177e4 80 enum symbol_type type;
0c1822e6 81 struct symbol_value curr;
eaa2a874 82 struct symbol_value def[S_DEF_COUNT];
1da177e4
LT
83 tristate visible;
84 int flags;
85 struct property *prop;
1da177e4
LT
86 struct expr_value rev_dep;
87};
88
89#define for_all_symbols(i, sym) for (i = 0; i < 257; i++) for (sym = symbol_hash[i]; sym; sym = sym->next) if (sym->type != S_OTHER)
90
c0e150ac 91#define SYMBOL_CONST 0x0001
1da177e4
LT
92#define SYMBOL_CHECK 0x0008
93#define SYMBOL_CHOICE 0x0010
94#define SYMBOL_CHOICEVAL 0x0020
1da177e4
LT
95#define SYMBOL_VALID 0x0080
96#define SYMBOL_OPTIONAL 0x0100
97#define SYMBOL_WRITE 0x0200
98#define SYMBOL_CHANGED 0x0400
1da177e4
LT
99#define SYMBOL_AUTO 0x1000
100#define SYMBOL_CHECKED 0x2000
1da177e4 101#define SYMBOL_WARNED 0x8000
669bfad9
RZ
102#define SYMBOL_DEF 0x10000
103#define SYMBOL_DEF_USER 0x10000
2e3646e5 104#define SYMBOL_DEF_AUTO 0x20000
669bfad9
RZ
105#define SYMBOL_DEF3 0x40000
106#define SYMBOL_DEF4 0x80000
1da177e4
LT
107
108#define SYMBOL_MAXLENGTH 256
109#define SYMBOL_HASHSIZE 257
110#define SYMBOL_HASHMASK 0xff
111
112enum prop_type {
93449082
RZ
113 P_UNKNOWN, P_PROMPT, P_COMMENT, P_MENU, P_DEFAULT, P_CHOICE,
114 P_SELECT, P_RANGE, P_ENV
1da177e4
LT
115};
116
117struct property {
118 struct property *next;
119 struct symbol *sym;
120 enum prop_type type;
121 const char *text;
122 struct expr_value visible;
123 struct expr *expr;
124 struct menu *menu;
125 struct file *file;
126 int lineno;
127};
128
129#define for_all_properties(sym, st, tok) \
130 for (st = sym->prop; st; st = st->next) \
131 if (st->type == (tok))
132#define for_all_defaults(sym, st) for_all_properties(sym, st, P_DEFAULT)
133#define for_all_choices(sym, st) for_all_properties(sym, st, P_CHOICE)
134#define for_all_prompts(sym, st) \
135 for (st = sym->prop; st; st = st->next) \
136 if (st->text)
137
138struct menu {
139 struct menu *next;
140 struct menu *parent;
141 struct menu *list;
142 struct symbol *sym;
143 struct property *prompt;
144 struct expr *dep;
145 unsigned int flags;
03d29122 146 char *help;
1da177e4
LT
147 struct file *file;
148 int lineno;
149 void *data;
150};
151
152#define MENU_CHANGED 0x0001
153#define MENU_ROOT 0x0002
154
155#ifndef SWIG
156
157extern struct file *file_list;
158extern struct file *current_file;
159struct file *lookup_file(const char *name);
160
161extern struct symbol symbol_yes, symbol_no, symbol_mod;
162extern struct symbol *modules_sym;
face4374 163extern struct symbol *sym_defconfig_list;
1da177e4
LT
164extern int cdebug;
165struct expr *expr_alloc_symbol(struct symbol *sym);
166struct expr *expr_alloc_one(enum expr_type type, struct expr *ce);
167struct expr *expr_alloc_two(enum expr_type type, struct expr *e1, struct expr *e2);
168struct expr *expr_alloc_comp(enum expr_type type, struct symbol *s1, struct symbol *s2);
169struct expr *expr_alloc_and(struct expr *e1, struct expr *e2);
170struct expr *expr_alloc_or(struct expr *e1, struct expr *e2);
171struct expr *expr_copy(struct expr *org);
172void expr_free(struct expr *e);
173int expr_eq(struct expr *e1, struct expr *e2);
174void expr_eliminate_eq(struct expr **ep1, struct expr **ep2);
175tristate expr_calc_value(struct expr *e);
176struct expr *expr_eliminate_yn(struct expr *e);
177struct expr *expr_trans_bool(struct expr *e);
178struct expr *expr_eliminate_dups(struct expr *e);
179struct expr *expr_transform(struct expr *e);
180int expr_contains_symbol(struct expr *dep, struct symbol *sym);
181bool expr_depends_symbol(struct expr *dep, struct symbol *sym);
182struct expr *expr_extract_eq_and(struct expr **ep1, struct expr **ep2);
183struct expr *expr_extract_eq_or(struct expr **ep1, struct expr **ep2);
184void expr_extract_eq(enum expr_type type, struct expr **ep, struct expr **ep1, struct expr **ep2);
185struct expr *expr_trans_compare(struct expr *e, enum expr_type type, struct symbol *sym);
186
187void expr_fprint(struct expr *e, FILE *out);
188struct gstr; /* forward */
189void expr_gstr_print(struct expr *e, struct gstr *gs);
190
191static inline int expr_is_yes(struct expr *e)
192{
193 return !e || (e->type == E_SYMBOL && e->left.sym == &symbol_yes);
194}
195
196static inline int expr_is_no(struct expr *e)
197{
198 return e && (e->type == E_SYMBOL && e->left.sym == &symbol_no);
199}
200#endif
201
202#ifdef __cplusplus
203}
204#endif
205
206#endif /* EXPR_H */