From ebf039e2eaa1367512d65064ccbcffdc26894058 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Thu, 3 Nov 2016 20:06:44 +0100 Subject: [PATCH] keyrings.7: Document /proc/key-users Signed-off-by: Michael Kerrisk --- man7/keyrings.7 | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) diff --git a/man7/keyrings.7 b/man7/keyrings.7 index 0e7870740..4e29153b3 100644 --- a/man7/keyrings.7 +++ b/man7/keyrings.7 @@ -435,6 +435,44 @@ for more information. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .\" FIXME document /proc files .TP +.IR /proc/keys " (since Linux 2.6.10)" +.TP +.IR /proc/key-users " (since Linux 2.6.10)" +This file lists various information for each user ID that +has at least one key on the system. +An example of the data that one might see in this file is the following: + +.nf +.in +4n + 0: 10 9/9 2/1000000 22/25000000 + 42: 9 9/9 8/200 106/20000 +1000: 11 11/11 10/200 271/20000 +.in +.fi + +The fields shown in each line are as follows: +.RS +.TP +.I uid +The user ID. +.TP +.I usage +[To be documented] +.\" FIXME What does 'usage' show us? +.TP +.IR nkeys / nikeys +The total number of keys owned by the user, +and the number of those keys that have been instantiated. +.TP +.IR qnkeys / maxkeys +The number of keys owned by the user, +and the maximum keys that the user may own. +.TP +.IR qnbytes / maxbytes +The number of bytes consumed in payloads of the keys owned by this user, +and the upper limit on the number of bytes in key payloads for that user. +.RE +.TP .IR /proc/sys/kernel/keys/gc_delay " (since Linux 2.6.32)" .\" commit 5d135440faf7db8d566de0c6fab36b16cf9cfc3b The value in this file specifies the interval, in seconds,