document get -o and stash

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@14003 ec53bebd-3082-4978-b11e-865c3cabbd6b

kadmin/kadmin.8

@@ -31,7 +31,7 @@
 .\"
 .\" $Id$
 .\"
-.Dd March 24, 2004
+.Dd June 27, 2004
 .Dt KADMIN 8
 .Os HEIMDAL
 .Sh NAME
@@ -128,8 +128,8 @@ If no
 .Ar command
 is given on the command line,
 .Nm
-will prompt for commands to process. Some of the commands which take a
+will prompt for commands to process. Some of the commands that take
-principal as argument
+one or more principals as argument
 .Ns ( Nm delete ,
 .Nm ext_keytab ,
 .Nm get ,
@@ -137,7 +137,9 @@ principal as argument
 and
 .Nm passwd )
 will accept a glob style wildcard, and perform the operation on all
-matching principals.  Commands include:
+matching principals.
+.Pp
+Commands include:
 .\" not using a list here, since groff apparently gets confused
 .\" with nested Xo/Xc
 .Bd -ragged -offset indent
@@ -191,11 +193,42 @@ Creates a keytab with the keys of the specified principals.
 .Op Fl l | Fl -long
 .Op Fl s | Fl -short
 .Op Fl t | Fl -terse
+.Op Fl o Ar string | Fl -column-info= Ns Ar string
 .Ar principal...
 .Pp
 .Bd -ragged -offset indent
-Lists the matching principals, long format gives more information, and
+Lists the matching principals, short prints the result as a table,
-terse just prints the names.
+while long format produces a more verbose output. Which columns to
+print can be selected with the
+.Fl o
+option. The argument is a comma separated list of column names
+optionally appended with an equal sign
+.Pq Sq =
+and a column header. Which columns are printed by default differ
+slightly between short and long output.
+.Pp
+The default terse output format is similar to
+.Fl s o Ar principal= ,
+just printing the names of matched principals.
+.Pp
+Possible column names include:
+.Li principal ,
+.Li princ_expire_time ,
+.Li pw_expiration ,
+.Li last_pwd_change ,
+.Li max_life ,
+.Li max_rlife ,
+.Li mod_time ,
+.Li mod_name ,
+.Li attributes ,
+.Li kvno ,
+.Li mkvno ,
+.Li last_success ,
+.Li last_failed ,
+.Li fail_auth_count ,
+.Li policy ,
+and
+.Li keytypes .
 .Ed
 .Pp
 .Nm modify
@@ -309,6 +342,22 @@ Similar to
 but just modifies the database with the entries in the dump file.
 .Ed
 .Pp
+.Nm stash
+.Oo Fl e Ar enctype \*(Ba Xo
+.Fl -enctype= Ns Ar enctype
+.Xc
+.Oc
+.Oo Fl k Ar keyfile \*(Ba Xo
+.Fl -key-file= Ns Ar keyfile
+.Xc
+.Oc
+.Op Fl -convert-file
+.Op Fl -master-key-fd= Ns Ar fd
+.Pp
+.Bd -ragged -offset indent
+Writes the Kerberos master key to a file used by the KDC.
+.Ed
+.Pp
 .Ed
 .\".Sh ENVIRONMENT
 .\".Sh FILES