mirror of https://github.com/mkerrisk/man-pages
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:
parent
ee61f2666b
commit
4c8ae2269c
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
Loading…
Reference in New Issue