diff options
| author | Ed Santiago <santiago@redhat.com> | 2022-09-14 10:52:47 -0600 |
|---|---|---|
| committer | Ed Santiago <santiago@redhat.com> | 2022-09-14 12:32:30 -0600 |
| commit | f76390d5e60bb580b87d61df839b7bb4913bf476 (patch) | |
| tree | d71e39d7d33fbf493b366e269a9e257008c25c13 /docs/source/markdown/options | |
| parent | 5d1144062a534b9ec504ee2866cc90ecea16358d (diff) | |
| download | podman-f76390d5e60bb580b87d61df839b7bb4913bf476.tar.gz podman-f76390d5e60bb580b87d61df839b7bb4913bf476.tar.bz2 podman-f76390d5e60bb580b87d61df839b7bb4913bf476.zip | |
Man pages: refactor common options: --user
In podman-create, exec, and run. Went with the podman-run version.
Signed-off-by: Ed Santiago <santiago@redhat.com>
Diffstat (limited to 'docs/source/markdown/options')
| -rw-r--r-- | docs/source/markdown/options/user.md | 7 |
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/source/markdown/options/user.md b/docs/source/markdown/options/user.md new file mode 100644 index 000000000..6cf12d347 --- /dev/null +++ b/docs/source/markdown/options/user.md @@ -0,0 +1,7 @@ +#### **--user**, **-u**=*user[:group]* + +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 will run 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 will 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 will by default correspond to the UID and GID of the user invoking Podman. |