dmtcp_launch1

Connecting to the DMTCP Coordinator

--port-file filename

File to write listener port number. (Useful with --coord-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 --coord-port, or with environment variable DMTCP_COORD_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)

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

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

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.