Re: [PATCH v4 00/10] man2: document "new" mount API
From: Askar Safin
Date: Sat Sep 20 2025 - 22:43:16 EST
Aleksa, thank you! Don't give up. We all need these manpages.
I see you didn't address some my previous notes.
* move_mount(2) still says "Mount objects cannot be attached beneath the filesystem root".
I suggest saying "root directory" or "root" or "root directory of the process" or just "/"
instead. But you may keep this phrase as is, of course.
* Docs for FSPICK_NO_AUTOMOUNT in fspick(2) are still wrong. They say that FSPICK_NO_AUTOMOUNT
affects all components of path. Similar thing applies to mount_setattr(2) and move_mount(2)
* open_tree(2) still says:
> If flags does not contain OPEN_TREE_CLONE, open_tree() returns a file descriptor
> that is exactly equivalent to one produced by openat(2) when called with the same dirfd and path.
This is not true if automounts are involved. I suggest adding "modulo automounts". But you may
keep everything, of course.
--
Askar Safin