DMTCP_RESTART(1)

📦 version 4.2.0, in arch rolling, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

💖 dmtcp_restart — bestie edition 💖

okay so this is the manual page for dmtcp_restart(1), part of Distributed MultiThreaded CheckPointing (DMTCP), and honestly? she's giving resurrection. like, bringing processes back from the dead energy. no cap. 🦋

✨ NAME ✨

dmtcp_restart — restart processes from given checkpoint images. that's it, that's the whole job, and she does it flawlessly. 💅

🌸 SYNOPSIS 🌸

dmtcp_restart [OPTIONS] ckpt1.dmtcp [ckpt2.dmtcp...]

🎀 DESCRIPTION 🎀

so basically dmtcp_restart restarts processes from the checkpoint image files you hand her. you give her the .dmtcp files, she gives you your processes back. iconic behavior, truly. 👑

also, important lil side quest: DMTCP also writes out a shell script for restarting all the processes. where does it live? by default it's written in the current directory of the coordinator. noted. 📝

💜 OPTIONS 💜

🔌 Connecting to the DMTCP Coordinator 🔌

  • -h, --coord-host hostname — (environment variable DMTCP_COORD_HOST) the hostname where dmtcp_coordinator is running. default: localhost. like, she's right there bestie, just say hi. 🫶
  • -p, --coord-port port — (environment variable DMTCP_COORD_PORT) the port where dmtcp_coordinator is running. default: 7779. remember it, love it. ✨
  • --port-file filename — file to write the listener port number to. (super useful with --port 0, which is the vibe you use to assign a random port.) 🎲
  • -j, --join — join an existing coordinator. if one doesn't already exist? she raises an error. no fake friends here, it's giving exclusive. 💀
  • --new-coordinator — create a new coordinator at the given port. fails if one already exists on that port. the port can be specified with --coord-port, or with the environment variable DMTCP_COORD_PORT. and if you specify no port at all? she starts the coordinator at a random port — same as specifying port '0'. surprise!! 🎉
  • -i, -interval seconds — (environment variable DMTCP_CHECKPOINT_INTERVAL) time in seconds between automatic checkpoints. 0 implies never (manual ckpt only, queen of self control). if it's not set and there's no env var, it uses the default value set in dmtcp_coordinator or dmtcp_command. not allowed if --join is specified. 🚫

🌈 Other options 🌈

  • --run-as-root — allow root to run dmtcp_restart and disable uid checking. (default: disabled). root privileges but make it permissive, i guess. 👑
  • --no-strict-uid-checking — (environment variable DMTCP_DISABLE_UID_CHECKING) disable uid checking for the checkpoint image. this means the checkpoint image can be restarted by a different user than the one who created it. sharing is caring fr fr. 🤝
  • --ckptdir path — (environment variable DMTCP_CHECKPOINT_DIR) directory to store checkpoint images. (default: use the same directory used in the previous checkpoint — she remembers where she was, loyal.) 🍓
  • --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 the environment variable DMTCP_QUIET = 0, 1, or 2) skip NOTE messages. if you give it twice, she also skips WARNINGs. shhh bestie, we're being mysterious. 🤫
  • --help — print this message and exit. bestie behavior: always show the menu. 📜
  • --version — print version information and exit. 🏷️

😭 REPORTING BUGS 😭

found a bug? spill the tea 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)

the whole friend group. go read them all, iykyk. 💖

🫶 AUTHOR 🫶

see /usr/share/doc/dmtcp-3.0.0/AUTHORS. the legends themselves. 🌟

⭐ VERSION ⭐

DMTCP version 3.0.0 of November, 2017.

see the /usr/share/doc/dmtcp-3.0.0/COPYING file.

License LGPLv3+: GNU LGPL version 3 or later, <http://gnu.org/licenses/lgpl.html>.

this program comes with ABSOLUTELY NO WARRANTY. it is free software, and you are welcome to redistribute it under certain conditions; see the COPYING file for details.

and that's the whole page, bestie!! 💅 this was dmtcp_restart(1) from Distributed MultiThreaded CheckPointing, version 3.0.0, dated November, 2017 — so like, vintage but still serving. slay, periodt. 🎀✨💜

📦 where this page comes from