DtTermSubprocReap(UNIX System V (1 August 199DtTermSubprocReap(3)
NAME
DtTermSubprocReap - allow a DtTerm widget to clean up after
subprocess termination
SYNOPSIS
#include <Dt/Term.h>
void DtTermSubprocReap(pid_t pid,
int *stat_loc);
DESCRIPTION
The DtTermSubprocReap() function allows DtTerm widgets to
function correctly in applications that have installed a
SIGCHLD signal handler.
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.
APPLICATION USAGE
The DtTermSubprocReap() function allows an application to
install its own SIGCHLD signal handler.
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.
SEE ALSO
DtTerm(5), DtTerm(3); signal(5), wait(2).
Page 1 (printed 9/3/04)