crypto/kerberosIV/man/kinit.1

   1 .\" $Id$
   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 KINIT 1 "Kerberos Version 4.0" "MIT Project Athena"
   8 .SH NAME
   9 kinit \- Kerberos login utility
  10 .SH SYNOPSIS
  11 .B kinit
  12 [
  13 .B \-irvlp
  14 ]
  15 .SH DESCRIPTION
  16 The
  17 .I kinit
  18 command is used to login to the
  19 Kerberos
  20 authentication and authorization system.
  21 Note that only registered
  22 Kerberos
  23 users can use the
  24 Kerberos
  25 system.
  26 For information about registering as a
  27 Kerberos
  28 user,
  29 see the
  30 .I kerberos(1)
  31 manual page.
  32 .PP
  33 If you are logged in to a workstation that is running the
  34 .I toehold
  35 service,
  36 you do not have to use
  37 .I kinit.
  38 The
  39 .I toehold
  40 login procedure will log you into
  41 Kerberos
  42 automatically.
  43 You will need to use
  44 .I kinit
  45 only in those situations in which
  46 your original tickets have expired.
  47 (Tickets expire in about a day.)
  48 Note as well that
  49 .I toehold
  50 will automatically destroy your tickets when you logout from the workstation.
  51 .PP
  52 When you use
  53 .I kinit
  54 without options,
  55 the utility
  56 prompts for your username and Kerberos password,
  57 and tries to authenticate your login with the local
  58 Kerberos
  59 server.
  60 .PP
  61 If
  62 Kerberos
  63 authenticates the login attempt,
  64 .I kinit
  65 retrieves your initial ticket and puts it in the ticket file specified by
  66 your KRBTKFILE environment variable.
  67 If this variable is undefined,
  68 your ticket will be stored in the
  69 .IR /tmp
  70 directory,
  71 in the file
  72 .I tktuid ,
  73 where
  74 .I uid
  75 specifies your user identification number.
  76 .PP
  77 If you have logged in to
  78 Kerberos
  79 without the benefit of the workstation
  80 .I toehold
  81 system,
  82 make sure you use the
  83 .I kdestroy
  84 command to destroy any active tickets before you end your login session.
  85 You may want to put the
  86 .I kdestroy
  87 command in your
  88 .I \.logout
  89 file so that your tickets will be destroyed automatically when you logout.
  90 .PP
  91 The options to
  92 .I kinit
  93 are as follows:
  94 .TP 7
  95 .B \-i
  96 .I kinit
  97 prompts you for a
  98 Kerberos
  99 instance.
 100 .TP
 101 .B \-r
 102 .I kinit
 103 prompts you for a
 104 Kerberos
 105 realm.
 106 This option lets you authenticate yourself with a remote
 107 Kerberos
 108 server.
 109 .TP
 110 .B \-v
 111 Verbose mode.
 112 .I kinit
 113 prints the realm you are in, the name of the ticket file used, and
 114 a status message indicating the success or failure of
 115 your login attempt.
 116 .TP
 117 .B \-l
 118 .I kinit
 119 prompts you for a ticket lifetime in minutes.  Due to protocol
 120 restrictions in Kerberos Version 4, this value must be between 5 and
 121 1275 minutes.
 122 .TP
 123 .B \-p
 124 .I kinit
 125 will acquires a ticket for chpass.kerberos.
 126 .SH SEE ALSO
 127 .PP
 128 kerberos(1), kdestroy(1), klist(1), toehold(1)
 129 .SH BUGS
 130 The
 131 .B \-r
 132 option has not been fully implemented.
 133 .SH AUTHORS
 134 Steve Miller, MIT Project Athena/Digital Equipment Corporation
 135 .br
 136 Clifford Neuman, MIT Project Athena