2 # /etc/login.defs - Configuration control definitions for the shadow package.
4 # $Id: login.defs 3189 2010-03-26 11:53:06Z nekral-guest $
8 # Delay in seconds before being allowed another attempt after a login failure
9 # Note: When PAM is used, some modules may enfore a minimal delay (e.g.
10 # pam_unix enforces a 2s delay)
15 # Enable logging and display of /var/log/faillog login failure info.
20 # Enable display of unknown usernames when login failures are recorded.
25 # Enable logging of successful logins
30 # Enable logging and display of /var/log/lastlog login time info.
35 # Enable checking and display of mailbox status upon login.
37 # Disable if the shell startup files already check for mail
38 # ("mailx -e" or equivalent).
43 # Enable additional checks upon password changes.
45 OBSCURE_CHECKS_ENAB yes
48 # Enable checking of time restrictions specified in /etc/porttime.
50 PORTTIME_CHECKS_ENAB yes
53 # Enable setting of ulimit, umask, and niceness from passwd gecos field.
58 # Enable "syslog" logging of su activity - in addition to sulog file logging.
59 # SYSLOG_SG_ENAB does the same for newgrp and sg.
65 # If defined, either full pathname of a file containing device names or
66 # a ":" delimited list of device names. Root logins will be allowed only
69 CONSOLE /etc/securetty
70 #CONSOLE console:tty01:tty02:tty03:tty04
73 # If defined, all su activity is logged to this file.
75 #SULOG_FILE /var/log/sulog
78 # If defined, ":" delimited list of "message of the day" files to
79 # be displayed upon login.
82 #MOTD_FILE /etc/motd:/usr/lib/news/news-motd
85 # If defined, this file will be output before each login prompt.
87 #ISSUE_FILE /etc/issue
90 # If defined, file which maps tty line to TERM environment parameter.
91 # Each line of the file is in a format something like "vt100 tty01".
93 #TTYTYPE_FILE /etc/ttytype
96 # If defined, login failures will be logged here in a utmp format.
97 # last, when invoked as lastb, will read /var/log/btmp, so...
99 FTMP_FILE /var/log/btmp
102 # If defined, name of file whose presence which will inhibit non-root
103 # logins. The contents of this file should be a message indicating
104 # why logins are inhibited.
106 NOLOGINS_FILE /etc/nologin
109 # If defined, the command name to display when running "su -". For
110 # example, if this is defined as "su" then a "ps" will display the
111 # command is "-su". If not defined, then "ps" would display the
112 # name of the shell actually being run, e.g. something like "-sh".
118 # Directory where mailboxes reside, _or_ name of file, relative to the
119 # home directory. If you _do_ define both, MAIL_DIR takes precedence.
125 # If defined, file which inhibits all the usual chatter during the login
126 # sequence. If a full pathname, then hushed mode will be enabled if the
127 # user's name or shell are found in the file. If not a full pathname, then
128 # hushed mode will be enabled if the file exists in the user's home directory.
130 HUSHLOGIN_FILE .hushlogin
131 #HUSHLOGIN_FILE /etc/hushlogins
134 # If defined, either a TZ environment parameter spec or the
135 # fully-rooted pathname of a file containing such a spec.
141 # If defined, an HZ environment parameter spec.
149 # *REQUIRED* The default PATH settings, for superuser and normal users.
151 # (they are minimal, add the rest in the shell startup files)
152 ENV_SUPATH PATH=/sbin:/bin:/usr/sbin:/usr/bin
153 ENV_PATH PATH=/bin:/usr/bin
156 # Terminal permissions
158 # TTYGROUP Login tty will be assigned this group ownership.
159 # TTYPERM Login tty will be set to this permission.
161 # If you have a "write" program which is "setgid" to a special group
162 # which owns the terminals, define TTYGROUP to the group number and
163 # TTYPERM to 0620. Otherwise leave TTYGROUP commented out and assign
164 # TTYPERM to either 622 or 600.
170 # Login configuration initializations:
172 # ERASECHAR Terminal ERASE character ('\010' = backspace).
173 # KILLCHAR Terminal KILL character ('\025' = CTRL/U).
174 # ULIMIT Default "ulimit" value.
176 # The ERASECHAR and KILLCHAR are used only on System V machines.
177 # The ULIMIT is used only if the system supports it.
178 # (now it works with setrlimit too; ulimit is in 512-byte units)
180 # Prefix these values with "0" to get octal, "0x" to get hexadecimal.
186 # Default initial "umask" value used by login on non-PAM enabled systems.
187 # Default "umask" value for pam_umask on PAM enabled systems.
188 # UMASK is also used by useradd and newusers to set the mode of new home
190 # 022 is the default value, but 027, or even 077, could be considered
191 # better for privacy. There is no One True Answer here: each sysadmin
192 # must make up her mind.
196 # Password aging controls:
198 # PASS_MAX_DAYS Maximum number of days a password may be used.
199 # PASS_MIN_DAYS Minimum number of days allowed between password changes.
200 # PASS_MIN_LEN Minimum acceptable password length.
201 # PASS_WARN_AGE Number of days warning given before a password expires.
209 # If "yes", the user must be listed as a member of the first gid 0 group
210 # in /etc/group (called "root" on most Linux systems) to be able to "su"
211 # to uid 0 accounts. If the group doesn't exist or is empty, no one
212 # will be able to "su" to uid 0.
217 # If compiled with cracklib support, where are the dictionaries
219 CRACKLIB_DICTPATH /var/cache/cracklib/cracklib_dict
222 # Min/max values for automatic uid selection in useradd
231 # Min/max values for automatic gid selection in groupadd
240 # Max number of login retries if password is bad
245 # Max time in seconds for login
250 # Maximum number of attempts to change password if rejected (too easy)
255 # Warn about weak passwords (but still allow them) if you are root.
260 # Number of significant characters in the password for crypt().
261 # Default is 8, don't change unless your crypt() is better.
262 # Ignored if MD5_CRYPT_ENAB set to "yes".
267 # Require password before chfn/chsh can make any changes.
272 # Which fields may be changed by regular users using chfn - use
273 # any combination of letters "frwh" (full name, room number, work
274 # phone, home phone). If not defined, no changes are allowed.
275 # For backward compatibility, "yes" = "rwh" and "no" = "frwh".
280 # Password prompt (%s will be replaced by user name).
282 # XXX - it doesn't work correctly yet, for now leave it commented out
283 # to use the default which is just "Password: ".
284 #LOGIN_STRING "%s's Password: "
287 # Only works if compiled with MD5_CRYPT defined:
288 # If set to "yes", new passwords will be encrypted using the MD5-based
289 # algorithm compatible with the one used by recent releases of FreeBSD.
290 # It supports passwords of unlimited length and longer salt strings.
291 # Set to "no" if you need to copy encrypted passwords to other systems
292 # which don't understand the new algorithm. Default is "no".
294 # Note: If you use PAM, it is recommended to use a value consistent with
295 # the PAM modules configuration.
297 # This variable is deprecated. You should use ENCRYPT_METHOD.
302 # Only works if compiled with ENCRYPTMETHOD_SELECT defined:
303 # If set to MD5 , MD5-based algorithm will be used for encrypting password
304 # If set to SHA256, SHA256-based algorithm will be used for encrypting password
305 # If set to SHA512, SHA512-based algorithm will be used for encrypting password
306 # If set to DES, DES-based algorithm will be used for encrypting password (default)
307 # Overrides the MD5_CRYPT_ENAB option
309 # Note: If you use PAM, it is recommended to use a value consistent with
310 # the PAM modules configuration.
315 # Only works if ENCRYPT_METHOD is set to SHA256 or SHA512.
317 # Define the number of SHA rounds.
318 # With a lot of rounds, it is more difficult to brute forcing the password.
319 # But note also that it more CPU resources will be needed to authenticate
322 # If not specified, the libc will choose the default number of rounds (5000).
323 # The values must be inside the 1000-999999999 range.
324 # If only one of the MIN or MAX values is set, then this value will be used.
325 # If MIN > MAX, the highest value will be used.
327 # SHA_CRYPT_MIN_ROUNDS 5000
328 # SHA_CRYPT_MAX_ROUNDS 5000
331 # List of groups to add to the user's supplementary group set
332 # when logging in on the console (as determined by the CONSOLE
333 # setting). Default is none.
335 # Use with caution - it is possible for users to gain permanent
336 # access to these groups, even when not logged in on the console.
337 # How to do it is left as an exercise for the reader...
339 #CONSOLE_GROUPS floppy:audio:cdrom
342 # Should login be allowed if we can't cd to the home directory?
348 # If this file exists and is readable, login environment will be
349 # read from it. Every line should be in the form name=value.
351 ENVIRON_FILE /etc/environment
354 # If defined, this command is run when removing a user.
355 # It should remove any at/cron/print jobs etc. owned by
356 # the user to be removed (passed as the first argument).
358 #USERDEL_CMD /usr/sbin/userdel_local
361 # Enable setting of the umask group bits to be the same as owner bits
362 # (examples: 022 -> 002, 077 -> 007) for non-root users, if the uid is
363 # the same as gid, and username is the same as the primary group name.
365 # This also enables userdel to remove user groups if no members exist.
370 # If set to a non-nul number, the shadow utilities will make sure that
371 # groups never have more than this number of users on one line.
372 # This permit to support split groups (groups split into multiple lines,
373 # with the same group ID, to avoid limitation of the line length in the
376 # 0 is the default value and disables this feature.
378 #MAX_MEMBERS_PER_GROUP 0
381 # If useradd should create home directories for users by default (non
383 # This option is overridden with the -M or -m flags on the useradd command