C Python Shell Makefile Assembly C++ Other
avagin inventory: save dump_uptime for criu dump if track_mem is set
A set of images from criu dump can be used as a previous point, when we
are doing snapshots. In this case, each point contains a full set of
images.

#479

v2: return -1 if invertory_save_uptime failed

Cc: Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Signed-off-by: Andrei Vagin <avagin@virtuozzo.com>
Reviewed-by: Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Signed-off-by: Andrei Vagin <avagin@virtuozzo.com>
Latest commit 380df8a Apr 28, 2018
Permalink
Failed to load latest commit information.
Documentation Add --ps-socket option to Documentation/criu.txt Jul 9, 2018
compel compel, x86_64: Fix sys_clone() definition Jul 9, 2018
contrib scripts/install-debian-packages: add libnl-route-3-dev May 10, 2017
coredump python: specify python2 as .py interpreter Apr 17, 2017
crit crit: enable python2 or python3 based crit Jul 9, 2018
criu inventory: save dump_uptime for criu dump if track_mem is set Jul 17, 2018
images seccomp: Add engine to restore per-thread seccomp chains Jul 9, 2018
include/common bitops: use a gcc builtin function instead of our __ffs Jul 9, 2018
lib lib/c: add missing criu_local_set_service_binary signature Jul 9, 2018
scripts travis: fix building on s390x Jul 10, 2018
soccr Remove redundant semicolons May 12, 2018
test zdtm: open notify file descriptors in a binary mode Jul 10, 2018
.gitignore crit: enable python2 or python3 based crit Jul 9, 2018
.mailmap repo: Add mailmap file Mar 25, 2012
.travis.yml travis: build criu and run tests on centos Jul 4, 2018
COPYING COPYING: fix a typo in a preamble Aug 11, 2016
CREDITS Add the CREDITS file Jul 30, 2012
INSTALL.md Makefile.install: rm unused vars/target Feb 6, 2017
Makefile crit: enable python2 or python3 based crit Jul 9, 2018
Makefile.compel build: Don't forget to rebuild pie code on compel plugins change Nov 23, 2017
Makefile.config criu: always enable the userfaultfd support Sep 16, 2017
Makefile.install Make the Makefile variables externally configurable. Aug 15, 2017
Makefile.versions criu: Version 3.10 Jul 10, 2018
README.md README.md correct travis links Jul 9, 2018

README.md

master development Codacy Badge

CRIU -- A project to implement checkpoint/restore functionality for Linux

CRIU (stands for Checkpoint and Restore in Userspace) is a utility to checkpoint/restore Linux tasks.

Using this tool, you can freeze a running application (or part of it) and checkpoint it to a hard drive as a collection of files. You can then use the files to restore and run the application from the point it was frozen at. The distinctive feature of the CRIU project is that it is mainly implemented in user space. There are some more projects doing C/R for Linux, and so far CRIU appears to be the most feature-rich and up-to-date with the kernel.

The project started as the way to do live migration for OpenVZ Linux containers, but later grew to more sophisticated and flexible tool. It is currently used by (integrated into) OpenVZ, LXC/LXD, Docker, and other software, project gets tremendous help from the community, and its packages are included into many Linux distributions.

The project home is at http://criu.org. This wiki contains all the knowledge base for CRIU we have. Pages worth starting with are:

A video tour on basic CRIU features

CRIU introduction

Advanced features

As main usage for CRIU is live migration, there's a library for it called P.Haul. Also the project exposes two cool core features as standalone libraries. These are libcompel for parasite code injection and libsoccr for TCP connections checkpoint-restore.

Live migration

True live migration using CRIU is possible, but doing all the steps by hands might be complicated. The phaul sub-project provides a Go library that encapsulates most of the complexity.

Parasite code injection

In order to get state of the running process CRIU needs to make this process execute some code, that would fetch the required information. To make this happen without killing the application itself, CRIU uses the parasite code injection technique, which is also available as a standalone library called libcompel.

TCP sockets checkpoint-restore

One of the CRIU features is the ability to save and restore state of a TCP socket without breaking the connection. This functionality is considered to be useful by itself, and we have it available as the libsoccr library.

How to contribute

CRIU project is (almost) the never-ending story, because we have to always keep up with the Linux kernel supporting checkpoint and restore for all the features it provides. Thus we're looking for contributors of all kinds -- feedback, bug reports, testing, coding, writing, etc. Here are some useful hints to get involved.

Licence

The project is licensed under GPLv2 (though files sitting in the lib/ directory are LGPLv2.1).