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,
79 Small and static DNS server daemon.
85 Send a magic packet to wake up sleeping machines.
92 fakeidentd listens on the ident port and returns a predefined
93 fake value on any query.
99 Retrieve a remote file via FTP.
105 Store a remote file via FTP.
107 config FEATURE_FTPGETPUT_LONG_OPTIONS
108 bool "Enable long options in ftpget/ftpput"
110 depends on GETOPT_LONG && (FTPGET || FTPPUT)
112 Support long options for the ftpget/ftpput applet.
118 Show or set the system's host name.
124 Serve web pages via an HTTP server.
126 config FEATURE_HTTPD_RANGES
127 bool "Support 'Ranges:' header"
131 Makes httpd emit "Accept-Ranges: bytes" header and understand
132 "Range: bytes=NNN-[MMM]" header. Allows for resuming interrupted
133 downloads, seeking in multimedia players etc.
135 config FEATURE_HTTPD_USE_SENDFILE
136 bool "Use sendfile system call"
140 When enabled, httpd will use the kernel sendfile() function
141 instead of read/write loop.
143 config FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
144 bool "Support reloading the global config file using hup signal"
148 This option enables processing of SIGHUP to reload cached
149 configuration settings.
151 config FEATURE_HTTPD_SETUID
152 bool "Enable -u <user> option"
156 This option allows the server to run as a specific user
157 rather than defaulting to the user that starts the server.
158 Use of this option requires special privileges to change to a
161 config FEATURE_HTTPD_BASIC_AUTH
162 bool "Enable Basic http Authentication"
166 Utilizes password settings from /etc/httpd.conf for basic
167 authentication on a per url basis.
169 config FEATURE_HTTPD_AUTH_MD5
170 bool "Support MD5 crypted passwords for http Authentication"
172 depends on FEATURE_HTTPD_BASIC_AUTH
174 Enables basic per URL authentication from /etc/httpd.conf
177 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
178 bool "Support loading additional MIME types at run-time"
182 This option enables support for additional MIME types at
183 run-time to be specified in the configuration file.
185 config FEATURE_HTTPD_CGI
186 bool "Support Common Gateway Interface (CGI)"
190 This option allows scripts and executables to be invoked
191 when specific URLs are requested.
193 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
194 bool "Enable support for running scripts through an interpreter"
196 depends on FEATURE_HTTPD_CGI
198 This option enables support for running scripts through an
199 interpreter. Turn this on if you want PHP scripts to work
200 properly. You need to supply an additional line in your httpd
202 *.php:/path/to/your/php
204 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
205 bool "Support the REMOTE_PORT environment variable for CGI"
207 depends on FEATURE_HTTPD_CGI
209 Use of this option can assist scripts in generating
210 references that contain a unique port number.
212 config FEATURE_HTTPD_ENCODE_URL_STR
213 bool "Enable the -e option for shell script CGI simplification."
217 This option allows html encoding arbitrary
218 strings for display of the browser. Output goes to stdout.
219 For example, httpd -e "<Hello World>" as
220 "<Hello World>".
222 config FEATURE_HTTPD_ERROR_PAGES
223 bool "Enable support for custom error pages"
227 This option allows you to define custom error pages in
228 the configuration file instead of the default HTTP status
229 error pages. For instance, if you add the line:
231 in the config file, the server will respond the specified
232 '/path/e404.html' file instead of the terse '404 NOT FOUND'
235 config FEATURE_HTTPD_PROXY
236 bool "Enable support for reverse proxy"
240 This option allows you to define URLs that will be forwarded
241 to another HTTP server. To setup add the following line to the
243 P:/url/:http://hostname[:port]/new/path/
244 Then a request to /url/myfile will be forwarded to
245 http://hostname[:port]/new/path/myfile.
251 Ifconfig is used to configure the kernel-resident network interfaces.
253 config FEATURE_IFCONFIG_STATUS
254 bool "Enable status reporting output (+7k)"
258 If ifconfig is called with no arguments it will display the status
259 of the currently active interfaces.
261 config FEATURE_IFCONFIG_SLIP
262 bool "Enable slip-specific options \"keepalive\" and \"outfill\""
266 Allow "keepalive" and "outfill" support for SLIP. If you're not
267 planning on using serial lines, leave this unchecked.
269 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
270 bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
274 Allow the start address for shared memory, start address for I/O,
275 and/or the interrupt line used by the specified device.
277 config FEATURE_IFCONFIG_HW
278 bool "Enable option \"hw\" (ether only)"
282 Set the hardware address of this interface, if the device driver
283 supports this operation. Currently, we only support the 'ether'
286 config FEATURE_IFCONFIG_BROADCAST_PLUS
287 bool "Set the broadcast automatically"
291 Setting this will make ifconfig attempt to find the broadcast
292 automatically if the value '+' is used.
298 Activate or deactivate the specified interfaces. This applet makes
299 use of either "ifconfig" and "route" or the "ip" command to actually
300 configure network interfaces. Therefore, you will probably also want
301 to enable either IFCONFIG and ROUTE, or enable
302 FEATURE_IFUPDOWN_IP and the various IP options. Of
303 course you could use non-busybox versions of these programs, so
304 against my better judgement (since this will surely result in plenty
305 of support questions on the mailing list), I do not force you to
306 enable these additional options. It is up to you to supply either
307 "ifconfig", "route" and "run-parts" or the "ip" command, either
308 via busybox or via standalone utilities.
310 config IFUPDOWN_IFSTATE_PATH
311 string "Absolute path to ifstate file"
312 default "/var/run/ifstate"
315 ifupdown keeps state information in a file called ifstate.
316 Typically it is located in /var/run/ifstate, however
317 some distributions tend to put it in other places
318 (debian, for example, uses /etc/network/run/ifstate).
319 This config option defines location of ifstate.
321 config FEATURE_IFUPDOWN_IP
326 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
327 than the default of using the older 'ifconfig' and 'route' utilities.
329 config FEATURE_IFUPDOWN_IP_BUILTIN
330 bool "Use busybox ip applet"
332 depends on FEATURE_IFUPDOWN_IP
334 select FEATURE_IP_ADDRESS
335 select FEATURE_IP_LINK
336 select FEATURE_IP_ROUTE
338 Use the busybox iproute "ip" applet to implement "ifupdown".
340 If left disabled, you must install the full-blown iproute2
341 utility or the "ifup" and "ifdown" applets will not work.
343 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
344 bool "Use busybox ifconfig and route applets"
346 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
350 Use the busybox iproute "ifconfig" and "route" applets to
351 implement the "ifup" and "ifdown" utilities.
353 If left disabled, you must install the full-blown ifconfig
354 and route utilities, or the "ifup" and "ifdown" applets will not
357 config FEATURE_IFUPDOWN_IPV4
358 bool "Enable support for IPv4"
362 If you want ifup/ifdown to talk IPv4, leave this on.
364 config FEATURE_IFUPDOWN_IPV6
365 bool "Enable support for IPv6"
367 depends on IFUPDOWN && FEATURE_IPV6
369 If you need support for IPv6, turn this option on.
372 ###config FEATURE_IFUPDOWN_IPX
373 ### bool "Enable support for IPX"
375 ### depends on IFUPDOWN
377 ### If this option is selected you can use busybox to work with IPX
380 config FEATURE_IFUPDOWN_MAPPING
381 bool "Enable mapping support"
385 This enables support for the "mapping" stanza, unless you have
386 a weird network setup you don't need it.
388 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
389 bool "Enable support for external dhcp clients"
393 This enables support for the external dhcp clients. Clients are
394 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
395 Otherwise, if udhcpc applet is enabled, it is used.
396 Otherwise, ifup/ifdown will have no support for DHCP.
401 select FEATURE_SYSLOG
403 Internet superserver daemon
405 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
406 bool "Support echo service"
410 Echo received data internal inetd service
412 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
413 bool "Support discard service"
417 Internet /dev/null internal inetd service
419 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
420 bool "Support time service"
424 Return 32 bit time since 1900 internal inetd service
426 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
427 bool "Support daytime service"
431 Return human-readable time internal inetd service
433 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
434 bool "Support chargen service"
438 Familiar character generator internal inetd service
440 config FEATURE_INETD_RPC
441 bool "Support RPC services"
444 select FEATURE_HAVE_RPC
446 Support Sun-RPC based services
452 The "ip" applet is a TCP/IP interface configuration and routing
453 utility. You generally don't need "ip" to use busybox with
456 config FEATURE_IP_ADDRESS
461 Address manipulation support for the "ip" applet.
463 config FEATURE_IP_LINK
468 Configure network devices with "ip".
470 config FEATURE_IP_ROUTE
475 Add support for routing table management to "ip".
477 config FEATURE_IP_TUNNEL
482 Add support for tunneling commands to "ip".
484 config FEATURE_IP_RULE
489 Add support for rule commands to "ip".
491 config FEATURE_IP_SHORT_FORMS
492 bool "Support short forms of ip commands."
496 Also support short-form of ip <OBJECT> commands:
500 ip tunnel -> iptunnel
503 Say N unless you desparately need the short form of the ip
506 config FEATURE_IP_RARE_PROTOCOLS
507 bool "Support displaying rarely used link types"
511 If you are not going to use links of type "frad", "econet",
512 "bif" etc, you probably don't need to enable this.
513 Ethernet, wireless, infrared, ppp/slip, ip tunnelling
514 link types are supported without this option selected.
519 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
524 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
529 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
534 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
539 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
545 ipcalc takes an IP address and netmask and calculates the
546 resulting broadcast, network, and host range.
548 config FEATURE_IPCALC_FANCY
549 bool "Fancy IPCALC, more options, adds 1 kbyte"
553 Adds the options hostname, prefix and silent to the output of "ipcalc".
555 config FEATURE_IPCALC_LONG_OPTIONS
556 bool "Enable long options"
558 depends on IPCALC && GETOPT_LONG
560 Support long options for the ipcalc applet.
565 select FEATURE_SYSLOG
567 nameif is used to rename network interface by its MAC address.
568 Renamed interfaces MUST be in the down state.
569 It is possible to use a file (default: /etc/mactab)
570 with list of new interface names and MACs.
571 Maximum interface name length: IF_NAMESIZE = 16
572 File fields are separated by space or tab.
575 new_interface_name XX:XX:XX:XX:XX:XX
577 config FEATURE_NAMEIF_EXTENDED
578 bool "Extended nameif"
582 This extends the nameif syntax to support the bus_info and driver
583 checks. The syntax is compatible to the normal nameif.
585 new_interface_name driver=asix bus=usb-0000:00:08.2-3
586 new_interface_name bus=usb-0000:00:08.2-3 00:80:C8:38:91:B5
587 new_interface_name mac=00:80:C8:38:91:B5
588 new_interface_name 00:80:C8:38:91:B5
594 A simple Unix utility which reads and writes data across network
598 bool "Netcat server options (-l)"
602 Allow netcat to act as a server.
605 bool "Netcat extensions (-eiw and filename)"
609 Add -e (support for executing the rest of the command line after
610 making or receiving a successful connection), -i (delay interval for
611 lines sent), -w (timeout for initial connection).
617 netstat prints information about the Linux networking subsystem.
619 config FEATURE_NETSTAT_WIDE
620 bool " Enable wide netstat output"
624 Add support for wide columns. Useful when displaying IPv6 addresses
631 nslookup is a tool to query Internet name servers.
637 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
638 elicit an ICMP ECHO_RESPONSE from a host or gateway.
643 depends on FEATURE_IPV6 && PING
645 This will give you a ping that can talk IPv6.
651 Simple network port scanner.
653 config FEATURE_FANCY_PING
654 bool "Enable fancy ping output"
658 Make the output from the ping applet include statistics, and at the
659 same time provide full support for ICMP packets.
665 Route displays or manipulates the kernel's IP routing tables.
671 slattach is a small utility to attach network interfaces to serial lines.
677 Telnet is an interface to the TELNET protocol, but is also commonly
678 used to test other simple protocols.
680 config FEATURE_TELNET_TTYPE
681 bool "Pass TERM type to remote host"
685 Setting this option will forward the TERM environment variable to the
686 remote host you are connecting to. This is useful to make sure that
687 things like ANSI colors and other control sequences behave.
689 config FEATURE_TELNET_AUTOLOGIN
690 bool "Pass USER type to remote host"
694 Setting this option will forward the USER environment variable to the
695 remote host you are connecting to. This is useful when you need to
696 log into a machine without telling the username (autologin). This
697 option enables `-a' and `-l USER' arguments.
702 select FEATURE_SYSLOG
704 A daemon for the TELNET protocol, allowing you to log onto the host
705 running the daemon. Please keep in mind that the TELNET protocol
706 sends passwords in plain text. If you can't afford the space for an
707 SSH daemon and you trust your network, you may say 'y' here. As a
708 more secure alternative, you should seriously consider installing the
709 very small Dropbear SSH daemon instead:
710 http://matt.ucc.asn.au/dropbear/dropbear.html
712 Note that for busybox telnetd to work you need several things:
713 First of all, your kernel needs:
717 Next, you need a /dev/pts directory on your root filesystem:
720 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
722 Next you need the pseudo terminal master multiplexer /dev/ptmx:
725 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
727 Any /dev/ttyp[0-9]* files you may have can be removed.
728 Next, you need to mount the devpts filesystem on /dev/pts using:
730 mount -t devpts devpts /dev/pts
732 You need to be sure that Busybox has LOGIN and
733 FEATURE_SUID enabled. And finally, you should make
734 certain that Busybox has been installed setuid root:
736 chown root.root /bin/busybox
737 chmod 4755 /bin/busybox
739 with all that done, telnetd _should_ work....
742 config FEATURE_TELNETD_STANDALONE
743 bool "Support standalone telnetd (not inetd only)"
747 Selecting this will make telnetd able to run standalone.
753 This enables the Trivial File Transfer Protocol client program. TFTP
754 is usually used for simple, small transfers such as a root image
755 for a network-enabled bootloader.
757 config FEATURE_TFTP_GET
758 bool "Enable \"get\" command"
762 Add support for the GET command within the TFTP client. This allows
763 a client to retrieve a file from a TFTP server.
765 config FEATURE_TFTP_PUT
766 bool "Enable \"put\" command"
770 Add support for the PUT command within the TFTP client. This allows
771 a client to transfer a file to a TFTP server.
773 config FEATURE_TFTP_BLOCKSIZE
774 bool "Enable \"blocksize\" command"
778 Allow the client to specify the desired block size for transfers.
785 Enable debug settings for tftp. This is useful if you're running
786 into problems with tftp as the protocol doesn't help you much when
787 you run into problems.
793 Utility to trace the route of IP packets
795 config FEATURE_TRACEROUTE_VERBOSE
796 bool "Enable verbose output"
798 depends on TRACEROUTE
800 Add some verbosity to traceroute. This includes amongst other things
801 hostnames and ICMP response types.
803 config FEATURE_TRACEROUTE_SOURCE_ROUTE
804 bool "Enable loose source route"
806 depends on TRACEROUTE
808 Add option to specify a loose source route gateway
811 config FEATURE_TRACEROUTE_USE_ICMP
812 bool "Use ICMP instead of UDP"
814 depends on TRACEROUTE
816 Add feature to allow for ICMP ECHO instead of UDP datagrams.
818 source networking/udhcp/Config.in
824 Creates, removes, and configures VLAN interfaces
830 wget is a utility for non-interactive download of files from HTTP,
831 HTTPS, and FTP servers.
833 config FEATURE_WGET_STATUSBAR
834 bool "Enable a nifty process meter (+2k)"
838 Enable the transfer progress bar for wget transfers.
840 config FEATURE_WGET_AUTHENTICATION
841 bool "Enable HTTP authentication"
845 Support authenticated HTTP transfers.
847 config FEATURE_WGET_LONG_OPTIONS
848 bool "Enable long options"
850 depends on WGET && GETOPT_LONG
852 Support long options for the wget applet.
857 select FEATURE_SYSLOG
859 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
860 It's a daemon that allocates and defends a dynamically assigned
861 address on the 169.254/16 network, requiring no system administrator.
863 See http://www.zeroconf.org for further details, and "zcip.script"
864 in the busybox examples.