summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2022-08-10 10:23:18 +0000
committerGitHub <noreply@github.com>2022-08-10 10:23:18 +0000
commitaa13c73f7130e7f477a9e1af247b79b39b059923 (patch)
treea1866b6c655a0e1b809ff839bfed3adce7f51d28 /docs
parentc4a35313c93b4384766af914bd1241bb77ebdbe5 (diff)
parent842c6c7c6748f8705698d25a29945f8437f1bed2 (diff)
downloadpodman-aa13c73f7130e7f477a9e1af247b79b39b059923.tar.gz
podman-aa13c73f7130e7f477a9e1af247b79b39b059923.tar.bz2
podman-aa13c73f7130e7f477a9e1af247b79b39b059923.zip
Merge pull request #14926 from cdoern/generateSpec
podman generate spec
Diffstat (limited to 'docs')
-rw-r--r--docs/source/markdown/podman-generate-spec.1.md26
-rw-r--r--docs/source/markdown/podman-generate.1.md3
2 files changed, 28 insertions, 1 deletions
diff --git a/docs/source/markdown/podman-generate-spec.1.md b/docs/source/markdown/podman-generate-spec.1.md
new file mode 100644
index 000000000..08c939698
--- /dev/null
+++ b/docs/source/markdown/podman-generate-spec.1.md
@@ -0,0 +1,26 @@
+% podman-generate-spec(1)
+
+## NAME
+podman\-generate\-spec - Generate Specgen JSON based on containers or pods
+
+## SYNOPSIS
+**podman generate spec** [*options*] *container | *pod*
+
+## DESCRIPTION
+**podman generate spec** will generate Specgen JSON from Podman Containers and Pods. This JSON can either be printed to a file, directly to the command line, or both.
+
+This JSON can then be used as input for the Podman API, specifically for Podman container and pod creation. Specgen is Podman's internal structure for formulating new container-related entities.
+
+## OPTIONS
+
+#### **--compact**, **-c**
+
+Print the output in a compact, one line format. This is useful when piping the data to the Podman API
+
+#### **--filename**, **-f**=**filename**
+
+Output to the given file.
+
+#### **--name**, **-n**
+
+Rename the pod or container, so that it does not conflict with the existing entity. This is helpful when the JSON is to be used before the source pod or container is deleted.
diff --git a/docs/source/markdown/podman-generate.1.md b/docs/source/markdown/podman-generate.1.md
index 415a53875..8466068f2 100644
--- a/docs/source/markdown/podman-generate.1.md
+++ b/docs/source/markdown/podman-generate.1.md
@@ -13,7 +13,8 @@ The generate command will create structured output (like YAML) based on a contai
| Command | Man Page | Description |
|---------|------------------------------------------------------------|-------------------------------------------------------------------------------------|
-| kube | [podman-generate-kube(1)](podman-generate-kube.1.md) | Generate Kubernetes YAML based on containers, pods or volumes. |
+| kube | [podman-generate-kube(1)](podman-generate-kube.1.md) | Generate Kubernetes YAML based on containers, pods or volumes. |
+| spec | [podman-generate-spec(1)](podman-generate-spec.1.md) | Generate Specgen JSON based on containers or pods. |
| systemd | [podman-generate-systemd(1)](podman-generate-systemd.1.md) | Generate systemd unit file(s) for a container or pod. |