Clarify, spelling and add examples.

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@15353 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Love Hörnquist Åstrand
2005-06-07 00:43:31 +00:00
parent a3850b13de
commit 50cc59275b

View File

@@ -5,10 +5,10 @@ $Id$
Each line in the dump file is one entry in the database.
Each field of a line is separated by one or more spaces, with the
exception of fields consisting of princial where space can be quoted
with \, \ is quoted by \.
exception of fields consisting of principals containing spaces, where
space can be quoted with \ and \ is quoted by \.
Fields are and the the of the fields are:
Fields and their types are:
Quoted princial (quote character is \) [string]
Keys [keys]
@@ -23,17 +23,27 @@ Fields are and the the of the fields are:
Fields following these silently are ignored.
All optional fields will be skipped if they fail to parse (or is given
All optional fields will be skipped if they fail to parse (or comprise
the optional field marker of "-", w/o quotes).
Example:
XXX
fred@EXAMPLE.COM 27:1:16:e8b4c8fc7e60b9e641dcf4cff3f08a701d982a2f89ba373733d26ca59ba6c789666f6b8bfcf169412bb1e5dceb9b33cda29f3412:-:1:3:4498a933881178c744f4232172dcd774c64e81fa6d05ecdf643a7e390624a0ebf3c7407a:-:1:2:b01934b13eb795d76f3a80717d469639b4da0cfb644161340ef44fdeb375e54d684dbb85:-:1:1:ea8e16d8078bf60c781da90f508d4deccba70595258b9d31888d33987cd31af0c9cced2e:- 20020415130120:admin@EXAMPLE.COM 20041221112428:fred@EXAMPLE.COM - - - 86400 604800 126 20020415130120:793707:28
Encoding of types are as follows:
keys:
kvno:[masterkvno:keytype:keydata:salt]{zero or more separated by :)
kvno:[masterkvno:keytype:keydata:salt]{zero or more separated by :}
kvno is the key version number.
keydata is hex-encoded
masterkvno is the kvno of the database master key. If this
field is empty, the kadmin load and merge operations will
encrypt the key data with the master key if there is one.
Otherwise the key data will be imported asis.
salt is encoded as "-" (no/default salt) or
@@ -41,38 +51,43 @@ keys:
salt-type / "string"
salt-type / hex-encoded-data
keytype is the protocol enctype number.
keytype is the protocol enctype number; see enum ENCTYPE in
include/krb5_asn1.h for values.
Example:
XXX
27:1:16:e8b4c8fc7e60b9e641dcf4cff3f08a701d982a2f89ba373733d26ca59ba6c789666f6b8bfcf169412bb1e5dceb9b33cda29f3412:-:1:3:4498a933881178c744f4232172dcd774c64e81fa6d05ecdf643a7e390624a0ebf3c7407a:-:1:2:b01934b13eb795d76f3a80717d469639b4da0cfb644161340ef44fdeb375e54d684dbb85:-:1:1:ea8e16d8078bf60c781da90f508d4deccba70595258b9d31888d33987cd31af0c9cced2e:-
kvno=27,{key: masterkvno=1,keytype=des3-cbc-sha1,keydata=...,
default salt}...
time:
Format of the time is: YYYYmmddHHMMSS
Format of the time is: YYYYmmddHHMMSS, corresponding to
strftime format "%Y%m%d%k%M%S".
Time if expressed in UTC.
Time is expressed in UTC.
Time can be optional (using -), the time 0 is used.
Time can be optional (using -), when the time 0 is used.
Example:
XXX
20041221112428
event:
time:principal
time is as given in format time
principal is a string, not quoting may not work in ealier
version of Heimdal.
principal is a string. Not quoting it may not work in earlier
versions of Heimdal.
Example:
XXX
20041221112428:bloggs@EXAMPLE.COM
hdb flags:
Integer encoding of HDB flags, see HDBFlags in
lib/hdb/hdb.asn1. Each in the integer is the same as the bit
lib/hdb/hdb.asn1. Each bit in the integer is the same as the bit
in the specification.
Example:
@@ -85,7 +100,7 @@ generation:
usec is a the microsecond, integer.
gen is generation number, integer.
generation can be option (using '-') or the empty string
The generation can be defaulted (using '-') or the empty string
Example:
XXX