81 lines
2.5 KiB
Groff
81 lines
2.5 KiB
Groff
.nh
|
|
.TH podman-image-mount 1
|
|
.SH NAME
|
|
podman-image-mount \- Mount an image's root filesystem
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman image mount\fP [\fIoptions\fP] [\fIimage\fP ...]
|
|
|
|
.SH DESCRIPTION
|
|
Mounts the specified images' root file system in a location which can be
|
|
accessed from the host, and returns its location.
|
|
|
|
.PP
|
|
The \fBpodman image mount\fR command without any arguments lists all of the
|
|
currently mounted images.
|
|
|
|
.PP
|
|
Rootless mode only supports mounting VFS driver, unless podman is run in a user namespace.
|
|
Use the \fBpodman unshare\fR command to enter the user namespace. All other storage drivers fail to mount.
|
|
|
|
.SH RETURN VALUE
|
|
The location of the mounted file system. On error an empty string and errno is
|
|
returned.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--all\fP, \fB-a\fP
|
|
Mount all images.
|
|
|
|
.SS \fB--format\fP=\fIformat\fP
|
|
Print the mounted images in specified format (json).
|
|
|
|
.SH EXAMPLES
|
|
Mount multiple images. Note: In rootless mode, image mounting works only after executing the podman unshare command to enter the user namespace.
|
|
|
|
.EX
|
|
podman image mount fedora ubi8-init
|
|
/var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
|
|
/var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged
|
|
.EE
|
|
|
|
.PP
|
|
List mounted images:
|
|
|
|
.EX
|
|
podman image 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
|
|
.EE
|
|
|
|
.PP
|
|
List mounted images in JSON format:
|
|
|
|
.EX
|
|
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"
|
|
}
|
|
]
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBpodman-image(1)\fP, \fBpodman-image-unmount(1)\fP, \fBpodman-unshare(1)\fP, \fBmount(8)\fP
|