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

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


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


.SH DESCRIPTION
.PP
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
.PP
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
.PP
The following deletes a tag from an OCI image and clean conducts a garbage
collection in order to clean up the remaining unused blobs.

.PP
.RS

.nf
% umoci rm --image image:sometag
% umoci gc --layout image

.fi
.RE


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