summaryrefslogtreecommitdiff
path: root/doc/reference/tmpl/reaper.sgml
blob: 4c80438cdbda530c480b69ab9fda7ee299d96127 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
<!-- ##### 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
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.
</para>

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

</para>

<!-- ##### SECTION Stability_Level ##### -->


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


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

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

<!-- ##### FUNCTION vte_reaper_get ##### -->
<para>

</para>

@Returns: 


<!-- ##### FUNCTION vte_reaper_add_child ##### -->
<para>

</para>

@pid: 
@Returns: