github.com/opencontainers/umoci@v0.4.8-0.20240508124516-656e4836fb0d/doc/man/umoci-remove.1.md (about)

     1  % umoci-remove(1) # umoci tag - Remove tags from OCI images
     2  % Aleksa Sarai
     3  % DECEMBER 2016
     4  # NAME
     5  umoci remove - Removes tags from OCI images
     6  
     7  # SYNOPSIS
     8  **umoci remove**
     9  **--image**=*image*[:*tag*]
    10  
    11  **umoci rm**
    12  **--image**=*image*[:*tag*]
    13  
    14  # DESCRIPTION
    15  Removes the given tag from the OCI image. The relevant blobs are **not**
    16  removed -- in order to remove all unused blobs see **umoci-gc**(1).
    17  
    18  # OPTIONS
    19  
    20  **--image**=*image*[:*tag*]
    21    The source OCI image tag to remove. *image* must be a path to a valid OCI
    22    image and *tag* must be a valid tag name (**umoci-remove**(1) does not return
    23    an error if the tag did not exist). If *tag* is not provided it defaults to
    24    "latest".
    25  
    26  # EXAMPLE
    27  The following creates a copy of a tag and then deletes the original.
    28  
    29  ```
    30  % umoci tag --image image:tag new-tag
    31  % umoci rm --image image:tag
    32  ```
    33  
    34  # SEE ALSO
    35  **umoci**(1), **umoci-tag**(1), **umoci-gc**(1)