Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
podman-image-mount(1)	    General Commands Manual	 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 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
       Mount multiple images. Note: In rootless	 mode,	image  mounting	 works
       only after executing the	podman unshare command to enter	the user name-
       space.

       podman image mount fedora ubi8-init
       /var/lib/containers/storage/overlay/f3ac502d97b5681989dff84dfedc8354239bcecbdc2692f9a639f4e080a02364/merged
       /var/lib/containers/storage/overlay/0ff7d7ca68bed1ace424f9df154d2dd7b5a125c19d887f17653cbcd5b6e30ba1/merged

       List mounted images:

       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

       List mounted images in JSON format:

       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(1), podman-image-unmount(1), podman-unshare(1),
       mount(8)

							 podman-image-mount(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-image-mount&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help