github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/options/userns-gid-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-gid-map**=*mapping*
     6  
     7  Directly specifies a GID 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 defaults 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 GID, a corresponding starting host-level GID, and the number of consecutive IDs which the map entry represents.
    14  
    15  This option overrides the *remap-gids* setting in the *options* section of /etc/containers/storage.conf.
    16  
    17  If this option is not specified, but a global --userns-gid-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-gid-map are specified, but --userns-uid-map is specified, the GID map is set to use the same numeric values as the UID map.