usr/src/man/man1/yppasswd.1

   1 '\" te
   2 .\" Copyright (c) 2001, Sun Microsystems, Inc.  All Rights Reserved
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH YPPASSWD 1 "Nov 28, 2001"
   7 .SH NAME
   8 yppasswd \- change your network password in the NIS database
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fByppasswd\fR [\fIusername\fR]
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .sp
  17 .LP
  18 The \fByppasswd\fR utility changes the network password  associated with the
  19 user \fIusername\fR in the Network Information Service (\fBNIS\fR) database. If
  20 the user has done a \fBkeylogin\fR(1), and a publickey/secretkey pair exists
  21 for the user in the \fBNIS\fR \fBpublickey.byname\fR map, \fByppasswd\fR also
  22 re-encrypts the secretkey with the new password. The \fBNIS\fR password may be
  23 different from the local one on your own machine.
  24 .sp
  25 .LP
  26 \fByppasswd\fR prompts for the old  \fBNIS\fR password, and then for the new
  27 one. You must type in the old password correctly for the change to take effect.
  28 The new password must be typed twice, to forestall mistakes.
  29 .sp
  30 .LP
  31 New passwords must be at least four characters long, if they use a sufficiently
  32 rich alphabet, and at least six characters long if monocase. These rules are
  33 relaxed if you are insistent enough. Only the owner of the name or the
  34 super-user may change a password; superuser on the root master will not be
  35 prompted for the old password, and does not need to follow password
  36 construction requirements.
  37 .sp
  38 .LP
  39 The \fBNIS\fR password daemon, \fBrpc.yppasswdd\fR must be running on your
  40 \fBNIS\fR server in order for the new password to take effect.
  41 .SH SEE ALSO
  42 .sp
  43 .LP
  44 \fBkeylogin\fR(1), \fBlogin\fR(1), \fBNIS+\fR(1), \fBnispasswd\fR(1),
  45 \fBpasswd\fR(1), \fBgetpwnam\fR(3C), \fBgetspnam\fR(3C),
  46 \fBsecure_rpc\fR(3NSL), \fBnsswitch.conf\fR(4), \fBattributes\fR(5)
  47 .SH WARNINGS
  48 .sp
  49 .LP
  50 Even after the user has successfully changed his or her password using this
  51 command, the subsequent \fBlogin\fR(1) using the new password will be
  52 successful only if the user's password and shadow information is obtained from
  53 NIS. See \fBgetpwnam\fR(3C), \fBgetspnam\fR(3C), and \fBnsswitch.conf\fR(4).
  54 .SH NOTES
  55 .sp
  56 .LP
  57 The use of \fByppasswd\fR is discouraged, as it is now only a wrapper around
  58 the \fBpasswd\fR(1) command, which should be used instead. Using
  59 \fBpasswd\fR(1) with the \fB-r\fR \fBnis\fR option (see \fBNIS+\fR(1)) will
  60 achieve the same results, and will be consistent across all the different name
  61 services available.
  62 .SH BUGS
  63 .sp
  64 .LP
  65 The update protocol passes all the information to the server in one \fBRPC\fR
  66 call, without ever looking at it. Thus, if you type your old password
  67 incorrectly, you will not be notified until after you have entered your new
  68 password.