dmtcp_launch(1)

1DMTCP_LAUNCH(1)    Distributed MultiThreaded CheckPointing     DMTCP_LAUNCH(1)
2
3
4

NAME

6       dmtcp_launch -- launch a process under DMTCP control.
7

SYNOPSIS

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

DESCRIPTION

12       dmtcp_launch launches a process under DMTCP control.
13
14       A typical usage is:
15         rm ckpt_a.out_*.dmtcp # Remove any stale copies of ckpt image
16         dmtcp_launch --interval 5 a.out
17         dmtcp_command --checkpoint # Execute this in another window
18         #Kill the currently running a.out process
19         dmtcp_restart ckpt_a.out_*.dmtcp
20

OPTIONS

22   Connecting to the DMTCP Coordinator
23       -h, --coord-host hostname (environment variable DMTCP_COORD_HOST)
24               Hostname where dmtcp_coordinator is run (default: localhost)
25
26       -p, --coord-port port (environment variable DMTCP_COORD_PORT)
27               Port where dmtcp_coordinator is run (default: 7779)
28
29       --port-file filename
30               File  to write listener port number.  (Useful with --coord-port
31              0, which is used to assign a random port)
32
33       -j, --join
34               Join an existing coordinator, raise error if  one  doesn't  al‐
35              ready exist
36
37       --new-coordinator
38               Create a new coordinator at the given port. Fail if one already
39              exists on the given port. The port can be specified  with  --co‐
40              ord-port,  or with environment variable DMTCP_COORD_PORT.  If no
41              port is specified, start coordinator at a random port  (same  as
42              specifying port '0').
43
44       --no-coordinator
45               Execute the process in stand-alone coordinator-less mode.
46              Use dmtcp_command or --interval to request checkpoints.
47
48       -i, --interval seconds (environment variable DMTCP_CHECKPOINT_INTERVAL)
49               Time in seconds between automatic checkpoints.  0 implies never
50              (manual ckpt only); if not set and no env var, use default value
51              set  in  dmtcp_coordinator  or  dmtcp_command.   Not  allowed if
52              --join is specified
53
54   Checkpoint image generation
55       --gzip, --no-gzip (environment variable DMTCP_GZIP=[01])
56               Enable/disable compression of  checkpoint  images  (default:  1
57              (enabled))
58              WARNING: gzip adds seconds. Without gzip, ckpt is often < 1s
59
60       --ckptdir path (environment variable DMTCP_CHECKPOINT_DIR)
61               Directory  to  store  checkpoint  images  (default: curr dir at
62              launch)
63
64       --ckpt-open-files
65               Checkpoint open files and restore old working dir. (default: do
66              neither)
67
68       --checkpoint-open-files
69               Deprecated. Use --ckpt-open-files instead.
70
71       --ckpt-signal signum
72               Signal  number  used internally by DMTCP for checkpointing (de‐
73              fault: 12)
74
75       --ckpt-signal signum
76               Deprecated. Use --ckpt-signal instead.
77
78   Enable/disable plugins
79       --with-plugin plugins (environment variable DMTCP_PLUGIN)
80               Colon-separated list of DMTCP  plugins  to  be  preloaded  with
81              DMTCP.  (Absolute pathnames are required.)
82
83       --batch-queue, --rm
84               Enable  support  for  resource managers (Torque PBS and SLURM).
85              (default: disabled)
86
87       --ptrace
88               Enable support for PTRACE system call for gdb/strace etc.  (de‐
89              fault: disabled)
90
91       --modify-env
92               Update  environment  variables  based on the environment on the
93              restart host (e.g., DISPLAY=$DISPLAY). This can be set in a file
94              dmtcp_env.txt.  (default: disabled)
95
96       --ib, --infiniband
97               Enable InfiniBand plugin. (default: disabled)
98
99       --disable-alloc-plugin (environment variable DMTCP_ALLOC_PLUGIN=[01])
100               Disable alloc plugin (default: enabled).
101
102       --disable-dl-plugin (environment variable DMTCP_DL_PLUGIN=[01])
103               Disable dl plugin (default: enabled).
104
105       --disable-all-plugins (EXPERTS ONLY, FOR DEBUGGING)
106               Disable all plugins.
107
108   Other options
109       --prefix path
110               Prefix where DMTCP is installed on remote nodes.
111
112       --tmpdir path (environment variable DMTCP_TMPDIR)
113               Directory    to   store   temporary   files   (default:   $TMD‐
114              PIR/dmtcp-$USER@$HOST or /tmp/dmtcp-$USER@$HOST)
115
116       -q, --quiet (or set environment variable DMTCP_QUIET = 0, 1, or 2)
117               Skip NOTE messages; if given twice, also skip WARNINGs
118
119       --help
120               Print this message and exit.
121
122       --version
123               Print version information and exit.
124

REPORTING BUGS

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

AUTHOR

134       See /usr/share/doc/dmtcp-2.6.0/AUTHORS.
135

VERSION

137       DMTCP version 2.6.0 of July, 2019.
138

COPYRIGHT

140       See /usr/share/doc/dmtcp-2.6.0/COPYING file.
141
142       License  LGPLv3+:  GNU  LGPL  version  3  or  later <http://gnu.org/li‐
143       censes/lgpl.html>.
144
145       This program comes with ABSOLUTELY NO WARRANTY.  This is free software,
146       and  you  are  welcome to redistribute it under certain conditions; see
147       COPYING file for details.
148
149Distributed MultiThreaded CheckPoinJtuilnyg, 2019                   DMTCP_LAUNCH(1)