mirror of
https://github.com/containers/podman.git
synced 2025-06-01 09:06:44 +08:00
6979d140f1
There are many use cases where you want to just mount an image without creating a container on it. For example you might want to just examine the content in an image after you pull it for security analysys. Or you might want to just use the executables on the image without running it in a container. The image is mounted readonly since we do not want people changing images. Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
77 lines
2.2 KiB
Markdown
77 lines
2.2 KiB
Markdown
% podman-image-mount(1)
|
|
|
|
## NAME
|
|
podman\-image\-mount - Mount an image's root filesystem
|
|
|
|
## SYNOPSIS
|
|
**podman image mount** [*options*] [*image* ...]
|
|
|
|
## DESCRIPTION
|
|
Mounts the specified images' root file system in a location which can be
|
|
accessed from the host, and returns its location.
|
|
|
|
If you execute the command without any arguments, Podman will list all of the
|
|
currently mounted images.
|
|
|
|
Rootless mode only supports mounting VFS driver, unless you enter the user namespace
|
|
via the `podman unshare` command. All other storage drivers will fail to mount.
|
|
|
|
## RETURN VALUE
|
|
The location of the mounted file system. On error an empty string and errno is
|
|
returned.
|
|
|
|
## OPTIONS
|
|
|
|
**--all**, **-a**
|
|
|
|
Mount all images.
|
|
|
|
**--format**=*format*
|
|
|
|
Print the mounted images in specified format (json).
|
|
|
|
## EXAMPLE
|
|
|
|
```
|
|
podman image mount fedora ubi8-init
|
|
|
|
/var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
|
|
/var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged
|
|
```
|
|
|
|
```
|
|
podman mount
|
|
|
|
registry.fedoraproject.org/fedora:latest /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
|
|
registry.access.redhat.com/ubi8-init:latest /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged
|
|
```
|
|
|
|
```
|
|
podman image mount --format json
|
|
[
|
|
{
|
|
"id": "00ff39a8bf19f810a7e641f7eb3ddc47635913a19c4996debd91fafb6b379069",
|
|
"Names": [
|
|
"sha256:58de585a231aca14a511347bc85b912a6f000159b49bc2b0582032911e5d3a6c"
|
|
],
|
|
"Repositories": [
|
|
"registry.fedoraproject.org/fedora:latest"
|
|
],
|
|
"mountpoint": "/var/lib/containers/storage/overlay/0ccfac04663bbe8813b5f24502ee0b7371ce5bf3c5adeb12e4258d191c2cf7bc/merged"
|
|
},
|
|
{
|
|
"id": "bcc2dc9a261774ad25a15e07bb515f9b77424266abf2a1252ec7bcfed1dd0ac2",
|
|
"Names": [
|
|
"sha256:d5f260b2e51b3ee9d05de1c31d261efc9af28e7d2d47cedf054c496d71424d63"
|
|
],
|
|
"Repositories": [
|
|
"registry.access.redhat.com/ubi8-init:latest"
|
|
],
|
|
"mountpoint": "/var/lib/containers/storage/overlay/d66b58e3391ea8ce4c81316c72e22b332618f2a28b461a32ed673e8998cdaeb8/merged"
|
|
}
|
|
]
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-image-umount(1), mount(8), podman-unshare(1)
|