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> |