[unix-history] / usr / share / man / cat1 / kinit.0



KINIT(1)               BSD Reference Manual              KINIT(1)


N\bNA\bAM\bME\bE
       kinit - Kerberos login utility

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
       k\bki\bin\bni\bit\bt [ -\b-i\bir\brv\bvl\bl ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
       The _\bk_\bi_\bn_\bi_\bt command is used to login to the Kerberos authen-
       tication and authorization system.  Note that only  regis-
       tered  Kerberos  users  can  use the Kerberos system.  For
       information about registering as a Kerberos user, see  the
       _\bk_\be_\br_\bb_\be_\br_\bo_\bs_\b(_\b1_\b) manual page.

       If  you are logged in to a workstation that is running the
       _\bt_\bo_\be_\bh_\bo_\bl_\bd service, you do not have to use _\bk_\bi_\bn_\bi_\bt_\b.   The  _\bt_\bo_\be_\b-
       _\bh_\bo_\bl_\bd  login procedure will log you into Kerberos automati-
       cally.  You will need to use _\bk_\bi_\bn_\bi_\bt only  in  those  situa-
       tions in which your original tickets have expired.  (Tick-
       ets expire in about a day.)  Note  as  well  that  _\bt_\bo_\be_\bh_\bo_\bl_\bd
       will  automatically  destroy  your tickets when you logout
       from the workstation.

       When you use _\bk_\bi_\bn_\bi_\bt without options,  the  utility  prompts
       for  your  username  and  Kerberos  password, and tries to
       authenticate your login with the local Kerberos server.

       If  Kerberos  authenticates  the  login   attempt,   _\bk_\bi_\bn_\bi_\bt
       retrieves  your  initial  ticket and puts it in the ticket
       file specified by your KRBTKFILE environment variable.  If
       this  variable is undefined, your ticket will be stored in
       the _\b/_\bt_\bm_\bp directory, in the file _\bt_\bk_\bt_\bu_\bi_\bd _\b, where _\bu_\bi_\bd  speci-
       fies your user identification number.

       If  you  have logged in to Kerberos without the benefit of
       the workstation _\bt_\bo_\be_\bh_\bo_\bl_\bd system, make sure you use the _\bk_\bd_\be_\b-
       _\bs_\bt_\br_\bo_\by command to destroy any active tickets before you end
       your login session.  You may want to put the _\bk_\bd_\be_\bs_\bt_\br_\bo_\by com-
       mand  in  your  _\b._\bl_\bo_\bg_\bo_\bu_\bt  file so that your tickets will be
       destroyed automatically when you logout.

       The options to _\bk_\bi_\bn_\bi_\bt are as follows:

       -\b-i\bi     _\bk_\bi_\bn_\bi_\bt prompts you for a Kerberos instance.

       -\b-r\br     _\bk_\bi_\bn_\bi_\bt prompts  you  for  a  Kerberos  realm.   This
              option lets you authenticate yourself with a remote
              Kerberos server.

       -\b-v\bv     Verbose mode.  _\bk_\bi_\bn_\bi_\bt prints the name of the  ticket
              file used, and a status message indicating the suc-
              cess or failure of your login attempt.


MIT Project Athena     Kerberos Version 4.0                     1


KINIT(1)               BSD Reference Manual              KINIT(1)


       -\b-l\bl     _\bk_\bi_\bn_\bi_\bt prompts you for a ticket lifetime in minutes.
              Due to protocol restrictions in Kerberos Version 4,
              this value must be between 5 and 1275 minutes.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
       kerberos(1), kdestroy(1), klist(1), toehold(1)

B\bBU\bUG\bGS\bS
       The -\b-r\br option has not been fully implemented.

A\bAU\bUT\bTH\bHO\bOR\bRS\bS
       Steve Miller, MIT Project Athena/Digital Equipment  Corpo-
       ration
       Clifford Neuman, MIT Project Athena


MIT Project Athena     Kerberos Version 4.0                     2
Commit	Line	Data
b1052012 C	1
	2
	3
	4	KINIT(1) BSD Reference Manual KINIT(1)
	5
	6
	7	N\bNA\bAM\bME\bE
	8	kinit - Kerberos login utility
	9
	10	S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
	11	k\bki\bin\bni\bit\bt [ -\b-i\bir\brv\bvl\bl ]
	12
	13	D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
	14	The _\bk_\bi_\bn_\bi_\bt command is used to login to the Kerberos authen-
	15	tication and authorization system. Note that only regis-
	16	tered Kerberos users can use the Kerberos system. For
	17	information about registering as a Kerberos user, see the
	18	_\bk_\be_\br_\bb_\be_\br_\bo_\bs_\b(_\b1_\b) manual page.
	19
	20	If you are logged in to a workstation that is running the
	21	_\bt_\bo_\be_\bh_\bo_\bl_\bd service, you do not have to use _\bk_\bi_\bn_\bi_\bt_\b. The _\bt_\bo_\be_\b-
	22	_\bh_\bo_\bl_\bd login procedure will log you into Kerberos automati-
	23	cally. You will need to use _\bk_\bi_\bn_\bi_\bt only in those situa-
	24	tions in which your original tickets have expired. (Tick-
	25	ets expire in about a day.) Note as well that _\bt_\bo_\be_\bh_\bo_\bl_\bd
	26	will automatically destroy your tickets when you logout
	27	from the workstation.
	28
	29	When you use _\bk_\bi_\bn_\bi_\bt without options, the utility prompts
	30	for your username and Kerberos password, and tries to
	31	authenticate your login with the local Kerberos server.
	32
	33	If Kerberos authenticates the login attempt, _\bk_\bi_\bn_\bi_\bt
	34	retrieves your initial ticket and puts it in the ticket
	35	file specified by your KRBTKFILE environment variable. If
	36	this variable is undefined, your ticket will be stored in
	37	the _\b/_\bt_\bm_\bp directory, in the file _\bt_\bk_\bt_\bu_\bi_\bd _\b, where _\bu_\bi_\bd speci-
	38	fies your user identification number.
	39
	40	If you have logged in to Kerberos without the benefit of
	41	the workstation _\bt_\bo_\be_\bh_\bo_\bl_\bd system, make sure you use the _\bk_\bd_\be_\b-
	42	_\bs_\bt_\br_\bo_\by command to destroy any active tickets before you end
	43	your login session. You may want to put the _\bk_\bd_\be_\bs_\bt_\br_\bo_\by com-
	44	mand in your _\b._\bl_\bo_\bg_\bo_\bu_\bt file so that your tickets will be
	45	destroyed automatically when you logout.
	46
	47	The options to _\bk_\bi_\bn_\bi_\bt are as follows:
	48
	49	-\b-i\bi _\bk_\bi_\bn_\bi_\bt prompts you for a Kerberos instance.
	50
	51	-\b-r\br _\bk_\bi_\bn_\bi_\bt prompts you for a Kerberos realm. This
	52	option lets you authenticate yourself with a remote
	53	Kerberos server.
	54
	55	-\b-v\bv Verbose mode. _\bk_\bi_\bn_\bi_\bt prints the name of the ticket
	56	file used, and a status message indicating the suc-
	57	cess or failure of your login attempt.
	58
	59
	60
	61	MIT Project Athena Kerberos Version 4.0 1
	62
	63
	64
65
66
67
68
69
70	KINIT(1) BSD Reference Manual KINIT(1)
71
72
73	-\b-l\bl _\bk_\bi_\bn_\bi_\bt prompts you for a ticket lifetime in minutes.
74	Due to protocol restrictions in Kerberos Version 4,
75	this value must be between 5 and 1275 minutes.
76
77	S\bSE\bEE\bE A\bAL\bLS\bSO\bO
78	kerberos(1), kdestroy(1), klist(1), toehold(1)
79
80	B\bBU\bUG\bGS\bS
81	The -\b-r\br option has not been fully implemented.
82
83	A\bAU\bUT\bTH\bHO\bOR\bRS\bS
84	Steve Miller, MIT Project Athena/Digital Equipment Corpo-
85	ration
86	Clifford Neuman, MIT Project Athena
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127	MIT Project Athena Kerberos Version 4.0 2
128
129
130
131
132