Return to kinit.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / old / athena / kinit

Annotation of 43BSDReno/old/athena/kinit/kinit.1, revision 1.1.1.1

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.