From 18c2a2be879f1fbde1ef66412155c6654ee53c1e Mon Sep 17 00:00:00 2001 From: Sergio Oller Date: Tue, 30 May 2023 11:08:49 +0200 Subject: [PATCH] [DOC] Clarify default behaviour on uidmap Specify that by default if only one of uidmap or gidmap is given, the other one is copied Co-authored-by: Tom Sweeney Signed-off-by: Sergio Oller --- docs/source/markdown/options/uidmap.container.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/source/markdown/options/uidmap.container.md b/docs/source/markdown/options/uidmap.container.md index 940ca6e26f..a65043170e 100644 --- a/docs/source/markdown/options/uidmap.container.md +++ b/docs/source/markdown/options/uidmap.container.md @@ -76,6 +76,11 @@ Every additional range is added sequentially afterward: | 1 | $FIRST_RANGE_ID | $FIRST_RANGE_LENGTH | | 1+$FIRST_RANGE_LENGTH | $SECOND_RANGE_ID | $SECOND_RANGE_LENGTH| +By default, providing either **--uidmap** or **--gidmap** replaces the +whole mapping. If only one of those two options is given, the other one is +copied by default. If only one value of the two needs to be changed, +both values should be provided. + Even if a user does not have any subordinate UIDs in _/etc/subuid_, **--uidmap** can be used to map the normal UID of the user to a container UID by running `podman <> --uidmap $container_uid:0:1 --user $container_uid ...`.