podman/podman-image-mount.1.md at d92bfd244fd2864f18e765a483fe4016b70f914c

mirror of https://github.com/containers/podman.git synced 2025-05-21 00:56:36 +08:00

Files

Ed Santiago d92bfd244f Man page checker: require canonical name in SEE ALSO

The man-page cross-reference script checks the SEE ALSO section
to confirm that all references are to existing man pages (#12258).
However, it's a little too forgiving: it allows aliases, the
short '.so' files under the 'links/' subdirectory. That means
we could link to non-default command names, and were doing so.

As of this PR, we no longer allow that. Any podman command
referenced in SEE ALSO must be the canonical command name
(and man page). Fix existing non-canonical names, and
remove the exception so we don't allow this again.

See #16848 for discussion of context.

Signed-off-by: Ed Santiago <santiago@redhat.com>

2023-01-03 10:24:55 -07:00

2.4 KiB

Raw Blame History

% 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.

The podman image mount command without any arguments lists all of the currently mounted images.

Rootless mode only supports mounting VFS driver, unless podman is run in a user namespace. Use the podman unshare command to enter the user namespace. 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"
 }
]

2.4 KiB Raw Blame History