github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-image-diff.1.md (about)

     1  % podman-image-diff 1
     2  
     3  ## NAME
     4  podman-image-diff - Inspect changes on an image's filesystem
     5  
     6  ## SYNOPSIS
     7  **podman image diff** [*options*] *image* [*image*]
     8  
     9  ## DESCRIPTION
    10  Displays changes on an image's filesystem.  The image is compared to its parent layer or the second argument when given.
    11  
    12  The output is prefixed with the following symbols:
    13  
    14  | Symbol | Description |
    15  |--------|-------------|
    16  | A | A file or directory was added.   |
    17  | D | A file or directory was deleted. |
    18  | C | A file or directory was changed. |
    19  
    20  ## OPTIONS
    21  
    22  #### **--format**
    23  
    24  Alter the output into a different format.  The only valid format for **podman image diff** is `json`.
    25  
    26  ## EXAMPLE
    27  
    28  Display image differences from images parent layer:
    29  ```
    30  $ podman image diff redis:old
    31  C /usr
    32  C /usr/local
    33  C /usr/local/bin
    34  A /usr/local/bin/docker-entrypoint.sh
    35  ```
    36  
    37  Display image differences between two different images in JSON format:
    38  ```
    39  $ podman image diff --format json redis:old redis:alpine
    40  {
    41    "changed": [
    42      "/usr",
    43      "/usr/local",
    44      "/usr/local/bin"
    45    ],
    46    "added": [
    47      "/usr/local/bin/docker-entrypoint.sh"
    48    ]
    49  }
    50  ```
    51  
    52  ## SEE ALSO
    53  **[podman(1)](podman.1.md)**, **[podman-image(1)](podman-image.1.md)**
    54  
    55  ## HISTORY
    56  August 2017, Originally compiled by Ryan Cole <rycole@redhat.com>