Skip to content
Checkpoint/Restore tool
Branch: criu-dev
Clone or download
Zhang Ning and avagin criu/clone: stack size is too small for Android
stack for clone is too small, child process will get
wild pointer, and segfault.

Error (criu/cr-restore.c:1418): 6082 killed by signal 11: Segmentation fault
Error (criu/cr-restore.c:2303): Restoring FAILED.

enlarge stack size to 1024, then no segfault.

Cc: Chen Hu <>
Signed-off-by: Zhang Ning <>
Signed-off-by: Andrei Vagin <>
Latest commit 01ac03d Apr 18, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
Documentation Add notes for Android NDK cross compile Apr 5, 2019
compel add Hygon CPU Vendor ID("HygonGenuine") checking in compel_cpuid() Apr 17, 2019
contrib scripts/install-debian-packages: add libnl-route-3-dev May 10, 2017
crit crit: enable python2 or python3 based crit Jul 9, 2018
criu criu/clone: stack size is too small for Android Apr 20, 2019
images rpc: reserve number for --check-mounts feature Apr 9, 2019
lib Convert spaces to tabs Apr 17, 2019
scripts Define CC if not set to 'default' Apr 20, 2019
test test: socket_udplite -- Test shudowned sockets Apr 20, 2019
.gitignore crit: enable python2 or python3 based crit Jul 9, 2018
.mailmap repo: Add mailmap file Mar 25, 2012
.travis.yml travis-ci: Enable ia32 tests Apr 11, 2019
COPYING COPYING: fix a typo in a preamble Aug 11, 2016
CREDITS Add the CREDITS file Jul 30, 2012 Makefile.install: rm unused vars/target Feb 6, 2017
Makefile.compel compel: Make sure the hostprog is built early Oct 30, 2018
Makefile.config Makefile.config: don't silent twice Jan 24, 2019
Makefile.install Make the Makefile variables externally configurable. Aug 15, 2017
Makefile.versions Bump SONAME to 2 Apr 17, 2019 readme: Update asciinema demo Mar 8, 2019

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 This wiki contains all the knowledge base for CRIU we have. Pages worth starting with are:

Checkpoint and restore of simple loop process

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. This library and the Go bindings for CRIU are stored in the go-criu repository.

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.


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

You can’t perform that action at this time.