xenial (1) dmtcp_checkpoint.1.gz

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.