PIUPARTS_SLAVE_RUN(8)

📦
version 1.6.0build1 · 4 versions
, in ubuntu resolute, ubuntu stonking

💅 PIUPARTS_SLAVE_RUN — the manual, bestie edition

okay so welcome to PIUPARTS_SLAVE_RUN(8), part of the Piuparts manual set. This is the lil launcher script that gets your piuparts-slave instance(s) up and running inside screen. Yes. Inside screen. We're doing this the cozy way. 🫶

✨ NAME ✨

piuparts_slave_run — start up piuparts-slave instance(s) in screen

🌸 SYNOPSIS 🌸

piuparts_slave_run ['SLAVE-NUMBERS']

💖 DESCRIPTION 💖

so basically, piuparts_slave_run spins up piuparts-slave instance(s) inside screen, and those slaves run piuparts tests. And what do piuparts tests do? They test whether Debian packages handle installation, upgrading, and removal correctly. That's the whole vibe. 👑

By default — no arguments, no stress — piuparts_slave_run starts up the number of slaves that the 'slave-count' parameter says to start, and that parameter lives in the piuparts.conf file. If 'slave-count' isn't defined at all? No worries, it just starts a single slave. One. Solo. Main character. ✨

Now if you do hand it a single argument — and that argument is a space-separated list of numbers, each one between 1 and 'slave-count' — then only those slaves get started. Cherry-picked. Curated. Slay. 🎀

💅 OPTIONS 💅

There are literally no options to this command right now. None. Zero. Nada. 🙈

but heads up bestie: this interface is under development and may change. so don't get too attached, okay? 😭

🦋 ENVIRONMENT 🦋

Running piuparts in master-slave mode requires configuration in /etc/piuparts. That's the spot. That's where the config lives. 📁✨

💀 BUGS 💀

piuparts_slave_run should be able to run slaves in different ways, and here's the wishlist, fr fr:

  1. all, in a new screen — and ngl, only this one is implemented at the moment 💀
  2. a specific one, in a specified screen slot in a (running) screen
  3. append one to a (running) screen using a "random" slot
  4. start slave in the current directory in the current shell in foreground

so yeah. one out of four. we're getting there. 🙈

🌈 NOTES 🌈

Make sure to also read /usr/share/doc/piuparts-master/README_server.txt. Like, actually read it. It's giving essential. 📖💜

👑 SEE ALSO 👑

  • piuparts (1)
  • piuparts_slave_join (8)
  • piuparts_slave_stop (8)
  • screen (1)

🍓 AUTHOR 🍓

Holger Levsen (<holger@layer-acht.org>)

okay that's the whole page, no cap. this was the PIUPARTS_SLAVE_RUN(8) page from the Piuparts source, dated Jan 27, 2026 — mwah, take care of yourself, hydrate, and go start some slaves in screen 💖🧚✨

📦 where this page comes from