.nh
.TH OCI-IMAGE-TOOL-UNPACK(1) OCI Image Tool User Manuals
OCI Community
JULY 2016

.SH NAME
.PP
oci-image-tool unpack - Unpack an image or image source layout


.SH SYNOPSIS
.PP
\fBoci-image-tool unpack\fP [src] [dest] [OPTIONS]


.SH DESCRIPTION
.PP
\fB\fCoci-image-tool unpack\fR validates an application/vnd.oci.image.manifest.v1+json and unpacks its layered filesystem to \fB\fCdest\fR\&.


.SH OPTIONS
.PP
\fB--help\fP
  Print usage statement

.PP
\fB--ref\fP=[]
  Specify the search criteria for the validated reference, format is A=B.
  Reference should point to a manifest or index.
  e.g. --ref name=v1.0 --ref platform.os=latest
  Only support \fB\fCname\fR, \fB\fCplatform.os\fR and \fB\fCdigest\fR three cases.

.PP
\fB--type\fP=""
  Type of the file to unpack. If unset, oci-image-tool will try to auto-detect the type. One of "imageLayout,image,imageZip"

.PP
\fB--platform\fP=""
  Specify the os and architecture of the manifest, format is OS:Architecture.
  e.g. --platform linux:amd64
  Only applicable if reftype is index.


.SH EXAMPLES
.PP
.RS

.nf
$ skopeo copy docker://busybox oci:busybox-oci:latest
$ mkdir busybox-bundle
$ oci-image-tool unpack --ref name=latest busybox-oci busybox-bundle
$ tree busybox-bundle
busybox-bundle
├── bin
│   ├── [
│   ├── [[
│   ├── acpid
│   ├── addgroup
│   ├── add-shell
│   ├── adduser
│   ├── adjtimex
│   ├── ar
│   ├── arp
│   ├── arping
│   ├── ash
[...]

.fi
.RE


.SH SEE ALSO
.PP
\fBskopeo\fP(1)


.SH HISTORY
.PP
Sept 2016, Originally compiled by Antonio Murdaca (runcom at redhat dot com)