2 * Copyright (C) 2002 Roman Zippel <zippel@linux-m68k.org>
3 * Released under the terms of the GNU GPL v2.0.
5 * Introduced single menu mode (show all sub-menus in one large tree).
6 * 2002-11-06 Petr Baudis <pasky@ucw.cz>
8 * i18n, 2005, Arnaldo Carvalho de Melo <acme@conectiva.com.br>
11 #include <sys/ioctl.h>
25 #define LKC_DIRECT_LINK
27 #include "lxdialog/dialog.h"
29 static const char mconf_readme[] = N_(
32 "Some kernel features may be built directly into the kernel.\n"
33 "Some may be made into loadable runtime modules. Some features\n"
34 "may be completely removed altogether. There are also certain\n"
35 "kernel parameters which are not really features, but must be\n"
36 "entered in as decimal or hexadecimal numbers or possibly text.\n"
38 "Menu items beginning with [*], <M> or [ ] represent features\n"
39 "configured to be built in, modularized or removed respectively.\n"
40 "Pointed brackets <> represent module capable features.\n"
42 "To change any of these features, highlight it with the cursor\n"
43 "keys and press <Y> to build it in, <M> to make it a module or\n"
44 "<N> to removed it. You may also press the <Space Bar> to cycle\n"
45 "through the available options (ie. Y->N->M->Y).\n"
47 "Some additional keyboard hints:\n"
51 "o Use the Up/Down arrow keys (cursor keys) to highlight the item\n"
52 " you wish to change or submenu wish to select and press <Enter>.\n"
53 " Submenus are designated by \"--->\".\n"
55 " Shortcut: Press the option's highlighted letter (hotkey).\n"
56 " Pressing a hotkey more than once will sequence\n"
57 " through all visible items which use that hotkey.\n"
59 " You may also use the <PAGE UP> and <PAGE DOWN> keys to scroll\n"
60 " unseen options into view.\n"
62 "o To exit a menu use the cursor keys to highlight the <Exit> button\n"
63 " and press <ENTER>.\n"
65 " Shortcut: Press <ESC><ESC> or <E> or <X> if there is no hotkey\n"
66 " using those letters. You may press a single <ESC>, but\n"
67 " there is a delayed response which you may find annoying.\n"
69 " Also, the <TAB> and cursor keys will cycle between <Select>,\n"
70 " <Exit> and <Help>\n"
72 "o To get help with an item, use the cursor keys to highlight <Help>\n"
73 " and Press <ENTER>.\n"
75 " Shortcut: Press <H> or <?>.\n"
78 "Radiolists (Choice lists)\n"
80 "o Use the cursor keys to select the option you wish to set and press\n"
81 " <S> or the <SPACE BAR>.\n"
83 " Shortcut: Press the first letter of the option you wish to set then\n"
84 " press <S> or <SPACE BAR>.\n"
86 "o To see available help for the item, use the cursor keys to highlight\n"
87 " <Help> and Press <ENTER>.\n"
89 " Shortcut: Press <H> or <?>.\n"
91 " Also, the <TAB> and cursor keys will cycle between <Select> and\n"
97 "o Enter the requested information and press <ENTER>\n"
98 " If you are entering hexadecimal values, it is not necessary to\n"
99 " add the '0x' prefix to the entry.\n"
101 "o For help, use the <TAB> or cursor keys to highlight the help option\n"
102 " and press <ENTER>. You can try <TAB><H> as well.\n"
105 "Text Box (Help Window)\n"
107 "o Use the cursor keys to scroll up/down/left/right. The VI editor\n"
108 " keys h,j,k,l function here as do <SPACE BAR> and <B> for those\n"
109 " who are familiar with less and lynx.\n"
111 "o Press <E>, <X>, <Enter> or <Esc><Esc> to exit.\n"
114 "Alternate Configuration Files\n"
115 "-----------------------------\n"
116 "Menuconfig supports the use of alternate configuration files for\n"
117 "those who, for various reasons, find it necessary to switch\n"
118 "between different kernel configurations.\n"
120 "At the end of the main menu you will find two options. One is\n"
121 "for saving the current configuration to a file of your choosing.\n"
122 "The other option is for loading a previously saved alternate\n"
125 "Even if you don't use alternate configuration files, but you\n"
126 "find during a Menuconfig session that you have completely messed\n"
127 "up your settings, you may use the \"Load Alternate...\" option to\n"
128 "restore your previously saved settings from \".config\" without\n"
129 "restarting Menuconfig.\n"
131 "Other information\n"
132 "-----------------\n"
133 "If you use Menuconfig in an XTERM window make sure you have your\n"
134 "$TERM variable set to point to a xterm definition which supports color.\n"
135 "Otherwise, Menuconfig will look rather bad. Menuconfig will not\n"
136 "display correctly in a RXVT window because rxvt displays only one\n"
137 "intensity of color, bright.\n"
139 "Menuconfig will display larger menus on screens or xterms which are\n"
140 "set to display more than the standard 25 row by 80 column geometry.\n"
141 "In order for this to work, the \"stty size\" command must be able to\n"
142 "display the screen's current row and column geometry. I STRONGLY\n"
143 "RECOMMEND that you make sure you do NOT have the shell variables\n"
144 "LINES and COLUMNS exported into your environment. Some distributions\n"
145 "export those variables via /etc/profile. Some ncurses programs can\n"
146 "become confused when those variables (LINES & COLUMNS) don't reflect\n"
147 "the true screen size.\n"
149 "Optional personality available\n"
150 "------------------------------\n"
151 "If you prefer to have all of the kernel options listed in a single\n"
152 "menu, rather than the default multimenu hierarchy, run the menuconfig\n"
153 "with MENUCONFIG_MODE environment variable set to single_menu. Example:\n"
155 "make MENUCONFIG_MODE=single_menu menuconfig\n"
157 "<Enter> will then unroll the appropriate category, or enfold it if it\n"
158 "is already unrolled.\n"
160 "Note that this mode can eventually be a little more CPU expensive\n"
161 "(especially with a larger number of unrolled categories) than the\n"
164 "Different color themes available\n"
165 "--------------------------------\n"
166 "It is possible to select different color themes using the variable\n"
167 "MENUCONFIG_COLOR. To select a theme use:\n"
169 "make MENUCONFIG_COLOR=<theme> menuconfig\n"
171 "Available themes are\n"
172 " mono => selects colors suitable for monochrome displays\n"
173 " blackbg => selects a color scheme with black background\n"
174 " classic => theme with blue background. The classic look\n"
175 " bluetitle => a LCD friendly version of classic. (default)\n"
177 menu_instructions[] = N_(
178 "Arrow keys navigate the menu. "
179 "<Enter> selects submenus --->. "
180 "Highlighted letters are hotkeys. "
181 "Pressing <Y> includes, <N> excludes, <M> modularizes features. "
182 "Press <Esc><Esc> to exit, <?> for Help, </> for Search. "
183 "Legend: [*] built-in [ ] excluded <M> module < > module capable"),
184 radiolist_instructions[] = N_(
185 "Use the arrow keys to navigate this window or "
186 "press the hotkey of the item you wish to select "
187 "followed by the <SPACE BAR>. "
188 "Press <?> for additional information about this option."),
189 inputbox_instructions_int[] = N_(
190 "Please enter a decimal value. "
191 "Fractions will not be accepted. "
192 "Use the <TAB> key to move from the input field to the buttons below it."),
193 inputbox_instructions_hex[] = N_(
194 "Please enter a hexadecimal value. "
195 "Use the <TAB> key to move from the input field to the buttons below it."),
196 inputbox_instructions_string[] = N_(
197 "Please enter a string value. "
198 "Use the <TAB> key to move from the input field to the buttons below it."),
200 "This feature depends on another which has been configured as a module.\n"
201 "As a result, this feature will be built as a module."),
203 "There is no help available for this kernel option.\n"),
204 load_config_text[] = N_(
205 "Enter the name of the configuration file you wish to load. "
206 "Accept the name shown to restore the configuration you "
207 "last retrieved. Leave blank to abort."),
208 load_config_help[] = N_(
210 "For various reasons, one may wish to keep several different kernel\n"
211 "configurations available on a single machine.\n"
213 "If you have saved a previous configuration in a file other than the\n"
214 "kernel's default, entering the name of the file here will allow you\n"
215 "to modify that configuration.\n"
217 "If you are uncertain, then you have probably never used alternate\n"
218 "configuration files. You should therefor leave this blank to abort.\n"),
219 save_config_text[] = N_(
220 "Enter a filename to which this configuration should be saved "
221 "as an alternate. Leave blank to abort."),
222 save_config_help[] = N_(
224 "For various reasons, one may wish to keep different kernel\n"
225 "configurations available on a single machine.\n"
227 "Entering a file name here will allow you to later retrieve, modify\n"
228 "and use the current configuration as an alternate to whatever\n"
229 "configuration options you have selected at that time.\n"
231 "If you are uncertain what all this means then you should probably\n"
232 "leave this blank.\n"),
235 "Search for CONFIG_ symbols and display their relations.\n"
236 "Regular expressions are allowed.\n"
237 "Example: search for \"^FOO\"\n"
239 "-----------------------------------------------------------------\n"
241 "Prompt: Foo bus is used to drive the bar HW\n"
242 "Defined at drivers/pci/Kconfig:47\n"
243 "Depends on: X86_LOCAL_APIC && X86_IO_APIC || IA64\n"
245 " -> Bus options (PCI, PCMCIA, EISA, MCA, ISA)\n"
246 " -> PCI support (PCI [=y])\n"
247 " -> PCI access mode (<choice> [=y])\n"
248 "Selects: LIBCRC32\n"
250 "-----------------------------------------------------------------\n"
251 "o The line 'Prompt:' shows the text used in the menu structure for\n"
252 " this CONFIG_ symbol\n"
253 "o The 'Defined at' line tell at what file / line number the symbol\n"
255 "o The 'Depends on:' line tell what symbols needs to be defined for\n"
256 " this symbol to be visible in the menu (selectable)\n"
257 "o The 'Location:' lines tell where in the menu structure this symbol\n"
259 " A location followed by a [=y] indicate that this is a selectable\n"
260 " menu item - and current value is displayed inside brackets.\n"
261 "o The 'Selects:' line tell what symbol will be automatically\n"
262 " selected if this symbol is selected (y or m)\n"
263 "o The 'Selected by' line tell what symbol has selected this symbol\n"
265 "Only relevant lines are shown.\n"
268 "Examples: USB => find all CONFIG_ symbols containing USB\n"
269 " ^USB => find all CONFIG_ symbols starting with USB\n"
270 " USB$ => find all CONFIG_ symbols ending with USB\n"
274 static struct termios ios_org;
275 static int rows = 0, cols = 0;
276 static struct menu *current_menu;
277 static int child_count;
278 static int single_menu_mode;
280 static void conf(struct menu *menu);
281 static void conf_choice(struct menu *menu);
282 static void conf_string(struct menu *menu);
283 static void conf_load(void);
284 static void conf_save(void);
285 static void show_textbox(const char *title, const char *text, int r, int c);
286 static void show_helptext(const char *title, const char *text);
287 static void show_help(struct menu *menu);
289 static void init_wsize(void)
294 if (!ioctl(STDIN_FILENO, TIOCGWINSZ, &ws)) {
300 env = getenv("LINES");
307 env = getenv("COLUMNS");
314 if (rows < 19 || cols < 80) {
315 fprintf(stderr, N_("Your display is too small to run Menuconfig!\n"));
316 fprintf(stderr, N_("It must be at least 19 lines by 80 columns.\n"));
324 static void get_prompt_str(struct gstr *r, struct property *prop)
327 struct menu *submenu[8], *menu;
329 str_printf(r, "Prompt: %s\n", prop->text);
330 str_printf(r, " Defined at %s:%d\n", prop->menu->file->name,
332 if (!expr_is_yes(prop->visible.expr)) {
333 str_append(r, " Depends on: ");
334 expr_gstr_print(prop->visible.expr, r);
337 menu = prop->menu->parent;
338 for (i = 0; menu != &rootmenu && i < 8; menu = menu->parent)
341 str_printf(r, " Location:\n");
342 for (j = 4; --i >= 0; j += 2) {
344 str_printf(r, "%*c-> %s", j, ' ', menu_get_prompt(menu));
346 str_printf(r, " (%s [=%s])", menu->sym->name ?
347 menu->sym->name : "<choice>",
348 sym_get_string_value(menu->sym));
355 static void get_symbol_str(struct gstr *r, struct symbol *sym)
358 struct property *prop;
360 str_printf(r, "Symbol: %s [=%s]\n", sym->name,
361 sym_get_string_value(sym));
362 for_all_prompts(sym, prop)
363 get_prompt_str(r, prop);
365 for_all_properties(sym, prop, P_SELECT) {
367 str_append(r, " Selects: ");
370 str_printf(r, " && ");
371 expr_gstr_print(prop->expr, r);
375 if (sym->rev_dep.expr) {
376 str_append(r, " Selected by: ");
377 expr_gstr_print(sym->rev_dep.expr, r);
380 str_append(r, "\n\n");
383 static struct gstr get_relations_str(struct symbol **sym_arr)
386 struct gstr res = str_new();
389 for (i = 0; sym_arr && (sym = sym_arr[i]); i++)
390 get_symbol_str(&res, sym);
392 str_append(&res, "No matches found.\n");
396 static char filename[PATH_MAX+1];
397 static void set_config_filename(const char *config_filename)
399 static char menu_backtitle[PATH_MAX+128];
403 sym = sym_lookup("KERNELVERSION", 0);
405 size = snprintf(menu_backtitle, sizeof(menu_backtitle),
406 _("%s - Linux Kernel v%s Configuration"),
407 config_filename, sym_get_string_value(sym));
408 if (size >= sizeof(menu_backtitle))
409 menu_backtitle[sizeof(menu_backtitle)-1] = '\0';
410 set_dialog_backtitle(menu_backtitle);
412 size = snprintf(filename, sizeof(filename), "%s", config_filename);
413 if (size >= sizeof(filename))
414 filename[sizeof(filename)-1] = '\0';
418 static void search_conf(void)
420 struct symbol **sym_arr;
425 dres = dialog_inputbox(_("Search Configuration Parameter"),
426 _("Enter CONFIG_ (sub)string to search for (omit CONFIG_)"),
432 show_helptext(_("Search Configuration"), search_help);
438 sym_arr = sym_re_search(dialog_input_result);
439 res = get_relations_str(sym_arr);
441 show_textbox(_("Search Results"), str_get(&res), 0, 0);
445 static void build_conf(struct menu *menu)
448 struct property *prop;
450 int type, tmp, doint = 2;
454 if (!menu_is_visible(menu))
460 if (prop && menu != current_menu) {
461 const char *prompt = menu_get_prompt(menu);
462 switch (prop->type) {
465 if (single_menu_mode) {
467 menu->data ? "-->" : "++>",
468 indent + 1, ' ', prompt);
470 item_make(" %*c%s --->", indent + 1, ' ', prompt);
474 if (single_menu_mode && menu->data)
480 item_make("---%*c%s", indent + 1, ' ', prompt);
490 type = sym_get_type(sym);
491 if (sym_is_choice(sym)) {
492 struct symbol *def_sym = sym_get_choice_value(sym);
493 struct menu *def_menu = NULL;
496 for (child = menu->list; child; child = child->next) {
497 if (menu_is_visible(child) && child->sym == def_sym)
501 val = sym_get_tristate_value(sym);
502 if (sym_is_changable(sym)) {
505 item_make("[%c]", val == no ? ' ' : '*');
509 case yes: ch = '*'; break;
510 case mod: ch = 'M'; break;
511 default: ch = ' '; break;
513 item_make("<%c>", ch);
520 item_set_tag(def_menu ? 't' : ':');
524 item_add_str("%*c%s", indent + 1, ' ', menu_get_prompt(menu));
527 item_add_str(" (%s)", menu_get_prompt(def_menu));
528 item_add_str(" --->");
529 if (def_menu->list) {
531 build_conf(def_menu);
538 if (menu == current_menu) {
539 item_make("---%*c%s", indent + 1, ' ', menu_get_prompt(menu));
545 val = sym_get_tristate_value(sym);
546 if (sym_is_choice_value(sym) && val == yes) {
553 if (sym_is_changable(sym))
554 item_make("[%c]", val == no ? ' ' : '*');
562 case yes: ch = '*'; break;
563 case mod: ch = 'M'; break;
564 default: ch = ' '; break;
566 if (sym_is_changable(sym))
567 item_make("<%c>", ch);
574 tmp = 2 + strlen(sym_get_string_value(sym)); /* () = 2 */
575 item_make("(%s)", sym_get_string_value(sym));
576 tmp = indent - tmp + 4;
579 item_add_str("%*c%s%s", tmp, ' ', menu_get_prompt(menu),
580 (sym_has_value(sym) || !sym_is_changable(sym)) ?
587 item_add_str("%*c%s%s", indent + 1, ' ', menu_get_prompt(menu),
588 (sym_has_value(sym) || !sym_is_changable(sym)) ?
590 if (menu->prompt->type == P_MENU) {
591 item_add_str(" --->");
598 for (child = menu->list; child; child = child->next)
603 static void conf(struct menu *menu)
605 struct menu *submenu;
606 const char *prompt = menu_get_prompt(menu);
608 struct menu *active_menu = NULL;
618 if (menu == &rootmenu) {
621 item_make(_(" Load an Alternate Configuration File"));
623 item_make(_(" Save an Alternate Configuration File"));
627 res = dialog_menu(prompt ? prompt : _("Main Menu"),
628 _(menu_instructions),
629 active_menu, &s_scroll);
630 if (res == 1 || res == KEY_ESC || res == -ERRDISPLAYTOOSMALL)
632 if (!item_activate_selected())
637 submenu = item_data();
638 active_menu = item_data();
646 switch (item_tag()) {
648 if (single_menu_mode)
649 submenu->data = (void *) (long) !submenu->data;
654 if (sym_is_choice(sym) && sym_get_tristate_value(sym) == yes)
655 conf_choice(submenu);
656 else if (submenu->prompt->type == P_MENU)
660 conf_string(submenu);
674 show_helptext("README", _(mconf_readme));
677 if (item_is_tag('t')) {
678 if (sym_set_tristate_value(sym, yes))
680 if (sym_set_tristate_value(sym, mod))
681 show_textbox(NULL, setmod_text, 6, 74);
685 if (item_is_tag('t'))
686 sym_set_tristate_value(sym, no);
689 if (item_is_tag('t'))
690 sym_set_tristate_value(sym, mod);
693 if (item_is_tag('t'))
694 sym_toggle_tristate_value(sym);
695 else if (item_is_tag('m'))
705 static void show_textbox(const char *title, const char *text, int r, int c)
708 dialog_textbox(title, text, r, c);
711 static void show_helptext(const char *title, const char *text)
713 show_textbox(title, text, 0, 0);
716 static void show_help(struct menu *menu)
718 struct gstr help = str_new();
719 struct symbol *sym = menu->sym;
724 str_printf(&help, "CONFIG_%s:\n\n", sym->name);
725 str_append(&help, _(sym->help));
726 str_append(&help, "\n");
729 str_append(&help, nohelp_text);
731 get_symbol_str(&help, sym);
732 show_helptext(menu_get_prompt(menu), str_get(&help));
736 static void conf_choice(struct menu *menu)
738 const char *prompt = menu_get_prompt(menu);
740 struct symbol *active;
742 active = sym_get_choice_value(menu->sym);
749 for (child = menu->list; child; child = child->next) {
750 if (!menu_is_visible(child))
752 item_make("%s", menu_get_prompt(child));
753 item_set_data(child);
754 if (child->sym == active)
755 item_set_selected(1);
756 if (child->sym == sym_get_choice_value(menu->sym))
760 res = dialog_checklist(prompt ? prompt : _("Main Menu"),
761 _(radiolist_instructions),
763 selected = item_activate_selected();
768 sym_set_tristate_value(child->sym, yes);
781 case -ERRDISPLAYTOOSMALL:
787 static void conf_string(struct menu *menu)
789 const char *prompt = menu_get_prompt(menu);
795 switch (sym_get_type(menu->sym)) {
797 heading = _(inputbox_instructions_int);
800 heading = _(inputbox_instructions_hex);
803 heading = _(inputbox_instructions_string);
806 heading = "Internal mconf error!";
809 res = dialog_inputbox(prompt ? prompt : _("Main Menu"),
811 sym_get_string_value(menu->sym));
814 if (sym_set_string_value(menu->sym, dialog_input_result))
816 show_textbox(NULL, _("You have made an invalid entry."), 5, 43);
827 static void conf_load(void)
833 res = dialog_inputbox(NULL, load_config_text,
837 if (!dialog_input_result[0])
839 if (!conf_read(dialog_input_result)) {
840 set_config_filename(dialog_input_result);
843 show_textbox(NULL, _("File does not exist!"), 5, 38);
846 show_helptext(_("Load Alternate Configuration"), load_config_help);
854 static void conf_save(void)
859 res = dialog_inputbox(NULL, save_config_text,
863 if (!dialog_input_result[0])
865 if (!conf_write(dialog_input_result)) {
866 set_config_filename(dialog_input_result);
869 show_textbox(NULL, _("Can't create file! Probably a nonexistent directory."), 5, 60);
872 show_helptext(_("Save Alternate Configuration"), save_config_help);
880 static void conf_cleanup(void)
882 tcsetattr(1, TCSAFLUSH, &ios_org);
885 int main(int ac, char **av)
890 setlocale(LC_ALL, "");
891 bindtextdomain(PACKAGE, LOCALEDIR);
897 mode = getenv("MENUCONFIG_MODE");
899 if (!strcasecmp(mode, "single_menu"))
900 single_menu_mode = 1;
903 tcgetattr(1, &ios_org);
904 atexit(conf_cleanup);
908 set_config_filename(conf_get_configname());
912 if (conf_get_changed())
913 res = dialog_yesno(NULL,
914 _("Do you wish to save your "
915 "new kernel configuration?\n"
916 "<ESC><ESC> to continue."),
920 } while (res == KEY_ESC);
925 if (conf_write(filename)) {
926 fprintf(stderr, _("\n\n"
927 "Error during writing of the kernel configuration.\n"
928 "Your kernel configuration changes were NOT saved."
934 "*** End of Linux kernel configuration.\n"
935 "*** Execute 'make' to build the kernel or try 'make help'."
939 fprintf(stderr, _("\n\n"
940 "Your kernel configuration changes were NOT saved."