keyctl.2, request_key.2: Consistently use term "negatively instantiated key"

Eliminate uses of the term "negative key" in favor of
"negatively instantiated key".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2017-02-10 10:11:17 +01:00
parent ee61f2666b
commit 4c8ae2269c
2 changed files with 8 additions and 7 deletions

View File

@ -1021,8 +1021,8 @@ automatically garbage collected after the timeout expires.
Subsequent attempts to access the key will then fail with the error
.BR EKEYEXPIRED .
This operation cannot be used to set timeouts on negative, revoked,
or expired keys.
This operation cannot be used to set timeouts on revoked, expired,
or negatively instantiated keys.
The arguments
.IR arg4
@ -1246,10 +1246,10 @@ program.
See
.BR request_key (2).
Negative keys are used to rate limit repeated
Negatively instantiated keys are used to rate limit repeated
.BR request_key (2)
calls by causing them to return the error specified until the negative key
expires.
calls by causing them to return the error specified until
the negatively instantiated key expires.
This operation is exposed by
.I libkeyutils

View File

@ -347,7 +347,8 @@ If these steps are unsuccessful, then an
.BR ENOKEY
error will be returned to the caller of
.BR request_key ()
and a temporary negative key will be installed in the keyring specified by
and a temporary, negatively instantiated key will be installed
in the keyring specified by
.IR dest_keyring .
This will expire after a few seconds, but will cause subsequent calls to
.BR request_key ()
@ -367,7 +368,7 @@ is no longer accessible from the
program.
If a key is created, then\(emregardless of whether it is a valid key or
a negative key\(emit will displace any other key with
a negatively instantiated key\(emit will displace any other key with
the same type and description from the keyring specified in
.IR dest_keyring .
.SH RETURN VALUE