File: dmtcp_restart.latex2man

package info (click to toggle)
dmtcp 2.6.0-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 6,496 kB
  • sloc: cpp: 33,592; ansic: 28,099; sh: 6,735; makefile: 1,950; perl: 1,690; python: 1,241; asm: 138; java: 13
file content (78 lines) | stat: -rw-r--r-- 3,254 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
\begin{Name}{1}{dmtcp\_restart}{Kapil Arya, Gene Cooperman, Rohan Garg, et al.}{Distributed MultiThreaded CheckPointing}{dmtcp\_restart --restart processes from ckpt image}
  \myProg{dmtcp\_restart} -- restart processes from given checkpoint images.
\end{Name}

\section{Synopsis}
%%%%%%%%%%%%%%%%%%

\myProg{dmtcp\_restart} \oArg{OPTIONS} \Arg{ckpt1.dmtcp} \oArg{ckpt2.dmtcp...}

\section{Description}
%%%%%%%%%%%%%%%%%%

\myProg{dmtcp\_restart} restarts processes from the given
checkpoint image files.  Note that DMTCP also writes out a shell script
for restarting all processes.  It is written in the current directory
of the coordinator by default.

\section{Options}
%%%%%%%%%%%%%%%%%%

\subsubsection{Connecting to the DMTCP Coordinator}
\begin{Description}
  \item[\Opt{-h}, \Opt{--coord-host} \Arg{hostname} (environment variable DMTCP\_COORD\_HOST)]
    Hostname where dmtcp\_coordinator is run (default: localhost)

  \item[\Opt{-p}, \Opt{--coord-port} \Arg{port} (environment variable DMTCP\_COORD\_PORT)]
    Port where dmtcp\_coordinator is run (default: 7779)

  \item[\OptSArg{--port-file}{filename}]
    File to write listener port number.
    (Useful with \Opt{--port 0}, which is used to assign a random port)

  \item[\Opt{-j}, \Opt{--join}]
    Join an existing coordinator, raise error if one doesn't
    already exist

  \item[\Opt{--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 \Opt{--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').

%  \item[\Opt{--no-coordinator}]
%    Execute the process in stand-alone coordinator-less mode.
%    Use dmtcp\_command or \Opt{--interval} to request checkpoints.

  \item[\Opt{-i}, \Opt{-interval} \Arg{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 \Opt{--join} is specified
\end{Description}

\subsubsection{Other options}
\begin{Description}
  \item[\Opt{--run-as-root}]
    Allow root to run dmtcp\_restart and disable uid checking.
    (default: disabled)

  \item[\Opt{--no-strict-uid-checking} (environment variable DMTCP\_DISABLE\_UID\_CHECKING)]
    Disable uid checking for the checkpoint image. This allows the checkpoint image
    to be restarted by a different user than the one that created it.

  \item[\OptSArg{--ckptdir}{path} (environment variable DMTCP\_CHECKPOINT\_DIR)]
    Directory to store checkpoint images (default: use the same directory used in previous checkpoint)

  \item[\OptSArg{--tmpdir}{path} (environment variable DMTCP\_TMPDIR)]
    Directory to store temporary files
    (default: \$TMDPIR/dmtcp-\$USER@\$HOST or /tmp/dmtcp-\$USER@\$HOST)

  \item[\Opt{-q}, \Opt{--quiet} (or set environment variable DMTCP\_QUIET = 0, 1, or 2)]
    Skip NOTE messages; if given twice, also skip WARNINGs

  \item[\Opt{--help}] Print this message and exit.

  \item[\Opt{--version}] Print version information and exit.
\end{Description}