Files
runc/man/runc-restore.8.md
Kir Kolyshkin dfc0f0695a man/*: revamp
Current runc man pages are ugly (no proper man page formatting)
and very short (mostly just a copy-paste from the "runc <command>
--help" output. They are also somewhat obsoleted as not all CLI updates
were propagated to man/*.

This commits makes the first step to solving this.

In short:
 - added some more information about some options;
 - lots of formatting fixes;
 - use references to other man pages and web pages;
 - fix SYNOPSYS (formatting, mostly);
 - removed the repeated description of <container_id> from every page;
 - added SEE ALSO;
 - something else I forgot.

Signed-off-by: Kir Kolyshkin <kolyshkin@gmail.com>
2021-06-16 12:42:06 -07:00

2.6 KiB

% runc-restore "8"

NAME

runc-restore - restore a container from a previous checkpoint

SYNOPSIS

runc restore [option ...] container-id

DESCRIPTION

Restores the container instance from a previously performed runc checkpoint.

OPTIONS

--console-socket path
Path to an AF_UNIX socket which will receive a file descriptor referencing the master end of the console's pseudoterminal. See docs/terminals.
--image-path path
Set path to get criu image files to restore from.
--work-path path
Set path for saving criu work files and logs. The default is to reuse the image files directory.
--tcp-established
Allow checkpoint/restore of established TCP connections. See criu --tcp-establised option.
--ext-unix-sk
Allow checkpoint/restore of external unix sockets. See criu --ext-unix-sk option.
--shell-job
Allow checkpoint/restore of shell jobs.
--file-locks
Allow checkpoint/restore of file locks. See criu --file-locks option.
--manage-cgroups-mode soft|full|strict.
Cgroups mode. Default is soft. See criu --manage-cgroups option.
--bundle|-b path
Path to the root of the bundle directory. Default is current directory.
--detach|-d
Detach from the container's process.
--pid-file path
Specify the file to write the initial container process' PID to.
--no-subreaper
Disable the use of the subreaper used to reap reparented processes.
--no-pivot
Do not use pivot root to jail process inside rootfs. This should not be used except in exceptional circumstances, and may be unsafe from the security standpoint.
--empty-ns namespace
Create a namespace, but don't restore its properties. See criu --empty-ns option.
--auto-dedup
Enable auto deduplication of memory images. See criu --auto-dedup option.
--lazy-pages
Use lazy migration mechanism. This requires a running criu lazy-pages daemon. See criu --lazy-pages option.
--lsm-profile type:label
Specify an LSM profile to be used during restore. Here type can either be apparamor or selinux, and label is a valid LSM label. For example, --lsm-profile "selinux:system_u:system_r:container_t:s0:c82,c137".

SEE ALSO

criu(8), runc-checkpoint(8), runc(8).