Changes

Jump to navigation Jump to search
1,366 bytes added ,  05:36, 20 July 2012
no edit summary
Line 1: Line 1: −
== Command line syntax ==
+
== Synopsis ==
 +
<pre>
 +
'crtools' [-c] [-s] [-f <file>] [-d] [-n] [-o <path>] [-D <path>] [-v [num]] [--help] <command> (-p|-t) <pid>
 +
</pre>
   −
Syntax is pretty trivial one but partially context dependent.
+
== Description ==
 +
'crtools' is command line utility to steer checkpoint and restore procedure.
   −
<code>
+
== Options ==
  crtools [-c] [-D dir] (show|dump|restore) [-p|-t] $pid
+
<pre>
</code>
+
<command>::
 +
    One of the follwong commands
 +
        * 'dump'
 +
                to initiate checkpoint procedure
 +
        * 'restore'
 +
                to restore previously checkpointed processes
 +
        * 'show'
 +
                to decode binary dump files and show their contents in human
 +
                readable format
 +
        * 'check'
 +
                to test whether the kernel support is up-to-date
   −
* '''c''' - to continue execution of a task once checkpoint is complete in case of '''checkpointing''' stage, and show contents of memory pages in case of '''show''' stage
+
-c::
* '''D dir''' - write/read dump images to/from the specified directory
+
    In case of 'show' command the dumped pages content will be shown in hex format.
 +
    In case of 'dump' command processes being checkpointed wont be killed once
 +
    checkpoint complete but rather continue execution.
 +
 
 +
-D <path>::
 +
    Use path 'path' as a base directory where to look for dump files set. This
 +
    commands allpies to any <command>.
 +
 
 +
-s::
 +
    Leave tasks in stopped state after checkpoint instead of killing them.
 +
 
 +
-f <file>::
 +
    This option is valid for 'show' command only and allows to see content of
 +
    the <file> specified.
 +
 
 +
-p <pid>::
 +
    Checkpoint only one process specified by 'pid' instead of the whole process
 +
    tree.
 +
 
 +
-t <pid>::
 +
    Checkpoint the whole process tree starting from 'pid'.
 +
 
 +
-d::
 +
    Detach 'crtools' itself once restore is complete.
 +
 
 +
-n <ns>::
 +
    Checkpoint namespaces. Namespaces must be separated by comma.
 +
    Currently supported namespaces: uts, ipc.
 +
 
 +
-o <file>::
 +
    Write logging messages to 'file'.
 +
 
 +
-v <num>::
 +
    Set logging level to 'num'. Valid options are: 0 - (silent, error messages
 +
    only), 1 - informative (default), 2 - debug messages.
 +
</pre>

Navigation menu