.\" $Id: kdb_init.8,v 1.2 2002/05/19 21:32:51 joda Exp $
.\" Copyright 1989 by the Massachusetts Institute of Technology.
.\"
.\" For copying and distribution information,
.\" please see the file <mit-copyright.h>.
.\"
.Dd April 2, 1997
.Dt KDB_INIT 8
.Os KTH-KRB
.Sh NAME
.Nm kdb_init
.Nd Initialize Kerberos key distribution center database
.Sh SYNOPSIS
.Nm
.Op Ar realm
.Sh DESCRIPTION
.Nm
initializes a Kerberos key distribution center database, creating the
necessary principals.
.Pp
If the optional
.Ar realm
argument is not present,
.Nm
prompts for a realm name.
After determining the realm to be created, it prompts for
a master key password.  The master key password is used to encrypt
every encryption key stored in the database.
.Sh DIAGNOSTICS
.Bl -tag -width Dv
.It /var/kerberos/principal: File exists
An attempt was made to create a database on a machine which already had
an existing database.
.El
.Sh FILES
.Bl -tag -width Dv
.It Pa /var/kerberos/principal.pag Ns No , Pa /var/kerberos/principal.dir
DBM files containing database
.El
.Sh SEE ALSO
.Xr kdb_destroy 8