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