crypto/kerberosIV/man/kdb_util.8

   1 .\" $Id: kdb_util.8,v 1.3 1997/04/02 20:45:38 assar Exp $
   2 .\" Copyright 1989 by the Massachusetts Institute of Technology.
   3 .\"
   4 .\" For copying and distribution information,
   5 .\" please see the file <mit-copyright.h>.
   6 .\"
   7 .TH KDB_UTIL 8 "Kerberos Version 4.0" "MIT Project Athena"
   8 .SH NAME
   9 kdb_util \-  Kerberos key distribution center database utility
  10 .SH SYNOPSIS
  11 kdb_util
  12 .B operation filename
  13 .SH DESCRIPTION
  14 .I kdb_util
  15 allows the Kerberos key distribution center (KDC) database administrator to
  16 perform utility functions on the database.
  17 .PP
  18 .I Operation
  19 must be one of the following:
  20 .TP 10n
  21 .I load
  22 initializes the KDC database with the records described by the
  23 text contained in the file
  24 .IR filename .
  25 Any existing database is overwritten.
  26 .TP
  27 .I dump
  28 dumps the KDC database into a text representation in the file
  29 .IR filename .
  30 .TP
  31 .I slave_dump
  32 performs a database dump like the
  33 .I dump
  34 operation, and additionally creates a semaphore file signalling the
  35 propagation software that an update is available for distribution to
  36 slave KDC databases.
  37 .TP
  38 .I merge
  39 merges in the entries from
  40 .IR filename
  41 into the database.
  42 .TP
  43 .I new_master_key
  44 prompts for the old and new master key strings, and then dumps the KDC
  45 database into a text representation in the file
  46 .IR filename .
  47 The keys in the text representation are encrypted in the new master key.
  48 .TP
  49 .I convert_old_db
  50 prompts for the master key string, and then dumps the KDC database into
  51 a text representation in the file
  52 .IR filename .
  53 The existing database is assumed to be encrypted using the old format
  54 (encrypted by the key schedule of the master key); the dumped database
  55 is encrypted using the new format (encrypted directly with master key).
  56 .PP
  57 .SH DIAGNOSTICS
  58 .TP 20n
  59 "verify_master_key: Invalid master key, does not match database."
  60 The master key string entered was incorrect.
  61 .SH FILES
  62 .TP 20n
  63 /kerberos/principal.pag, /kerberos/principal.dir
  64 DBM files containing database
  65 .TP
  66 .IR filename .ok
  67 semaphore file created by
  68 .IR slave_dump.