2 # For a description of the syntax of this configuration file,
3 # see scripts/kbuild/config-language.txt.
6 menu "Login/Password Management Utilities"
10 config FEATURE_SHADOWPASSWDS
11 bool "Support for shadow passwords"
14 Build support for shadow password in /etc/shadow. This file is only
15 readable by root and thus the encrypted passwords are no longer
19 bool "Use internal password and group functions rather than system functions"
22 If you leave this disabled, busybox will use the system's password
23 and group functions. And if you are using the GNU C library
24 (glibc), you will then need to install the /etc/nsswitch.conf
25 configuration file and the required /lib/libnss_* libraries in
26 order for the password and group functions to work. This generally
27 makes your embedded system quite a bit larger.
29 Enabling this option will cause busybox to directly access the
30 system's /etc/password, /etc/group files (and your system will be
31 smaller, and I will get fewer emails asking about how glibc NSS
32 works). When this option is enabled, you will not be able to use
33 PAM to access remote LDAP password servers and whatnot. And if you
34 want hostname resolution to work with glibc, you still need the
35 /lib/libnss_* libraries.
37 If you need to use glibc's nsswitch.conf mechanism
38 (e.g. if user/group database is NOT stored in /etc/passwd etc),
39 you must NOT use this option.
41 If you enable this option, it will add about 1.5k.
44 bool "Use internal shadow password functions"
46 depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS
48 If you leave this disabled, busybox will use the system's shadow
49 password handling functions. And if you are using the GNU C library
50 (glibc), you will then need to install the /etc/nsswitch.conf
51 configuration file and the required /lib/libnss_* libraries in
52 order for the shadow password functions to work. This generally
53 makes your embedded system quite a bit larger.
55 Enabling this option will cause busybox to directly access the
56 system's /etc/shadow file when handling shadow passwords. This
57 makes your system smaller (and I will get fewer emails asking about
58 how glibc NSS works). When this option is enabled, you will not be
59 able to use PAM to access shadow passwords from remote LDAP
60 password servers and whatnot.
63 bool "Use internal crypt functions"
66 Busybox has internal DES and MD5 crypt functions.
67 They produce results which are identical to corresponding
68 standard C library functions.
70 If you leave this disabled, busybox will use the system's
71 crypt functions. Most C libraries use large (~70k)
72 static buffers there, and also combine them with more general
73 DES encryption/decryption.
75 For busybox, having large static buffers is undesirable,
76 especially on NOMMU machines. Busybox also doesn't need
77 DES encryption/decryption and can do with smaller code.
79 If you enable this option, it will add about 4.8k of code
80 if you are building dynamically linked executable.
81 In static build, it makes code _smaller_ by about 1.2k,
82 and likely many kilobytes less of bss.
84 config USE_BB_CRYPT_SHA
85 bool "Enable SHA256/512 crypt functions"
87 depends on USE_BB_CRYPT
89 Enable this if you have passwords starting with "$5$" or "$6$"
90 in your /etc/passwd or /etc/shadow files. These passwords
91 are hashed using SHA256 and SHA512 algorithms. Support for them
92 was added to glibc in 2008.
93 With this option off, login will fail password check for any
94 user which has password encrypted with these algorithms.
100 Utility for creating a new user account.
102 config FEATURE_ADDUSER_LONG_OPTIONS
103 bool "Enable long options"
105 depends on ADDUSER && LONG_OPTS
107 Support long options for the adduser applet.
109 config FEATURE_CHECK_NAMES
110 bool "Enable sanity check on user/group names in adduser and addgroup"
112 depends on ADDUSER || ADDGROUP
114 Enable sanity check on user and group names in adduser and addgroup.
115 To avoid problems, the user or group name should consist only of
116 letters, digits, underscores, periods, at signs and dashes,
117 and not start with a dash (as defined by IEEE Std 1003.1-2001).
118 For compatibility with Samba machine accounts "$" is also supported
119 at the end of the user or group name.
121 config FIRST_SYSTEM_ID
122 int "First valid system uid or gid for adduser and addgroup"
123 depends on ADDUSER || ADDGROUP
127 First valid system uid or gid for adduser and addgroup
129 config LAST_SYSTEM_ID
130 int "Last valid system uid or gid for adduser and addgroup"
131 depends on ADDUSER || ADDGROUP
135 Last valid system uid or gid for adduser and addgroup
141 Utility for creating a new group account.
143 config FEATURE_ADDGROUP_LONG_OPTIONS
144 bool "Enable long options"
146 depends on ADDGROUP && LONG_OPTS
148 Support long options for the addgroup applet.
150 config FEATURE_ADDUSER_TO_GROUP
151 bool "Support for adding users to groups"
155 If called with two non-option arguments,
156 addgroup will add an existing user to an
163 Utility for deleting a user account.
169 Utility for deleting a group account.
171 config FEATURE_DEL_USER_FROM_GROUP
172 bool "Support for removing users from groups"
176 If called with two non-option arguments, deluser
177 or delgroup will remove an user from a specified group.
182 select FEATURE_SYSLOG
184 getty lets you log in on a tty. It is normally invoked by init.
186 Note that you can save a few bytes by disabling it and
187 using login applet directly.
188 If you need to reset tty attributes before calling login,
189 this script approximates getty:
191 exec </dev/$1 >/dev/$1 2>&1 || exit 1
193 stty sane; stty ispeed 38400; stty ospeed 38400
194 printf "%s login: " "`hostname`"
196 exec /bin/login "$login"
201 select FEATURE_SYSLOG
203 login is used when signing onto a system.
205 Note that Busybox binary must be setuid root for this applet to
208 config LOGIN_SESSION_AS_CHILD
209 bool "Run logged in session in a child process"
213 Run the logged in session in a child process. This allows
214 login to clean up things such as utmp entries or PAM sessions
215 when the login session is complete. If you use PAM, you
216 almost always would want this to be set to Y, else PAM session
217 will not be cleaned up.
220 bool "Support for PAM (Pluggable Authentication Modules)"
224 Use PAM in login(1) instead of direct access to password database.
227 bool "Support for login scripts"
231 Enable this if you want login to execute $LOGIN_PRE_SUID_SCRIPT
232 just prior to switching from root to logged-in user.
234 config FEATURE_NOLOGIN
235 bool "Support for /etc/nologin"
239 The file /etc/nologin is used by (some versions of) login(1).
240 If it exists, non-root logins are prohibited.
242 config FEATURE_SECURETTY
243 bool "Support for /etc/securetty"
247 The file /etc/securetty is used by (some versions of) login(1).
248 The file contains the device names of tty lines (one per line,
249 without leading /dev/) on which root is allowed to login.
254 select FEATURE_SYSLOG
256 passwd changes passwords for user and group accounts. A normal user
257 may only change the password for his/her own account, the super user
258 may change the password for any account. The administrator of a group
259 may change the password for the group.
261 Note that Busybox binary must be setuid root for this applet to
264 config FEATURE_PASSWD_WEAK_CHECK
265 bool "Check new passwords for weakness"
269 With this option passwd will refuse new passwords which are "weak".
275 Encrypts the given password with the crypt(3) libc function
276 using the given salt. Debian has this utility under mkpasswd
277 name. Busybox provides mkpasswd as an alias for cryptpw.
283 Reads a file of user name and password pairs from standard input
284 and uses this information to update a group of existing users.
286 config FEATURE_DEFAULT_PASSWD_ALGO
287 string "Default password encryption method (passwd -a, cryptpw -m parameter)"
289 depends on PASSWD || CRYPTPW
291 Possible choices are "d[es]", "m[d5]", "s[ha256]" or "sha512".
296 select FEATURE_SYSLOG
298 su is used to become another user during a login session.
299 Invoked without a username, su defaults to becoming the super user.
301 Note that Busybox binary must be setuid root for this applet to
304 config FEATURE_SU_SYSLOG
305 bool "Enable su to write to syslog"
309 config FEATURE_SU_CHECKS_SHELLS
310 bool "Enable su to check user's shell to be listed in /etc/shells"
317 select FEATURE_SYSLOG
319 sulogin is invoked when the system goes into single user
320 mode (this is done through an entry in inittab).
326 Build the "vlock" applet which allows you to lock (virtual) terminals.
328 Note that Busybox binary must be setuid root for this applet to