<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>kswitch — MIT Kerberos Documentation</title> <link rel="stylesheet" href="../../_static/agogo.css" type="text/css" /> <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" /> <link rel="stylesheet" href="../../_static/kerb.css" type="text/css" /> <script type="text/javascript"> var DOCUMENTATION_OPTIONS = { URL_ROOT: '../../', VERSION: '1.11.4', COLLAPSE_INDEX: false, FILE_SUFFIX: '.html', HAS_SOURCE: true }; </script> <script type="text/javascript" src="../../_static/jquery.js"></script> <script type="text/javascript" src="../../_static/underscore.js"></script> <script type="text/javascript" src="../../_static/doctools.js"></script> <link rel="author" title="About these documents" href="../../about.html" /> <link rel="copyright" title="Copyright" href="../../copyright.html" /> <link rel="top" title="MIT Kerberos Documentation" href="../../index.html" /> <link rel="up" title="User commands" href="index.html" /> <link rel="next" title="kvno" href="kvno.html" /> <link rel="prev" title="ksu" href="ksu.html" /> </head> <body> <div class="header-wrapper"> <div class="header" style="padding-bottom: 0px;"> <h1><a href="../../index.html" style="color: #5d1509; font-size: 120%; padding-top: 10px;">MIT Kerberos Documentation</a></h1> <div class="rel"> <a href="../../index.html" title="Full Table of Contents" accesskey="C">Contents</a> | <a href="ksu.html" title="ksu" accesskey="P">previous</a> | <a href="kvno.html" title="kvno" accesskey="N">next</a> | <a href="../../genindex.html" title="General Index" accesskey="I">index</a> | <a href="../../search.html" title="Enter search criteria" accesskey="S">Search</a> | <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__kswitch">feedback</a> </div> </div> </div> <div class="content-wrapper"> <div class="content"> <div class="sidebar" style="float: right; background: #F9F9F9"> <h2>On this page </h2> <ul> <li><a class="reference internal" href="#">kswitch</a><ul> <li><a class="reference internal" href="#synopsis">SYNOPSIS</a></li> <li><a class="reference internal" href="#description">DESCRIPTION</a></li> <li><a class="reference internal" href="#options">OPTIONS</a></li> <li><a class="reference internal" href="#environment">ENVIRONMENT</a></li> <li><a class="reference internal" href="#files">FILES</a></li> <li><a class="reference internal" href="#see-also">SEE ALSO</a></li> </ul> </li> </ul> <br/> <h2>Table of contents</h2> <ul class="current"> <li class="toctree-l1 current"><a class="reference internal" href="../index.html">For users</a><ul class="current"> <li class="toctree-l2"><a class="reference internal" href="../pwd_mgmt.html">Password management</a></li> <li class="toctree-l2"><a class="reference internal" href="../tkt_mgmt.html">Ticket management</a></li> <li class="toctree-l2"><a class="reference internal" href="../user_config/index.html">User config files</a></li> <li class="toctree-l2 current"><a class="reference internal" href="index.html">User commands</a><ul class="current"> <li class="toctree-l3"><a class="reference internal" href="kdestroy.html">kdestroy</a></li> <li class="toctree-l3"><a class="reference internal" href="kinit.html">kinit</a></li> <li class="toctree-l3"><a class="reference internal" href="klist.html">klist</a></li> <li class="toctree-l3"><a class="reference internal" href="kpasswd.html">kpasswd</a></li> <li class="toctree-l3"><a class="reference internal" href="krb5-config.html">krb5-config</a></li> <li class="toctree-l3"><a class="reference internal" href="ksu.html">ksu</a></li> <li class="toctree-l3 current"><a class="current reference internal" href="">kswitch</a></li> <li class="toctree-l3"><a class="reference internal" href="kvno.html">kvno</a></li> <li class="toctree-l3"><a class="reference internal" href="sclient.html">sclient</a></li> </ul> </li> </ul> </li> <li class="toctree-l1"><a class="reference internal" href="../../admin/index.html">For administrators</a></li> <li class="toctree-l1"><a class="reference internal" href="../../appdev/index.html">For application developers</a></li> <li class="toctree-l1"><a class="reference internal" href="../../plugindev/index.html">For plugin module developers</a></li> <li class="toctree-l1"><a class="reference internal" href="../../build/index.html">Building Kerberos V5</a></li> <li class="toctree-l1"><a class="reference internal" href="../../basic/index.html">Kerberos V5 concepts</a></li> <li class="toctree-l1"><a class="reference internal" href="../../mitK5features.html">MIT Kerberos features</a></li> <li class="toctree-l1"><a class="reference internal" href="../../build_this.html">How to build this documentation from the source</a></li> <li class="toctree-l1"><a class="reference internal" href="../../about.html">The Kerberos Documentation Set</a></li> <li class="toctree-l1"><a class="reference internal" href="../../resources.html">Resources</a></li> </ul> <br/> <h4><a href="../../index.html">Full Table of Contents </a></h4> <h4>Search</h4> <form class="search" action="../../search.html" method="get"> <input type="text" name="q" size="18" /> <input type="submit" value="Go" /> <input type="hidden" name="check_keywords" value="yes" /> <input type="hidden" name="area" value="default" /> </form> </div> <div class="document"> <div class="documentwrapper"> <div class="bodywrapper"> <div class="body"> <div class="section" id="kswitch"> <span id="kswitch-1"></span><h1>kswitch<a class="headerlink" href="#kswitch" title="Permalink to this headline">¶</a></h1> <div class="section" id="synopsis"> <h2>SYNOPSIS<a class="headerlink" href="#synopsis" title="Permalink to this headline">¶</a></h2> <p><strong>kswitch</strong> {<strong>-c</strong> <em>cachename</em>|<strong>-p</strong> <em>principal</em>}</p> </div> <div class="section" id="description"> <h2>DESCRIPTION<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2> <p>kswitch makes the specified credential cache the primary cache for the collection, if a cache collection is available.</p> </div> <div class="section" id="options"> <h2>OPTIONS<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h2> <dl class="docutils"> <dt><strong>-c</strong> <em>cachename</em></dt> <dd>Directly specifies the credential cache to be made primary.</dd> <dt><strong>-p</strong> <em>principal</em></dt> <dd>Causes the cache collection to be searched for a cache containing credentials for <em>principal</em>. If one is found, that collection is made primary.</dd> </dl> </div> <div class="section" id="environment"> <h2>ENVIRONMENT<a class="headerlink" href="#environment" title="Permalink to this headline">¶</a></h2> <p>kswitch uses the following environment variables:</p> <dl class="docutils"> <dt><strong>KRB5CCNAME</strong></dt> <dd>Location of the default Kerberos 5 credentials (ticket) cache, in the form <em>type</em>:<em>residual</em>. If no <em>type</em> prefix is present, the <strong>FILE</strong> type is assumed. The type of the default cache may determine the availability of a cache collection; for instance, a default cache of type <strong>DIR</strong> causes caches within the directory to be present in the collection.</dd> </dl> </div> <div class="section" id="files"> <h2>FILES<a class="headerlink" href="#files" title="Permalink to this headline">¶</a></h2> <dl class="docutils"> <dt><tt class="docutils literal"><span class="pre">FILE:/tmp/krb5cc_%{uid}</span></tt></dt> <dd>Default location of Kerberos 5 credentials cache</dd> </dl> </div> <div class="section" id="see-also"> <h2>SEE ALSO<a class="headerlink" href="#see-also" title="Permalink to this headline">¶</a></h2> <p><a class="reference internal" href="kinit.html#kinit-1"><em>kinit</em></a>, <a class="reference internal" href="kdestroy.html#kdestroy-1"><em>kdestroy</em></a>, <a class="reference internal" href="klist.html#klist-1"><em>klist</em></a>), kerberos(1)</p> </div> </div> </div> </div> </div> </div> <div class="clearer" ></div> </div> </div> <div class="footer-wrapper" > <div class="footer" > <div class="right" ><i>Release: 1.11.4</i><br /> © <a href="../../copyright.html">Copyright</a> 1985-2013, MIT. </div> <div class="left" > <a href="../../index.html" title="Full Table of Contents" >Contents</a> | <a href="ksu.html" title="ksu" >previous</a> | <a href="kvno.html" title="kvno" >next</a> | <a href="../../genindex.html" title="General Index" >index</a> | <a href="../../search.html" title="Enter search criteria" >Search</a> | <a href="mailto:krb5-bugs@mit.edu?subject=Documentation__kswitch">feedback</a> </div> </div> </div> </body> </html>