PROCESS(nged)

💅 PROCESS(nged) — the subprocess wrangler ✨

okay so this is process, a command from the BRL-CAD MGED Commands manual, and honestly bestie it's giving "air traffic controller for your runaway ray tracers" 🛬✨

---

🌸 NAME

process — list and manage the subprocesses that are currently running. fr fr it's your little subprocess dashboard 💖

---

🎀 SYNOPSIS

process

process list

process pabort {pid}

process gabort {glob}

literally that's it, four little forms, no cap 🫶

---

🦋 DESCRIPTION

so the way that process works is it gives you a program-agnostic way to manage subprocesses that a GED application has launched 👑. The most common case of this whole phenomenon is long-running rt commands on big models, but bestie there are other commands too — things like rtcheck — that also operate in this asynchronous way ⭐.

and like… if one of those processes is running wayyyyy too long or eating too many resources, process lets you identify them and stop them right from the GED command line 💅 periodt.

---

🔥 EXAMPLES

the examples below walk you through a whole sample process workflow, slay:

✨ Example 1. Process Help

mged>process

    Usage: process [subcommand]

    Subcommands:

      list          - List all currently running subprocesses.
      pabort <pid>  - Abort the specified subprocess.

      gabort <glob> - Abort all subprocesses whose command matches the glob expression.

look at that usage text serving main character energy 🌈

💜 Example 2. List Currently Running Processes

mged>process list

        PID CMD
    5524692 rt -M -u model /home/user/test.g
    6515118 rtcheck -M /home/user/test.g obj

the way you get a PID column and a CMD column, iconic 😭💖

🧚 Example 3. Eliminate a Running Subprocess

mged>process pabort 6515118

using the reported PID from process list, that line right there terminates the rtcheck subprocess 🎀 bye bestie 👋

---

👑 AUTHOR

BRL-CAD Team 💜

---

🍓 BUG REPORTS

if you find bugs or problems, please submit reports via electronic mail to devs@brlcad.org 📧

---

⚠️ quick vibe check: those PIDs in the examples are literal — copy the real one from your process list output before you pabort it, or you'll be aborting the wrong little guy 🙈

---

and that's the whole page bestie! this one came from the BRL-CAD manual collection, page PROCESS(nged) — dated in the footer only as BRL-CAD, no version number or date beyond that, so don't come for me about timestamps 🫶✨