randomize_kstack: Improve docs on requirements/rationale
authorKees Cook <keescook@chromium.org>
Tue, 10 May 2022 17:29:36 +0000 (10:29 -0700)
committerKees Cook <keescook@chromium.org>
Tue, 10 May 2022 17:40:26 +0000 (10:40 -0700)
commit1ff297584fad2eef390f212b860e0fbb7363e0e8
treec3c7aa0bdbb4ee93e782f293fd316575d8138a46
parent8c6a490e404fe82b53bbafe0f0eeef10605617f7
randomize_kstack: Improve docs on requirements/rationale

There were some recent questions about where and why to use the
random_kstack routines when applying them to new architectures[1].
Update the header comments to reflect the design choices for the
routines.

[1] https://lore.kernel.org/lkml/1652173338.7bltwybi0c.astroid@bobo.none

Cc: Nicholas Piggin <npiggin@gmail.com>
Cc: Xiu Jianfeng <xiujianfeng@huawei.com>
Signed-off-by: Kees Cook <keescook@chromium.org>
include/linux/randomize_kstack.h