xref: /linux-6.15/scripts/kconfig/lkc.h (revision f79dc03f)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * Copyright (C) 2002 Roman Zippel <[email protected]>
4  */
5 
6 #ifndef LKC_H
7 #define LKC_H
8 
9 #include <assert.h>
10 #include <stdio.h>
11 #include <stdlib.h>
12 
13 #include "expr.h"
14 
15 #ifdef __cplusplus
16 extern "C" {
17 #endif
18 
19 #include "lkc_proto.h"
20 
21 #define SRCTREE "srctree"
22 
23 #ifndef CONFIG_
24 #define CONFIG_ "CONFIG_"
25 #endif
26 static inline const char *CONFIG_prefix(void)
27 {
28 	return getenv( "CONFIG_" ) ?: CONFIG_;
29 }
30 #undef CONFIG_
31 #define CONFIG_ CONFIG_prefix()
32 
33 extern int yylineno;
34 void zconfdump(FILE *out);
35 void zconf_starthelp(void);
36 FILE *zconf_fopen(const char *name);
37 void zconf_initscan(const char *name);
38 void zconf_nextfile(const char *name);
39 
40 /* confdata.c */
41 extern struct gstr autoconf_cmd;
42 const char *conf_get_configname(void);
43 
44 /* confdata.c and expr.c */
45 static inline void xfwrite(const void *str, size_t len, size_t count, FILE *out)
46 {
47 	assert(len != 0);
48 
49 	if (fwrite(str, len, count, out) != count)
50 		fprintf(stderr, "Error in writing or end of file.\n");
51 }
52 
53 /* util.c */
54 unsigned int strhash(const char *s);
55 const char *file_lookup(const char *name);
56 void *xmalloc(size_t size);
57 void *xcalloc(size_t nmemb, size_t size);
58 void *xrealloc(void *p, size_t size);
59 char *xstrdup(const char *s);
60 char *xstrndup(const char *s, size_t n);
61 
62 /* lexer.l */
63 int yylex(void);
64 
65 struct gstr {
66 	size_t len;
67 	char  *s;
68 	/*
69 	* when max_width is not zero long lines in string s (if any) get
70 	* wrapped not to exceed the max_width value
71 	*/
72 	int max_width;
73 };
74 struct gstr str_new(void);
75 void str_free(struct gstr *gs);
76 void str_append(struct gstr *gs, const char *s);
77 void str_printf(struct gstr *gs, const char *fmt, ...);
78 char *str_get(struct gstr *gs);
79 
80 /* menu.c */
81 struct menu *menu_next(struct menu *menu, struct menu *root);
82 #define menu_for_each_sub_entry(menu, root) \
83 	for (menu = menu_next(root, root); menu; menu = menu_next(menu, root))
84 #define menu_for_each_entry(menu) \
85 	menu_for_each_sub_entry(menu, &rootmenu)
86 void _menu_init(void);
87 void menu_warn(struct menu *menu, const char *fmt, ...);
88 struct menu *menu_add_menu(void);
89 void menu_end_menu(void);
90 void menu_add_entry(struct symbol *sym);
91 void menu_add_dep(struct expr *dep);
92 void menu_add_visibility(struct expr *dep);
93 struct property *menu_add_prompt(enum prop_type type, char *prompt, struct expr *dep);
94 void menu_add_expr(enum prop_type type, struct expr *expr, struct expr *dep);
95 void menu_add_symbol(enum prop_type type, struct symbol *sym, struct expr *dep);
96 void menu_finalize(void);
97 void menu_set_type(int type);
98 
99 extern struct menu rootmenu;
100 
101 bool menu_is_empty(struct menu *menu);
102 bool menu_is_visible(struct menu *menu);
103 bool menu_has_prompt(struct menu *menu);
104 const char *menu_get_prompt(struct menu *menu);
105 struct menu *menu_get_parent_menu(struct menu *menu);
106 int get_jump_key_char(void);
107 struct gstr get_relations_str(struct symbol **sym_arr, struct list_head *head);
108 void menu_get_ext_help(struct menu *menu, struct gstr *help);
109 
110 /* symbol.c */
111 void sym_clear_all_valid(void);
112 struct symbol *sym_choice_default(struct symbol *sym);
113 struct property *sym_get_range_prop(struct symbol *sym);
114 const char *sym_get_string_default(struct symbol *sym);
115 struct symbol *sym_check_deps(struct symbol *sym);
116 struct symbol *prop_get_symbol(struct property *prop);
117 
118 static inline tristate sym_get_tristate_value(struct symbol *sym)
119 {
120 	return sym->curr.tri;
121 }
122 
123 struct symbol *sym_get_choice_value(struct symbol *sym);
124 
125 static inline bool sym_is_choice(struct symbol *sym)
126 {
127 	/* A choice is a symbol with no name */
128 	return sym->name == NULL;
129 }
130 
131 static inline bool sym_is_choice_value(struct symbol *sym)
132 {
133 	return sym->flags & SYMBOL_CHOICEVAL ? true : false;
134 }
135 
136 static inline bool sym_has_value(struct symbol *sym)
137 {
138 	return sym->flags & SYMBOL_DEF_USER ? true : false;
139 }
140 
141 #ifdef __cplusplus
142 }
143 #endif
144 
145 #endif /* LKC_H */
146