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_RANGES
87 bool "Support 'Ranges:' header"
91 Makes httpd emit "Accept-Ranges: bytes" header and understand
92 "Range: bytes=NNN-[MMM]" header. Allows for resuming interrupted
93 downloads, seeking in multimedia players etc.
95 config FEATURE_HTTPD_USE_SENDFILE
96 bool "Use sendfile system call"
100 When enabled, httpd will use the kernel sendfile() function
101 instead of read/write loop.
103 config FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
104 bool "Support reloading the global config file using hup signal"
108 This option enables processing of SIGHUP to reload cached
109 configuration settings.
111 config FEATURE_HTTPD_SETUID
112 bool "Enable -u <user> option"
116 This option allows the server to run as a specific user
117 rather than defaulting to the user that starts the server.
118 Use of this option requires special privileges to change to a
121 config FEATURE_HTTPD_BASIC_AUTH
122 bool "Enable Basic http Authentication"
126 Utilizes password settings from /etc/httpd.conf for basic
127 authentication on a per url basis.
129 config FEATURE_HTTPD_AUTH_MD5
130 bool "Support MD5 crypted passwords for http Authentication"
132 depends on FEATURE_HTTPD_BASIC_AUTH
134 Enables basic per URL authentication from /etc/httpd.conf
137 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
138 bool "Support loading additional MIME types at run-time"
142 This option enables support for additional MIME types at
143 run-time to be specified in the configuration file.
145 config FEATURE_HTTPD_CGI
146 bool "Support Common Gateway Interface (CGI)"
150 This option allows scripts and executables to be invoked
151 when specific URLs are requested.
153 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
154 bool "Enable support for running scripts through an interpreter"
156 depends on FEATURE_HTTPD_CGI
158 This option enables support for running scripts through an
159 interpreter. Turn this on if you want PHP scripts to work
160 properly. You need to supply an additional line in your httpd
162 *.php:/path/to/your/php
164 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
165 bool "Support the REMOTE_PORT environment variable for CGI"
167 depends on FEATURE_HTTPD_CGI
169 Use of this option can assist scripts in generating
170 references that contain a unique port number.
172 config FEATURE_HTTPD_ENCODE_URL_STR
173 bool "Enable the -e option for shell script CGI simplification."
177 This option allows html encoding arbitrary
178 strings for display of the browser. Output goes to stdout.
179 For example, httpd -e "<Hello World>" as
180 "<Hello World>".
182 config FEATURE_HTTPD_ERROR_PAGES
183 bool "Enable support for custom error pages"
187 This option allows you to define custom error pages in
188 the configuration file instead of the default HTTP status
189 error pages. For instance, if you add the line:
191 in the config file, the server will respond the specified
192 '/path/e404.html' file instead of the terse '404 NOT FOUND'
195 config FEATURE_HTTPD_PROXY
196 bool "Enable support for reverse proxy"
200 This option allows you to define URLs that will be forwarded
201 to another HTTP server. To setup add the following line to the
203 P:/url/:http://hostname[:port]/new/path/
204 Then a request to /url/myfile will be forwarded to
205 http://hostname[:port]/new/path/myfile.
211 Ifconfig is used to configure the kernel-resident network interfaces.
213 config FEATURE_IFCONFIG_STATUS
214 bool "Enable status reporting output (+7k)"
218 If ifconfig is called with no arguments it will display the status
219 of the currently active interfaces.
221 config FEATURE_IFCONFIG_SLIP
222 bool "Enable slip-specific options \"keepalive\" and \"outfill\""
226 Allow "keepalive" and "outfill" support for SLIP. If you're not
227 planning on using serial lines, leave this unchecked.
229 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
230 bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
234 Allow the start address for shared memory, start address for I/O,
235 and/or the interrupt line used by the specified device.
237 config FEATURE_IFCONFIG_HW
238 bool "Enable option \"hw\" (ether only)"
242 Set the hardware address of this interface, if the device driver
243 supports this operation. Currently, we only support the 'ether'
246 config FEATURE_IFCONFIG_BROADCAST_PLUS
247 bool "Set the broadcast automatically"
251 Setting this will make ifconfig attempt to find the broadcast
252 automatically if the value '+' is used.
258 Activate or deactivate the specified interfaces. This applet makes
259 use of either "ifconfig" and "route" or the "ip" command to actually
260 configure network interfaces. Therefore, you will probably also want
261 to enable either IFCONFIG and ROUTE, or enable
262 FEATURE_IFUPDOWN_IP and the various IP options. Of
263 course you could use non-busybox versions of these programs, so
264 against my better judgement (since this will surely result in plenty
265 of support questions on the mailing list), I do not force you to
266 enable these additional options. It is up to you to supply either
267 "ifconfig", "route" and "run-parts" or the "ip" command, either
268 via busybox or via standalone utilities.
270 config IFUPDOWN_IFSTATE_PATH
271 string "Absolute path to ifstate file"
272 default "/var/run/ifstate"
275 ifupdown keeps state information in a file called ifstate.
276 Typically it is located in /var/run/ifstate, however
277 some distributions tend to put it in other places
278 (debian, for example, uses /etc/network/run/ifstate).
279 This config option defines location of ifstate.
281 config FEATURE_IFUPDOWN_IP
286 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
287 than the default of using the older 'ifconfig' and 'route' utilities.
289 config FEATURE_IFUPDOWN_IP_BUILTIN
290 bool "Use busybox ip applet"
292 depends on FEATURE_IFUPDOWN_IP
294 select FEATURE_IP_ADDRESS
295 select FEATURE_IP_LINK
296 select FEATURE_IP_ROUTE
298 Use the busybox iproute "ip" applet to implement "ifupdown".
300 If left disabled, you must install the full-blown iproute2
301 utility or the "ifup" and "ifdown" applets will not work.
303 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
304 bool "Use busybox ifconfig and route applets"
306 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
310 Use the busybox iproute "ifconfig" and "route" applets to
311 implement the "ifup" and "ifdown" utilities.
313 If left disabled, you must install the full-blown ifconfig
314 and route utilities, or the "ifup" and "ifdown" applets will not
317 config FEATURE_IFUPDOWN_IPV4
318 bool "Enable support for IPv4"
322 If you want ifup/ifdown to talk IPv4, leave this on.
324 config FEATURE_IFUPDOWN_IPV6
325 bool "Enable support for IPv6"
327 depends on IFUPDOWN && FEATURE_IPV6
329 If you need support for IPv6, turn this option on.
332 ### config FEATURE_IFUPDOWN_IPX
333 ### bool "Enable support for IPX"
335 ### depends on IFUPDOWN
337 ### If this option is selected you can use busybox to work with IPX
340 config FEATURE_IFUPDOWN_MAPPING
341 bool "Enable mapping support"
345 This enables support for the "mapping" stanza, unless you have
346 a weird network setup you don't need it.
348 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
349 bool "Enable support for external dhcp clients"
353 This enables support for the external dhcp clients. Clients are
354 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
355 Otherwise, if udhcpc applet is enabled, it is used.
356 Otherwise, ifup/ifdown will have no support for DHCP.
361 select FEATURE_SYSLOG
363 Internet superserver daemon
365 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
366 bool "Support echo service"
370 Echo received data internal inetd service
372 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
373 bool "Support discard service"
377 Internet /dev/null internal inetd service
379 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
380 bool "Support time service"
384 Return 32 bit time since 1900 internal inetd service
386 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
387 bool "Support daytime service"
391 Return human-readable time internal inetd service
393 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
394 bool "Support chargen service"
398 Familiar character generator internal inetd service
400 config FEATURE_INETD_RPC
401 bool "Support RPC services"
404 select FEATURE_HAVE_RPC
406 Support Sun-RPC based services
412 The "ip" applet is a TCP/IP interface configuration and routing
413 utility. You generally don't need "ip" to use busybox with
416 config FEATURE_IP_ADDRESS
421 Address manipulation support for the "ip" applet.
423 config FEATURE_IP_LINK
428 Configure network devices with "ip".
430 config FEATURE_IP_ROUTE
435 Add support for routing table management to "ip".
437 config FEATURE_IP_TUNNEL
442 Add support for tunneling commands to "ip".
444 config FEATURE_IP_RULE
449 Add support for rule commands to "ip".
451 config FEATURE_IP_SHORT_FORMS
452 bool "Support short forms of ip commands."
456 Also support short-form of ip <OBJECT> commands:
460 ip tunnel -> iptunnel
463 Say N unless you desparately need the short form of the ip
466 config FEATURE_IP_RARE_PROTOCOLS
467 bool "Suport display of rarely-used link types."
471 If you are not going to use links of type "frad", "econet",
472 "bif" etc, you probably don't need to enable this.
473 Ethernet, wireless, infrared, ppp/slip, ip tunnelling
474 link types are supported without this option selected.
479 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
484 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
489 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
494 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
499 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
505 ipcalc takes an IP address and netmask and calculates the
506 resulting broadcast, network, and host range.
508 config FEATURE_IPCALC_FANCY
509 bool "Fancy IPCALC, more options, adds 1 kbyte"
513 Adds the options hostname, prefix and silent to the output of "ipcalc".
515 config FEATURE_IPCALC_LONG_OPTIONS
516 bool "Enable long options"
518 depends on IPCALC && GETOPT_LONG
520 Support long options for the ipcalc applet.
525 select FEATURE_SYSLOG
527 nameif is used to rename network interface by its MAC address.
528 Renamed interfaces MUST be in the down state.
529 It is possible to use a file (default: /etc/mactab)
530 with list of new interface names and MACs.
531 Maximum interface name length: IF_NAMESIZE = 16
532 File fields are separated by space or tab.
535 new_interface_name XX:XX:XX:XX:XX:XX
541 A simple Unix utility which reads and writes data across network
545 bool "Netcat server options (-l)"
549 Allow netcat to act as a server.
552 bool "Netcat extensions (-eiw and filename)"
556 Add -e (support for executing the rest of the command line after
557 making or receiving a successful connection), -i (delay interval for
558 lines sent), -w (timeout for initial connection).
564 netstat prints information about the Linux networking subsystem.
566 config FEATURE_NETSTAT_WIDE
567 bool " Enable wide netstat output"
571 Add support for wide columns. Useful when displaying IPv6 addresses
578 nslookup is a tool to query Internet name servers.
584 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
585 elicit an ICMP ECHO_RESPONSE from a host or gateway.
590 depends on FEATURE_IPV6 && PING
592 This will give you a ping that can talk IPv6.
598 Simple network port scanner.
600 config FEATURE_FANCY_PING
601 bool "Enable fancy ping output"
605 Make the output from the ping applet include statistics, and at the
606 same time provide full support for ICMP packets.
612 Route displays or manipulates the kernel's IP routing tables.
618 slattach is a small utility to attach network interfaces to serial lines.
624 Telnet is an interface to the TELNET protocol, but is also commonly
625 used to test other simple protocols.
627 config FEATURE_TELNET_TTYPE
628 bool "Pass TERM type to remote host"
632 Setting this option will forward the TERM environment variable to the
633 remote host you are connecting to. This is useful to make sure that
634 things like ANSI colors and other control sequences behave.
636 config FEATURE_TELNET_AUTOLOGIN
637 bool "Pass USER type to remote host"
641 Setting this option will forward the USER environment variable to the
642 remote host you are connecting to. This is useful when you need to
643 log into a machine without telling the username (autologin). This
644 option enables `-a' and `-l USER' arguments.
649 select FEATURE_SYSLOG
651 A daemon for the TELNET protocol, allowing you to log onto the host
652 running the daemon. Please keep in mind that the TELNET protocol
653 sends passwords in plain text. If you can't afford the space for an
654 SSH daemon and you trust your network, you may say 'y' here. As a
655 more secure alternative, you should seriously consider installing the
656 very small Dropbear SSH daemon instead:
657 http://matt.ucc.asn.au/dropbear/dropbear.html
659 Note that for busybox telnetd to work you need several things:
660 First of all, your kernel needs:
664 Next, you need a /dev/pts directory on your root filesystem:
667 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
669 Next you need the pseudo terminal master multiplexer /dev/ptmx:
672 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
674 Any /dev/ttyp[0-9]* files you may have can be removed.
675 Next, you need to mount the devpts filesystem on /dev/pts using:
677 mount -t devpts devpts /dev/pts
679 You need to be sure that Busybox has LOGIN and
680 FEATURE_SUID enabled. And finally, you should make
681 certain that Busybox has been installed setuid root:
683 chown root.root /bin/busybox
684 chmod 4755 /bin/busybox
686 with all that done, telnetd _should_ work....
689 config FEATURE_TELNETD_STANDALONE
690 bool "Support standalone telnetd (not inetd only)"
694 Selecting this will make telnetd able to run standalone.
700 This enables the Trivial File Transfer Protocol client program. TFTP
701 is usually used for simple, small transfers such as a root image
702 for a network-enabled bootloader.
704 config FEATURE_TFTP_GET
705 bool "Enable \"get\" command"
709 Add support for the GET command within the TFTP client. This allows
710 a client to retrieve a file from a TFTP server.
712 config FEATURE_TFTP_PUT
713 bool "Enable \"put\" command"
717 Add support for the PUT command within the TFTP client. This allows
718 a client to transfer a file to a TFTP server.
720 config FEATURE_TFTP_BLOCKSIZE
721 bool "Enable \"blocksize\" command"
725 Allow the client to specify the desired block size for transfers.
732 Enable debug settings for tftp. This is useful if you're running
733 into problems with tftp as the protocol doesn't help you much when
734 you run into problems.
740 Utility to trace the route of IP packets
742 config FEATURE_TRACEROUTE_VERBOSE
743 bool "Enable verbose output"
745 depends on TRACEROUTE
747 Add some verbosity to traceroute. This includes amongst other things
748 hostnames and ICMP response types.
750 config FEATURE_TRACEROUTE_SOURCE_ROUTE
751 bool "Enable loose source route"
753 depends on TRACEROUTE
755 Add option to specify a loose source route gateway
758 config FEATURE_TRACEROUTE_USE_ICMP
759 bool "Use ICMP instead of UDP"
761 depends on TRACEROUTE
763 Add feature to allow for ICMP ECHO instead of UDP datagrams.
765 source networking/udhcp/Config.in
771 Creates, removes, and configures VLAN interfaces
777 wget is a utility for non-interactive download of files from HTTP,
778 HTTPS, and FTP servers.
780 config FEATURE_WGET_STATUSBAR
781 bool "Enable a nifty process meter (+2k)"
785 Enable the transfer progress bar for wget transfers.
787 config FEATURE_WGET_AUTHENTICATION
788 bool "Enable HTTP authentication"
792 Support authenticated HTTP transfers.
794 config FEATURE_WGET_LONG_OPTIONS
795 bool "Enable long options"
797 depends on WGET && GETOPT_LONG
799 Support long options for the wget applet.
804 select FEATURE_SYSLOG
806 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
807 It's a daemon that allocates and defends a dynamically assigned
808 address on the 169.254/16 network, requiring no system administrator.
810 See http://www.zeroconf.org for further details, and "zcip.script"
811 in the busybox examples.