|
|
1.1 ! root 1: .\" $Source: /mit/kerberos/src/man/RCS/kinit.1,v $ ! 2: .\" $Author: jtkohl $ ! 3: .\" $Header: kinit.1,v 4.6 89/01/23 11:39:11 jtkohl Exp $ ! 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 ! 11: kinit \- Kerberos login utility ! 12: .SH SYNOPSIS ! 13: .B kinit ! 14: [ ! 15: .B \-irvl ! 16: ] ! 17: .SH DESCRIPTION ! 18: The ! 19: .I kinit ! 20: command is used to login to the ! 21: Kerberos ! 22: authentication and authorization system. ! 23: Note that only registered ! 24: Kerberos ! 25: users can use the ! 26: Kerberos ! 27: system. ! 28: For information about registering as a ! 29: Kerberos ! 30: user, ! 31: see the ! 32: .I kerberos(1) ! 33: manual page. ! 34: .PP ! 35: If you system is configured so that ! 36: .IR login (1) ! 37: automatically provides your initial tickets, ! 38: you do not have to use ! 39: .I kinit. ! 40: You will need to use ! 41: .I kinit ! 42: only in those situations in which ! 43: your original tickets have expired. ! 44: (Tickets expire in about a day.) ! 45: .PP ! 46: When you use ! 47: .I kinit ! 48: without options, ! 49: the utility ! 50: prompts for your Kerberos principal name and password, ! 51: and tries to authenticate your login with the local realm's ! 52: Kerberos ! 53: server. ! 54: .PP ! 55: If ! 56: Kerberos ! 57: authenticates the login attempt, ! 58: .I kinit ! 59: retrieves your initial ticket and puts it in the ticket file specified by ! 60: your KRBTKFILE environment variable. ! 61: If this variable is undefined, ! 62: your ticket will be stored in the ! 63: .IR /tmp ! 64: directory, ! 65: in the file ! 66: .I tktuid , ! 67: where ! 68: .I uid ! 69: specifies your user identification number. ! 70: .PP ! 71: Make sure you use the ! 72: .I kdestroy ! 73: command to destroy any active tickets before you end your login session. ! 74: You may want to put the ! 75: .I kdestroy ! 76: command in your ! 77: .I \.logout ! 78: file so that your tickets will be destroyed automatically when you logout. ! 79: .PP ! 80: The options to ! 81: .I kinit ! 82: are as follows: ! 83: .TP 7 ! 84: .B \-i ! 85: .I kinit ! 86: prompts you for a ! 87: Kerberos ! 88: instance. ! 89: .TP ! 90: .B \-r ! 91: .I kinit ! 92: prompts you for a ! 93: Kerberos ! 94: realm. ! 95: This option lets you authenticate yourself with a remote ! 96: Kerberos ! 97: server. ! 98: .TP ! 99: .B \-v ! 100: Verbose mode. ! 101: .I kinit ! 102: prints the location of your tickets, and ! 103: a status message indicating the success or failure of ! 104: your login attempt. ! 105: .TP ! 106: .B \-l ! 107: .I kinit ! 108: prompts you for a ticket lifetime in minutes. Due to protocol ! 109: restrictions in Kerberos Version 4, this value must be between 5 and ! 110: 1275 minutes. ! 111: .SH SEE ALSO ! 112: .PP ! 113: kerberos(1), kdestroy(1), klist(1) ! 114: .SH BUGS ! 115: The ! 116: .B \-r ! 117: option has not been fully implemented. ! 118: .SH AUTHORS ! 119: Steve Miller, MIT Project Athena/Digital Equipment Corporation ! 120: .br ! 121: Clifford Neuman, MIT Project Athena
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.