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

OPTIONS

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

REPORTING BUGS

122       Report bugs to: dmtcp-forum@lists.sourceforge.net
123       DMTCP home page: <http://dmtcp.sourceforge.net>
124

SEE ALSO

126       dmtcp(1),  dmtcp_coordinator(1),   dmtcp_launch(1),   dmtcp_restart(1),
127       dmtcp_command(1)
128

AUTHOR

130       See /usr/share/doc/dmtcp-2.5.2/AUTHORS.
131

VERSION

133       DMTCP version 2.5.2 of November, 2017.
134

136       See /usr/share/doc/dmtcp-2.5.2/COPYING file.
137
138       License     LGPLv3+:     GNU     LGPL     version     3     or    later
139       <http://gnu.org/licenses/lgpl.html>.
140
141       This program comes with ABSOLUTELY NO WARRANTY.  This is free software,
142       and  you  are  welcome to redistribute it under certain conditions; see
143       COPYING file for details.
144
145Distributed MultiThreaded CheckPoNionvteimnbger, 2017                 DMTCP_LAUNCH(1)
Impressum