blob: 565292369ce9b131d37cbe15d2e72d2eda5242da (
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
58
59
60
61
62
63
64
65
66
67
|
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="en" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>user goetia-shutdown</title>
<meta name="Description" content="Script to tear down a user supervision tree." />
<meta name="Keywords" content="goetia s6 s6-rc shutdown user supervision tree" />
</head>
<header>
<p>
<a href="//0x53.net/software/goetia/goetia-base">goetia-base</a>
<br />
<a href="//0x53.net/software/goetia">goetia</a>
<br />
<a href="//0x53.net/software">Software</a>
<br />
<a href="//0x53.net">0x53.net</a>
</p>
</header>
<body>
<h1>The user goetia-shutdown service</h1>
<p>
The user goetia-shutdown service is used to tear down
<a href="//0x53.net/software/goetia/supervisiontree.html#user">user supervision trees</a>.
Upon being started it:
<ul>
<li>
It reads the <code>USER</code> environment variable,
if it is empty it exits 100.
</li>
<li>
It reads the <code>USERTREE</code> environment variable,
If it is empty it exits 100.
</li>
<li>
It checks whether the subdirectory
<code>${USER}/${USERTREE}</code>
of the
<a href="//0x53.net/software/goetia/rundir.html#user">user runtime directory</a>
exists. If not, meaning no user supervision tree is running, it exits 0.
</li>
<li>
It makes all of its stdout and stderr go to the
<a href="//0x53.net/software/goetia/goetia-base/service/user/s6-svscan-log.html">s6-svscan-log</a>
of the user supervision tree.
</li>
<li>
It stops all services managed by
<a href="https://skarnet.org/software/s6-rc/">s6-rc</a>.
</li>
<li>
It sends SIGHUP to s6-svscan-log of the user supervision tree.
This is important, since s6-svscan will keep the fifo open,
waiting for s6-svscan-log to exit, which in turn waits for
EOF before exiting itself.
SIGHUP tells s6-svscan-log to immediatly exit.
</li>
<li>
It tells
<a href="https://skarnet.org/software/s6/s6-svscan.html">s6-svscan</a>
to stop all remaining services and exit.
</li>
</ul>
</body>
</html>
|
