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>
21 #define LKC_DIRECT_LINK
23 #include "lxdialog/dialog.h"
25 static const char mconf_readme
[] = N_(
28 "Some kernel features may be built directly into the kernel.\n"
29 "Some may be made into loadable runtime modules. Some features\n"
30 "may be completely removed altogether. There are also certain\n"
31 "kernel parameters which are not really features, but must be\n"
32 "entered in as decimal or hexadecimal numbers or possibly text.\n"
34 "Menu items beginning with following braces represent features that\n"
35 " [ ] can be built in or removed\n"
36 " < > can be built in, modularized or removed\n"
37 " { } can be built in or modularized (selected by other feature)\n"
38 " - - are selected by other feature,\n"
39 "while *, M or whitespace inside braces means to build in, build as\n"
40 "a module or to exclude the feature respectively.\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 menu
*current_menu
;
275 static int child_count
;
276 static int single_menu_mode
;
278 static void conf(struct menu
*menu
);
279 static void conf_choice(struct menu
*menu
);
280 static void conf_string(struct menu
*menu
);
281 static void conf_load(void);
282 static void conf_save(void);
283 static void show_textbox(const char *title
, const char *text
, int r
, int c
);
284 static void show_helptext(const char *title
, const char *text
);
285 static void show_help(struct menu
*menu
);
287 static void get_prompt_str(struct gstr
*r
, struct property
*prop
)
290 struct menu
*submenu
[8], *menu
;
292 str_printf(r
, _("Prompt: %s\n"), _(prop
->text
));
293 str_printf(r
, _(" Defined at %s:%d\n"), prop
->menu
->file
->name
,
295 if (!expr_is_yes(prop
->visible
.expr
)) {
296 str_append(r
, _(" Depends on: "));
297 expr_gstr_print(prop
->visible
.expr
, r
);
300 menu
= prop
->menu
->parent
;
301 for (i
= 0; menu
!= &rootmenu
&& i
< 8; menu
= menu
->parent
)
304 str_printf(r
, _(" Location:\n"));
305 for (j
= 4; --i
>= 0; j
+= 2) {
307 str_printf(r
, "%*c-> %s", j
, ' ', _(menu_get_prompt(menu
)));
309 str_printf(r
, " (%s [=%s])", menu
->sym
->name
?
310 menu
->sym
->name
: _("<choice>"),
311 sym_get_string_value(menu
->sym
));
318 static void get_symbol_str(struct gstr
*r
, struct symbol
*sym
)
321 struct property
*prop
;
323 if (sym
&& sym
->name
)
324 str_printf(r
, "Symbol: %s [=%s]\n", sym
->name
,
325 sym_get_string_value(sym
));
326 for_all_prompts(sym
, prop
)
327 get_prompt_str(r
, prop
);
329 for_all_properties(sym
, prop
, P_SELECT
) {
331 str_append(r
, " Selects: ");
334 str_printf(r
, " && ");
335 expr_gstr_print(prop
->expr
, r
);
339 if (sym
->rev_dep
.expr
) {
340 str_append(r
, _(" Selected by: "));
341 expr_gstr_print(sym
->rev_dep
.expr
, r
);
344 str_append(r
, "\n\n");
347 static struct gstr
get_relations_str(struct symbol
**sym_arr
)
350 struct gstr res
= str_new();
353 for (i
= 0; sym_arr
&& (sym
= sym_arr
[i
]); i
++)
354 get_symbol_str(&res
, sym
);
356 str_append(&res
, _("No matches found.\n"));
360 static char filename
[PATH_MAX
+1];
361 static void set_config_filename(const char *config_filename
)
363 static char menu_backtitle
[PATH_MAX
+128];
367 sym
= sym_lookup("KERNELVERSION", 0);
369 size
= snprintf(menu_backtitle
, sizeof(menu_backtitle
),
370 _("%s - Linux Kernel v%s Configuration"),
371 config_filename
, sym_get_string_value(sym
));
372 if (size
>= sizeof(menu_backtitle
))
373 menu_backtitle
[sizeof(menu_backtitle
)-1] = '\0';
374 set_dialog_backtitle(menu_backtitle
);
376 size
= snprintf(filename
, sizeof(filename
), "%s", config_filename
);
377 if (size
>= sizeof(filename
))
378 filename
[sizeof(filename
)-1] = '\0';
382 static void search_conf(void)
384 struct symbol
**sym_arr
;
390 dres
= dialog_inputbox(_("Search Configuration Parameter"),
391 _("Enter CONFIG_ (sub)string to search for "
392 "(with or without \"CONFIG\")"),
398 show_helptext(_("Search Configuration"), search_help
);
404 /* strip CONFIG_ if necessary */
405 dialog_input
= dialog_input_result
;
406 if (strncasecmp(dialog_input_result
, "CONFIG_", 7) == 0)
409 sym_arr
= sym_re_search(dialog_input
);
410 res
= get_relations_str(sym_arr
);
412 show_textbox(_("Search Results"), str_get(&res
), 0, 0);
416 static void build_conf(struct menu
*menu
)
419 struct property
*prop
;
421 int type
, tmp
, doint
= 2;
425 if (!menu_is_visible(menu
))
431 if (prop
&& menu
!= current_menu
) {
432 const char *prompt
= menu_get_prompt(menu
);
433 switch (prop
->type
) {
437 if (single_menu_mode
) {
439 menu
->data
? "-->" : "++>",
440 indent
+ 1, ' ', prompt
);
442 item_make(" %*c%s --->", indent
+ 1, ' ', prompt
);
446 if (single_menu_mode
&& menu
->data
)
452 item_make(" %*c*** %s ***", indent
+ 1, ' ', _(prompt
));
460 item_make("---%*c%s", indent
+ 1, ' ', _(prompt
));
470 type
= sym_get_type(sym
);
471 if (sym_is_choice(sym
)) {
472 struct symbol
*def_sym
= sym_get_choice_value(sym
);
473 struct menu
*def_menu
= NULL
;
476 for (child
= menu
->list
; child
; child
= child
->next
) {
477 if (menu_is_visible(child
) && child
->sym
== def_sym
)
481 val
= sym_get_tristate_value(sym
);
482 if (sym_is_changable(sym
)) {
485 item_make("[%c]", val
== no
? ' ' : '*');
489 case yes
: ch
= '*'; break;
490 case mod
: ch
= 'M'; break;
491 default: ch
= ' '; break;
493 item_make("<%c>", ch
);
500 item_set_tag(def_menu
? 't' : ':');
504 item_add_str("%*c%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)));
507 item_add_str(" (%s)", _(menu_get_prompt(def_menu
)));
508 item_add_str(" --->");
509 if (def_menu
->list
) {
511 build_conf(def_menu
);
518 if (menu
== current_menu
) {
519 item_make("---%*c%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)));
525 val
= sym_get_tristate_value(sym
);
526 if (sym_is_choice_value(sym
) && val
== yes
) {
533 if (sym_is_changable(sym
))
534 item_make("[%c]", val
== no
? ' ' : '*');
536 item_make("-%c-", val
== no
? ' ' : '*');
542 case yes
: ch
= '*'; break;
543 case mod
: ch
= 'M'; break;
544 default: ch
= ' '; break;
546 if (sym_is_changable(sym
)) {
547 if (sym
->rev_dep
.tri
== mod
)
548 item_make("{%c}", ch
);
550 item_make("<%c>", ch
);
552 item_make("-%c-", ch
);
557 tmp
= 2 + strlen(sym_get_string_value(sym
)); /* () = 2 */
558 item_make("(%s)", sym_get_string_value(sym
));
559 tmp
= indent
- tmp
+ 4;
562 item_add_str("%*c%s%s", tmp
, ' ', _(menu_get_prompt(menu
)),
563 (sym_has_value(sym
) || !sym_is_changable(sym
)) ?
570 item_add_str("%*c%s%s", indent
+ 1, ' ', _(menu_get_prompt(menu
)),
571 (sym_has_value(sym
) || !sym_is_changable(sym
)) ?
573 if (menu
->prompt
->type
== P_MENU
) {
574 item_add_str(" --->");
581 for (child
= menu
->list
; child
; child
= child
->next
)
586 static void conf(struct menu
*menu
)
588 struct menu
*submenu
;
589 const char *prompt
= menu_get_prompt(menu
);
591 struct menu
*active_menu
= NULL
;
601 if (menu
== &rootmenu
) {
604 item_make(_(" Load an Alternate Configuration File"));
606 item_make(_(" Save an Alternate Configuration File"));
610 res
= dialog_menu(prompt
? _(prompt
) : _("Main Menu"),
611 _(menu_instructions
),
612 active_menu
, &s_scroll
);
613 if (res
== 1 || res
== KEY_ESC
|| res
== -ERRDISPLAYTOOSMALL
)
615 if (!item_activate_selected())
620 submenu
= item_data();
621 active_menu
= item_data();
629 switch (item_tag()) {
631 if (single_menu_mode
)
632 submenu
->data
= (void *) (long) !submenu
->data
;
637 if (sym_is_choice(sym
) && sym_get_tristate_value(sym
) == yes
)
638 conf_choice(submenu
);
639 else if (submenu
->prompt
->type
== P_MENU
)
643 conf_string(submenu
);
657 show_helptext(_("README"), _(mconf_readme
));
660 if (item_is_tag('t')) {
661 if (sym_set_tristate_value(sym
, yes
))
663 if (sym_set_tristate_value(sym
, mod
))
664 show_textbox(NULL
, setmod_text
, 6, 74);
668 if (item_is_tag('t'))
669 sym_set_tristate_value(sym
, no
);
672 if (item_is_tag('t'))
673 sym_set_tristate_value(sym
, mod
);
676 if (item_is_tag('t'))
677 sym_toggle_tristate_value(sym
);
678 else if (item_is_tag('m'))
688 static void show_textbox(const char *title
, const char *text
, int r
, int c
)
691 dialog_textbox(title
, text
, r
, c
);
694 static void show_helptext(const char *title
, const char *text
)
696 show_textbox(title
, text
, 0, 0);
699 static void show_help(struct menu
*menu
)
701 struct gstr help
= str_new();
702 struct symbol
*sym
= menu
->sym
;
704 if (menu_has_help(menu
))
707 str_printf(&help
, "CONFIG_%s:\n\n", sym
->name
);
708 str_append(&help
, _(menu_get_help(menu
)));
709 str_append(&help
, "\n");
712 str_append(&help
, nohelp_text
);
714 get_symbol_str(&help
, sym
);
715 show_helptext(_(menu_get_prompt(menu
)), str_get(&help
));
719 static void conf_choice(struct menu
*menu
)
721 const char *prompt
= _(menu_get_prompt(menu
));
723 struct symbol
*active
;
725 active
= sym_get_choice_value(menu
->sym
);
732 for (child
= menu
->list
; child
; child
= child
->next
) {
733 if (!menu_is_visible(child
))
735 item_make("%s", _(menu_get_prompt(child
)));
736 item_set_data(child
);
737 if (child
->sym
== active
)
738 item_set_selected(1);
739 if (child
->sym
== sym_get_choice_value(menu
->sym
))
743 res
= dialog_checklist(prompt
? _(prompt
) : _("Main Menu"),
744 _(radiolist_instructions
),
746 selected
= item_activate_selected();
751 sym_set_tristate_value(child
->sym
, yes
);
764 case -ERRDISPLAYTOOSMALL
:
770 static void conf_string(struct menu
*menu
)
772 const char *prompt
= menu_get_prompt(menu
);
778 switch (sym_get_type(menu
->sym
)) {
780 heading
= _(inputbox_instructions_int
);
783 heading
= _(inputbox_instructions_hex
);
786 heading
= _(inputbox_instructions_string
);
789 heading
= _("Internal mconf error!");
792 res
= dialog_inputbox(prompt
? _(prompt
) : _("Main Menu"),
794 sym_get_string_value(menu
->sym
));
797 if (sym_set_string_value(menu
->sym
, dialog_input_result
))
799 show_textbox(NULL
, _("You have made an invalid entry."), 5, 43);
810 static void conf_load(void)
816 res
= dialog_inputbox(NULL
, load_config_text
,
820 if (!dialog_input_result
[0])
822 if (!conf_read(dialog_input_result
)) {
823 set_config_filename(dialog_input_result
);
824 sym_set_change_count(1);
827 show_textbox(NULL
, _("File does not exist!"), 5, 38);
830 show_helptext(_("Load Alternate Configuration"), load_config_help
);
838 static void conf_save(void)
843 res
= dialog_inputbox(NULL
, save_config_text
,
847 if (!dialog_input_result
[0])
849 if (!conf_write(dialog_input_result
)) {
850 set_config_filename(dialog_input_result
);
853 show_textbox(NULL
, _("Can't create file! Probably a nonexistent directory."), 5, 60);
856 show_helptext(_("Save Alternate Configuration"), save_config_help
);
864 int main(int ac
, char **av
)
866 int saved_x
, saved_y
;
870 setlocale(LC_ALL
, "");
871 bindtextdomain(PACKAGE
, LOCALEDIR
);
877 mode
= getenv("MENUCONFIG_MODE");
879 if (!strcasecmp(mode
, "single_menu"))
880 single_menu_mode
= 1;
883 getyx(stdscr
, saved_y
, saved_x
);
884 if (init_dialog(NULL
)) {
885 fprintf(stderr
, N_("Your display is too small to run Menuconfig!\n"));
886 fprintf(stderr
, N_("It must be at least 19 lines by 80 columns.\n"));
890 set_config_filename(conf_get_configname());
894 if (conf_get_changed())
895 res
= dialog_yesno(NULL
,
896 _("Do you wish to save your "
897 "new kernel configuration?\n"
898 "<ESC><ESC> to continue."),
902 } while (res
== KEY_ESC
);
903 end_dialog(saved_x
, saved_y
);
907 if (conf_write(filename
)) {
908 fprintf(stderr
, _("\n\n"
909 "Error during writing of the kernel configuration.\n"
910 "Your kernel configuration changes were NOT saved."
916 "*** End of Linux kernel configuration.\n"
917 "*** Execute 'make' to build the kernel or try 'make help'."
921 fprintf(stderr
, _("\n\n"
922 "Your kernel configuration changes were NOT saved."