.\" from: kstash.8,v 4.1 89/01/23 11:11:39 jtkohl Exp $
.\" $Id$
.\" Copyright 1989 by the Massachusetts Institute of Technology.
.\"
.\" For copying and distribution information,
.\" please see the file <Copyright.MIT>.
.\"
.TH KSTASH 8 "Kerberos Version 4.0" "MIT Project Athena"
.SH NAME
kstash \- stash Kerberos key distribution center database master key
.SH SYNOPSIS
kstash
.SH DESCRIPTION
.I kstash
saves the Kerberos key distribution center (KDC) database master key in
the master key cache file.
.PP
The user is prompted to enter the key, to verify the authenticity of the
key and the authorization to store the key in the file.
.SH DIAGNOSTICS
.TP 20n
"verify_master_key: Invalid master key, does not match database."
The master key string entered was incorrect.
.TP
"kstash: Unable to open master key file"
The attempt to open the cache file for writing failed (probably due to a
system or access permission error).
.TP
"kstash: Write I/O error on master key file"
The 
.BR write (2)
system call returned an error while
.I kstash
was attempting to write the key to the file.
.SH FILES
.TP 20n
/etc/kerberosIV/principal.db
DBM file containing database
.TP
/etc/kerberosIV/principal.ok
Semaphore indicating that the DBM database is not being modified.
.TP
/etc/kerberosIV/master_key
Master key cache file.