man/login.defs.5

   1 '\" t
   2 .\"     Title: login.defs
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 02/16/2011
   6 .\"    Manual: File Formats and Conversions
   7 .\"    Source: File Formats and Conversions
   8 .\"  Language: English
   9 .\"
  10 .TH "LOGIN\&.DEFS" "5" "02/16/2011" "File Formats and Conversions" "File Formats and Conversions"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 login.defs \- shadow password suite configuration
  32 .SH "DESCRIPTION"
  33 .PP
  34 The
  35 /etc/login\&.defs
  36 file defines the site\-specific configuration for the shadow password suite\&. This file is required\&. Absence of this file will not prevent system operation, but will probably result in undesirable operation\&.
  37 .PP
  38 This file is a readable text file, each line of the file describing one configuration parameter\&. The lines consist of a configuration name and value, separated by whitespace\&. Blank lines and comment lines are ignored\&. Comments are introduced with a "#" pound sign and the pound sign must be the first non\-white character of the line\&.
  39 .PP
  40 Parameter values may be of four types: strings, booleans, numbers, and long numbers\&. A string is comprised of any printable characters\&. A boolean should be either the value
  41 \fIyes\fR
  42 or
  43 \fIno\fR\&. An undefined boolean parameter or one with a value other than these will be given a
  44 \fIno\fR
  45 value\&. Numbers (both regular and long) may be either decimal values, octal values (precede the value with
  46 \fI0\fR) or hexadecimal values (precede the value with
  47 \fI0x\fR)\&. The maximum value of the regular and long numeric parameters is machine\-dependent\&.
  48 .PP
  49 The following configuration items are provided:
  50 .PP
  51 \fBCHFN_AUTH\fR (boolean)
  52 .RS 4
  53 If
  54 \fIyes\fR, the
  55 \fBchfn\fR
  56 program will require authentication before making any changes, unless run by the superuser\&.
  57 .RE
  58 .PP
  59 \fBCHFN_RESTRICT\fR (string)
  60 .RS 4
  61 This parameter specifies which values in the
  62 \fIgecos\fR
  63 field of the
  64 /etc/passwd
  65 file may be changed by regular users using the
  66 \fBchfn\fR
  67 program\&. It can be any combination of letters
  68 \fIf\fR,
  69 \fIr\fR,
  70 \fIw\fR,
  71 \fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility,
  72 \fIyes\fR
  73 is equivalent to
  74 \fIrwh\fR
  75 and
  76 \fIno\fR
  77 is equivalent to
  78 \fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing
  79 \fBchfn\fR
  80 SUID\&.
  81 .RE
  82 .PP
  83 \fBCHSH_AUTH\fR (boolean)
  84 .RS 4
  85 If
  86 \fIyes\fR, the
  87 \fBchsh\fR
  88 program will require authentication before making any changes, unless run by the superuser\&.
  89 .RE
  90 .PP
  91 \fBCONSOLE\fR (string)
  92 .RS 4
  93 If defined, either full pathname of a file containing device names (one per line) or a ":" delimited list of device names\&. Root logins will be allowed only upon these devices\&.
  94 .sp
  95 If not defined, root will be allowed on any device\&.
  96 .sp
  97 The device should be specified without the /dev/ prefix\&.
  98 .RE
  99 .PP
 100 \fBCONSOLE_GROUPS\fR (string)
 101 .RS 4
 102 List of groups to add to the user\*(Aqs supplementary groups set when logging in on the console (as determined by the CONSOLE setting)\&. Default is none\&.
 103
 104 Use with caution \- it is possible for users to gain permanent access to these groups, even when not logged in on the console\&.
 105 .RE
 106 .PP
 107 \fBCREATE_HOME\fR (boolean)
 108 .RS 4
 109 Indicate if a home directory should be created by default for new users\&.
 110 .sp
 111 This setting does not apply to system users, and can be overriden on the command line\&.
 112 .RE
 113 .PP
 114 \fBDEFAULT_HOME\fR (boolean)
 115 .RS 4
 116 Indicate if login is allowed if we can\*(Aqt cd to the home directory\&. Default in no\&.
 117 .sp
 118 If set to
 119 \fIyes\fR, the user will login in the root (/) directory if it is not possible to cd to her home directory\&.
 120 .RE
 121 .PP
 122 \fBENCRYPT_METHOD\fR (string)
 123 .RS 4
 124 This defines the system default encryption algorithm for encrypting passwords (if no algorithm are specified on the command line)\&.
 125 .sp
 126 It can take one of these values:
 127 .sp
 128 .RS 4
 129 .ie n \{\
 130 \h'-04'\(bu\h'+03'\c
 131 .\}
 132 .el \{\
 133 .sp -1
 134 .IP \(bu 2.3
 135 .\}
 136 \fIDES\fR
 137 (default)
 138 .RE
 139 .sp
 140 .RS 4
 141 .ie n \{\
 142 \h'-04'\(bu\h'+03'\c
 143 .\}
 144 .el \{\
 145 .sp -1
 146 .IP \(bu 2.3
 147 .\}
 148 \fIMD5\fR
 149 .RE
 150 .sp
 151 .RS 4
 152 .ie n \{\
 153 \h'-04'\(bu\h'+03'\c
 154 .\}
 155 .el \{\
 156 .sp -1
 157 .IP \(bu 2.3
 158 .\}
 159 \fISHA256\fR
 160 .RE
 161 .sp
 162 .RS 4
 163 .ie n \{\
 164 \h'-04'\(bu\h'+03'\c
 165 .\}
 166 .el \{\
 167 .sp -1
 168 .IP \(bu 2.3
 169 .\}
 170 \fISHA512\fR
 171 .RE
 172 .sp
 173 Note: this parameter overrides the
 174 \fBMD5_CRYPT_ENAB\fR
 175 variable\&.
 176 .RE
 177 .PP
 178 \fBENV_HZ\fR (string)
 179 .RS 4
 180 If set, it will be used to define the HZ environment variable when a user login\&. The value must be preceded by
 181 \fIHZ=\fR\&. A common value on Linux is
 182 \fIHZ=100\fR\&.
 183 .RE
 184 .PP
 185 \fBENV_PATH\fR (string)
 186 .RS 4
 187 If set, it will be used to define the PATH environment variable when a regular user login\&. The value can be preceded by
 188 \fIPATH=\fR, or a colon separated list of paths (for example
 189 \fI/bin:/usr/bin\fR)\&. The default value is
 190 \fIPATH=/bin:/usr/bin\fR\&.
 191 .RE
 192 .PP
 193 \fBENV_SUPATH\fR (string)
 194 .RS 4
 195 If set, it will be used to define the PATH environment variable when the superuser login\&. The value can be preceded by
 196 \fIPATH=\fR, or a colon separated list of paths (for example
 197 \fI/sbin:/bin:/usr/sbin:/usr/bin\fR)\&. The default value is
 198 \fIPATH=/bin:/usr/bin\fR\&.
 199 .RE
 200 .PP
 201 \fBENV_TZ\fR (string)
 202 .RS 4
 203 If set, it will be used to define the TZ environment variable when a user login\&. The value can be the name of a timezone preceded by
 204 \fITZ=\fR
 205 (for example
 206 \fITZ=CST6CDT\fR), or the full path to the file containing the timezone specification (for example
 207 /etc/tzname)\&.
 208 .sp
 209 If a full path is specified but the file does not exist or cannot be read, the default is to use
 210 \fITZ=CST6CDT\fR\&.
 211 .RE
 212 .PP
 213 \fBENVIRON_FILE\fR (string)
 214 .RS 4
 215 If this file exists and is readable, login environment will be read from it\&. Every line should be in the form name=value\&.
 216 .sp
 217 Lines starting with a # are treated as comment lines and ignored\&.
 218 .RE
 219 .PP
 220 \fBERASECHAR\fR (number)
 221 .RS 4
 222 Terminal ERASE character (\fI010\fR
 223 = backspace,
 224 \fI0177\fR
 225 = DEL)\&.
 226 .sp
 227 The value can be prefixed "0" for an octal value, or "0x" for an hexadecimal value\&.
 228 .RE
 229 .PP
 230 \fBFAIL_DELAY\fR (number)
 231 .RS 4
 232 Delay in seconds before being allowed another attempt after a login failure\&.
 233 .RE
 234 .PP
 235 \fBFAILLOG_ENAB\fR (boolean)
 236 .RS 4
 237 Enable logging and display of
 238 /var/log/faillog
 239 login failure info\&.
 240 .RE
 241 .PP
 242 \fBFAKE_SHELL\fR (string)
 243 .RS 4
 244 If set,
 245 \fBlogin\fR
 246 will execute this shell instead of the users\*(Aq shell specified in
 247 /etc/passwd\&.
 248 .RE
 249 .PP
 250 \fBFTMP_FILE\fR (string)
 251 .RS 4
 252 If defined, login failures will be logged in this file in a utmp format\&.
 253 .RE
 254 .PP
 255 \fBGID_MAX\fR (number), \fBGID_MIN\fR (number)
 256 .RS 4
 257 Range of group IDs used for the creation of regular groups by
 258 \fBuseradd\fR,
 259 \fBgroupadd\fR, or
 260 \fBnewusers\fR\&.
 261 .RE
 262 .PP
 263 \fBHUSHLOGIN_FILE\fR (string)
 264 .RS 4
 265 If defined, this file can inhibit all the usual chatter during the login sequence\&. If a full pathname is specified, then hushed mode will be enabled if the user\*(Aqs name or shell are found in the file\&. If not a full pathname, then hushed mode will be enabled if the file exists in the user\*(Aqs home directory\&.
 266 .RE
 267 .PP
 268 \fBISSUE_FILE\fR (string)
 269 .RS 4
 270 If defined, this file will be displayed before each login prompt\&.
 271 .RE
 272 .PP
 273 \fBKILLCHAR\fR (number)
 274 .RS 4
 275 Terminal KILL character (\fI025\fR
 276 = CTRL/U)\&.
 277 .sp
 278 The value can be prefixed "0" for an octal value, or "0x" for an hexadecimal value\&.
 279 .RE
 280 .PP
 281 \fBLASTLOG_ENAB\fR (boolean)
 282 .RS 4
 283 Enable logging and display of /var/log/lastlog login time info\&.
 284 .RE
 285 .PP
 286 \fBLOG_OK_LOGINS\fR (boolean)
 287 .RS 4
 288 Enable logging of successful logins\&.
 289 .RE
 290 .PP
 291 \fBLOG_UNKFAIL_ENAB\fR (boolean)
 292 .RS 4
 293 Enable display of unknown usernames when login failures are recorded\&.
 294 .sp
 295 Note: logging unknown usernames may be a security issue if an user enter her password instead of her login name\&.
 296 .RE
 297 .PP
 298 \fBLOGIN_RETRIES\fR (number)
 299 .RS 4
 300 Maximum number of login retries in case of bad password\&.
 301 .RE
 302 .PP
 303 \fBLOGIN_STRING\fR (string)
 304 .RS 4
 305 The string used for prompting a password\&. The default is to use "Password: ", or a translation of that string\&. If you set this variable, the prompt will no be translated\&.
 306 .sp
 307 If the string contains
 308 \fI%s\fR, this will be replaced by the user\*(Aqs name\&.
 309 .RE
 310 .PP
 311 \fBLOGIN_TIMEOUT\fR (number)
 312 .RS 4
 313 Max time in seconds for login\&.
 314 .RE
 315 .PP
 316 \fBMAIL_CHECK_ENAB\fR (boolean)
 317 .RS 4
 318 Enable checking and display of mailbox status upon login\&.
 319 .sp
 320 You should disable it if the shell startup files already check for mail ("mailx \-e" or equivalent)\&.
 321 .RE
 322 .PP
 323 \fBMAIL_DIR\fR (string)
 324 .RS 4
 325 The mail spool directory\&. This is needed to manipulate the mailbox when its corresponding user account is modified or deleted\&. If not specified, a compile\-time default is used\&.
 326 .RE
 327 .PP
 328 \fBMAIL_FILE\fR (string)
 329 .RS 4
 330 Defines the location of the users mail spool files relatively to their home directory\&.
 331 .RE
 332 .PP
 333 The
 334 \fBMAIL_DIR\fR
 335 and
 336 \fBMAIL_FILE\fR
 337 variables are used by
 338 \fBuseradd\fR,
 339 \fBusermod\fR, and
 340 \fBuserdel\fR
 341 to create, move, or delete the user\*(Aqs mail spool\&.
 342 .PP
 343 If
 344 \fBMAIL_CHECK_ENAB\fR
 345 is set to
 346 \fIyes\fR, they are also used to define the
 347 \fBMAIL\fR
 348 environment variable\&.
 349 .PP
 350 \fBMAX_MEMBERS_PER_GROUP\fR (number)
 351 .RS 4
 352 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
 353 /etc/group
 354 (with the same name, same password, and same GID)\&.
 355 .sp
 356 The default value is 0, meaning that there are no limits in the number of members in a group\&.
 357 .sp
 358 This feature (split group) permits to limit the length of lines in the group file\&. This is useful to make sure that lines for NIS groups are not larger than 1024 characters\&.
 359 .sp
 360 If you need to enforce such limit, you can use 25\&.
 361 .sp
 362 Note: split groups may not be supported by all tools (even in the Shadow toolsuite)\&. You should not use this variable unless you really need it\&.
 363 .RE
 364 .PP
 365 \fBMD5_CRYPT_ENAB\fR (boolean)
 366 .RS 4
 367 Indicate if passwords must be encrypted using the MD5\-based algorithm\&. If set to
 368 \fIyes\fR, new passwords will be encrypted using the MD5\-based algorithm compatible with the one used by recent releases of FreeBSD\&. It supports passwords of unlimited length and longer salt strings\&. Set to
 369 \fIno\fR
 370 if you need to copy encrypted passwords to other systems which don\*(Aqt understand the new algorithm\&. Default is
 371 \fIno\fR\&.
 372 .sp
 373 This variable is superceded by the
 374 \fBENCRYPT_METHOD\fR
 375 variable or by any command line option used to configure the encryption algorithm\&.
 376 .sp
 377 This variable is deprecated\&. You should use
 378 \fBENCRYPT_METHOD\fR\&.
 379 .RE
 380 .PP
 381 \fBMOTD_FILE\fR (string)
 382 .RS 4
 383 If defined, ":" delimited list of "message of the day" files to be displayed upon login\&.
 384 .RE
 385 .PP
 386 \fBNOLOGINS_FILE\fR (string)
 387 .RS 4
 388 If defined, name of file whose presence will inhibit non\-root logins\&. The contents of this file should be a message indicating why logins are inhibited\&.
 389 .RE
 390 .PP
 391 \fBOBSCURE_CHECKS_ENAB\fR (boolean)
 392 .RS 4
 393 Enable additional checks upon password changes\&.
 394 .RE
 395 .PP
 396 \fBPASS_ALWAYS_WARN\fR (boolean)
 397 .RS 4
 398 Warn about weak passwords (but still allow them) if you are root\&.
 399 .RE
 400 .PP
 401 \fBPASS_CHANGE_TRIES\fR (number)
 402 .RS 4
 403 Maximum number of attempts to change password if rejected (too easy)\&.
 404 .RE
 405 .PP
 406 \fBPASS_MAX_DAYS\fR (number)
 407 .RS 4
 408 The maximum number of days a password may be used\&. If the password is older than this, a password change will be forced\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
 409 .RE
 410 .PP
 411 \fBPASS_MIN_DAYS\fR (number)
 412 .RS 4
 413 The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
 414 .RE
 415 .PP
 416 \fBPASS_WARN_AGE\fR (number)
 417 .RS 4
 418 The number of days warning given before a password expires\&. A zero means warning is given only upon the day of expiration, a negative value means no warning is given\&. If not specified, no warning will be provided\&.
 419 .RE
 420 .PP
 421
 422 \fBPASS_MAX_DAYS\fR,
 423 \fBPASS_MIN_DAYS\fR
 424 and
 425 \fBPASS_WARN_AGE\fR
 426 are only used at the time of account creation\&. Any changes to these settings won\*(Aqt affect existing accounts\&.
 427 .PP
 428 \fBPASS_MAX_LEN\fR (number), \fBPASS_MIN_LEN\fR (number)
 429 .RS 4
 430 Number of significant characters in the password for crypt()\&.
 431 \fBPASS_MAX_LEN\fR
 432 is 8 by default\&. Don\*(Aqt change unless your crypt() is better\&. This is ignored if
 433 \fBMD5_CRYPT_ENAB\fR
 434 set to
 435 \fIyes\fR\&.
 436 .RE
 437 .PP
 438 \fBPORTTIME_CHECKS_ENAB\fR (boolean)
 439 .RS 4
 440 Enable checking of time restrictions specified in /etc/porttime\&.
 441 .RE
 442 .PP
 443 \fBQUOTAS_ENAB\fR (boolean)
 444 .RS 4
 445 Enable setting of ulimit, umask, and niceness from passwd gecos field\&.
 446 .RE
 447 .PP
 448 \fBSHA_CRYPT_MIN_ROUNDS\fR (number), \fBSHA_CRYPT_MAX_ROUNDS\fR (number)
 449 .RS 4
 450 When
 451 \fBENCRYPT_METHOD\fR
 452 is set to
 453 \fISHA256\fR
 454 or
 455 \fISHA512\fR, this defines the number of SHA rounds used by the encryption algorithm by default (when the number of rounds is not specified on the command line)\&.
 456 .sp
 457 With a lot of rounds, it is more difficult to brute forcing the password\&. But note also that more CPU resources will be needed to authenticate users\&.
 458 .sp
 459 If not specified, the libc will choose the default number of rounds (5000)\&.
 460 .sp
 461 The values must be inside the 1000\-999999999 range\&.
 462 .sp
 463 If only one of the
 464 \fBSHA_CRYPT_MIN_ROUNDS\fR
 465 or
 466 \fBSHA_CRYPT_MAX_ROUNDS\fR
 467 values is set, then this value will be used\&.
 468 .sp
 469 If
 470 \fBSHA_CRYPT_MIN_ROUNDS\fR
 471 >
 472 \fBSHA_CRYPT_MAX_ROUNDS\fR, the highest value will be used\&.
 473 .RE
 474 .PP
 475 \fBSULOG_FILE\fR (string)
 476 .RS 4
 477 If defined, all su activity is logged to this file\&.
 478 .RE
 479 .PP
 480 \fBSU_NAME\fR (string)
 481 .RS 4
 482 If defined, the command name to display when running "su \-"\&. For example, if this is defined as "su" then a "ps" will display the command is "\-su"\&. If not defined, then "ps" would display the name of the shell actually being run, e\&.g\&. something like "\-sh"\&.
 483 .RE
 484 .PP
 485 \fBSU_WHEEL_ONLY\fR (boolean)
 486 .RS 4
 487 If
 488 \fIyes\fR, the user must be listed as a member of the first gid 0 group in
 489 /etc/group
 490 (called
 491 \fIroot\fR
 492 on most Linux systems) to be able to
 493 \fBsu\fR
 494 to uid 0 accounts\&. If the group doesn\*(Aqt exist or is empty, no one will be able to
 495 \fBsu\fR
 496 to uid 0\&.
 497 .RE
 498 .PP
 499 \fBSYS_GID_MAX\fR (number), \fBSYS_GID_MIN\fR (number)
 500 .RS 4
 501 Range of group IDs used for the creation of system groups by
 502 \fBuseradd\fR,
 503 \fBgroupadd\fR, or
 504 \fBnewusers\fR\&.
 505 .RE
 506 .PP
 507 \fBSYS_UID_MAX\fR (number), \fBSYS_UID_MIN\fR (number)
 508 .RS 4
 509 Range of user IDs used for the creation of system users by
 510 \fBuseradd\fR
 511 or
 512 \fBnewusers\fR\&.
 513 .RE
 514 .PP
 515 \fBSYSLOG_SG_ENAB\fR (boolean)
 516 .RS 4
 517 Enable "syslog" logging of
 518 \fBsg\fR
 519 activity\&.
 520 .RE
 521 .PP
 522 \fBSYSLOG_SU_ENAB\fR (boolean)
 523 .RS 4
 524 Enable "syslog" logging of
 525 \fBsu\fR
 526 activity \- in addition to sulog file logging\&.
 527 .RE
 528 .PP
 529 \fBTTYGROUP\fR (string), \fBTTYPERM\fR (string)
 530 .RS 4
 531 The terminal permissions: the login tty will be owned by the
 532 \fBTTYGROUP\fR
 533 group, and the permissions will be set to
 534 \fBTTYPERM\fR\&.
 535 .sp
 536 By default, the ownership of the terminal is set to the user\*(Aqs primary group and the permissions are set to
 537 \fI0600\fR\&.
 538 .sp
 539
 540 \fBTTYGROUP\fR
 541 can be either the name of a group or a numeric group identifier\&.
 542 .sp
 543 If you have a
 544 \fBwrite\fR
 545 program which is "setgid" to a special group which owns the terminals, define TTYGROUP to the group number and TTYPERM to 0620\&. Otherwise leave TTYGROUP commented out and assign TTYPERM to either 622 or 600\&.
 546 .RE
 547 .PP
 548 \fBTTYTYPE_FILE\fR (string)
 549 .RS 4
 550 If defined, file which maps tty line to TERM environment parameter\&. Each line of the file is in a format something like "vt100 tty01"\&.
 551 .RE
 552 .PP
 553 \fBUID_MAX\fR (number), \fBUID_MIN\fR (number)
 554 .RS 4
 555 Range of user IDs used for the creation of regular users by
 556 \fBuseradd\fR
 557 or
 558 \fBnewusers\fR\&.
 559 .RE
 560 .PP
 561 \fBULIMIT\fR (number)
 562 .RS 4
 563 Default
 564 \fBulimit\fR
 565 value\&.
 566 .RE
 567 .PP
 568 \fBUMASK\fR (number)
 569 .RS 4
 570 The file mode creation mask is initialized to this value\&. If not specified, the mask will be initialized to 022\&.
 571 .sp
 572
 573 \fBuseradd\fR
 574 and
 575 \fBnewusers\fR
 576 use this mask to set the mode of the home directory they create
 577 .sp
 578 It is also used by
 579 \fBlogin\fR
 580 to define users\*(Aq initial umask\&. Note that this mask can be overriden by the user\*(Aqs GECOS line (if
 581 \fBQUOTAS_ENAB\fR
 582 is set) or by the specification of a limit with the
 583 \fIK\fR
 584 identifier in
 585 \fBlimits\fR(5)\&.
 586 .RE
 587 .PP
 588 \fBUSERDEL_CMD\fR (string)
 589 .RS 4
 590 If defined, this command is run when removing a user\&. It should remove any at/cron/print jobs etc\&. owned by the user to be removed (passed as the first argument)\&.
 591 .sp
 592 The return code of the script is not taken into account\&.
 593 .sp
 594 Here is an example script, which removes the user\*(Aqs cron, at and print jobs:
 595 .sp
 596 .if n \{\
 597 .RS 4
 598 .\}
 599 .nf
 600 #! /bin/sh
 601
 602 # Check for the required argument\&.
 603 if [ $# != 1 ]; then
 604         echo "Usage: $0 username"
 605         exit 1
 606 fi
 607
 608 # Remove cron jobs\&.
 609 crontab \-r \-u $1
 610
 611 # Remove at jobs\&.
 612 # Note that it will remove any jobs owned by the same UID,
 613 # even if it was shared by a different username\&.
 614 AT_SPOOL_DIR=/var/spool/cron/atjobs
 615 find $AT_SPOOL_DIR \-name "[^\&.]*" \-type f \-user $1 \-delete \e;
 616
 617 # Remove print jobs\&.
 618 lprm $1
 619
 620 # All done\&.
 621 exit 0
 622
 623 .fi
 624 .if n \{\
 625 .RE
 626 .\}
 627 .sp
 628 .RE
 629 .PP
 630 \fBUSERGROUPS_ENAB\fR (boolean)
 631 .RS 4
 632 Enable setting of the umask group bits to be the same as owner bits (examples: 022 \-> 002, 077 \-> 007) for non\-root users, if the uid is the same as gid, and username is the same as the primary group name\&.
 633 .sp
 634 If set to
 635 \fIyes\fR,
 636 \fBuserdel\fR
 637 will remove the user\*(Aqs group if it contains no more members, and
 638 \fBuseradd\fR
 639 will create by default a group with the name of the user\&.
 640 .RE
 641 .SH "CROSS REFERENCES"
 642 .PP
 643 The following cross references show which programs in the shadow password suite use which parameters\&.
 644 .PP
 645 chfn
 646 .RS 4
 647
 648 CHFN_AUTH
 649 CHFN_RESTRICT
 650 LOGIN_STRING
 651 .RE
 652 .PP
 653 chgpasswd
 654 .RS 4
 655 ENCRYPT_METHOD MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB
 656 SHA_CRYPT_MAX_ROUNDS SHA_CRYPT_MIN_ROUNDS
 657 .RE
 658 .PP
 659 chpasswd
 660 .RS 4
 661 ENCRYPT_METHOD MD5_CRYPT_ENAB
 662 SHA_CRYPT_MAX_ROUNDS SHA_CRYPT_MIN_ROUNDS
 663 .RE
 664 .PP
 665 chsh
 666 .RS 4
 667 CHSH_AUTH LOGIN_STRING
 668 .RE
 669 .PP
 670 gpasswd
 671 .RS 4
 672 ENCRYPT_METHOD MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB
 673 SHA_CRYPT_MAX_ROUNDS SHA_CRYPT_MIN_ROUNDS
 674 .RE
 675 .PP
 676 groupadd
 677 .RS 4
 678 GID_MAX GID_MIN MAX_MEMBERS_PER_GROUP SYS_GID_MAX SYS_GID_MIN
 679 .RE
 680 .PP
 681 groupdel
 682 .RS 4
 683 MAX_MEMBERS_PER_GROUP
 684 .RE
 685 .PP
 686 groupmems
 687 .RS 4
 688 MAX_MEMBERS_PER_GROUP
 689 .RE
 690 .PP
 691 groupmod
 692 .RS 4
 693 MAX_MEMBERS_PER_GROUP
 694 .RE
 695 .PP
 696 grpck
 697 .RS 4
 698 MAX_MEMBERS_PER_GROUP
 699 .RE
 700 .PP
 701 grpconv
 702 .RS 4
 703 MAX_MEMBERS_PER_GROUP
 704 .RE
 705 .PP
 706 grpunconv
 707 .RS 4
 708 MAX_MEMBERS_PER_GROUP
 709 .RE
 710 .PP
 711 login
 712 .RS 4
 713
 714 CONSOLE
 715 CONSOLE_GROUPS DEFAULT_HOME
 716 ENV_HZ ENV_PATH ENV_SUPATH ENV_TZ ENVIRON_FILE
 717 ERASECHAR FAIL_DELAY
 718 FAILLOG_ENAB
 719 FAKE_SHELL
 720 FTMP_FILE
 721 HUSHLOGIN_FILE
 722 ISSUE_FILE
 723 KILLCHAR
 724 LASTLOG_ENAB
 725 LOGIN_RETRIES
 726 LOGIN_STRING
 727 LOGIN_TIMEOUT LOG_OK_LOGINS LOG_UNKFAIL_ENAB
 728 MAIL_CHECK_ENAB MAIL_DIR MAIL_FILE MOTD_FILE NOLOGINS_FILE PORTTIME_CHECKS_ENAB QUOTAS_ENAB
 729 TTYGROUP TTYPERM TTYTYPE_FILE
 730 ULIMIT UMASK
 731 USERGROUPS_ENAB
 732 .RE
 733 .PP
 734 newgrp / sg
 735 .RS 4
 736 SYSLOG_SG_ENAB
 737 .RE
 738 .PP
 739 newusers
 740 .RS 4
 741 ENCRYPT_METHOD GID_MAX GID_MIN MAX_MEMBERS_PER_GROUP MD5_CRYPT_ENAB PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
 742 SHA_CRYPT_MAX_ROUNDS SHA_CRYPT_MIN_ROUNDS
 743 SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN UMASK
 744 .RE
 745 .PP
 746 passwd
 747 .RS 4
 748 ENCRYPT_METHOD MD5_CRYPT_ENAB OBSCURE_CHECKS_ENAB PASS_ALWAYS_WARN PASS_CHANGE_TRIES PASS_MAX_LEN PASS_MIN_LEN
 749 SHA_CRYPT_MAX_ROUNDS SHA_CRYPT_MIN_ROUNDS
 750 .RE
 751 .PP
 752 pwck
 753 .RS 4
 754 PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
 755 .RE
 756 .PP
 757 pwconv
 758 .RS 4
 759 PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE
 760 .RE
 761 .PP
 762 su
 763 .RS 4
 764
 765 CONSOLE
 766 CONSOLE_GROUPS DEFAULT_HOME
 767 ENV_HZ ENVIRON_FILE
 768 ENV_PATH ENV_SUPATH
 769 ENV_TZ LOGIN_STRING MAIL_CHECK_ENAB MAIL_DIR MAIL_FILE QUOTAS_ENAB
 770 SULOG_FILE SU_NAME
 771 SU_WHEEL_ONLY
 772 SYSLOG_SU_ENAB
 773 USERGROUPS_ENAB
 774 .RE
 775 .PP
 776 sulogin
 777 .RS 4
 778 ENV_HZ
 779 ENV_TZ
 780 .RE
 781 .PP
 782 useradd
 783 .RS 4
 784 CREATE_HOME GID_MAX GID_MIN MAIL_DIR MAX_MEMBERS_PER_GROUP PASS_MAX_DAYS PASS_MIN_DAYS PASS_WARN_AGE SYS_GID_MAX SYS_GID_MIN SYS_UID_MAX SYS_UID_MIN UID_MAX UID_MIN UMASK
 785 .RE
 786 .PP
 787 userdel
 788 .RS 4
 789 MAIL_DIR MAIL_FILE MAX_MEMBERS_PER_GROUP USERDEL_CMD USERGROUPS_ENAB
 790 .RE
 791 .PP
 792 usermod
 793 .RS 4
 794 MAIL_DIR MAIL_FILE MAX_MEMBERS_PER_GROUP
 795 .RE
 796 .SH "SEE ALSO"
 797 .PP
 798
 799 \fBlogin\fR(1),
 800 \fBpasswd\fR(1),
 801 \fBsu\fR(1),
 802 \fBpasswd\fR(5),
 803 \fBshadow\fR(5),
 804 \fBpam\fR(8)\&.