2 # /etc/login.defs - Configuration control definitions for the shadow package.
4 # $Id: login.defs 3038 2009-07-23 20:41:35Z 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.
121 MAIL_DIR /var/spool/mail
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 for non-PAM enabled systems.
187 # UMASK is also used by useradd and newusers to set the mode of new home
189 # 022 is the default value, but 027, or even 077, could be considered
190 # better for privacy. There is no One True Answer here: each sysadmin
191 # must make up her mind.
195 # Password aging controls:
197 # PASS_MAX_DAYS Maximum number of days a password may be used.
198 # PASS_MIN_DAYS Minimum number of days allowed between password changes.
199 # PASS_MIN_LEN Minimum acceptable password length.
200 # PASS_WARN_AGE Number of days warning given before a password expires.
208 # If "yes", the user must be listed as a member of the first gid 0 group
209 # in /etc/group (called "root" on most Linux systems) to be able to "su"
210 # to uid 0 accounts. If the group doesn't exist or is empty, no one
211 # will be able to "su" to uid 0.
216 # If compiled with cracklib support, where are the dictionaries
218 CRACKLIB_DICTPATH /var/cache/cracklib/cracklib_dict
221 # Min/max values for automatic uid selection in useradd
230 # Min/max values for automatic gid selection in groupadd
239 # Max number of login retries if password is bad
244 # Max time in seconds for login
249 # Maximum number of attempts to change password if rejected (too easy)
254 # Warn about weak passwords (but still allow them) if you are root.
259 # Number of significant characters in the password for crypt().
260 # Default is 8, don't change unless your crypt() is better.
261 # Ignored if MD5_CRYPT_ENAB set to "yes".
266 # Require password before chfn/chsh can make any changes.
271 # Which fields may be changed by regular users using chfn - use
272 # any combination of letters "frwh" (full name, room number, work
273 # phone, home phone). If not defined, no changes are allowed.
274 # For backward compatibility, "yes" = "rwh" and "no" = "frwh".
279 # Password prompt (%s will be replaced by user name).
281 # XXX - it doesn't work correctly yet, for now leave it commented out
282 # to use the default which is just "Password: ".
283 #LOGIN_STRING "%s's Password: "
286 # Only works if compiled with MD5_CRYPT defined:
287 # If set to "yes", new passwords will be encrypted using the MD5-based
288 # algorithm compatible with the one used by recent releases of FreeBSD.
289 # It supports passwords of unlimited length and longer salt strings.
290 # Set to "no" if you need to copy encrypted passwords to other systems
291 # which don't understand the new algorithm. Default is "no".
293 # Note: If you use PAM, it is recommended to use a value consistent with
294 # the PAM modules configuration.
296 # This variable is deprecated. You should use ENCRYPT_METHOD.
301 # Only works if compiled with ENCRYPTMETHOD_SELECT defined:
302 # If set to MD5 , MD5-based algorithm will be used for encrypting password
303 # If set to SHA256, SHA256-based algorithm will be used for encrypting password
304 # If set to SHA512, SHA512-based algorithm will be used for encrypting password
305 # If set to DES, DES-based algorithm will be used for encrypting password (default)
306 # Overrides the MD5_CRYPT_ENAB option
308 # Note: If you use PAM, it is recommended to use a value consistent with
309 # the PAM modules configuration.
314 # Only works if ENCRYPT_METHOD is set to SHA256 or SHA512.
316 # Define the number of SHA rounds.
317 # With a lot of rounds, it is more difficult to brute forcing the password.
318 # But note also that it more CPU resources will be needed to authenticate
321 # If not specified, the libc will choose the default number of rounds (5000).
322 # The values must be inside the 1000-999999999 range.
323 # If only one of the MIN or MAX values is set, then this value will be used.
324 # If MIN > MAX, the highest value will be used.
326 # SHA_CRYPT_MIN_ROUNDS 5000
327 # SHA_CRYPT_MAX_ROUNDS 5000
330 # List of groups to add to the user's supplementary group set
331 # when logging in on the console (as determined by the CONSOLE
332 # setting). Default is none.
334 # Use with caution - it is possible for users to gain permanent
335 # access to these groups, even when not logged in on the console.
336 # How to do it is left as an exercise for the reader...
338 #CONSOLE_GROUPS floppy:audio:cdrom
341 # Should login be allowed if we can't cd to the home directory?
347 # If this file exists and is readable, login environment will be
348 # read from it. Every line should be in the form name=value.
350 ENVIRON_FILE /etc/environment
353 # If defined, this command is run when removing a user.
354 # It should remove any at/cron/print jobs etc. owned by
355 # the user to be removed (passed as the first argument).
357 #USERDEL_CMD /usr/sbin/userdel_local
360 # Enable setting of the umask group bits to be the same as owner bits
361 # (examples: 022 -> 002, 077 -> 007) for non-root users, if the uid is
362 # the same as gid, and username is the same as the primary group name.
364 # This also enables userdel to remove user groups if no members exist.
369 # If set to a non-nul number, the shadow utilities will make sure that
370 # groups never have more than this number of users on one line.
371 # This permit to support split groups (groups split into multiple lines,
372 # with the same group ID, to avoid limitation of the line length in the
375 # 0 is the default value and disables this feature.
377 #MAX_MEMBERS_PER_GROUP 0
380 # If useradd should create home directories for users by default (non
382 # This option is overridden with the -M or -m flags on the useradd command