projects / unix-history / blame
| Commit | Line | Data |
|---|---|---|
| fdf53e02 GW |
1 | .\" $Source: /usr/src/kerberosIV/man/RCS/kdb_edit.8,v $ |
| 2 | .\" $Author: kfall $ | |
| 3 | .\" $Header: /usr/src/kerberosIV/man/RCS/kdb_edit.8,v 4.2 90/06/25 21:12:03 kfall Exp $ | |
| 4 | .\" Copyright 1989 by the Massachusetts Institute of Technology. | |
| 5 | .\" | |
| 6 | .\" For copying and distribution information, | |
| 7 | .\" please see the file <mit-copyright.h>. | |
| 8 | .\" | |
| 9 | .TH KDB_EDIT 8 "Kerberos Version 4.0" "MIT Project Athena" | |
| 10 | .SH NAME | |
| 11 | kdb_edit \- Kerberos key distribution center database editing utility | |
| 12 | .SH SYNOPSIS | |
| 13 | kdb_edit [ | |
| 14 | .B \-n | |
| 15 | ] | |
| 16 | .SH DESCRIPTION | |
| 17 | .I kdb_edit | |
| 18 | is used to create or change principals stored in the Kerberos key | |
| 19 | distribution center (KDC) database. | |
| 20 | .PP | |
| 21 | When executed, | |
| 22 | .I kdb_edit | |
| 23 | prompts for the master key string and verifies that it matches the | |
| 24 | master key stored in the database. | |
| 25 | If the | |
| 26 | .B \-n | |
| 27 | option is specified, the master key is instead fetched from the master | |
| 28 | key cache file. | |
| 29 | .PP | |
| 30 | Once the master key has been verified, | |
| 31 | .I kdb_edit | |
| 32 | begins a prompt loop. The user is prompted for the principal and | |
| 33 | instance to be modified. If the entry is not found the user may create | |
| 34 | it. | |
| 35 | Once an entry is found or created, the user may set the password, | |
| 36 | expiration date, maximum ticket lifetime, and attributes. | |
| 37 | Default expiration dates, maximum ticket lifetimes, and attributes are | |
| 38 | presented in brackets; if the user presses return the default is selected. | |
| 39 | There is no default password. | |
| 40 | The password RANDOM is interpreted specially, and if entered | |
| 41 | the user may have the program select a random DES key for the | |
| 42 | principal. | |
| 43 | .PP | |
| 44 | Upon successfully creating or changing the entry, ``Edit O.K.'' is | |
| 45 | printed. | |
| 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 | /etc/kerberosIV/principal.pag, /etc/kerberosIV/principal.dir | |
| 53 | DBM files containing database | |
| 54 | .TP | |
| 55 | /etc/kerberosIV/master_key | |
| 56 | Master key cache file. |