e39fb6f79ecf97c80f519386d036d8e58161a0f4
[oweals/busybox.git] / loginutils / 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 "Login/Password Management Utilities"
7
8 config FEATURE_SHADOWPASSWDS
9         bool "Support for shadow passwords"
10         default n
11         help
12           Build support for shadow password in /etc/shadow.  This file is only
13           readable by root and thus the encrypted passwords are no longer
14           publicly readable.
15
16 config USE_BB_PWD_GRP
17         bool "Use internal password and group functions rather than system functions"
18         default n
19         help
20           If you leave this disabled, busybox will use the system's password
21           and group functions.  And if you are using the GNU C library
22           (glibc), you will then need to install the /etc/nsswitch.conf
23           configuration file and the required /lib/libnss_* libraries in
24           order for the password and group functions to work.  This generally
25           makes your embedded system quite a bit larger.
26
27           Enabling this option will cause busybox to directly access the
28           system's /etc/password, /etc/group files (and your system will be
29           smaller, and I will get fewer emails asking about how glibc NSS
30           works).  When this option is enabled, you will not be able to use
31           PAM to access remote LDAP password servers and whatnot.  And if you
32           want hostname resolution to work with glibc, you still need the
33           /lib/libnss_* libraries.
34
35           If you need to use glibc's nsswitch.conf mechanism
36           (e.g. if user/group database is NOT stored in /etc/passwd etc),
37           you must NOT use this option.
38
39           If you enable this option, it will add about 1.5k to busybox.
40
41 config USE_BB_SHADOW
42         bool "Use busybox shadow password functions"
43         default y
44         depends on USE_BB_PWD_GRP && FEATURE_SHADOWPASSWDS
45         help
46           If you leave this disabled, busybox will use the system's shadow
47           password handling functions.  And if you are using the GNU C library
48           (glibc), you will then need to install the /etc/nsswitch.conf
49           configuration file and the required /lib/libnss_* libraries in
50           order for the shadow password functions to work.  This generally
51           makes your embedded system quite a bit larger.
52
53           Enabling this option will cause busybox to directly access the
54           system's /etc/shadow file when handling shadow passwords.  This
55           makes your system smaller and I will get fewer emails asking about
56           how glibc NSS works).  When this option is enabled, you will not be
57           able to use PAM to access shadow passwords from remote LDAP
58           password servers and whatnot.
59
60 config USE_BB_CRYPT
61         bool "Use internal DES and MD5 crypt functions rather than system functions"
62         default y
63         help
64           If you leave this disabled, busybox will use the system's password
65           and group functions.  Most C libraries use large (~70k)
66           static buffers in these functions, and also combine them
67           with more general DES encryption/decryption routines.
68           For busybox, having large static buffers is undesirable,
69           especially so on NOMMU machines.
70
71           These functions produce results which are identical
72           to corresponding C library functions.
73
74           If you enable this option, it will add about 4.8k to busybox
75           if you are building dynamically linked executable.
76           In static build, it makes executable _smaller_ by about 1.2k.
77
78 config ADDGROUP
79         bool "addgroup"
80         default n
81         help
82           Utility for creating a new group account.
83
84 config FEATURE_ADDUSER_TO_GROUP
85         bool "Support for adding users to groups"
86         default n
87         depends on ADDGROUP
88         help
89           If  called  with two non-option arguments,
90           addgroup will add an existing user to an
91           existing group.
92
93 config DELGROUP
94         bool "delgroup"
95         default n
96         help
97           Utility for deleting a group account.
98
99 config FEATURE_DEL_USER_FROM_GROUP
100         bool "Support for removing users from groups."
101         default n
102         depends on DELGROUP
103         help
104           If called with two non-option arguments, deluser
105           or delgroup will remove an user from a specified group.
106
107 config FEATURE_CHECK_NAMES
108         bool "Enable sanity check on user/group names in adduser and addgroup"
109         default n
110         depends on ADDUSER || ADDGROUP
111         help
112           Enable sanity check on user and group names in adduser and addgroup.
113           To avoid problems, the user or group name should consist only of
114           letters, digits, underscores, periods, at signs and dashes,
115           and not start with a dash (as defined by IEEE Std 1003.1-2001).
116           For compatibility with Samba machine accounts "$" is also supported
117           at the end of the user or group name.
118
119 config ADDUSER
120         bool "adduser"
121         default n
122         help
123           Utility for creating a new user account.
124
125 config FEATURE_ADDUSER_LONG_OPTIONS
126         bool "Enable long options"
127         default n
128         depends on ADDUSER && GETOPT_LONG
129         help
130           Support long options for the adduser applet.
131
132 config DELUSER
133         bool "deluser"
134         default n
135         help
136           Utility for deleting a user account.
137
138 config GETTY
139         bool "getty"
140         default n
141         select FEATURE_SYSLOG
142         help
143           getty lets you log in on a tty, it is normally invoked by init.
144
145 config FEATURE_UTMP
146         bool "Support utmp file"
147         depends on GETTY || LOGIN || SU || WHO
148         default n
149         help
150           The file /var/run/utmp is used to track who is currently logged in.
151
152 config FEATURE_WTMP
153         bool "Support wtmp file"
154         depends on GETTY || LOGIN || SU || LAST
155         default n
156         select FEATURE_UTMP
157         help
158           The file /var/run/wtmp is used to track when user's have logged into
159           and logged out of the system.
160
161 config LOGIN
162         bool "login"
163         default n
164         select FEATURE_SUID
165         select FEATURE_SYSLOG
166         help
167           login is used when signing onto a system.
168
169           Note that Busybox binary must be setuid root for this applet to
170           work properly.
171
172 config PAM
173         bool "Support for PAM (Pluggable Authentication Modules)"
174         default n
175         depends on LOGIN
176         help
177           Use PAM in login(1) instead of direct access to password database.
178
179 config LOGIN_SCRIPTS
180         bool "Support for login scripts"
181         depends on LOGIN
182         default n
183         help
184           Enable this if you want login to execute $LOGIN_PRE_SUID_SCRIPT
185           just prior to switching from root to logged-in user.
186
187 config FEATURE_NOLOGIN
188         bool "Support for /etc/nologin"
189         default y
190         depends on LOGIN
191         help
192           The file /etc/nologin is used by (some versions of) login(1).
193           If it exists, non-root logins are prohibited.
194
195 config FEATURE_SECURETTY
196         bool "Support for /etc/securetty"
197         default y
198         depends on LOGIN
199         help
200           The file /etc/securetty is used by (some versions of) login(1).
201           The file contains the device names of tty lines (one per line,
202           without leading /dev/) on which root is allowed to login.
203
204 config PASSWD
205         bool "passwd"
206         default n
207         select FEATURE_SUID
208         select FEATURE_SYSLOG
209         help
210           passwd changes passwords for user and group accounts.  A normal user
211           may only change the password for his/her own account, the super user
212           may change the password for any account.  The administrator of a group
213           may change the password for the group.
214
215           Note that Busybox binary must be setuid root for this applet to
216           work properly.
217
218 config FEATURE_PASSWD_WEAK_CHECK
219         bool "Check new passwords for weakness"
220         default y
221         depends on PASSWD
222         help
223           With this option passwd will refuse new passwords which are "weak".
224
225 config CRYPTPW
226         bool "cryptpw"
227         default n
228         help
229           Applet for crypting a string.
230
231 config CHPASSWD
232        bool "chpasswd"
233        default n
234        help
235          chpasswd  reads  a  file  of user name and password pairs from
236          standard input and uses this information to update a group of
237          existing users.
238
239 config SU
240         bool "su"
241         default n
242         select FEATURE_SUID
243         select FEATURE_SYSLOG
244         help
245           su is used to become another user during a login session.
246           Invoked without a username, su defaults to becoming the super user.
247
248           Note that Busybox binary must be setuid root for this applet to
249           work properly.
250
251 config FEATURE_SU_SYSLOG
252         bool "Enable su to write to syslog"
253         default y
254         depends on SU
255
256 config FEATURE_SU_CHECKS_SHELLS
257         bool "Enable su to check user's shell to be listed in /etc/shells"
258         depends on SU
259         default y
260
261 config SULOGIN
262         bool "sulogin"
263         default n
264         select FEATURE_SYSLOG
265         help
266           sulogin is invoked when the system goes into single user
267           mode (this is done through an entry in inittab).
268
269 config VLOCK
270         bool "vlock"
271         default n
272         select FEATURE_SUID
273         help
274           Build the "vlock" applet which allows you to lock (virtual) terminals.
275
276           Note that Busybox binary must be setuid root for this applet to
277           work properly.
278
279 endmenu