mirror of
https://github.com/containers/podman.git
synced 2025-09-28 01:04:28 +08:00
c12b1b32bc
This commit does the following: - Splits the podman-systemd.unit.5.md into multiple files - one for each quadlet file type, podman-quadlet.7.md for general quadlet information and podman-quadlet-basic-usage.7.md for quadlet examples. - Removes the original podman-systemd.unit.5.md file. - Adds support for jinja2 templating language in the markdown_preprocess. - Uses jinja2 in options/*.md to use the 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>
16 lines
1.0 KiB
Markdown
16 lines
1.0 KiB
Markdown
####> This option file is used in:
|
|
####> podman podman-container.unit.5.md.in, create, exec, run
|
|
####> If file is edited, make sure the changes
|
|
####> are applicable to all of those.
|
|
{% if is_quadlet %}
|
|
### `User=user[:group]`
|
|
{% else %}
|
|
#### **--user**, **-u**=*user[:group]*
|
|
{% endif %}
|
|
|
|
Sets the username or UID used and, optionally, the groupname or GID for the specified command. Both *user* and *group* may be symbolic or numeric.
|
|
|
|
Without this argument, the command runs as the user specified in the container image. Unless overridden by a `USER` command in the Containerfile or by a value passed to this option, this user generally defaults to root.
|
|
|
|
When a user namespace is not in use, the UID and GID used within the container and on the host match. When user namespaces are in use, however, the UID and GID in the container may correspond to another UID and GID on the host. In rootless containers, for example, a user namespace is always used, and root in the container by default corresponds to the UID and GID of the user invoking Podman.
|