Switch to github.com/golang/dep for vendoring

Signed-off-by: Mrunal Patel <mrunalp@gmail.com>
This commit is contained in:
Mrunal Patel 2017-01-31 16:45:59 -08:00
parent d6ab91be27
commit 8e5b17cf13
15431 changed files with 3971413 additions and 8881 deletions

6
vendor/github.com/containers/storage/docs/Makefile generated vendored Normal file
View file

@ -0,0 +1,6 @@
GOMD2MAN = go-md2man
docs: $(patsubst %.md,%.1,$(wildcard *.md))
%.1: %.md
$(GOMD2MAN) -in $^ -out $@

View file

@ -0,0 +1,25 @@
## oci-storage-add-names "August 2016"
## NAME
oci-storage add-names - Add names to a layer/image/container
## SYNOPSIS
**oci-storage** **add-names** [*options* [...]] *layerOrImageOrContainerNameOrID*
## DESCRIPTION
In addition to IDs, *layers*, *images*, and *containers* can have
human-readable names assigned to them in *oci-storage*. The *add-names*
command can be used to add one or more names to them.
## OPTIONS
**-n | --name** *name*
Specifies a name to add to the layer, image, or container. If a specified name
is already used by another layer, image, or container, it is removed from that
other layer, image, or container.
## EXAMPLE
**oci-storage add-names -n my-awesome-container -n my-for-realsies-awesome-container f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
## SEE ALSO
oci-storage-set-names(1)

View file

@ -0,0 +1,32 @@
## oci-storage-apply-diff 1 "August 2016"
## NAME
oci-storage apply-diff - Apply a layer diff to a layer
## SYNOPSIS
**oci-storage** **apply-diff** [*options* [...]] *layerNameOrID* [*referenceLayerNameOrID*]
## DESCRIPTION
When a layer is first created, 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. A
layer diff takes the form of a (possibly compressed) tar archive with
additional information present in its headers, and can be produced by running
*oci-storage diff* or an equivalent.
Layer diffs are not typically applied manually. More often they are applied by
a tool which is being used to import an entire image, such as **skopeo**.
## OPTIONS
**-f | --file** *filename*
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.
## EXAMPLE
**oci-storage apply-diff -f 71841c97e320d6cde.tar.gz layer1**
## SEE ALSO
oci-storage-changes(1)
oci-storage-diff(1)
oci-storage-diffsize(1)

View file

@ -0,0 +1,21 @@
## oci-storage-changes 1 "August 2016"
## NAME
oci-storage changes - Produce a list of changes in a layer
## SYNOPSIS
**oci-storage** **changes** *layerNameOrID* [*referenceLayerNameOrID*]
## DESCRIPTION
When a layer is first created, it contains no changes relative to its parent
layer. After that is changed, the *oci-storage changes* command can be used to
obtain a summary of which files have been added, deleted, or modified in the
layer.
## EXAMPLE
**oci-storage changes f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
## SEE ALSO
oci-storage-applydiff(1)
oci-storage-diff(1)
oci-storage-diffsize(1)

View file

@ -0,0 +1,18 @@
## oci-storage-container 1 "August 2016"
## NAME
oci-storage container - Examine a single container
## SYNOPSIS
**oci-storage** **container** *containerNameOrID*
## DESCRIPTION
Retrieve information about a container: any names it has, which image was used
to create it, any names that image has, and the ID of the container's layer.
## EXAMPLE
**oci-storage container f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
**oci-storage container my-awesome-container**
## SEE ALSO
oci-storage-containers(1)

View file

@ -0,0 +1,16 @@
## oci-storage-containers 1 "August 2016"
## NAME
oci-storage containers - List known containers
## SYNOPSIS
**oci-storage** **containers**
## DESCRIPTION
Retrieves information about all known containers and lists their IDs and names.
## EXAMPLE
**oci-storage containers**
## SEE ALSO
oci-storage-container(1)

View file

@ -0,0 +1,37 @@
## oci-storage-create-container 1 "August 2016"
## NAME
oci-storage create-container - Create a container
## SYNOPSIS
**oci-storage** **create-container** [*options*...] *imageNameOrID*
## DESCRIPTION
Creates a container, using the specified image as the starting point for its
root filesystem.
## OPTIONS
**-n | --name** *name*
Sets an optional name for the container. If a name is already in use, an error
is returned.
**-i | --id** *ID*
Sets the ID for the container. If none is specified, one is generated.
**-m | --metadata** *metadata-value*
Sets the metadata for the container to the specified value.
**-f | --metadata-file** *metadata-file*
Sets the metadata for the container to the contents of the specified file.
## EXAMPLE
**oci-storage create-container -f manifest.json -n new-container goodimage**
## SEE ALSO
oci-storage-create-image(1)
oci-storage-create-layer(1)
oci-storage-delete-container(1)

View file

@ -0,0 +1,37 @@
## oci-storage-create-image 1 "August 2016"
## NAME
oci-storage create-image - Create an image
## SYNOPSIS
**oci-storage** **create-image** [*options*...] *topLayerNameOrID*
## DESCRIPTION
Creates an image, referring to the specified layer as the one which should be
used as the basis for containers which will be based on the image.
## OPTIONS
**-n | --name** *name*
Sets an optional name for the image. If a name is already in use, an error is
returned.
**-i | --id** *ID*
Sets the ID for the image. If none is specified, one is generated.
**-m | --metadata** *metadata-value*
Sets the metadata for the image to the specified value.
**-f | --metadata-file** *metadata-file*
Sets the metadata for the image to the contents of the specified file.
## EXAMPLE
**oci-storage create-image -f manifest.json -n new-image somelayer**
## SEE ALSO
oci-storage-create-container(1)
oci-storage-create-layer(1)
oci-storage-delete-image(1)

View file

@ -0,0 +1,42 @@
## oci-storage-create-layer 1 "August 2016"
## NAME
oci-storage create-layer - Create a layer
## SYNOPSIS
**oci-storage** **create-layer** [*options* [...]] [*parentLayerNameOrID*]
## DESCRIPTION
Creates a new layer which either has a specified layer as its parent, or if no
parent is specified, is empty.
## OPTIONS
**-n** *name*
Sets an optional name for the layer. If a name is already in use, an error is
returned.
**-i | --id** *ID*
Sets the ID for the layer. If none is specified, one is generated.
**-m | --metadata** *metadata-value*
Sets the metadata for the layer to the specified value.
**-f | --metadata-file** *metadata-file*
Sets the metadata for the layer to the contents of the specified file.
**-l | --label** *mount-label*
Sets the label which should be assigned as an SELinux context when mounting the
layer.
## EXAMPLE
**oci-storage create-layer -f manifest.json -n new-layer somelayer**
## SEE ALSO
oci-storage-create-container(1)
oci-storage-create-image(1)
oci-storage-delete-layer(1)

View file

@ -0,0 +1,18 @@
## oci-storage-delete-container 1 "August 2016"
## NAME
oci-storage delete-container - Delete a container
## SYNOPSIS
**oci-storage** **delete-container** *containerNameOrID*
## DESCRIPTION
Deletes a container and its layer.
## EXAMPLE
**oci-storage delete-container my-awesome-container**
## SEE ALSO
oci-storage-create-container(1)
oci-storage-delete-image(1)
oci-storage-delete-layer(1)

View file

@ -0,0 +1,21 @@
## oci-storage-delete-image 1 "August 2016"
## NAME
oci-storage delete-image - Delete an image
## SYNOPSIS
**oci-storage** **delete-image** *imageNameOrID*
## DESCRIPTION
Deletes an image if it is not currently being used by any containers. If the
image's top layer is not being used by any other images, it will be removed.
If that image's parent is then not being used by other images, it, too, will be
removed, and the this will be repeated for each parent's parent.
## EXAMPLE
**oci-storage delete-image my-base-image**
## SEE ALSO
oci-storage-create-image(1)
oci-storage-delete-container(1)
oci-storage-delete-layer(1)

View file

@ -0,0 +1,19 @@
## oci-storage-delete-layer 1 "August 2016"
## NAME
oci-storage delete-layer - Delete a layer
## SYNOPSIS
**oci-storage** **delete-layer** *layerNameOrID*
## DESCRIPTION
Deletes a layer if it is not currently being used by any images or containers,
and is not the parent of any other layers.
## EXAMPLE
**oci-storage delete-layer my-base-layer**
## SEE ALSO
oci-storage-create-layer(1)
oci-storage-delete-image(1)
oci-storage-delete-layer(1)

View file

@ -0,0 +1,19 @@
## oci-storage-delete 1 "August 2016"
## NAME
oci-storage delete - Force deletion of a layer, image, or container
## SYNOPSIS
**oci-storage** **delete** *layerOrImageOrContainerNameOrID*
## DESCRIPTION
Deletes a specified layer, image, or container, with no safety checking. This
can corrupt data, and may be removed.
## EXAMPLE
**oci-storage delete my-base-layer**
## SEE ALSO
oci-storage-delete-container(1)
oci-storage-delete-image(1)
oci-storage-delete-layer(1)

View file

@ -0,0 +1,32 @@
## oci-storage-diff 1 "August 2016"
## NAME
oci-storage diff - Generate a layer diff
## SYNOPSIS
**oci-storage** **diff** [*options* [...]] *layerNameOrID*
## DESCRIPTION
Generates a layer diff representing the changes made in the specified layer.
If the layer was populated using a layer diff, the result aims to be
bit-for-bit identical with the one that was applied, including the type of
compression which was applied.
## OPTIONS
**-f | --file** *file*
Write the diff to the specified file instead of stdout.
**-c | --gzip**
Compress the diff using gzip compression. If the layer was populated by a
layer diff, and that layer diff was compressed, this will be done
automatically.
## EXAMPLE
**oci-storage diff my-base-layer**
## SEE ALSO
oci-storage-applydiff(1)
oci-storage-changes(1)
oci-storage-diffsize(1)

View file

@ -0,0 +1,19 @@
## oci-storage-diffsize 1 "August 2016"
## NAME
oci-storage diffsize - Compute the size of a layer diff
## SYNOPSIS
**oci-storage** **diffsize** *layerNameOrID*
## DESCRIPTION
Computes the expected size of the layer diff which would be generated for the
specified layer.
## EXAMPLE
**oci-storage diffsize my-base-layer**
## SEE ALSO
oci-storage-applydiff(1)
oci-storage-changes(1)
oci-storage-diff(1)

View file

@ -0,0 +1,31 @@
## oci-storage-exists 1 "August 2016"
## NAME
oci-storage exists - Check if a layer, image, or container exists
## SYNOPSIS
**oci-storage** **exists** [*options* [...]] *layerOrImageOrContainerNameOrID* [...]
## DESCRIPTION
Checks if there are layers, images, or containers which have the specified
names or IDs.
## OPTIONS
**-c | --container**
Only succeed if the names or IDs are that of containers.
**-i | --image**
Only succeed if the names or IDs are that of images.
**-l | --layer**
Only succeed if the names or IDs are that of layers.
**-q | --quiet**
Suppress output.
## EXAMPLE
**oci-storage exists my-base-layer**

View file

@ -0,0 +1,22 @@
## oci-storage-get-container-data 1 "August 2016"
## NAME
oci-storage get-container-data - Retrieve lookaside data for a container
## SYNOPSIS
**oci-storage** **get-container-data** [*options* [...]] *containerNameOrID* *dataName*
## DESCRIPTION
Retrieves a piece of named data which is associated with a container.
## OPTIONS
**-f | --file** *file*
Write the data to a file instead of stdout.
## EXAMPLE
**oci-storage get-container-data -f config.json my-container configuration**
## SEE ALSO
oci-storage-list-container-data(1)
oci-storage-set-container-data(1)

View file

@ -0,0 +1,17 @@
## oci-storage-get-container-dir 1 "Sepember 2016"
## NAME
oci-storage get-container-dir - Find lookaside directory for a container
## SYNOPSIS
**oci-storage** **get-container-dir** [*options* [...]] *containerNameOrID*
## DESCRIPTION
Prints the location of a directory which the caller can use to store lookaside
information which should be cleaned up when the container is deleted.
## EXAMPLE
**oci-storage get-container-dir my-container**
## SEE ALSO
oci-storage-get-container-run-dir(1)

View file

@ -0,0 +1,17 @@
## oci-storage-get-container-run-dir 1 "Sepember 2016"
## NAME
oci-storage get-container-run-dir - Find runtime lookaside directory for a container
## SYNOPSIS
**oci-storage** **get-container-run-dir** [*options* [...]] *containerNameOrID*
## DESCRIPTION
Prints the location of a directory which the caller can use to store lookaside
information which should be cleaned up when the host is rebooted.
## EXAMPLE
**oci-storage get-container-run-dir my-container**
## SEE ALSO
oci-storage-get-container-dir(1)

View file

@ -0,0 +1,22 @@
## oci-storage-get-image-data 1 "August 2016"
## NAME
oci-storage get-image-data - Retrieve lookaside data for an image
## SYNOPSIS
**oci-storage** **get-image-data** [*options* [...]] *imageNameOrID* *dataName*
## DESCRIPTION
Retrieves a piece of named data which is associated with an image.
## OPTIONS
**-f | --file** *file*
Write the data to a file instead of stdout.
## EXAMPLE
**oci-storage get-image-data -f manifest.json my-image manifest**
## SEE ALSO
oci-storage-list-image-data(1)
oci-storage-set-image-data(1)

View file

@ -0,0 +1,18 @@
## oci-storage-image 1 "August 2016"
## NAME
oci-storage image - Examine a single image
## SYNOPSIS
**oci-storage** **image** *imageNameOrID*
## DESCRIPTION
Retrieve information about an image: its ID, any names it has, and the ID of
its top layer.
## EXAMPLE
**oci-storage image 49bff34e4baf9378c01733d02276a731a4c4771ebeab305020c5303679f88bb8**
**oci-storage image my-favorite-image**
## SEE ALSO
oci-storage-images(1)

View file

@ -0,0 +1,16 @@
## oci-storage-images 1 "August 2016"
## NAME
oci-storage images - List known images
## SYNOPSIS
**oci-storage** **images**
## DESCRIPTION
Retrieves information about all known images and lists their IDs and names.
## EXAMPLE
**oci-storage images**
## SEE ALSO
oci-storage-image(1)

View file

@ -0,0 +1,23 @@
## oci-storage-layers 1 "August 2016"
## NAME
oci-storage layers - List known layers
## SYNOPSIS
**oci-storage** [*options* [...]] **layers**
## DESCRIPTION
Retrieves information about all known layers and lists their IDs and names, the
IDs and names of any images which list those layers as their top layer, and the
IDs and names of any containers for which the layer serves as the container's
own layer.
## OPTIONS
**-t | --tree**
Display results using a tree to show the hierarchy of parent-child
relationships between layers.
## EXAMPLE
**oci-storage layers**
**oci-storage layers -t**

View file

@ -0,0 +1,17 @@
## oci-storage-list-container-data 1 "August 2016"
## NAME
oci-storage list-container-data - List lookaside data for a container
## SYNOPSIS
**oci-storage** **list-container-data** *containerNameOrID*
## DESCRIPTION
List the pieces of named data which are associated with a container.
## EXAMPLE
**oci-storage list-container-data my-container**
## SEE ALSO
oci-storage-get-container-data(1)
oci-storage-set-container-data(1)

View file

@ -0,0 +1,17 @@
## oci-storage-list-image-data 1 "August 2016"
## NAME
oci-storage list-image-data - List lookaside data for an image
## SYNOPSIS
**oci-storage** **list-image-data** *imageNameOrID*
## DESCRIPTION
List the pieces of named data which are associated with an image.
## EXAMPLE
**oci-storage list-image-data my-image**
## SEE ALSO
oci-storage-get-image-data(1)
oci-storage-list-image-data(1)

View file

@ -0,0 +1,22 @@
## oci-storage-metadata 1 "August 2016"
## NAME
oci-storage metadata - Retrieve metadata for a layer, image, or container
## SYNOPSIS
**oci-storage** **metadata** [*options* [...]] *layerOrImageOrContainerNameOrID*
## DESCRIPTION
Outputs metadata associated with a layer, image, or container. Metadata is
intended to be small, and is expected to be cached in memory.
## OPTIONS
**-q | --quiet**
Don't print the ID or name of the item with which the metadata is associated.
## EXAMPLE
**oci-storage metadata -q my-image > my-image.txt**
## SEE ALSO
oci-storage-set-metadata(1)

View file

@ -0,0 +1,22 @@
## oci-storage-mount 1 "August 2016"
## NAME
oci-storage mount - Mount a layer or a container's layer for manipulation
## SYNOPSIS
**oci-storage** **mount** [*options* [...]] *layerOrContainerNameOrID*
## DESCRIPTION
Mounts a layer or a container's layer on the host's filesystem and prints the
mountpoint.
## OPTIONS
**-l | --label** *label*
Specify an SELinux context for the mounted layer.
## EXAMPLE
**oci-storage mount my-container**
## SEE ALSO
oci-storage-unmount(1)

View file

@ -0,0 +1,22 @@
## oci-storage-set-container-data 1 "August 2016"
## NAME
oci-storage set-container-data - Set lookaside data for a container
## SYNOPSIS
**oci-storage** **set-container-data** [*options* [...]] *containerNameOrID* *dataName*
## DESCRIPTION
Sets a piece of named data which is associated with a container.
## OPTIONS
**-f | --file** *filename*
Read the data contents from a file instead of stdin.
## EXAMPLE
**oci-storage set-container-data -f ./config.json my-container configuration**
## SEE ALSO
oci-storage-get-container-data(1)
oci-storage-list-container-data(1)

View file

@ -0,0 +1,22 @@
## oci-storage-set-image-data 1 "August 2016"
## NAME
oci-storage set-image-data - Set lookaside data for an image
## SYNOPSIS
**oci-storage** **set-image-data** [*options* [...]] *imageNameOrID* *dataName*
## DESCRIPTION
Sets a piece of named data which is associated with an image.
## OPTIONS
**-f | --file** *filename*
Read the data contents from a file instead of stdin.
## EXAMPLE
**oci-storage set-image-data -f ./manifest.json my-image manifest**
## SEE ALSO
oci-storage-get-image-data(1)
oci-storage-list-image-data(1)

View file

@ -0,0 +1,26 @@
## oci-storage-set-metadata 1 "August 2016"
## NAME
oci-storage set-metadata - Set metadata for a layer, image, or container
## SYNOPSIS
**oci-storage** **set-metadata** [*options* [...]] *layerOrImageOrContainerNameOrID*
## DESCRIPTION
Updates the metadata associated with a layer, image, or container. Metadata is
intended to be small, and is expected to be cached in memory.
## OPTIONS
**-f | --metadata-file** *filename*
Use the contents of the specified file as the metadata.
**-m | --metadata** *value*
Use the specified value as the metadata.
## EXAMPLE
**oci-storage set-metadata -m "compression: gzip" my-layer**
## SEE ALSO
oci-storage-metadata(1)

View file

@ -0,0 +1,27 @@
## oci-storage-set-names 1 "August 2016"
## NAME
oci-storage set-names - Set names for a layer/image/container
## SYNOPSIS
**oci-storage** **set-names** [**-n** *name* [...]] *layerOrImageOrContainerNameOrID*
## DESCRIPTION
In addition to IDs, *layers*, *images*, and *containers* can have
human-readable names assigned to them in *oci-storage*. The *set-names*
command can be used to reset the list of names for any of them.
## OPTIONS
**-n | --name** *name*
Specifies a name to set on the layer, image, or container. If a specified name
is already used by another layer, image, or container, it is removed from that
other layer, image, or container. Any names which are currently assigned to
this layer, image, or container, and which are not specified using this option,
will be removed from the layer, image, or container.
## EXAMPLE
**oci-storage set-names -n my-one-and-only-name f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
## SEE ALSO
oci-storage-add-names(1)

View file

@ -0,0 +1,20 @@
## oci-storage-shutdown 1 "October 2016"
## NAME
oci-storage shutdown - Shut down layer storage
## SYNOPSIS
**oci-storage** **shutdown** [*options* [...]]
## DESCRIPTION
Shuts down the layer storage driver, which may be using kernel resources.
## OPTIONS
**-f | --force**
Attempt to unmount any mounted layers before attempting to shut down the
driver. If this option is not specified, if any layers are mounted, shutdown
will not be attempted.
## EXAMPLE
**oci-storage shutdown**

View file

@ -0,0 +1,16 @@
## oci-storage-status 1 "August 2016"
## NAME
oci-storage status - Output status information from the storage library's driver
## SYNOPSIS
**oci-storage** **status**
## DESCRIPTION
Queries the storage library's driver for status information.
## EXAMPLE
**oci-storage status**
## SEE ALSO
oci-storage-version(1)

View file

@ -0,0 +1,17 @@
## oci-storage-unmount 1 "August 2016"
## NAME
oci-storage unmount - Unmount a layer or a container's layer
## SYNOPSIS
**oci-storage** **unmount** *layerOrContainerMountpointOrNameOrID*
## DESCRIPTION
Unmounts a layer or a container's layer from the host's filesystem.
## EXAMPLE
**oci-storage unmount my-container**
**oci-storage unmount /var/lib/oci-storage/mounts/my-container**
## SEE ALSO
oci-storage-mount(1)

View file

@ -0,0 +1,16 @@
## oci-storage-version 1 "August 2016"
## NAME
oci-storage version - Output version information about the storage library
## SYNOPSIS
**oci-storage** **version**
## DESCRIPTION
Outputs version information about the storage library and *oci-storage*.
## EXAMPLE
**oci-storage version**
## SEE ALSO
oci-storage-status(1)

View file

@ -0,0 +1,14 @@
## oci-storage-wipe 1 "August 2016"
## NAME
oci-storage wipe - Delete all containers, images, and layers
## SYNOPSIS
**oci-storage** **wipe**
## DESCRIPTION
Deletes all known containers, images, and layers. Depending on your use case,
use with caution or abandon.
## EXAMPLE
**oci-storage wipe**

View file

@ -0,0 +1,131 @@
## oci-storage 1 "August 2016"
## NAME
oci-storage - Manage layer/image/container storage
## SYNOPSIS
**oci-storage** [**subcommand**] [**--help**]
## DESCRIPTION
The *oci-storage* command is a front-end for the *containers/storage* library.
While it can be used to manage storage for filesystem layers, images, and
containers directly, its main use cases are centered around troubleshooting and
querying the state of storage which is being managed by other processes.
Notionally, a complete filesystem layer is composed of a container filesystem
and some bookkeeping information. Other layers, *children* of that layer,
default to sharing its contents, but any changes made to the contents of the
children are not reflected in the *parent*. This arrangement is intended to
save disk space: by storing the *child* layer only as a set of changes relative
to its *parent*, the *parent*'s contents should not need to be duplicated for
each of the *parent*'s *children*. Of course, each *child* can have its own
*children*. The contents of *parent* layers should not be modified.
An *image* is a reference to a particular *layer*, along with some bookkeeping
information. Presumably, the *image* points to a *layer* which has been
modified, possibly in multiple steps, from some general-purpose *parent*, so
that it is suitable for running an intended application. Multiple *images* can
reference a single *layer*, while differing only in the additional bookkeeping
information that they carry. The contents of *images* should be considered
read-only.
A *container* is essentially a *layer* which is a *child* of a *layer* which is
referred to by an *image* (put another way, a *container* is instantiated from
an *image*), along with some bookkeeping information. They do not have
*children* and their *layers* can not be directly referred to by *images*.
This ensures that changes to the contents of a *container*'s layer do not
affect other *images* or *layers*, so they are considered writeable.
All of *layers*, *images*, and *containers* can have metadata which
*oci-storage* manages attached to them. Generally this metadata is not
expected to be large, as it is cached in memory.
*Images* and *containers* can also have arbitrarily-named data items attached
to them. Generally, this data can be larger than metadata, and is not kept in
memory unless it is being retrieved or written.
It is expected that signatures which can be used to verify an *image*'s
contents will be stored as data items for that *image*, along with any template
configuration data which is recommended for use in *containers* which derive
from the *image*. It is also expected that a *container*'s run-time
configuration will be stored as data items.
## SUB-COMMANDS
The *oci-storage* command's features are broken down into several subcommands:
**oci-storage add-names(1)** Add layer, image, or container name or names
**oci-storage applydiff(1)** Apply a diff to a layer
**oci-storage changes(1)** Compare two layers
**oci-storage container(1)** Examine a container
**oci-storage containers(1)** List containers
**oci-storage create-container(1)** Create a new container from an image
**oci-storage create-image(1)** Create a new image using layers
**oci-storage create-layer(1)** Create a new layer
**oci-storage delete(1)** Delete a layer or image or container, with no safety checks
**oci-storage delete-container(1)** Delete a container, with safety checks
**oci-storage delete-image(1)** Delete an image, with safety checks
**oci-storage delete-layer(1)** Delete a layer, with safety checks
**oci-storage diff(1)** Compare two layers
**oci-storage diffsize(1)** Compare two layers
**oci-storage exists(1)** Check if a layer or image or container exists
**oci-storage get-container-data(1)** Get data that is attached to a container
**oci-storage get-image-data(1)** Get data that is attached to an image
**oci-storage image(1)** Examine an image
**oci-storage images(1)** List images
**oci-storage layers(1)** List layers
**oci-storage list-container-data(1)** List data items that are attached to a container
**oci-storage list-image-data(1)** List data items that are attached to an image
**oci-storage metadata(1)** Retrieve layer, image, or container metadata
**oci-storage mount(1)** Mount a layer or container
**oci-storage set-container-data(1)** Set data that is attached to a container
**oci-storage set-image-data(1)** Set data that is attached to an image
**oci-storage set-metadata(1)** Set layer, image, or container metadata
**oci-storage set-names(1)** Set layer, image, or container name or names
**oci-storage shutdown(1)** Shut down graph driver
**oci-storage status(1)** Check on graph driver status
**oci-storage unmount(1)** Unmount a layer or container
**oci-storage version(1)** Return oci-storage version information
**oci-storage wipe(1)** Wipe all layers, images, and containers
## OPTIONS
**--help**
Print the list of available sub-commands. When a sub-command is specified,
provide information about that command.
**--debug, -D**
Increases the amount of debugging information which is printed.
**--graph, -g=/var/lib/oci-storage**
Overrides the root of the storage tree, used for storing layer contents and
information about layers, images, and containers.
**--run, -R=/var/run/oci-storage**
Overrides the root of the runtime state tree, currently used mainly for noting
the location where a given layer is mounted (see **oci-storage mount**) so that
it can be unmounted by path name as an alternative to unmounting by ID or name.
**--storage-driver, -s**
Specifies which storage driver to use. If not set, but *$STORAGE_DRIVER* is
set in the environment, its value is used. If the storage tree has previously
been initialized, neither needs to be provided. If the tree has not previously
been initialized and neither is set, a hard-coded default is selected.
**--storage-opt=[]**
Set options which will be passed to the storage driver. If not set, but
*$STORAGE_OPTS* is set in the environment, its value is treated as a
comma-separated list and used instead. If the storage tree has previously been
initialized, these need not be provided.
## EXAMPLES
**oci-storage layers -t**
## BUGS
This is still a work in progress, so some functionality may not yet be
implemented, and some will be removed if it is found to be unnecessary. That
said, if anything isn't working correctly, please report it to [the project's
issue tracker] (https://github.com/containers/storage/issues).