--- v3
+++ v5
@@ -62,6 +62,76 @@
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]
+- open_tree(2): fix leftover confusing usages of "attach" when referring
+ to file descriptors being associated with mount objects.
+- open_tree(2): rename "Anonymous mount namespaces" NOTES subsection to
+ the far more informative "Mount propagation" and clean up the wording
+ a little.
+- open_tree_attr(2): add a code comment about
+ <https://lore.kernel.org/all/20250808-open_tree_attr-bugfix-idmap-v1-0-0ec7bc05646c@cyphar.com/>
+- {fsconfig,open_tree_attr}(2): use _Nullable.
+- {fsmount,open_tree}(2): mention the the unmount-on-close behaviour is
+ actually lazy (a-la MNT_DETACH).
+- {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.
+- 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): 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]
+- 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]
+- v3: <https://lore.kernel.org/r/20250809-new-mount-api-v3-0-f61405c80f34@cyphar.com>
+
Changes in v3:
- `sed -i s|Co-developed-by|Co-authored-by|g`. [Alejandro Colomar]
- Add Signed-off-by for co-authors. [Christian Brauner]
@@ -122,33 +192,27 @@
- v1: <https://lore.kernel.org/r/20250806-new-mount-api-v1-0-8678f56c6ee0@cyphar.com>
---
-Aleksa Sarai (12):
- man/man2/statx.2: correctly document AT_NO_AUTOMOUNT
- man/man2/mount_setattr.2: fix stray quote in SYNOPSIS
- man/man2/mount_setattr.2: move mount_attr struct to mount_attr(2type)
+Aleksa Sarai (8):
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 | 681 ++++++++++++++++++++++++++++++++++++++++++
- man/man2/fsmount.2 | 220 ++++++++++++++
- man/man2/fsopen.2 | 384 ++++++++++++++++++++++++
- man/man2/fspick.2 | 309 +++++++++++++++++++
- man/man2/mount_setattr.2 | 62 +++-
- man/man2/move_mount.2 | 640 +++++++++++++++++++++++++++++++++++++++
- man/man2/open_tree.2 | 593 ++++++++++++++++++++++++++++++++++++
- man/man2/open_tree_attr.2 | 1 +
- man/man2/statx.2 | 6 +-
- man/man2type/mount_attr.2type | 61 ++++
- 10 files changed, 2940 insertions(+), 17 deletions(-)
+ 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(+)
---
-base-commit: e473affca7b039fd018eedb839d6c80e4fd3df17
+base-commit: f17990c243eafc1891ff692f90b6ce42e6449be8
change-id: 20250802-new-mount-api-436db984f432