Home My Page Projects Code Snippets Project Openings diderot
Summary Activity Tracker Tasks SCM

SCM Repository

[diderot] Annotation of /trunk/src/compiler/IL/ssa-fn.sml
ViewVC logotype

Annotation of /trunk/src/compiler/IL/ssa-fn.sml

Parent Directory Parent Directory | Revision Log Revision Log


Revision 319 - (view) (download)

1 : jhr 137 (* ssa-fn.sml
2 : jhr 124 *
3 :     * COPYRIGHT (c) 2010 The Diderot Project (http://diderot.cs.uchicago.edu)
4 :     * All rights reserved.
5 : jhr 137 *
6 :     * The IL is a combination of a block-structured tree and an SSA control-flow
7 :     * graph of blocks.
8 : jhr 124 *)
9 :    
10 : jhr 198 signature SSA =
11 :     sig
12 :    
13 :     structure Op : OPERATORS
14 :    
15 : jhr 256 (***** CFG *****)
16 : jhr 198
17 : jhr 256 datatype node = ND of {
18 :     id : Stamp.stamp,
19 :     props : PropList.holder,
20 :     kind : node_kind
21 : jhr 198 }
22 :    
23 : jhr 256 and node_kind
24 :     = NULL
25 :     | ENTRY of {
26 :     succ : node ref
27 :     }
28 :     | JOIN of {
29 :     preds : node list ref,
30 :     phis : (var * var list) list ref, (* phi statements *)
31 :     succ : node ref
32 :     }
33 :     | COND of {
34 :     pred : node ref,
35 :     cond : var,
36 :     trueBranch : node ref,
37 :     falseBranch : node ref
38 :     }
39 :     | BLOCK of {
40 :     pred : node ref,
41 :     body : assign list ref,
42 :     succ : node ref
43 :     }
44 :     | NEW of {
45 :     pred : node ref,
46 :     actor : Atom.atom,
47 :     args : var list,
48 :     succ : node ref
49 :     }
50 :     | DIE of {
51 :     pred : node ref
52 :     }
53 :     | STABILIZE of {
54 :     pred : node ref
55 :     }
56 :     | EXIT of {
57 :     pred : node ref
58 :     }
59 : jhr 198
60 : jhr 256 (***** Statements *****)
61 :    
62 : jhr 198 and stmt = STM of {
63 :     id : Stamp.stamp,
64 :     props : PropList.holder,
65 : jhr 256 kind : stmt_kind,
66 :     next : stmt option (* next statement at this structural level *)
67 : jhr 198 }
68 :    
69 :     and stmt_kind
70 : jhr 256 = S_SIMPLE of node (* ENTRY, JOIN, BLOCK, NEW, DIE, STABILIZE, or EXIT node *)
71 :     | S_IF of {
72 :     cond : node, (* COND node *)
73 : jhr 198 thenBranch : stmt,
74 :     elseBranch : stmt
75 :     }
76 : jhr 256 | S_LOOP of {
77 : jhr 198 hdr : stmt,
78 : jhr 256 cond : node, (* COND node *)
79 :     body : stmt
80 : jhr 198 }
81 :    
82 :     and rhs
83 :     = VAR of var
84 :     | LIT of Literal.literal
85 :     | OP of Op.rator * var list
86 :     | CONS of var list (* tensor-value construction *)
87 :    
88 :     and var = V of {
89 :     name : string, (* name *)
90 :     id : Stamp.stamp, (* unique ID *)
91 :     useCnt : int ref, (* count of uses *)
92 :     props : PropList.holder
93 :     }
94 :    
95 :     withtype assign = (var * rhs)
96 :    
97 : jhr 256 datatype program = Program of {
98 :     globals : var list,
99 :     globalInit : stmt,
100 :     actors : actor list
101 :     (* initialization *)
102 :     }
103 : jhr 198
104 : jhr 256 and actor = Actor of {
105 :     name : Atom.atom,
106 :     params : var list,
107 :     state : var list,
108 :     stateInit : stmt,
109 :     methods : method list
110 :     }
111 : jhr 198
112 : jhr 256 and method = Method of {
113 :     name : Atom.atom,
114 :     stateIn : var list, (* names of state variables on method entry *)
115 :     stateOut : var list, (* names of state variables on method exit *)
116 :     body : stmt (* method body *)
117 :     }
118 : jhr 198
119 : jhr 256 structure Node : sig
120 :     val same : node * node -> bool
121 :     val compare : node * node -> order
122 :     val hash : node -> word
123 :     val toString : node -> string
124 :     val preds : node -> node list
125 :     val setPred : node * node -> unit
126 :     val hasSucc : node -> bool
127 :     val succs : node -> node list
128 :     val setSucc : node * node -> unit
129 :     val setTrueBranch : node * node -> unit (* set trueBranch successor for COND node *)
130 :     val setFalseBranch : node * node -> unit (* set falseBranch successor for COND node *)
131 :     val addEdge : node * node -> unit
132 : jhr 283 (* properties *)
133 :     val newProp : (node -> 'a) -> {
134 :     getFn : node -> 'a,
135 :     peekFn : node -> 'a option,
136 :     setFn : node * 'a -> unit,
137 :     clrFn : node -> unit
138 :     }
139 :     val newFlag : unit -> {
140 :     getFn : node -> bool,
141 :     setFn : node * bool -> unit
142 :     }
143 : jhr 256 end
144 : jhr 198
145 : jhr 256 structure Stmt : sig
146 :     val same : stmt * stmt -> bool
147 :     val compare : stmt * stmt -> order
148 :     val hash : stmt -> word
149 :     val toString : stmt -> string
150 :     (* return the entry node of the statement *)
151 :     val entry : stmt -> node
152 :     (* return the tail-end node of a statement (not applicable to S_IF or S_LOOP) *)
153 :     val tail : stmt -> node
154 :     (* statement constructor functions *)
155 :     val mkENTRY : stmt option -> stmt
156 :     val mkJOIN : (var * var list) list * stmt option -> stmt
157 :     val mkIF : var * stmt * stmt * stmt option -> stmt
158 :     val mkBLOCK : assign list * stmt option -> stmt
159 :     val mkNEW : Atom.atom * var list * stmt option -> stmt
160 :     val mkDIE : unit -> stmt
161 :     val mkSTABILIZE : unit -> stmt
162 :     val mkEXIT : unit -> stmt
163 : jhr 283 (* properties *)
164 :     val newProp : (stmt -> 'a) -> {
165 :     getFn : stmt -> 'a,
166 :     peekFn : stmt -> 'a option,
167 :     setFn : stmt * 'a -> unit,
168 :     clrFn : stmt -> unit
169 :     }
170 :     val newFlag : unit -> {
171 :     getFn : stmt -> bool,
172 :     setFn : stmt * bool -> unit
173 :     }
174 : jhr 256 end
175 : jhr 198
176 : jhr 199 structure Var : sig
177 :     val new : string -> var
178 :     val same : var * var -> bool
179 :     val compare : var * var -> order
180 :     val hash : var -> word
181 :     val toString : var -> string
182 : jhr 283 (* properties *)
183 :     val newProp : (var -> 'a) -> {
184 :     getFn : var -> 'a,
185 :     peekFn : var -> 'a option,
186 :     setFn : var * 'a -> unit,
187 :     clrFn : var -> unit
188 :     }
189 :     val newFlag : unit -> {
190 :     getFn : var -> bool,
191 :     setFn : var * bool -> unit
192 :     }
193 :     (* collections *)
194 : jhr 199 structure Map : ORD_MAP where type Key.ord_key = var
195 :     structure Set : ORD_SET where type Key.ord_key = var
196 :     structure Tbl : MONO_HASH_TABLE where type Key.hash_key = var
197 :     end
198 : jhr 198
199 : jhr 319 (* DFS sorting of the graph rooted at the entry to a statement; the resulting list will
200 :     * be in preorder with parents before children.
201 :     *)
202 : jhr 257 val sortNodes : stmt -> node list
203 :    
204 : jhr 198 end
205 :    
206 :     functor SSAFn (Op : OPERATORS) : SSA =
207 : jhr 192 struct
208 : jhr 137
209 : jhr 192 structure Op = Op
210 : jhr 137
211 : jhr 256 datatype node = ND of {
212 :     id : Stamp.stamp,
213 :     props : PropList.holder,
214 :     kind : node_kind
215 : jhr 197 }
216 :    
217 : jhr 256 and node_kind
218 :     = NULL
219 :     | ENTRY of {
220 :     succ : node ref
221 :     }
222 :     | JOIN of {
223 :     preds : node list ref,
224 :     phis : (var * var list) list ref, (* phi statements *)
225 :     succ : node ref
226 :     }
227 :     | COND of {
228 :     pred : node ref,
229 :     cond : var,
230 :     trueBranch : node ref,
231 :     falseBranch : node ref
232 :     }
233 :     | BLOCK of {
234 :     pred : node ref,
235 :     body : assign list ref,
236 :     succ : node ref
237 :     }
238 :     | NEW of {
239 :     pred : node ref,
240 :     actor : Atom.atom,
241 :     args : var list,
242 :     succ : node ref
243 :     }
244 :     | DIE of {
245 :     pred : node ref
246 :     }
247 :     | STABILIZE of {
248 :     pred : node ref
249 :     }
250 :     | EXIT of {
251 :     pred : node ref
252 :     }
253 : jhr 197
254 : jhr 256 (***** Statements *****)
255 : jhr 197
256 :     and stmt = STM of {
257 : jhr 188 id : Stamp.stamp,
258 :     props : PropList.holder,
259 : jhr 256 kind : stmt_kind,
260 :     next : stmt option (* next statement at this structural level *)
261 : jhr 188 }
262 :    
263 : jhr 192 and stmt_kind
264 : jhr 256 = S_SIMPLE of node (* ENTRY, JOIN, BLOCK, NEW, DIE, STABILIZE, or EXIT node *)
265 :     | S_IF of {
266 :     cond : node, (* COND node *)
267 : jhr 192 thenBranch : stmt,
268 :     elseBranch : stmt
269 :     }
270 : jhr 256 | S_LOOP of {
271 : jhr 192 hdr : stmt,
272 : jhr 256 cond : node, (* COND node *)
273 :     body : stmt
274 : jhr 192 }
275 :    
276 : jhr 188 and rhs
277 :     = VAR of var
278 :     | LIT of Literal.literal
279 :     | OP of Op.rator * var list
280 :     | CONS of var list (* tensor-value construction *)
281 :    
282 : jhr 192 and var = V of {
283 : jhr 137 name : string, (* name *)
284 :     id : Stamp.stamp, (* unique ID *)
285 :     useCnt : int ref, (* count of uses *)
286 :     props : PropList.holder
287 : jhr 124 }
288 :    
289 : jhr 192 withtype assign = (var * rhs)
290 : jhr 188
291 : jhr 256 datatype program = Program of {
292 :     globals : var list,
293 :     globalInit : stmt,
294 :     actors : actor list
295 :     (* initialization *)
296 :     }
297 : jhr 188
298 : jhr 256 and actor = Actor of {
299 :     name : Atom.atom,
300 :     params : var list,
301 :     state : var list,
302 :     stateInit : stmt,
303 :     methods : method list
304 :     }
305 : jhr 188
306 : jhr 256 and method = Method of {
307 :     name : Atom.atom,
308 :     stateIn : var list, (* names of state variables on method entry *)
309 :     stateOut : var list, (* names of state variables on method exit *)
310 :     body : stmt (* method body *)
311 :     }
312 : jhr 188
313 : jhr 256 structure Node =
314 :     struct
315 :     fun same (ND{id=a, ...}, ND{id=b, ...}) = Stamp.same(a, b)
316 :     fun compare (ND{id=a, ...}, ND{id=b, ...}) = Stamp.compare(a, b)
317 :     fun hash (ND{id, ...}) = Stamp.hash id
318 :     fun toString (ND{id, kind, ...}) = let
319 :     val tag = (case kind
320 :     of NULL => "NULL"
321 :     | ENTRY _ => "ENTRY"
322 :     | JOIN _ => "JOIN"
323 :     | COND _ => "COND"
324 :     | BLOCK _ => "BLOCK"
325 :     | NEW _ => "NEW"
326 :     | DIE _ => "DIE"
327 :     | STABILIZE _ => "STABILIZE"
328 :     | EXIT _ => "EXIT"
329 :     (* end case *))
330 :     in
331 :     tag ^ Stamp.toString id
332 :     end
333 :     fun new kind = ND{id = Stamp.new(), props = PropList.newHolder(), kind = kind}
334 :     val dummy = new NULL
335 :     fun mkENTRY () = new (ENTRY{succ = ref dummy})
336 :     fun mkJOIN phis = new (JOIN{preds = ref [], phis = ref phis, succ = ref dummy})
337 :     fun mkCOND {cond, trueBranch, falseBranch} = new (COND{
338 :     pred = ref dummy, cond = cond,
339 :     trueBranch = ref trueBranch, falseBranch = ref falseBranch
340 :     })
341 :     fun mkBLOCK body = new (BLOCK{pred = ref dummy, body = ref body, succ = ref dummy})
342 :     fun mkNEW {actor, args} = new (NEW{
343 :     pred = ref dummy, actor = actor, args = args, succ = ref dummy
344 :     })
345 :     fun mkDIE () = new (DIE{pred = ref dummy})
346 :     fun mkSTABILIZE () = new (STABILIZE{pred = ref dummy})
347 :     fun mkEXIT () = new (EXIT{pred = ref dummy})
348 :     (* editing node edges *)
349 :     fun setPred (ND{kind, ...}, nd) = (case kind
350 :     of NULL => raise Fail "setPred on NULL node"
351 :     | ENTRY _ => raise Fail "setPred on ENTRY node"
352 :     | JOIN{preds, ...} => if List.exists (fn nd' => same(nd, nd')) (!preds)
353 :     then ()
354 :     else preds := nd :: !preds
355 :     | COND{pred, ...} => pred := nd
356 :     | BLOCK{pred, ...} => pred := nd
357 :     | NEW{pred, ...} => pred := nd
358 :     | DIE{pred} => pred := nd
359 :     | STABILIZE{pred} => pred := nd
360 :     | EXIT{pred} => pred := nd
361 :     (* end case *))
362 :     fun preds (ND{kind, ...}) = (case kind
363 :     of NULL => raise Fail "preds on NULL node"
364 :     | ENTRY _ => []
365 :     | JOIN{preds, ...} => !preds
366 :     | COND{pred, ...} => [!pred]
367 :     | BLOCK{pred, ...} => [!pred]
368 :     | NEW{pred, ...} => [!pred]
369 :     | DIE{pred} => [!pred]
370 :     | STABILIZE{pred} => [!pred]
371 :     | EXIT{pred} => [!pred]
372 :     (* end case *))
373 :     fun hasSucc (ND{kind, ...}) = (case kind
374 :     of NULL => false
375 :     | ENTRY{succ} => true
376 :     | JOIN{succ, ...} => true
377 :     | COND{trueBranch, falseBranch, ...} => true
378 :     | BLOCK{succ, ...} => true
379 :     | NEW{succ, ...} => true
380 :     | DIE _ => false
381 :     | STABILIZE _ => false
382 :     | EXIT _ => false
383 :     (* end case *))
384 :     fun setSucc (ND{kind, ...}, nd) = (case kind
385 :     of NULL => raise Fail "setSucc on NULL node"
386 :     | ENTRY{succ} => succ := nd
387 :     | JOIN{succ, ...} => succ := nd
388 :     | COND _ => raise Fail "setSucc on COND node"
389 :     | BLOCK{succ, ...} => succ := nd
390 :     | NEW{succ, ...} => succ := nd
391 :     | DIE _ => raise Fail "setSucc on DIE node"
392 :     | STABILIZE _ => raise Fail "setSucc on STABILIZE node"
393 :     | EXIT _ => raise Fail "setSucc on EXIT node"
394 :     (* end case *))
395 :     fun succs (ND{kind, ...}) = (case kind
396 :     of NULL => raise Fail "succs on NULL node"
397 :     | ENTRY{succ} => [!succ]
398 :     | JOIN{succ, ...} => [!succ]
399 :     | COND{trueBranch, falseBranch, ...} => [!trueBranch, !falseBranch]
400 :     | BLOCK{succ, ...} => [!succ]
401 :     | NEW{succ, ...} => [!succ]
402 :     | DIE _ => []
403 :     | STABILIZE _ => []
404 :     | EXIT _ => []
405 :     (* end case *))
406 :     fun setTrueBranch (ND{kind=COND{trueBranch, ...}, ...}, nd) = trueBranch := nd
407 :     | setTrueBranch (nd, _) = raise Fail("setTrueBranch on " ^ toString nd)
408 :     fun setFalseBranch (ND{kind=COND{falseBranch, ...}, ...}, nd) = falseBranch := nd
409 :     | setFalseBranch (nd, _) = raise Fail("setFalseBranch on " ^ toString nd)
410 :     fun addEdge (nd1, nd2) = (
411 :     if hasSucc nd1
412 :     then (
413 :     setSucc (nd1, nd2);
414 :     setPred (nd2, nd1))
415 :     else ())
416 :     (*DEBUG*)handle ex => (
417 :     print(concat["error in addEdge(", toString nd1, ",", toString nd2, ")\n"]);
418 :     raise ex)
419 : jhr 283 (* properties *)
420 :     fun newProp initFn =
421 :     PropList.newProp (fn (ND{props, ...}) => props, initFn)
422 :     fun newFlag () =
423 :     PropList.newFlag (fn (ND{props, ...}) => props)
424 : jhr 256 end
425 : jhr 124
426 : jhr 256 structure Stmt =
427 :     struct
428 :     fun same (STM{id=a, ...}, STM{id=b, ...}) = Stamp.same(a, b)
429 :     fun compare (STM{id=a, ...}, STM{id=b, ...}) = Stamp.compare(a, b)
430 :     fun hash (STM{id, ...}) = Stamp.hash id
431 :     fun toString (STM{id, kind, ...}) = let
432 :     val tag = (case kind
433 :     of S_SIMPLE(ND{kind, ...}) => (case kind
434 :     of NULL => "NULL"
435 :     | ENTRY _ => "ENTRY"
436 :     | JOIN _ => "JOIN"
437 :     | COND _ => raise Fail "unexpected S_SIMPLE with COND node"
438 :     | BLOCK _ => "BLOCK"
439 :     | NEW _ => "NEW"
440 :     | DIE _ => "DIE"
441 :     | STABILIZE _ => "STABILIZE"
442 :     | EXIT _ => "EXIT"
443 :     (* end case *))
444 :     | S_IF _ => "IF"
445 :     | S_LOOP _ => "LOOP"
446 :     (* end case *))
447 :     in
448 :     tag ^ Stamp.toString id
449 :     end
450 :     (* return the entry node of the statement *)
451 :     fun entry (STM{kind, ...}) = (case kind
452 :     of S_SIMPLE nd => nd
453 :     | S_IF{cond, ...} => cond
454 :     | S_LOOP{hdr, ...} => entry hdr
455 :     (* end case *))
456 :     (* return the tail-end node of a statement (not applicable to S_IF or S_LOOP) *)
457 :     fun tail (STM{kind, ...}) = (case kind
458 :     of S_SIMPLE nd => nd
459 :     | S_IF{cond, ...} => raise Fail "tail of IF"
460 :     | S_LOOP{hdr, ...} => raise Fail "tail of LOOP"
461 :     (* end case *))
462 :     (* statement constructor functions *)
463 :     fun new (kind, next) = STM{
464 : jhr 137 id = Stamp.new(),
465 : jhr 188 props = PropList.newHolder(),
466 : jhr 256 kind = kind,
467 :     next = next
468 : jhr 137 }
469 : jhr 256 val dummy = new (S_SIMPLE(Node.dummy), NONE)
470 :     fun mkENTRY next = new (S_SIMPLE(Node.mkENTRY ()), next)
471 :     fun mkJOIN (phis, next) = new (S_SIMPLE(Node.mkJOIN phis), next)
472 :     fun mkIF (cond, thenBranch, elseBranch, next) = let
473 :     val cond = Node.mkCOND {
474 :     cond = cond,
475 :     trueBranch = entry thenBranch,
476 :     falseBranch = entry elseBranch
477 :     }
478 :     in
479 :     Node.setPred (entry thenBranch, cond);
480 :     Node.setPred (entry elseBranch, cond);
481 :     new (S_IF{cond = cond, thenBranch = thenBranch, elseBranch = elseBranch}, next)
482 :     end
483 :     fun mkBLOCK (body, next) = new (S_SIMPLE(Node.mkBLOCK body), next)
484 :     fun mkNEW (actor, args, next) = new (S_SIMPLE(Node.mkNEW{actor=actor, args=args}), next)
485 :     fun mkDIE () = new (S_SIMPLE(Node.mkDIE ()), NONE)
486 :     fun mkSTABILIZE () = new (S_SIMPLE(Node.mkSTABILIZE ()), NONE)
487 :     fun mkEXIT () = new (S_SIMPLE(Node.mkEXIT ()), NONE)
488 : jhr 283 (* properties *)
489 :     fun newProp initFn =
490 :     PropList.newProp (fn (STM{props, ...}) => props, initFn)
491 :     fun newFlag () =
492 :     PropList.newFlag (fn (STM{props, ...}) => props)
493 : jhr 256 end
494 : jhr 137
495 : jhr 199 structure Var =
496 :     struct
497 :     fun new name = V{
498 :     name = name,
499 :     id = Stamp.new(),
500 :     useCnt = ref 0,
501 :     props = PropList.newHolder()
502 :     }
503 :     fun same (V{id=a, ...}, V{id=b, ...}) = Stamp.same(a, b)
504 :     fun compare (V{id=a, ...}, V{id=b, ...}) = Stamp.compare(a, b)
505 :     fun hash (V{id, ...}) = Stamp.hash id
506 :     fun toString (V{name, id, ...}) = name ^ Stamp.toString id
507 : jhr 283 (* properties *)
508 :     fun newProp initFn =
509 :     PropList.newProp (fn (V{props, ...}) => props, initFn)
510 :     fun newFlag () =
511 :     PropList.newFlag (fn (V{props, ...}) => props)
512 : jhr 199 local
513 :     structure V =
514 :     struct
515 :     type ord_key = var
516 :     val compare = compare
517 :     end
518 :     in
519 :     structure Map = RedBlackMapFn (V)
520 :     structure Set = RedBlackSetFn (V)
521 :     end
522 :     structure Tbl = HashTableFn (
523 :     struct
524 :     type hash_key = var
525 :     val hashVal = hash
526 :     val sameKey = same
527 :     end)
528 :     end
529 : jhr 197
530 : jhr 319 (* DFS sorting of the graph rooted at the entry to a statement; the resulting list will
531 :     * be in preorder with parents before children.
532 :     *)
533 : jhr 257 fun sortNodes stmt = let
534 :     val {getFn, setFn} = PropList.newFlag (fn (ND{props, ...}) => props)
535 :     fun dfs (nd, l) =
536 :     if getFn nd
537 :     then l
538 :     else (
539 :     setFn (nd, true);
540 :     nd :: List.foldl dfs l (Node.succs nd))
541 : jhr 319 val nodes = dfs (Stmt.entry stmt, [])
542 : jhr 257 in
543 : jhr 319 List.app (fn nd => setFn(nd, false)) nodes;
544 :     nodes
545 : jhr 257 end
546 :    
547 : jhr 124 end

root@smlnj-gforge.cs.uchicago.edu
ViewVC Help
Powered by ViewVC 1.0.0