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 FEATURE_PREFER_IPV4_ADDRESS
16 bool "Preferentially use IPv4 addresses from DNS queries"
18 depends on FEATURE_IPV6
20 Use IPv4 address of network host if it has one.
22 If this option is off, the first returned address will be used.
23 This may cause problems when your DNS server is IPv6-capable and
24 is returning IPv6 host addresses too. If IPv6 address
25 precedes IPv4 one in DNS reply, busybox network applets
26 (e.g. wget) will use IPv6 address. On an IPv6-incapable host
27 or network applets will fail to connect to the host
30 config VERBOSE_RESOLUTION_ERRORS
31 bool "Verbose resolution errors"
34 Enable if you are not satisfied with simplistic
35 "can't resolve 'hostname.com'" and want to know more.
36 This may increase size of your executable a bit.
42 Manipulate the system ARP cache.
48 Ping hosts by ARP packets.
54 Manage ethernet bridges.
55 Supports addbr/delbr and addif/delif.
57 #config FEATURE_BRCTL_SHOW
58 # bool "support show, showmac and showstp"
62 # Add support for option which print the current config:
63 # showmacs, showstp, show
65 config FEATURE_BRCTL_FANCY
70 Add support for extended option like:
71 setageing, setfd, sethello, setmaxage,
72 setpathcost, setportprio, setbridgeprio,
74 This adds about 600 bytes.
80 Small and static DNS server daemon.
86 Send a magic packet to wake up sleeping machines.
93 fakeidentd listens on the ident port and returns a predefined
94 fake value on any query.
100 Retrieve a remote file via FTP.
106 Store a remote file via FTP.
108 config FEATURE_FTPGETPUT_LONG_OPTIONS
109 bool "Enable long options in ftpget/ftpput"
111 depends on GETOPT_LONG && (FTPGET || FTPPUT)
113 Support long options for the ftpget/ftpput applet.
119 Show or set the system's host name.
125 Serve web pages via an HTTP server.
127 config FEATURE_HTTPD_RANGES
128 bool "Support 'Ranges:' header"
132 Makes httpd emit "Accept-Ranges: bytes" header and understand
133 "Range: bytes=NNN-[MMM]" header. Allows for resuming interrupted
134 downloads, seeking in multimedia players etc.
136 config FEATURE_HTTPD_USE_SENDFILE
137 bool "Use sendfile system call"
141 When enabled, httpd will use the kernel sendfile() function
142 instead of read/write loop.
144 config FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
145 bool "Support reloading the global config file using hup signal"
149 This option enables processing of SIGHUP to reload cached
150 configuration settings.
152 config FEATURE_HTTPD_SETUID
153 bool "Enable -u <user> option"
157 This option allows the server to run as a specific user
158 rather than defaulting to the user that starts the server.
159 Use of this option requires special privileges to change to a
162 config FEATURE_HTTPD_BASIC_AUTH
163 bool "Enable Basic http Authentication"
167 Utilizes password settings from /etc/httpd.conf for basic
168 authentication on a per url basis.
170 config FEATURE_HTTPD_AUTH_MD5
171 bool "Support MD5 crypted passwords for http Authentication"
173 depends on FEATURE_HTTPD_BASIC_AUTH
175 Enables basic per URL authentication from /etc/httpd.conf
178 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
179 bool "Support loading additional MIME types at run-time"
183 This option enables support for additional MIME types at
184 run-time to be specified in the configuration file.
186 config FEATURE_HTTPD_CGI
187 bool "Support Common Gateway Interface (CGI)"
191 This option allows scripts and executables to be invoked
192 when specific URLs are requested.
194 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
195 bool "Enable support for running scripts through an interpreter"
197 depends on FEATURE_HTTPD_CGI
199 This option enables support for running scripts through an
200 interpreter. Turn this on if you want PHP scripts to work
201 properly. You need to supply an additional line in your httpd
203 *.php:/path/to/your/php
205 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
206 bool "Support the REMOTE_PORT environment variable for CGI"
208 depends on FEATURE_HTTPD_CGI
210 Use of this option can assist scripts in generating
211 references that contain a unique port number.
213 config FEATURE_HTTPD_ENCODE_URL_STR
214 bool "Enable the -e option for shell script CGI simplification."
218 This option allows html encoding arbitrary
219 strings for display of the browser. Output goes to stdout.
220 For example, httpd -e "<Hello World>" as
221 "<Hello World>".
223 config FEATURE_HTTPD_ERROR_PAGES
224 bool "Enable support for custom error pages"
228 This option allows you to define custom error pages in
229 the configuration file instead of the default HTTP status
230 error pages. For instance, if you add the line:
232 in the config file, the server will respond the specified
233 '/path/e404.html' file instead of the terse '404 NOT FOUND'
236 config FEATURE_HTTPD_PROXY
237 bool "Enable support for reverse proxy"
241 This option allows you to define URLs that will be forwarded
242 to another HTTP server. To setup add the following line to the
244 P:/url/:http://hostname[:port]/new/path/
245 Then a request to /url/myfile will be forwarded to
246 http://hostname[:port]/new/path/myfile.
252 Ifconfig is used to configure the kernel-resident network interfaces.
254 config FEATURE_IFCONFIG_STATUS
255 bool "Enable status reporting output (+7k)"
259 If ifconfig is called with no arguments it will display the status
260 of the currently active interfaces.
262 config FEATURE_IFCONFIG_SLIP
263 bool "Enable slip-specific options \"keepalive\" and \"outfill\""
267 Allow "keepalive" and "outfill" support for SLIP. If you're not
268 planning on using serial lines, leave this unchecked.
270 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
271 bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
275 Allow the start address for shared memory, start address for I/O,
276 and/or the interrupt line used by the specified device.
278 config FEATURE_IFCONFIG_HW
279 bool "Enable option \"hw\" (ether only)"
283 Set the hardware address of this interface, if the device driver
284 supports this operation. Currently, we only support the 'ether'
287 config FEATURE_IFCONFIG_BROADCAST_PLUS
288 bool "Set the broadcast automatically"
292 Setting this will make ifconfig attempt to find the broadcast
293 automatically if the value '+' is used.
299 Activate or deactivate the specified interfaces. This applet makes
300 use of either "ifconfig" and "route" or the "ip" command to actually
301 configure network interfaces. Therefore, you will probably also want
302 to enable either IFCONFIG and ROUTE, or enable
303 FEATURE_IFUPDOWN_IP and the various IP options. Of
304 course you could use non-busybox versions of these programs, so
305 against my better judgement (since this will surely result in plenty
306 of support questions on the mailing list), I do not force you to
307 enable these additional options. It is up to you to supply either
308 "ifconfig", "route" and "run-parts" or the "ip" command, either
309 via busybox or via standalone utilities.
311 config IFUPDOWN_IFSTATE_PATH
312 string "Absolute path to ifstate file"
313 default "/var/run/ifstate"
316 ifupdown keeps state information in a file called ifstate.
317 Typically it is located in /var/run/ifstate, however
318 some distributions tend to put it in other places
319 (debian, for example, uses /etc/network/run/ifstate).
320 This config option defines location of ifstate.
322 config FEATURE_IFUPDOWN_IP
327 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
328 than the default of using the older 'ifconfig' and 'route' utilities.
330 config FEATURE_IFUPDOWN_IP_BUILTIN
331 bool "Use busybox ip applet"
333 depends on FEATURE_IFUPDOWN_IP
335 select FEATURE_IP_ADDRESS
336 select FEATURE_IP_LINK
337 select FEATURE_IP_ROUTE
339 Use the busybox iproute "ip" applet to implement "ifupdown".
341 If left disabled, you must install the full-blown iproute2
342 utility or the "ifup" and "ifdown" applets will not work.
344 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
345 bool "Use busybox ifconfig and route applets"
347 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
351 Use the busybox iproute "ifconfig" and "route" applets to
352 implement the "ifup" and "ifdown" utilities.
354 If left disabled, you must install the full-blown ifconfig
355 and route utilities, or the "ifup" and "ifdown" applets will not
358 config FEATURE_IFUPDOWN_IPV4
359 bool "Enable support for IPv4"
363 If you want ifup/ifdown to talk IPv4, leave this on.
365 config FEATURE_IFUPDOWN_IPV6
366 bool "Enable support for IPv6"
368 depends on IFUPDOWN && FEATURE_IPV6
370 If you need support for IPv6, turn this option on.
373 ###config FEATURE_IFUPDOWN_IPX
374 ### bool "Enable support for IPX"
376 ### depends on IFUPDOWN
378 ### If this option is selected you can use busybox to work with IPX
381 config FEATURE_IFUPDOWN_MAPPING
382 bool "Enable mapping support"
386 This enables support for the "mapping" stanza, unless you have
387 a weird network setup you don't need it.
389 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
390 bool "Enable support for external dhcp clients"
394 This enables support for the external dhcp clients. Clients are
395 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
396 Otherwise, if udhcpc applet is enabled, it is used.
397 Otherwise, ifup/ifdown will have no support for DHCP.
402 select FEATURE_SYSLOG
404 Internet superserver daemon
406 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
407 bool "Support echo service"
411 Echo received data internal inetd service
413 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
414 bool "Support discard service"
418 Internet /dev/null internal inetd service
420 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
421 bool "Support time service"
425 Return 32 bit time since 1900 internal inetd service
427 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
428 bool "Support daytime service"
432 Return human-readable time internal inetd service
434 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
435 bool "Support chargen service"
439 Familiar character generator internal inetd service
441 config FEATURE_INETD_RPC
442 bool "Support RPC services"
445 select FEATURE_HAVE_RPC
447 Support Sun-RPC based services
453 The "ip" applet is a TCP/IP interface configuration and routing
454 utility. You generally don't need "ip" to use busybox with
457 config FEATURE_IP_ADDRESS
462 Address manipulation support for the "ip" applet.
464 config FEATURE_IP_LINK
469 Configure network devices with "ip".
471 config FEATURE_IP_ROUTE
476 Add support for routing table management to "ip".
478 config FEATURE_IP_TUNNEL
483 Add support for tunneling commands to "ip".
485 config FEATURE_IP_RULE
490 Add support for rule commands to "ip".
492 config FEATURE_IP_SHORT_FORMS
493 bool "Support short forms of ip commands."
497 Also support short-form of ip <OBJECT> commands:
501 ip tunnel -> iptunnel
504 Say N unless you desparately need the short form of the ip
507 config FEATURE_IP_RARE_PROTOCOLS
508 bool "Support displaying rarely used link types"
512 If you are not going to use links of type "frad", "econet",
513 "bif" etc, you probably don't need to enable this.
514 Ethernet, wireless, infrared, ppp/slip, ip tunnelling
515 link types are supported without this option selected.
520 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
525 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
530 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
535 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
540 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
546 ipcalc takes an IP address and netmask and calculates the
547 resulting broadcast, network, and host range.
549 config FEATURE_IPCALC_FANCY
550 bool "Fancy IPCALC, more options, adds 1 kbyte"
554 Adds the options hostname, prefix and silent to the output of "ipcalc".
556 config FEATURE_IPCALC_LONG_OPTIONS
557 bool "Enable long options"
559 depends on IPCALC && GETOPT_LONG
561 Support long options for the ipcalc applet.
566 select FEATURE_SYSLOG
568 nameif is used to rename network interface by its MAC address.
569 Renamed interfaces MUST be in the down state.
570 It is possible to use a file (default: /etc/mactab)
571 with list of new interface names and MACs.
572 Maximum interface name length: IF_NAMESIZE = 16
573 File fields are separated by space or tab.
576 new_interface_name XX:XX:XX:XX:XX:XX
578 config FEATURE_NAMEIF_EXTENDED
579 bool "Extended nameif"
583 This extends the nameif syntax to support the bus_info and driver
584 checks. The syntax is compatible to the normal nameif.
586 new_interface_name driver=asix bus=usb-0000:00:08.2-3
587 new_interface_name bus=usb-0000:00:08.2-3 00:80:C8:38:91:B5
588 new_interface_name mac=00:80:C8:38:91:B5
589 new_interface_name 00:80:C8:38:91:B5
595 A simple Unix utility which reads and writes data across network
599 bool "Netcat server options (-l)"
603 Allow netcat to act as a server.
606 bool "Netcat extensions (-eiw and filename)"
610 Add -e (support for executing the rest of the command line after
611 making or receiving a successful connection), -i (delay interval for
612 lines sent), -w (timeout for initial connection).
618 netstat prints information about the Linux networking subsystem.
620 config FEATURE_NETSTAT_WIDE
621 bool " Enable wide netstat output"
625 Add support for wide columns. Useful when displaying IPv6 addresses
632 nslookup is a tool to query Internet name servers.
638 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
639 elicit an ICMP ECHO_RESPONSE from a host or gateway.
644 depends on FEATURE_IPV6 && PING
646 This will give you a ping that can talk IPv6.
648 config FEATURE_FANCY_PING
649 bool "Enable fancy ping output"
653 Make the output from the ping applet include statistics, and at the
654 same time provide full support for ICMP packets.
660 Simple network port scanner.
666 Route displays or manipulates the kernel's IP routing tables.
674 config FEATURE_SENDMAIL_EHLO
675 bool "Support EHLO command"
679 Support ESMTP EHLO command.
681 config FEATURE_SENDMAIL_BLOATY
682 bool "Be more verbose"
686 Should be turned off.
694 config FEATURE_FETCHMAIL_APOP
695 bool "Support APOP authentication"
699 Support secure APOP authentication.
701 config FEATURE_FETCHMAIL_FILTER
702 bool "Pipe thru external filter"
706 Support piping incoming messages thru external filter.
712 slattach is a small utility to attach network interfaces to serial lines.
718 Telnet is an interface to the TELNET protocol, but is also commonly
719 used to test other simple protocols.
721 config FEATURE_TELNET_TTYPE
722 bool "Pass TERM type to remote host"
726 Setting this option will forward the TERM environment variable to the
727 remote host you are connecting to. This is useful to make sure that
728 things like ANSI colors and other control sequences behave.
730 config FEATURE_TELNET_AUTOLOGIN
731 bool "Pass USER type to remote host"
735 Setting this option will forward the USER environment variable to the
736 remote host you are connecting to. This is useful when you need to
737 log into a machine without telling the username (autologin). This
738 option enables `-a' and `-l USER' arguments.
743 select FEATURE_SYSLOG
745 A daemon for the TELNET protocol, allowing you to log onto the host
746 running the daemon. Please keep in mind that the TELNET protocol
747 sends passwords in plain text. If you can't afford the space for an
748 SSH daemon and you trust your network, you may say 'y' here. As a
749 more secure alternative, you should seriously consider installing the
750 very small Dropbear SSH daemon instead:
751 http://matt.ucc.asn.au/dropbear/dropbear.html
753 Note that for busybox telnetd to work you need several things:
754 First of all, your kernel needs:
758 Next, you need a /dev/pts directory on your root filesystem:
761 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
763 Next you need the pseudo terminal master multiplexer /dev/ptmx:
766 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
768 Any /dev/ttyp[0-9]* files you may have can be removed.
769 Next, you need to mount the devpts filesystem on /dev/pts using:
771 mount -t devpts devpts /dev/pts
773 You need to be sure that Busybox has LOGIN and
774 FEATURE_SUID enabled. And finally, you should make
775 certain that Busybox has been installed setuid root:
777 chown root.root /bin/busybox
778 chmod 4755 /bin/busybox
780 with all that done, telnetd _should_ work....
783 config FEATURE_TELNETD_STANDALONE
784 bool "Support standalone telnetd (not inetd only)"
788 Selecting this will make telnetd able to run standalone.
794 This enables the Trivial File Transfer Protocol client program. TFTP
795 is usually used for simple, small transfers such as a root image
796 for a network-enabled bootloader.
798 config FEATURE_TFTP_GET
799 bool "Enable \"get\" command"
803 Add support for the GET command within the TFTP client. This allows
804 a client to retrieve a file from a TFTP server.
806 config FEATURE_TFTP_PUT
807 bool "Enable \"put\" command"
811 Add support for the PUT command within the TFTP client. This allows
812 a client to transfer a file to a TFTP server.
814 config FEATURE_TFTP_BLOCKSIZE
815 bool "Enable \"blocksize\" command"
819 Allow the client to specify the desired block size for transfers.
826 Enable debug settings for tftp. This is useful if you're running
827 into problems with tftp as the protocol doesn't help you much when
828 you run into problems.
834 Utility to trace the route of IP packets
836 config FEATURE_TRACEROUTE_VERBOSE
837 bool "Enable verbose output"
839 depends on TRACEROUTE
841 Add some verbosity to traceroute. This includes amongst other things
842 hostnames and ICMP response types.
844 config FEATURE_TRACEROUTE_SOURCE_ROUTE
845 bool "Enable loose source route"
847 depends on TRACEROUTE
849 Add option to specify a loose source route gateway
852 config FEATURE_TRACEROUTE_USE_ICMP
853 bool "Use ICMP instead of UDP"
855 depends on TRACEROUTE
857 Add feature to allow for ICMP ECHO instead of UDP datagrams.
859 source networking/udhcp/Config.in
865 Creates, removes, and configures VLAN interfaces
871 wget is a utility for non-interactive download of files from HTTP,
872 HTTPS, and FTP servers.
874 config FEATURE_WGET_STATUSBAR
875 bool "Enable a nifty process meter (+2k)"
879 Enable the transfer progress bar for wget transfers.
881 config FEATURE_WGET_AUTHENTICATION
882 bool "Enable HTTP authentication"
886 Support authenticated HTTP transfers.
888 config FEATURE_WGET_LONG_OPTIONS
889 bool "Enable long options"
891 depends on WGET && GETOPT_LONG
893 Support long options for the wget applet.
898 select FEATURE_SYSLOG
900 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
901 It's a daemon that allocates and defends a dynamically assigned
902 address on the 169.254/16 network, requiring no system administrator.
904 See http://www.zeroconf.org for further details, and "zcip.script"
905 in the busybox examples.