.\" ========================================================================
.\"
.IX Title "ADDR2LINE 1"
-.TH ADDR2LINE 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH ADDR2LINE 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
addr2line \- convert addresses into file names and line numbers.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "AR 1"
-.TH AR 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH AR 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
ar \- create, modify, and extract from archives
.SH "SYNOPSIS"
************
This brief manual contains documentation for the GNU binary utilities
-(collectively version 2.15.96):
+(collectively version 2.15.97):
This document is distributed under the terms of the GNU Free
Documentation License. A copy of the license is included in the
[`-h'|`--file-header']
[`-l'|`--program-headers'|`--segments']
[`-S'|`--section-headers'|`--sections']
+ [`-g'|`--section-groups']
[`-e'|`--headers']
[`-s'|`--syms'|`--symbols']
[`-n'|`--notes']
Displays the information contained in the file's section headers,
if it has any.
+`-g'
+`--section-groups'
+ Displays the information contained in the file's section groups,
+ if it has any.
+
`-s'
`--symbols'
`--syms'
Only the unwind sections for IA64 ELF files are currently
supported.
-`-u'
-`--unwind'
- Displays the contents of the file's unwind section, if it has one.
- Only the unwind sections for IA64 ELF files are currently
- supported.
-
`-d'
`--dynamic'
Displays the contents of the file's dynamic section, if it has one.
* dynamic symbol table entries, printing: objdump. (line 334)
* dynamic symbols: nm. (line 136)
* ELF dynamic section information: readelf. (line 97)
-* ELF file header information: readelf. (line 49)
+* ELF file header information: readelf. (line 50)
* ELF file information: readelf. (line 6)
-* ELF notes: readelf. (line 76)
+* ELF notes: readelf. (line 82)
* ELF object file format: objdump. (line 310)
-* ELF program header information: readelf. (line 55)
-* ELF reloc information: readelf. (line 80)
-* ELF section information: readelf. (line 61)
-* ELF segment information: readelf. (line 55)
-* ELF symbol table information: readelf. (line 67)
+* ELF program header information: readelf. (line 56)
+* ELF reloc information: readelf. (line 86)
+* ELF section group information: readelf. (line 67)
+* ELF section information: readelf. (line 62)
+* ELF segment information: readelf. (line 56)
+* ELF symbol table information: readelf. (line 73)
* ELF version sections informations: readelf. (line 101)
* endianness: objdump. (line 125)
* error on valid input: Bug Criteria. (line 12)
* symbols, discarding: strip. (line 6)
* undefined symbols: nm. (line 217)
* Unix compatibility, ar: ar cmdline. (line 8)
-* unwind information: readelf. (line 85)
+* unwind information: readelf. (line 91)
* updating an archive: ar cmdline. (line 180)
* version: Top. (line 6)
* VMA in objdump: objdump. (line 65)
Node: dlltool\7f89216
Node: def file format\7f99642
Node: readelf\7f101380
-Node: Selecting The Target System\7f105783
-Node: Target Selection\7f106708
-Node: Architecture Selection\7f108690
-Node: Reporting Bugs\7f109518
-Node: Bug Criteria\7f110297
-Node: Bug Reporting\7f110850
-Node: GNU Free Documentation License\7f117944
-Node: Index\7f137671
+Node: Selecting The Target System\7f105769
+Node: Target Selection\7f106694
+Node: Architecture Selection\7f108676
+Node: Reporting Bugs\7f109504
+Node: Bug Criteria\7f110283
+Node: Bug Reporting\7f110836
+Node: GNU Free Documentation License\7f117930
+Node: Index\7f137657
\1f
End Tag Table
.\" ========================================================================
.\"
.IX Title "C++FILT 1"
-.TH C++FILT 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH C++FILT 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
cxxfilt \- Demangle C++ and Java symbols.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "DLLTOOL 1"
-.TH DLLTOOL 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH DLLTOOL 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
dlltool \- Create files needed to build and use DLLs.
.SH "SYNOPSIS"
.PP
.Vb 2
\& asm (".section .drectve");
-\& asm (".ascii \e"-export:my_func\e"");
+\& asm (".ascii \e"\-export:my_func\e"");
.Ve
.PP
.Vb 1
that uses that \s-1DLL:\s0
.PP
.Vb 4
-\& gcc -c dll.c
-\& dlltool -e exports.o -l dll.lib dll.o
-\& gcc dll.o exports.o -o dll.dll
-\& gcc program.o dll.lib -o program
+\& gcc \-c dll.c
+\& dlltool \-e exports.o \-l dll.lib dll.o
+\& gcc dll.o exports.o \-o dll.dll
+\& gcc program.o dll.lib \-o program
.Ve
.SH "OPTIONS"
.IX Header "OPTIONS"
.\" ========================================================================
.\"
.IX Title "NLMCONV 1"
-.TH NLMCONV 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH NLMCONV 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
nlmconv \- converts object code into an NLM.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "NM 1"
-.TH NM 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH NM 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
nm \- list symbols from object files
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "OBJCOPY 1"
-.TH OBJCOPY 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH OBJCOPY 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
objcopy \- copy and translate object files
.SH "SYNOPSIS"
For example:
.Sp
.Vb 1
-\& -w -W !foo -W fo*
+\& \-w \-W !foo \-W fo*
.Ve
.Sp
would cause objcopy to weaken all symbols that start with ``fo''
data you could use the following command line to achieve it:
.Sp
.Vb 3
-\& objcopy
-I binary -O <output_format> -B <architecture> \e
-\& --rename-section .data=.rodata,alloc,load,readonly,data,contents \e
+\& objcopy
\-I binary \-O <output_format> \-B <architecture> \e
+\& \-\-rename\-section .data=.rodata,alloc,load,readonly,data,contents \e
\& <input_binary_file> <output_object_file>
.Ve
.IP "\fB\-\-change\-leading\-char\fR" 4
.\" ========================================================================
.\"
.IX Title "OBJDUMP 1"
-.TH OBJDUMP 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH OBJDUMP 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
objdump \- display information from object files.
.SH "SYNOPSIS"
For example,
.Sp
.Vb 1
-\& objdump -b oasys -m vax -h fu.o
+\& objdump \-b oasys \-m vax \-h fu.o
.Ve
.Sp
displays summary information from the section headers (\fB\-h\fR) of
.\" ========================================================================
.\"
.IX Title "RANLIB 1"
-.TH RANLIB 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH RANLIB 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
ranlib \- generate index to archive.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "READELF 1"
-.TH READELF 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH READELF 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
readelf \- Displays information about ELF files.
.SH "SYNOPSIS"
[\fB\-h\fR|\fB\-\-file\-header\fR]
[\fB\-l\fR|\fB\-\-program\-headers\fR|\fB\-\-segments\fR]
[\fB\-S\fR|\fB\-\-section\-headers\fR|\fB\-\-sections\fR]
+ [\fB\-g\fR|\fB\-\-section\-groups\fR]
[\fB\-e\fR|\fB\-\-headers\fR]
[\fB\-s\fR|\fB\-\-syms\fR|\fB\-\-symbols\fR]
[\fB\-n\fR|\fB\-\-notes\fR]
.PD
Displays the information contained in the file's section headers, if it
has any.
+.IP "\fB\-g\fR" 4
+.IX Item "-g"
+.PD 0
+.IP "\fB\-\-section\-groups\fR" 4
+.IX Item "--section-groups"
+.PD
+Displays the information contained in the file's section groups, if it
+has any.
.IP "\fB\-s\fR" 4
.IX Item "-s"
.PD 0
.PD
Displays the contents of the file's unwind section, if it has one. Only
the unwind sections for \s-1IA64\s0 \s-1ELF\s0 files are currently supported.
-.IP "\fB\-u\fR" 4
-.IX Item "-u"
-.PD 0
-.IP "\fB\-\-unwind\fR" 4
-.IX Item "--unwind"
-.PD
-Displays the contents of the file's unwind section, if it has one. Only
-the unwind sections for \s-1IA64\s0 \s-1ELF\s0 files are currently supported.
.IP "\fB\-d\fR" 4
.IX Item "-d"
.PD 0
.\" ========================================================================
.\"
.IX Title "SIZE 1"
-.TH SIZE 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH SIZE 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
size \- list section sizes and total size.
.SH "SYNOPSIS"
\&\fBsize\fR:
.Sp
.Vb 4
-\& $ size --format=Berkeley ranlib size
+\& $ size \-\-format=Berkeley ranlib size
\& text data bss dec hex filename
\& 294880 81920 11592 388392 5ed28 ranlib
\& 294880 81920 11888 388688 5ee50 size
This is the same data, but displayed closer to System V conventions:
.Sp
.Vb 7
-\& $ size --format=SysV ranlib size
+\& $ size \-\-format=SysV ranlib size
\& ranlib :
\& section size addr
\& .text 294880 8192
.\" ========================================================================
.\"
.IX Title "STRINGS 1"
-.TH STRINGS 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH STRINGS 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
strings \- print the strings of printable characters in files.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "STRIP 1"
-.TH STRIP 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH STRIP 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
strip \- Discard symbols from object files.
.SH "SYNOPSIS"
For example:
.Sp
.Vb 1
-\& -w -K !foo -K fo*
+\& \-w \-K !foo \-K fo*
.Ve
.Sp
would cause strip to only keep symbols that start with the letters
.\" ========================================================================
.\"
.IX Title "WINDRES 1"
-.TH WINDRES 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH WINDRES 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
windres \- manipulate Windows resources.
.SH "SYNOPSIS"
.\" ========================================================================
.\"
.IX Title "AS 1"
-.TH AS 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH AS 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
AS \- the portable GNU assembler.
.SH "SYNOPSIS"
by commas. For example:
.PP
.Vb 1
-\& gcc -c -g -O -Wa,-alh,-L file.c
+\& gcc \-c \-g \-O \-Wa,\-alh,\-L file.c
.Ve
.PP
This passes two options to the assembler: \fB\-alh\fR (emit a listing to
Indirect:
as.info-1: 778
as.info-2: 299494
-as.info-3: 569799
+as.info-3: 569898
\1f
Tag Table:
(Indirect)
Node: M88K Directives\7f372041
Node: MIPS-Dependent\7f373561
Node: MIPS Opts\7f374648
-Node: MIPS Object\7f381517
-Node: MIPS Stabs\7f383083
-Node: MIPS symbol sizes\7f383805
-Node: MIPS ISA\7f385474
-Node: MIPS autoextend\7f386623
-Node: MIPS insn\7f387353
-Node: MIPS option stack\7f387850
-Node: MIPS ASE instruction generation overrides\7f388624
-Node: MMIX-Dependent\7f389397
-Node: MMIX-Opts\7f389777
-Node: MMIX-Expand\7f393381
-Node: MMIX-Syntax\7f394696
-Ref: mmixsite\7f395053
-Node: MMIX-Chars\7f395894
-Node: MMIX-Symbols\7f396548
-Node: MMIX-Regs\7f398616
-Node: MMIX-Pseudos\7f399641
-Ref: MMIX-loc\7f399782
-Ref: MMIX-local\7f400862
-Ref: MMIX-is\7f401394
-Ref: MMIX-greg\7f401665
-Ref: GREG-base\7f402584
-Ref: MMIX-byte\7f403901
-Ref: MMIX-constants\7f404372
-Ref: MMIX-prefix\7f405018
-Ref: MMIX-spec\7f405392
-Node: MMIX-mmixal\7f405726
-Node: MSP430-Dependent\7f409223
-Node: MSP430 Options\7f409689
-Node: MSP430 Syntax\7f409881
-Node: MSP430-Macros\7f410197
-Node: MSP430-Chars\7f410928
-Node: MSP430-Regs\7f411241
-Node: MSP430-Ext\7f411801
-Node: MSP430 Floating Point\7f413622
-Node: MSP430 Directives\7f413846
-Node: MSP430 Opcodes\7f414637
-Node: MSP430 Profiling Capability\7f415032
-Node: PDP-11-Dependent\7f417361
-Node: PDP-11-Options\7f417750
-Node: PDP-11-Pseudos\7f422821
-Node: PDP-11-Syntax\7f423166
-Node: PDP-11-Mnemonics\7f423917
-Node: PDP-11-Synthetic\7f424219
-Node: PJ-Dependent\7f424437
-Node: PJ Options\7f424662
-Node: PPC-Dependent\7f424939
-Node: PowerPC-Opts\7f425226
-Node: PowerPC-Pseudo\7f427191
-Node: SH-Dependent\7f427790
-Node: SH Options\7f428202
-Node: SH Syntax\7f429056
-Node: SH-Chars\7f429329
-Node: SH-Regs\7f429623
-Node: SH-Addressing\7f430237
-Node: SH Floating Point\7f431146
-Node: SH Directives\7f432240
-Node: SH Opcodes\7f432610
-Node: SH64-Dependent\7f436932
-Node: SH64 Options\7f437295
-Node: SH64 Syntax\7f439012
-Node: SH64-Chars\7f439295
-Node: SH64-Regs\7f439595
-Node: SH64-Addressing\7f440691
-Node: SH64 Directives\7f441874
-Node: SH64 Opcodes\7f442984
-Node: Sparc-Dependent\7f443700
-Node: Sparc-Opts\7f444085
-Node: Sparc-Aligned-Data\7f446342
-Node: Sparc-Float\7f447197
-Node: Sparc-Directives\7f447398
-Node: TIC54X-Dependent\7f449358
-Node: TIC54X-Opts\7f450084
-Node: TIC54X-Block\7f451127
-Node: TIC54X-Env\7f451487
-Node: TIC54X-Constants\7f451835
-Node: TIC54X-Subsyms\7f452237
-Node: TIC54X-Locals\7f454146
-Node: TIC54X-Builtins\7f454890
-Node: TIC54X-Ext\7f457361
-Node: TIC54X-Directives\7f457932
-Node: TIC54X-Macros\7f468834
-Node: TIC54X-MMRegs\7f470944
-Node: Z8000-Dependent\7f471160
-Node: Z8000 Options\7f472124
-Node: Z8000 Syntax\7f472341
-Node: Z8000-Chars\7f472631
-Node: Z8000-Regs\7f472864
-Node: Z8000-Addressing\7f473654
-Node: Z8000 Directives\7f474771
-Node: Z8000 Opcodes\7f476380
-Node: Vax-Dependent\7f486322
-Node: VAX-Opts\7f486839
-Node: VAX-float\7f490574
-Node: VAX-directives\7f491206
-Node: VAX-opcodes\7f492067
-Node: VAX-branch\7f492456
-Node: VAX-operands\7f494963
-Node: VAX-no\7f495726
-Node: V850-Dependent\7f495963
-Node: V850 Options\7f496361
-Node: V850 Syntax\7f498750
-Node: V850-Chars\7f498990
-Node: V850-Regs\7f499155
-Node: V850 Floating Point\7f500723
-Node: V850 Directives\7f500929
-Node: V850 Opcodes\7f502072
-Node: Xtensa-Dependent\7f507964
-Node: Xtensa Options\7f508695
-Node: Xtensa Syntax\7f511466
-Node: Xtensa Opcodes\7f513355
-Node: Xtensa Registers\7f515149
-Node: Xtensa Optimizations\7f515782
-Node: Density Instructions\7f516234
-Node: Xtensa Automatic Alignment\7f517336
-Node: Xtensa Relaxation\7f520082
-Node: Xtensa Branch Relaxation\7f520990
-Node: Xtensa Call Relaxation\7f522362
-Node: Xtensa Immediate Relaxation\7f524148
-Node: Xtensa Directives\7f526722
-Node: Schedule Directive\7f528430
-Node: Longcalls Directive\7f528770
-Node: Transform Directive\7f529314
-Node: Literal Directive\7f530056
-Node: Literal Position Directive\7f531841
-Node: Literal Prefix Directive\7f533540
-Node: Absolute Literals Directive\7f535703
-Node: Reporting Bugs\7f537010
-Node: Bug Criteria\7f537734
-Node: Bug Reporting\7f538499
-Node: Acknowledgements\7f545132
-Ref: Acknowledgements-Footnote-1\7f550051
-Node: GNU Free Documentation License\7f550077
-Node: Index\7f569799
+Node: MIPS Object\7f381616
+Node: MIPS Stabs\7f383182
+Node: MIPS symbol sizes\7f383904
+Node: MIPS ISA\7f385573
+Node: MIPS autoextend\7f386722
+Node: MIPS insn\7f387452
+Node: MIPS option stack\7f387949
+Node: MIPS ASE instruction generation overrides\7f388723
+Node: MMIX-Dependent\7f389496
+Node: MMIX-Opts\7f389876
+Node: MMIX-Expand\7f393480
+Node: MMIX-Syntax\7f394795
+Ref: mmixsite\7f395152
+Node: MMIX-Chars\7f395993
+Node: MMIX-Symbols\7f396647
+Node: MMIX-Regs\7f398715
+Node: MMIX-Pseudos\7f399740
+Ref: MMIX-loc\7f399881
+Ref: MMIX-local\7f400961
+Ref: MMIX-is\7f401493
+Ref: MMIX-greg\7f401764
+Ref: GREG-base\7f402683
+Ref: MMIX-byte\7f404000
+Ref: MMIX-constants\7f404471
+Ref: MMIX-prefix\7f405117
+Ref: MMIX-spec\7f405491
+Node: MMIX-mmixal\7f405825
+Node: MSP430-Dependent\7f409322
+Node: MSP430 Options\7f409788
+Node: MSP430 Syntax\7f409980
+Node: MSP430-Macros\7f410296
+Node: MSP430-Chars\7f411027
+Node: MSP430-Regs\7f411340
+Node: MSP430-Ext\7f411900
+Node: MSP430 Floating Point\7f413721
+Node: MSP430 Directives\7f413945
+Node: MSP430 Opcodes\7f414736
+Node: MSP430 Profiling Capability\7f415131
+Node: PDP-11-Dependent\7f417460
+Node: PDP-11-Options\7f417849
+Node: PDP-11-Pseudos\7f422920
+Node: PDP-11-Syntax\7f423265
+Node: PDP-11-Mnemonics\7f424016
+Node: PDP-11-Synthetic\7f424318
+Node: PJ-Dependent\7f424536
+Node: PJ Options\7f424761
+Node: PPC-Dependent\7f425038
+Node: PowerPC-Opts\7f425325
+Node: PowerPC-Pseudo\7f427290
+Node: SH-Dependent\7f427889
+Node: SH Options\7f428301
+Node: SH Syntax\7f429155
+Node: SH-Chars\7f429428
+Node: SH-Regs\7f429722
+Node: SH-Addressing\7f430336
+Node: SH Floating Point\7f431245
+Node: SH Directives\7f432339
+Node: SH Opcodes\7f432709
+Node: SH64-Dependent\7f437031
+Node: SH64 Options\7f437394
+Node: SH64 Syntax\7f439111
+Node: SH64-Chars\7f439394
+Node: SH64-Regs\7f439694
+Node: SH64-Addressing\7f440790
+Node: SH64 Directives\7f441973
+Node: SH64 Opcodes\7f443083
+Node: Sparc-Dependent\7f443799
+Node: Sparc-Opts\7f444184
+Node: Sparc-Aligned-Data\7f446441
+Node: Sparc-Float\7f447296
+Node: Sparc-Directives\7f447497
+Node: TIC54X-Dependent\7f449457
+Node: TIC54X-Opts\7f450183
+Node: TIC54X-Block\7f451226
+Node: TIC54X-Env\7f451586
+Node: TIC54X-Constants\7f451934
+Node: TIC54X-Subsyms\7f452336
+Node: TIC54X-Locals\7f454245
+Node: TIC54X-Builtins\7f454989
+Node: TIC54X-Ext\7f457460
+Node: TIC54X-Directives\7f458031
+Node: TIC54X-Macros\7f468933
+Node: TIC54X-MMRegs\7f471043
+Node: Z8000-Dependent\7f471259
+Node: Z8000 Options\7f472223
+Node: Z8000 Syntax\7f472440
+Node: Z8000-Chars\7f472730
+Node: Z8000-Regs\7f472963
+Node: Z8000-Addressing\7f473753
+Node: Z8000 Directives\7f474870
+Node: Z8000 Opcodes\7f476479
+Node: Vax-Dependent\7f486421
+Node: VAX-Opts\7f486938
+Node: VAX-float\7f490673
+Node: VAX-directives\7f491305
+Node: VAX-opcodes\7f492166
+Node: VAX-branch\7f492555
+Node: VAX-operands\7f495062
+Node: VAX-no\7f495825
+Node: V850-Dependent\7f496062
+Node: V850 Options\7f496460
+Node: V850 Syntax\7f498849
+Node: V850-Chars\7f499089
+Node: V850-Regs\7f499254
+Node: V850 Floating Point\7f500822
+Node: V850 Directives\7f501028
+Node: V850 Opcodes\7f502171
+Node: Xtensa-Dependent\7f508063
+Node: Xtensa Options\7f508794
+Node: Xtensa Syntax\7f511565
+Node: Xtensa Opcodes\7f513454
+Node: Xtensa Registers\7f515248
+Node: Xtensa Optimizations\7f515881
+Node: Density Instructions\7f516333
+Node: Xtensa Automatic Alignment\7f517435
+Node: Xtensa Relaxation\7f520181
+Node: Xtensa Branch Relaxation\7f521089
+Node: Xtensa Call Relaxation\7f522461
+Node: Xtensa Immediate Relaxation\7f524247
+Node: Xtensa Directives\7f526821
+Node: Schedule Directive\7f528529
+Node: Longcalls Directive\7f528869
+Node: Transform Directive\7f529413
+Node: Literal Directive\7f530155
+Node: Literal Position Directive\7f531940
+Node: Literal Prefix Directive\7f533639
+Node: Absolute Literals Directive\7f535802
+Node: Reporting Bugs\7f537109
+Node: Bug Criteria\7f537833
+Node: Bug Reporting\7f538598
+Node: Acknowledgements\7f545231
+Ref: Acknowledgements-Footnote-1\7f550150
+Node: GNU Free Documentation License\7f550176
+Node: Index\7f569898
\1f
End Tag Table
Using as
********
-This file is a user guide to the GNU assembler `as' version 2.15.96.
+This file is a user guide to the GNU assembler `as' version 2.15.97.
This document is distributed under the terms of the GNU Free
Documentation License. A copy of the license is included in the
intended to be used on GCC-generated code: it is not designed to
catch all problems in hand-written assembler code.
+`-mfix-vr4130'
+`-no-mfix-vr4130'
+ Insert nops to work around the VR4130 `mflo'/`mfhi' errata.
+
`-m4010'
`-no-m4010'
Generate code for the LSI R4010 chip. This tells the assembler to
-@set VERSION 2.15.96
+@set VERSION 2.15.97
.\" ========================================================================
.\"
.IX Title "LD 1"
-.TH LD 1 "2005-03-08" "binutils-2.15.96" "GNU Development Tools"
+.TH LD 1 "2005-04-20" "binutils-2.15.97" "GNU Development Tools"
.SH "NAME"
ld \- Using LD, the GNU linker
.SH "SYNOPSIS"
link a file \f(CW\*(C`hello.o\*(C'\fR:
.PP
.Vb 1
-\& ld -o <output> /lib/crt0.o hello.o -lc
+\& ld \-o <output> /lib/crt0.o hello.o \-lc
.Ve
.PP
This tells \fBld\fR to produce a file called \fIoutput\fR as the
compiler driver) like this:
.PP
.Vb 1
-\& gcc -Wl,--startgroup foo.o bar.o -Wl,--endgroup
+\& gcc \-Wl,\-\-startgroup foo.o bar.o \-Wl,\-\-endgroup
.Ve
.PP
This is important, because otherwise the compiler driver program may
.Sp
.Vb 3
\& extern type extern_array[];
-\& extern_array[1] -->
+\& extern_array[1] \-\->
\& { volatile type *t=extern_array; t[1] }
.Ve
.Sp
.Sp
.Vb 3
\& extern type extern_array[];
-\& extern_array[1] -->
+\& extern_array[1] \-\->
\& { volatile int t=1; extern_array[t] }
.Ve
.Sp
.Sp
.Vb 3
\& extern struct s extern_struct;
-\& extern_struct.field -->
-\& { volatile struct s *t=&extern_struct; t->field }
+\& extern_struct.field \-\->
+\& { volatile struct s *t=&extern_struct; t\->field }
.Ve
.Sp
or
.Sp
.Vb 3
\& extern long long extern_ll;
-\& extern_ll -->
+\& extern_ll \-\->
\& { volatile long long * local_ll=&extern_ll; *local_ll }
.Ve
.Sp
Original:
.Sp
.Vb 7
-\& --foo.h
+\& \-\-foo.h
\& extern int arr[];
-\& --foo.c
+\& \-\-foo.c
\& #include "foo.h"
\& void main(int argc, char **argv){
\& printf("%d\en",arr[1]);
Solution 1:
.Sp
.Vb 9
-\& --foo.h
+\& \-\-foo.h
\& extern int arr[];
-\& --foo.c
+\& \-\-foo.c
\& #include "foo.h"
\& void main(int argc, char **argv){
\& /* This workaround is for win32 and cygwin; do not "optimize" */
Solution 2:
.Sp
.Vb 14
-\& --foo.h
-\& /* Note: auto-export is assumed (no __declspec(dllexport)) */
+\& \-\-foo.h
+\& /* Note: auto\-export is assumed (no __declspec(dllexport)) */
\& #if (defined(_WIN32) || defined(__CYGWIN__)) && \e
\& !(defined(FOO_BUILD_DLL) || defined(FOO_STATIC))
\& #define FOO_IMPORT __declspec(dllimport)
\& #define FOO_IMPORT
\& #endif
\& extern FOO_IMPORT int arr[];
-\& --foo.c
+\& \-\-foo.c
\& #include "foo.h"
\& void main(int argc, char **argv){
\& printf("%d\en",arr[1]);
* Ld: (ld). The GNU linker.
END-INFO-DIR-ENTRY
- This file documents the GNU linker LD version 2.15.96.
+ This file documents the GNU linker LD version 2.15.97.
Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98, 99, 2000, 2001,
2002, 2003, 2004 Free Software Foundation, Inc.
Using ld
********
-This file documents the GNU linker ld version 2.15.96.
+This file documents the GNU linker ld version 2.15.97.
This document is distributed under the terms of the GNU Free
Documentation License. A copy of the license is included in the
-@set VERSION 2.15.96
+@set VERSION 2.15.97
projects / thirdparty / binutils-gdb.git / commitdiff
