.TH "umoci-gc" "1" " # umoci gc - Garbage collects all unreferenced OCI image blobs" "Aleksa Sarai" "DECEMBER 2016" 
.nh
.ad l


.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)