. ds us _
. ds se
.\}
-.TH key 1 "5 June 1999" Catacomb
+.TH key 1 "5 June 1999" "Straylight/Edgeware" "Catacomb cryptographic library"
.SH NAME
key \- simple key management system
.SH SYNOPSIS
is one of:
.PP
.B add
-.RB [ \-lqLS ]
+.RB [ \-lqrLS ]
.RB [ \-a
.IR alg ]
.RB [ \-b | \-B
.IR bits ]
.RB [ \-p
.IR param ]
-.RB [ \-r
+.RB [ \-R
.IR tag ]
.br
\h'8n'
.I "global options"
may be given. The following global options are supported:
.TP
-.B "\-h, \-\-help"
+.BR "\-h, \-\-help " [ \fIcommand ]
Writes a brief summary of
.BR key 's
various options to standard output, and
-returns a successful exit status.
+returns a successful exit status. With a command name, gives help on
+that command.
.TP
.B "\-v, \-\-version"
Writes the program's version number to standard output, and returns a
Selects a tag string for the key. The default is not to set a tag. It
is an error to select a tag which already exists.
.TP
-.BI "\-r, \-\-rand-id " tag
+.BI "\-r, \-\-retag"
+If a
+.B \-t
+option is given, remove this tag from any key which already has it.
+.TP
+.BI "\-R, \-\-rand-id " tag
Selects the key to use for the random number generator. Catacomb's
random number generator can be
.IR keyed ,
Sets, deletes or changes the tag attached to a key. The first tag or
keyid names the key to be modified; the second, if present specifies the
new tag to be set. If no second argument is given, the existing tag, if
-any, is removed and no new tag is set.
+any, is removed and no new tag is set. It is an error to set a tag
+which already exists on another key, unless you give the
+.B \-r
+option, which removes the tag first.
.SS "setattr"
Attaches attributes to a key. The key to which the attributes should be
attached is given by its