[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <CAGXu5jKA-J0WcpMGbxVBC9nC5JK7oCRopQs7rYftv5f=BzQriQ@mail.gmail.com>
Date: Mon, 6 Feb 2017 12:08:32 -0800
From: Kees Cook <keescook@...omium.org>
To: Mark Rutland <mark.rutland@....com>
Cc: David Windsor <dwindsor@...il.com>, Greg KH <gregkh@...uxfoundation.org>,
"kernel-hardening@...ts.openwall.com" <kernel-hardening@...ts.openwall.com>,
"Reshetova, Elena" <elena.reshetova@...el.com>, Hans Liljestrand <ishkamiel@...il.com>,
Peter Zijlstra <peterz@...radead.org>
Subject: Re: Re: HARDENED_ATOMIC documentation
On Mon, Feb 6, 2017 at 8:09 AM, Mark Rutland <mark.rutland@....com> wrote:
> On Mon, Feb 06, 2017 at 11:02:56AM -0500, David Windsor wrote:
>> > Why not put the documentation right into the kernel tree? That way it
>> > is always up to date with the code (well, hopefully), it will get built
>> > and hosted all over the internet at different sites (including
>> > kernel.org) and is much easier to search and people can modify easier.
>> >
>>
>> Fair enough, I'll re-submit as a patch against something in
>> Documentation/. It doesn't appear that there's currently a good
>> landing spot for this, as Documentation/security/self-protection.txt
>> already looks fairly crowded. Individual KSPP sub-project details
>> would impossibly complicate this file. Maybe a kspp/ or
>> self-protection/ sub-directory with files for individual KSPP
>> features?
>
> It would be better to mirror our documentation of atomics; i.e. place
> this in Documentation/core-api/refcount_ops.rst.
Yeah, this is likely the best place. (And since it's not strictly
"hardened atomic" any more: it's just "safe refcounting".)
> Developers don't care if this is part of KSPP, they care about the API.
Right. I think changes could be made to
Documentation/security/self-protection.txt to point to the
refcount_ops.rst file, though, since security folks would like
pointers from that doc to the refcount API.
-Kees
--
Kees Cook
Pixel Security
Powered by blists - more mailing lists
Confused about mailing lists and their use?
Read about mailing lists on Wikipedia
and check out these
guidelines on proper formatting of your messages.
