xref: /freebsd/crypto/krb5/src/windows/leash/htmlhelp/html/KSWITCH.htm (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
2<HTML>
3<HEAD>
4<meta name="GENERATOR" content="Microsoft&reg; HTML Help Workshop 4.1">
5<link rel="stylesheet" type="text/css" href="Leash.css" />
6<Title>KSWITCH</Title>
7</HEAD>
8<BODY>
9<H1>KSWITCH Command</H1>
10
11<table>
12<tr><th id="th2"> The following information reproduces the information from UNIX man page for the KSWITCH command.</th>
13</tr>
14</table>
15<H2>SYNOPSIS</H2>
16<table>
17<tr>
18<th id="th2">kswitch </th>
19<td>
20
21<span class="command"> { <B>-c</B> <I>cache</I><B>_</B><I>name</I> | <B>-p</B> <I>principal</I> }</span>
22</td>
23</tr>
24</table>
25
26<H2>DESCRIPTION</H2>
27<p>
28       <span class="command">  <I>kswitch </I></span>  makes the specified credential cache the primary cache for the collection, if a cache collection is available.
29</p>
30
31<H2>OPTIONS</H2>
32
33
34<table>
35<tr>
36<th id="th2"><span class="command">  <B>-c</B> <I>cache</I><B>_</B><I>name</I>   </span></th>
37<td> Directly specifies the credential cache to be made primary.
38</td>
39</tr>
40<tr>
41<th id="th2"><span class="command"> <B>-p</B> <I>principal</I>  </span></th>
42<td> Causes the cache collection to be searched for a cache containing credentials for principal. If one is found, that collection is made primary.
43</td>
44</tr>
45      </table>
46
47
48<H2>ENVIRONMENT</H2>
49<p>     <B>kswitch</B> uses the following environment variables:</p>
50<table>
51<tr>
52<th id="th2"> KRB5CCNAME</th>
53<td>      Location of the default Kerberos 5 credentials (ticket)
54                       cache, in the form <I>type</I>:<I>residual</I>.  If no type prefix is
55                       present,  the  <B>FILE</B>  type  is assumed.  The type of the
56                       default cache may determine the availability of a cache
57                       collection;  for  instance, a default cache of type <B>DIR</B>
58                       causes caches within the directory to be present in the
59                       collection. </td>
60</tr>
61</table>
62
63<H2>FILES</H2>
64<table>
65<tr>
66  <th id="th2">     <span class="command">   /tmp/krb5cc_[uid] </span></th>
67<td>       default  location  of  Kerberos  5 credentials cache ([uid] is the decimal UID of the user). </td></tr>
68
69</table>
70
71<H2>SEE ALSO</H2>
72<ul id="helpul">
73<li><a href="HTML/KINIT.htm"><B>kinit</B></a> </li>
74<li><a href="HTML/KDESTROY.htm"><B>kdestroy</B></a></li>
75<li><a href="HTML/KLIST.htm"><B>klist</B></a> </li>
76<li><B>kerberos (1)</B></li>
77
78
79</BODY>
80</HTML>
81