crypto/kerberosIV/man/ext_srvtab.8

   1 .\" $Id: ext_srvtab.8,v 1.3 1997/04/02 21:09:51 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 EXT_SRVTAB 8 "Kerberos Version 4.0" "MIT Project Athena"
   8 .SH NAME
   9 ext_srvtab \- extract service key files from Kerberos key distribution center database
  10 .SH SYNOPSIS
  11 ext_srvtab [
  12 .B \-n
  13 ] [
  14 .B \-r realm
  15 ] [
  16 .B hostname ...
  17 ]
  18 .SH DESCRIPTION
  19 .I ext_srvtab
  20 extracts service key files from the Kerberos key distribution center
  21 (KDC) database.
  22 .PP
  23 Upon execution, it prompts the user to enter the master key string for
  24 the database.  If the
  25 .B \-n
  26 option is specified, the master key is instead fetched from the master
  27 key cache file.
  28 .PP
  29 For each
  30 .I hostname
  31 specified on the command line,
  32 .I ext_srvtab
  33 creates the service key file
  34 .IR hostname -new-srvtab,
  35 containing all the entries in the database with an instance field of
  36 .I hostname.
  37 This new file contains all the keys registered for Kerberos-mediated
  38 service providing programs which use the
  39 .IR krb_get_phost (3)
  40 principal and instance conventions to run on the host
  41 .IR hostname .
  42 If the
  43 .B \-r
  44 option is specified, the realm fields in the extracted file will
  45 match the given realm rather than the local realm.
  46 .SH DIAGNOSTICS
  47 .TP 20n
  48 "verify_master_key: Invalid master key, does not match database."
  49 The master key string entered was incorrect.
  50 .SH FILES
  51 .TP 20n
  52 .IR hostname -new-srvtab
  53 Service key file generated for
  54 .I hostname
  55 .TP
  56 /var/kerberos/principal.pag, /var/kerberos/principal.dir
  57 DBM files containing database
  58 .TP
  59 /.k
  60 Master key cache file.
  61 .SH SEE ALSO
  62 read_service_key(3), krb_get_phost(3)