dmtcp_launch −− start a process under DMTCP control.
dmtcp_launch [OPTIONS] <command> [args...]
dmtcp_command is a tool to send user commands to the dmtcp_coordinator remotely.
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.
Report bugs to: dmtcp−forum AT lists DOT sourceforge DOT net
DMTCP home page: <http://dmtcp.sourceforge.net>
dmtcp(1), dmtcp_coordinator(1), dmtcp_launch(1), dmtcp_restart(1), dmtcp_command(1)
See /usr/share/doc/dmtcp−2.2/AUTHORS.
DMTCP version 2.2 of March 2014.
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.