129 lines
4.1 KiB
Groff
129 lines
4.1 KiB
Groff
|
.\"
|
||
|
|
.\" Manpage Copyright 1994 Olaf Kirch, <okir@monad.swb.de>
|
||
|
|
.\"
|
||
|
|
.TH YPPASSWD 1 "18 December 1994" "" ""
|
||
|
|
.SH NAME
|
||
|
|
yppasswd, ypchfn, ypchsh \- NIS password update clients
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B "yppasswd [-l] [-f] [-p] [user]"
|
||
|
|
.br
|
||
|
|
.B "ypchfn [-l] [-f] [-p] [user]"
|
||
|
|
.br
|
||
|
|
.B "ypchsh [-l] [-f] [-p] [user]"
|
||
|
|
.SH DESCRIPTION
|
||
|
|
When distributing your users' passwords over NIS (a.k.a. YP), the standard
|
||
|
|
\fBpasswd\fP, \fBchfn\fP and \fBchsh\fP utilities cannot be used anymore to
|
||
|
|
let a user change her password, because they only modify the password file
|
||
|
|
on the local host. They are usually replaced by their YP counterparts,
|
||
|
|
\fByppasswd\fP, \fBypchfn\fP and \fBypchsh\fP.
|
||
|
|
.P
|
||
|
|
These commands are in fact the very same program, linked to different names.
|
||
|
|
Using the command line switches, you can choose whether to update your
|
||
|
|
password (\fB-p\fP), your login shell (\fB-l\fP), or your GECOS field
|
||
|
|
information (\fB-f\fP), or a combination of them. \fByppasswd\fP implies
|
||
|
|
the \fB-p\fP option, \fBypchfn\fP the \fB-f\fP option, and so on.
|
||
|
|
.P
|
||
|
|
When invoked without the \fIuser\fP argument, the account information for
|
||
|
|
the invoking user will be updated, otherwise that of \fIuser\fP will be
|
||
|
|
updated. This option is only available to the superuser.
|
||
|
|
.P
|
||
|
|
All tools will first prompt the user for the current NIS password needed
|
||
|
|
for authentication with the \fByppasswdd\fP daemon. Subsequently, the
|
||
|
|
program prompts for the updated information:
|
||
|
|
.\"
|
||
|
|
.\"
|
||
|
|
.IP "\fByppasswd\fP or \fB-p\fP
|
||
|
|
Change the user's NIS password. The user is prompted for the new password.
|
||
|
|
While typing the password, echoing is turned off, so the password does not
|
||
|
|
appear on the screen. An empty password is rejected, as are passwords shorter
|
||
|
|
than six characters. The user will then be requested to retype the
|
||
|
|
password to make sure it wasn't misspelled the first time.
|
||
|
|
.\"
|
||
|
|
.\"
|
||
|
|
.IP "\fBypchsh\fP or \fB-l\fP
|
||
|
|
Change the user's login shell. The user is prompted for a new shell,
|
||
|
|
offering the old one as default:
|
||
|
|
.IP
|
||
|
|
.in +2n
|
||
|
|
.ft B
|
||
|
|
.nf
|
||
|
|
Login shell [/bin/bash]: _
|
||
|
|
.fi
|
||
|
|
.ft
|
||
|
|
.in
|
||
|
|
.IP
|
||
|
|
To accept the default, simply press return. To clear the shell field in
|
||
|
|
your \fBpasswd\fP file entry (so that the system's default shell is selected),
|
||
|
|
enter the string \fInone\fP.
|
||
|
|
.\"
|
||
|
|
.\"
|
||
|
|
.IP "\fBypchfn\fP or \fB-f\fP
|
||
|
|
Change the user's full name and related information. Traditionally, some
|
||
|
|
applications expect the GECOS field (field 4) of the \fBpasswd\fP file to
|
||
|
|
contain the user's real name (as opposed to the login name) plus some
|
||
|
|
additional information like the office phone number. This information is
|
||
|
|
displayed by \fBfinger(1)\fP and probably some other tools, too.
|
||
|
|
.IP
|
||
|
|
When setting the full name, \fBypchfn\fP displays the following prompts,
|
||
|
|
with the defaults in brackets:
|
||
|
|
.IP
|
||
|
|
.in +2n
|
||
|
|
.ft B
|
||
|
|
.nf
|
||
|
|
Name [Joe Doe]:
|
||
|
|
Location [2nd floor, bldg 34]:
|
||
|
|
Office Phone [12345]:
|
||
|
|
Home Phone []:
|
||
|
|
.fi
|
||
|
|
.ft
|
||
|
|
.in
|
||
|
|
.IP
|
||
|
|
To accept a default, simply press return. To clear a field, enter the string
|
||
|
|
\fInone\fP.
|
||
|
|
.SH INSTALLATION
|
||
|
|
\fByppasswd\fP and friends are usually installed over the existing, non-NIS
|
||
|
|
versions of these programs by renaming the old programs, and linking the new
|
||
|
|
ones to the `normal' names. In this way, users can continue to use
|
||
|
|
\fBpasswd\fP without having to meditate on the nature of NIS. For instance,
|
||
|
|
\fByppasswd\fP could be substituted for \fBpasswd\fP with the following
|
||
|
|
sequence of commands:
|
||
|
|
.P
|
||
|
|
.in +2n
|
||
|
|
.ft B
|
||
|
|
.nf
|
||
|
|
# cd /bin
|
||
|
|
# mv passwd passwd.old
|
||
|
|
# chmod go-rwx passwd.old
|
||
|
|
# ln yppasswd passwd
|
||
|
|
.fi
|
||
|
|
.ft R
|
||
|
|
.in
|
||
|
|
.P
|
||
|
|
In this way, the superuser can still use \fBpasswd.old\fP to update the
|
||
|
|
local passwords of users not in the NIS \fBpasswd.*\fP maps. Usually, the
|
||
|
|
user information for critical accounts such as \fBroot\fP are kept
|
||
|
|
in the local \fBpasswd\fP file.
|
||
|
|
.SH LICENSE
|
||
|
|
This program is a heavily beefed-up version of Theo de Raadt's \fByppasswd\fP
|
||
|
|
client, which is covered by the BSD license. Therefore, the BSD license
|
||
|
|
applies to this program as well.
|
||
|
|
.SH FILES
|
||
|
|
\fB/bin/yppasswd\fP
|
||
|
|
.br
|
||
|
|
\fB/bin/passwd\fP
|
||
|
|
.br
|
||
|
|
\fB/bin/ypchfn\fP
|
||
|
|
.br
|
||
|
|
\fB/bin/ypchsh\fP
|
||
|
|
.SH SEE ALSO
|
||
|
|
.BR finger(1) ,
|
||
|
|
.BR passwd(5) ,
|
||
|
|
.BR passwd(1) ,
|
||
|
|
.BR ypchfn(1) ,
|
||
|
|
.BR ypchsh(1) ,
|
||
|
|
.BR yppasswdd(8) .
|
||
|
|
.SH AUTHOR
|
||
|
|
Theo de Raadt <deraadt@fsa.ca> (original client)
|
||
|
|
.br
|
||
|
|
Olaf Kirch <okir@monad.swb.de> (heavy modifications and manpages)
|