*CHECKPOINTCTL-PLUGIN*(1)

📦
version 1.7.0 · 3 versions
, in fedora 43, fedora 44

💖 CHECKPOINTCTL-PLUGIN 💖

okay bestie, welcome to the checkpointctl-plugin page from the CHECKPOINTCTL manual ✨ this is literally the guide to managing checkpointctl plugins and it's lowkey adorable how simple it is 🎀

🌸 NAME 🌸

checkpointctl-plugin — manage checkpointctl plugins 💅

✨ SYNOPSIS ✨

checkpointctl plugin COMMAND

🦋 DESCRIPTION 🦋

so the checkpointctl plugin command is the one that manages external plugins — little add-ons that extend checkpointctl with extra subcommands 🫶

Plugins are standalone executables that live in PATH, and their names have to match the pattern checkpointctl-<name>. When checkpointctl starts up, it goes and discovers these plugins and registers them as subcommands, no cap 👑 So like, if checkpointctl-foo exists in PATH, boom, it becomes available as checkpointctl foo.

The whole point of this plugin architecture? Extending checkpointctl's functionality without making the core tool's binary size grow 🌈 And the best part — plugins can be implemented in any programming language. literally any. go feral 🧚

🎀 COMMANDS 🎀

  • list — List all available plugins discovered in PATH. ✨

💜 PLUGIN DEVELOPMENT 💜

To create a plugin, here's the lil ritual 🌟

  1. Create an executable named checkpointctl-<name> (e.g., checkpointctl-hello)
  2. Place it in a directory included in PATH
  3. Make it executable (chmod +x)

🌸 Plugin Description 🌸

Plugins can provide a description that shows up in checkpointctl --help by supporting the --plugin-description flag 🫶 And here's the lil secret: the plugin must exit with code 42 to indicate that it supports this flag:

#!/bin/sh
if [ "$1" = "--plugin-description" ]; then
    echo "My plugin description"
    exit 42
fi
# Normal plugin logic here
bestie listen — if a plugin does not exit with code 42 when it gets called with --plugin-description, then a default description showing the plugin path gets used instead. so 42 is the magic number, iykyk 💫

💅 OPTIONS 💅

  • -h, --help — Show help for checkpointctl plugin 😌

🔥 EXAMPLES 🔥

List available plugins:

$ checkpointctl plugin list

Run a plugin (assuming checkpointctl-hello exists in PATH):

$ checkpointctl hello

🌈 SEE ALSO 🌈

👑 AUTHOR 👑

The CRIU team 💖

and that's the whole page bestie, slay ✨ this was checkpointctl, dated 2026-10-19, from the CHECKPOINTCTL manual — go forth and plugin, you absolute icon 🎀🦋💅

📦 where this page comes from