DTTERMSUBPROCREAP(3)

💖 NAME 💖

DtTermSubprocReap is the main character here, and yes bestie, this is a library call page. It lets a DtTerm widget clean up after subprocess termination. 💅

✨ SYNOPSIS ✨

#include &<Dt/Term.h>
void DtTermSubprocReap(
pid_t pid,
int *stat_loc);

🦋 DESCRIPTION 🦋

The DtTermSubprocReap function lets DtTerm widgets function correctly in applications that have installed a SIGCHLD signal handler. Lowkey essential if you're doing your own signal-handler thing and still want the widget to behave. ✨

• The pid argument specifies the process ID of the child process wait(2) returns.
• The stat_loc argument specifies the termination information wait(2) returns.

🎀 RETURN VALUES 🎀

The DtTermSubprocReap function returns no value. That's it — no return-value drama, bestie. 🫶

🌸 APPLICATION USAGE 🌸

The DtTermSubprocReap function allows an application to install its own SIGCHLD signal handler.

Here's the important stuff, no cap:

• The application must install its own SIGCHILD signal handler and call DtTermSubprocReap if the DtTerm widget was created with the DtSubprocessTerminatorCatch resource set to False.
• The application must call the DtTermSubprocReap function after performing a wait(2) (or associated function) on a terminated child process.
• If the child process is associated with a DtTerm widget, the widget's data structures are cleaned up and the associated callbacks invoked.

spelling tea: this page uses SIGCHLD in the description and SIGCHILD in application usage. I'm keeping both exactly as written — signal names are not a place to freestyle, bestie. 🫶

🔥 SEE ALSO 🔥

You already know the cross-refs: Dt/Term.h — DtTerm(5), DtTerm(3), signal(5), wait(2).

---

That's the whole page, bestie! Footer note: this copy only carries the library call footer label — there's no extra source/version or date info to report, so no invented metadata, periodt. 🌈