manual/shadow/original/man5/passwd.5

   1 .\"$Id: passwd.5,v 1.8 2002/03/08 04:39:11 kloczek Exp $
   2 .\" Copyright 1989 - 1990, Julianne Frances Haugh
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\" 1. Redistributions of source code must retain the above copyright
   9 .\"    notice, this list of conditions and the following disclaimer.
  10 .\" 2. Redistributions in binary form must reproduce the above copyright
  11 .\"    notice, this list of conditions and the following disclaimer in the
  12 .\"    documentation and/or other materials provided with the distribution.
  13 .\" 3. Neither the name of Julianne F. Haugh nor the names of its contributors
  14 .\"    may be used to endorse or promote products derived from this software
  15 .\"    without specific prior written permission.
  16 .\"
  17 .\" THIS SOFTWARE IS PROVIDED BY JULIE HAUGH AND CONTRIBUTORS ``AS IS'' AND
  18 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  19 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20 .\" ARE DISCLAIMED.  IN NO EVENT SHALL JULIE HAUGH OR CONTRIBUTORS BE LIABLE
  21 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27 .\" SUCH DAMAGE.
  28 .TH PASSWD 5
  29 .SH NAME
  30 passwd \- The password file
  31 .SH DESCRIPTION
  32 .I passwd
  33 contains various pieces of information for each user account.
  34 Included is
  35 .IP "" .5i
  36 Login name
  37 .IP "" .5i
  38 Optional encrypted password
  39 .IP "" .5i
  40 Numerical user ID
  41 .IP "" .5i
  42 Numerical group ID
  43 .IP "" .5i
  44 User name or comment field
  45 .IP "" .5i
  46 User home directory
  47 .IP "" .5i
  48 User command interpreter
  49 .PP
  50 The password field may not be filled if shadow passwords
  51 have been enabled.
  52 If shadow passwords are being used, the encrypted password will
  53 be found in \fI/etc/shadow\fR.
  54 The encryped password consists of 13 characters from the
  55 64 character alphabet
  56 a thru z, A thru Z, 0 thru 9, \. and /.
  57 Refer to \fBcrypt\fR(3) for details on how this string is
  58 interpreted.
  59 .PP
  60 An optional password age string may follow the encrypted
  61 password, separated by a comma, from the same alphabet
  62 as the password itself.
  63 The first character gives the number of weeks during which the
  64 password is valid.
  65 The second character gives the number of weeks which must pass
  66 before the user is permitted to change the password.
  67 The last two characters give the week since Jan 1970 when the
  68 password was last changed.
  69 When the number of weeks during which the password is valid
  70 have passed, the user will be required to provide a new
  71 password.
  72 .PP
  73 The comment field is used by various system utilities, such as
  74 \fBfinger\fR(1).
  75 Three additional values may be present in the comment field.
  76 They are
  77 .IP "" .5i
  78 pri= \- set initial value of nice
  79 .IP "" .5i
  80 umask= \- set initial value of umask
  81 .IP "" .5i
  82 ulimit= \- set initial value of ulimit
  83 .PP
  84 These fields are separated from each other and from any other
  85 comment field by a comma.
  86 .PP
  87 The home directory field provides the name of the initial
  88 working directory.
  89 \fBLogin\fR uses this information to set the value of
  90 the \fBHOME\fR environmental variable.
  91 .PP
  92 The command interpreter field provides the name of the user's
  93 command language interpreter, or the name of the initial program
  94 to execute.
  95 \fBLogin\fR uses this information to set the value of the
  96 \fBSHELL\fR environmental variable.
  97 If this field is empty, it defaults to the value \fB/bin/sh\fR.
  98 .SH FILES
  99 /etc/passwd \- user account information
 100 .SH SEE ALSO
 101 .BR login (1),
 102 .BR passwd (1),
 103 .BR su (1),
 104 .BR shadow (5),
 105 .BR pwconv (8),
 106 .BR pwunconv (8),
 107 .BR sulogin (8)
 108 .SH AUTHOR
 109 Julianne Frances Haugh (jockgrrl@ix.netcom.com)