Initial import from FreeBSD RELENG_4:
[dragonfly.git] / crypto / kerberosIV / man / ksrvtgt.1
1 .\" $Id: ksrvtgt.1,v 1.2 1996/06/12 21:29:26 bg Exp $
2 .\" Copyright 1989 by the Massachusetts Institute of Technology.
3 .\"
4 .\" For copying and distribution information,
5 .\" please see the file <mit-copyright.h>.
6 .\"
7 .TH KSRVTGT 1 "Kerberos Version 4.0" "MIT Project Athena"
8 .SH NAME
9 ksrvtgt \- fetch and store Kerberos ticket-granting-ticket using a
10 service key
11 .SH SYNOPSIS
12 .B ksrvtgt
13 name instance [[realm] srvtab]
14 .SH DESCRIPTION
15 .I ksrvtgt
16 retrieves a ticket-granting ticket with a lifetime of five (5) minutes
17 for the principal
18 .I name.instance@realm
19 (or 
20 .I name.instance@localrealm
21 if
22 .I realm
23 is not supplied on the command line), decrypts the response using
24 the service key found in
25 .I srvtab
26 (or in 
27 .B /etc/srvtab
28 if
29 .I srvtab
30 is not specified on the command line), and stores the ticket in the
31 standard ticket cache.
32 .PP
33 This command is intended primarily for use in shell scripts and other
34 batch-type facilities.
35 .SH DIAGNOSTICS
36 "Generic kerberos failure (kfailure)" can indicate a whole range of
37 problems, the most common of which is the inability to read the service
38 key file.
39 .SH FILES
40 .TP 2i
41 /etc/krb.conf
42 to get the name of the local realm.
43 .TP
44 /tmp/tkt[uid]
45 The default ticket file.
46 .TP
47 /etc/srvtab
48 The default service key file.
49 .SH SEE ALSO
50 kerberos(1), kinit(1), kdestroy(1)