landlock: Clarify documentation for struct landlock_ruleset_attr
authorGünther Noack <gnoack@google.com>
Thu, 11 Jul 2024 16:54:57 +0000 (16:54 +0000)
committerMickaël Salaün <mic@digikod.net>
Tue, 16 Jul 2024 14:34:49 +0000 (16:34 +0200)
commit33c97e7c0338d921c2ae0c2e54bf17121007fb94
tree3a924c7b76b9874f2c619ecb7457c58eb2967650
parent395a02d04ed4d9b9ae2d7cadfd9b14a64fe240b5
landlock: Clarify documentation for struct landlock_ruleset_attr

The explanation for @handled_access_fs and @handled_access_net has
significant overlap and is better explained together.

* Explain the commonalities in structure-level documentation.
* Clarify some wording and break up longer sentences.
* Put emphasis on the word "handled" to make it clearer that "handled"
  is a term with special meaning in the context of Landlock.

I'd like to transfer this wording into the man pages as well.

Signed-off-by: Günther Noack <gnoack@google.com>
Cc: Alejandro Colomar <alx@kernel.org>
Cc: Konstantin Meskhidze <konstantin.meskhidze@huawei.com>
Cc: linux-security-module@vger.kernel.org
Link: https://lore.kernel.org/r/20240711165456.2148590-2-gnoack@google.com
[mic: Format commit message]
Signed-off-by: Mickaël Salaün <mic@digikod.net>
include/uapi/linux/landlock.h