RtsFlags.c 69.9 KB
Newer Older
1
/* -----------------------------------------------------------------------------
2 3
 *
 * (c) The AQUA Project, Glasgow University, 1994-1997
Simon Marlow's avatar
Simon Marlow committed
4
 * (c) The GHC Team, 1998-2006
5 6 7 8 9
 *
 * Functions for parsing the argument list.
 *
 * ---------------------------------------------------------------------------*/

10
#include "PosixSource.h"
11 12 13
#include "Rts.h"
#include "RtsFlags.h"
#include "RtsUtils.h"
14
#include "Profiling.h"
15

16 17
#ifdef HAVE_CTYPE_H
#include <ctype.h>
18 19
#endif

20 21 22
#include <stdlib.h>
#include <string.h>

23 24
// Flag Structure
RTS_FLAGS RtsFlags;
25 26 27 28

/*
 * Split argument lists
 */
sof's avatar
sof committed
29
int     prog_argc = 0;    /* an "int" so as to match normal "argc" */
30
char  **prog_argv = NULL;
sof's avatar
sof committed
31
char   *prog_name = NULL; /* 'basename' of prog_argv[0] */
32
int     rts_argc = 0;  /* ditto */
33 34 35 36 37 38 39 40
char   *rts_argv[MAX_RTS_ARGS];

/*
 * constants, used later 
 */
#define RTS 1
#define PGM 0

41 42
#if defined(GRAN)

sof's avatar
sof committed
43
static char *gran_debug_opts_strs[] = {
44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61
  "DEBUG (-bDe, -bD1): event_trace; printing event trace.\n",
  "DEBUG (-bDE, -bD2): event_stats; printing event statistics.\n",
  "DEBUG (-bDb, -bD4): bq; check blocking queues\n",
  "DEBUG (-bDG, -bD8): pack; routines for (un-)packing graph structures.\n",
  "DEBUG (-bDq, -bD16): checkSparkQ; check consistency of the spark queues.\n",
  "DEBUG (-bDf, -bD32): thunkStealing; print forwarding of fetches.\n",
  "DEBUG (-bDr, -bD64): randomSteal; stealing sparks/threads from random PEs.\n",
  "DEBUG (-bDF, -bD128): findWork; searching spark-pools (local & remote), thread queues for work.\n",
  "DEBUG (-bDu, -bD256): unused; currently unused flag.\n",
  "DEBUG (-bDS, -bD512): pri; priority sparking or scheduling.\n",
  "DEBUG (-bD:, -bD1024): checkLight; check GranSim-Light setup.\n",
  "DEBUG (-bDo, -bD2048): sortedQ; check whether spark/thread queues are sorted.\n",
  "DEBUG (-bDz, -bD4096): blockOnFetch; check for blocked on fetch.\n",
  "DEBUG (-bDP, -bD8192): packBuffer; routines handling pack buffer (GranSim internal!).\n",
  "DEBUG (-bDt, -bD16384): blockOnFetch_sanity; check for TSO asleep on fetch.\n",
};

/* one character codes for the available debug options */
sof's avatar
sof committed
62
static char gran_debug_opts_flags[] = {
63 64 65 66 67
  'e', 'E', 'b', 'G', 'q', 'f', 'r', 'F', 'u', 'S', ':', 'o', 'z', 'P', 't'
};

#elif defined(PAR)

sof's avatar
sof committed
68
static char *par_debug_opts_strs[] = {
69
  "DEBUG (-qDv, -qD1): verbose; be generally verbose with parallel related stuff.\n",
70
  "DEBUG (-qDq, -qD2): bq; print blocking queues.\n",
71 72 73
  "DEBUG (-qDs, -qD4): schedule; scheduling of parallel threads.\n",
  "DEBUG (-qDe, -qD8): free; free messages.\n",
  "DEBUG (-qDr, -qD16): resume; resume messages.\n",
74
  "DEBUG (-qDw, -qD32): weight; print weights and distrib GC stuff.\n",
75
  "DEBUG (-qDF, -qD64): fetch; fetch messages.\n",
76 77 78 79 80
  // "DEBUG (-qDa, -qD128): ack; ack messages.\n",
  "DEBUG (-qDf, -qD128): fish; fish messages.\n",
  //"DEBUG (-qDo, -qD512): forward; forwarding messages to other PEs.\n",
  "DEBUG (-qDl, -qD256): tables; print internal LAGA etc tables.\n",
  "DEBUG (-qDo, -qD512): packet; packets and graph structures when packing.\n",
81 82
  "DEBUG (-qDp, -qD1024): pack; packing and unpacking graphs.\n",
  "DEBUG (-qDz, -qD2048): paranoia; ridiculously detailed output (excellent for filling a partition).\n"
83 84 85
};

/* one character codes for the available debug options */
sof's avatar
sof committed
86
static char par_debug_opts_flags[] = {
87
  'v', 'q', 's', 'e', 'r', 'w', 'F', 'f', 'l', 'o', 'p', 'z'
88 89 90 91
};

#endif /* PAR */

92 93 94 95
/* -----------------------------------------------------------------------------
   Static function decls
   -------------------------------------------------------------------------- */

96
static int		/* return NULL on error */
97 98 99 100
open_stats_file (
    I_ arg,
    int argc, char *argv[],
    int rts_argc, char *rts_argv[],
101 102
    const char *FILENAME_FMT,
    FILE **file_ret);
103 104 105 106

static I_ decode(const char *s);
static void bad_option(const char *s);

107 108 109 110 111 112 113 114 115 116 117
#if defined(GRAN)
static void enable_GranSimLight(void);
static void process_gran_option(int arg, int *rts_argc, char *rts_argv[], rtsBool *error);
static void set_GranSim_debug_options(nat n);
static void help_GranSim_debug_options(nat n);
#elif defined(PAR)
static void process_par_option(int arg, int *rts_argc, char *rts_argv[], rtsBool *error);
static void set_par_debug_options(nat n);
static void help_par_debug_options(nat n);
#endif

118 119 120 121 122 123 124 125 126
/* -----------------------------------------------------------------------------
 * Command-line option parsing routines.
 * ---------------------------------------------------------------------------*/

void initRtsFlagsDefaults(void)
{
    RtsFlags.GcFlags.statsFile		= NULL;
    RtsFlags.GcFlags.giveStats		= NO_GC_STATS;

127
    RtsFlags.GcFlags.maxStkSize		= (8 * 1024 * 1024) / sizeof(W_);
128 129
    RtsFlags.GcFlags.initialStkSize	= 1024 / sizeof(W_);

130
    RtsFlags.GcFlags.minAllocAreaSize   = (512 * 1024)        / BLOCK_SIZE;
131
    RtsFlags.GcFlags.minOldGenSize      = (1024 * 1024)       / BLOCK_SIZE;
132
    RtsFlags.GcFlags.maxHeapSize	= 0;    /* off by default */
133
    RtsFlags.GcFlags.heapSizeSuggestion	= 0;    /* none */
134
    RtsFlags.GcFlags.pcFreeHeap		= 3;	/* 3% */
135
    RtsFlags.GcFlags.oldGenFactor       = 2;
136 137 138 139 140 141
#if defined(PAR)
    /* A hack currently needed for GUM -- HWL */
    RtsFlags.GcFlags.generations        = 1;
    RtsFlags.GcFlags.steps              = 2;
    RtsFlags.GcFlags.squeezeUpdFrames	= rtsFalse;
#else
142
    RtsFlags.GcFlags.generations        = 2;
143
    RtsFlags.GcFlags.steps              = 2;
144
    RtsFlags.GcFlags.squeezeUpdFrames	= rtsTrue;
145
#endif
146
    RtsFlags.GcFlags.compact            = rtsFalse;
147
    RtsFlags.GcFlags.compactThreshold   = 30.0;
148 149 150
#ifdef RTS_GTK_FRONTPANEL
    RtsFlags.GcFlags.frontpanel         = rtsFalse;
#endif
151
    RtsFlags.GcFlags.idleGCDelayTime    = 300; /* millisecs */
152

153 154
#ifdef DEBUG
    RtsFlags.DebugFlags.scheduler	= rtsFalse;
155
    RtsFlags.DebugFlags.interpreter	= rtsFalse;
156 157 158 159 160 161
    RtsFlags.DebugFlags.weak		= rtsFalse;
    RtsFlags.DebugFlags.gccafs		= rtsFalse;
    RtsFlags.DebugFlags.gc		= rtsFalse;
    RtsFlags.DebugFlags.block_alloc	= rtsFalse;
    RtsFlags.DebugFlags.sanity		= rtsFalse;
    RtsFlags.DebugFlags.stable		= rtsFalse;
162
    RtsFlags.DebugFlags.stm             = rtsFalse;
163 164 165 166
    RtsFlags.DebugFlags.prof		= rtsFalse;
    RtsFlags.DebugFlags.gran		= rtsFalse;
    RtsFlags.DebugFlags.par		= rtsFalse;
    RtsFlags.DebugFlags.linker		= rtsFalse;
167
    RtsFlags.DebugFlags.squeeze		= rtsFalse;
168 169
#endif

170 171 172 173 174
#if defined(PROFILING) || defined(PAR)
    RtsFlags.CcFlags.doCostCentres	= 0;
#endif /* PROFILING or PAR */

#ifdef PROFILING
175
    RtsFlags.ProfFlags.doHeapProfile      = rtsFalse;
176
    RtsFlags.ProfFlags.profileInterval    = 100;
177
    RtsFlags.ProfFlags.includeTSOs        = rtsFalse;
178
    RtsFlags.ProfFlags.showCCSOnException = rtsFalse;
179
    RtsFlags.ProfFlags.maxRetainerSetSize = 8;
180 181 182 183
    RtsFlags.ProfFlags.modSelector        = NULL;
    RtsFlags.ProfFlags.descrSelector      = NULL;
    RtsFlags.ProfFlags.typeSelector       = NULL;
    RtsFlags.ProfFlags.ccSelector         = NULL;
184
    RtsFlags.ProfFlags.ccsSelector        = NULL;
185 186
    RtsFlags.ProfFlags.retainerSelector   = NULL;
    RtsFlags.ProfFlags.bioSelector        = NULL;
187

188
#elif defined(DEBUG)
189
    RtsFlags.ProfFlags.doHeapProfile      = rtsFalse;
190 191
#endif

192 193
    RtsFlags.MiscFlags.tickInterval	= 50;  /* In milliseconds */
    RtsFlags.ConcFlags.ctxtSwitchTime	= 50;  /* In milliseconds */
194

195
#ifdef THREADED_RTS
196
    RtsFlags.ParFlags.nNodes	        = 1;
197 198
    RtsFlags.ParFlags.migrate           = rtsTrue;
    RtsFlags.ParFlags.wakeupMigrate     = rtsFalse;
199
#endif
200

201
#ifdef PAR
202
    RtsFlags.ParFlags.ParStats.Full   	  = rtsFalse;
203
    RtsFlags.ParFlags.ParStats.Suppressed = rtsFalse;
204 205 206 207 208 209
    RtsFlags.ParFlags.ParStats.Binary 	  = rtsFalse;
    RtsFlags.ParFlags.ParStats.Sparks 	  = rtsFalse;
    RtsFlags.ParFlags.ParStats.Heap   	  = rtsFalse;
    RtsFlags.ParFlags.ParStats.NewLogfile = rtsFalse;
    RtsFlags.ParFlags.ParStats.Global     = rtsFalse;

210
    RtsFlags.ParFlags.outputDisabled	= rtsFalse;
211 212 213 214 215
#ifdef DIST
    RtsFlags.ParFlags.doFairScheduling  = rtsTrue;  /* fair sched by def */
#else
    RtsFlags.ParFlags.doFairScheduling  = rtsFalse;  /* unfair sched by def */
#endif
216
    RtsFlags.ParFlags.packBufferSize	= 1024;
217 218
    RtsFlags.ParFlags.thunksToPack      = 1; /* 0 ... infinity; */
    RtsFlags.ParFlags.globalising       = 1; /* 0 ... everything */
219 220 221
    RtsFlags.ParFlags.maxThreads        = 1024;
    RtsFlags.ParFlags.maxFishes        = MAX_FISHES;
    RtsFlags.ParFlags.fishDelay         = FISH_DELAY;
222 223
#endif

224
#if defined(PAR) || defined(THREADED_RTS)
225
    RtsFlags.ParFlags.maxLocalSparks	= 4096;
226
#endif /* PAR || THREADED_RTS */
227 228 229

#if defined(GRAN)
    /* ToDo: check defaults for GranSim and GUM */
230
    RtsFlags.GcFlags.maxStkSize		= (8 * 1024 * 1024) / sizeof(W_);
231 232
    RtsFlags.GcFlags.initialStkSize	= 1024 / sizeof(W_);

233
    RtsFlags.GranFlags.maxThreads	= 65536; // refers to mandatory threads
234 235 236 237 238 239 240
    RtsFlags.GranFlags.GranSimStats.Full	= rtsFalse;
    RtsFlags.GranFlags.GranSimStats.Suppressed	= rtsFalse;
    RtsFlags.GranFlags.GranSimStats.Binary      = rtsFalse;
    RtsFlags.GranFlags.GranSimStats.Sparks      = rtsFalse;
    RtsFlags.GranFlags.GranSimStats.Heap        = rtsFalse;
    RtsFlags.GranFlags.GranSimStats.NewLogfile  = rtsFalse;
    RtsFlags.GranFlags.GranSimStats.Global      = rtsFalse;
241 242 243 244

    RtsFlags.GranFlags.packBufferSize	= 1024;
    RtsFlags.GranFlags.packBufferSize_internal = GRANSIM_DEFAULT_PACK_BUFFER_SIZE;

245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283
    RtsFlags.GranFlags.proc         = MAX_PROC;
    RtsFlags.GranFlags.Fishing      = rtsFalse;
    RtsFlags.GranFlags.maxFishes   = MAX_FISHES;
    RtsFlags.GranFlags.time_slice   = GRAN_TIME_SLICE;
    RtsFlags.GranFlags.Light        = rtsFalse;

    RtsFlags.GranFlags.Costs.latency =             LATENCY;          
    RtsFlags.GranFlags.Costs.additional_latency =  ADDITIONAL_LATENCY; 
    RtsFlags.GranFlags.Costs.fetchtime =           FETCHTIME; 
    RtsFlags.GranFlags.Costs.lunblocktime =        LOCALUNBLOCKTIME; 
    RtsFlags.GranFlags.Costs.gunblocktime =        GLOBALUNBLOCKTIME;
    RtsFlags.GranFlags.Costs.mpacktime =           MSGPACKTIME;      
    RtsFlags.GranFlags.Costs.munpacktime =         MSGUNPACKTIME;
    RtsFlags.GranFlags.Costs.mtidytime =           MSGTIDYTIME;

    RtsFlags.GranFlags.Costs.threadcreatetime =         THREADCREATETIME;
    RtsFlags.GranFlags.Costs.threadqueuetime =          THREADQUEUETIME;
    RtsFlags.GranFlags.Costs.threaddescheduletime =     THREADDESCHEDULETIME;
    RtsFlags.GranFlags.Costs.threadscheduletime =       THREADSCHEDULETIME;
    RtsFlags.GranFlags.Costs.threadcontextswitchtime =  THREADCONTEXTSWITCHTIME;

    RtsFlags.GranFlags.Costs.arith_cost =         ARITH_COST;       
    RtsFlags.GranFlags.Costs.branch_cost =        BRANCH_COST; 
    RtsFlags.GranFlags.Costs.load_cost =          LOAD_COST;        
    RtsFlags.GranFlags.Costs.store_cost =         STORE_COST; 
    RtsFlags.GranFlags.Costs.float_cost =         FLOAT_COST;       

    RtsFlags.GranFlags.Costs.heapalloc_cost =     HEAPALLOC_COST;

    RtsFlags.GranFlags.Costs.pri_spark_overhead = PRI_SPARK_OVERHEAD;        
    RtsFlags.GranFlags.Costs.pri_sched_overhead = PRI_SCHED_OVERHEAD;        

    RtsFlags.GranFlags.DoFairSchedule           = rtsFalse;             
    RtsFlags.GranFlags.DoAsyncFetch             = rtsFalse;        
    RtsFlags.GranFlags.DoStealThreadsFirst      = rtsFalse;        
    RtsFlags.GranFlags.DoAlwaysCreateThreads    = rtsFalse;      
    RtsFlags.GranFlags.DoBulkFetching           = rtsFalse;             
    RtsFlags.GranFlags.DoThreadMigration        = rtsFalse;          
    RtsFlags.GranFlags.FetchStrategy            = 2;                     
284
    RtsFlags.GranFlags.PreferSparksOfLocalNodes = rtsFalse;   
285 286 287 288 289 290 291 292 293
    RtsFlags.GranFlags.DoPrioritySparking       = rtsFalse;         
    RtsFlags.GranFlags.DoPriorityScheduling     = rtsFalse;       
    RtsFlags.GranFlags.SparkPriority            = 0;
    RtsFlags.GranFlags.SparkPriority2           = 0; 
    RtsFlags.GranFlags.RandomPriorities         = rtsFalse;           
    RtsFlags.GranFlags.InversePriorities        = rtsFalse;          
    RtsFlags.GranFlags.IgnorePriorities         = rtsFalse;           
    RtsFlags.GranFlags.ThunksToPack             = 0;                      
    RtsFlags.GranFlags.RandomSteal              = rtsTrue;
294 295 296
#endif

#ifdef TICKY_TICKY
297 298
    RtsFlags.TickyFlags.showTickyStats	 = rtsFalse;
    RtsFlags.TickyFlags.tickyFile	 = NULL;
299
#endif
Simon Marlow's avatar
Simon Marlow committed
300 301 302

    RtsFlags.TraceFlags.timestamp	= rtsFalse;
    RtsFlags.TraceFlags.sched 		= rtsFalse;
303 304 305 306 307 308 309 310 311 312 313 314 315 316
}

static const char *
usage_text[] = {
"",
"Usage: <prog> <args> [+RTS <rtsopts> | -RTS <args>] ... --RTS <args>",
"",
"   +RTS    Indicates run time system options follow",
"   -RTS    Indicates program arguments follow",
"  --RTS    Indicates that ALL subsequent arguments will be given to the",
"           program (including any of these RTS flags)",
"",
"The following run time system options are available:",
"",
317
"  -?       Prints this message and exits; the program is not executed",
318
"",
319
"  -K<size> Sets the maximum stack size (default 8M)  Egs: -K32k   -K512k",
sof's avatar
sof committed
320
"  -k<size> Sets the initial thread stack size (default 1k)  Egs: -k4k   -k2m",
321 322
"",
"  -A<size> Sets the minimum allocation area size (default 256k) Egs: -A1m -A10k",
323
"  -M<size> Sets the maximum heap size (default unlimited)  Egs: -M256k -M1G",
324
"  -H<size> Sets the minimum heap size (default 0M)   Egs: -H24m  -H1G",
325
"  -m<n>    Minimum % of heap which must be available (default 3%)",
326
"  -G<n>    Number of generations (default: 2)",
327
"  -T<n>    Number of steps in younger generations (default: 2)",
328 329
"  -c<n>    Auto-enable compaction of the oldest generation when live data is",
"           at least <n>% of the maximum heap size set with -M (default: 30%)",
330
"  -c       Enable compaction for all major collections",
331
#if defined(THREADED_RTS)
332 333
"  -I<sec>  Perform full GC after <sec> idle time (default: 0.3, 0 == off)",
#endif
334 335 336 337
"",
"  -t<file> One-line GC statistics  (default file: <program>.stat)",
"  -s<file> Summary  GC statistics  (with -Sstderr going to stderr)",
"  -S<file> Detailed GC statistics",
338 339 340
#ifdef RTS_GTK_FRONTPANEL
"  -f       Display front panel (requires X11 & GTK+)",
#endif
341 342 343 344 345 346
"",
"",
"  -Z       Don't squeeze out update frames on stack overflow",
"  -B       Sound the bell at the start of each garbage collection",
#if defined(PROFILING) || defined(PAR)
"",
347
"  -px      Time/allocation profile (XML)  (output file <program>.prof)",
andy's avatar
andy committed
348 349 350
"  -p       Time/allocation profile        (output file <program>.prof)",
"  -P       More detailed Time/Allocation profile",
"  -Pa      Give information about *all* cost centres",
351

352 353
# if defined(PROFILING)
"",
354 355 356 357 358 359 360 361
"  -hx            Heap residency profile (XML)   (output file <program>.prof)",
"  -h<break-down> Heap residency profile (hp2ps) (output file <program>.hp)",
"     break-down: c = cost centre stack (default)",
"                 m = module",
"                 d = closure description",
"                 y = type description",
"                 r = retainer",
"                 b = biography (LAG,DRAG,VOID,USE)",
362
"  A subset of closures may be selected thusly:",
363 364
"    -hc<cc>,...  specific cost centre(s) (top of stack only)",
"    -hC<cc>,...  specific cost centre(s) (anywhere in stack)",
365 366 367 368 369
"    -hm<mod>...  all cost centres from the specified modules(s)",
"    -hd<des>,... closures with specified closure descriptions",
"    -hy<typ>...  closures with specified type descriptions",
"    -hr<cc>...   closures with specified retainers",
"    -hb<bio>...  closures with specified biographies (lag,drag,void,use)",
370 371
"",
"  -R<size>       Set the maximum retainer set size (default: 8)",
372
"",
373
"  -i<sec>        Time between heap samples (seconds, default: 0.1)",
andy's avatar
andy committed
374
"",
375 376
"  -xt            Include threads (TSOs) in a heap profile",
"",
377
"  -xc      Show current cost centre stack on raising an exception",
378 379 380 381 382 383 384 385 386 387 388 389 390 391
# endif
#endif /* PROFILING or PAR */
#if !defined(PROFILING) && defined(DEBUG)
"",
"  -h<break-down> Debugging Heap residency profile",
"                 (output file <program>.hp)",
"     break-down: L = closure label (default)",
"                 T = closure type (constructor, thunk etc.)",
#endif
"",
#if defined(TICKY_TICKY)
"  -r<file>  Produce reduction profiling statistics (with -rstderr for stderr)",
"",
#endif
392
#if defined(PAR)
393 394
"  -N<n>     Use <n> PVMish processors in parallel (default: 2)",
/* NB: the -N<n> is implemented by the driver!! */
395
#endif
396 397 398 399 400 401
"  -C<secs>  Context-switch interval in seconds.",
"            0 or no argument means switch as often as possible.",
"            Default: 0.02 sec; resolution is set by -V below.",
"  -V<secs>  Master tick interval in seconds.",
"            This sets the resolution for -C and the profile timer -i.",
"            Default: 0.02 sec.",
402
"",
Simon Marlow's avatar
Simon Marlow committed
403 404 405
"  -vs       Trace scheduler events (see also -Ds with -debug)",
"  -vt       Time-stamp trace messages",
"",
406 407
#if defined(DEBUG)
"  -Ds  DEBUG: scheduler",
408
"  -Di  DEBUG: interpreter",
409 410 411 412 413 414 415 416 417 418
"  -Dw  DEBUG: weak",
"  -DG  DEBUG: gccafs",
"  -Dg  DEBUG: gc",
"  -Db  DEBUG: block",
"  -DS  DEBUG: sanity",
"  -Dt  DEBUG: stable",
"  -Dp  DEBUG: prof",
"  -Dr  DEBUG: gran",
"  -DP  DEBUG: par",
"  -Dl  DEBUG: linker",
419
"  -Dm  DEBUG: stm",
420
"  -Dz  DEBUG: stack squezing",
421
"",
422
#endif /* DEBUG */
423
#if defined(THREADED_RTS) && !defined(NOSMP)
424
"  -N<n>     Use <n> OS threads (default: 1)",
425 426
"  -qm       Don't automatically migrate threads between CPUs",
"  -qw       Migrate a thread to the current CPU when it is woken up",
427
#endif
428
#if defined(THREADED_RTS) || defined(PAR)
429 430 431
"  -e<size>  Size of spark pools (default 100)",
#endif
#if defined(PAR)
432 433 434 435 436
"  -t<num>   Set maximum number of advisory threads per PE (default 32)",
"  -qP       Enable activity profile (output files in ~/<program>*.gr)",
"  -qQ<size> Set pack-buffer size (default: 1024)",
"  -qd       Turn on PVM-ish debugging",
"  -qO       Disable output for performance measurement",
437
#endif
438
#if defined(THREADED_RTS) || defined(PAR)
439 440
"  -e<n>     Maximum number of outstanding local sparks (default: 4096)",
#endif
441
#if defined(PAR)
442 443
"  -d        Turn on PVM-ish debugging",
"  -O        Disable output for performance measurement",
444 445
#endif /* PAR */
#if defined(GRAN)  /* ToDo: fill in decent Docu here */
446
"  -b...     All GranSim options start with -b; see GranSim User's Guide for details",
447
#endif
448
"",
449 450
"RTS options may also be specified using the GHCRTS environment variable.",
"",
451 452 453 454 455 456
"Other RTS options may be available for programs compiled a different way.",
"The GHC User's Guide has full details.",
"",
0
};

sof's avatar
sof committed
457
STATIC_INLINE rtsBool
458 459 460 461 462
strequal(const char *a, const char * b)
{
    return(strcmp(a, b) == 0);
}

463 464 465 466 467 468 469 470 471 472 473 474 475 476
static void
splitRtsFlags(char *s, int *rts_argc, char *rts_argv[])
{
    char *c1, *c2;

    c1 = s;
    do {
	while (isspace(*c1)) { c1++; };
	c2 = c1;
	while (!isspace(*c2) && *c2 != '\0') { c2++; };
	
	if (c1 == c2) { break; }
	
	if (*rts_argc < MAX_RTS_ARGS-1) {
sof's avatar
sof committed
477
	    s = stgMallocBytes(c2-c1+1, "RtsFlags.c:splitRtsFlags()");
478 479 480 481 482 483 484 485 486 487 488
	    strncpy(s, c1, c2-c1);
	    s[c2-c1] = '\0';
	    rts_argv[(*rts_argc)++] = s;
	} else {
	    barf("too many RTS arguments (max %d)", MAX_RTS_ARGS-1);
	}
	
	c1 = c2;
    } while (*c1 != '\0');
}
    
489 490 491 492 493 494 495
void
setupRtsFlags(int *argc, char *argv[], int *rts_argc, char *rts_argv[])
{
    rtsBool error = rtsFalse;
    I_ mode;
    I_ arg, total_arg;

496
    setProgName (argv);
497 498 499 500 501 502
    total_arg = *argc;
    arg = 1;

    *argc = 1;
    *rts_argc = 0;

503 504 505 506 507 508 509 510 511
    // process arguments from the ghc_rts_opts global variable first.
    // (arguments from the GHCRTS environment variable and the command
    // line override these).
    {
	if (ghc_rts_opts != NULL) {
	    splitRtsFlags(ghc_rts_opts, rts_argc, rts_argv);
	}
    }

512
    // process arguments from the GHCRTS environment variable next
513
    // (arguments from the command line override these).
514 515 516 517
    {
	char *ghc_rts = getenv("GHCRTS");

	if (ghc_rts != NULL) {
518
	    splitRtsFlags(ghc_rts, rts_argc, rts_argv);
519 520
	}
    }
521

522 523 524
    // Split arguments (argv) into PGM (argv) and RTS (rts_argv) parts
    //   argv[0] must be PGM argument -- leave in argv

525 526 527 528 529 530 531 532 533 534 535 536
    for (mode = PGM; arg < total_arg; arg++) {
	// The '--RTS' argument disables all future +RTS ... -RTS processing.
	if (strequal("--RTS", argv[arg])) {
	    arg++;
	    break;
	}
	// The '--' argument is passed through to the program, but
	// disables all further +RTS ... -RTS processing.
	else if (strequal("--", argv[arg])) {
	    break;
	}
	else if (strequal("+RTS", argv[arg])) {
537 538 539 540 541 542 543 544 545 546 547 548 549 550 551
	    mode = RTS;
	}
	else if (strequal("-RTS", argv[arg])) {
	    mode = PGM;
	}
	else if (mode == RTS && *rts_argc < MAX_RTS_ARGS-1) {
	    rts_argv[(*rts_argc)++] = argv[arg];
	}
	else if (mode == PGM) {
	    argv[(*argc)++] = argv[arg];
	}
	else {
	  barf("too many RTS arguments (max %d)", MAX_RTS_ARGS-1);
	}
    }
552 553 554
    // process remaining program arguments
    for (; arg < total_arg; arg++) {
	argv[(*argc)++] = argv[arg];
555 556 557 558 559
    }
    argv[*argc] = (char *) 0;
    rts_argv[*rts_argc] = (char *) 0;

    // Process RTS (rts_argv) part: mainly to determine statsfile
560 561 562
    for (arg = 0; arg < *rts_argc; arg++) {
	if (rts_argv[arg][0] != '-') {
	    fflush(stdout);
563
	    errorBelch("unexpected RTS argument: %s", rts_argv[arg]);
564 565 566 567 568 569 570 571 572 573
	    error = rtsTrue;

        } else {
	    switch(rts_argv[arg][1]) {

	      /* process: general args, then PROFILING-only ones,
		 then CONCURRENT-only, PARallel-only, GRAN-only,
		 TICKY-only (same order as defined in RtsFlags.lh);
		 within those groups, mostly in case-insensitive
		 alphabetical order.
574
                 Final group is x*, which allows for more options.
575 576 577 578 579 580
	      */

#ifdef TICKY_TICKY
# define TICKY_BUILD_ONLY(x) x
#else
# define TICKY_BUILD_ONLY(x) \
581
errorBelch("not built for: ticky-ticky stats"); \
582 583 584 585 586 587 588
error = rtsTrue;
#endif

#if defined(PROFILING) 
# define COST_CENTRE_USING_BUILD_ONLY(x) x
#else
# define COST_CENTRE_USING_BUILD_ONLY(x) \
589
errorBelch("not built for: -prof or -parallel"); \
590 591 592 593 594 595 596
error = rtsTrue;
#endif

#ifdef PROFILING
# define PROFILING_BUILD_ONLY(x)   x
#else
# define PROFILING_BUILD_ONLY(x) \
597
errorBelch("not built for: -prof"); \
598 599 600
error = rtsTrue;
#endif

601 602 603 604
#ifdef PAR
# define PAR_BUILD_ONLY(x)      x
#else
# define PAR_BUILD_ONLY(x) \
605
errorBelch("not built for: -parallel"); \
606 607 608
error = rtsTrue;
#endif

609 610 611 612 613 614 615 616 617 618
#ifdef THREADED_RTS
# define THREADED_BUILD_ONLY(x)      x
#else
# define THREADED_BUILD_ONLY(x) \
errorBelch("not built for: -smp"); \
error = rtsTrue;
#endif

#if defined(THREADED_RTS) || defined(PAR)
# define PAR_OR_THREADED_BUILD_ONLY(x)      x
619
#else
620
# define PAR_OR_THREADED_BUILD_ONLY(x) \
621
errorBelch("not built for: -parallel or -smp"); \
622 623 624 625 626 627 628
error = rtsTrue;
#endif

#ifdef GRAN
# define GRAN_BUILD_ONLY(x)     x
#else
# define GRAN_BUILD_ONLY(x) \
629
errorBelch("not built for: -gransim"); \
630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649
error = rtsTrue;
#endif

	      /* =========== GENERAL ========================== */
	      case '?':
		error = rtsTrue;
		break;

	      case 'A':
		RtsFlags.GcFlags.minAllocAreaSize
		  = decode(rts_argv[arg]+2) / BLOCK_SIZE;
		if (RtsFlags.GcFlags.minAllocAreaSize <= 0) {
		  bad_option(rts_argv[arg]);
		}
		break;

	      case 'B':
		RtsFlags.GcFlags.ringBell = rtsTrue;
		break;

650
	      case 'c':
651 652 653 654
		  if (rts_argv[arg][2] != '\0') {
		      RtsFlags.GcFlags.compactThreshold =
			  atof(rts_argv[arg]+2);
		  } else {
655
		      RtsFlags.GcFlags.compact = rtsTrue;
656 657
		  }
		  break;
658

659 660 661 662 663 664 665
	      case 'F':
	        RtsFlags.GcFlags.oldGenFactor = atof(rts_argv[arg]+2);
	      
		if (RtsFlags.GcFlags.oldGenFactor < 0)
		  bad_option( rts_argv[arg] );
		break;
	      
666 667
#ifdef DEBUG
	      case 'D':
668 669 670 671 672 673 674 675
	      { 
		  char *c;

		  for (c  = rts_argv[arg] + 2; *c != '\0'; c++) {
		      switch (*c) {
		      case 's':
			  RtsFlags.DebugFlags.scheduler = rtsTrue;
			  break;
676 677
		      case 'i':
			  RtsFlags.DebugFlags.interpreter = rtsTrue;
678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708
			  break;
		      case 'w':
			  RtsFlags.DebugFlags.weak = rtsTrue;
			  break;
		      case 'G':
			  RtsFlags.DebugFlags.gccafs = rtsTrue;
			  break;
		      case 'g':
			  RtsFlags.DebugFlags.gc = rtsTrue;
			  break;
		      case 'b':
			  RtsFlags.DebugFlags.block_alloc = rtsTrue;
			  break;
		      case 'S':
			  RtsFlags.DebugFlags.sanity = rtsTrue;
			  break;
		      case 't':
			  RtsFlags.DebugFlags.stable = rtsTrue;
			  break;
		      case 'p':
			  RtsFlags.DebugFlags.prof = rtsTrue;
			  break;
		      case 'r':
			  RtsFlags.DebugFlags.gran = rtsTrue;
			  break;
		      case 'P':
			  RtsFlags.DebugFlags.par = rtsTrue;
			  break;
		      case 'l':
			  RtsFlags.DebugFlags.linker = rtsTrue;
			  break;
709 710 711
		      case 'a':
			  RtsFlags.DebugFlags.apply = rtsTrue;
			  break;
712 713 714
		      case 'm':
			  RtsFlags.DebugFlags.stm = rtsTrue;
			  break;
715 716 717
		      case 'z':
			  RtsFlags.DebugFlags.squeeze = rtsTrue;
			  break;
718 719 720 721 722 723
		      default:
			  bad_option( rts_argv[arg] );
		      }
		  }
		  break;
	      }
724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759
#endif

	      case 'K':
		RtsFlags.GcFlags.maxStkSize = 
		  decode(rts_argv[arg]+2) / sizeof(W_);

		if (RtsFlags.GcFlags.maxStkSize == 0) 
		  bad_option( rts_argv[arg] );
		break;

	      case 'k':
		RtsFlags.GcFlags.initialStkSize = 
		  decode(rts_argv[arg]+2) / sizeof(W_);

		if (RtsFlags.GcFlags.initialStkSize == 0) 
		  bad_option( rts_argv[arg] );
		break;

	      case 'M':
		RtsFlags.GcFlags.maxHeapSize = 
		  decode(rts_argv[arg]+2) / BLOCK_SIZE;
		/* user give size in *bytes* but "maxHeapSize" is in *blocks* */

		if (RtsFlags.GcFlags.maxHeapSize <= 0) {
		  bad_option(rts_argv[arg]);
		}
		break;

	      case 'm':
		RtsFlags.GcFlags.pcFreeHeap = atof(rts_argv[arg]+2);

		if (RtsFlags.GcFlags.pcFreeHeap < 0 || 
		    RtsFlags.GcFlags.pcFreeHeap > 100)
		  bad_option( rts_argv[arg] );
		break;

760 761
	      case 'G':
		RtsFlags.GcFlags.generations = decode(rts_argv[arg]+2);
762
		if (RtsFlags.GcFlags.generations < 1) {
763 764 765 766
		  bad_option(rts_argv[arg]);
		}
		break;

767 768 769 770 771 772 773
	      case 'T':
		RtsFlags.GcFlags.steps = decode(rts_argv[arg]+2);
		if (RtsFlags.GcFlags.steps < 1) {
		  bad_option(rts_argv[arg]);
		}
		break;

774
	      case 'H':
775 776 777 778 779 780
		RtsFlags.GcFlags.heapSizeSuggestion = 
		  decode(rts_argv[arg]+2) / BLOCK_SIZE;

		if (RtsFlags.GcFlags.heapSizeSuggestion <= 0) {
		  bad_option(rts_argv[arg]);
		}
781 782
		break;

783 784 785 786 787 788
#ifdef RTS_GTK_FRONTPANEL
	      case 'f':
		  RtsFlags.GcFlags.frontpanel = rtsTrue;
		  break;
#endif

789 790 791 792 793 794
    	      case 'I':	/* idle GC delay */
		if (rts_argv[arg][2] == '\0') {
		  /* use default */
		} else {
		    I_ cst; /* tmp */

795
		    /* Convert to millisecs */
796
		    cst = (I_) ((atof(rts_argv[arg]+2) * 1000));
797
		    RtsFlags.GcFlags.idleGCDelayTime = cst;
798 799 800
		}
		break;

801
	      case 'S':
802 803
		  RtsFlags.GcFlags.giveStats = VERBOSE_GC_STATS;
		  goto stats;
804

805
	      case 's':
806 807
		  RtsFlags.GcFlags.giveStats = SUMMARY_GC_STATS;
		  goto stats;
808 809

	      case 't':
810 811
		  RtsFlags.GcFlags.giveStats = ONELINE_GC_STATS;
		  goto stats;
812

813
	    stats:
814
#ifdef PAR
815 816
		/* Opening all those files would almost certainly fail... */
		// RtsFlags.ParFlags.ParStats.Full = rtsTrue;
817
		RtsFlags.GcFlags.statsFile = NULL; /* temporary; ToDo: rm */
818
#else
819 820 821 822 823 824 825
		{ 
		    int r;
		    r = open_stats_file(arg, *argc, argv,
					*rts_argc, rts_argv, STAT_FILENAME_FMT,
					&RtsFlags.GcFlags.statsFile);
		    if (r == -1) { error = rtsTrue; }
		}
826
#endif
827
		  break;
828 829 830 831 832 833 834 835 836 837 838

	      case 'Z':
		RtsFlags.GcFlags.squeezeUpdFrames = rtsFalse;
		break;

	      /* =========== PROFILING ========================== */

	      case 'P': /* detailed cost centre profiling (time/alloc) */
	      case 'p': /* cost centre profiling (time/alloc) */
		COST_CENTRE_USING_BUILD_ONLY(
		switch (rts_argv[arg][2]) {
839 840
		  case 'x':
		    RtsFlags.CcFlags.doCostCentres = COST_CENTRES_XML;
841
		    break;
andy's avatar
andy committed
842 843 844
		  case 'a':
		    RtsFlags.CcFlags.doCostCentres = COST_CENTRES_ALL;
		    break;
845
		  default:
846 847 848 849 850 851 852 853
		      if (rts_argv[arg][1] == 'P') {
			  RtsFlags.CcFlags.doCostCentres =
			      COST_CENTRES_VERBOSE;
		      } else {
			  RtsFlags.CcFlags.doCostCentres =
			      COST_CENTRES_SUMMARY;
		      }
		      break;
854 855 856
		}
		) break;

857 858 859 860 861
	      case 'R':
		  PROFILING_BUILD_ONLY(
		      RtsFlags.ProfFlags.maxRetainerSetSize = atof(rts_argv[arg]+2);
  	          ) break;

862 863 864 865 866 867 868 869 870 871 872
	      case 'h': /* serial heap profile */
#if !defined(PROFILING) && defined(DEBUG)
		switch (rts_argv[arg][2]) {
		  case '\0':
		  case 'L':
		    RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_INFOPTR;
		    break;
		  case 'T':
		    RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_CLOSURE_TYPE;
		    break;
		  default:
873
		    errorBelch("invalid heap profile option: %s",rts_argv[arg]);
874 875 876 877 878
		    error = rtsTrue;
		}
#else
		PROFILING_BUILD_ONLY(
		switch (rts_argv[arg][2]) {
879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895
		case '\0':
		case 'C':
		case 'c':
		case 'M':
		case 'm':
		case 'D':
		case 'd':
		case 'Y':
		case 'y':
		case 'R':
		case 'r':
		case 'B':
		case 'b':
		    if (rts_argv[arg][2] != '\0' && rts_argv[arg][3] != '\0') {
			{
			    char *left  = strchr(rts_argv[arg], '{');
			    char *right = strrchr(rts_argv[arg], '}');
896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912

			    // curly braces are optional, for
			    // backwards compat.
			    if (left)
				left = left+1;
			    else
				left = rts_argv[arg] + 3;

			    if (!right)
				right = rts_argv[arg] + strlen(rts_argv[arg]);

			    *right = '\0';

			    switch (rts_argv[arg][2]) {
			    case 'c': // cost centre label select
				RtsFlags.ProfFlags.ccSelector = left;
				break;
913 914 915
			    case 'C':
				RtsFlags.ProfFlags.ccsSelector = left;
				break;
916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935
			    case 'M':
			    case 'm': // cost centre module select
				RtsFlags.ProfFlags.modSelector = left;
				break;
			    case 'D':
			    case 'd': // closure descr select 
				RtsFlags.ProfFlags.descrSelector = left;
				break;
			    case 'Y':
			    case 'y': // closure type select
				RtsFlags.ProfFlags.typeSelector = left;
				break;
			    case 'R':
			    case 'r': // retainer select
				RtsFlags.ProfFlags.retainerSelector = left;
				break;
			    case 'B':
			    case 'b': // biography select
				RtsFlags.ProfFlags.bioSelector = left;
				break;
936 937 938 939
			    }
			}
			break;
		    }
940

941
		    if (RtsFlags.ProfFlags.doHeapProfile != 0) {
942
			errorBelch("multiple heap profile options");
943 944 945 946 947 948 949 950 951 952 953 954
			error = rtsTrue;
			break;
		    }

		    switch (rts_argv[arg][2]) {
		    case '\0':
		    case 'C':
		    case 'c':
			RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_CCS;
			break;
		    case 'M':
		    case 'm':
955 956
			  RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_MOD;
			  break;
957 958
		    case 'D':
		    case 'd':
959 960
			  RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_DESCR;
			  break;
961 962
		    case 'Y':
		    case 'y':
963 964
			  RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_TYPE;
			  break;
965 966
		    case 'R':
		    case 'r':
967 968
			  RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_RETAINER;
			  break;
969 970
		    case 'B':
		    case 'b':
971 972
			  RtsFlags.ProfFlags.doHeapProfile = HEAP_BY_LDV;
			  break;
973 974
		    }
		    break;
975
		      
976
		default:
977
		    errorBelch("invalid heap profile option: %s",rts_argv[arg]);
978 979 980
		    error = rtsTrue;
		}
		) 
981
#endif /* PROFILING */
andy's avatar
andy committed
982 983 984 985 986 987 988 989 990 991 992
    	    	break;

#if defined(PROFILING) 
    	      case 'i':	/* heap sample interval */
		if (rts_argv[arg][2] == '\0') {
		  /* use default */
		} else {
		    I_ cst; /* tmp */

		    /* Convert to milliseconds */
		    cst = (I_) ((atof(rts_argv[arg]+2) * 1000));
993
		    RtsFlags.ProfFlags.profileInterval = cst;
andy's avatar
andy committed
994 995 996
		}
		break;
#endif
997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010

	      /* =========== CONCURRENT ========================= */
    	      case 'C':	/* context switch interval */
		if (rts_argv[arg][2] == '\0')
    	    	    RtsFlags.ConcFlags.ctxtSwitchTime = 0;
		else {
		    I_ cst; /* tmp */

		    /* Convert to milliseconds */
		    cst = (I_) ((atof(rts_argv[arg]+2) * 1000));
		    RtsFlags.ConcFlags.ctxtSwitchTime = cst;
		}
    	    	break;

1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023
              case 'V': /* master tick interval */
                if (rts_argv[arg][2] == '\0') {
                    // turns off ticks completely
                    RtsFlags.MiscFlags.tickInterval = 0;
                } else {
                    I_ cst; /* tmp */

                    /* Convert to milliseconds */
                    cst = (I_) ((atof(rts_argv[arg]+2) * 1000));
                    RtsFlags.MiscFlags.tickInterval = cst;
                }
                break;

1024
#if defined(THREADED_RTS) && !defined(NOSMP)
1025
	      case 'N':
1026
		THREADED_BUILD_ONLY(
1027
		if (rts_argv[arg][2] != '\0') {
1028
		    RtsFlags.ParFlags.nNodes
1029
		      = strtol(rts_argv[arg]+2, (char **) NULL, 10);
1030
		    if (RtsFlags.ParFlags.nNodes <= 0) {
1031
		      errorBelch("bad value for -N");
1032
		      error = rtsTrue;
1033 1034
		    }
		}
1035
		) break;
1036

Simon Marlow's avatar
Simon Marlow committed
1037
	      case 'q':
1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054
		    switch (rts_argv[arg][2]) {
		    case '\0':
			errorBelch("incomplete RTS option: %s",rts_argv[arg]);
			error = rtsTrue;
			break;
		    case 'm':
			RtsFlags.ParFlags.migrate = rtsFalse;
			break;
		    case 'w':
			RtsFlags.ParFlags.wakeupMigrate = rtsTrue;
			break;
		    default:
			errorBelch("unknown RTS option: %s",rts_argv[arg]);
			error = rtsTrue;
			break;
		    }
		    break;
1055
#endif
1056 1057
	      /* =========== PARALLEL =========================== */
	      case 'e':
1058
		PAR_OR_THREADED_BUILD_ONLY(
1059
		if (rts_argv[arg][2] != '\0') {
1060 1061 1062
		    RtsFlags.ParFlags.maxLocalSparks
		      = strtol(rts_argv[arg]+2, (char **) NULL, 10);
		    if (RtsFlags.ParFlags.maxLocalSparks <= 0) {
1063
		      errorBelch("bad value for -e");
1064
		      error = rtsTrue;
1065 1066 1067 1068
		    }
		}
		) break;

1069
#ifdef PAR
1070
    	      case 'q':
1071
		PAR_BUILD_ONLY(
1072
		  process_par_option(arg, rts_argc, rts_argv, &error);
1073
		) break;
1074
#endif
1075 1076 1077 1078 1079

	      /* =========== GRAN =============================== */

    	      case 'b':
		GRAN_BUILD_ONLY(
1080
		  process_gran_option(arg, rts_argc, rts_argv, &error);
1081 1082 1083 1084 1085 1086 1087 1088 1089
		) break;

	      /* =========== TICKY ============================== */

	      case 'r': /* Basic profiling stats */
		TICKY_BUILD_ONLY(

		RtsFlags.TickyFlags.showTickyStats = rtsTrue;

1090 1091 1092 1093 1094 1095 1096
		{ 
		    int r;
		    r = open_stats_file(arg, *argc, argv,
					*rts_argc, rts_argv, TICKY_FILENAME_FMT,
					&RtsFlags.TickyFlags.tickyFile);
		    if (r == -1) { error = rtsTrue; }
		}
1097 1098
	        ) break;

Simon Marlow's avatar
Simon Marlow committed
1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119
	      /* =========== TRACING ---------=================== */

	      case 'v':
                switch(rts_argv[arg][2]) {
		case '\0':
		    errorBelch("incomplete RTS option: %s",rts_argv[arg]);
		    error = rtsTrue;
		    break;
		case 't':
		    RtsFlags.TraceFlags.timestamp = rtsTrue;
		    break;
		case 's':
		    RtsFlags.TraceFlags.sched = rtsTrue;
		    break;
		default:
		    errorBelch("unknown RTS option: %s",rts_argv[arg]);
		    error = rtsTrue;
		    break;
		}
                break;

1120 1121 1122 1123 1124
	      /* =========== EXTENDED OPTIONS =================== */

              case 'x': /* Extend the argument space */
                switch(rts_argv[arg][2]) {
                  case '\0':
1125
		    errorBelch("incomplete RTS option: %s",rts_argv[arg]);
1126 1127 1128 1129 1130
		    error = rtsTrue;
		    break;

                  case 'c': /* Debugging tool: show current cost centre on an exception */
                    PROFILING_BUILD_ONLY(
1131 1132 1133 1134 1135 1136 1137 1138 1139
			RtsFlags.ProfFlags.showCCSOnException = rtsTrue;
			);
		    break;

		case 't':  /* Include memory used by TSOs in a heap profile */
		    PROFILING_BUILD_ONLY(
			RtsFlags.ProfFlags.includeTSOs = rtsTrue;
			);
		    break;
1140 1141 1142 1143

                  /* The option prefix '-xx' is reserved for future extension.  KSW 1999-11. */

	          default:
1144
		    errorBelch("unknown RTS option: %s",rts_argv[arg]);
1145 1146 1147 1148 1149
		    error = rtsTrue;
		    break;
                }
                break;  /* defensive programming */

1150 1151
	      /* =========== OH DEAR ============================ */
	      default:
1152
		errorBelch("unknown RTS option: %s",rts_argv[arg]);
simonm's avatar