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_RELOAD_CONFIG_SIGHUP
87 bool "Support reloading the global config file using hup signal"
91 This option enables processing of SIGHUP to reload cached
92 configuration settings.
94 config FEATURE_HTTPD_SETUID
95 bool "Enable -u <user> option"
99 This option allows the server to run as a specific user
100 rather than defaulting to the user that starts the server.
101 Use of this option requires special privileges to change to a
104 config FEATURE_HTTPD_BASIC_AUTH
105 bool "Enable Basic http Authentication"
109 Utilizes password settings from /etc/httpd.conf for basic
110 authentication on a per url basis.
112 config FEATURE_HTTPD_AUTH_MD5
113 bool "Support MD5 crypted passwords for http Authentication"
115 depends on FEATURE_HTTPD_BASIC_AUTH
117 Enables basic per URL authentication from /etc/httpd.conf
120 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
121 bool "Support loading additional MIME types at run-time"
125 This option enables support for additional MIME types at
126 run-time to be specified in the configuration file.
128 config FEATURE_HTTPD_CGI
129 bool "Support Common Gateway Interface (CGI)"
133 This option allows scripts and executables to be invoked
134 when specific URLs are requested.
136 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
137 bool "Enable support for running scripts through an interpreter"
139 depends on FEATURE_HTTPD_CGI
141 This option enables support for running scripts through an
142 interpreter. Turn this on if you want PHP scripts to work
143 properly. You need to supply an additional line in your httpd
145 *.php:/path/to/your/php
147 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
148 bool "Support the REMOTE_PORT environment variable for CGI"
150 depends on FEATURE_HTTPD_CGI
152 Use of this option can assist scripts in generating
153 references that contain a unique port number.
155 config FEATURE_HTTPD_ENCODE_URL_STR
156 bool "Enable the -e option for shell script CGI simplification."
160 This option allows html encoding arbitrary
161 strings for display of the browser. Output goes to stdout.
162 For example, httpd -e "<Hello World>" as
163 "<Hello World>".
169 Ifconfig is used to configure the kernel-resident network interfaces.
171 config FEATURE_IFCONFIG_STATUS
172 bool "Enable status reporting output (+7k)"
176 If ifconfig is called with no arguments it will display the status
177 of the currently active interfaces.
179 config FEATURE_IFCONFIG_SLIP
180 bool "Enable slip-specific options \"keepalive\" and \"outfill\""
184 Allow "keepalive" and "outfill" support for SLIP. If you're not
185 planning on using serial lines, leave this unchecked.
187 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
188 bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
192 Allow the start address for shared memory, start address for I/O,
193 and/or the interrupt line used by the specified device.
195 config FEATURE_IFCONFIG_HW
196 bool "Enable option \"hw\" (ether only)"
200 Set the hardware address of this interface, if the device driver
201 supports this operation. Currently, we only support the 'ether'
204 config FEATURE_IFCONFIG_BROADCAST_PLUS
205 bool "Set the broadcast automatically"
209 Setting this will make ifconfig attempt to find the broadcast
210 automatically if the value '+' is used.
216 Activate or deactivate the specified interfaces. This applet makes
217 use of either "ifconfig" and "route" or the "ip" command to actually
218 configure network interfaces. Therefore, you will probably also want
219 to enable either IFCONFIG and ROUTE, or enable
220 FEATURE_IFUPDOWN_IP and the various IP options. Of
221 course you could use non-busybox versions of these programs, so
222 against my better judgement (since this will surely result in plenty
223 of support questions on the mailing list), I do not force you to
224 enable these additional options. It is up to you to supply either
225 "ifconfig", "route" and "run-parts" or the "ip" command, either
226 via busybox or via standalone utilities.
228 config IFUPDOWN_IFSTATE_PATH
229 string "Absolute path to ifstate file"
230 default "/var/run/ifstate"
232 ifupdown keeps state information in a file called ifstate.
233 Typically it is located in /var/run/ifstate, however
234 some distributions tend to put it in other places
235 (debian, for example, uses /etc/network/run/ifstate).
236 This config option defines location of ifstate.
238 config FEATURE_IFUPDOWN_IP
243 Use the iproute "ip" command to implement "ifup" and "ifdown", rather
244 than the default of using the older 'ifconfig' and 'route' utilities.
246 config FEATURE_IFUPDOWN_IP_BUILTIN
247 bool "Use busybox ip applet"
249 depends on FEATURE_IFUPDOWN_IP
251 select FEATURE_IP_ADDRESS
252 select FEATURE_IP_LINK
253 select FEATURE_IP_ROUTE
255 Use the busybox iproute "ip" applet to implement "ifupdown".
257 If left disabled, you must install the full-blown iproute2
258 utility or the "ifup" and "ifdown" applets will not work.
260 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
261 bool "Use busybox ifconfig and route applets"
263 depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
267 Use the busybox iproute "ifconfig" and "route" applets to
268 implement the "ifup" and "ifdown" utilities.
270 If left disabled, you must install the full-blown ifconfig
271 and route utilities, or the "ifup" and "ifdown" applets will not
274 config FEATURE_IFUPDOWN_IPV4
275 bool "Enable support for IPv4"
279 If you want ifup/ifdown to talk IPv4, leave this on.
281 config FEATURE_IFUPDOWN_IPV6
282 bool "Enable support for IPv6"
284 depends on IFUPDOWN && FEATURE_IPV6
286 If you need support for IPv6, turn this option on.
289 ### config FEATURE_IFUPDOWN_IPX
290 ### bool "Enable support for IPX"
292 ### depends on IFUPDOWN
294 ### If this option is selected you can use busybox to work with IPX
297 config FEATURE_IFUPDOWN_MAPPING
298 bool "Enable mapping support"
302 This enables support for the "mapping" stanza, unless you have
303 a weird network setup you don't need it.
305 config FEATURE_IFUPDOWN_EXTERNAL_DHCP
306 bool "Enable support for external dhcp clients"
310 This enables support for the external dhcp clients. Clients are
311 tried in the following order: dhcpcd, dhclient, pump and udhcpc.
312 Otherwise, if udhcpc applet is enabled, it is used.
313 Otherwise, ifup/ifdown will have no support for DHCP.
318 select FEATURE_SYSLOG
320 Internet superserver daemon
322 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
323 bool "Support echo service"
327 Echo received data internal inetd service
329 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
330 bool "Support discard service"
334 Internet /dev/null internal inetd service
336 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
337 bool "Support time service"
341 Return 32 bit time since 1900 internal inetd service
343 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
344 bool "Support daytime service"
348 Return human-readable time internal inetd service
350 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
351 bool "Support chargen service"
355 Familiar character generator internal inetd service
357 config FEATURE_INETD_RPC
358 bool "Support RPC services"
361 select FEATURE_HAVE_RPC
363 Support Sun-RPC based services
369 The "ip" applet is a TCP/IP interface configuration and routing
370 utility. You generally don't need "ip" to use busybox with
373 config FEATURE_IP_ADDRESS
378 Address manipulation support for the "ip" applet.
380 config FEATURE_IP_LINK
385 Configure network devices with "ip".
387 config FEATURE_IP_ROUTE
392 Add support for routing table management to "ip".
394 config FEATURE_IP_TUNNEL
399 Add support for tunneling commands to "ip".
401 config FEATURE_IP_RULE
406 Add support for rule commands to "ip".
408 config FEATURE_IP_SHORT_FORMS
409 bool "Support short forms of ip commands."
413 Also support short-form of ip <OBJECT> commands:
417 ip tunnel -> iptunnel
420 Say N unless you desparately need the short form of the ip
426 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
431 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
436 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
441 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
446 depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
452 ipcalc takes an IP address and netmask and calculates the
453 resulting broadcast, network, and host range.
455 config FEATURE_IPCALC_FANCY
456 bool "Fancy IPCALC, more options, adds 1 kbyte"
460 Adds the options hostname, prefix and silent to the output of "ipcalc".
462 config FEATURE_IPCALC_LONG_OPTIONS
463 bool "Enable long options"
465 depends on IPCALC && GETOPT_LONG
467 Support long options for the ipcalc applet.
472 select FEATURE_SYSLOG
474 nameif is used to rename network interface by its MAC address.
475 Renamed interfaces MUST be in the down state.
476 It is possible to use a file (default: /etc/mactab)
477 with list of new interface names and MACs.
478 Maximum interface name length: IF_NAMESIZE = 16
479 File fields are separated by space or tab.
482 new_interface_name XX:XX:XX:XX:XX:XX
488 A simple Unix utility which reads and writes data across network
492 bool "Netcat server options (-l)"
496 Allow netcat to act as a server.
499 bool "Netcat extensions (-eiw and filename)"
503 Add -e (support for executing the rest of the command line after
504 making or receiving a successful connection), -i (delay interval for
505 lines sent), -w (timeout for initial connection).
511 netstat prints information about the Linux networking subsystem.
513 config FEATURE_NETSTAT_WIDE
514 bool " Enable wide netstat output"
518 Add support for wide columns. Useful when displaying IPv6 addresses
525 nslookup is a tool to query Internet name servers.
531 ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
532 elicit an ICMP ECHO_RESPONSE from a host or gateway.
537 depends on FEATURE_IPV6 && PING
539 This will give you a ping that can talk IPv6.
545 Simple network port scanner.
547 config FEATURE_FANCY_PING
548 bool "Enable fancy ping output"
552 Make the output from the ping applet include statistics, and at the
553 same time provide full support for ICMP packets.
559 Route displays or manipulates the kernel's IP routing tables.
565 slattach is a small utility to attach network interfaces to serial lines.
571 Telnet is an interface to the TELNET protocol, but is also commonly
572 used to test other simple protocols.
574 config FEATURE_TELNET_TTYPE
575 bool "Pass TERM type to remote host"
579 Setting this option will forward the TERM environment variable to the
580 remote host you are connecting to. This is useful to make sure that
581 things like ANSI colors and other control sequences behave.
583 config FEATURE_TELNET_AUTOLOGIN
584 bool "Pass USER type to remote host"
588 Setting this option will forward the USER environment variable to the
589 remote host you are connecting to. This is useful when you need to
590 log into a machine without telling the username (autologin). This
591 option enables `-a' and `-l USER' arguments.
596 select FEATURE_SYSLOG
598 A daemon for the TELNET protocol, allowing you to log onto the host
599 running the daemon. Please keep in mind that the TELNET protocol
600 sends passwords in plain text. If you can't afford the space for an
601 SSH daemon and you trust your network, you may say 'y' here. As a
602 more secure alternative, you should seriously consider installing the
603 very small Dropbear SSH daemon instead:
604 http://matt.ucc.asn.au/dropbear/dropbear.html
606 Note that for busybox telnetd to work you need several things:
607 First of all, your kernel needs:
611 Next, you need a /dev/pts directory on your root filesystem:
614 drwxr-xr-x 2 root root 0 Sep 23 13:21 /dev/pts/
616 Next you need the pseudo terminal master multiplexer /dev/ptmx:
619 crw-rw-rw- 1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
621 Any /dev/ttyp[0-9]* files you may have can be removed.
622 Next, you need to mount the devpts filesystem on /dev/pts using:
624 mount -t devpts devpts /dev/pts
626 You need to be sure that Busybox has LOGIN and
627 FEATURE_SUID enabled. And finally, you should make
628 certain that Busybox has been installed setuid root:
630 chown root.root /bin/busybox
631 chmod 4755 /bin/busybox
633 with all that done, telnetd _should_ work....
636 config FEATURE_TELNETD_STANDALONE
637 bool "Support standalone telnetd (not inetd only)"
641 Selecting this will make telnetd able to run standalone.
647 This enables the Trivial File Transfer Protocol client program. TFTP
648 is usually used for simple, small transfers such as a root image
649 for a network-enabled bootloader.
651 config FEATURE_TFTP_GET
652 bool "Enable \"get\" command"
656 Add support for the GET command within the TFTP client. This allows
657 a client to retrieve a file from a TFTP server.
659 config FEATURE_TFTP_PUT
660 bool "Enable \"put\" command"
664 Add support for the PUT command within the TFTP client. This allows
665 a client to transfer a file to a TFTP server.
667 config FEATURE_TFTP_BLOCKSIZE
668 bool "Enable \"blocksize\" command"
672 Allow the client to specify the desired block size for transfers.
679 Enable debug settings for tftp. This is useful if you're running
680 into problems with tftp as the protocol doesn't help you much when
681 you run into problems.
687 Utility to trace the route of IP packets
689 config FEATURE_TRACEROUTE_VERBOSE
690 bool "Enable verbose output"
692 depends on TRACEROUTE
694 Add some verbosity to traceroute. This includes amongst other things
695 hostnames and ICMP response types.
697 config FEATURE_TRACEROUTE_SOURCE_ROUTE
698 bool "Enable loose source route"
700 depends on TRACEROUTE
702 Add option to specify a loose source route gateway
705 config FEATURE_TRACEROUTE_USE_ICMP
706 bool "Use ICMP instead of UDP"
708 depends on TRACEROUTE
710 Add feature to allow for ICMP ECHO instead of UDP datagrams.
712 source networking/udhcp/Config.in
718 Creates, removes, and configures VLAN interfaces
724 wget is a utility for non-interactive download of files from HTTP,
725 HTTPS, and FTP servers.
727 config FEATURE_WGET_STATUSBAR
728 bool "Enable a nifty process meter (+2k)"
732 Enable the transfer progress bar for wget transfers.
734 config FEATURE_WGET_AUTHENTICATION
735 bool "Enable HTTP authentication"
739 Support authenticated HTTP transfers.
741 config FEATURE_WGET_LONG_OPTIONS
742 bool "Enable long options"
744 depends on WGET && GETOPT_LONG
746 Support long options for the wget applet.
751 select FEATURE_SYSLOG
753 ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
754 It's a daemon that allocates and defends a dynamically assigned
755 address on the 169.254/16 network, requiring no system administrator.
757 See http://www.zeroconf.org for further details, and "zcip.script"
758 in the busybox examples.