.nh

.SH containers\-storage\-import\-layer 1 "April 2019"
.SH NAME
.PP
containers\-storage import\-layer \- Import files to a new layer

.SH SYNOPSIS
.PP
\fBcontainers\-storage\fP \fBimport\-layer\fP [\fIoptions\fP [...]] [\fIparentLayerNameOrID\fP]

.SH DESCRIPTION
.PP
This subcommand is a combination of \fIcontainers\-storage create\-layer\fP and
\fIcontainers\-storage apply\-diff\fP\&.

.PP
When a layer is first created with \fIcontainers\-storage create\-layer\fP, it
contains no changes relative to its parent layer.
The layer can either be mounted read\-write and its contents modified
directly, or contents can be added (or removed) by applying a layer diff
by running \fIcontainers\-storage apply\-diff\fP\&.

.SH OPTIONS
.PP
\fB\-n\fP \fIname\fP

.PP
Sets an optional name for the layer. If a name is already in use, an error is
returned.

.PP
\fB\-i | \-\-id\fP \fIID\fP

.PP
Sets the ID for the layer. If none is specified, one is generated.

.PP
\fB\-f | \-\-file\fP \fIfilename\fP

.PP
Specifies the name of a file from which the diff should be read. If this
option is not used, the diff is read from standard input.

.PP
\fB\-l | \-\-label\fP \fImount\-label\fP

.PP
Sets the label which should be assigned as an SELinux context when mounting the
layer.

.PP
\fB\-r | \-\-readonly\fP

.PP
Mark the layer as readonly.

.PP
\fB\-j | \-\-json\fP

.PP
Prefer JSON output.

.PP
\fB\-\-uidmap\fP

.PP
UID map specified in the format expected by \fIsubuid\fP\&. It cannot be specified simultaneously with \fI\-\-hostuidmap\fP\&.

.PP
\fB\-\-gidmap\fP

.PP
GID map specified in the format expected by \fIsubgid\fP\&. It cannot be specified simultaneously with \fI\-\-hostuidmap\fP\&.

.PP
\fB\-\-hostuidmap\fP

.PP
Force host UID map. It cannot be specified simultaneously with neither \fI\-\-uidmap\fP nor \fI\-\-subuidmap\fP\&.

.PP
\fB\-\-hostgidmap\fP

.PP
Force host GID map. It cannot be specified simultaneously with neither \fI\-\-gidmap\fP nor \fI\-\-subgidmap\fP\&.

.PP
\fB\-\-subuidmap\fP \fIusername\fP

.PP
Create UID map for username using the data from /etc/subuid. It cannot be specified simultaneously with \fI\-\-hostuidmap\fP\&.

.PP
\fB\-\-subgidmap\fP \fIgroup\-name\fP

.PP
Create GID map for group\-name using the data from /etc/subgid. It cannot be specified simultaneously with \fI\-\-hostuidmap\fP\&.

.SH EXAMPLE
.PP
\fBcontainers\-storage import\-layer \-f 71841c97e320d6cde.tar.gz \-n new\-layer somelayer\fP

.SH SEE ALSO
.PP
containers\-storage\-create\-layer(1)
containers\-storage\-apply\-diff(1)