diff --git a/man2/mount_setattr.2 b/man2/mount_setattr.2 index 875834637..910b541ef 100644 --- a/man2/mount_setattr.2 +++ b/man2/mount_setattr.2 @@ -97,9 +97,9 @@ argument should usually be specified as However, if the caller is using a kernel that supports an extended .IR "struct mount_attr" , but the caller does not intend to make use of these features, -they can pass the size of an earlier +it is possible to pass the size of an earlier version of the structure together with the extended structure. -This allows the kernel to not copy later parts of the struct +This allows the kernel to not copy later parts of the structure that aren't used anyway. With each extension that changes the size of .IR "struct mount_attr" , @@ -431,7 +431,7 @@ isn't a mount point. .TP .B EINVAL An unsupported value was set in -.I flags. +.IR flags . .TP .B EINVAL An unsupported value was specified in the @@ -587,8 +587,8 @@ change ownership in a temporary and localized way. It is a localized change because the ownership changes are visible only via a specific mount. All other users and locations where the filesystem is exposed are unaffected. -And it is a temporary change because -ownership changes are tied to the lifetime of the mount. +It is a temporary change because +the ownership changes are tied to the lifetime of the mount. .PP Whenever callers interact with the filesystem through an ID-mapped mount, the ID mapping of the mount will be applied to @@ -665,16 +665,15 @@ If any user IDs or group IDs are not mapped, all files owned by that unmapped user or group ID will appear as being owned by the overflow user ID or overflow group ID respectively. .PP -Further details and instructions for setting up ID mappings can be found in the -.BR user_namespaces (7) -man page. +Further details on setting up ID mappings can be found in +.BR user_namespaces (7). .PP In the common case, the user namespace passed in .I userns_fd -together with +(together with .B MOUNT_ATTR_IDMAP in -.I attr_set +.IR attr_set ) to create an ID-mapped mount will be the user namespace of a container. In other scenarios it will be a dedicated user namespace associated with a user's login session as is the case for portable home directories in