linux-kernel - Re: Revised keyrings(7) man page for review

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <26757.1481635886@warthog.procyon.org.uk>
Date:   Tue, 13 Dec 2016 13:31:26 +0000
From:   David Howells <dhowells@...hat.com>
To:     "Michael Kerrisk \(man-pages\)" <mtk.manpages@...il.com>
Cc:     dhowells@...hat.com, Michael Kerrisk <mtk@...7.org>,
        lkml <linux-kernel@...r.kernel.org>,
        Eugene Syromyatnikov <evgsyr@...il.com>,
        keyrings@...r.kernel.org, linux-man <linux-man@...r.kernel.org>
Subject: Re: Revised keyrings(7) man page for review

Michael Kerrisk (man-pages) <mtk.manpages@...il.com> wrote:

> I use/Linux man-pages uses the "Oxford comma" convention.

"... an optional comma ..." ;-)

There's also:

	... LSM security checks are still performed, and may filter out
        further keys that the process is not authorized to view.

but has two parts and isn't a list... ;-P

> >>                      D   The key is dead (i.e., has been deleted).  (A
> >>                          key  may  be  briefly  in  this  state during
> >>                          garbage collection.)
> > 
> > No - "dead" in this context means that the key type was unregistered.
> 
> Okay, so the text should read as:
> 
>                      D   The key is dead (i.e., the key has been unregis‐
>                          tered).  (A key may be  briefly  in  this  state
>                          during garbage collection.)
> 
> Right?

Not quite.  The driver for the key type has been unregistered, not the key.

David