blob: 0d7cb0e11f2c4b1ed0552504940c94cab4c09983 [file] [log] [blame]
Rob Landley5bcc7ea2014-09-20 13:20:17 -05001mainmenu "Toybox Configuration"
landley5257cf52006-10-31 23:30:06 -05002
Rob Landley76ec4852012-10-21 17:57:23 -05003
4source generated/Config.probed
5source generated/Config.in
6
7comment ""
8
Rob Landley3a9241a2012-08-25 14:25:22 -05009menu "Toybox global settings"
landley5257cf52006-10-31 23:30:06 -050010
Rob Landleya8bee462014-08-18 19:10:45 -050011# This entry controls the multiplexer, disabled for single command builds
Rob Landley28964802008-01-19 17:08:39 -060012config TOYBOX
13 bool
Rob Landleyd04dc1f2013-08-30 01:53:31 -050014 default y
Rob Landleyd06c58d2007-10-11 15:36:36 -050015 help
Rob Landley0a403902015-04-07 14:57:55 -050016 usage: toybox [--long | --version | [command] [arguments...]]
Rob Landleyd06c58d2007-10-11 15:36:36 -050017
Rob Landley26c00452013-04-14 12:35:25 -050018 With no arguments, shows available commands. First argument is
Rob Landley28964802008-01-19 17:08:39 -060019 name of a command to run, followed by any arguments to that command.
Rob Landleyd06c58d2007-10-11 15:36:36 -050020
Rob Landley84316922014-06-10 21:57:05 -050021 --long Show path to each command
Rob Landley0a403902015-04-07 14:57:55 -050022 --version Show toybox version
Rob Landley84316922014-06-10 21:57:05 -050023
24 To install command symlinks, try:
25 for i in $(/bin/toybox --long); do ln -s /bin/toybox $i; done
26
Rob Landleye0377fb2010-01-05 12:17:05 -060027config TOYBOX_SUID
28 bool "SUID support"
29 default y
30 help
Rob Landley26c00452013-04-14 12:35:25 -050031 Support for the Set User ID bit, to install toybox suid root and drop
32 permissions for commands which do not require root access. To use
33 this change ownership of the file to the root user and set the suid
34 bit in the file permissions:
35
36 chown root:root toybox; chmod +s toybox
Rob Landleye0377fb2010-01-05 12:17:05 -060037
Elliott Hughes7e2af1c2015-01-16 13:36:53 -060038config TOYBOX_SELINUX
39 bool "SELinux support"
40 default n
41 help
42 Include SELinux options in commands such as ls, and add
Rob Landley0a403902015-04-07 14:57:55 -050043 SELinux-specific commands such as chcon to the Android menu.
Elliott Hughes7e2af1c2015-01-16 13:36:53 -060044
Rob Landleyf01503d2012-02-02 07:26:39 -060045config TOYBOX_FLOAT
46 bool "Floating point support"
47 default y
48 help
49 Include floating point support infrastructure and commands that
50 require it.
51
Rob Landley36ffc5a2013-04-14 21:43:22 -050052config TOYBOX_HELP
Rob Landleyd683b172013-06-16 20:00:11 -050053 bool "Help messages"
Rob Landley36ffc5a2013-04-14 21:43:22 -050054 default y
55 help
56 Include help text for each command.
57
Rob Landley953722e2013-06-30 15:58:24 -050058config TOYBOX_HELP_DASHDASH
59 bool "--help"
60 default y
61 depends on TOYBOX_HELP
62 help
63 Support --help argument in all commands, even ones with a NULL
64 optstring. Produces the same output as "help command".
65
Felix Janda250e0052012-11-21 20:38:29 +010066config TOYBOX_I18N
Rob Landley26c00452013-04-14 12:35:25 -050067 bool "Internationalization support"
Felix Janda250e0052012-11-21 20:38:29 +010068 default y
69 help
Rob Landley26c00452013-04-14 12:35:25 -050070 Support for UTF-8 character sets, and some locale support.
Felix Janda250e0052012-11-21 20:38:29 +010071
Rob Landleyde05a702007-01-31 14:37:01 -050072config TOYBOX_FREE
landley5257cf52006-10-31 23:30:06 -050073 bool "Free memory unnecessarily"
74 default n
75 help
76 When a program exits, the operating system will clean up after it
Rob Landley26c00452013-04-14 12:35:25 -050077 (free memory, close files, etc). To save size, toybox usually relies
78 on this behavior. If you're running toybox under a debugger or
landley5257cf52006-10-31 23:30:06 -050079 without a real OS (ala newlib+libgloss), enable this to make toybox
80 clean up after itself.
81
Rob Landley977e48e2014-10-20 19:52:29 -050082config TOYBOX_NORECURSE
83 bool "Disable recursive execution"
84 default n
85 help
86 When one toybox command calls another, usually it just calls the new
87 command's main() function rather than searching the $PATH and calling
88 exec on another file (which is much slower).
89
90 This disables that optimization, so toybox will run external commands
91 even when it has a built-in version of that command. This requires
92 toybox symlinks to be installed in the $PATH, or re-invoking the
93 "toybox" multiplexer command by name.
94
Rob Landleyde05a702007-01-31 14:37:01 -050095config TOYBOX_DEBUG
Rob Landley8324b892006-11-19 02:49:22 -050096 bool "Debugging tests"
97 default n
98 help
Rob Landleya8bee462014-08-18 19:10:45 -050099 Enable extra checks for debugging purposes. All of them catch
100 things that can only go wrong at development time, not runtime.
101
102config TOYBOX_UID_SYS
103 int "First system UID"
104 default 100
105 help
106 When commands like useradd/groupadd allocate system IDs, start here.
107
108config TOYBOX_UID_USR
109 int "First user UID"
110 default 500
111 help
112 When commands like useradd/groupadd allocate user IDs, start here.
landley5257cf52006-10-31 23:30:06 -0500113endmenu