summaryrefslogtreecommitdiffstats
path: root/doc/rst_source/krb_users/user_commands/kswitch.rst
blob: 261660dada5832679f61b797ac6476856fa2c261 (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
.. _kswitch(1):

kswitch
=======

SYNOPSIS
~~~~~~~~

**kswitch**
{**-c** *cachename*\|\ **-p** *principal*}


DESCRIPTION
-----------

kswitch makes the specified credential cache the primary cache for the
collection, if a cache collection is available.


OPTIONS
-------

**-c** *cachename*
    Directly specifies the credential cache to be made primary.

**-p** *principal*
    Causes the cache collection to be searched for a cache containing
    credentials for *principal*.  If one is found, that collection is
    made primary.


ENVIRONMENT
-----------

kswitch uses the following environment variables:

**KRB5CCNAME**
    Location of the default Kerberos 5 credentials (ticket) cache, in
    the form *type*:*residual*.  If no *type* prefix is present, the
    **FILE** type is assumed.  The type of the default cache may
    determine the availability of a cache collection; for instance, a
    default cache of type **DIR** causes caches within the directory
    to be present in the collection.


FILES
-----

|ccache|
    Default location of Kerberos 5 credentials cache


SEE ALSO
--------

:ref:`kinit(1)`, :ref:`kdestroy(1)`, :ref:`klist(1)`), kerberos(1)