.nh
.TH umoci-gc(1) # umoci gc - Garbage collects all unreferenced OCI image blobs
Aleksa Sarai
DECEMBER 2016

.SH NAME
umoci gc \- Garbage collects all unreferenced OCI image blobs


.SH SYNOPSIS
\fBumoci gc\fP
\fB--layout\fP=\fIimage\fP


.SH DESCRIPTION
Conduct a mark-and-sweep garbage collection of the provided OCI image, only
retaining blobs which can be reached by a descriptor path from the root set of
tags. All other blobs will be removed.


.SH OPTIONS
The global options are defined in \fBumoci\fP(1).

.PP
\fB--layout\fP=\fIimage\fP
  The OCI image layout to be garbage collected. \fIimage\fP must be a path to a
  valid OCI image.


.SH EXAMPLE
The following deletes a tag from an OCI image and clean conducts a garbage
collection in order to clean up the remaining unused blobs.

.EX
% umoci rm --image image:sometag
% umoci gc --layout image
.EE


.SH SEE ALSO
\fBumoci\fP(1), \fBumoci-remove\fP(1)