From b191244ea01bf15fa197c7f35dc8b0def022602c Mon Sep 17 00:00:00 2001 From: Cyrill Gorcunov Date: Tue, 30 Sep 2014 21:18:46 +0400 Subject: [PATCH] cpuinfo: Update documentation for --cpu-cap Signed-off-by: Cyrill Gorcunov Signed-off-by: Pavel Emelyanov --- Documentation/criu.txt | 25 ++++++++++++++++++++----- 1 file changed, 20 insertions(+), 5 deletions(-) diff --git a/Documentation/criu.txt b/Documentation/criu.txt index a1296f9b5..d2feb17d0 100644 --- a/Documentation/criu.txt +++ b/Documentation/criu.txt @@ -77,15 +77,30 @@ OPTIONS done with help of 'post-dump' script. In other words, do not use it until really needed. -*--cpu-cap* 'cap'[,'cap']:: +*--cpu-cap* [,'cap']:: When restore process require 'cap' CPU capability to be present. To inverse capability prefix it with '^'. - - *fpu*. Requre the CPU to have comaptible FPU. For example the process - might be dumped with xsave capability but attempted to restore - without it present on target cpu. In such case we refuse to procceed. + - 'all'. Require all capabilities. This is *default* mode if *--cpu-cap* + is passed without arguments. Most safe mode. - - *all*. Require all capability. This is *default* mode. + - 'cpu'. Require the CPU to have all capabilities match. On *dump* the + capabilities are writen into image file and on *restore* they + are validated to match ones present on runtime CPU. + + - 'fpu'. Requre the CPU to have comaptible FPU. For example the process + might be dumped with xsave capability but attempted to restore + without it present on target CPU. In such case we refuse to + procceed. This is *default* mode if *--cpu-cap* is not present + in command line. + + - 'none'. Ignore capabilities. Most dangerous mode. The behaviour is + implementation dependent. Try to not use it until really + required. One possible need of using this option is when + *--cpu-cap*='cpu' has been passed on *dump* then images are + migrated to a less capable processor and one need to *restore* + this application, by default *criu* will refuse to proceed without + relaxing capability with *--cpu-cap*='none' parameter. *-f*, *--file* 'file':: This option is valid for the *show* command only and allows one to see the