[CRIU] [PATCH 4/4] criu2text: add README
Ruslan Kuprieiev
kupruser at gmail.com
Fri Sep 19 06:53:13 PDT 2014
Some notes about how to build, use and test criu2text.
Wiki page is comming soon.
Signed-off-by: Ruslan Kuprieiev <kupruser at gmail.com>
---
tools/criu2text/README | 51 ++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 51 insertions(+)
create mode 100644 tools/criu2text/README
diff --git a/tools/criu2text/README b/tools/criu2text/README
new file mode 100644
index 0000000..f05c1d7
--- /dev/null
+++ b/tools/criu2text/README
@@ -0,0 +1,51 @@
+criu2text
+
+Convert criu images to/from set of files in human-readable format
+
+Building:
+ Specify PROTOBUF_DIR, MAGIC_C_HEADER and CRIU
+ variables in Makefile if you are building
+ criu2text not from criu/tools/criu2text.
+
+ Run:
+ make
+ to generate magic.py and compile needed
+ protobuf messages.
+
+ Run:
+ make test
+ to dump simple loop and convert it's images
+ to text and back and compare them bit by bit.
+
+ Run:
+ make clean
+ to cleanup.
+
+Usage:
+ criu2text [-h] [-o OUT] {to-text,to-img} image
+
+ positional arguments:
+ {to-text,to-img} to what type convert input file(s)
+ image path to criu image or base path to criu image
+ files in human-readable format (e.g. ./imgs/core-1234.img)
+
+ optional arguments:
+ -h, --help show this help message and exit
+ -o OUT, --out OUT directory where output file(s) should be placed
+
+ Examples:
+ 1) Convert ./core-1234.img to set of text files (core-1234.img.magic,
+ core-1234.img.0) and place them at text_imgs_dir.
+
+ $ criu2text to-text core-1234.img -o text_imgs_dir
+ $ ls text_imgs_dir
+ core-1234.img.magic
+ core-1234.img.0
+
+ 2) Convert text_imgs_dir/core-1234.img.magic, text_imgs_dir/core-1234.img.0
+ (note common base text_imgs_dir/core-1234.img, which we're specifying)
+ to criu img format and place it at imgs_dir.
+
+ $ criu2text to-img text_imgs_dir/core-1234.img -o imgs_dir
+ $ ls imgs_dir
+ core-1234.img
--
1.9.3
More information about the CRIU
mailing list