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 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 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 exception of fields consisting of principals containing spaces, where
with \, \ is quoted by \. 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] Quoted princial (quote character is \) [string]
Keys [keys] Keys [keys]
@@ -23,17 +23,27 @@ Fields are and the the of the fields are:
Fields following these silently are ignored. 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). the optional field marker of "-", w/o quotes).
Example: 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: Encoding of types are as follows:
keys: 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 salt is encoded as "-" (no/default salt) or
@@ -41,38 +51,43 @@ keys:
salt-type / "string" salt-type / "string"
salt-type / hex-encoded-data 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: 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: 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: Example:
XXX 20041221112428
event: event:
time:principal time:principal
time is as given in format time time is as given in format time
principal is a string, not quoting may not work in ealier principal is a string. Not quoting it may not work in earlier
version of Heimdal. versions of Heimdal.
Example: Example:
XXX 20041221112428:bloggs@EXAMPLE.COM
hdb flags: hdb flags:
Integer encoding of HDB flags, see HDBFlags in 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. in the specification.
Example: Example:
@@ -85,7 +100,7 @@ generation:
usec is a the microsecond, integer. usec is a the microsecond, integer.
gen is generation number, 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: Example:
XXX XXX