--- v5
+++ v4
@@ -62,37 +62,6 @@
Signed-off-by: Christian Brauner <brauner@kernel.org>
Signed-off-by: Aleksa Sarai <cyphar@cyphar.com>
---
-Changes in v5:
-- `sed -i s|file descriptor based|file-descriptor-based|`.
- [Alejandro Colomar]
-- fsconfig(2): use bullets instead of ordered list for workflow
- description. [Alejandro Colomar]
-- mount_setattr(2): fix minor wording nit in new attribute-parameter
- subsection.
-- fsopen(2): remove brackets around "message" for message retrieval
- interface description. [Alejandro Colomar]
-- {move_mount,fspick}(2): fix remaining incorrect no-automount text.
- [Askar Safin]
-- {fsmount,open_tree}(2): `sed -i s|MOUNT_DETACH|MNT_DETACH|g`.
- [Askar Safin]
-- mount_setattr(2): fix copy-paste snafu in attribute-parameter
- subsection. [Askar Safin]
-- *: clean `make -R build-catman-troff`. [Alejandro Colomar]
-- *: switch to \[em]\c where appropriate.
-- open_tree(2): clean up MNT_DETACH-on-close description and make it
- slightly more prominent. [Alejandro Colomar]
-- open_tree(2): mention the distinction from open(O_PATH) with regards
- to automounts. Askar suggested it be put in the section about
- ~OPEN_TREE_CLONE, but the change in behaviour also applies to
- OPEN_TREE_CLONE and it looked awkward to include it in the
- dentry_open() case because O_PATH only gets mentioned in the following
- paragraph (where I've put the text now). [Askar Safin]
-- {move_mount,open_tree{,_attr}}(2): fix column-width-related "make -R
- check" failures.
-- *: fix remaining "make -R lint" failures.
-- open_tree_attr(2): add example using MOUNT_ATTR_IDMAP.
-- v4: <https://lore.kernel.org/r/20250919-new-mount-api-v4-0-1261201ab562@cyphar.com>
-
Changes in v4:
- `sed -i s|\\% |\\%|g`.
- Remove unneeded quotes in SYNOPSIS. [Alejandro Colomar]
@@ -109,27 +78,27 @@
- {fsconfig,mount_setattr}(2): improve "mount attributes and filesystem
parameters" wording to make it clearer that superblock and mount flags
are sibling properties, not the same thing.
-- open_tree(2): mention that any mount propagation events while the
- mount object is detached are completely lost -- i.e., they don't get
- replayed once you attach the mount somewhere.
+- open_tree(2): mention that any mount propagation events while the mount
+ object is detached are completely lost -- i.e., they don't get replayed once
+ you attach the mount somewhere.
- fsconfig(2): fix minor grammatical / missing joining word issues.
- fsconfig(2): fix final leftover `.IR A " and " B` cases.
-- fsconfig(2): explain that failed fsconfig(FSCONFIG_CMD_*) operations
- render the filesystem context invalid.
-- fsconfig(2): rework the description of superblock reuse, as the
- previous text was very wrong. (Though there has been discussion about
- changing this behaviour...)
-- fsconfig(2): remove misleading wording in FSCONFIG_CMD_CREATE_EXCL
- about how we are requesting a new filesystem instance -- in theory
- filesystems could take this request into account but in practice none
- do (and it seems unlikely any ever will).
+- fsconfig(2): explain that failed fsconfig(FSCONFIG_CMD_*) operations render
+ the filesystem context invalid.
+- fsconfig(2): rework the description of superblock reuse, as the previous text
+ was very wrong. (Though there has been discussion about changing this
+ behaviour...)
+- fsconfig(2): remove misleading wording in FSCONFIG_CMD_CREATE_EXCL about how
+ we are requesting a new filesystem instance -- in theory filesystems could
+ take this request into account but in practice none do (and it seems unlikely
+ any ever will).
- fsconfig(2): mention that key, value, and aux must be 0 or NULL for
FSCONFIG_CMD_RECONF.
-- fsmount(2): fix usage of "filesystem instance" in relation to
- fsmount() and open_tree() comparison. [Askar Safin]
+- fsmount(2): fix usage of "filesystem instance" in relation to fsmount() and
+ open_tree() comparison. [Askar Safin]
- move_mount(2): "as attached" -> "as a detached" [Askar Safin]
-- fspick(2): add note about filesystem parameter list being copied
- rather than reset with FSCONFIG_CMD_RECONFIGURE. [Askar Safin]
+- fspick(2): add note about filesystem parameter list being copied rather than
+ reset with FSCONFIG_CMD_RECONFIGURE. [Askar Safin]
- v3: <https://lore.kernel.org/r/20250809-new-mount-api-v3-0-f61405c80f34@cyphar.com>
Changes in v3:
@@ -192,27 +161,30 @@
- v1: <https://lore.kernel.org/r/20250806-new-mount-api-v1-0-8678f56c6ee0@cyphar.com>
---
-Aleksa Sarai (8):
+Aleksa Sarai (10):
+ man/man2/mount_setattr.2: move mount_attr struct to mount_attr(2type)
man/man2/fsopen.2: document "new" mount API
man/man2/fspick.2: document "new" mount API
man/man2/fsconfig.2: document "new" mount API
man/man2/fsmount.2: document "new" mount API
man/man2/move_mount.2: document "new" mount API
man/man2/open_tree.2: document "new" mount API
+ man/man2/mount_setattr.2: mirror opening sentence from fsopen(2)
man/man2/open_tree{,_attr}.2: document new open_tree_attr() API
man/man2/{fsconfig,mount_setattr}.2: add note about attribute-parameter distinction
- man/man2/fsconfig.2 | 741 ++++++++++++++++++++++++++++++++++++++++++++++
- man/man2/fsmount.2 | 231 +++++++++++++++
- man/man2/fsopen.2 | 385 ++++++++++++++++++++++++
- man/man2/fspick.2 | 343 +++++++++++++++++++++
- man/man2/mount_setattr.2 | 39 +++
- man/man2/move_mount.2 | 646 ++++++++++++++++++++++++++++++++++++++++
- man/man2/open_tree.2 | 709 ++++++++++++++++++++++++++++++++++++++++++++
- man/man2/open_tree_attr.2 | 1 +
- 8 files changed, 3095 insertions(+)
+ man/man2/fsconfig.2 | 739 ++++++++++++++++++++++++++++++++++++++++++
+ man/man2/fsmount.2 | 231 +++++++++++++
+ man/man2/fsopen.2 | 384 ++++++++++++++++++++++
+ man/man2/fspick.2 | 342 +++++++++++++++++++
+ man/man2/mount_setattr.2 | 63 +++-
+ man/man2/move_mount.2 | 646 ++++++++++++++++++++++++++++++++++++
+ man/man2/open_tree.2 | 638 ++++++++++++++++++++++++++++++++++++
+ man/man2/open_tree_attr.2 | 1 +
+ man/man2type/mount_attr.2type | 61 ++++
+ 9 files changed, 3092 insertions(+), 13 deletions(-)
---
-base-commit: f17990c243eafc1891ff692f90b6ce42e6449be8
+base-commit: e86f9fd0c279f593242969a2fbb5ef379272d89d
change-id: 20250802-new-mount-api-436db984f432