59 lines
1.8 KiB
Groff
59 lines
1.8 KiB
Groff
.\" $KTH-KRB: kdb_edit.8,v 1.2 2002/05/19 21:37:19 joda Exp $
|
|
.\" $NetBSD: kdb_edit.8,v 1.1.1.2 2002/09/12 12:22:03 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_EDIT 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm kdb_edit
|
|
.Nd Kerberos key distribution center database editing utility
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl n
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is used to create or change principals stored in the Kerberos key
|
|
distribution center (KDC) database.
|
|
.Pp
|
|
When executed,
|
|
.Nm
|
|
prompts for the master key string and verifies that it matches the
|
|
master key stored in the database.
|
|
If the
|
|
.Fl n
|
|
option is specified, the master key is instead fetched from the master
|
|
key cache file.
|
|
.Pp
|
|
Once the master key has been verified,
|
|
.Nm
|
|
begins a prompt loop. The user is prompted for the principal and
|
|
instance to be modified. If the entry is not found the user may create
|
|
it.
|
|
Once an entry is found or created, the user may set the password,
|
|
expiration date, maximum ticket lifetime, and attributes.
|
|
Default expiration dates, maximum ticket lifetimes, and attributes are
|
|
presented in brackets; if the user presses return the default is selected.
|
|
There is no default password.
|
|
The password RANDOM is interpreted specially, and if entered
|
|
the user may have the program select a random DES key for the
|
|
principal.
|
|
.Pp
|
|
Upon successfully creating or changing the entry, ``Edit O.K.'' is
|
|
printed.
|
|
.Sh DIAGNOSTICS
|
|
.Bl -tag -width Dv
|
|
.It verify_master_key: Invalid master key, does not match database.
|
|
The master key string entered was incorrect.
|
|
.El
|
|
.Sh FILES
|
|
.Bl -tag -width Dv
|
|
.It Pa /var/kerberos/principal.pag Ns No , Pa /var/kerberos/principal.dir
|
|
DBM files containing database
|
|
.It Pa /.k
|
|
Master key cache file.
|
|
.El
|