chpoxctl

Langue: en

Version: 07 January 2004 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

NAME

chpoxctl - control chpox system

SYNOPSIS

chpoxctl [ -h ] [ -d DEVICE ] [ -v ] command ...

DESCRIPTION

chpoxctl is used to configure chpox. It can registrer or derigister processes for checkpointing and manipulate by library list.

OPTIONS

-d, --dev=DEVICE
Use another device file instead of /proc/chpox/chpoxctl
-h, --help
Show help message and exit
-v, --verbose
Turn on verbose output

COMMANDS

add PID SIGNAL FLAGS FILE
Add process with given PID to the checkpoint list or change it's parameters. Process will be registered for checkpoint with given SIGNAL and FLAGS. Dump will be created as FILE. After registering process can be checkpointed as many times as needed by sending SIGNAL to it
del PID
Delete process with given PID from the checkpoint list
clear
Clear the checkpoint list
addlib FILE
Add FILE to the list of libraries
dellib FILE
Remove FILE from the list of libraries
clearlibs
Clear the libraries list
listlibs
List all registered libraries

CHECKPOINTING FLAGS

The FLAGS field of add command is the bit field. It's bits have the following mining (bits are numbered from 1):

bit 2
include executable file into dump
bit 3
include registered libraries into dump
bit 4
dump all child processes of the given one

EXAMPLES

Registration of process with pid 1234 for checkpointig with by 31(SIGSYS):

chpoxctl add 1234 31 1 /tmp/proc.dump

Registration of process with all it's child processes:

chpoxctl add 1234 31 9 /tmp/proc.dump

Checkpointing the process:

kill -31 1234

Unregistering of one process:

chpoxctl del 1234

Unregistering of all registered processes:

chpoxctl clear

Adding library to list:

chpoxctl addlib /lib/ld-linux.so.2

Removing one library from list:

chpoxctl dellib /lib/ld-linux.so.2

Removing all libraries from list:

chpoxctl clearlibs

Displaying list of registered libraries:

chpoxctl liblist

LICENSE

This program licensed under the GNU General Public License.

AVAILABILITY

The latest version of chpox can be found at
 <URL:http://www.cluster.kiev.ua/eng/tasks/chpx.html>

SEE ALSO

ld-chpox(1)

AUTHORS

Olexander O. Sudakov <csaa@univ.kiev.ua>

Eugeniy S. Meshcheryakov <eugen@univ.kiev.ua>