small ipv6 doc changes; nslookup a tiny bit smaller
[oweals/busybox.git] / networking / Config.in
1 #
2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
4 #
5
6 menu "Networking Utilities"
7
8 config FEATURE_IPV6
9         bool "Enable IPv6 support"
10         default n
11         help
12           Enable IPv6 support in busybox.
13           This adds IPv6 support in the networking applets.
14
15 config ARPING
16         bool "arping"
17         default n
18         help
19           Ping hosts by ARP packets
20
21 config DNSD
22         bool "dnsd"
23         default n
24         help
25           Small and static DNS server daemon.
26
27 config ETHER_WAKE
28         bool "ether-wake"
29         default n
30         help
31           Send a magic packet to wake up sleeping machines.
32
33 config FAKEIDENTD
34         bool "fakeidentd"
35         default n
36         select FEATURE_SYSLOG
37         help
38           fakeidentd listens on the ident port and returns a predefined
39           fake value on any query.
40
41 config FTPGET
42         bool "ftpget"
43         default n
44         help
45           Retrieve a remote file via FTP.
46
47 config FTPPUT
48         bool "ftpput"
49         default n
50         help
51           Store a remote file via FTP.
52
53 config FEATURE_FTPGETPUT_LONG_OPTIONS
54         bool "Enable long options in ftpget/ftpput"
55         default n
56         depends on GETOPT_LONG && (FTPGET || FTPPUT)
57         help
58           Support long options for the ftpget/ftpput applet.
59
60 config HOSTNAME
61         bool "hostname"
62         default n
63         help
64           Show or set the system's host name
65
66 config HTTPD
67         bool "httpd"
68         default n
69         help
70           Serve web pages via an HTTP server.
71
72 config FEATURE_HTTPD_WITHOUT_INETD
73         bool "Support using httpd as a daemon (not from inetd)"
74         default n
75         depends on HTTPD
76         help
77           This option enables uid and port options for the httpd applet,
78           and eliminates the need to be called from the inetd server daemon.
79
80 config FEATURE_HTTPD_RELOAD_CONFIG_SIGHUP
81         bool "Support reloading the global config file using hup signal"
82         default n
83         depends on HTTPD && FEATURE_HTTPD_WITHOUT_INETD
84         help
85           This option enables processing of SIGHUP to reload cached
86           configuration settings.
87
88 config FEATURE_HTTPD_SETUID
89         bool "Enable support -u <user> option"
90         default n
91         depends on HTTPD && FEATURE_HTTPD_WITHOUT_INETD
92         help
93           This option allows the server to run as a specific user
94           rather than defaulting to the user that starts the server.
95           Use of this option requires special privileges to change to a
96           different user.
97
98 config FEATURE_HTTPD_BASIC_AUTH
99         bool "Enable Basic http Authentication"
100         default y
101         depends on HTTPD
102         help
103           Utilizes password settings from /etc/httpd.conf for basic
104           authentication on a per url basis.
105
106 config FEATURE_HTTPD_AUTH_MD5
107         bool "Support MD5 crypted passwords for http Authentication"
108         default n
109         depends on FEATURE_HTTPD_BASIC_AUTH
110         help
111           Enables basic per URL authentication from /etc/httpd.conf
112           using md5 passwords.
113
114 config FEATURE_HTTPD_CONFIG_WITH_MIME_TYPES
115         bool "Support loading additional MIME types at run-time"
116         default n
117         depends on HTTPD
118         help
119           This option enables support for additional MIME types at
120           run-time to be specified in the configuration file.
121
122 config FEATURE_HTTPD_CGI
123         bool "Support Common Gateway Interface (CGI)"
124         default y
125         depends on HTTPD
126         help
127           This option allows scripts and executables to be invoked
128           when specific URLs are requested.
129
130 config FEATURE_HTTPD_CONFIG_WITH_SCRIPT_INTERPR
131         bool "Enable support for running scripts through an interpreter"
132         default n
133         depends on FEATURE_HTTPD_CGI
134         help
135           This option enables support for running scripts through an
136           interpreter. Turn this on if you want PHP scripts to work
137           properly. You need to supply an addition line in your httpd
138           config file:
139           *.php:/path/to/your/php
140
141 config FEATURE_HTTPD_SET_REMOTE_PORT_TO_ENV
142         bool "Support the REMOTE_PORT environment variable for CGI"
143         default n
144         depends on FEATURE_HTTPD_CGI
145         help
146           Use of this option can assist scripts in generating
147           references that contain a unique port number.
148
149 config FEATURE_HTTPD_ENCODE_URL_STR
150         bool "Enable the -e option for shell script CGI simplification."
151         default y
152         depends on HTTPD
153         help
154           This option allows html encoding arbitrary
155           strings for display of the browser.  Output goes to stdout.
156           For example, httpd -e "<Hello World>" as
157           "&#60Hello&#32World&#62".
158
159 config IFCONFIG
160         bool "ifconfig"
161         default n
162         help
163           Ifconfig is used to configure the kernel-resident network interfaces.
164
165 config FEATURE_IFCONFIG_STATUS
166         bool "Enable status reporting output (+7k)"
167         default y
168         depends on IFCONFIG
169         help
170           If ifconfig is called with no arguments it will display the status
171           of the currently active interfaces.
172
173 config FEATURE_IFCONFIG_SLIP
174         bool "Enable slip-specific options \"keepalive\" and \"outfill\""
175         default n
176         depends on IFCONFIG
177         help
178           Allow "keepalive" and "outfill" support for SLIP.  If you're not
179           planning on using serial lines, leave this unchecked.
180
181 config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
182         bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
183         default n
184         depends on IFCONFIG
185         help
186           Allow the start address for shared memory, start address for I/O,
187           and/or the interrupt line used by the specified device.
188
189 config FEATURE_IFCONFIG_HW
190         bool "Enable option \"hw\" (ether only)"
191         default y
192         depends on IFCONFIG
193         help
194           Set the hardware address of this interface, if the device driver
195           supports  this  operation.  Currently, we only support the 'ether'
196           class.
197
198 config FEATURE_IFCONFIG_BROADCAST_PLUS
199         bool "Set the broadcast automatically"
200         default n
201         depends on IFCONFIG
202         help
203           Setting this will make ifconfig attempt to find the broadcast
204           automatically if the value '+' is used.
205
206 config IFUPDOWN
207         bool "ifupdown"
208         default n
209         select RUN_PARTS
210         help
211           Activate or deactivate the specified interfaces.  This applet makes
212           use of either "ifconfig" and "route" or the "ip" command to actually
213           configure network interfaces.  Therefore, you will probably also want
214           to enable either IFCONFIG and ROUTE, or enable
215           FEATURE_IFUPDOWN_IP and the various IP options.  Of
216           course you could use non-busybox versions of these programs, so
217           against my better judgement (since this will surely result in plenty
218           of support questions on the mailing list), I do not force you to
219           enable these additional options.  It is up to you to supply either
220           "ifconfig" and "route" or the "ip" command, either via busybox or via
221           standalone utilities.
222
223 config FEATURE_IFUPDOWN_IP
224         bool "Use ip applet"
225         default n
226         depends on IFUPDOWN
227         help
228           Use the iproute "ip" command to implement "ifup" and "ifdown", rather
229           than the default of using the older 'ifconfig' and 'route' utilities.
230
231 config FEATURE_IFUPDOWN_IP_BUILTIN
232         bool "Use busybox ip applet"
233         default y
234         depends on FEATURE_IFUPDOWN_IP
235         select IP
236         select FEATURE_IP_ADDRESS
237         select FEATURE_IP_LINK
238         select FEATURE_IP_ROUTE
239         help
240           Use the busybox iproute "ip" applet to implement "ifupdown".
241
242           If left disabled, you must install the full-blown iproute2
243           utility or the  "ifup" and "ifdown" applets will not work.
244
245 config FEATURE_IFUPDOWN_IFCONFIG_BUILTIN
246         bool "Use busybox ifconfig and route applets"
247         default y
248         depends on IFUPDOWN && !FEATURE_IFUPDOWN_IP
249         select IFCONFIG
250         select ROUTE
251         help
252           Use the busybox iproute "ifconfig" and "route" applets to
253           implement the "ifup" and "ifdown" utilities.
254
255           If left disabled, you must install the full-blown ifconfig
256           and route utilities, or the  "ifup" and "ifdown" applets will not
257           work.
258
259 config FEATURE_IFUPDOWN_IPV4
260         bool "Enable support for IPv4"
261         default y
262         depends on IFUPDOWN
263         help
264           If you want busybox to talk IPv4, leave this on.
265
266 config FEATURE_IFUPDOWN_IPV6
267         bool "Enable support for IPv6"
268         default n
269         depends on IFUPDOWN && FEATURE_IPV6
270         help
271           If you need support for IPv6, turn this option on.
272
273 config FEATURE_IFUPDOWN_IPX
274         bool "Enable support for IPX"
275         default n
276         depends on IFUPDOWN
277         help
278           If this option is selected you can use busybox to work with IPX
279           networks.
280
281 config FEATURE_IFUPDOWN_MAPPING
282         bool "Enable mapping support"
283         default n
284         depends on IFUPDOWN
285         help
286           This enables support for the "mapping" stanza, unless you have
287           a weird network setup you don't need it.
288
289 config INETD
290         bool "inetd"
291         default n
292         select FEATURE_SYSLOG
293         help
294           Internet superserver daemon
295
296 config FEATURE_INETD_SUPPORT_BUILTIN_ECHO
297         bool "Support echo service"
298         default y
299         depends on INETD
300         help
301           Echo received data internal inetd service
302
303 config FEATURE_INETD_SUPPORT_BUILTIN_DISCARD
304         bool "Support discard service"
305         default y
306         depends on INETD
307         help
308           Internet /dev/null internal inetd service
309
310 config FEATURE_INETD_SUPPORT_BUILTIN_TIME
311         bool "Support time service"
312         default y
313         depends on INETD
314         help
315           Return 32 bit time since 1900 internal inetd service
316
317 config FEATURE_INETD_SUPPORT_BUILTIN_DAYTIME
318         bool "Support daytime service"
319         default y
320         depends on INETD
321         help
322           Return human-readable time internal inetd service
323
324 config FEATURE_INETD_SUPPORT_BUILTIN_CHARGEN
325         bool "Support chargen service"
326         default y
327         depends on INETD
328         help
329           Familiar character generator internal inetd service
330
331 config FEATURE_INETD_RPC
332         bool "Support RPC services"
333         default n
334         depends on INETD
335         help
336           Suuport Sun-RPC based services
337
338
339 config IP
340         bool "ip"
341         default n
342         help
343           The "ip" applet is a TCP/IP interface configuration and routing
344           utility.  You generally don't need "ip" to use busybox with
345           TCP/IP.
346
347 config FEATURE_IP_ADDRESS
348         bool "ip address"
349         default y
350         depends on IP
351         help
352           Address manipulation support for the "ip" applet.
353
354 config FEATURE_IP_LINK
355         bool "ip link"
356         default y
357         depends on IP
358         help
359           Configure network devices with "ip".
360
361 config FEATURE_IP_ROUTE
362         bool "ip route"
363         default y
364         depends on IP
365         help
366           Add support for routing table management to "ip".
367
368 config FEATURE_IP_TUNNEL
369         bool "ip tunnel"
370         default n
371         depends on IP
372         help
373           Add support for tunneling commands to "ip".
374
375 config FEATURE_IP_SHORT_FORMS
376         bool "Support short forms of ip commands."
377         default n
378         depends on IP
379         help
380           Also support short-form of ip <OBJECT> commands:
381           ip addr   -> ipaddr
382           ip link   -> iplink
383           ip route  -> iproute
384           ip tunnel -> iptunnel
385
386           Say N unless you desparately need the short form of the ip
387           object commands.
388
389 config IPADDR
390         bool
391         default y
392         depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
393
394 config IPLINK
395         bool
396         default y
397         depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
398
399 config IPROUTE
400         bool
401         default y
402         depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
403
404 config IPTUNNEL
405         bool
406         default y
407         depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
408
409 config IPCALC
410         bool "ipcalc"
411         default n
412         help
413           ipcalc takes an IP address and netmask and calculates the
414           resulting broadcast, network, and host range.
415
416 config FEATURE_IPCALC_FANCY
417         bool "Fancy IPCALC, more options, adds 1 kbyte"
418         default y
419         depends on IPCALC
420         help
421           Adds the options hostname, prefix and silent to the output of "ipcalc".
422
423 config FEATURE_IPCALC_LONG_OPTIONS
424         bool "Enable long options"
425         default n
426         depends on IPCALC && GETOPT_LONG
427         help
428           Support long options for the ipcalc applet.
429
430 config NAMEIF
431         bool "nameif"
432         default n
433         select FEATURE_SYSLOG
434         help
435           nameif is used to rename network interface by its MAC address.
436           Renamed interfaces MUST be in the down state.
437           It is possible to use a file (default: /etc/mactab)
438           with list of new interface names and MACs.
439           Maximum interface name length: IF_NAMESIZE = 16
440           File fields are separated by space or tab.
441           File format:
442           # Comment
443           new_interface_name    XX:XX:XX:XX:XX:XX
444
445 config NC
446         bool "nc"
447         default n
448         help
449           A simple Unix utility which reads and writes data across network
450           connections.
451
452 config NC_SERVER
453         bool "Netcat server options (-lp)"
454         default n
455         depends on NC
456         help
457           Allow netcat to act as a server.
458
459 config NC_EXTRA
460         bool "Netcat extensions (-eiw and filename)"
461         default n
462         depends on NC
463         help
464           Add -e (support for executing the rest of the command line after
465           making or receiving a successful connection), -i (delay interval for
466           lines sent), -w (timeout for initial connection).
467
468 config NETSTAT
469         bool "netstat"
470         default n
471         help
472           netstat prints information about the Linux networking subsystem.
473
474 config NSLOOKUP
475         bool "nslookup"
476         default n
477         help
478           nslookup is a tool to query Internet name servers.
479
480 config PING
481         bool "ping"
482         default n
483         help
484           ping uses the ICMP protocol's mandatory ECHO_REQUEST datagram to
485           elicit an ICMP ECHO_RESPONSE from a host or gateway.
486
487 config FEATURE_FANCY_PING
488         bool "Enable fancy ping output"
489         default y
490         depends on PING
491         help
492           Make the output from the ping applet include statistics, and at the
493           same time provide full support for ICMP packets.
494
495 config PING6
496         bool "ping6"
497         default n
498         depends on FEATURE_IPV6
499         help
500           This will give you a ping that can talk IPv6.
501
502 config FEATURE_FANCY_PING6
503         bool "Enable fancy ping6 output"
504         default y
505         depends on PING6
506         help
507           Make the output from the ping6 applet include statistics, and at the
508           same time provide full support for ICMP packets.
509
510 config ROUTE
511         bool "route"
512         default n
513         help
514           Route displays or manipulates the kernel's IP routing tables.
515
516 config TELNET
517         bool "telnet"
518         default n
519         help
520           Telnet is an interface to the TELNET protocol, but is also commonly
521           used to test other simple protocols.
522
523 config FEATURE_TELNET_TTYPE
524         bool "Pass TERM type to remote host"
525         default y
526         depends on TELNET
527         help
528           Setting this option will forward the TERM environment variable to the
529           remote host you are connecting to.  This is useful to make sure that
530           things like ANSI colors and other control sequences behave.
531
532 config FEATURE_TELNET_AUTOLOGIN
533         bool "Pass USER type to remote host"
534         default y
535         depends on TELNET
536         help
537           Setting this option will forward the USER environment variable to the
538           remote host you are connecting to. This is useful when you need to
539           log into a machine without telling the username (autologin). This
540           option enables `-a' and `-l USER' arguments.
541
542 config TELNETD
543         bool "telnetd"
544         default n
545         select FEATURE_SYSLOG
546         help
547           A daemon for the TELNET protocol, allowing you to log onto the host
548           running the daemon.  Please keep in mind that the TELNET protocol
549           sends passwords in plain text.  If you can't afford the space for an
550           SSH daemon and you trust your network, you may say 'y' here.  As a
551           more secure alternative, you should seriously consider installing the
552           very small Dropbear SSH daemon instead:
553                 http://matt.ucc.asn.au/dropbear/dropbear.html
554
555           Note that for busybox telnetd to work you need several things:
556           First of all, your kernel needs:
557                   UNIX98_PTYS=y
558                   DEVPTS_FS=y
559
560           Next, you need a /dev/pts directory on your root filesystem:
561
562                   $ ls -ld /dev/pts
563                   drwxr-xr-x  2 root root 0 Sep 23 13:21 /dev/pts/
564
565           Next you need the pseudo terminal master multiplexer /dev/ptmx:
566
567                   $ ls -la /dev/ptmx
568                   crw-rw-rw-  1 root tty 5, 2 Sep 23 13:55 /dev/ptmx
569
570           Any /dev/ttyp[0-9]* files you may have can be removed.
571           Next, you need to mount the devpts filesystem on /dev/pts using:
572
573                   mount -t devpts devpts /dev/pts
574
575           You need to be sure that Busybox has LOGIN and
576           FEATURE_SUID enabled.  And finally, you should make
577           certain that Busybox has been installed setuid root:
578
579                 chown root.root /bin/busybox
580                 chmod 4755 /bin/busybox
581
582           with all that done, telnetd _should_ work....
583
584
585 config FEATURE_TELNETD_INETD
586         bool "Support call from inetd only"
587         default n
588         depends on TELNETD
589         help
590           Selecting this will make telnetd only callable from inetd,
591           removing the standalone support.
592
593 config TFTP
594         bool "tftp"
595         default n
596         help
597           This enables the Trivial File Transfer Protocol client program.  TFTP
598           is usually used for simple, small transfers such as a root image
599           for a network-enabled bootloader.
600
601 config FEATURE_TFTP_GET
602         bool "Enable \"get\" command"
603         default y
604         depends on TFTP
605         help
606           Add support for the GET command within the TFTP client.  This allows
607           a client to retrieve a file from a TFTP server.
608
609 config FEATURE_TFTP_PUT
610         bool "Enable \"put\" command"
611         default y
612         depends on TFTP
613         help
614           Add support for the PUT command within the TFTP client.  This allows
615           a client to transfer a file to a TFTP server.
616
617 config FEATURE_TFTP_BLOCKSIZE
618         bool "Enable \"blocksize\" command"
619         default n
620         depends on TFTP
621         help
622           Allow the client to specify the desired block size for transfers.
623
624 config DEBUG_TFTP
625         bool "Enable debug"
626         default n
627         depends on TFTP
628         help
629           Enable debug settings for tftp.  This is useful if you're running
630           into problems with tftp as the protocol doesn't help you much when
631           you run into problems.
632
633 config TRACEROUTE
634         bool "traceroute"
635         default n
636         help
637           Utility to trace the route of IP packets
638
639 config FEATURE_TRACEROUTE_VERBOSE
640         bool "Enable verbose output"
641         default n
642         depends on TRACEROUTE
643         help
644           Add some verbosity to traceroute.  This includes amongst other things
645           hostnames and ICMP response types.
646
647 config FEATURE_TRACEROUTE_SOURCE_ROUTE
648         bool "Enable loose source route"
649         default n
650         depends on TRACEROUTE
651         help
652           Add option to specify a loose source route gateway
653           (8 maximum).
654
655 config FEATURE_TRACEROUTE_USE_ICMP
656         bool "Use ICMP instead of UDP"
657         default n
658         depends on TRACEROUTE
659         help
660           Add feature to allow for ICMP ECHO instead of UDP datagrams.
661
662 source networking/udhcp/Config.in
663
664 config VCONFIG
665         bool "vconfig"
666         default n
667         help
668           Creates, removes, and configures VLAN interfaces
669
670 config WGET
671         bool "wget"
672         default n
673         help
674           wget is a utility for non-interactive download of files from HTTP,
675           HTTPS, and FTP servers.
676
677 config FEATURE_WGET_STATUSBAR
678         bool "Enable a nifty process meter (+2k)"
679         default y
680         depends on WGET
681         help
682           Enable the transfer progress bar for wget transfers.
683
684 config FEATURE_WGET_AUTHENTICATION
685         bool "Enable HTTP authentication"
686         default y
687         depends on WGET
688         help
689           Support authenticated HTTP transfers.
690
691 config FEATURE_WGET_IP6_LITERAL
692         bool "Enable IPv6 literal addresses"
693         default y
694         depends on WGET && FEATURE_IPV6
695         help
696           Support IPv6 address literal notation in URLs.
697
698 config FEATURE_WGET_LONG_OPTIONS
699         bool "Enable long options"
700         default n
701         depends on WGET && GETOPT_LONG
702         help
703           Support long options for the wget applet.
704
705 config ZCIP
706         bool "zcip"
707         default n
708         select FEATURE_SYSLOG
709         help
710           ZCIP provides ZeroConf IPv4 address selection, according to RFC 3927.
711           It's a daemon that allocates and defends a dynamically assigned
712           address on the 169.254/16 network, requiring no system administrator.
713
714           See http://www.zeroconf.org for further details, and "zcip.script"
715           in the busybox examples.
716
717 endmenu