This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type. - Adds the podman-quadlet-basic-usage.7.md for quadlet examples. - Majority of the text in the new files is copied from the podman-systemd.unit.5.md - Adds support for very simple condditional in the markdown_preprocess. - Uses new logic in markdown_preprocess in options/*.md to use a single .md file for both podman subcommands man-pages and quadlet man-pages. This deduplicates the Quadlet man-pages a lot. - Adds new `@@option quadlet:source.md`` preprocess command to import such .md files from options directory. Signed-off-by: Jan Kaluza <jkaluza@redhat.com>
981 B
####> This option file is used in: ####> podman podman-container.unit.5.md.in, create, podman-pod.unit.5.md.in, run ####> If file is edited, make sure the changes ####> are applicable to all of those. << if is_quadlet >>
GIDMap=[flags]container_gid:from_gid[:amount]
<< else >>
--gidmap=[flags]container_gid:from_gid[:amount]
<< endif >>
Run the container in a new user namespace using the supplied GID mapping. This option conflicts with the << 'UserNS=' if is_quadlet else '--userns' >> and << 'SubGIDMap=' if is_quadlet else '--subgidname' >> options. This option provides a way to map host GIDs to container GIDs in the same way as --uidmap maps host UIDs to container UIDs. For details see --uidmap.
Note: the << 'GIDMap=' if is_quadlet else '--gidmap' >> option cannot be called in conjunction with the << 'Pod=' if is_quadlet else '--pod' >> option as a gidmap cannot be set on the container level when in a pod.