src/man/kswitch.man

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