2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Networking Utilities"
9 bool "Enable IPv6 support"
12 Enable IPv6 support in busybox.
13 This adds IPv6 support in the networking applets.
15 config VERBOSE_RESOLUTION_ERRORS
16 bool "Verbose resolution errors"
19 Enable if you are not satisfied with simplistic
20 "can't resolve 'hostname.com'" and want to know more.
21 This may increase size of your executable a bit.
27 Manipulate the system ARP cache.
33 Ping hosts by ARP packets.
39 Small and static DNS server daemon.
45 Send a magic packet to wake up sleeping machines.
52 fakeidentd listens on the ident port and returns a predefined
53 fake value on any query.
59 Retrieve a remote file via FTP.
65 Store a remote file via FTP.
67 config FEATURE_FTPGETPUT_LONG_OPTIONS
68 bool "Enable long options in ftpget/ftpput"
70 depends on GETOPT_LONG && (FTPGET || FTPPUT)
72 Support long options for the ftpget/ftpput applet.
78 Show or set the system's host name.
84 Serve web pages via an HTTP server.
86 config FEATURE_HTTPD_USE_SENDFILE
87 bool "Use sendfile system call"
91 When enabled, httpd will use the kernel sendfile() function
92 instead of read/write loop.
94 config FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
95 bool "Support reloading the global config file using hup signal"
99 This option enables processing of SIGHUP to reload cached
100 configuration settings.
102 config FEATURE_HTTPD_SETUID
103 bool "Enable -u <user> option"
107 This option allows the server to run as a specific user
108 rather than defaulting to the user that starts the server.
109 Use of this option requires special privileges to change to a
112 config FEATURE_HTTPD_BASIC_AUTH
113 bool "Enable Basic http Authentication"
117 Utilizes password settings from /etc/httpd.conf for basic
118 authentication on a per url basis.
120 config FEATURE_HTTPD_AUTH_MD5
121 bool "Support MD5 crypted passwords for http Authentication"
123 depends on FEATURE_HTTPD_BASIC_AUTH
125 Enables basic per URL authentication from /etc/httpd.conf
128 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
129 bool "Support loading additional MIME types at run-time"
133 This option enables support for additional MIME types at
134 run-time to be specified in the configuration file.
136 config FEATURE_HTTPD_CGI
137 bool "Support Common Gateway Interface (CGI)"
141 This option allows scripts and executables to be invoked
142 when specific URLs are requested.
144 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
145 bool "Enable support for running scripts through an interpreter"
147 depends on FEATURE_HTTPD_CGI
149 This option enables support for running scripts through an
150 interpreter. Turn this on if you want PHP scripts to work
151 properly. You need to supply an additional line in your httpd
153 *.php:/path/to/your/php
155 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
156 bool "Support the REMOTE_PORT environment variable for CGI"
158 depends on FEATURE_HTTPD_CGI
160 Use of this option can assist scripts in generating
161 references that contain a unique port number.
163 config FEATURE_HTTPD_ENCODE_URL_STR
164 bool "Enable the -e option for shell script CGI simplification."
168 This option allows html encoding arbitrary
169 strings for display of the browser. Output goes to stdout.
170 For example, httpd -e "<Hello World>" as
171 "<Hello World>".
173 config FEATURE_HTTPD_ERROR_PAGES
174 bool "Enable support for custom error pages"
178 This option allows you to define custom error pages in
179 the configuration file instead of the default HTTP status
180 error pages. For instance, if you add the line:
182 in the config file, the server will respond the specified
183 '/path/e404.html' file instead of the terse '404 NOT FOUND'
190 Ifconfig is used to configure the kernel-resident network interfaces.
192 config FEATURE_IFCONFIG_STATUS
193 bool "Enable status reporting output (+7k)"
197 If ifconfig is called with no arguments it will display the status
198 of the currently active interfaces.
200 config FEATURE_IFCONFIG_SLIP
201 bool "Enable slip-specific options \"keepalive\" and \"outfill\""
205 Allow "keepalive" and "outfill" support for SLIP. If you're not
206 planning on using serial lines, leave this unchecked.
208 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
209 bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
213 Allow the start address for shared memory, start address for I/O,
214 and/or the interrupt line used by the specified device.
216 config FEATURE_IFCONFIG_HW
217 bool "Enable option \"hw\" (ether only)"
221 Set the hardware address of this interface, if the device driver
222 supports this operation. Currently, we only support the 'ether'
225 config FEATURE_IFCONFIG_BROADCAST_PLUS
226 bool "Set the broadcast automatically"
230 Setting this will make ifconfig attempt to find the broadcast
231 automatically if the value '+' is used.
237 Activate or deactivate the specified interfaces. This applet makes
238 use of either "ifconfig" and "route" or the "ip" command to actually
239 configure network interfaces. Therefore, you will probably also want
240 to enable either IFCONFIG and ROUTE, or enable
241 FEATURE_IFUPDOWN_IP and the various IP options. Of
242 course you could use non-busybox versions of these programs, so
243 against my better judgement (since this will surely result in plenty
244 of support questions on the mailing list), I do not force you to
245 enable these additional options. It is up to you to supply either
246 "ifconfig", "route" and "run-parts" or the "ip" command, either
247 via busybox or via standalone utilities.
249 config IFUPDOWN_IFSTATE_PATH
250 string "Absolute path to ifstate file"
251 default "/var/run/ifstate"
253 ifupdown keeps state information in a file called ifstate.
254 Typically it is located in /var/run/ifstate, however
255 some distributions tend to put it in other places
256 (debian, for example, uses /etc/network/run/ifstate).
257 This config option defines location of ifstate.
259 config FEATURE_IFUPDOWN_IP
264 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
265 than the default of using the older 'ifconfig' and 'route' utilities.
267 config FEATURE_IFUPDOWN_IP_BUILTIN
268 bool "Use busybox ip applet"
270 depends on FEATURE_IFUPDOWN_IP
272 select FEATURE_IP_ADDRESS
273 select FEATURE_IP_LINK
274 select FEATURE_IP_ROUTE
276 Use the busybox iproute "ip" applet to implement "ifupdown".
278 If left disabled, you must install the full-blown iproute2
279 utility or the "ifup" and "ifdown" applets will not work.
281 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
282 bool "Use busybox ifconfig and route applets"
284 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
288 Use the busybox iproute "ifconfig" and "route" applets to
289 implement the "ifup" and "ifdown" utilities.
291 If left disabled, you must install the full-blown ifconfig
292 and route utilities, or the "ifup" and "ifdown" applets will not
295 config FEATURE_IFUPDOWN_IPV4
296 bool "Enable support for IPv4"
300 If you want ifup/ifdown to talk IPv4, leave this on.
302 config FEATURE_IFUPDOWN_IPV6
303 bool "Enable support for IPv6"
305 depends on IFUPDOWN && FEATURE_IPV6
307 If you need support for IPv6, turn this option on.
310 ### config FEATURE_IFUPDOWN_IPX
311 ### bool "Enable support for IPX"
313 ### depends on IFUPDOWN
315 ### If this option is selected you can use busybox to work with IPX
318 config FEATURE_IFUPDOWN_MAPPING
319 bool "Enable mapping support"
323 This enables support for the "mapping" stanza, unless you have
324 a weird network setup you don't need it.
326 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
327 bool "Enable support for external dhcp clients"
331 This enables support for the external dhcp clients. Clients are
332 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
333 Otherwise, if udhcpc applet is enabled, it is used.
334 Otherwise, ifup/ifdown will have no support for DHCP.
339 select FEATURE_SYSLOG
341 Internet superserver daemon
343 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
344 bool "Support echo service"
348 Echo received data internal inetd service
350 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
351 bool "Support discard service"
355 Internet /dev/null internal inetd service
357 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
358 bool "Support time service"
362 Return 32 bit time since 1900 internal inetd service
364 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
365 bool "Support daytime service"
369 Return human-readable time internal inetd service
371 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
372 bool "Support chargen service"
376 Familiar character generator internal inetd service
378 config FEATURE_INETD_RPC
379 bool "Support RPC services"
382 select FEATURE_HAVE_RPC
384 Support Sun-RPC based services
390 The "ip" applet is a TCP/IP interface configuration and routing
391 utility. You generally don't need "ip" to use busybox with
394 config FEATURE_IP_ADDRESS
399 Address manipulation support for the "ip" applet.
401 config FEATURE_IP_LINK
406 Configure network devices with "ip".
408 config FEATURE_IP_ROUTE
413 Add support for routing table management to "ip".
415 config FEATURE_IP_TUNNEL
420 Add support for tunneling commands to "ip".
422 config FEATURE_IP_RULE
427 Add support for rule commands to "ip".
429 config FEATURE_IP_SHORT_FORMS
430 bool "Support short forms of ip commands."
434 Also support short-form of ip <OBJECT> commands:
438 ip tunnel -> iptunnel
441 Say N unless you desparately need the short form of the ip
447 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
452 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
457 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
462 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
467 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
473 ipcalc takes an IP address and netmask and calculates the
474 resulting broadcast, network, and host range.
476 config FEATURE_IPCALC_FANCY
477 bool "Fancy IPCALC, more options, adds 1 kbyte"
481 Adds the options hostname, prefix and silent to the output of "ipcalc".
483 config FEATURE_IPCALC_LONG_OPTIONS
484 bool "Enable long options"
486 depends on IPCALC && GETOPT_LONG
488 Support long options for the ipcalc applet.
493 select FEATURE_SYSLOG
495 nameif is used to rename network interface by its MAC address.
496 Renamed interfaces MUST be in the down state.
497 It is possible to use a file (default: /etc/mactab)
498 with list of new interface names and MACs.
499 Maximum interface name length: IF_NAMESIZE = 16
500 File fields are separated by space or tab.
503 new_interface_name XX:XX:XX:XX:XX:XX
509 A simple Unix utility which reads and writes data across network
513 bool "Netcat server options (-l)"
517 Allow netcat to act as a server.
520 bool "Netcat extensions (-eiw and filename)"
524 Add -e (support for executing the rest of the command line after
525 making or receiving a successful connection), -i (delay interval for
526 lines sent), -w (timeout for initial connection).
532 netstat prints information about the Linux networking subsystem.
534 config FEATURE_NETSTAT_WIDE
535 bool " Enable wide netstat output"
539 Add support for wide columns. Useful when displaying IPv6 addresses
546 nslookup is a tool to query Internet name servers.
552 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
553 elicit an ICMP ECHO_RESPONSE from a host or gateway.
558 depends on FEATURE_IPV6 && PING
560 This will give you a ping that can talk IPv6.
566 Simple network port scanner.
568 config FEATURE_FANCY_PING
569 bool "Enable fancy ping output"
573 Make the output from the ping applet include statistics, and at the
574 same time provide full support for ICMP packets.
580 Route displays or manipulates the kernel's IP routing tables.
586 slattach is a small utility to attach network interfaces to serial lines.
592 Telnet is an interface to the TELNET protocol, but is also commonly
593 used to test other simple protocols.
595 config FEATURE_TELNET_TTYPE
596 bool "Pass TERM type to remote host"
600 Setting this option will forward the TERM environment variable to the
601 remote host you are connecting to. This is useful to make sure that
602 things like ANSI colors and other control sequences behave.
604 config FEATURE_TELNET_AUTOLOGIN
605 bool "Pass USER type to remote host"
609 Setting this option will forward the USER environment variable to the
610 remote host you are connecting to. This is useful when you need to
611 log into a machine without telling the username (autologin). This
612 option enables `-a' and `-l USER' arguments.
617 select FEATURE_SYSLOG
619 A daemon for the TELNET protocol, allowing you to log onto the host
620 running the daemon. Please keep in mind that the TELNET protocol
621 sends passwords in plain text. If you can't afford the space for an
622 SSH daemon and you trust your network, you may say 'y' here. As a
623 more secure alternative, you should seriously consider installing the
624 very small Dropbear SSH daemon instead:
625 http://matt.ucc.asn.au/dropbear/dropbear.html
627 Note that for busybox telnetd to work you need several things:
628 First of all, your kernel needs:
632 Next, you need a /dev/pts directory on your root filesystem:
635 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
637 Next you need the pseudo terminal master multiplexer /dev/ptmx:
640 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
642 Any /dev/ttyp[0-9]* files you may have can be removed.
643 Next, you need to mount the devpts filesystem on /dev/pts using:
645 mount -t devpts devpts /dev/pts
647 You need to be sure that Busybox has LOGIN and
648 FEATURE_SUID enabled. And finally, you should make
649 certain that Busybox has been installed setuid root:
651 chown root.root /bin/busybox
652 chmod 4755 /bin/busybox
654 with all that done, telnetd _should_ work....
657 config FEATURE_TELNETD_STANDALONE
658 bool "Support standalone telnetd (not inetd only)"
662 Selecting this will make telnetd able to run standalone.
668 This enables the Trivial File Transfer Protocol client program. TFTP
669 is usually used for simple, small transfers such as a root image
670 for a network-enabled bootloader.
672 config FEATURE_TFTP_GET
673 bool "Enable \"get\" command"
677 Add support for the GET command within the TFTP client. This allows
678 a client to retrieve a file from a TFTP server.
680 config FEATURE_TFTP_PUT
681 bool "Enable \"put\" command"
685 Add support for the PUT command within the TFTP client. This allows
686 a client to transfer a file to a TFTP server.
688 config FEATURE_TFTP_BLOCKSIZE
689 bool "Enable \"blocksize\" command"
693 Allow the client to specify the desired block size for transfers.
700 Enable debug settings for tftp. This is useful if you're running
701 into problems with tftp as the protocol doesn't help you much when
702 you run into problems.
708 Utility to trace the route of IP packets
710 config FEATURE_TRACEROUTE_VERBOSE
711 bool "Enable verbose output"
713 depends on TRACEROUTE
715 Add some verbosity to traceroute. This includes amongst other things
716 hostnames and ICMP response types.
718 config FEATURE_TRACEROUTE_SOURCE_ROUTE
719 bool "Enable loose source route"
721 depends on TRACEROUTE
723 Add option to specify a loose source route gateway
726 config FEATURE_TRACEROUTE_USE_ICMP
727 bool "Use ICMP instead of UDP"
729 depends on TRACEROUTE
731 Add feature to allow for ICMP ECHO instead of UDP datagrams.
733 source networking/udhcp/Config.in
739 Creates, removes, and configures VLAN interfaces
745 wget is a utility for non-interactive download of files from HTTP,
746 HTTPS, and FTP servers.
748 config FEATURE_WGET_STATUSBAR
749 bool "Enable a nifty process meter (+2k)"
753 Enable the transfer progress bar for wget transfers.
755 config FEATURE_WGET_AUTHENTICATION
756 bool "Enable HTTP authentication"
760 Support authenticated HTTP transfers.
762 config FEATURE_WGET_LONG_OPTIONS
763 bool "Enable long options"
765 depends on WGET && GETOPT_LONG
767 Support long options for the wget applet.
772 select FEATURE_SYSLOG
774 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
775 It's a daemon that allocates and defends a dynamically assigned
776 address on the 169.254/16 network, requiring no system administrator.
778 See http://www.zeroconf.org for further details, and "zcip.script"
779 in the busybox examples.