SLAU131V October   2004  – February 2020

 

  1.   1
    1.     2
    2.     3
    3.     4
    4.     5
    5.     6
  2.   7
    1.     8
    2.     9
  3.   10
    1.     11
    2.     12
    3.     13
      1.      14
    4.     15
      1.      16
      2.      17
      3.      18
      4.      19
        1.       20
        2.       21
      5.      22
      6.      23
      7.      24
    5.     25
      1.      26
      2.      27
    6.     28
      1.      29
      2.      30
      3.      31
      4.      32
    7.     33
      1.      34
      2.      35
    8.     36
  4.   37
    1.     38
      1.      39
      2.      40
        1.       41
        2.       42
        3.       43
        4.       44
        5.       45
          1.        46
    2.     47
    3.     48
      1.      49
      2.      50
        1.       51
        2.       52
        3.       53
      3.      54
        1.       55
        2.       56
    4.     57
    5.     58
    6.     59
  5.   60
    1.     61
    2.     62
    3.     63
    4.     64
    5.     65
      1.      66
      2.      67
    6.     68
      1.      69
      2.      70
      3.      71
        1.       72
      4.      73
    7.     74
      1.      75
        1.       76
        2.       77
        3.       78
        4.       79
        5.       80
      2.      81
      3.      82
    8.     83
      1.      84
      2.      85
      3.      86
        1.       87
      4.      88
      5.      89
      6.      90
      7.      91
      8.      92
      9.      93
    9.     94
      1.      95
      2.      96
      3.      97
    10.     98
      1.      99
      2.      100
    11.     101
    12.     102
      1.      103
      2.      104
    13.     105
      1.      106
  6.   107
    1.     108
    2.     109
      1.      110
    3.     111
    4.     112
    5.     113
    6.     114
    7.     115
    8.     116
    9.     117
    10.     118
    11.     119
    12.     120
  7.   121
    1.     122
    2.     123
      1.      124
    3.     125
      1.      126
      2.      127
        1.       128
        2.       129
      3.      130
      4.      131
      5.      132
      6.      133
      7.      134
        1.       135
      8.      136
      9.      137
      10.      138
      11.      139
    4.     140
    5.     141
      1.      142
      2.      143
      3.      144
    6.     145
      1.      146
    7.     147
      1.      148
    8.     149
    9.     150
      1.      151
      2.      152
    10.     153
  8.   154
    1.     155
    2.     156
    3.     157
    4.     158
      1.      159
    5.     160
      1.      161
      2.      162
      3.      163
      4.      164
  9.   165
    1.     166
    2.     167
    3.     168
    4.     169
      1.      170
      2.      171
      3.      172
        1.       173
        2.       174
        3.       175
      4.      176
      5.      177
      6.      178
      7.      179
      8.      180
      9.      181
      10.      182
      11.      183
      12.      184
      13.      185
      14.      186
      15.      187
        1.       188
        2.       189
        3.       190
      16.      191
        1.       192
      17.      193
      18.      194
      19.      195
      20.      196
      21.      197
      22.      198
      23.      199
      24.      200
      25.      201
      26.      202
      27.      203
      28.      204
      29.      205
      30.      206
      31.      207
      32.      208
      33.      209
      34.      210
      35.      211
    5.     212
      1.      213
      2.      214
      3.      215
      4.      216
      5.      217
      6.      218
        1.       219
        2.       220
          1.        221
        3.       222
          1.        223
      7.      224
        1.       225
          1.        226
        2.       227
          1.        228
          2.        229
          3.        230
          4.        231
            1.         232
            2.         233
          5.        234
          6.        235
        3.       236
          1.        237
        4.       238
        5.       239
          1.        240
        6.       241
        7.       242
      8.      243
        1.       244
        2.       245
          1.        246
          2.        247
      9.      248
        1.       249
          1.        250
        2.       251
          1.        252
          2.        253
        3.       254
        4.       255
          1.        256
        5.       257
        6.       258
      10.      259
      11.      260
        1.       261
        2.       262
        3.       263
      12.      264
        1.       265
        2.       266
        3.       267
        4.       268
        5.       269
        6.       270
        7.       271
          1.        272
          2.        273
          3.        274
          4.        275
        8.       276
      13.      277
        1.       278
        2.       279
        3.       280
        4.       281
    6.     282
      1.      283
      2.      284
      3.      285
    7.     286
      1.      287
      2.      288
      3.      289
    8.     290
      1.      291
      2.      292
      3.      293
        1.       294
      4.      295
        1.       296
        2.       297
        3.       298
        4.       299
          1.        300
        5.       301
          1.        302
        6.       303
          1.        304
          2.        305
      5.      306
        1.       307
        2.       308
        3.       309
        4.       310
        5.       311
      6.      312
        1.       313
      7.      314
        1.       315
    9.     316
      1.      317
      2.      318
      3.      319
        1.       320
        2.       321
        3.       322
        4.       323
      4.      324
        1.       325
      5.      326
    10.     327
    11.     328
      1.      329
      2.      330
      3.      331
      4.      332
      5.      333
    12.     334
      1.      335
      2.      336
  10.   337
    1.     338
    2.     339
    3.     340
      1.      341
      2.      342
  11.   343
    1.     344
    2.     345
    3.     346
      1.      347
  12.   348
    1.     349
    2.     350
    3.     351
    4.     352
  13.   353
    1.     354
    2.     355
      1.      356
      2.      357
    3.     358
      1.      359
      2.      360
      3.      361
      4.      362
    4.     363
      1.      364
      2.      365
        1.       366
        2.       367
    5.     368
    6.     369
      1.      370
      2.      371
    7.     372
    8.     373
    9.     374
      1.      375
      2.      376
      3.      377
    10.     378
    11.     379
    12.     380
    13.     381
      1.      382
      2.      383
      3.      384
      4.      385
      5.      386
      6.      387
        1.       388
  14.   389
    1.     390
    2.     391
      1.      392
      2.      393
      3.      394
      4.      395
      5.      396
      6.      397
      7.      398
      8.      399
      9.      400
      10.      401
      11.      402
      12.      403
      13.      404
      14.      405
      15.      406
      16.      407
    3.     408
      1.      409
      2.      410
      3.      411
      4.      412
    4.     413
      1.      414
      2.      415
      3.      416
      4.      417
      5.      418
      6.      419
      7.      420
  15.   421
    1.     422
    2.     423
  16.   424
    1.     425
    2.     426
      1.      427
        1.       428
      2.      429
        1.       430
      3.      431
        1.       432
      4.      433
        1.       434
      5.      435
        1.       436
      6.      437
        1.       438
      7.      439
        1.       440
  17.   441
    1.     442
      1.      443
    2.     444
      1.      445
      2.      446
      3.      447
      4.      448
      5.      449
      6.      450
  18.   451
    1.     452
  19.   453
    1.     454

Linker Options

Linker options control linking operations. They can be placed on the command line or in a command file. Linker options must be preceded by a hyphen (-). Options can be separated from arguments (if they have them) by an optional space.

Table 8-1 Basic Options Summary

Option Alias Description Section
--run_linker -z Enables linking Section 8.3
--output_file -o Names the executable output module. The default filename is a.out. Section 8.4.22
--map_file -m Produces a map or listing of the input and output sections, including holes, and places the listing in filename Section 8.4.17
--stack_size -stack Sets C system stack size to sizebytes and defines a global symbol that specifies the stack size. Default = 128 bytes Section 8.4.28
--heap_size -heap Sets heap size (for the dynamic memory allocation in C) to sizebytes and defines a global symbol that specifies the heap size. Default = 128 bytes Section 8.4.13

Table 8-2 File Search Path Options Summary

Option Alias Description Section
--library -l Names an archive library or link command filename as linker input Section 8.4.15
--disable_auto_rts Disables the automatic selection of a run-time-support library Section 8.4.7
--priority -priority Satisfies unresolved references by the first library that contains a definition for that symbol Section 8.4.15.3
--reread_libs -x Forces rereading of libraries, which resolves back references Section 8.4.15.3
--search_path -i Alters library-search algorithms to look in a directory named with pathname before looking in the default location. This option must appear before the --library option. Section 8.4.15.1

Table 8-3 Command File Preprocessing Options Summary

Option Alias Description Section
--define Predefines name as a preprocessor macro. Section 8.4.9
--undefine Removes the preprocessor macro name. Section 8.4.9
--disable_pp Disables preprocessing for command files Section 8.4.9

Table 8-4 Diagnostic Options Summary

Option Alias Description Section
--diag_error Categorizes the diagnostic identified by num as an error Section 8.4.6
--diag_remark Categorizes the diagnostic identified by num as a remark Section 8.4.6
--diag_suppress Suppresses the diagnostic identified by num Section 8.4.6
--diag_warning Categorizes the diagnostic identified by num as a warning Section 8.4.6
--display_error_number Displays a diagnostic's identifiers along with its text Section 8.4.6
--emit_references:file[=file] Emits a file containing section information. The information includes section size, symbols defined, and references to symbols. Section 8.4.6
--emit_warnings_as_errors -pdew Treats warnings as errors Section 8.4.6
--issue_remarks Issues remarks (nonserious warnings) Section 8.4.6
--no_demangle Disables demangling of symbol names in diagnostics Section 8.4.19
--no_warnings Suppresses warning diagnostics (errors are still issued) Section 8.4.6
--set_error_limit Sets the error limit to num. The linker abandons linking after this number of errors. (The default is 100.) Section 8.4.6
--verbose_diagnostics Provides verbose diagnostics that display the original source with line-wrap Section 8.4.6
--warn_sections -w Displays a message when an undefined output section is created Section 8.4.33

Table 8-5 Linker Output Options Summary

Option Alias Description Section
--absolute_exe -a Produces an absolute, executable module. This is the default; if neither --absolute_exe nor --relocatable is specified, the linker acts as if --absolute_exe were specified. Section 8.4.3.1
--ecc={ on | off } Enable linker-generated Error Correcting Codes (ECC). The default is off. Section 8.4.10
Section 8.5.9
--ecc:data_error Inject the specified errors into the output file for testing Section 8.4.10
Section 8.5.9
--ecc:ecc_error Inject the specified errors into the Error Correcting Code (ECC) for testing Section 8.4.10
Section 8.5.9
--mapfile_contents Controls the information that appears in the map file. Section 8.4.18
--relocatable -r Produces a nonexecutable, relocatable output module Section 8.4.3.2
--rom -r Create a ROM object
--run_abs -abs Produces an absolute listing file Section 8.4.26
--xml_link_info Generates a well-formed XML file containing detailed information about the result of a link Section 8.4.34

Table 8-6 Symbol Management Options Summary

Option Alias Description Section
--entry_point -e Defines a global symbol that specifies the primary entry point for the output module Section 8.4.11
--globalize Changes the symbol linkage to global for symbols that match pattern Section 8.4.16
--hide Hides global symbols that match pattern Section 8.4.14
--localize Changes the symbol linkage to local for symbols that match pattern Section 8.4.16
--make_global -g Makes symbol global (overrides -h) Section 8.4.16.1
--make_static -h Makes all global symbols static Section 8.4.16.1
--no_symtable -s Strips symbol table information and line number entries from the output module Section 8.4.21
--retain Retains a list of sections that otherwise would be discarded Section 8.4.25
--scan_libraries -scanlibs Scans all libraries for duplicate symbol definitions Section 8.4.27
--symbol_map Maps symbol references to a symbol definition of a different name Section 8.4.30
--undef_sym -u Places an unresolved external symbol into the output module's symbol table Section 8.4.31
--unhide Reveals (un-hides) global symbols that match pattern Section 8.4.14

Table 8-7 Run-Time Environment Options Summary

Option Alias Description Section
--arg_size --args Allocates memory to be used by the loader to pass arguments Section 8.4.4
--cinit_hold_wdt={on|off} Hold (on) or do not hold (off) watchdog timer during cinit auto-initialization. Section 8.11.5
--fill_value -f Sets default fill values for holes within output sections; fill_value is a 32-bit constant Section 8.4.12
--ram_model -cr Initializes variables at load time Section 8.4.24
--rom_model -c Autoinitializes variables at run time Section 8.4.24
--use_hw_mpy[={16|32|F5|none}] This option is now a compiler option. It should be placed on the command line before the --run_linker or -z option. See the MSP430 Optimizing C/C++ Compiler User's Guide for details. --

Table 8-8 Link-Time Optimization Options Summary

Option Alias Description Section
--cinit_compression [=compression_kind] Specifies the type of compression to apply to the C auto initialization data. The default if this option is used with no kind specified is lzss for Lempel-Ziv-Storer-Szymanski compression. Alternately, specify --cinit_compression=rle to use Run Length Encoded compression, which generally provides less efficient compression. Section 8.4.5
--copy_compression [=compression_kind] Compresses data copied by linker copy tables Section 8.4.5
--unused_section_elimination Eliminates sections that are not needed in the executable module; on by default Section 8.4.8

Table 8-9 Miscellaneous Options Summary

Option Alias Description Section
--linker_help -help Displays information about syntax and available options
--preferred_order Prioritizes placement of functions Section 8.4.23
--strict_compatibility Performs more conservative and rigorous compatibility checking of input object files Section 8.4.29