share/man/man1/kpasswd.1

   1 '\" te
   2 .\" Copyright 1987, 1989 by the Student Information Processing Board of the Massachusetts Institute of Technology.  For copying and distribution information,  please see the file kerberosv5/mit-sipb-copyright.h.
   3 .\" Portions Copyright (c) 2004, Sun Microsystems, Inc.  All Rights Reserved
   4 .\" 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.
   5 .\" 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.
   6 .\" 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]
   7 .TH KPASSWD 1 "Jul 30, 2001"
   8 .SH NAME
   9 kpasswd \- change a user's Kerberos password
  10 .SH SYNOPSIS
  11 .LP
  12 .nf
  13 \fB/usr/bin/kpasswd\fR [\fIprincipal\fR]
  14 .fi
  15
  16 .SH DESCRIPTION
  17 .sp
  18 .LP
  19 The \fBkpasswd\fR command is used to change a Kerberos principal's password.
  20 \fBkpasswd\fR prompts for the current Kerberos password, which is used to
  21 obtain a \fBchangepw\fR ticket from the \fBKDC\fR for the user's Kerberos
  22 realm. If \fBkpasswd\fR successfully obtains the \fBchangepw\fR ticket, the
  23 user is prompted twice for the new password, and the password is changed.
  24 .sp
  25 .LP
  26 If the principal is governed by a policy that specifies the length and/or
  27 number of character classes required in the new password, the new password must
  28 conform to the policy. (The five character classes are lower case, upper case,
  29 numbers, punctuation, and all other characters.)
  30 .SH OPERANDS
  31 .sp
  32 .LP
  33 The following operand is supported:
  34 .sp
  35 .ne 2
  36 .na
  37 \fB\fIprincipal\fR\fR
  38 .ad
  39 .RS 13n
  40 Change the password for the Kerberos principal \fIprincipal\fR. Otherwise, the
  41 principal is derived from the identity of the user invoking the \fBkpasswd\fR
  42 command.
  43 .RE
  44
  45 .SH FILES
  46 .sp
  47 .ne 2
  48 .na
  49 \fB\fB/tmp/ovsec_adm.\fIxxxxxx\fR\fR\fR
  50 .ad
  51 .RS 25n
  52 Temporary credentials cache for the lifetime of the password changing
  53 operation. (\fIxxxxxx\fR is a random string.)
  54 .RE
  55
  56 .SH ATTRIBUTES
  57 .sp
  58 .LP
  59 See \fBattributes\fR(5) for descriptions of the following attributes:
  60 .sp
  61
  62 .sp
  63 .TS
  64 box;
  65 c | c
  66 l | l .
  67 ATTRIBUTE TYPE  ATTRIBUTE VALUE
  68 _
  69 CSI     Enabled
  70 .TE
  71
  72 .SH SEE ALSO
  73 .sp
  74 .LP
  75 \fBkerberos\fR(5)
  76 .SH BUGS
  77 .sp
  78 .LP
  79 If \fBkpasswd\fR is suspended, the \fBchangepw\fR tickets may not be destroyed.