Return to passwd.1 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man1

Annotation of 43BSDTahoe/man/man1/passwd.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1980 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)passwd.1    6.4 (Berkeley) 6/5/86
                      6: .\"
                      7: .TH PASSWD 1 "June 5, 1986"
                      8: .UC 4
                      9: .SH NAME
                     10: chfn, chsh, passwd \- change password file information
                     11: .SH SYNOPSIS
                     12: .B passwd
                     13: [
                     14: .B \-f
                     15: ] [
                     16: .B \-s
                     17: ] [ name ]
                     18: .SH DESCRIPTION
                     19: This command changes (or installs)
                     20: a password, login shell
                     21: .RB ( \-s
                     22: option), or GECOS information field
                     23: .RB ( \-f
                     24: option)
                     25: associated with the user
                     26: .IR name
                     27: (your own name by default).
                     28: .PP
                     29: When altering a password,
                     30: the program prompts for the current password and then for the new one.
                     31: The caller must supply both.
                     32: The new password must be typed twice to forestall mistakes.
                     33: .PP
                     34: New passwords must be at least four characters long if they use
                     35: a sufficiently rich alphabet and at least six characters long
                     36: if monocase.
                     37: These rules are relaxed if you are insistent enough.
                     38: .PP
                     39: Only the owner of the name or the super-user may change a password;
                     40: the owner must prove he knows the old password.
                     41: .PP
                     42: When altering a login shell,
                     43: .I passwd
                     44: displays the current login shell and then prompts
                     45: for the new one.
                     46: The new login shell must be one of the approved shells
                     47: listed in
                     48: .I /etc/shells
                     49: unless you are the super-user.
                     50: If
                     51: .I /etc/shells
                     52: does not exist, the only shells that may be specified are
                     53: .I /bin/sh
                     54: and
                     55: .IR /bin/csh .
                     56: .PP
                     57: The super-user may change anyone's login shell; normal users
                     58: may only change their own login shell.
                     59: .PP
                     60: When altering the GECOS information field,
                     61: .I passwd
                     62: displays the current information, broken into
                     63: fields, as interpreted by the
                     64: .IR finger (1)
                     65: program, among others, and prompts for new values.
                     66: These fields include a user's
                     67: ``real life'' name, office room number,
                     68: office phone number, and home phone number.
                     69: Included in each prompt is a default value,
                     70: which is enclosed between brackets.
                     71: The default value is accepted simply by typing a carriage
                     72: return.  To enter a blank field, the word ``none'' may
                     73: be typed.  Below is a sample run:
                     74: .IP
                     75: .B "Name [Biff Studsworth II]:"
                     76: .br
                     77: .B "Room number (Exs: 597E or 197C) []:"
                     78: 521E
                     79: .br
                     80: .B "Office Phone (Ex: 1632) []:"
                     81: 1863
                     82: .br
                     83: .B "Home Phone (Ex: 987532) [5771546]:"
                     84: none
                     85: .sp
                     86: .PP
                     87: .I Passwd
                     88: allows phone numbers to be entered with or without hyphens.
                     89: It is a good idea to run
                     90: .I finger
                     91: after changing the GECOS information
                     92: to make sure everything is setup properly.
                     93: .PP
                     94: The super-user may change anyone's GECOS information; normal
                     95: users may only change their own.
                     96: .SH FILES
                     97: /etc/passwd    The file containing all of this information
                     98: .br
                     99: /etc/shells    The list of approved shells
                    100: .SH "SEE ALSO"
                    101: login(1), finger(1), passwd(5), crypt(3)
                    102: .br
                    103: Robert Morris and Ken Thompson,
                    104: .I UNIX password security

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.