Scroll to navigation

DMTCP_LAUNCH(1) Distributed MultiThreaded CheckPointing DMTCP_LAUNCH(1)

NAME

dmtcp_launch -- start a process under DMTCP control.

SYNOPSIS

dmtcp_launch [OPTIONS] <command> [args...]

DESCRIPTION

dmtcp_command is a tool to send user commands to the dmtcp_coordinator remotely.

OPTIONS

Connecting to the DMTCP Coordinator


Hostname where dmtcp_coordinator is run (default: localhost)

Port where dmtcp_coordinator is run (default: 7779)

File to write listener port number. (Useful with --port 0, which is used to assign a random port)

Join an existing coordinator, raise error if one doesn't already exist

Create a new coordinator at the given port. Fail if one already exists on the given port. The port can be specified with --port, or with environment variable DMTCP_PORT. If no port is specified, start coordinator at a random port (same as specifying port '0').

Execute the process in stand-alone coordinator-less mode.
Use dmtcp_command or --interval to request checkpoints.

Time in seconds between automatic checkpoints. 0 implies never (manual ckpt only); if not set and no env var, use default value set in dmtcp_coordinator or dmtcp_command. Not allowed if --join is specified

Checkpoint image generation


Enable/disable compression of checkpoint images (default: 1 (enabled))
WARNING: gzip adds seconds. Without gzip, ckpt is often < 1s

Directory to store checkpoint images (default: curr dir at launch)

Checkpoint open files and restore old working dir. (default: do neither)

Deprecated. Use --ckpt-open-files instead.

Signal number used internally by DMTCP for checkpointing (default: 12)

Deprecated. Use --ckpt-signal instead.

Enable/disable plugins


Colon-separated list of DMTCP plugins to be preloaded with DMTCP. (Absolute pathnames are required.)

Enable support for resource managers (Torque PBS and SLURM). (default: disabled)

Enable support for PTRACE system call for gdb/strace etc. (default: disabled)

Update environment variables based on the environment on the restart host (e.g., DISPLAY=$DISPLAY). This can be set in a file dmtcp_env.txt. (default: disabled)

Enable InfiniBand plugin. (default: disabled)

Disable alloc plugin (default: enabled).

Disable dl plugin (default: enabled).

Disable all plugins.

Other options


Prefix where DMTCP is installed on remote nodes.

Directory to store temporary files (default: $TMDPIR/dmtcp-$USER@$HOST or /tmp/dmtcp-$USER@$HOST)

Skip NOTE messages; if given twice, also skip WARNINGs

Print this message and exit.

Print version information and exit.

REPORTING BUGS

Report bugs to: dmtcp-forum@lists.sourceforge.net
DMTCP home page: <http://dmtcp.sourceforge.net>

SEE ALSO

dmtcp(1), dmtcp_coordinator(1), dmtcp_launch(1), dmtcp_restart(1), dmtcp_command(1)

AUTHOR

See /usr/share/doc/dmtcp-2.2/AUTHORS.

VERSION

DMTCP version 2.2 of March 2014.

COPYRIGHT

See /usr/share/doc/dmtcp-2.2/COPYING file.

License LGPLv3+: GNU LGPL version 3 or later <http://gnu.org/licenses/lgpl.html>.

This program comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions; see COPYING file for details.

March 2014 Distributed MultiThreaded CheckPointing