mirror of
https://github.com/containers/podman.git
synced 2025-11-03 07:47:19 +08:00
c9c2f644da
In each options/foo.md, keep a list of where the option is used. This will be valuable to anyone making future edits, and to those reviewing those edits. This may be a controversial commit, because those crossref lists are autogenerated as a side effect of the script that reads them. It definitely violates POLA. And one day, some kind person will reconcile (e.g.) --label, using it in more man pages, and maybe forget to git-commit the rewritten file, and CI will fail. I think this is a tough tradeoff, but worth doing. Without this, it's much too easy for someone to change an option file in a way that renders it inapplicable/misleading for some podman commands. Signed-off-by: Ed Santiago <santiago@redhat.com>
37 lines
1.7 KiB
Markdown
37 lines
1.7 KiB
Markdown
####> This option file is used in:
|
|
####> podman create, pod clone, pod create, run
|
|
####> If you edit this file, make sure your changes
|
|
####> are applicable to all of those.
|
|
#### **--volumes-from**=*CONTAINER[:OPTIONS]*
|
|
|
|
Mount volumes from the specified container(s). Used to share volumes between
|
|
containers<<| and pods>>. The *options* is a comma-separated list with the following available elements:
|
|
|
|
* **rw**|**ro**
|
|
* **z**
|
|
|
|
Mounts already mounted volumes from a source container onto another
|
|
<<container|pod>>. _CONTAINER_ may be a name or ID.
|
|
To share a volume, use the --volumes-from option when running
|
|
the target container. Volumes can be shared even if the source container
|
|
is not running.
|
|
|
|
By default, Podman mounts the volumes in the same mode (read-write or
|
|
read-only) as it is mounted in the source container.
|
|
This can be changed by adding a `ro` or `rw` _option_.
|
|
|
|
Labeling systems like SELinux require that proper labels are placed on volume
|
|
content mounted into a <<container|pod>>. Without a label, the security system might
|
|
prevent the processes running inside the container from using the content. By
|
|
default, Podman does not change the labels set by the OS.
|
|
|
|
To change a label in the <<container|pod>> context, add `z` to the volume mount.
|
|
This suffix tells Podman to relabel file objects on the shared volumes. The `z`
|
|
option tells Podman that two entities share the volume content. As a result,
|
|
Podman labels the content with a shared content label. Shared volume labels allow
|
|
all containers to read/write content.
|
|
|
|
If the location of the volume from the source container overlaps with
|
|
data residing on a target <<container|pod>>, then the volume hides
|
|
that data on the target.
|