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