summaryrefslogtreecommitdiff
path: root/API.md
diff options
context:
space:
mode:
authorbaude <bbaude@redhat.com>2018-05-11 12:33:47 -0500
committerAtomic Bot <atomic-devel@projectatomic.io>2018-05-15 17:08:10 +0000
commitd870c25c012c8f8d39692d3c786c5f3ea0bd7169 (patch)
tree95ec275b645f7a34b0882f58b42ee446c2cae3b0 /API.md
parent962fde3c6cc62fe60132c6c94d0aa10103a77862 (diff)
downloadpodman-d870c25c012c8f8d39692d3c786c5f3ea0bd7169.tar.gz
podman-d870c25c012c8f8d39692d3c786c5f3ea0bd7169.tar.bz2
podman-d870c25c012c8f8d39692d3c786c5f3ea0bd7169.zip
implement varlink commit
Signed-off-by: baude <bbaude@redhat.com> Closes: #762 Approved by: baude
Diffstat (limited to 'API.md')
-rwxr-xr-xAPI.md40
1 files changed, 23 insertions, 17 deletions
diff --git a/API.md b/API.md
index c9d2d5c23..af48c10b1 100755
--- a/API.md
+++ b/API.md
@@ -7,9 +7,9 @@ in the [API.md](https://github.com/projectatomic/libpod/blob/master/API.md) file
[func BuildImage() NotImplemented](#BuildImage)
-[func CreateContainer() NotImplemented](#CreateContainer)
+[func Commit(name: string, image_name: string, changes: []string, author: string, message: string, pause: bool) string](#Commit)
-[func CreateFromContainer() NotImplemented](#CreateFromContainer)
+[func CreateContainer() NotImplemented](#CreateContainer)
[func CreateImage() NotImplemented](#CreateImage)
@@ -27,14 +27,14 @@ in the [API.md](https://github.com/projectatomic/libpod/blob/master/API.md) file
[func GetContainerStats(name: string) ContainerStats](#GetContainerStats)
+[func GetInfo() PodmanInfo](#GetInfo)
+
[func GetVersion() Version](#GetVersion)
[func HistoryImage(name: string) ImageHistory](#HistoryImage)
[func ImportImage(source: string, reference: string, message: string, changes: []string) string](#ImportImage)
-[func Info() PodmanInfo](#Info)
-
[func InspectContainer(name: string) string](#InspectContainer)
[func InspectImage(name: string) string](#InspectImage)
@@ -134,16 +134,22 @@ This method has not be implemented yet.
method BuildImage() [NotImplemented](#NotImplemented)</div>
This function is not implemented yet.
-### <a name="CreateContainer"></a>func CreateContainer
+### <a name="Commit"></a>func Commit
<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
-method CreateContainer() [NotImplemented](#NotImplemented)</div>
-This method has not been implemented yet.
-### <a name="CreateFromContainer"></a>func CreateFromContainer
+method Commit(name: [string](https://godoc.org/builtin#string), image_name: [string](https://godoc.org/builtin#string), changes: [[]string](#[]string), author: [string](https://godoc.org/builtin#string), message: [string](https://godoc.org/builtin#string), pause: [bool](https://godoc.org/builtin#bool)) [string](https://godoc.org/builtin#string)</div>
+Commit, creates an image from an existing container. It requires the name or
+ID of the container as well as the resulting image name. Optionally, you can define an author and message
+to be added to the resulting image. You can also define changes to the resulting image for the following
+attributes: _CMD, ENTRYPOINT, ENV, EXPOSE, LABEL, STOPSIGNAL, USER, VOLUME, and WORKDIR_. To pause the
+container while it is being committed, pass a _true_ bool for the pause argument. If the container cannot
+be found by the ID or name provided, a (ContainerNotFound)[#ContainerNotFound] error will be returned; otherwise,
+the resulting image's ID will be returned as a string.
+### <a name="CreateContainer"></a>func CreateContainer
<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
-method CreateFromContainer() [NotImplemented](#NotImplemented)</div>
-This method is not implemented.
+method CreateContainer() [NotImplemented](#NotImplemented)</div>
+This method is not implemented yet.
### <a name="CreateImage"></a>func CreateImage
<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
@@ -219,6 +225,12 @@ $ varlink call -m unix:/run/io.projectatomic.podman/io.projectatomic.podman.GetC
}
}
~~~
+### <a name="GetInfo"></a>func GetInfo
+<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
+
+method GetInfo() [PodmanInfo](#PodmanInfo)</div>
+GetInfo returns a [PodmanInfo](#PodmanInfo) struct that describes podman and its host such as storage stats,
+build information of Podman, and system-wide registries.
### <a name="GetVersion"></a>func GetVersion
<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
@@ -238,12 +250,6 @@ history is in the form of an array of ImageHistory structures. If the image can
method ImportImage(source: [string](https://godoc.org/builtin#string), reference: [string](https://godoc.org/builtin#string), message: [string](https://godoc.org/builtin#string), changes: [[]string](#[]string)) [string](https://godoc.org/builtin#string)</div>
ImportImage imports an image from a source (like tarball) into local storage. The image can have additional
descriptions added to it using the message and changes options. See also [ExportImage](ExportImage).
-### <a name="Info"></a>func Info
-<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
-
-method Info() [PodmanInfo](#PodmanInfo)</div>
-Info returns a [PodmanInfo](#PodmanInfo) struct that describes podman and its host such as storage stats,
-build information of Podman, and system-wide registries.
### <a name="InspectContainer"></a>func InspectContainer
<div style="background-color: #E8E8E8; padding: 15px; margin: 10px; border-radius: 10px;">
@@ -576,7 +582,7 @@ name [string](https://godoc.org/builtin#string)
star_count [int](https://godoc.org/builtin#int)
### <a name="InfoGraphStatus"></a>type InfoGraphStatus
-InfoGraphStatus describes the detailed status of the graphc
+InfoGraphStatus describes the detailed status of the storage driver
backing_filesystem [string](https://godoc.org/builtin#string)