runc-checkpoint - Man Page
checkpoint a running container
Synopsis
runc checkpoint [option ...] container-id
Description
The checkpoint command saves the state of the running container instance with the help of criu(8) tool, to be restored later.
Options
- --image-path path
Set path for saving criu image files. The default is ./checkpoint.
- --work-path path
Set path for saving criu work files and logs. The default is to reuse the image files directory.
- --parent-path path
Set path for previous criu image files, in pre-dump.
- --leave-running
Leave the process running after checkpointing.
- --tcp-established
Allow checkpoint/restore of established TCP connections. See criu --tcp-establised option ⟨https://criu.org/CLI/opt/--tcp-established⟩.
- --ext-unix-sk
Allow checkpoint/restore of external unix sockets. See criu --ext-unix-sk option ⟨https://criu.org/CLI/opt/--ext-unix-sk⟩.
- --shell-job
Allow checkpoint/restore of shell jobs.
- --lazy-pages
Use lazy migration mechanism. See criu --lazy-pages option ⟨https://criu.org/CLI/opt/--lazy-pages⟩.
- --status-fd fd
Pass a file descriptor fd to criu. Once lazy-pages server is ready, criu writes \0 (a zero byte) to that fd. Used together with --lazy-pages.
- --page-server IP-address:port
Start a page server at the specified IP-address and port. This is used together with criu lazy-pages. See criu lazy migration ⟨https://criu.org/Lazy_migration⟩.
- --file-locks
Allow checkpoint/restore of file locks. See criu --file-locks option ⟨https://criu.org/CLI/opt/--file-locks⟩.
- --pre-dump
Do a pre-dump, i.e. dump container's memory information only, leaving the container running. See criu iterative migration ⟨https://criu.org/Iterative_migration⟩.
- --manage-cgroups-mode soft|full|strict|ignore.
Cgroups mode. Default is soft. See criu --manage-cgroups option ⟨https://criu.org/CLI/opt/--manage-cgroups⟩.
- --empty-ns namespace
Checkpoint a namespace, but don't save its properties. See criu --empty-ns option ⟨https://criu.org/CLI/opt/--empty-ns⟩.
- --auto-dedup
Enable auto deduplication of memory images. See criu --auto-dedup option ⟨https://criu.org/CLI/opt/--auto-dedup⟩.