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"
254 ifupdown keeps state information in a file called ifstate.
255 Typically it is located in /var/run/ifstate, however
256 some distributions tend to put it in other places
257 (debian, for example, uses /etc/network/run/ifstate).
258 This config option defines location of ifstate.
260 config FEATURE_IFUPDOWN_IP
265 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
266 than the default of using the older 'ifconfig' and 'route' utilities.
268 config FEATURE_IFUPDOWN_IP_BUILTIN
269 bool "Use busybox ip applet"
271 depends on FEATURE_IFUPDOWN_IP
273 select FEATURE_IP_ADDRESS
274 select FEATURE_IP_LINK
275 select FEATURE_IP_ROUTE
277 Use the busybox iproute "ip" applet to implement "ifupdown".
279 If left disabled, you must install the full-blown iproute2
280 utility or the "ifup" and "ifdown" applets will not work.
282 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
283 bool "Use busybox ifconfig and route applets"
285 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
289 Use the busybox iproute "ifconfig" and "route" applets to
290 implement the "ifup" and "ifdown" utilities.
292 If left disabled, you must install the full-blown ifconfig
293 and route utilities, or the "ifup" and "ifdown" applets will not
296 config FEATURE_IFUPDOWN_IPV4
297 bool "Enable support for IPv4"
301 If you want ifup/ifdown to talk IPv4, leave this on.
303 config FEATURE_IFUPDOWN_IPV6
304 bool "Enable support for IPv6"
306 depends on IFUPDOWN && FEATURE_IPV6
308 If you need support for IPv6, turn this option on.
311 ### config FEATURE_IFUPDOWN_IPX
312 ### bool "Enable support for IPX"
314 ### depends on IFUPDOWN
316 ### If this option is selected you can use busybox to work with IPX
319 config FEATURE_IFUPDOWN_MAPPING
320 bool "Enable mapping support"
324 This enables support for the "mapping" stanza, unless you have
325 a weird network setup you don't need it.
327 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
328 bool "Enable support for external dhcp clients"
332 This enables support for the external dhcp clients. Clients are
333 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
334 Otherwise, if udhcpc applet is enabled, it is used.
335 Otherwise, ifup/ifdown will have no support for DHCP.
340 select FEATURE_SYSLOG
342 Internet superserver daemon
344 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
345 bool "Support echo service"
349 Echo received data internal inetd service
351 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
352 bool "Support discard service"
356 Internet /dev/null internal inetd service
358 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
359 bool "Support time service"
363 Return 32 bit time since 1900 internal inetd service
365 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
366 bool "Support daytime service"
370 Return human-readable time internal inetd service
372 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
373 bool "Support chargen service"
377 Familiar character generator internal inetd service
379 config FEATURE_INETD_RPC
380 bool "Support RPC services"
383 select FEATURE_HAVE_RPC
385 Support Sun-RPC based services
391 The "ip" applet is a TCP/IP interface configuration and routing
392 utility. You generally don't need "ip" to use busybox with
395 config FEATURE_IP_ADDRESS
400 Address manipulation support for the "ip" applet.
402 config FEATURE_IP_LINK
407 Configure network devices with "ip".
409 config FEATURE_IP_ROUTE
414 Add support for routing table management to "ip".
416 config FEATURE_IP_TUNNEL
421 Add support for tunneling commands to "ip".
423 config FEATURE_IP_RULE
428 Add support for rule commands to "ip".
430 config FEATURE_IP_SHORT_FORMS
431 bool "Support short forms of ip commands."
435 Also support short-form of ip <OBJECT> commands:
439 ip tunnel -> iptunnel
442 Say N unless you desparately need the short form of the ip
448 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
453 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
458 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
463 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
468 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
474 ipcalc takes an IP address and netmask and calculates the
475 resulting broadcast, network, and host range.
477 config FEATURE_IPCALC_FANCY
478 bool "Fancy IPCALC, more options, adds 1 kbyte"
482 Adds the options hostname, prefix and silent to the output of "ipcalc".
484 config FEATURE_IPCALC_LONG_OPTIONS
485 bool "Enable long options"
487 depends on IPCALC && GETOPT_LONG
489 Support long options for the ipcalc applet.
494 select FEATURE_SYSLOG
496 nameif is used to rename network interface by its MAC address.
497 Renamed interfaces MUST be in the down state.
498 It is possible to use a file (default: /etc/mactab)
499 with list of new interface names and MACs.
500 Maximum interface name length: IF_NAMESIZE = 16
501 File fields are separated by space or tab.
504 new_interface_name XX:XX:XX:XX:XX:XX
510 A simple Unix utility which reads and writes data across network
514 bool "Netcat server options (-l)"
518 Allow netcat to act as a server.
521 bool "Netcat extensions (-eiw and filename)"
525 Add -e (support for executing the rest of the command line after
526 making or receiving a successful connection), -i (delay interval for
527 lines sent), -w (timeout for initial connection).
533 netstat prints information about the Linux networking subsystem.
535 config FEATURE_NETSTAT_WIDE
536 bool " Enable wide netstat output"
540 Add support for wide columns. Useful when displaying IPv6 addresses
547 nslookup is a tool to query Internet name servers.
553 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
554 elicit an ICMP ECHO_RESPONSE from a host or gateway.
559 depends on FEATURE_IPV6 && PING
561 This will give you a ping that can talk IPv6.
567 Simple network port scanner.
569 config FEATURE_FANCY_PING
570 bool "Enable fancy ping output"
574 Make the output from the ping applet include statistics, and at the
575 same time provide full support for ICMP packets.
581 Route displays or manipulates the kernel's IP routing tables.
587 slattach is a small utility to attach network interfaces to serial lines.
593 Telnet is an interface to the TELNET protocol, but is also commonly
594 used to test other simple protocols.
596 config FEATURE_TELNET_TTYPE
597 bool "Pass TERM type to remote host"
601 Setting this option will forward the TERM environment variable to the
602 remote host you are connecting to. This is useful to make sure that
603 things like ANSI colors and other control sequences behave.
605 config FEATURE_TELNET_AUTOLOGIN
606 bool "Pass USER type to remote host"
610 Setting this option will forward the USER environment variable to the
611 remote host you are connecting to. This is useful when you need to
612 log into a machine without telling the username (autologin). This
613 option enables `-a' and `-l USER' arguments.
618 select FEATURE_SYSLOG
620 A daemon for the TELNET protocol, allowing you to log onto the host
621 running the daemon. Please keep in mind that the TELNET protocol
622 sends passwords in plain text. If you can't afford the space for an
623 SSH daemon and you trust your network, you may say 'y' here. As a
624 more secure alternative, you should seriously consider installing the
625 very small Dropbear SSH daemon instead:
626 http://matt.ucc.asn.au/dropbear/dropbear.html
628 Note that for busybox telnetd to work you need several things:
629 First of all, your kernel needs:
633 Next, you need a /dev/pts directory on your root filesystem:
636 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
638 Next you need the pseudo terminal master multiplexer /dev/ptmx:
641 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
643 Any /dev/ttyp[0-9]* files you may have can be removed.
644 Next, you need to mount the devpts filesystem on /dev/pts using:
646 mount -t devpts devpts /dev/pts
648 You need to be sure that Busybox has LOGIN and
649 FEATURE_SUID enabled. And finally, you should make
650 certain that Busybox has been installed setuid root:
652 chown root.root /bin/busybox
653 chmod 4755 /bin/busybox
655 with all that done, telnetd _should_ work....
658 config FEATURE_TELNETD_STANDALONE
659 bool "Support standalone telnetd (not inetd only)"
663 Selecting this will make telnetd able to run standalone.
669 This enables the Trivial File Transfer Protocol client program. TFTP
670 is usually used for simple, small transfers such as a root image
671 for a network-enabled bootloader.
673 config FEATURE_TFTP_GET
674 bool "Enable \"get\" command"
678 Add support for the GET command within the TFTP client. This allows
679 a client to retrieve a file from a TFTP server.
681 config FEATURE_TFTP_PUT
682 bool "Enable \"put\" command"
686 Add support for the PUT command within the TFTP client. This allows
687 a client to transfer a file to a TFTP server.
689 config FEATURE_TFTP_BLOCKSIZE
690 bool "Enable \"blocksize\" command"
694 Allow the client to specify the desired block size for transfers.
701 Enable debug settings for tftp. This is useful if you're running
702 into problems with tftp as the protocol doesn't help you much when
703 you run into problems.
709 Utility to trace the route of IP packets
711 config FEATURE_TRACEROUTE_VERBOSE
712 bool "Enable verbose output"
714 depends on TRACEROUTE
716 Add some verbosity to traceroute. This includes amongst other things
717 hostnames and ICMP response types.
719 config FEATURE_TRACEROUTE_SOURCE_ROUTE
720 bool "Enable loose source route"
722 depends on TRACEROUTE
724 Add option to specify a loose source route gateway
727 config FEATURE_TRACEROUTE_USE_ICMP
728 bool "Use ICMP instead of UDP"
730 depends on TRACEROUTE
732 Add feature to allow for ICMP ECHO instead of UDP datagrams.
734 source networking/udhcp/Config.in
740 Creates, removes, and configures VLAN interfaces
746 wget is a utility for non-interactive download of files from HTTP,
747 HTTPS, and FTP servers.
749 config FEATURE_WGET_STATUSBAR
750 bool "Enable a nifty process meter (+2k)"
754 Enable the transfer progress bar for wget transfers.
756 config FEATURE_WGET_AUTHENTICATION
757 bool "Enable HTTP authentication"
761 Support authenticated HTTP transfers.
763 config FEATURE_WGET_LONG_OPTIONS
764 bool "Enable long options"
766 depends on WGET && GETOPT_LONG
768 Support long options for the wget applet.
773 select FEATURE_SYSLOG
775 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
776 It's a daemon that allocates and defends a dynamically assigned
777 address on the 169.254/16 network, requiring no system administrator.
779 See http://www.zeroconf.org for further details, and "zcip.script"
780 in the busybox examples.