SHTK_PROCESS_RUN(3)

✨ shtk_process_run(3) ✨ — the library functions manual bestie 💅

okay so this is the page for shtk_process_run(3) from the Library Functions Manual, and honestly? it's giving "run your command but make it safe" 🎀

---

🌸 NAME 🌸

shtk_process_run — runs a command inside a controlled environment, no cap ✨

📚 LIBRARY 📚

shtk_import run

like, that's the import you need. periodt 💜

🦋 SYNOPSIS 🦋

shtk_process_run [-t seconds] command [arg1 .. argN]

💖 DESCRIPTION 💖

okay so shtk_process_run executes the command you hand it — that's the command sitting at the front of the argument list, followed by however many args — and while it's doing that it logs stuff using the logging functions from shtk_cli(3). literally it logs two things: the invocation of the command, and its termination status. like a little paper trail, adorable 🫶

and optionally — optional, key word — shtk_process_run can enforce a maximum run time for the executed command. so if you pass -t, the executed command gets forcibly terminated with a KILL signal if its run time exceeds the seconds you gave. yeah. KILL. no chill. it's for its own good tho 💀

🌈 RETURN VALUES 🌈

shtk_process_run returns the exit code of the executed command. unless — if a timeout was provided and the command timed out, then it returns 127. that's the whole vibe check 😭

👀 SEE ALSO 👀

shtk(3), shtk_process(3)

go read those too bestie, iykyk 🦋

🎀 HISTORY 🎀

shtk_process_run first appeared in shtk 1.0.

the -t flag showed up later, in shtk 1.5. iconic glow-up honestly 👑

---

ngl the whole thing is very "i will run your command but i'm also timing it and i'm not afraid to use KILL" — main character energy fr fr 🔥

k bye, this was the Debian build from November 7, 2014, mwah 💋