diff options
| author | Ed Santiago <santiago@redhat.com> | 2022-09-06 06:39:09 -0600 |
|---|---|---|
| committer | Ed Santiago <santiago@redhat.com> | 2022-09-06 08:20:32 -0600 |
| commit | 40cd1c0ff5d4c1e99e51cf60046c957a1a6ba81e (patch) | |
| tree | 626b8f9fdc93e148327a529418952a1c3765cd33 /docs/source/markdown/podman-run.1.md.in | |
| parent | cd09e3b6d0b0eb32f6ad6062b13194f97873c664 (diff) | |
| download | podman-40cd1c0ff5d4c1e99e51cf60046c957a1a6ba81e.tar.gz podman-40cd1c0ff5d4c1e99e51cf60046c957a1a6ba81e.tar.bz2 podman-40cd1c0ff5d4c1e99e51cf60046c957a1a6ba81e.zip | |
Man pages: refactor common options: --device
The refactors are starting to get harder to review - sorry.
Here the differences are pretty small, mostly changes to the
"it is a combination" wording and some asteriskization.
The more significant diffs are that there are some Notes that
are pod- or container- or build-specific; I needed to move those
from the middle to the end, then keep them in the source files
themselves. I don't think this affects readability of the
resulting man pages, but your opinion may differ.
Last important thing: I included the /dev/fuse text in the
common option, which means it will now show up in podman-build
(it was not previously there). If this text is not applicable
to podman-build, please LMK ASAP so I can just move it back
to individual source files.
Signed-off-by: Ed Santiago <santiago@redhat.com>
Diffstat (limited to 'docs/source/markdown/podman-run.1.md.in')
| -rw-r--r-- | docs/source/markdown/podman-run.1.md.in | 15 |
1 files changed, 1 insertions, 14 deletions
diff --git a/docs/source/markdown/podman-run.1.md.in b/docs/source/markdown/podman-run.1.md.in index 3ad338662..db56459d2 100644 --- a/docs/source/markdown/podman-run.1.md.in +++ b/docs/source/markdown/podman-run.1.md.in @@ -159,25 +159,12 @@ Specify the key sequence for detaching a container. Format is a single character This option can also be set in **containers.conf**(5) file. -#### **--device**=*host-device[:container-device][:permissions]* - -Add a host device to the container. Optional *permissions* parameter -can be used to specify device permissions by combining -**r** for read, **w** for write, and **m** for **mknod**(2). - -Example: **--device=/dev/sdc:/dev/xvdc:rwm**. - -Note: if _host_device_ is a symbolic link then it will be resolved first. -The container will only store the major and minor numbers of the host device. +@@option device Note: if the user only has access rights via a group, accessing the device from inside a rootless container will fail. Use the `--group-add keep-groups` flag to pass the user's supplementary group access into the container. -Podman may load kernel modules required for using the specified -device. The devices that Podman will load modules when necessary are: -/dev/fuse. - @@option device-cgroup-rule @@option device-read-bps |