Skip to content

Commit ce442ac

Browse files
committed
config: add reference to mount_setattr(2) for idmapped mounts
The idmapped mounts sections do not make any reference to how the mapping should be implemented. Add a reference to MOUNT_ATTR_IDMAP since that is what runtimes are expected to use. Signed-off-by: Aleksa Sarai <[email protected]>
1 parent 2ac0e64 commit ce442ac

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

config.md

+2
Original file line numberDiff line numberDiff line change
@@ -180,10 +180,12 @@ For POSIX platforms the `mounts` structure has the following fields:
180180
* Linux: filesystem types supported by the kernel as listed in */proc/filesystems* (e.g., "minix", "ext2", "ext3", "jfs", "xfs", "reiserfs", "msdos", "proc", "nfs", "iso9660"). For bind mounts (when `options` include either `bind` or `rbind`), the type is a dummy, often "none" (not listed in */proc/filesystems*).
181181
* Solaris: corresponds to "type" of the fs resource in [zonecfg(1M)][zonecfg.1m].
182182
* **`uidMappings`** (array of type LinuxIDMapping, OPTIONAL) The mapping to convert UIDs from the source file system to the destination mount point.
183+
This SHOULD be implemented using [`mount_setattr(MOUNT_ATTR_IDMAP)`][mount_setattr.2], available since Linux 5.12.
183184
If specified, the `options` field of the `mounts` structure SHOULD contain either `idmap` or `ridmap` to specify whether the mapping should be applied recursively for `rbind` mounts, as well as to ensure that older runtimes will not silently ignore this field.
184185
The format is the same as [user namespace mappings](config-linux.md#user-namespace-mappings).
185186
If specified, it MUST be specified along with `gidMappings`.
186187
* **`gidMappings`** (array of type LinuxIDMapping, OPTIONAL) The mapping to convert GIDs from the source file system to the destination mount point.
188+
This SHOULD be implemented using [`mount_setattr(MOUNT_ATTR_IDMAP)`][mount_setattr.2], available since Linux 5.12.
187189
If specified, the `options` field of the `mounts` structure SHOULD contain either `idmap` or `ridmap` to specify whether the mapping should be applied recursively for `rbind` mounts, as well as to ensure that older runtimes will not silently ignore this field.
188190
For more details see `uidMappings`.
189191
If specified, it MUST be specified along with `uidMappings`.

0 commit comments

Comments
 (0)