1.\" $NetBSD: copy_cred_cache.1,v 1.3 2014/04/24 13:45:34 pettai Exp $ 2.\" 3.\" Copyright (c) 2004 Kungliga Tekniska Högskolan 4.\" (Royal Institute of Technology, Stockholm, Sweden). 5.\" All rights reserved. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions 9.\" are met: 10.\" 11.\" 1. Redistributions of source code must retain the above copyright 12.\" notice, this list of conditions and the following disclaimer. 13.\" 14.\" 2. Redistributions in binary form must reproduce the above copyright 15.\" notice, this list of conditions and the following disclaimer in the 16.\" documentation and/or other materials provided with the distribution. 17.\" 18.\" 3. Neither the name of the Institute nor the names of its contributors 19.\" may be used to endorse or promote products derived from this software 20.\" without specific prior written permission. 21.\" 22.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE. 33.\" 34.\" Id 35.\" 36.Dd April 24, 2004 37.Dt COPY_CRED_CACHE 1 38.Os 39.Sh NAME 40.Nm copy_cred_cache 41.Nd copy credentials from one cache to another 42.Sh SYNOPSIS 43.Nm 44.Op Fl Fl krbtgt-only 45.Op Fl Fl service= Ns Ar principal 46.Op Fl Fl enctype= Ns Ar enctype 47.Op Fl Fl flags= Ns Ar ticketflags 48.Op Fl Fl valid-for= Ns Ar time 49.Op Fl Fl fcache-version= Ns Ar integer 50.Op Aq Ar from-cache 51.Aq Ar to-cache 52.Sh DESCRIPTION 53.Nm 54copies credentials from 55.Aq Ar from-cache 56(or the default cache) to 57.Aq Ar to-cache . 58.Pp 59Supported options: 60.Bl -tag -width Ds 61.It Fl Fl krbtgt-only 62Copies only krbtgt credentials for the client's realm. This is 63equivalent to 64.Fl Fl service= Ns Li krbtgt/ Ns Ao Ar CLIENTREALM Ac Ns Li @ Ns Ao Ar CLIENTREALM Ac . 65.It Fl Fl service= Ns Ar principal 66Copies only credentials matching this service principal. 67.It Fl Fl enctype= Ns Ar enctype 68Copies only credentials a matching enctype. 69.It Fl Fl flags= Ns Ar ticketflags 70Copies only credentials with these ticket flags set. 71.It Fl Fl valid-for= Ns Ar time 72Copies only credentials that are valid for at least this long. This 73does not take renewable creds into account. 74.It Fl Fl fcache-version= Ns Ar integer 75The created cache, If a standard 76.Li FILE 77cache is created, it will have this file format version. 78.El 79.\".Sh ENVIRONMENT 80.\".Sh FILES 81.Sh EXAMPLES 82To copy only credentials that are valid for at least one day and with 83the 84.Li initial 85flag set, try something like: 86.Bd -literal -offset indent 87$ copy_cred_cache --valid-for=1d --flags=initial FILE:/some/cache 88.Ed 89.Sh DIAGNOSTICS 90The 91.Nm 92utility exits 0 on success, and \*[Gt]0 if an error occurs, or if no 93credentials where actually copied. 94.\".Sh SEE ALSO 95.\".Sh STANDARDS 96.\".Sh HISTORY 97.\".Sh AUTHORS 98.\".Sh BUGS 99