processman(3tcl)

💖 processman — the girlies' guide to babysitting your child processes 💖

okay so bestie, welcome to the processman manual page, from the tcllib collection. this is the processman page (that's the manual name, she's iconic, she contains multitudes), and we're about to make process management feel like a group chat that actually works. pull up a chair. 🫶

---

✨ NAME ✨

processman — a tool for automating the period callback of commands. no cap, that's literally what it does. 💅

---

🌸 SYNOPSIS 🌸

package require Tcl 8.5 9

package require twapi 3.1

package require cron 1.1

package require processman ?0.8?

::processman::find_exe name

::processman::kill id

::processman::kill_all

::processman::killexe name

::processman::onexit id cmd

::processman::priority id level

::processman::process_list

::processman::process_list id

::processman::spawn id cmd args

like, look at her go. the whole roster. 🎀

---

🦋 DESCRIPTION 🦋

so the processman package serves up a Pure-tcl set of utilities for managing child processes, and it does it in a platform-generic nature. meaning: it works on Unix, it works on Windows, it does not care, she's versatile, she's adaptable, she's giving cross-platform main character energy. ✨

---

👑 COMMANDS 👑

::processman::find_exe name

locate an executable by the name of name in the system path. 💫

on windows, it also adds the .exe extension if you didn't already give it. thoughtful! considerate! we love a helper who anticipates your needs.

::processman::kill id

kill a child process id. that's it. that's the tweet. 💀

::processman::kill_all

kill all processes spawned by this program. every last one. absolutely no survivors. 🔥

::processman::killexe name

kill a process identified by the executable.

• on Unix, this triggers a killall.
• on windows, twapi::get_process_ids is used to map a name to one or more IDs, which are then killed.

see how she handles both platforms? consistent queen behavior. 👑

::processman::onexit id cmd

arrange to execute the script cmd when this program detects that process id has terminated. it's like setting a little alarm that goes off when your child process finally leaves the group chat. 😭

::processman::priority id level

mark process id with the priority level.

valid levels are: low, high, default.

• on Unix, the process is tagged using the nice command.
• on Windows, the process is modified via the twapi::set_priority_class.

giving your processes a lil rank. low, high, default. it's giving hierarchy, it's giving order, it's giving balance. 🧚

::processman::process_list

return a list of processes that have been triggered by this program, plus a boolean flag to indicate if the process is still running. a full roll call. 📋

::processman::process_list id

return true if process id is still running, and false otherwise. simple. clean. a vibe check for one specific process. ✅

::processman::spawn id cmd args

start a child process, identified by id.

• cmd is the name of the command to execute.
• args are arguments to pass to that command.

congratulations, you're a parent now. 🌈

---

🙈 BUGS, IDEAS, FEEDBACK 🙈

ngl, this document and the package it describes will undoubtedly contain bugs and other problems. like, it's software, bestie, of course it does. 😭

please report such bugs in the category odie of the Tcllib Trackers at [http://core.tcl.tk/tcllib/reportlist].

also please report any ideas for enhancements you may have for either the package and/or the documentation. we want the ideas. give us the ideas. 🫶

when proposing code changes, please provide unified diffs, i.e. the output of diff -u.

note further that attachments are strongly preferred over inlined patches. attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar. go forth and attach. 📎✨

---

⭐ KEYWORDS ⭐

odie, processman

---

🎀 CATEGORY 🎀

System

---

💜 COPYRIGHT 💜

Copyright (c) 2015 Sean Woods <yoda@etoyoc.com>

---

and that's the whole page, bestie. tcllib, version 0.8, and this manual page's date — the processman(3tcl) footer — all wrapped up in one lil sign-off. thanks for reading, mwah, go manage those processes responsibly. 💅✨🦋