On 10/01/2024 00:45, Kent Gibson wrote:
On Tue, Jan 09, 2024 at 10:00:26PM +0200, Andy Shevchenko wrote:
On Tue, Jan 9, 2024 at 4:00 PM Kent Gibson <warthog618@xxxxxxxxx> wrote:
May we actually state in the documentation that sysfs is subject to
remove at some point?
So formally define what "deprecated" means?
Is that covered in the higher level documentation somewhere?
If so I'm more than happy to provide a reference.
We have a few files that may be relevant here, that I'm aware of:
1) https://docs.kernel.org/admin-guide/sysfs-rules.html
documents some general assumptions that userspace can make about the
stability of sysfs and its files
2) https://docs.kernel.org/admin-guide/abi.html
This is the public-facing, somewhat machine-readable repository of what
is supposed to be the kernel's ABI/API, including "obsolete" and
"removed" interfaces.
3) Documentation/ABI/README
describes the process of deprecating an interface
Vegard