crypto/kerberosIV/man/kinit.1

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