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¶
- -h, --host hostname (environment
variable DMTCP_HOST)
-
Hostname where dmtcp_coordinator is run (default: localhost)
- -p, --port port (environment variable
DMTCP_PORT)
-
Port where dmtcp_coordinator is run (default: 7779)
- --port-file filename
-
File to write listener port number. (Useful with --port 0, which is
used to assign a random port)
- -j, --join
-
Join an existing coordinator, raise error if one doesn't already exist
- --new-coordinator
-
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').
- --no-coordinator
-
Execute the process in stand-alone coordinator-less mode.
Use dmtcp_command or --interval to request checkpoints.
- -i, -interval seconds (environment
variable DMTCP_CHECKPOINT_INTERVAL)
-
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¶
- --gzip, --no-gzip (environment variable
DMTCP_GZIP=[01])
-
Enable/disable compression of checkpoint images (default: 1 (enabled))
WARNING: gzip adds seconds. Without gzip, ckpt is often < 1s
- --ckptdir path (environment variable
DMTCP_CHECKPOINT_DIR)
-
Directory to store checkpoint images (default: curr dir at launch)
- --ckpt-open-files
-
Checkpoint open files and restore old working dir. (default: do
neither)
- --checkpoint-open-files
-
Deprecated. Use --ckpt-open-files instead.
- --ckpt-signal signum
-
Signal number used internally by DMTCP for checkpointing (default: 12)
- --mtcp-checkpoint-signal signum
-
Deprecated. Use --ckpt-signal instead.
Enable/disable plugins¶
- --with-plugin plugins (environment variable
DMTCP_PLUGIN)
-
Colon-separated list of DMTCP plugins to be preloaded with DMTCP. (Absolute
pathnames are required.)
- --batch-queue, --rm
-
Enable support for resource managers (Torque PBS and SLURM). (default:
disabled)
- --ptrace
-
Enable support for PTRACE system call for gdb/strace etc. (default:
disabled)
- --modify-env
-
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)
- --ib, --infiniband
-
Enable InfiniBand plugin. (default: disabled)
- --disable-alloc-plugin (environment variable
DMTCP_ALLOC_PLUGIN=[01])
-
Disable alloc plugin (default: enabled).
- --disable-dl-plugin (environment variable
DMTCP_DL_PLUGIN=[01])
-
Disable dl plugin (default: enabled).
- --disable-all-plugins (EXPERTS ONLY, FOR
DEBUGGING)
-
Disable all plugins.
Other options¶
- --prefix path
-
Prefix where DMTCP is installed on remote nodes.
- --tmpdir path (environment variable
DMTCP_TMPDIR)
-
Directory to store temporary files (default: $TMDPIR/dmtcp-$USER@$HOST or
/tmp/dmtcp-$USER@$HOST)
- -q, --quiet (or set environment variable
DMTCP_QUIET = 0, 1, or 2)
-
Skip NOTE messages; if given twice, also skip WARNINGs
- --help
-
Print this message and exit.
- --version
-
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.