From 4c8ae2269c98e752d9f7312424e705dc50200d77 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 10 Feb 2017 10:11:17 +0100 Subject: [PATCH] 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 --- man2/keyctl.2 | 10 +++++----- man2/request_key.2 | 5 +++-- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/man2/keyctl.2 b/man2/keyctl.2 index 721797b5d..a4ec2a0df 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -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 diff --git a/man2/request_key.2 b/man2/request_key.2 index ad87424f2..c40ec5b73 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -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