summaryrefslogtreecommitdiff
path: root/docs/source/markdown/podman-container-restore.1.md
diff options
context:
space:
mode:
authorAdrian Reber <areber@redhat.com>2021-11-10 12:43:12 +0000
committerAdrian Reber <areber@redhat.com>2021-11-15 11:50:25 +0000
commit914f4c8905d102a5f345b445cc899fd85062093b (patch)
tree4cfb4aff966506440ccd5a993291214cc7584a7d /docs/source/markdown/podman-container-restore.1.md
parent80e56fa12b7bf7e19a768ce9a3beeeeb53f9b33d (diff)
downloadpodman-914f4c8905d102a5f345b445cc899fd85062093b.tar.gz
podman-914f4c8905d102a5f345b445cc899fd85062093b.tar.bz2
podman-914f4c8905d102a5f345b445cc899fd85062093b.zip
Update man pages for checkpoint/restore --print-stats
This commit updates the man pages for checkpoint and restore to describe the '--print-stats' parameter. Signed-off-by: Adrian Reber <areber@redhat.com>
Diffstat (limited to 'docs/source/markdown/podman-container-restore.1.md')
-rw-r--r--docs/source/markdown/podman-container-restore.1.md26
1 files changed, 25 insertions, 1 deletions
diff --git a/docs/source/markdown/podman-container-restore.1.md b/docs/source/markdown/podman-container-restore.1.md
index 856008cc0..962770ea0 100644
--- a/docs/source/markdown/podman-container-restore.1.md
+++ b/docs/source/markdown/podman-container-restore.1.md
@@ -102,6 +102,30 @@ from (see **[podman pod create --share](podman-pod-create.1.md#--share)**).
This option requires at least CRIU 3.16.
+#### **--print-stats**
+
+Print out statistics about restoring the container(s). The output is
+rendered in a JSON array and contains information about how much time different
+restore operations required. Many of the restore statistics are created
+by CRIU and just passed through to Podman. The following information is provided
+in the JSON array:
+
+- **podman_restore_duration**: Overall time (in microseconds) needed to restore
+ all checkpoints.
+
+- **runtime_restore_duration**: Time (in microseconds) the container runtime
+ needed to restore the checkpoint.
+
+- **forking_time**: Time (in microseconds) CRIU needed to create (fork) all
+ processes in the restored container (measured by CRIU).
+
+- **restore_time**: Time (in microseconds) CRIU needed to restore all processes
+ in the container (measured by CRIU).
+
+- **pages_restored**: Number of memory pages restored (measured by CRIU).
+
+The default is **false**.
+
#### **--publish**, **-p**=*port*
Replaces the ports that the *container* publishes, as configured during the
@@ -137,7 +161,7 @@ $ podman run --rm -p 2345:80 -d webserver
```
## SEE ALSO
-**[podman(1)](podman.1.md)**, **[podman-container-checkpoint(1)](podman-container-checkpoint.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**
+**[podman(1)](podman.1.md)**, **[podman-container-checkpoint(1)](podman-container-checkpoint.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[podman-pod-create(1)](podman-pod-create.1.md)**, **criu(8)**
## HISTORY
September 2018, Originally compiled by Adrian Reber <areber@redhat.com>