github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-image-unmount.1.md (about)

     1  % podman-image-unmount(1)
     2  
     3  ## NAME
     4  podman\-image\-unmount - Unmount an image's root filesystem
     5  
     6  ## SYNOPSIS
     7  **podman image unmount** [*options*] *image* [...]
     8  
     9  **podman image umount** [*options*] *image* [...]
    10  
    11  ## DESCRIPTION
    12  Unmounts the specified images' root file system, if no other processes
    13  are using it.
    14  
    15  Image storage increments a mount counter each time an image is mounted.
    16  When a image is unmounted, the mount counter is decremented, and the
    17  image's root filesystem is physically unmounted only when the mount
    18  counter reaches zero indicating no other processes are using the mount.
    19  An unmount can be forced with the --force flag.
    20  
    21  ## OPTIONS
    22  #### **--all**, **-a**
    23  
    24  All of the currently mounted images will be unmounted.
    25  
    26  #### **--force**, **-f**
    27  
    28  Force the unmounting of specified images' root file system, even if other
    29  processes have mounted it.
    30  
    31  Note: This could cause other processes that are using the file system to fail,
    32  as the mount point could be removed without their knowledge.
    33  
    34  ## EXAMPLE
    35  
    36  Unmount image with a given ID
    37  ```
    38  podman image unmount imageID
    39  ```
    40  
    41  Unmount multiple images with given IDs
    42  ```
    43  podman image unmount imageID1 imageID2 imageID3
    44  ```
    45  
    46  Unmount all images
    47  ```
    48  podman image unmount --all
    49  ```
    50  ## SEE ALSO
    51  **[podman(1)](podman.1.md)**, **[podman-image-mount(1)](podman-image-mount.1.md)**, **[podman-container-mount(1)](podman-container-mount.1.md)**