mirror of
https://github.com/opencontainers/runc.git
synced 2025-10-08 08:50:15 +08:00

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>
2.6 KiB
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).