SCCfinal.lhs 13.8 KB
Newer Older
1
%
2
% (c) The GRASP/AQUA Project, Glasgow University, 1992-1998
3
%
4
\section[SCCfinal]{Modify and collect code generation for final STG program}
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

This is now a sort-of-normal STG-to-STG pass (WDP 94/06), run by stg2stg.

* Traverses the STG program collecting the cost centres. These are
  required to declare the cost centres at the start of code
  generation.

  Note: because of cross-module unfolding, some of these cost centres
  may be from other modules.  But will still have to give them
  "extern" declarations.

* Puts on CAF cost-centres if the user has asked for individual CAF
  cost-centres.

* Ditto for individual DICT cost-centres.

* Boxes top-level inherited functions passed as arguments.

* "Distributes" given cost-centres to all as-yet-unmarked RHSs.

\begin{code}
26
{-# OPTIONS -w #-}
27
28
29
-- The above warning supression flag is a temporary kludge.
-- While working on this module you are encouraged to remove it and fix
-- any warnings in the module. See
Ian Lynagh's avatar
Ian Lynagh committed
30
--     http://hackage.haskell.org/trac/ghc/wiki/Commentary/CodingStyle#Warnings
31
32
-- for details

33
34
module SCCfinal ( stgMassageForProfiling ) where

35
#include "HsVersions.h"
36
37

import StgSyn
38

39
import StaticFlags	( opt_AutoSccsOnIndividualCafs )
40
import CostCentre	-- lots of things
Simon Marlow's avatar
Simon Marlow committed
41
42
import Id
import Name
43
import Module
Simon Marlow's avatar
Simon Marlow committed
44
45
46
47
import UniqSupply	( splitUniqSupply, UniqSupply )
#ifdef PROF_DO_BOXING
import UniqSupply	( uniqFromSupply )
#endif
48
import VarSet
49
import ListSetOps	( removeDups )
sof's avatar
sof committed
50
import Outputable	
51
52
53
54
55
56

infixr 9 `thenMM`, `thenMM_`
\end{code}

\begin{code}
stgMassageForProfiling
Simon Marlow's avatar
Simon Marlow committed
57
	:: PackageId
58
	-> Module			-- module name
59
60
	-> UniqSupply		    	-- unique supply
	-> [StgBinding]		    	-- input
61
	-> (CollectedCCs, [StgBinding])
62

Simon Marlow's avatar
Simon Marlow committed
63
stgMassageForProfiling this_pkg mod_name us stg_binds
64
  = let
65
	((local_ccs, extern_ccs, cc_stacks),
66
	 stg_binds2)
67
	  = initMM mod_name us (do_top_bindings stg_binds)
68

69
70
71
72
73
	(fixed_ccs, fixed_cc_stacks)
	  = if opt_AutoSccsOnIndividualCafs
	    then ([],[])  -- don't need "all CAFs" CC 
			  -- (for Prelude, we use PreludeCC)
	    else ([all_cafs_cc], [all_cafs_ccs])
74
75
76
77

	local_ccs_no_dups  = fst (removeDups cmpCostCentre local_ccs)
	extern_ccs_no_dups = fst (removeDups cmpCostCentre extern_ccs)
    in
78
79
80
    ((fixed_ccs ++ local_ccs_no_dups, 
      extern_ccs_no_dups, 
      fixed_cc_stacks ++ cc_stacks), stg_binds2)
81
82
  where

83
    all_cafs_cc  = mkAllCafsCC mod_name
84
    all_cafs_ccs = mkSingletonCCS all_cafs_cc
85
86

    ----------
87
    do_top_bindings :: [StgBinding] -> MassageM [StgBinding]
88

89
    do_top_bindings [] = returnMM []
90

91
    do_top_bindings (StgNonRec b rhs : bs) 
92
93
94
      = do_top_rhs b rhs 		`thenMM` \ rhs' ->
	addTopLevelIshId b (
	   do_top_bindings bs `thenMM` \bs' ->
95
	   returnMM (StgNonRec b rhs' : bs')
96
97
	)

98
    do_top_bindings (StgRec pairs : bs)
99
100
101
      = addTopLevelIshIds binders (
	   mapMM do_pair pairs		`thenMM` \ pairs2 ->
	   do_top_bindings bs `thenMM` \ bs' ->
102
	   returnMM (StgRec pairs2 : bs')
103
	)
104
      where
105
	binders = map fst pairs
106
	do_pair (b, rhs) 
107
108
109
110
	   = do_top_rhs b rhs	`thenMM` \ rhs2 ->
	     returnMM (b, rhs2)

    ----------
111
    do_top_rhs :: Id -> StgRhs -> MassageM StgRhs
112

113
    do_top_rhs binder (StgRhsClosure _ bi fv u srt [] (StgSCC cc (StgConApp con args)))
Simon Marlow's avatar
Simon Marlow committed
114
      | not (isSccCountCostCentre cc) && not (isDllConApp this_pkg con args)
115
116
	-- Trivial _scc_ around nothing but static data
	-- Eliminate _scc_ ... and turn into StgRhsCon
117
118

	-- isDllConApp checks for LitLit args too
119
      = returnMM (StgRhsCon dontCareCCS con args)
120

121
{- Can't do this one with cost-centre stacks:  --SDM
122
    do_top_rhs binder (StgRhsClosure no_cc bi fv u [] (StgSCC ty cc expr))
123
      | (noCCSAttached no_cc || currentOrSubsumedCCS no_cc)
124
125
126
127
128
        && not (isSccCountCostCentre cc)
	-- Top level CAF without a cost centre attached
	-- Attach and collect cc of trivial _scc_ in body
      = collectCC cc					`thenMM_`
	set_prevailing_cc cc (do_expr expr)		`thenMM`  \ expr' ->
129
        returnMM (StgRhsClosure cc bi fv u [] expr')
130
-}
131

132
    do_top_rhs binder (StgRhsClosure no_cc bi fv u srt [] body)
133
      | noCCSAttached no_cc || currentOrSubsumedCCS no_cc
134
135
	-- Top level CAF without a cost centre attached
	-- Attach CAF cc (collect if individual CAF ccs)
136
      = (if opt_AutoSccsOnIndividualCafs 
Simon Marlow's avatar
Simon Marlow committed
137
		then let cc = mkAutoCC binder modl CafCC
138
			 ccs = mkSingletonCCS cc
Simon Marlow's avatar
Simon Marlow committed
139
140
141
142
143
                                -- careful: the binder might be :Main.main,
                                -- which doesn't belong to module mod_name.
                                -- bug #249, tests prof001, prof002
                         modl | Just m <- nameModule_maybe (idName binder) = m
                              | otherwise = mod_name
144
		     in
145
		     collectNewCC  cc  `thenMM_`
146
147
148
149
		     collectCCS ccs `thenMM_`
		     returnMM ccs
		else 
		     returnMM all_cafs_ccs)		`thenMM`  \ caf_ccs ->
150
	   set_prevailing_cc caf_ccs (do_expr body)	`thenMM`  \ body' ->
151
           returnMM (StgRhsClosure caf_ccs bi fv u srt [] body')
152

153
    do_top_rhs binder (StgRhsClosure cc bi fv u srt [] body)
154
155
	-- Top level CAF with cost centre attached
	-- Should this be a CAF cc ??? Does this ever occur ???
156
      = pprPanic "SCCfinal: CAF with cc:" (ppr cc)
157

158
    do_top_rhs binder (StgRhsClosure no_ccs bi fv u srt args body)
159
	-- Top level function, probably subsumed
160
      | noCCSAttached no_ccs
161
      = set_lambda_cc (do_expr body)	`thenMM` \ body' ->
162
	returnMM (StgRhsClosure subsumedCCS bi fv u srt args body')
163

164
165
166
167
      | otherwise
      = pprPanic "SCCfinal: CAF with cc:" (ppr no_ccs)

    do_top_rhs binder (StgRhsCon ccs con args)
168
	-- Top-level (static) data is not counted in heap
169
	-- profiles; nor do we set CCCS from it; so we
170
	-- just slam in dontCareCostCentre
171
      = returnMM (StgRhsCon dontCareCCS con args)
172
173

    ------
174
    do_expr :: StgExpr -> MassageM StgExpr
175

176
177
    do_expr (StgLit l) = returnMM (StgLit l)

178
179
    do_expr (StgApp fn args)
      = boxHigherOrderArgs (StgApp fn) args
180

181
182
183
    do_expr (StgConApp con args)
      = boxHigherOrderArgs (\args -> StgConApp con args) args

184
185
    do_expr (StgOpApp con args res_ty)
      = boxHigherOrderArgs (\args -> StgOpApp con args res_ty) args
186

187
    do_expr (StgSCC cc expr)	-- Ha, we found a cost centre!
188
189
      = collectCC cc		`thenMM_`
	do_expr expr		`thenMM` \ expr' ->
190
	returnMM (StgSCC cc expr')
191

192
    do_expr (StgCase expr fv1 fv2 bndr srt alt_type alts)
193
      = do_expr expr		`thenMM` \ expr' ->
194
195
	mapMM do_alt alts 	`thenMM` \ alts' ->
	returnMM (StgCase expr' fv1 fv2 bndr srt alt_type alts')
196
      where
197
198
199
	do_alt (id, bs, use_mask, e)
	  = do_expr e `thenMM` \ e' ->
	    returnMM (id, bs, use_mask, e')
200
201

    do_expr (StgLet b e)
202
203
204
205
206
207
208
	= do_let b e `thenMM` \ (b,e) ->
	  returnMM (StgLet b e)

    do_expr (StgLetNoEscape lvs1 lvs2 b e)
	= do_let b e `thenMM` \ (b,e) ->
	  returnMM (StgLetNoEscape lvs1 lvs2 b e)

andy@galois.com's avatar
andy@galois.com committed
209
210
211
212
    do_expr (StgTick m n expr) 
        = do_expr expr `thenMM` \ expr' ->
          returnMM (StgTick m n expr')

213
214
215
216
#ifdef DEBUG
    do_expr other = pprPanic "SCCfinal.do_expr" (ppr other)
#endif

217
218
    ----------------------------------

219
    do_let (StgNonRec b rhs) e
220
221
222
      = do_rhs rhs		 	`thenMM` \ rhs' ->
	addTopLevelIshId b (
	  do_expr e		  	`thenMM` \ e' ->
223
	  returnMM (StgNonRec b rhs',e')
224
225
        )

226
    do_let (StgRec pairs) e
227
228
229
      = addTopLevelIshIds binders (
	   mapMM do_pair pairs	 	`thenMM` \ pairs' ->
	   do_expr e		  	`thenMM` \ e' ->
230
	   returnMM (StgRec pairs', e')
231
	)
232
      where
233
234
235
236
	binders = map fst pairs
	do_pair (b, rhs) 
	   = do_rhs rhs			`thenMM` \ rhs2 ->
	     returnMM (b, rhs2)
237

238
    ----------------------------------
239
    do_rhs :: StgRhs -> MassageM StgRhs
240
	-- We play much the same game as we did in do_top_rhs above;
241
	-- but we don't have to worry about cafs etc.
242

243
{-
244
    do_rhs (StgRhsClosure closure_cc bi fv u [] (StgSCC ty cc (StgCon (DataCon con) args _)))
245
      | not (isSccCountCostCentre cc)
246
247
      = collectCC cc `thenMM_`
	returnMM (StgRhsCon cc con args)
248
-}
249

250
    do_rhs (StgRhsClosure _ bi fv u srt args expr)
251
252
      = slurpSCCs currentCCS expr	`thenMM` \ (expr', ccs) ->
	do_expr expr'			`thenMM` \ expr'' ->
253
	returnMM (StgRhsClosure ccs bi fv u srt args expr'')
254
255
256
      where
	slurpSCCs ccs (StgSCC cc e) 
	     = collectCC cc 			`thenMM_`
257
	       slurpSCCs (cc `pushCCOnCCS` ccs) e
258
259
	slurpSCCs ccs e 
	     = returnMM (e, ccs)
260
261

    do_rhs (StgRhsCon cc con args)
262
      = returnMM (StgRhsCon currentCCS con args)
263
264
265
266
267
268
269
270
\end{code}

%************************************************************************
%*									*
\subsection{Boxing higher-order args}
%*									*
%************************************************************************

271
272
273
Boxing is *turned off* at the moment, until we can figure out how to
do it properly in general.

274
275
\begin{code}
boxHigherOrderArgs
276
    :: ([StgArg] -> StgExpr)
277
			-- An application lacking its arguments
278
    -> [StgArg]		-- arguments which we might box
279
    -> MassageM StgExpr
280

281
282
283
284
#ifndef PROF_DO_BOXING
boxHigherOrderArgs almost_expr args
   = returnMM (almost_expr args)
#else
285
boxHigherOrderArgs almost_expr args
286
287
288
  = getTopLevelIshIds		`thenMM` \ ids ->
    mapAccumMM (do_arg ids) [] args	`thenMM` \ (let_bindings, new_args) ->
    returnMM (foldr (mk_stg_let currentCCS) (almost_expr new_args) let_bindings)
289
290
291
  where
    ---------------

292
    do_arg ids bindings arg@(StgVarArg old_var)
293
	|  (not (isLocalVar old_var) || elemVarSet old_var ids)
294
	&& isFunTy (dropForAlls var_type)
295
296
297
      =     -- make a trivial let-binding for the top-level function
	getUniqueMM		`thenMM` \ uniq ->
	let
298
	    new_var = mkSysLocal FSLIT("sf") uniq var_type
299
	in
300
301
302
303
304
	returnMM ( (new_var, old_var) : bindings, StgVarArg new_var )
      where
	var_type = idType old_var

    do_arg ids bindings arg = returnMM (bindings, arg)
305
306

    ---------------
307
    mk_stg_let :: CostCentreStack -> (Id, Id) -> StgExpr -> StgExpr
308
309
310

    mk_stg_let cc (new_var, old_var) body
      = let
311
	    rhs_body    = StgApp old_var [{-args-}]
312
	    rhs_closure = StgRhsClosure cc stgArgOcc [{-fvs-}] ReEntrant NoSRT{-eeek!!!-} [{-args-}] rhs_body
313
        in
314
	StgLet (StgNonRec new_var rhs_closure) body
315
      where
316
	bOGUS_LVs = emptyUniqSet -- easier to print than: panic "mk_stg_let: LVs"
317
#endif
318
319
320
321
322
323
324
325
326
327
\end{code}

%************************************************************************
%*									*
\subsection{Boring monad stuff for this}
%*									*
%************************************************************************

\begin{code}
type MassageM result
328
  =  Module		-- module name
329
  -> CostCentreStack	-- prevailing CostCentre
330
			-- if none, subsumedCosts at top-level
331
			-- currentCostCentre at nested levels
332
  -> UniqSupply
333
  -> VarSet		-- toplevel-ish Ids for boxing
334
335
336
  -> CollectedCCs
  -> (CollectedCCs, result)

337
-- the initMM function also returns the final CollectedCCs
338

339
initMM :: Module	-- module name, which we may consult
340
       -> UniqSupply
341
342
343
       -> MassageM a
       -> (CollectedCCs, a)

344
initMM mod_name init_us m = m mod_name noCCS init_us emptyVarSet ([],[],[])
345
346
347
348

thenMM  :: MassageM a -> (a -> MassageM b) -> MassageM b
thenMM_ :: MassageM a -> (MassageM b) -> MassageM b

349
thenMM expr cont mod scope_cc us ids ccs
350
  = case splitUniqSupply us	of { (s1, s2) ->
351
352
    case (expr mod scope_cc s1 ids ccs) of { (ccs2, result) ->
    cont result mod scope_cc s2 ids ccs2 }}
353

354
thenMM_ expr cont mod scope_cc us ids ccs
355
  = case splitUniqSupply us	of { (s1, s2) ->
356
357
    case (expr mod scope_cc s1 ids ccs)	of { (ccs2, _) ->
    cont mod scope_cc s2 ids ccs2 }}
358
359

returnMM :: a -> MassageM a
360
returnMM result mod scope_cc us ids ccs = (ccs, result)
361
362

nopMM :: MassageM ()
363
nopMM mod scope_cc us ids ccs = (ccs, ())
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378

mapMM :: (a -> MassageM b) -> [a] -> MassageM [b]
mapMM f [] = returnMM []
mapMM f (m:ms)
  = f m		`thenMM` \ r  ->
    mapMM f ms	`thenMM` \ rs ->
    returnMM (r:rs)

mapAccumMM :: (acc -> x -> MassageM (acc, y)) -> acc -> [x] -> MassageM (acc, [y])
mapAccumMM f b [] = returnMM (b, [])
mapAccumMM f b (m:ms)
  = f b m		`thenMM` \ (b2, r)  ->
    mapAccumMM f b2 ms	`thenMM` \ (b3, rs) ->
    returnMM (b3, r:rs)

Simon Marlow's avatar
Simon Marlow committed
379
#ifdef PROF_DO_BOXING
380
getUniqueMM :: MassageM Unique
381
getUniqueMM mod scope_cc us ids ccs = (ccs, uniqFromSupply us)
Simon Marlow's avatar
Simon Marlow committed
382
#endif
383

384
385
386
387
addTopLevelIshId :: Id -> MassageM a -> MassageM a
addTopLevelIshId id scope mod scope_cc us ids ccs
  | isCurrentCCS scope_cc = scope mod scope_cc us ids ccs
  | otherwise             = scope mod scope_cc us (extendVarSet ids id) ccs
388

389
390
391
392
addTopLevelIshIds :: [Id] -> MassageM a -> MassageM a
addTopLevelIshIds [] cont = cont
addTopLevelIshIds (id:ids) cont 
  = addTopLevelIshId id (addTopLevelIshIds ids cont)
393

394
395
396
397
398
399
400
401
getTopLevelIshIds :: MassageM VarSet
getTopLevelIshIds mod scope_cc us ids ccs = (ccs, ids)
\end{code}

The prevailing CCS is used to tell whether we're in a top-levelish
position, where top-levelish is defined as "not inside a lambda".
Prevailing CCs used to be used for something much more complicated,
I'm sure --SDM
402

403
\begin{code}
404
set_lambda_cc :: MassageM a -> MassageM a
405
406
set_lambda_cc action mod scope_cc us ids ccs
  = action mod currentCCS us ids ccs
407

408
409
410
set_prevailing_cc :: CostCentreStack -> MassageM a -> MassageM a
set_prevailing_cc cc_to_set_to action mod scope_cc us ids ccs
  = action mod cc_to_set_to us ids ccs
411

412
get_prevailing_cc :: MassageM CostCentreStack
413
get_prevailing_cc mod scope_cc us ids ccs = (ccs, scope_cc)
414
415
416
417
418
\end{code}

\begin{code}
collectCC :: CostCentre -> MassageM ()

419
collectCC cc mod_name scope_cc us ids (local_ccs, extern_ccs, ccss)
420
  = ASSERT(not (noCCAttached cc))
421
    if (cc `ccFromThisModule` mod_name) then
422
	((cc : local_ccs, extern_ccs, ccss), ())
423
    else -- must declare it "extern"
424
425
	((local_ccs, cc : extern_ccs, ccss), ())

426
427
428
429
430
431
432
433
-- Version of collectCC used when we definitely want to declare this
-- CC as local, even if its module name is not the same as the current
-- module name (eg. the special :Main module) see bug #249, #1472, 
-- test prof001,prof002.
collectNewCC :: CostCentre -> MassageM ()
collectNewCC cc mod_name scope_cc us ids (local_ccs, extern_ccs, ccss)
  = ((cc : local_ccs, extern_ccs, ccss), ())

434
435
collectCCS :: CostCentreStack -> MassageM ()

436
collectCCS ccs mod_name scope_cc us ids (local_ccs, extern_ccs, ccss)
437
438
  = ASSERT(not (noCCSAttached ccs))
    ((local_ccs, extern_ccs, ccs : ccss), ())
439
\end{code}