1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
mainmenu "Toybox Configuration"
source generated/Config.probed
source generated/Config.in
comment ""
menu "Toybox global settings"
# This entry controls the multiplexer, disabled for single command builds
config TOYBOX
bool
default y
help
usage: toybox [--long | --help | --version | [command] [arguments...]]
With no arguments, shows available commands. First argument is
name of a command to run, followed by any arguments to that command.
--long Show path to each command
To install command symlinks, try:
for i in $(/bin/toybox --long); do ln -s /bin/toybox $i; done
Most toybox commands also understand the following arguments:
--help Show command help (only)
--version Show toybox version (only)
The filename "-" means stdin, "--" stops argument parsing,
and numerical arguments accept a single letter suffix for
kilo, mega, giga, tera, peta, and exabytes, plus an additional
"d" to indicate decimal 1000's instead of 1024.
config TOYBOX_SUID
bool "SUID support"
default y
help
Support for the Set User ID bit, to install toybox suid root and drop
permissions for commands which do not require root access. To use
this change ownership of the file to the root user and set the suid
bit in the file permissions:
chown root:root toybox; chmod +s toybox
choice
prompt "Security Blanket"
default TOYBOX_LSM_NONE
help
Select a Linux Security Module to complicate your system
until you can't find holes in it.
config TOYBOX_LSM_NONE
bool "None"
help
Don't try to achieve "watertight" by plugging the holes in a
collander, instead use conventional unix security (and possibly
Linux Containers) for a simple straightforward system.
config TOYBOX_SELINUX
bool "SELinux support"
help
Include SELinux options in commands such as ls, and add
SELinux-specific commands such as chcon to the Android menu.
config TOYBOX_SMACK
bool "SMACK support"
help
Include SMACK options in commands like ls for systems like Tizen.
endchoice
config TOYBOX_LIBCRYPTO
bool "Use libcrypto (OpenSSL/BoringSSL)"
default n
help
Use faster hash functions out of exteral -lcrypto library.
config TOYBOX_FLOAT
bool "Floating point support"
default y
help
Include floating point support infrastructure and commands that
require it.
config TOYBOX_HELP
bool "Help messages"
default y
help
Include help text for each command.
config TOYBOX_HELP_DASHDASH
bool "--help and --version"
default y
depends on TOYBOX_HELP
help
Support --help argument in all commands, even ones with a NULL
optstring. (Use TOYFLAG_NOHELP to disable.) Produces the same output
as "help command". --version shows toybox version.
config TOYBOX_I18N
bool "Internationalization support"
default y
help
Support for UTF-8 character sets, and some locale support.
config TOYBOX_FREE
bool "Free memory unnecessarily"
default n
help
When a program exits, the operating system will clean up after it
(free memory, close files, etc). To save size, toybox usually relies
on this behavior. If you're running toybox under a debugger or
without a real OS (ala newlib+libgloss), enable this to make toybox
clean up after itself.
config TOYBOX_NORECURSE
bool "Disable recursive execution"
default n
help
When one toybox command calls another, usually it just calls the new
command's main() function rather than searching the $PATH and calling
exec on another file (which is much slower).
This disables that optimization, so toybox will run external commands
even when it has a built-in version of that command. This requires
toybox symlinks to be installed in the $PATH, or re-invoking the
"toybox" multiplexer command by name.
config TOYBOX_DEBUG
bool "Debugging tests"
default n
help
Enable extra checks for debugging purposes. All of them catch
things that can only go wrong at development time, not runtime.
config TOYBOX_PEDANTIC_ARGS
bool "Pedantic argument checking"
default n
help
Check arguments for commands that have no arguments.
config TOYBOX_UID_SYS
int "First system UID"
default 100
help
When commands like useradd/groupadd allocate system IDs, start here.
config TOYBOX_UID_USR
int "First user UID"
default 500
help
When commands like useradd/groupadd allocate user IDs, start here.
config TOYBOX_MUSL_NOMMU_IS_BROKEN
bool "Workaround for musl-libc breakage on nommu systems."
default n
help
When using musl-libc on a nommu system, you'll need to say "y" here.
Although uclibc lets you detect support for things like fork() and
daemon() at compile time, musl intentionally includes broken versions
that always return -ENOSYS on nommu systems, and goes out of its way
to prevent any cross-compile compatible compile-time probes for a
nommu system.
Musl does this despite the fact that a nommu system can't even run
standard ELF binaries, and requires specially packaged executables.
(You can't even check a #define to see that you're building against
musl, due to its maintainer's policy that musl never has bugs that
require workarounds.)
So our only choice is to manually provide a musl nommu bug workaround
you can manually select to enable (larger, slower) nommu support with
musl.
You don't need this for uClibc, we have a compile time probe that
autodetects nommu support there.
endmenu
|