mirror of
https://github.com/containers/podman.git
synced 2025-05-29 06:03:25 +08:00

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>
2.2 KiB
2.2 KiB
% 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)