proc_sysctl: enhance documentation
authorLuis Chamberlain <mcgrof@kernel.org>
Fri, 10 Mar 2023 21:00:16 +0000 (13:00 -0800)
committerGreg Kroah-Hartman <gregkh@linuxfoundation.org>
Wed, 17 May 2023 09:53:45 +0000 (11:53 +0200)
commitfde64a409bee247379f38e6b88b7e09593e4cb93
treedcb4bdeefb173892921f369b784eb6813119175c
parentf4708645c14405879f0e6fbfc2ff80209167fd71
proc_sysctl: enhance documentation

commit 1dc8689e4cc651e21566e10206a84c4006e81fb1 upstream.

Expand documentation to clarify:

  o that paths don't need to exist for the new API callers
  o clarify that we *require* callers to keep the memory of
    the table around during the lifetime of the sysctls
  o annotate routines we are trying to deprecate and later remove

Cc: stable@vger.kernel.org # v5.17
Cc: Christian Brauner <brauner@kernel.org>
Cc: Kefeng Wang <wangkefeng.wang@huawei.com>
Signed-off-by: Luis Chamberlain <mcgrof@kernel.org>
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
fs/proc/proc_sysctl.c