kcm/kcm.8

   1 .\" Copyright (c) 2005 Kungliga Tekniska Högskolan
   2 .\" (Royal Institute of Technology, Stockholm, Sweden).
   3 .\" All rights reserved.
   4 .\"
   5 .\" Redistribution and use in source and binary forms, with or without
   6 .\" modification, are permitted provided that the following conditions
   7 .\" are met:
   8 .\"
   9 .\" 1. Redistributions of source code must retain the above copyright
  10 .\"    notice, this list of conditions and the following disclaimer.
  11 .\"
  12 .\" 2. Redistributions in binary form must reproduce the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer in the
  14 .\"    documentation and/or other materials provided with the distribution.
  15 .\"
  16 .\" 3. Neither the name of the Institute nor the names of its contributors
  17 .\"    may be used to endorse or promote products derived from this software
  18 .\"    without specific prior written permission.
  19 .\"
  20 .\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND
  21 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  22 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  23 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE
  24 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  25 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  26 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  27 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  28 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  29 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  30 .\" SUCH DAMAGE.
  31 .\"
  32 .\" $Id$
  33 .\"
  34 .Dd May 29, 2005
  35 .Dt KCM 8
  36 .Os Heimdal
  37 .Sh NAME
  38 .Nm kcm
  39 .Nd
  40 is a process based credential cache for Kerberos tickets.
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl -cache-name= Ns Ar cachename
  44 .Oo Fl c Ar file \*(Ba Xo
  45 .Fl -config-file= Ns Ar file
  46 .Xc
  47 .Oc
  48 .Oo Fl g Ar group \*(Ba Xo
  49 .Fl -group= Ns Ar group
  50 .Xc
  51 .Oc
  52 .Op Fl -max-request= Ns Ar size
  53 .Op Fl -disallow-getting-krbtgt
  54 .Op Fl -detach
  55 .Op Fl h | Fl -help
  56 .Oo Fl k Ar principal \*(Ba Xo
  57 .Fl -system-principal= Ns Ar principal
  58 .Xc
  59 .Oc
  60 .Oo Fl l Ar time \*(Ba Xo
  61 .Fl -lifetime= Ns Ar time
  62 .Xc
  63 .Oc
  64 .Oo Fl m Ar mode \*(Ba Xo
  65 .Fl -mode= Ns Ar mode
  66 .Xc
  67 .Oc
  68 .Op Fl n | Fl -no-name-constraints
  69 .Oo Fl r Ar time \*(Ba Xo
  70 .Fl -renewable-life= Ns Ar time
  71 .Xc
  72 .Oc
  73 .Oo Fl s Ar path \*(Ba Xo
  74 .Fl -socket-path= Ns Ar path
  75 .Xc
  76 .Oc
  77 .Oo Xo
  78 .Fl -door-path= Ns Ar path
  79 .Xc
  80 .Oc
  81 .Oo Fl S Ar principal \*(Ba Xo
  82 .Fl -server= Ns Ar principal
  83 .Xc
  84 .Oc
  85 .Oo Fl t Ar keytab \*(Ba Xo
  86 .Fl -keytab= Ns Ar keytab
  87 .Xc
  88 .Oc
  89 .Oo Fl u Ar user \*(Ba Xo
  90 .Fl -user= Ns Ar user
  91 .Xc
  92 .Oc
  93 .Op Fl v | Fl -version
  94 .Sh DESCRIPTION
  95 .Nm
  96 is a process based credential cache.
  97 To use it, set the
  98 .Ev KRB5CCNAME
  99 enviroment variable to
 100 .Ql KCM: Ns Ar uid
 101 or add the stanza
 102 .Bd -literal
 103
 104 [libdefaults]
 105         default_cc_name = KCM:%{uid}
 106
 107 .Ed
 108 to the
 109 .Pa /etc/krb5.conf
 110 configuration file and make sure
 111 .Nm kcm
 112 is started in the system startup files.
 113 .Pp
 114 The
 115 .Nm
 116 daemon can hold the credentials for all users in the system.  Access
 117 control is done with Unix-like permissions.  The daemon checks the
 118 access on all operations based on the uid and gid of the user.  The
 119 tickets are renewed as long as is permitted by the KDC's policy.
 120 .Pp
 121 The
 122 .Nm
 123 daemon can also keep a SYSTEM credential that server processes can
 124 use to access services.  One example of usage might be an nss_ldap
 125 module that quickly needs to get credentials and doesn't want to renew
 126 the ticket itself.
 127 .Pp
 128 Supported options:
 129 .Bl -tag -width Ds
 130 .It Fl -cache-name= Ns Ar cachename
 131 system cache name
 132 .It Fl c Ar file , Fl -config-file= Ns Ar file
 133 location of config file
 134 .It Fl g Ar group , Fl -group= Ns Ar group
 135 system cache group
 136 .It Fl -max-request= Ns Ar size
 137 max size for a kcm-request
 138 .It Fl -disallow-getting-krbtgt
 139 disallow extracting any krbtgt from the
 140 .Nm kcm
 141 daemon.
 142 .It Fl -detach
 143 detach from console
 144 .It Fl h , Fl -help
 145 .It Fl k Ar principal , Fl -system-principal= Ns Ar principal
 146 system principal name
 147 .It Fl l Ar time , Fl -lifetime= Ns Ar time
 148 lifetime of system tickets
 149 .It Fl m Ar mode , Fl -mode= Ns Ar mode
 150 octal mode of system cache
 151 .It Fl n , Fl -no-name-constraints
 152 disable credentials cache name constraints
 153 .It Fl r Ar time , Fl -renewable-life= Ns Ar time
 154 renewable lifetime of system tickets
 155 .It Fl s Ar path , Fl -socket-path= Ns Ar path
 156 path to kcm domain socket
 157 .It Fl -door-path= Ns Ar path
 158 path to kcm door socket
 159 .It Fl S Ar principal , Fl -server= Ns Ar principal
 160 server to get system ticket for
 161 .It Fl t Ar keytab , Fl -keytab= Ns Ar keytab
 162 system keytab name
 163 .It Fl u Ar user , Fl -user= Ns Ar user
 164 system cache owner
 165 .It Fl v , Fl -version
 166 .El
 167 .\".Sh ENVIRONMENT
 168 .\".Sh FILES
 169 .\".Sh EXAMPLES
 170 .\".Sh DIAGNOSTICS
 171 .\".Sh SEE ALSO
 172 .\".Sh STANDARDS
 173 .\".Sh HISTORY
 174 .\".Sh AUTHORS
 175 .\".Sh BUGS