crypto/kerberosIV/man/kpasswd.1

   1 .\" $Id: kpasswd.1,v 1.2 1996/06/12 21:29:21 bg Exp $
   2 .\" Copyright 1989 by the Massachusetts Institute of Technology.
   3 .\"
   4 .\" For copying and distribution information,
   5 .\" please see the file <mit-copyright.h>.
   6 .\"
   7 .TH KPASSWD 1 "Kerberos Version 4.0" "MIT Project Athena"
   8 .FM mit
   9 .SH NAME
  10 kpasswd \- change a user's Kerberos password
  11 .SH SYNOPSIS
  12 .B kpasswd
  13 [
  14 .B \-h
  15 ] [
  16 .B \-n
  17 .I name
  18 ] [
  19 .B \-i
  20 .I instance
  21 ] [
  22 .B \-r
  23 .I realm
  24 ] [
  25 \-u
  26 .IR username[.instance][@realm] ]
  27 .SH DESCRIPTION
  28 The
  29 .I kpasswd
  30 command is used to change a Kerberos principal's password.
  31 .PP
  32 If the
  33 .I \-h
  34 option is specified, a brief summary of the options is printed, and
  35 .I kpasswd
  36 then exits.
  37 .PP
  38 If the
  39 .I \-n
  40 option is specified,
  41 .I name
  42 is used as the principal name rather than the username of the user
  43 running
  44 .IR kpasswd .
  45 (This is determined from the ticket file if it exists;
  46 otherwise, it is determined from the unix user id.)
  47 .PP
  48 If the
  49 .I \-i
  50 option is specified,
  51 .I instance
  52 is used as the instance rather than a null instance.
  53 .PP
  54 If the
  55 .I \-r
  56 option is specified,
  57 .I realm
  58 is used as the realm rather than the local realm.
  59 .PP
  60 If the
  61 .I \-u
  62 option is specified, a fully qualified kerberos
  63 principal can be given.
  64 .PP
  65
  66 The utility prompts for the current Kerberos password (printing
  67 the name of the principal for which it intends to change the password),
  68 which is verified by the Kerberos server.  If the old password is
  69 correct, the user is prompted twice for the new password.  A message is
  70 printed indicating the success or failure of the password changing
  71 operation.
  72
  73 .SH BUGS
  74
  75 .I kpasswd
  76 does not handle names, instances, or realms with special
  77 characters in them when the -n, -i, or -r options are used.  Any
  78 valid fullname is accepted, however, if the -u option is used.
  79
  80 If the principal whose password you are trying to change does
  81 not exist, you will not be told until after you have entered the
  82 old password.
  83
  84 .SH SEE ALSO
  85 kerberos(1), kinit(1), passwd(1), kadmin(8)