Switch to github.com/golang/dep for vendoring
Signed-off-by: Mrunal Patel <mrunalp@gmail.com>
This commit is contained in:
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
6
vendor/github.com/containers/storage/docs/Makefile
generated
vendored
Normal file
|
@ -0,0 +1,6 @@
|
|||
GOMD2MAN = go-md2man
|
||||
|
||||
docs: $(patsubst %.md,%.1,$(wildcard *.md))
|
||||
|
||||
%.1: %.md
|
||||
$(GOMD2MAN) -in $^ -out $@
|
25
vendor/github.com/containers/storage/docs/oci-storage-add-names.md
generated
vendored
Normal file
25
vendor/github.com/containers/storage/docs/oci-storage-add-names.md
generated
vendored
Normal 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)
|
32
vendor/github.com/containers/storage/docs/oci-storage-applydiff.md
generated
vendored
Normal file
32
vendor/github.com/containers/storage/docs/oci-storage-applydiff.md
generated
vendored
Normal 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)
|
21
vendor/github.com/containers/storage/docs/oci-storage-changes.md
generated
vendored
Normal file
21
vendor/github.com/containers/storage/docs/oci-storage-changes.md
generated
vendored
Normal 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)
|
18
vendor/github.com/containers/storage/docs/oci-storage-container.md
generated
vendored
Normal file
18
vendor/github.com/containers/storage/docs/oci-storage-container.md
generated
vendored
Normal 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)
|
16
vendor/github.com/containers/storage/docs/oci-storage-containers.md
generated
vendored
Normal file
16
vendor/github.com/containers/storage/docs/oci-storage-containers.md
generated
vendored
Normal 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)
|
37
vendor/github.com/containers/storage/docs/oci-storage-create-container.md
generated
vendored
Normal file
37
vendor/github.com/containers/storage/docs/oci-storage-create-container.md
generated
vendored
Normal 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)
|
37
vendor/github.com/containers/storage/docs/oci-storage-create-image.md
generated
vendored
Normal file
37
vendor/github.com/containers/storage/docs/oci-storage-create-image.md
generated
vendored
Normal 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)
|
42
vendor/github.com/containers/storage/docs/oci-storage-create-layer.md
generated
vendored
Normal file
42
vendor/github.com/containers/storage/docs/oci-storage-create-layer.md
generated
vendored
Normal 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)
|
18
vendor/github.com/containers/storage/docs/oci-storage-delete-container.md
generated
vendored
Normal file
18
vendor/github.com/containers/storage/docs/oci-storage-delete-container.md
generated
vendored
Normal 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)
|
21
vendor/github.com/containers/storage/docs/oci-storage-delete-image.md
generated
vendored
Normal file
21
vendor/github.com/containers/storage/docs/oci-storage-delete-image.md
generated
vendored
Normal 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)
|
19
vendor/github.com/containers/storage/docs/oci-storage-delete-layer.md
generated
vendored
Normal file
19
vendor/github.com/containers/storage/docs/oci-storage-delete-layer.md
generated
vendored
Normal 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)
|
19
vendor/github.com/containers/storage/docs/oci-storage-delete.md
generated
vendored
Normal file
19
vendor/github.com/containers/storage/docs/oci-storage-delete.md
generated
vendored
Normal 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)
|
32
vendor/github.com/containers/storage/docs/oci-storage-diff.md
generated
vendored
Normal file
32
vendor/github.com/containers/storage/docs/oci-storage-diff.md
generated
vendored
Normal 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)
|
19
vendor/github.com/containers/storage/docs/oci-storage-diffsize.md
generated
vendored
Normal file
19
vendor/github.com/containers/storage/docs/oci-storage-diffsize.md
generated
vendored
Normal 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)
|
31
vendor/github.com/containers/storage/docs/oci-storage-exists.md
generated
vendored
Normal file
31
vendor/github.com/containers/storage/docs/oci-storage-exists.md
generated
vendored
Normal 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**
|
22
vendor/github.com/containers/storage/docs/oci-storage-get-container-data.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-get-container-data.md
generated
vendored
Normal 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)
|
17
vendor/github.com/containers/storage/docs/oci-storage-get-container-dir.md
generated
vendored
Normal file
17
vendor/github.com/containers/storage/docs/oci-storage-get-container-dir.md
generated
vendored
Normal 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)
|
17
vendor/github.com/containers/storage/docs/oci-storage-get-container-run-dir.md
generated
vendored
Normal file
17
vendor/github.com/containers/storage/docs/oci-storage-get-container-run-dir.md
generated
vendored
Normal 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)
|
22
vendor/github.com/containers/storage/docs/oci-storage-get-image-data.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-get-image-data.md
generated
vendored
Normal 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)
|
18
vendor/github.com/containers/storage/docs/oci-storage-image.md
generated
vendored
Normal file
18
vendor/github.com/containers/storage/docs/oci-storage-image.md
generated
vendored
Normal 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)
|
16
vendor/github.com/containers/storage/docs/oci-storage-images.md
generated
vendored
Normal file
16
vendor/github.com/containers/storage/docs/oci-storage-images.md
generated
vendored
Normal 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)
|
23
vendor/github.com/containers/storage/docs/oci-storage-layers.md
generated
vendored
Normal file
23
vendor/github.com/containers/storage/docs/oci-storage-layers.md
generated
vendored
Normal 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**
|
17
vendor/github.com/containers/storage/docs/oci-storage-list-container-data.md
generated
vendored
Normal file
17
vendor/github.com/containers/storage/docs/oci-storage-list-container-data.md
generated
vendored
Normal 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)
|
17
vendor/github.com/containers/storage/docs/oci-storage-list-image-data.md
generated
vendored
Normal file
17
vendor/github.com/containers/storage/docs/oci-storage-list-image-data.md
generated
vendored
Normal 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)
|
22
vendor/github.com/containers/storage/docs/oci-storage-metadata.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-metadata.md
generated
vendored
Normal 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)
|
22
vendor/github.com/containers/storage/docs/oci-storage-mount.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-mount.md
generated
vendored
Normal 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)
|
22
vendor/github.com/containers/storage/docs/oci-storage-set-container-data.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-set-container-data.md
generated
vendored
Normal 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)
|
22
vendor/github.com/containers/storage/docs/oci-storage-set-image-data.md
generated
vendored
Normal file
22
vendor/github.com/containers/storage/docs/oci-storage-set-image-data.md
generated
vendored
Normal 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)
|
26
vendor/github.com/containers/storage/docs/oci-storage-set-metadata.md
generated
vendored
Normal file
26
vendor/github.com/containers/storage/docs/oci-storage-set-metadata.md
generated
vendored
Normal 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)
|
27
vendor/github.com/containers/storage/docs/oci-storage-set-names.md
generated
vendored
Normal file
27
vendor/github.com/containers/storage/docs/oci-storage-set-names.md
generated
vendored
Normal 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)
|
20
vendor/github.com/containers/storage/docs/oci-storage-shutdown.md
generated
vendored
Normal file
20
vendor/github.com/containers/storage/docs/oci-storage-shutdown.md
generated
vendored
Normal 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**
|
16
vendor/github.com/containers/storage/docs/oci-storage-status.md
generated
vendored
Normal file
16
vendor/github.com/containers/storage/docs/oci-storage-status.md
generated
vendored
Normal 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)
|
17
vendor/github.com/containers/storage/docs/oci-storage-unmount.md
generated
vendored
Normal file
17
vendor/github.com/containers/storage/docs/oci-storage-unmount.md
generated
vendored
Normal 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)
|
16
vendor/github.com/containers/storage/docs/oci-storage-version.md
generated
vendored
Normal file
16
vendor/github.com/containers/storage/docs/oci-storage-version.md
generated
vendored
Normal 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)
|
14
vendor/github.com/containers/storage/docs/oci-storage-wipe.md
generated
vendored
Normal file
14
vendor/github.com/containers/storage/docs/oci-storage-wipe.md
generated
vendored
Normal 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**
|
131
vendor/github.com/containers/storage/docs/oci-storage.md
generated
vendored
Normal file
131
vendor/github.com/containers/storage/docs/oci-storage.md
generated
vendored
Normal 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).
|
Loading…
Add table
Add a link
Reference in a new issue