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

     1  ####> This option file is used in:
     2  ####>   podman build, farm build
     3  ####> If file is edited, make sure the changes
     4  ####> are applicable to all of those.
     5  #### **--label**=*label*
     6  
     7  Add an image *label* (e.g. label=*value*) to the image metadata. Can be used
     8  multiple times.
     9  
    10  Users can set a special LABEL **io.containers.capabilities=CAP1,CAP2,CAP3** in
    11  a Containerfile that specifies the list of Linux capabilities required for the
    12  container to run properly. This label specified in a container image tells
    13  Podman to run the container with just these capabilities. Podman launches the
    14  container with just the specified capabilities, as long as this list of
    15  capabilities is a subset of the default list.
    16  
    17  If the specified capabilities are not in the default set, Podman prints an error
    18  message and runs the container with the default capabilities.