Re: [PATCH 5/9] kernel/api: add API specification for sys_open

From
Jonathan Corbet <corbet@lwn.net>
Date
2026-03-18 14:16:55
Also in
linux-doc, linux-fsdevel, linux-kbuild, linux-kselftest, lkml, tools, workflows
Reply to
Sasha Levin, 2026-03-18
Sasha Levin [off-list ref] writes:
On Tue, Mar 17, 2026 at 12:37:13PM -0600, Jonathan Corbet wrote:
quoted
Sasha Levin [off-list ref] writes:
quoted
On Fri, Mar 13, 2026 at 04:33:57PM +0100, Greg Kroah-Hartman wrote:
quoted
On Fri, Mar 13, 2026 at 11:09:15AM -0400, Sasha Levin wrote:
quoted
quoted
quoted
+ * since-version: 1.0
I think since older versions :)
Right. I guess that in my mind 1.0 was the first official "release". I'll
update it to 0.01.
That kind of raises the question of just what since-version means.  The
version-0.01 (or 1.0) version of open() surely didn't do everything
described in this specification.  So it's saying that some version of
the system call has existed since then?
You know, I'm not entierly sure what the definition should be here.

I stole this from man pages where they indicate at which version the API was
introduced in. I'm not sure if it really adds any value.

Any objections to just dropping it?
Not here.  My general objective with the docs is to describe the kernel
as it is now, without that sort of history unless there's something
specific it can tell current users.

Thanks,

jon
Thread (38 messages) 38 messages, 8 authors, last reply 2026-04-08
Keyboard shortcuts
hback out one level
jnext message in thread / next series-diff position
kprevious message in thread / previous series-diff position
ldrill in
Escclose help / fold thread tree
?toggle this help