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

     1  % umoci-gc(1) # umoci gc - Garbage collects all unreferenced OCI image blobs
     2  % Aleksa Sarai
     3  % DECEMBER 2016
     4  # NAME
     5  umoci gc - Garbage collects all unreferenced OCI image blobs
     6  
     7  # SYNOPSIS
     8  **umoci gc**
     9  **--layout**=*image*
    10  
    11  # DESCRIPTION
    12  Conduct a mark-and-sweep garbage collection of the provided OCI image, only
    13  retaining blobs which can be reached by a descriptor path from the root set of
    14  tags. All other blobs will be removed.
    15  
    16  # OPTIONS
    17  The global options are defined in **umoci**(1).
    18  
    19  **--layout**=*image*
    20    The OCI image layout to be garbage collected. *image* must be a path to a
    21    valid OCI image.
    22  
    23  # EXAMPLE
    24  
    25  The following deletes a tag from an OCI image and clean conducts a garbage
    26  collection in order to clean up the remaining unused blobs.
    27  
    28  ```
    29  % umoci rm --image image:sometag
    30  % umoci gc --layout image
    31  ```
    32  
    33  # SEE ALSO
    34  **umoci**(1), **umoci-remove**(1)