diff options
Diffstat (limited to 'crypto/heimdal/kdc/kstash.8')
-rw-r--r-- | crypto/heimdal/kdc/kstash.8 | 58 |
1 files changed, 51 insertions, 7 deletions
diff --git a/crypto/heimdal/kdc/kstash.8 b/crypto/heimdal/kdc/kstash.8 index 3bd46c63..f30eac6 100644 --- a/crypto/heimdal/kdc/kstash.8 +++ b/crypto/heimdal/kdc/kstash.8 @@ -1,6 +1,37 @@ -.\" $Id: kstash.8,v 1.7 2002/08/20 16:37:14 joda Exp $ +.\" Copyright (c) 1997 - 2004 Kungliga Tekniska Högskolan +.\" (Royal Institute of Technology, Stockholm, Sweden). +.\" All rights reserved. .\" -.Dd September 1, 2000 +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" 3. Neither the name of the Institute nor the names of its contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE INSTITUTE AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE INSTITUTE OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" $Id: kstash.8 20316 2007-04-11 11:53:20Z lha $ +.\" +.Dd April 10, 2007 .Dt KSTASH 8 .Os HEIMDAL .Sh NAME @@ -8,6 +39,7 @@ .Nd "store the KDC master password in a file" .Sh SYNOPSIS .Nm +.Bk -words .Oo Fl e Ar string \*(Ba Xo .Fl -enctype= Ns Ar string .Xc @@ -17,9 +49,12 @@ .Xc .Oc .Op Fl -convert-file +.Op Fl -random-key .Op Fl -master-key-fd= Ns Ar fd +.Op Fl -random-key .Op Fl h | Fl -help .Op Fl -version +.Ek .Sh DESCRIPTION .Nm reads the Kerberos master key and stores it in a file that will be @@ -31,25 +66,34 @@ Supported options: .Fl e Ar string , .Fl -enctype= Ns Ar string .Xc -the encryption type to use, defaults to DES3-CBC-SHA1 +the encryption type to use, defaults to DES3-CBC-SHA1. .It Xo .Fl k Ar file , .Fl -key-file= Ns Ar file .Xc -the name of the master key file +the name of the master key file. .It Xo .Fl -convert-file .Xc don't ask for a new master key, just read an old master key file, and -write it back in the new keyfile format +write it back in the new keyfile format. +.It Xo +.Fl -random-key +.Xc +generate a random master key. .It Xo .Fl -master-key-fd= Ns Ar fd .Xc filedescriptor to read passphrase from, if not specified the -passphrase will be read from the terminal +passphrase will be read from the terminal. .El .\".Sh ENVIRONMENT -.\".Sh FILES +.Sh FILES +.Pa /var/heimdal/m-key +is the default keyfile if no other keyfile is specified. +The format of a Heimdal master key is the same as a keytab, so +.Nm ktutil +list can be used to list the content of the file. .\".Sh EXAMPLES .\".Sh DIAGNOSTICS .Sh SEE ALSO |