reaper.sgml 1.26 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
<!-- ##### SECTION Title ##### -->
VteReaper

<!-- ##### SECTION Short_Description ##### -->
A singleton object which catches %SIGCHLD signals and converts them into
GObject-style &quot;child-exited&quot; signals.

<!-- ##### SECTION Long_Description ##### -->
<para>
Because an application may need to be notified when child processes
exit, and because there is only one %SIGCHLD handler, the #VteTerminal
widget relies on a #VteReaper to watch for %SIGCHLD notifications and
13 14 15
retrieve the exit status of child processes which have exited.  When
glib provides child_watch functionality, the #VteReaper merely acts as
a proxy for glib's own functionality.
16 17 18 19 20 21 22 23 24
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### STRUCT VteReaper ##### -->
<para>
25
This should not be accessed directly.
26 27 28
</para>


29
<!-- ##### SIGNAL VteReaper::child-exited ##### -->
30
<para>
31
Emitted when the #VteReaper object detects that a child of the current process has exited.
32 33
</para>

34 35
@vtereaper: the object which received the signal.
@arg1: the process ID of the exited child.
36
@arg2: the status of the exited child, as returned by waitpid().
37

38
<!-- ##### FUNCTION vte_reaper_get ##### -->
39 40 41 42
<para>

</para>

43 44
@Returns: 

45

46 47 48 49 50 51 52 53 54
<!-- ##### FUNCTION vte_reaper_add_child ##### -->
<para>

</para>

@pid: 
@data: