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
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="generator" content="AsciiDoc 8.6.8">
<title>LocalRef</title>
<link rel="stylesheet" href="./asciidoc.css" type="text/css">
<link rel="stylesheet" href="./pygments.css" type="text/css">
<script type="text/javascript" src="./asciidoc.js"></script>
<script type="text/javascript">
/*<![CDATA[*/
asciidoc.install();
/*]]>*/
</script>
<link rel="stylesheet" href="./mlton.css" type="text/css"/>
</head>
<body class="article">
<div id="banner">
<div id="banner-home">
<a href="./Home">MLton 20130715</a>
</div>
</div>
<div id="header">
<h1>LocalRef</h1>
</div>
<div id="content">
<div id="preamble">
<div class="sectionbody">
<div class="paragraph"><p><a href="LocalRef">LocalRef</a> is an optimization pass for the <a href="SSA">SSA</a>
<a href="IntermediateLanguage">IntermediateLanguage</a>, invoked from <a href="SSASimplify">SSASimplify</a>.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_description">Description</h2>
<div class="sectionbody">
<div class="paragraph"><p>This pass optimizes <span class="monospaced">ref</span> cells local to a <a href="SSA">SSA</a> function:</p></div>
<div class="ulist"><ul>
<li>
<p>
global <span class="monospaced">ref</span>-s only used in one function are moved to the function
</p>
</li>
<li>
<p>
<span class="monospaced">ref</span>-s only created, read from, and written to (i.e., don’t escape)
are converted into function local variables
</p>
</li>
</ul></div>
<div class="paragraph"><p>Uses <a href="Multi">Multi</a> and <a href="Restore">Restore</a>.</p></div>
</div>
</div>
<div class="sect1">
<h2 id="_implementation">Implementation</h2>
<div class="sectionbody">
<div class="ulist"><ul>
<li>
<p>
<a href="https://github.com/MLton/mlton/blob/master/mlton/ssa/local-ref.fun"><span class="monospaced">local-ref.fun</span></a>
</p>
</li>
</ul></div>
</div>
</div>
<div class="sect1">
<h2 id="_details_and_notes">Details and Notes</h2>
<div class="sectionbody">
<div class="paragraph"><p>Moving a global <span class="monospaced">ref</span> requires the <a href="Multi">Multi</a> analysis, because a
global <span class="monospaced">ref</span> can only be moved into a function that is executed at
most once.</p></div>
<div class="paragraph"><p>Conversion of non-escaping <span class="monospaced">ref</span>-s is structured in three phases:</p></div>
<div class="ulist"><ul>
<li>
<p>
analysis — a variable <span class="monospaced">r = Ref_ref x</span> escapes if
</p>
<div class="ulist"><ul>
<li>
<p>
<span class="monospaced">r</span> is used in any context besides <span class="monospaced">Ref_assign (r, _)</span> or <span class="monospaced">Ref_deref r</span>
</p>
</li>
<li>
<p>
all uses <span class="monospaced">r</span> reachable from a (direct or indirect) call to <span class="monospaced">Thread_copyCurrent</span> are of the same flavor (either <span class="monospaced">Ref_assign</span> or <span class="monospaced">Ref_deref</span>); this also requires the <a href="Multi">Multi</a> analysis.
</p>
</li>
</ul></div>
</li>
<li>
<p>
transformation
</p>
<div class="openblock">
<div class="content">
<div class="ulist"><ul>
<li>
<p>
rewrites <span class="monospaced">r = Ref_ref x</span> to <span class="monospaced">r = x</span>
</p>
</li>
<li>
<p>
rewrites <span class="monospaced">_ = Ref_assign (r, y)</span> to <span class="monospaced">r = y</span>
</p>
</li>
<li>
<p>
rewrites <span class="monospaced">z = Ref_deref r</span> to <span class="monospaced">z = r</span>
</p>
</li>
</ul></div>
</div></div>
<div class="paragraph"><p>Note that the resulting program violates the SSA condition.</p></div>
</li>
<li>
<p>
<a href="Restore">Restore</a> — restore the SSA condition.
</p>
</li>
</ul></div>
</div>
</div>
</div>
<div id="footnotes"><hr></div>
<div id="footer">
<div id="footer-text">
</div>
<div id="footer-badges">
</div>
</div>
</body>
</html>
|
