summaryrefslogtreecommitdiff
path: root/networking
diff options
context:
space:
mode:
authorDenys Vlasenko2017-07-27 10:53:09 +0200
committerDenys Vlasenko2017-07-27 10:53:09 +0200
commit68b653b66b0db6b1554806650fb0bebd7af9ef3b (patch)
tree6549966edd734b162fc4f6c88271b1023fa0d013 /networking
parent86d5bf4246a7ba68d220bc6c7a7a3be62119dc12 (diff)
downloadbusybox-68b653b66b0db6b1554806650fb0bebd7af9ef3b.zip
busybox-68b653b66b0db6b1554806650fb0bebd7af9ef3b.tar.gz
config: trim/improve item names and help texts, take 2
Signed-off-by: Denys Vlasenko <vda.linux@googlemail.com>
Diffstat (limited to 'networking')
-rw-r--r--networking/ftpd.c13
-rw-r--r--networking/ifupdown.c4
-rw-r--r--networking/ip.c18
-rw-r--r--networking/telnetd.c2
-rw-r--r--networking/tftp.c16
-rw-r--r--networking/udhcp/Config.src80
-rw-r--r--networking/udhcp/d6_dhcpc.c2
7 files changed, 74 insertions, 61 deletions
diff --git a/networking/ftpd.c b/networking/ftpd.c
index aee00e1..c562c28 100644
--- a/networking/ftpd.c
+++ b/networking/ftpd.c
@@ -18,11 +18,12 @@
//config: Simple FTP daemon. You have to run it via inetd.
//config:
//config:config FEATURE_FTPD_WRITE
-//config: bool "Enable upload commands"
+//config: bool "Enable -w (upload commands)"
//config: default y
//config: depends on FTPD
//config: help
-//config: Enable all kinds of FTP upload commands (-w option)
+//config: Enable -w option. "ftpd -w" will accept upload commands
+//config: such as STOR, STOU, APPE, DELE, MKD, RMD, rename commands.
//config:
//config:config FEATURE_FTPD_ACCEPT_BROKEN_LIST
//config: bool "Enable workaround for RFC-violating clients"
@@ -40,7 +41,13 @@
//config: default y
//config: depends on FTPD
//config: help
-//config: Enable basic system login as seen in telnet etc.
+//config: Require login, and change to logged in user's UID:GID before
+//config: accessing any files. Option "-a USER" allows "anonymous"
+//config: logins (treats them as if USER logged in).
+//config:
+//config: If this option is not selected, ftpd runs with the rights
+//config: of the user it was started under, and does not require login.
+//config: Take care to not launch it under root.
//applet:IF_FTPD(APPLET(ftpd, BB_DIR_USR_SBIN, BB_SUID_DROP))
diff --git a/networking/ifupdown.c b/networking/ifupdown.c
index f8c29ab..c2cfe82 100644
--- a/networking/ifupdown.c
+++ b/networking/ifupdown.c
@@ -59,11 +59,11 @@
//config: than the default of using the older "ifconfig" and "route" utilities.
//config:
//config: If Y: you must install either the full-blown iproute2 package
-//config: or enable "ip" applet in Busybox, or the "ifup" and "ifdown" applets
+//config: or enable "ip" applet in busybox, or the "ifup" and "ifdown" applets
//config: will not work.
//config:
//config: If N: you must install either the full-blown ifconfig and route
-//config: utilities, or enable these applets in Busybox.
+//config: utilities, or enable these applets in busybox.
//config:
//config:config FEATURE_IFUPDOWN_IPV4
//config: bool "Support IPv4"
diff --git a/networking/ip.c b/networking/ip.c
index cca7cbe..8aaeef0 100644
--- a/networking/ip.c
+++ b/networking/ip.c
@@ -14,8 +14,10 @@
//config: select PLATFORM_LINUX
//config: help
//config: The "ip" applet is a TCP/IP interface configuration and routing
-//config: utility. You generally don't need "ip" to use busybox with
-//config: TCP/IP.
+//config: utility.
+//config: Short forms (enabled below) are busybox-specific extensions.
+//config: The standard "ip" utility does not provide them. If you are
+//config: trying to be portable, it's better to use "ip CMD" forms.
//config:
//config:config IPADDR
//config: bool "ipaddr (14 kb)"
@@ -23,7 +25,7 @@
//config: select FEATURE_IP_ADDRESS
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip addr: ipaddr
+//config: Short form of "ip addr"
//config:
//config:config IPLINK
//config: bool "iplink (16 kb)"
@@ -31,7 +33,7 @@
//config: select FEATURE_IP_LINK
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip link: iplink
+//config: Short form of "ip link"
//config:
//config:config IPROUTE
//config: bool "iproute (15 kb)"
@@ -39,7 +41,7 @@
//config: select FEATURE_IP_ROUTE
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip route: iproute
+//config: Short form of "ip route"
//config:
//config:config IPTUNNEL
//config: bool "iptunnel (9.6 kb)"
@@ -47,7 +49,7 @@
//config: select FEATURE_IP_TUNNEL
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip tunnel: iptunnel
+//config: Short form of "ip tunnel"
//config:
//config:config IPRULE
//config: bool "iprule (10 kb)"
@@ -55,7 +57,7 @@
//config: select FEATURE_IP_RULE
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip rule: iprule
+//config: Short form of "ip rule"
//config:
//config:config IPNEIGH
//config: bool "ipneigh (8.3 kb)"
@@ -63,7 +65,7 @@
//config: select FEATURE_IP_NEIGH
//config: select PLATFORM_LINUX
//config: help
-//config: Support short form of ip neigh: ipneigh
+//config: Short form of "ip neigh"
//config:
//config:config FEATURE_IP_ADDRESS
//config: bool "ip address"
diff --git a/networking/telnetd.c b/networking/telnetd.c
index 6e12de0..16c572e 100644
--- a/networking/telnetd.c
+++ b/networking/telnetd.c
@@ -54,7 +54,7 @@
//config:
//config: You need to be sure that busybox has LOGIN and
//config: FEATURE_SUID enabled. And finally, you should make
-//config: certain that Busybox has been installed setuid root:
+//config: certain that busybox has been installed setuid root:
//config:
//config: chown root.root /bin/busybox
//config: chmod 4755 /bin/busybox
diff --git a/networking/tftp.c b/networking/tftp.c
index 947e651..5baa804 100644
--- a/networking/tftp.c
+++ b/networking/tftp.c
@@ -22,15 +22,20 @@
//config: bool "tftp (12 kb)"
//config: default y
//config: help
-//config: This enables the Trivial File Transfer Protocol client program. TFTP
-//config: is usually used for simple, small transfers such as a root image
+//config: Trivial File Transfer Protocol client. TFTP is usually used
+//config: for simple, small transfers such as a root image
//config: for a network-enabled bootloader.
//config:
+//config:config FEATURE_TFTP_PROGRESS_BAR
+//config: bool "Enable progress bar"
+//config: default y
+//config: depends on TFTP
+//config:
//config:config TFTPD
//config: bool "tftpd (10 kb)"
//config: default y
//config: help
-//config: This enables the Trivial File Transfer Protocol server program.
+//config: Trivial File Transfer Protocol server.
//config: It expects that stdin is a datagram socket and a packet
//config: is already pending on it. It will exit after one transfer.
//config: In other words: it should be run from inetd in nowait mode,
@@ -68,11 +73,6 @@
//config: Allow tftp to specify block size, and tftpd to understand
//config: "blksize" and "tsize" options.
//config:
-//config:config FEATURE_TFTP_PROGRESS_BAR
-//config: bool "Enable progress bar"
-//config: default y
-//config: depends on TFTP && FEATURE_TFTP_BLOCKSIZE
-//config:
//config:config TFTP_DEBUG
//config: bool "Enable debug"
//config: default n
diff --git a/networking/udhcp/Config.src b/networking/udhcp/Config.src
index af2fe18..8ab8d30 100644
--- a/networking/udhcp/Config.src
+++ b/networking/udhcp/Config.src
@@ -3,26 +3,14 @@
# see scripts/kbuild/config-language.txt.
#
-INSERT
-
config UDHCPD
- bool "udhcpd (DHCP server)"
+ bool "udhcpd"
default y
select PLATFORM_LINUX
help
udhcpd is a DHCP server geared primarily toward embedded systems,
while striving to be fully functional and RFC compliant.
-config FEATURE_UDHCPD_WRITE_LEASES_EARLY
- bool "Rewrite the lease file at every new acknowledge"
- default y
- depends on UDHCPD
- help
- If selected, udhcpd will write a new file with leases every
- time a new lease has been accepted, thus eliminating the need
- to send SIGUSR1 for the initial writing or updating. Any timed
- rewriting remains undisturbed.
-
config FEATURE_UDHCPD_BASE_IP_ON_MAC
bool "Select IP address based on client MAC"
default n
@@ -37,6 +25,16 @@ config FEATURE_UDHCPD_BASE_IP_ON_MAC
for the same client to (almost always) contain the same
IP address.
+config FEATURE_UDHCPD_WRITE_LEASES_EARLY
+ bool "Rewrite lease file at every new acknowledge"
+ default y
+ depends on UDHCPD
+ help
+ If selected, udhcpd will write a new file with leases every
+ time a new lease has been accepted, thus eliminating the need
+ to send SIGUSR1 for the initial writing or updating. Any timed
+ rewriting remains undisturbed.
+
config DHCPD_LEASES_FILE
string "Absolute path to lease file"
default "/var/lib/misc/udhcpd.leases"
@@ -57,12 +55,12 @@ config DHCPRELAY
bool "dhcprelay (5.8 kb)"
default y
help
- dhcprelay listens for dhcp requests on one or more interfaces
- and forwards these requests to a different interface or dhcp
+ dhcprelay listens for DHCP requests on one or more interfaces
+ and forwards these requests to a different interface or DHCP
server.
config UDHCPC
- bool "udhcpc (DHCP client)"
+ bool "udhcpc"
default y
select PLATFORM_LINUX
help
@@ -102,19 +100,25 @@ config UDHCPC_DEFAULT_SCRIPT
examples/udhcp for a working example. Normally it is safe
to leave this untouched.
+# udhcpc6 config is inserted here:
+INSERT
+
+comment "Common options for DHCP applets"
+ depends on UDHCPD || UDHCPC || UDHCPC6 || DHCPRELAY
+
config FEATURE_UDHCP_PORT
bool "Enable '-P port' option for udhcpd and udhcpc"
default n
- depends on UDHCPD || UDHCPC
+ depends on UDHCPD || UDHCPC || UDHCPC6
help
At the cost of ~300 bytes, enables -P port option.
This feature is typically not needed.
config UDHCP_DEBUG
- int "Maximum verbosity level for udhcp applets (0..9)"
+ int "Maximum verbosity level (0..9)"
default 9
range 0 9
- depends on UDHCPD || UDHCPC || DHCPRELAY
+ depends on UDHCPD || UDHCPC || UDHCPC6 || DHCPRELAY
help
Verbosity can be increased with multiple -v options.
This option controls how high it can be cranked up.
@@ -122,23 +126,6 @@ config UDHCP_DEBUG
Bigger values result in bigger code. Levels above 1
are very verbose and useful for debugging only.
-config FEATURE_UDHCP_RFC3397
- bool "Support RFC3397 domain search (experimental)"
- default y
- depends on UDHCPD || UDHCPC
- help
- If selected, both client and server will support passing of domain
- search lists via option 119, specified in RFC 3397,
- and SIP servers option 120, specified in RFC 3361.
-
-config FEATURE_UDHCP_8021Q
- bool "Support 802.1Q VLAN parameters"
- default y
- depends on UDHCPD || UDHCPC
- help
- If selected, both client and server will support passing of VLAN
- ID and priority via options 132 and 133 as per 802.1Q.
-
config UDHCPC_SLACK_FOR_BUGGY_SERVERS
int "DHCP options slack buffer size"
default 80
@@ -149,10 +136,10 @@ config UDHCPC_SLACK_FOR_BUGGY_SERVERS
field larger than we expect (which might also be considered a
buffer overflow attempt). These packets are normally discarded.
If circumstances beyond your control force you to support such
- servers, this may help. The upper limit (924) makes dhcpc accept
+ servers, this may help. The upper limit (924) makes udhcpc accept
even 1500 byte packets (maximum-sized ethernet packets).
- This option does not make dhcp[cd] emit non-standard
+ This option does not make udhcp[cd] emit non-standard
sized packets.
Known buggy DHCP servers:
@@ -161,3 +148,20 @@ config UDHCPC_SLACK_FOR_BUGGY_SERVERS
maximum size of entire IP packet, and sends packets
which are 28 bytes too large.
Seednet (ISP) VDSL: sends packets 2 bytes too large.
+
+config FEATURE_UDHCP_RFC3397
+ bool "Support RFC 3397 domain search options"
+ default y
+ depends on UDHCPD || UDHCPC
+ help
+ If selected, both client and server will support passing of domain
+ search lists via option 119, specified in RFC 3397,
+ and SIP servers option 120, specified in RFC 3361.
+
+config FEATURE_UDHCP_8021Q
+ bool "Support 802.1Q VLAN parameters options"
+ default y
+ depends on UDHCPD || UDHCPC
+ help
+ If selected, both client and server will support passing of VLAN
+ ID and priority via options 132 and 133 as per 802.1Q.
diff --git a/networking/udhcp/d6_dhcpc.c b/networking/udhcp/d6_dhcpc.c
index 5ebd05d..43081ef 100644
--- a/networking/udhcp/d6_dhcpc.c
+++ b/networking/udhcp/d6_dhcpc.c
@@ -10,7 +10,7 @@
*/
//config:config UDHCPC6
-//config: bool "udhcpc6 (DHCPv6 client, EXPERIMENTAL)"
+//config: bool "udhcpc6"
//config: default n # not yet ready
//config: depends on FEATURE_IPV6
//config: help