Ahem: add new faq entry to list at top of FAQ.html
[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 CONFIG_USE_BB_PWD_GRP
9         bool "Use internal password and group functions rather than system functions"
10         default n
11         help
12             If you leave this disabled, busybox will use the system's password
13             and group functions.  And if you are using the GNU C library
14             (glibc), you will then need to install the /etc/nsswitch.conf
15             configuration file and the required /lib/libnss_* libraries in
16             order for the password and group functions to work.  This generally
17             makes your embedded system quite a bit larger.
18
19             Enabling this option will cause busybox to directly access the
20             system's /etc/password, /etc/group files (and your system will be
21             smaller, and I will get fewer emails asking about how glibc NSS
22             works).  When this option is enabled, you will not be able to use
23             PAM to access remote LDAP password servers and whatnot.  And if you
24             want hostname resolution to work with glibc, you still need the
25             /lib/libnss_* libraries.
26
27             If you enable this option, it will add about 1.5k to busybox.
28
29
30 config CONFIG_ADDGROUP
31         bool "addgroup"
32         default n
33         help
34           Utility for creating a new group account.
35
36 config CONFIG_DELGROUP
37         bool "delgroup"
38         default n
39         help
40           Utility for deleting a group account.
41
42 config CONFIG_ADDUSER
43         bool "adduser"
44         default n
45         help
46           Utility for creating a new user account.
47
48 config CONFIG_DELUSER
49         bool "deluser"
50         default n
51         help
52           Utility for deleting a user account.
53
54 config CONFIG_GETTY
55         bool "getty"
56         default n
57         help
58           getty lets you log in on a tty, it is normally invoked by init.
59
60 config CONFIG_FEATURE_UTMP
61         bool "  Support utmp file"
62         depends on CONFIG_GETTY || CONFIG_LOGIN || CONFIG_SU || CONFIG_WHO 
63         default n
64         help
65           The file /var/run/utmp is used to track who is currently logged in.
66
67 config CONFIG_FEATURE_WTMP
68         bool "  Support wtmp file"
69         depends on CONFIG_GETTY || CONFIG_LOGIN || CONFIG_SU || CONFIG_LAST
70         default n
71         select CONFIG_FEATURE_UTMP
72         help
73           The file /var/run/wtmp is used to track when user's have logged into 
74           and logged out of the system.
75
76 config CONFIG_LOGIN
77         bool "login"
78         default n
79         select CONFIG_FEATURE_SUID
80         help
81           login is used when signing onto a system.
82
83           Note that Busybox binary must be setuid root for this applet to
84           work properly.
85
86 config CONFIG_FEATURE_SECURETTY
87         bool "  Support for /etc/securetty"
88         default y
89         depends on CONFIG_LOGIN
90         help
91           The file  /etc/securetty  is used by (some versions of) login(1).
92           The file contains the device names of tty lines (one per line,
93           without leading /dev/) on which root is allowed to login.
94
95 config CONFIG_PASSWD
96         bool "passwd"
97         default n
98         select CONFIG_FEATURE_SUID
99         help
100           passwd changes passwords for user and group accounts.  A normal user
101           may only change the password for his/her own account, the super user
102           may change the password for any account.  The administrator of a group
103           may change the password for the group.
104
105           Note that Busybox binary must be setuid root for this applet to
106           work properly.
107
108 config CONFIG_SU
109         bool "su"
110         default n
111         select CONFIG_FEATURE_SUID
112         help
113           su is used to become another user during a login session.
114           Invoked without a username, su defaults to becoming the super user.
115
116           Note that Busybox binary must be setuid root for this applet to
117           work properly.
118
119 config CONFIG_SULOGIN
120         bool "sulogin"
121         default n
122         help
123           sulogin is invoked when the system goes into single user
124           mode (this is done through an entry in inittab).
125
126 config CONFIG_VLOCK
127         bool "vlock"
128         default n
129         select CONFIG_FEATURE_SUID
130         help
131           Build the "vlock" applet which allows you to lock (virtual) terminals.
132
133           Note that Busybox binary must be setuid root for this applet to
134           work properly.
135
136 comment "Common options for adduser, deluser, login, su"
137         depends on CONFIG_ADDUSER || CONFIG_DELUSER || CONFIG_LOGIN || CONFIG_SU
138
139 config CONFIG_FEATURE_SHADOWPASSWDS
140         bool "Support for shadow passwords"
141         default n
142         depends on CONFIG_ADDUSER || CONFIG_DELUSER || CONFIG_LOGIN || CONFIG_SU
143         help
144           Build support for shadow password in /etc/shadow.  This file is only
145           readable by root and thus the encrypted passwords are no longer
146           publicly readable.
147
148 config CONFIG_USE_BB_SHADOW
149         bool "  Use busybox shadow password functions"
150         default n
151         depends on CONFIG_USE_BB_PWD_GRP && CONFIG_FEATURE_SHADOWPASSWDS
152         help
153             If you leave this disabled, busybox will use the system's shadow
154             password handling functions.  And if you are using the GNU C library
155             (glibc), you will then need to install the /etc/nsswitch.conf
156             configuration file and the required /lib/libnss_* libraries in
157             order for the shadow password functions to work.  This generally
158             makes your embedded system quite a bit larger.
159
160             Enabling this option will cause busybox to directly access the
161             system's /etc/shadow file when handling shadow passwords.  This
162             makes your system smaller and I will get fewer emails asking about
163             how glibc NSS works).  When this option is enabled, you will not be
164             able to use PAM to access shadow passwords from remote LDAP
165             password servers and whatnot.
166
167 endmenu
168