2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Networking Utilities"
8 config BUSYBOX_CONFIG_FEATURE_IPV6
9 bool "Enable IPv6 support"
12 Enable IPv6 support to busybox. This makes applets that talk IP
13 able to work with IPv6.
15 config BUSYBOX_CONFIG_ARPING
19 Ping hosts by ARP packets
21 config BUSYBOX_CONFIG_DNSD
25 Small and static DNS server deamon.
27 config BUSYBOX_CONFIG_ETHER_WAKE
31 Send a magic packet to wake up sleeping machines.
33 config BUSYBOX_CONFIG_FAKEIDENTD
37 fakeidentd listens to the ident port and returns a set fake
38 value whatever it gets.
40 config BUSYBOX_CONFIG_FTPGET
44 Retrieve a remote file via FTP.
46 config BUSYBOX_CONFIG_FTPPUT
50 Store a remote file via FTP.
52 config BUSYBOX_CONFIG_HOSTNAME
56 Show or set the system's host name
58 config BUSYBOX_CONFIG_HTTPD
62 Serve web pages via an HTTP server.
64 config BUSYBOX_CONFIG_FEATURE_HTTPD_USAGE_FROM_INETD_ONLY
65 bool " Support using httpd only from inetd"
67 depends on BUSYBOX_CONFIG_HTTPD
69 This option disables uid and port options for the httpd applet
70 but requires inetd server daemon.
72 config BUSYBOX_CONFIG_FEATURE_HTTPD_BASIC_AUTH
73 bool " Enable Basic http Authentication"
75 depends on BUSYBOX_CONFIG_HTTPD
77 Utilizes password settings from /etc/httpd.conf for basic
78 authentication on a per url basis.
80 config BUSYBOX_CONFIG_FEATURE_HTTPD_AUTH_MD5
81 bool " Support MD5 crypted passwords for http Authentication"
83 depends on BUSYBOX_CONFIG_FEATURE_HTTPD_BASIC_AUTH
85 Enables basic per url authentication from /etc/httpd.conf
88 if !CONFIG_FEATURE_HTTPD_USAGE_FROM_INETD_ONLY
89 config BUSYBOX_CONFIG_FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
90 bool " Support reloading the global config file using hup signal"
92 depends on BUSYBOX_CONFIG_HTTPD
94 This option enables processing of SIGHUP to reload cached
95 configuration settings.
97 config BUSYBOX_CONFIG_FEATURE_HTTPD_SETUID
98 bool " Enable support -u <user> option"
100 depends on BUSYBOX_CONFIG_HTTPD
102 This option allows the server to run as a specific user
103 rather than defaulting to the user that starts the server.
104 Use of this option requires special privileges to change to a
108 config BUSYBOX_CONFIG_FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
109 bool " Support loading additional MIME types at run-time"
111 depends on BUSYBOX_CONFIG_HTTPD
113 This option enables support for additional MIME types at
114 run-time to be specified in the configuration file.
116 config BUSYBOX_CONFIG_FEATURE_HTTPD_CGI
117 bool " Support Common Gateway Interface (CGI)"
119 depends on BUSYBOX_CONFIG_HTTPD
121 This option allows scripts and executables to be invoked
122 when specific urls are requested.
124 config BUSYBOX_CONFIG_FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
125 bool " Enable support for running scripts through an interpreter"
127 depends on BUSYBOX_CONFIG_FEATURE_HTTPD_CGI
129 This option enables support for running scripts through an
130 interpreter. Turn this on, if you want PHP scripts to work
131 properly. You need to supply an addition line in your httpd
133 *.php:/path/to/your/php
135 config BUSYBOX_CONFIG_FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
136 bool " Support the REMOTE_PORT environment variable for CGI"
138 depends on BUSYBOX_CONFIG_FEATURE_HTTPD_CGI
140 Use of this option can assist scripts in generating
141 references that contain a unique port number.
143 config BUSYBOX_CONFIG_FEATURE_HTTPD_ENCODE_URL_STR
144 bool " Enable the -e option for shell script CGI simplification."
146 depends on BUSYBOX_CONFIG_HTTPD
148 After set, this option allows html encoding arbitrary
149 strings for display of the browser. Output goes to stdout.
150 For example, httpd -e "<Hello World>" as
151 "<Hello World>".
153 config BUSYBOX_CONFIG_IFCONFIG
157 Ifconfig is used to configure the kernel-resident network interfaces.
159 config BUSYBOX_CONFIG_FEATURE_IFCONFIG_STATUS
160 bool " Enable status reporting output (+7k)"
162 depends on BUSYBOX_CONFIG_IFCONFIG
164 If ifconfig is called with no arguments it will display the status
165 of the currently active interfaces.
167 config BUSYBOX_CONFIG_FEATURE_IFCONFIG_SLIP
168 bool " Enable slip-specific options \"keepalive\" and \"outfill\""
170 depends on BUSYBOX_CONFIG_IFCONFIG
172 Allow "keepalive" and "outfill" support for SLIP. If you're not
173 planning on using serial lines, leave this unchecked.
175 config BUSYBOX_CONFIG_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
176 bool " Enable options \"mem_start\", \"io_addr\", and \"irq\""
178 depends on BUSYBOX_CONFIG_IFCONFIG
180 Allow the start address for shared memory, start address for I/O,
181 and/or the interrupt line used by the specified device.
183 config BUSYBOX_CONFIG_FEATURE_IFCONFIG_HW
184 bool " Enable option \"hw\" (ether only)"
186 depends on BUSYBOX_CONFIG_IFCONFIG
188 Set the hardware address of this interface, if the device driver
189 supports this operation. Currently, we only support the 'ether'
192 config BUSYBOX_CONFIG_FEATURE_IFCONFIG_BROADCAST_PLUS
193 bool " Set the broadcast automatically"
195 depends on BUSYBOX_CONFIG_IFCONFIG
197 Setting this will make ifconfig attempt to find the broadcast
198 automatically if the value '+' is used.
200 config BUSYBOX_CONFIG_IFUPDOWN
203 select BUSYBOX_CONFIG_RUN_PARTS
205 Activate or deactivate the specified interfaces. This applet makes
206 use of either "ifconfig" and "route" or the "ip" command to actually
207 configure network interfaces. Therefore, you will probably also want
208 to enable either BUSYBOX_CONFIG_IFCONFIG and BUSYBOX_CONFIG_ROUTE, or enable
209 BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IP and the various BUSYBOX_CONFIG_IP options. Of
210 course you could use non-busybox versions of these programs, so
211 against my better judgement (since this will surely result in plenty
212 of support questions on the mailing list), I do not force you to
213 enable these additional options. It is up to you to supply either
214 "ifconfig" and "route" or the "ip" command, either via busybox or via
215 standalone utilities.
217 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IP
218 bool " Use ip applet"
220 depends on BUSYBOX_CONFIG_IFUPDOWN
222 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
223 than the default of using the older 'ifconfig' and 'route' utilities.
225 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IP_BUILTIN
226 bool " Use busybox ip applet"
228 depends on BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IP
229 select BUSYBOX_CONFIG_IP
230 select BUSYBOX_CONFIG_FEATURE_IP_ADDRESS
231 select BUSYBOX_CONFIG_FEATURE_IP_LINK
232 select BUSYBOX_CONFIG_FEATURE_IP_ROUTE
234 Use the busybox iproute "ip" applet to implement "ifupdown".
236 If leave this disabled, you must install the full-blown iproute2
237 utility or the "ifup" and "ifdown" applets will not work.
239 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IP_BUILTIN
240 bool " Use busybox ifconfig and route applets"
242 depends on BUSYBOX_CONFIG_IFUPDOWN && !CONFIG_FEATURE_IFUPDOWN_IP
243 select BUSYBOX_CONFIG_IFCONFIG
244 select BUSYBOX_CONFIG_ROUTE
246 Use the busybox iproute "ifconfig" and "route" applets to
247 implement the "ifup" and "ifdown" utilities.
249 If leave this disabled, you must install the full-blown ifconfig
250 and route utilities, or the "ifup" and "ifdown" applets will not
253 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IPV4
254 bool " Enable support for IPv4"
256 depends on BUSYBOX_CONFIG_IFUPDOWN
258 If you want busybox to talk IPv4, leave this on.
260 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IPV6
261 bool " Enable support for IPv6"
263 depends on BUSYBOX_CONFIG_IFUPDOWN
265 If you need support for IPv6, turn this option on.
267 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_IPX
268 bool " Enable support for IPX"
270 depends on BUSYBOX_CONFIG_IFUPDOWN
272 If this option is selected you can use busybox to work with IPX
275 config BUSYBOX_CONFIG_FEATURE_IFUPDOWN_MAPPING
276 bool " Enable mapping support"
278 depends on BUSYBOX_CONFIG_IFUPDOWN
280 This enables support for the "mapping" stanza, unless you have
281 a weird network setup you don't need it.
283 config BUSYBOX_CONFIG_INETD
287 Internet superserver daemon
289 config BUSYBOX_CONFIG_FEATURE_INETD_SUPPORT_BILTIN_ECHO
290 bool " Support echo service"
292 depends on BUSYBOX_CONFIG_INETD
294 Echo received data internal inetd service
296 config BUSYBOX_CONFIG_FEATURE_INETD_SUPPORT_BILTIN_DISCARD
297 bool " Support discard service"
299 depends on BUSYBOX_CONFIG_INETD
301 Internet /dev/null internal inetd service
303 config BUSYBOX_CONFIG_FEATURE_INETD_SUPPORT_BILTIN_TIME
304 bool " Support time service"
306 depends on BUSYBOX_CONFIG_INETD
308 Return 32 bit time since 1900 internal inetd service
310 config BUSYBOX_CONFIG_FEATURE_INETD_SUPPORT_BILTIN_DAYTIME
311 bool " Support daytime service"
313 depends on BUSYBOX_CONFIG_INETD
315 Return human-readable time internal inetd service
317 config BUSYBOX_CONFIG_FEATURE_INETD_SUPPORT_BILTIN_CHARGEN
318 bool " Support chargen service"
320 depends on BUSYBOX_CONFIG_INETD
322 Familiar character generator internal inetd service
324 config BUSYBOX_CONFIG_FEATURE_INETD_RPC
325 bool " Support RPC services"
327 depends on BUSYBOX_CONFIG_INETD
329 Suuport Sun-RPC based services
332 config BUSYBOX_CONFIG_IP
336 The "ip" applet is a TCP/IP interface configuration and routing
337 utility. You generally don't need "ip" to use busybox with
340 if BUSYBOX_CONFIG_IP && BUSYBOX_CONFIG_IPADDR
341 config BUSYBOX_CONFIG_FEATURE_IP_ADDRESS
343 comment " address (forced enabled for ipaddr)"
345 if ! (CONFIG_IP && BUSYBOX_CONFIG_IPADDR)
346 config BUSYBOX_CONFIG_FEATURE_IP_ADDRESS
349 depends on BUSYBOX_CONFIG_IP
351 Address manipulation support for the "ip" applet.
354 if BUSYBOX_CONFIG_IP && BUSYBOX_CONFIG_IPLINK
355 config BUSYBOX_CONFIG_FEATURE_IP_LINK
357 comment " link (forced enabled for iplink)"
359 if !(CONFIG_IP && BUSYBOX_CONFIG_IPLINK)
360 config BUSYBOX_CONFIG_FEATURE_IP_LINK
363 depends on BUSYBOX_CONFIG_IP
365 Configure network devices with "ip".
368 if BUSYBOX_CONFIG_IP && BUSYBOX_CONFIG_IPROUTE
369 config BUSYBOX_CONFIG_FEATURE_IP_ROUTE
371 comment " route (forced enabled for iproute)"
373 if !(CONFIG_IP && BUSYBOX_CONFIG_IPROUTE)
374 config BUSYBOX_CONFIG_FEATURE_IP_ROUTE
377 depends on BUSYBOX_CONFIG_IP
379 Add support for routing table management to "ip".
382 if BUSYBOX_CONFIG_IP && BUSYBOX_CONFIG_IPTUNNEL
383 config BUSYBOX_CONFIG_FEATURE_IP_TUNNEL
385 comment " tunnel (forced enabled for iptunnel)"
387 if !(CONFIG_IP && BUSYBOX_CONFIG_IPTUNNEL)
388 config BUSYBOX_CONFIG_FEATURE_IP_TUNNEL
391 depends on BUSYBOX_CONFIG_IP
393 Add support for tunneling commands to "ip".
396 config BUSYBOX_CONFIG_IPCALC
400 ipcalc takes an IP address and netmask and calculates the
401 resulting broadcast, network, and host range.
403 config BUSYBOX_CONFIG_FEATURE_IPCALC_FANCY
404 bool " Fancy IPCALC, more options, adds 1 kbyte"
406 depends on BUSYBOX_CONFIG_IPCALC
408 Adds the options hostname, prefix and silent to the output of "ipcalc".
410 config BUSYBOX_CONFIG_IPADDR
414 Equivalent to selecting address support to "ip", above.
416 config BUSYBOX_CONFIG_IPLINK
420 Equivalent to selecting link support to "ip", above.
422 config BUSYBOX_CONFIG_IPROUTE
426 Equivalent to selecting route support to "ip", above.
428 config BUSYBOX_CONFIG_IPTUNNEL
432 Equivalent to selecting tunnel support to "ip", above.
434 config BUSYBOX_CONFIG_NAMEIF
438 nameif is used to rename network interface by its MAC address.
439 Renamed interfaces MUST be in the down state.
440 It is possible to use a file (default: /etc/mactab)
441 with list of new interface names and MACs.
442 Maximum interface name length: IF_NAMESIZE = 16
443 File fields are separated by space or tab.
446 new_interface_name XX:XX:XX:XX:XX:XX
448 config BUSYBOX_CONFIG_NC
452 A simple Unix utility which reads and writes data across network
455 config BUSYBOX_CONFIG_NETMSG
459 simple program for sending udp broadcast messages
461 config BUSYBOX_CONFIG_NC_GAPING_SECURITY_HOLE
462 bool "gaping security hole"
464 depends on BUSYBOX_CONFIG_NC
466 Add support for executing a program after making or receiving a
467 successful connection (-e option).
469 config BUSYBOX_CONFIG_NETSTAT
473 netstat prints information about the Linux networking subsystem.
475 config BUSYBOX_CONFIG_NSLOOKUP
479 nslookup is a tool to query Internet name servers.
481 config BUSYBOX_CONFIG_PING
485 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
486 elicit an ICMP ECHO_RESPONSE from a host or gateway.
488 config BUSYBOX_CONFIG_FEATURE_FANCY_PING
489 bool " Enable fancy ping output"
491 depends on BUSYBOX_CONFIG_PING
493 Make the output from the ping applet include statistics, and at the
494 same time provide full support for ICMP packets.
496 config BUSYBOX_CONFIG_PING6
499 depends on BUSYBOX_CONFIG_FEATURE_IPV6
501 This will give you a ping that can talk IPv6.
503 config BUSYBOX_CONFIG_FEATURE_FANCY_PING6
504 bool " Enable fancy ping6 output"
506 depends on BUSYBOX_CONFIG_PING6
508 Make the output from the ping6 applet include statistics, and at the
509 same time provide full support for ICMP packets.
511 config BUSYBOX_CONFIG_ROUTE
515 Route displays or manipulates the kernel's IP routing tables.
517 config BUSYBOX_CONFIG_TELNET
521 Telnet is an interface to the TELNET protocol, but is also commonly
522 used to test other simple protocols.
524 config BUSYBOX_CONFIG_FEATURE_TELNET_TTYPE
525 bool " Pass TERM type to remote host"
527 depends on BUSYBOX_CONFIG_TELNET
529 Setting this option will forward the TERM environment variable to the
530 remote host you are connecting to. This is useful to make sure that
531 things like ANSI colors and other control sequences behave.
533 config BUSYBOX_CONFIG_FEATURE_TELNET_AUTOLOGIN
534 bool " Pass USER type to remote host"
536 depends on BUSYBOX_CONFIG_TELNET
538 Setting this option will forward the USER environment variable to the
539 remote host you are connecting to. This is useful when you need to
540 log into a machine without telling the username (autologin). This
541 option enables `-a' and `-l USER' arguments.
543 config BUSYBOX_CONFIG_TELNETD
547 A daemon for the TELNET protocol, allowing you to log onto the host
548 running the daemon. Please keep in mind that the TELNET protocol
549 sends passwords in plain text. If you can't afford the space for an
550 SSH daemon and you trust your network, you may say 'y' here. As a
551 more secure alternative, you should seriously consider installing the
552 very small Dropbear SSH daemon instead:
553 http://matt.ucc.asn.au/dropbear/dropbear.html
555 Note that for busybox telnetd to work you need several things:
556 First of all, your kernel needs:
557 BUSYBOX_CONFIG_UNIX98_PTYS=y
558 BUSYBOX_CONFIG_DEVPTS_FS=y
560 Next, you need a /dev/pts directory on your root filesystem:
563 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
565 Next you need the pseudo terminal master multiplexer /dev/ptmx:
568 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
570 Any /dev/ttyp[0-9]* files you may have can be removed.
571 Next, you need to mount the devpts filesystem on /dev/pts using:
573 mount -t devpts devpts /dev/pts
575 You need to be sure that Busybox has BUSYBOX_CONFIG_LOGIN and
576 BUSYBOX_CONFIG_FEATURE_SUID enabled. And finally, you should make
577 certain that Busybox has been installed setuid root:
579 chown root.root /bin/busybox
580 chmod 4755 /bin/busybox
582 with all that done, telnetd _should_ work....
585 config BUSYBOX_CONFIG_FEATURE_TELNETD_INETD
586 bool " Support call from inetd only"
588 depends on BUSYBOX_CONFIG_TELNETD
590 Selecting this will make telnetd only callable from inetd,
591 removing the standalone support.
593 config BUSYBOX_CONFIG_TFTP
597 This enables the Trivial File Transfer Protocol client program. TFTP
598 is usually used for simple, small transfers such as a root image
599 for a network-enabled bootloader.
601 config BUSYBOX_CONFIG_FEATURE_TFTP_GET
602 bool " Enable \"get\" command"
604 depends on BUSYBOX_CONFIG_TFTP
606 Add support for the GET command within the TFTP client. This allows
607 a client to retrieve a file from a TFTP server.
609 config BUSYBOX_CONFIG_FEATURE_TFTP_PUT
610 bool " Enable \"put\" command"
612 depends on BUSYBOX_CONFIG_TFTP
614 Add support for the PUT command within the TFTP client. This allows
615 a client to transfer a file to a TFTP server.
617 config BUSYBOX_CONFIG_FEATURE_TFTP_BLOCKSIZE
618 bool " Enable \"blocksize\" command"
620 depends on BUSYBOX_CONFIG_TFTP
622 Allow the client to specify the desired block size for transfers.
624 config BUSYBOX_CONFIG_FEATURE_TFTP_DEBUG
627 depends on BUSYBOX_CONFIG_TFTP
629 Enable debug settings for tftp. This is useful if you're running
630 into problems with tftp as the protocol doesn't help you much when
631 you run into problems.
633 config BUSYBOX_CONFIG_TRACEROUTE
637 Utility to trace the route of IP packets
639 config BUSYBOX_CONFIG_FEATURE_TRACEROUTE_VERBOSE
640 bool " Enable verbose output"
642 depends on BUSYBOX_CONFIG_TRACEROUTE
644 Add some verbosity to traceroute. This includes amongst other things
645 hostnames and ICMP response types.
647 config BUSYBOX_CONFIG_FEATURE_TRACEROUTE_SOURCE_ROUTE
648 bool " Enable loose source route"
650 depends on BUSYBOX_CONFIG_TRACEROUTE
652 Add option to specify a loose source route gateway
655 config BUSYBOX_CONFIG_FEATURE_TRACEROUTE_USE_ICMP
656 bool " Use ICMP instead of UDP"
658 depends on BUSYBOX_CONFIG_TRACEROUTE
660 Add feature to allow for ICMP ECHO instead of UDP datagrams.
663 config BUSYBOX_CONFIG_VCONFIG
667 Creates, removes, and configures VLAN interfaces
669 config BUSYBOX_CONFIG_WGET
673 wget is a utility for non-interactive download of files from HTTP,
674 HTTPS, and FTP servers.
676 config BUSYBOX_CONFIG_FEATURE_WGET_STATUSBAR
677 bool " Enable a nifty process meter (+2k)"
679 depends on BUSYBOX_CONFIG_WGET
681 Enable the transfer progress bar for wget transfers.
683 config BUSYBOX_CONFIG_FEATURE_WGET_AUTHENTICATION
684 bool " Enable HTTP authentication"
686 depends on BUSYBOX_CONFIG_WGET
688 Support authenticated HTTP transfers.
690 config BUSYBOX_CONFIG_FEATURE_WGET_IP6_LITERAL
691 bool " Enable IPv6 literal addresses"
693 depends on BUSYBOX_CONFIG_WGET
695 Support IPv6 address literal notation in URLs.
697 source package/busybox/config/networking/udhcp/Config.in
699 config BUSYBOX_CONFIG_ZCIP
703 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
704 It's a daemon that allocates and defends a dynamically assigned
705 address on the 169.254/16 network, requiring no system administrator.
707 See http://www.zeroconf.org for further details, and "zcip.script"
708 in the busybox examples.