crypto/external/bsd/heimdal/dist/kdc/kstash.8

   1 .\"     $NetBSD: kstash.8,v 1.3 2014/04/24 13:45:34 pettai Exp $
   2 .\"
   3 .\" Copyright (c) 1997 - 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 10, 2007
  37 .Dt KSTASH 8
  38 .Os
  39 .Sh NAME
  40 .Nm kstash
  41 .Nd "store the KDC master password in a file"
  42 .Sh SYNOPSIS
  43 .Nm
  44 .Bk -words
  45 .Oo Fl e Ar string \*(Ba Xo
  46 .Fl Fl enctype= Ns Ar string
  47 .Xc
  48 .Oc
  49 .Oo Fl k Ar file \*(Ba Xo
  50 .Fl Fl key-file= Ns Ar file
  51 .Xc
  52 .Oc
  53 .Op Fl Fl convert-file
  54 .Op Fl Fl random-key
  55 .Op Fl Fl master-key-fd= Ns Ar fd
  56 .Op Fl Fl random-key
  57 .Op Fl h | Fl Fl help
  58 .Op Fl Fl version
  59 .Ek
  60 .Sh DESCRIPTION
  61 .Nm
  62 reads the Kerberos master key and stores it in a file that will be
  63 used by the KDC.
  64 .Pp
  65 Supported options:
  66 .Bl -tag -width Ds
  67 .It Fl e Ar string , Fl Fl enctype= Ns Ar string
  68 the encryption type to use, defaults to DES3-CBC-SHA1.
  69 .It Fl k Ar file , Fl Fl key-file= Ns Ar file
  70 the name of the master key file.
  71 .It Fl Fl convert-file
  72 don't ask for a new master key, just read an old master key file, and
  73 write it back in the new keyfile format.
  74 .It Fl Fl random-key
  75 generate a random master key.
  76 .It Fl Fl master-key-fd= Ns Ar fd
  77 filedescriptor to read passphrase from, if not specified the
  78 passphrase will be read from the terminal.
  79 .El
  80 .\".Sh ENVIRONMENT
  81 .Sh FILES
  82 .Pa /var/heimdal/m-key
  83 is the default keyfile if no other keyfile is specified.
  84 The format of a Heimdal master key is the same as a keytab, so
  85 .Nm ktutil
  86 list can be used to list the content of the file.
  87 .\".Sh EXAMPLES
  88 .\".Sh DIAGNOSTICS
  89 .Sh SEE ALSO
  90 .Xr kdc 8
  91 .\".Sh STANDARDS
  92 .\".Sh HISTORY
  93 .\".Sh AUTHORS
  94 .\".Sh BUGS