github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/options/userns-uid-map.md (about)

     1  ####> This option file is used in:
     2  ####>   podman build, farm build
     3  ####> If file is edited, make sure the changes
     4  ####> are applicable to all of those.
     5  #### **--userns-uid-map**=*mapping*
     6  
     7  Directly specifies a UID mapping to be used to set ownership, at the
     8  filesystem level, on the working container's contents.
     9  Commands run when handling `RUN` instructions default to being run in
    10  their own user namespaces, configured using the UID and GID maps.
    11  
    12  Entries in this map take the form of one or more triples of a starting
    13  in-container UID, a corresponding starting host-level UID, and the number of consecutive IDs which the map entry represents.
    14  
    15  This option overrides the *remap-uids* setting in the *options* section of /etc/containers/storage.conf.
    16  
    17  If this option is not specified, but a global --userns-uid-map setting is supplied, settings from the global option is used.
    18  
    19  If none of --userns-uid-map-user, --userns-gid-map-group, or --userns-uid-map are specified, but --userns-gid-map is specified, the UID map is set to use the same numeric values as the GID map.