summaryrefslogtreecommitdiffstats
path: root/src/man/kswitch.man
blob: b265b78fb0489979ee54c70b189cdd84186b8616 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
.TH "KSWITCH" "1" " " "0.0.1" "MIT Kerberos"
.SH NAME
kswitch \- switch primary ticket cache
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructeredText.
.
.SH SYNOPSIS
.sp
\fBkswitch\fP
{\fB\-c\fP \fIcachename\fP|\fB\-p\fP \fIprincipal\fP}
.SS DESCRIPTION
.sp
kswitch makes the specified credential cache the primary cache for the
collection, if a cache collection is available.
.SS OPTIONS
.INDENT 0.0
.TP
.B \fB\-c\fP \fIcachename\fP
.sp
Directly specifies the credential cache to be made primary.
.TP
.B \fB\-p\fP \fIprincipal\fP
.sp
Causes the cache collection to be searched for a cache containing
credentials for \fIprincipal\fP.  If one is found, that collection is
made primary.
.UNINDENT
.SS ENVIRONMENT
.sp
kswitch uses the following environment variables:
.INDENT 0.0
.TP
.B \fBKRB5CCNAME\fP
.sp
Location of the default Kerberos 5 credentials (ticket) cache, in
the form \fItype\fP:\fIresidual\fP.  If no \fItype\fP prefix is present, the
\fBFILE\fP type is assumed.  The type of the default cache may
determine the availability of a cache collection; for instance, a
default cache of type \fBDIR\fP causes caches within the directory
to be present in the collection.
.UNINDENT
.SS FILES
.INDENT 0.0
.TP
.B \fB/tmp/krb5cc_[uid]\fP
.sp
Default location of Kerberos 5 credentials cache ([\fIuid\fP] is the
decimal UID of the user).
.UNINDENT
.SS SEE ALSO
.sp
\fIkinit(1)\fP, \fIkdestroy(1)\fP, \fIklist(1)\fP), kerberos(1)
.SH AUTHOR
MIT
.SH COPYRIGHT
2011, MIT
.\" Generated by docutils manpage writer.
.