spiegel_podman/docs/source/markdown/options/image-volume.md
Grzegorz Szczepanczyk da5b172766 docs: fix --image-volume default and accepted values
The docs, the create/run --help text and the shell completion all show
"bind" as the main/default value for --image-volume. That's wrong: the
accepted values are ignore | tmpfs | anonymous
(pkg/specgen/container_validate.go), the default is anonymous
(pkg/specgen/specgen.go), and "bind" is only a deprecated alias the code
maps to anonymous (pkg/specgenutil/specgen.go,
pkg/specgen/generate/kube/kube.go).

Show "anonymous" everywhere (options man page, the Quadlet ImageVolume=
key, --help, completion) and note that "bind" still works as a deprecated
alias. Behavior is unchanged.

Fixes: #27674

Signed-off-by: Grzegorz Szczepanczyk <g.szczepanczyk@getprintbox.com>
2026-06-29 12:35:25 +02:00

18 lines
806 B
Markdown

####> This option file is used in:
####> podman podman-container.unit.5.md.in, create, run
####> If file is edited, make sure the changes
####> are applicable to all of those.
<< if is_quadlet >>
### `ImageVolume=mode`
<< else >>
#### **--image-volume**=**anonymous** | *tmpfs* | *ignore*
<< endif >>
Tells Podman how to handle the builtin image volumes. Default is **anonymous**.
- **anonymous**: An anonymous named volume is created and mounted into the container.
- **tmpfs**: The volume is mounted onto the container as a tmpfs, which allows the users to create
content that disappears when the container is stopped.
- **ignore**: All volumes are just ignored and no action is taken.
In the past, a **bind** option was accepted as well. This is deprecated, and currently aliased to **anonymous**.