even more of help text fixes

[oweals/busybox.git] / loginutils / Config.in

diff --git a/loginutils/Config.in b/loginutils/Config.in
index 99265519ed1951b1d868c79b950a3a6f903d179d..c3c8dd513dbedda50cf757af9836942b13ba6998 100644 (file)
--- a/loginutils/Config.in
+++ b/loginutils/Config.in
@@ -5,7 +5,7 @@
 
 menu "Login/Password Management Utilities"
 
 
 menu "Login/Password Management Utilities"
 

-config CONFIG_FEATURE_SHADOWPASSWDS
+config FEATURE_SHADOWPASSWDS

        bool "Support for shadow passwords"
        default n
        help
        bool "Support for shadow passwords"
        default n
        help


@@ -13,115 +13,203 @@ config CONFIG_FEATURE_SHADOWPASSWDS
          readable by root and thus the encrypted passwords are no longer
          publicly readable.
 
          readable by root and thus the encrypted passwords are no longer
          publicly readable.
 

-config CONFIG_USE_BB_SHADOW
-       bool "  Use busybox shadow password functions"
-       default y
-       depends on CONFIG_USE_BB_PWD_GRP && CONFIG_FEATURE_SHADOWPASSWDS
-       help
-           If you leave this disabled, busybox will use the system's shadow
-           password handling functions.  And if you are using the GNU C library
-           (glibc), you will then need to install the /etc/nsswitch.conf
-           configuration file and the required /lib/libnss_* libraries in
-           order for the shadow password functions to work.  This generally
-           makes your embedded system quite a bit larger.
-
-           Enabling this option will cause busybox to directly access the
-           system's /etc/shadow file when handling shadow passwords.  This
-           makes your system smaller and I will get fewer emails asking about
-           how glibc NSS works).  When this option is enabled, you will not be
-           able to use PAM to access shadow passwords from remote LDAP
-           password servers and whatnot.
-
-config CONFIG_USE_BB_PWD_GRP
+config USE_BB_PWD_GRP

        bool "Use internal password and group functions rather than system functions"
        default n
        help
        bool "Use internal password and group functions rather than system functions"
        default n
        help

-           If you leave this disabled, busybox will use the system's password
-           and group functions.  And if you are using the GNU C library
-           (glibc), you will then need to install the /etc/nsswitch.conf
-           configuration file and the required /lib/libnss_* libraries in
-           order for the password and group functions to work.  This generally
-           makes your embedded system quite a bit larger.
+         If you leave this disabled, busybox will use the system's password
+         and group functions.  And if you are using the GNU C library
+         (glibc), you will then need to install the /etc/nsswitch.conf
+         configuration file and the required /lib/libnss_* libraries in
+         order for the password and group functions to work.  This generally
+         makes your embedded system quite a bit larger.
+
+         Enabling this option will cause busybox to directly access the
+         system's /etc/password, /etc/group files (and your system will be
+         smaller, and I will get fewer emails asking about how glibc NSS
+         works).  When this option is enabled, you will not be able to use
+         PAM to access remote LDAP password servers and whatnot.  And if you
+         want hostname resolution to work with glibc, you still need the
+         /lib/libnss_* libraries.
+
+         If you need to use glibc's nsswitch.conf mechanism
+         (e.g. if user/group database is NOT stored in /etc/passwd etc),
+         you must NOT use this option.
+
+         If you enable this option, it will add about 1.5k.
+
+config USE_BB_SHADOW
+       bool "Use internal shadow password functions"
+       default y
+       depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS
+       help
+         If you leave this disabled, busybox will use the system's shadow
+         password handling functions.  And if you are using the GNU C library
+         (glibc), you will then need to install the /etc/nsswitch.conf
+         configuration file and the required /lib/libnss_* libraries in
+         order for the shadow password functions to work.  This generally
+         makes your embedded system quite a bit larger.
+
+         Enabling this option will cause busybox to directly access the
+         system's /etc/shadow file when handling shadow passwords.  This
+         makes your system smaller (and I will get fewer emails asking about
+         how glibc NSS works).  When this option is enabled, you will not be
+         able to use PAM to access shadow passwords from remote LDAP
+         password servers and whatnot.
+
+config USE_BB_CRYPT
+       bool "Use internal DES and MD5 crypt functions"
+       default y
+       help
+         Busybox has internal DES and MD5 crypt functions.
+         They produce results which are identical to corresponding
+         standard C library functions.

 
 

-           Enabling this option will cause busybox to directly access the
-           system's /etc/password, /etc/group files (and your system will be
-           smaller, and I will get fewer emails asking about how glibc NSS
-           works).  When this option is enabled, you will not be able to use
-           PAM to access remote LDAP password servers and whatnot.  And if you
-           want hostname resolution to work with glibc, you still need the
-           /lib/libnss_* libraries.
+         If you leave this disabled, busybox will use the system's
+         crypt functions.  Most C libraries use large (~70k)
+         static buffers there, and also combine them with more general
+         DES encryption/decryption.

 
 

-           If you enable this option, it will add about 1.5k to busybox.
+         For busybox, having large static buffers is undesirable,
+         especially on NOMMU machines. Busybox also doesn't
+         need DES encryption/decryption and can do with smaller code.

 
 

-config CONFIG_ADDGROUP
+         If you enable this option, it will add about 4.8k of code
+         if you are building dynamically linked executable.
+         In static build, it makes code _smaller_ by about 1.2k,
+         and likely many kilobytes less of bss.
+
+config ADDGROUP

        bool "addgroup"
        default n
        help
          Utility for creating a new group account.
 
        bool "addgroup"
        default n
        help
          Utility for creating a new group account.
 

-config CONFIG_DELGROUP
+config FEATURE_ADDUSER_TO_GROUP
+       bool "Support for adding users to groups"
+       default n
+       depends on ADDGROUP
+       help
+         If  called  with two non-option arguments,
+         addgroup will add an existing user to an
+         existing group.
+
+config DELGROUP

        bool "delgroup"
        default n
        help
          Utility for deleting a group account.
 
        bool "delgroup"
        default n
        help
          Utility for deleting a group account.
 

-config CONFIG_ADDUSER
+config FEATURE_DEL_USER_FROM_GROUP
+       bool "Support for removing users from groups."
+       default n
+       depends on DELGROUP
+       help
+         If called with two non-option arguments, deluser
+         or delgroup will remove an user from a specified group.
+
+config FEATURE_CHECK_NAMES
+       bool "Enable sanity check on user/group names in adduser and addgroup"
+       default n
+       depends on ADDUSER || ADDGROUP
+       help
+         Enable sanity check on user and group names in adduser and addgroup.
+         To avoid problems, the user or group name should consist only of
+         letters, digits, underscores, periods, at signs and dashes,
+         and not start with a dash (as defined by IEEE Std 1003.1-2001).
+         For compatibility with Samba machine accounts "$" is also supported
+         at the end of the user or group name.
+
+config ADDUSER

        bool "adduser"
        default n
        help
          Utility for creating a new user account.
 
        bool "adduser"
        default n
        help
          Utility for creating a new user account.
 

-config CONFIG_DELUSER
+config FEATURE_ADDUSER_LONG_OPTIONS
+       bool "Enable long options"
+       default n
+       depends on ADDUSER && GETOPT_LONG
+       help
+         Support long options for the adduser applet.
+
+config DELUSER

        bool "deluser"
        default n
        help
          Utility for deleting a user account.
 
        bool "deluser"
        default n
        help
          Utility for deleting a user account.
 

-config CONFIG_GETTY
+config GETTY

        bool "getty"
        default n
        bool "getty"
        default n

+       select FEATURE_SYSLOG

        help
          getty lets you log in on a tty, it is normally invoked by init.
 
        help
          getty lets you log in on a tty, it is normally invoked by init.
 

-config CONFIG_FEATURE_UTMP
+config FEATURE_UTMP

        bool "Support utmp file"
        bool "Support utmp file"

-       depends on CONFIG_GETTY || CONFIG_LOGIN || CONFIG_SU || CONFIG_WHO
+       depends on GETTY || LOGIN || SU || WHO

        default n
        help
          The file /var/run/utmp is used to track who is currently logged in.
 
        default n
        help
          The file /var/run/utmp is used to track who is currently logged in.
 

-config CONFIG_FEATURE_WTMP
+config FEATURE_WTMP

        bool "Support wtmp file"
        bool "Support wtmp file"

-       depends on CONFIG_GETTY || CONFIG_LOGIN || CONFIG_SU || CONFIG_LAST
+       depends on GETTY || LOGIN || SU || LAST

        default n
        default n

-       select CONFIG_FEATURE_UTMP
+       select FEATURE_UTMP

        help
          The file /var/run/wtmp is used to track when user's have logged into
          and logged out of the system.
 
        help
          The file /var/run/wtmp is used to track when user's have logged into
          and logged out of the system.
 

-config CONFIG_LOGIN
+config LOGIN

        bool "login"
        default n
        bool "login"
        default n

-       select CONFIG_FEATURE_SUID
+       select FEATURE_SUID
+       select FEATURE_SYSLOG

        help
          login is used when signing onto a system.
 
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 
        help
          login is used when signing onto a system.
 
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 

-config CONFIG_FEATURE_SECURETTY
+config PAM
+       bool "Support for PAM (Pluggable Authentication Modules)"
+       default n
+       depends on LOGIN
+       help
+         Use PAM in login(1) instead of direct access to password database.
+
+config LOGIN_SCRIPTS
+       bool "Support for login scripts"
+       depends on LOGIN
+       default n
+       help
+         Enable this if you want login to execute $LOGIN_PRE_SUID_SCRIPT
+         just prior to switching from root to logged-in user.
+
+config FEATURE_NOLOGIN
+       bool "Support for /etc/nologin"
+       default y
+       depends on LOGIN
+       help
+         The file /etc/nologin is used by (some versions of) login(1).
+         If it exists, non-root logins are prohibited.
+
+config FEATURE_SECURETTY

        bool "Support for /etc/securetty"
        default y
        bool "Support for /etc/securetty"
        default y

-       depends on CONFIG_LOGIN
+       depends on LOGIN

        help
        help

-         The file  /etc/securetty  is used by (some versions of) login(1).
+         The file /etc/securetty is used by (some versions of) login(1).

          The file contains the device names of tty lines (one per line,
          without leading /dev/) on which root is allowed to login.
 
          The file contains the device names of tty lines (one per line,
          without leading /dev/) on which root is allowed to login.
 

-config CONFIG_PASSWD
+config PASSWD

        bool "passwd"
        default n
        bool "passwd"
        default n

-       select CONFIG_FEATURE_SUID
+       select FEATURE_SUID
+       select FEATURE_SYSLOG

        help
          passwd changes passwords for user and group accounts.  A normal user
          may only change the password for his/her own account, the super user
        help
          passwd changes passwords for user and group accounts.  A normal user
          may only change the password for his/her own account, the super user


@@ -131,10 +219,32 @@ config CONFIG_PASSWD
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 

-config CONFIG_SU
+config FEATURE_PASSWD_WEAK_CHECK
+       bool "Check new passwords for weakness"
+       default y
+       depends on PASSWD
+       help
+         With this option passwd will refuse new passwords which are "weak".
+
+config CRYPTPW
+       bool "cryptpw"
+       default n
+       help
+         Applet for crypting a string.
+
+config CHPASSWD
+       bool "chpasswd"
+       default n
+       help
+         chpasswd  reads  a  file  of user name and password pairs from
+         standard input and uses this information to update a group of
+         existing users.
+
+config SU

        bool "su"
        default n
        bool "su"
        default n

-       select CONFIG_FEATURE_SUID
+       select FEATURE_SUID
+       select FEATURE_SYSLOG

        help
          su is used to become another user during a login session.
          Invoked without a username, su defaults to becoming the super user.
        help
          su is used to become another user during a login session.
          Invoked without a username, su defaults to becoming the super user.


@@ -142,24 +252,28 @@ config CONFIG_SU
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 
          Note that Busybox binary must be setuid root for this applet to
          work properly.
 

-config CONFIG_SU_SYSLOG
-       bool "Support for syslog in su"
+config FEATURE_SU_SYSLOG
+       bool "Enable su to write to syslog"

        default y
        default y

-       depends on CONFIG_SU
-       help
-         Enables support for syslog in su.
+       depends on SU

 
 

-config CONFIG_SULOGIN
+config FEATURE_SU_CHECKS_SHELLS
+       bool "Enable su to check user's shell to be listed in /etc/shells"
+       depends on SU
+       default y
+
+config SULOGIN

        bool "sulogin"
        default n
        bool "sulogin"
        default n

+       select FEATURE_SYSLOG

        help
          sulogin is invoked when the system goes into single user
          mode (this is done through an entry in inittab).
 
        help
          sulogin is invoked when the system goes into single user
          mode (this is done through an entry in inittab).
 

-config CONFIG_VLOCK
+config VLOCK

        bool "vlock"
        default n
        bool "vlock"
        default n

-       select CONFIG_FEATURE_SUID
+       select FEATURE_SUID

        help
          Build the "vlock" applet which allows you to lock (virtual) terminals.
 
        help
          Build the "vlock" applet which allows you to lock (virtual) terminals.
 


@@ -167,4 +281,3 @@ config CONFIG_VLOCK
          work properly.
 
 endmenu
          work properly.
 
 endmenu

-