kuser/copy_cred_cache.1

   1 .\" Copyright (c) 2004 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 April 24, 2004
  35 .Dt COPY_CRED_CACHE 1
  36 .Os HEIMDAL
  37 .Sh NAME
  38 .Nm copy_cred_cache
  39 .Nd
  40 copy credentials from one cache to another
  41 .Sh SYNOPSIS
  42 .Nm
  43 .Op Fl -krbtgt-only
  44 .Op Fl -service= Ns Ar principal
  45 .Op Fl -enctype= Ns Ar enctype
  46 .Op Fl -flags= Ns Ar ticketflags
  47 .Op Fl -valid-for= Ns Ar time
  48 .Op Fl -fcache-version= Ns Ar integer
  49 .Op Aq Ar from-cache
  50 .Aq Ar to-cache
  51 .Sh DESCRIPTION
  52 .Nm
  53 copies credentials from
  54 .Aq Ar from-cache
  55 (or the default cache) to
  56 .Aq Ar to-cache .
  57 .Pp
  58 Supported options:
  59 .Bl -tag -width Ds
  60 .It Fl -krbtgt-only
  61 Copies only krbtgt credentials for the client's realm. This is
  62 equivalent to
  63 .Fl -service= Ns Li krbtgt/ Ns Ao Ar CLIENTREALM Ac Ns Li @ Ns Ao Ar CLIENTREALM Ac .
  64 .It Fl -service= Ns Ar principal
  65 Copies only credentials matching this service principal.
  66 .It Fl -enctype= Ns Ar enctype
  67 Copies only credentials a matching enctype.
  68 .It Fl -flags= Ns Ar ticketflags
  69 Copies only credentials with these ticket flags set.
  70 .It Fl -valid-for= Ns Ar time
  71 Copies only credentials that are valid for at least this long. This
  72 does not take renewable creds into account.
  73 .It Fl -fcache-version= Ns Ar integer
  74 The created cache, If a standard
  75 .Li FILE
  76 cache is created, it will have this file format version.
  77 .El
  78 .\".Sh ENVIRONMENT
  79 .\".Sh FILES
  80 .Sh EXAMPLES
  81 To copy only credentials that are valid for at least one day and with
  82 the
  83 .Li initial
  84 flag set, try something like:
  85 .Bd -literal -offset indent
  86 $ copy_cred_cache --valid-for=1d --flags=initial FILE:/some/cache
  87 .Ed
  88 .Sh DIAGNOSTICS
  89 The
  90 .Nm
  91 utility exits 0 on success, and \*[Gt]0 if an error occurs, or of no
  92 credentials where actually copied.
  93 .\".Sh SEE ALSO
  94 .\".Sh STANDARDS
  95 .\".Sh HISTORY
  96 .\".Sh AUTHORS
  97 .\".Sh BUGS