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