summaryrefslogtreecommitdiff
path: root/gnu/usr.bin/binutils/ld/ld.info-4
blob: 2352b4ccae5164f341c8e982fd685882aacc5eb5 (plain)
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
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
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
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
This is Info file ld.info, produced by Makeinfo-1.64 from the input
file ./ld.texinfo.

START-INFO-DIR-ENTRY
* Ld: (ld).                       The GNU linker.
END-INFO-DIR-ENTRY

   This file documents the GNU linker LD.

   Copyright (C) 1991, 92, 93, 94, 95, 96, 1997 Free Software
Foundation, Inc.

   Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.

   Permission is granted to copy and distribute modified versions of
this manual under the conditions for verbatim copying, provided also
that the entire resulting derived work is distributed under the terms
of a permission notice identical to this one.

   Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions.


File: ld.info,  Node: Index,  Prev: MRI,  Up: Top

Index
*****

* Menu:

* ":                                    Symbols.
* *( COMMON ):                          Section Placement.
* *(SECTION):                           Section Placement.
* -(:                                   Options.
* -architecture=ARCH:                   Options.
* -auxiliary:                           Options.
* -cref:                                Options.
* -defsym SYMBOL=EXP:                   Options.
* -discard-all:                         Options.
* -discard-locals:                      Options.
* -dynamic-linker FILE:                 Options.
* -embedded-relocs:                     Options.
* -entry=ENTRY:                         Options.
* -export-dynamic:                      Options.
* -filter:                              Options.
* -force-exe-suffix:                    Options.
* -format=FORMAT:                       Options.
* -gpsize:                              Options.
* -help:                                Options.
* -just-symbols=FILE:                   Options.
* -library-path=DIR:                    Options.
* -library=ARCHIVE:                     Options.
* -mri-script=MRI-CMDFILE:              Options.
* -nmagic:                              Options.
* -no-keep-memory:                      Options.
* -no-whole-archive:                    Options.
* -noinhibit-exec:                      Options.
* -oformat:                             Options.
* -omagic:                              Options.
* -output=OUTPUT:                       Options.
* -print-map:                           Options.
* -relax:                               Options.
* -relocateable:                        Options.
* -script=SCRIPT:                       Options.
* -sort-common:                         Options.
* -split-by-file:                       Options.
* -split-by-reloc:                      Options.
* -stats:                               Options.
* -strip-all:                           Options.
* -strip-debug:                         Options.
* -trace:                               Options.
* -trace-symbol=SYMBOL:                 Options.
* -traditional-format:                  Options.
* -undefined=SYMBOL:                    Options.
* -verbose:                             Options.
* -version:                             Options.
* -version-script=VERSION-SCRIPTFILE:   Options.
* -warn-comon:                          Options.
* -warn-constructors:                   Options.
* -warn-multiple-gp:                    Options.
* -warn-once:                           Options.
* -warn-section-align:                  Options.
* -whole-archive:                       Options.
* -wrap:                                Options.
* -AARCH:                               Options.
* -aKEYWORD:                            Options.
* -assert KEYWORD:                      Options.
* -b FORMAT:                            Options.
* -Bdynamic:                            Options.
* -Bshareable:                          Options.
* -Bstatic:                             Options.
* -Bsymbolic:                           Options.
* -c MRI-CMDFILE:                       Options.
* -call_shared:                         Options.
* -d:                                   Options.
* -dc:                                  Options.
* -dn:                                  Options.
* -dp:                                  Options.
* -dy:                                  Options.
* -E:                                   Options.
* -e ENTRY:                             Options.
* -EB:                                  Options.
* -EL:                                  Options.
* -f:                                   Options.
* -G:                                   Options.
* -hNAME:                               Options.
* -i:                                   Options.
* -lARCHIVE:                            Options.
* -LDIR:                                Options.
* -M:                                   Options.
* -m EMULATION:                         Options.
* -Map:                                 Options.
* -n:                                   Options.
* -non_shared:                          Options.
* -o OUTPUT:                            Options.
* -qmagic:                              Options.
* -Qy:                                  Options.
* -r:                                   Options.
* -R FILE:                              Options.
* -rpath:                               Options.
* -rpath-link:                          Options.
* -S:                                   Options.
* -shared:                              Options.
* -soname=NAME:                         Options.
* -static:                              Options.
* -t:                                   Options.
* -T SCRIPT:                            Options.
* -Tbss ORG:                            Options.
* -Tdata ORG:                           Options.
* -Ttext ORG:                           Options.
* -u SYMBOL:                            Options.
* -Ur:                                  Options.
* -V:                                   Options.
* -X:                                   Options.
* -Y PATH:                              Options.
* -y SYMBOL:                            Options.
* -z KEYWORD:                           Options.
* .:                                    Location Counter.
* 0x:                                   Integers.
* :PHDR:                                Section Options.
* ;:                                    Assignment.
* =FILL:                                Section Options.
* >REGION:                              Section Options.
* -relax on i960:                       i960.
* [SECTION...], not supported:          Section Placement.
* ABSOLUTE (MRI):                       MRI.
* ALIAS (MRI):                          MRI.
* ALIGN (MRI):                          MRI.
* BASE (MRI):                           MRI.
* CHIP (MRI):                           MRI.
* END (MRI):                            MRI.
* FORMAT (MRI):                         MRI.
* ld bugs, reporting:                   Bug Reporting.
* LIST (MRI):                           MRI.
* LOAD (MRI):                           MRI.
* NAME (MRI):                           MRI.
* ORDER (MRI):                          MRI.
* PUBLIC (MRI):                         MRI.
* SECT (MRI):                           MRI.
* GNU linker:                           Overview.
* FILENAME:                             Section Placement.
* FILENAME(SECTION):                    Section Placement.
* SYMBOL = EXPRESSION ;:                Section Data Expressions.
* SYMBOL F= EXPRESSION ;:               Section Data Expressions.
* absolute and relocatable symbols:     Assignment.
* ABSOLUTE(EXP):                        Arithmetic Functions.
* ADDR(SECTION):                        Arithmetic Functions.
* ALIGN(EXP):                           Arithmetic Functions.
* aligning sections:                    Section Options.
* allocating memory:                    MEMORY.
* architectures:                        Options.
* archive files, from cmd line:         Options.
* arithmetic:                           Expressions.
* arithmetic operators:                 Operators.
* assignment in scripts:                Assignment.
* assignment, in section defn:          Section Data Expressions.
* AT ( LDADR ):                         Section Options.
* back end:                             BFD.
* BFD canonical format:                 Canonical format.
* BFD requirements:                     BFD.
* big-endian objects:                   Options.
* binary input files:                   Option Commands.
* binary input format:                  Options.
* BLOCK(ALIGN):                         Section Options.
* bug criteria:                         Bug Criteria.
* bug reports:                          Bug Reporting.
* bugs in ld:                           Reporting Bugs.
* BYTE(EXPRESSION):                     Section Data Expressions.
* C++ constructors, arranging in link:  Option Commands.
* combining symbols, warnings on:       Options.
* command files:                        Commands.
* command line:                         Options.
* commands, fundamental:                Scripts.
* comments:                             Scripts.
* common allocation <1>:                Option Commands.
* common allocation:                    Options.
* commons in output:                    Section Placement.
* compatibility, MRI:                   Options.
* CONSTRUCTORS:                         Option Commands.
* constructors:                         Options.
* constructors, arranging in link:      Option Commands.
* contents of a section:                Section Placement.
* crash of linker:                      Bug Criteria.
* CREATE_OBJECT_SYMBOLS:                Section Data Expressions.
* cross reference table:                Options.
* cross references:                     Option Commands.
* current output location:              Location Counter.
* dbx:                                  Options.
* decimal integers:                     Integers.
* default input format:                 Environment.
* DEFINED(SYMBOL):                      Arithmetic Functions.
* deleting local symbols:               Options.
* direct output:                        Section Data Expressions.
* discontinuous memory:                 MEMORY.
* dot:                                  Location Counter.
* dynamic linker, from command line:    Options.
* dynamic symbol table:                 Options.
* ELF program headers:                  PHDRS.
* emulation:                            Options.
* endianness:                           Options.
* entry point, defaults:                Entry Point.
* entry point, from command line:       Options.
* ENTRY(SYMBOL):                        Entry Point.
* error on valid input:                 Bug Criteria.
* expression evaluation order:          Evaluation.
* expression syntax:                    Expressions.
* expression, absolute:                 Arithmetic Functions.
* expressions in a section:             Section Data Expressions.
* fatal signal:                         Bug Criteria.
* filename symbols:                     Section Data Expressions.
* files and sections, section defn:     Section Placement.
* files, including in output sections:  Section Placement.
* fill pattern, entire section:         Section Options.
* FILL(EXPRESSION):                     Section Data Expressions.
* first input file:                     Option Commands.
* first instruction:                    Entry Point.
* FLOAT:                                Option Commands.
* FORCE_COMMON_ALLOCATION:              Option Commands.
* format, output file:                  Option Commands.
* functions in expression language:     Arithmetic Functions.
* fundamental script commands:          Scripts.
* GNUTARGET <1>:                        Option Commands.
* GNUTARGET:                            Environment.
* GROUP ( FILES ):                      Option Commands.
* grouping input files:                 Option Commands.
* groups of archives:                   Options.
* H8/300 support:                       H8/300.
* header size:                          Arithmetic Functions.
* help:                                 Options.
* hexadecimal integers:                 Integers.
* holes:                                Location Counter.
* holes, filling:                       Section Data Expressions.
* i960 support:                         i960.
* INCLUDE FILENAME:                     Option Commands.
* including a linker script:            Option Commands.
* including an entire archive:          Options.
* incremental link:                     Options.
* INPUT ( FILES ):                      Option Commands.
* input file format:                    Option Commands.
* input filename symbols:               Section Data Expressions.
* input files, displaying:              Options.
* input files, section defn:            Section Placement.
* input format:                         Options.
* input sections to output section:     Section Placement.
* integer notation:                     Integers.
* integer suffixes:                     Integers.
* internal object-file format:          Canonical format.
* invalid input:                        Bug Criteria.
* K and M integer suffixes:             Integers.
* l =:                                  MEMORY.
* L, deleting symbols beginning:        Options.
* layout of output file:                Scripts.
* lazy evaluation:                      Evaluation.
* len =:                                MEMORY.
* LENGTH =:                             MEMORY.
* link map:                             Options.
* link-time runtime library search path: Options.
* linker crash:                         Bug Criteria.
* little-endian objects:                Options.
* load address, specifying:             Section Options.
* LOADADDR(SECTION):                    Arithmetic Functions.
* loading, preventing:                  Section Options.
* local symbols, deleting:              Options.
* location counter:                     Location Counter.
* LONG(EXPRESSION):                     Section Data Expressions.
* M and K integer suffixes:             Integers.
* machine architecture, output:         Option Commands.
* machine dependencies:                 Machine Dependent.
* MAX:                                  Arithmetic Functions.
* MEMORY:                               MEMORY.
* memory region attributes:             MEMORY.
* memory regions and sections:          Section Options.
* memory usage:                         Options.
* MIN:                                  Arithmetic Functions.
* MIPS embedded PIC code:               Options.
* MRI compatibility:                    MRI.
* names:                                Symbols.
* naming memory regions:                MEMORY.
* naming output sections:               Section Definition.
* naming the output file <1>:           Option Commands.
* naming the output file:               Options.
* negative integers:                    Integers.
* NEXT(EXP):                            Arithmetic Functions.
* NMAGIC:                               Options.
* NOCROSSREFS ( SECTIONS ):             Option Commands.
* NOFLOAT:                              Option Commands.
* NOLOAD:                               Section Options.
* Non constant expression:              Assignment.
* o =:                                  MEMORY.
* objdump -i:                           BFD.
* object file management:               BFD.
* object files:                         Options.
* object formats available:             BFD.
* object size:                          Options.
* octal integers:                       Integers.
* OMAGIC:                               Options.
* opening object files:                 BFD outline.
* Operators for arithmetic:             Operators.
* options:                              Options.
* org =:                                MEMORY.
* ORIGIN =:                             MEMORY.
* OUTPUT ( FILENAME ):                  Option Commands.
* output file after errors:             Options.
* output file layout:                   Scripts.
* OUTPUT_ARCH ( BFDNAME ):              Option Commands.
* OUTPUT_FORMAT ( BFDNAME ):            Option Commands.
* OVERLAY:                              Overlays.
* overlays:                             Overlays.
* partial link:                         Options.
* path for libraries:                   Option Commands.
* PHDRS:                                PHDRS.
* precedence in expressions:            Operators.
* prevent unnecessary loading:          Section Options.
* program headers:                      PHDRS.
* program headers and sections:         Section Options.
* provide:                              Assignment.
* QUAD(EXPRESSION):                     Section Data Expressions.
* quoted symbol names:                  Symbols.
* read-only text:                       Options.
* read/write from cmd line:             Options.
* regions of memory:                    MEMORY.
* relaxing addressing modes:            Options.
* relaxing on H8/300:                   H8/300.
* relaxing on i960:                     i960.
* relocatable and absolute symbols:     Assignment.
* relocatable output:                   Options.
* reporting bugs in ld:                 Reporting Bugs.
* requirements for BFD:                 BFD.
* retaining specified symbols:          Options.
* rounding up location counter:         Arithmetic Functions.
* runtime library name:                 Options.
* runtime library search path:          Options.
* scaled integers:                      Integers.
* script files:                         Options.
* search directory, from cmd line:      Options.
* search path, libraries:               Option Commands.
* SEARCH_DIR ( PATH ):                  Option Commands.
* section address <1>:                  Arithmetic Functions.
* section address:                      Section Options.
* section alignment:                    Section Options.
* section alignment, warnings on:       Options.
* section definition:                   Section Definition.
* section defn, full syntax:            Section Options.
* section fill pattern:                 Section Options.
* section load address:                 Arithmetic Functions.
* section size:                         Arithmetic Functions.
* section start:                        Section Options.
* section, assigning to memory region:  Section Options.
* section, assigning to program header: Section Options.
* SECTIONS:                             SECTIONS.
* segment origins, cmd line:            Options.
* semicolon:                            Assignment.
* shared libraries:                     Options.
* SHORT(EXPRESSION):                    Section Data Expressions.
* SIZEOF(SECTION):                      Arithmetic Functions.
* sizeof_headers:                       Arithmetic Functions.
* specify load address:                 Section Options.
* standard Unix system:                 Options.
* start address, section:               Section Options.
* start of execution:                   Entry Point.
* STARTUP ( FILENAME ):                 Option Commands.
* strip all symbols:                    Options.
* strip debugger symbols:               Options.
* stripping all but some symbols:       Options.
* suffixes for integers:                Integers.
* symbol defaults:                      Arithmetic Functions.
* symbol definition, scripts:           Assignment.
* symbol names:                         Symbols.
* symbol tracing:                       Options.
* symbol versions:                      Version Script.
* symbol-only input:                    Options.
* symbols, from command line:           Options.
* symbols, relocatable and absolute:    Assignment.
* symbols, retaining selectively:       Options.
* synthesizing linker:                  Options.
* synthesizing on H8/300:               H8/300.
* TARGET ( FORMAT ):                    Option Commands.
* traditional format:                   Options.
* unallocated address, next:            Arithmetic Functions.
* undefined symbol:                     Options.
* undefined symbols, warnings on:       Options.
* uninitialized data:                   Section Placement.
* unspecified memory:                   Section Data Expressions.
* usage:                                Options.
* variables, defining:                  Assignment.
* verbose:                              Options.
* version:                              Options.
* VERSION {script text}:                Version Script.
* version script:                       Version Script.
* version script, symbol versions:      Options.
* versions of symbols:                  Version Script.
* warnings, on combining symbols:       Options.
* warnings, on section alignment:       Options.
* warnings, on undefined symbols:       Options.
* what is this?:                        Overview.