Import binutils-2.20
[dragonfly.git] / contrib / binutils-2.20 / gas / doc / c-ppc.texi
CommitLineData
8e158dd0
SS
1@c Copyright 2001, 2002, 2003, 2005, 2006, 2007, 2008
2@c Free Software Foundation, Inc.
3@c This is part of the GAS manual.
4@c For copying conditions, see the file as.texinfo.
5@ifset GENERIC
6@page
7@node PPC-Dependent
8@chapter PowerPC Dependent Features
9@end ifset
10@ifclear GENERIC
11@node Machine Dependencies
12@chapter PowerPC Dependent Features
13@end ifclear
14
15@cindex PowerPC support
16@menu
17* PowerPC-Opts:: Options
18* PowerPC-Pseudo:: PowerPC Assembler Directives
19@end menu
20
21@node PowerPC-Opts
22@section Options
23
24@cindex options for PowerPC
25@cindex PowerPC options
26@cindex architectures, PowerPC
27@cindex PowerPC architectures
28The PowerPC chip family includes several successive levels, using the same
29core instruction set, but including a few additional instructions at
30each level. There are exceptions to this however. For details on what
31instructions each variant supports, please see the chip's architecture
32reference manual.
33
34The following table lists all available PowerPC options.
35
36@table @code
37@item -mpwrx | -mpwr2
38Generate code for POWER/2 (RIOS2).
39
40@item -mpwr
41Generate code for POWER (RIOS1)
42
43@item -m601
44Generate code for PowerPC 601.
45
46@item -mppc, -mppc32, -m603, -m604
47Generate code for PowerPC 603/604.
48
49@item -m403, -m405
50Generate code for PowerPC 403/405.
51
52@item -m440
53Generate code for PowerPC 440. BookE and some 405 instructions.
54
55@item -m476
56Generate code for PowerPC 476.
57
58@item -m7400, -m7410, -m7450, -m7455
59Generate code for PowerPC 7400/7410/7450/7455.
60
61@item -m750cl
62Generate code for PowerPC 750CL.
63
64@item -mppc64, -m620
65Generate code for PowerPC 620/625/630.
66
67@item -me500, -me500x2
68Generate code for Motorola e500 core complex.
69
70@item -mspe
71Generate code for Motorola SPE instructions.
72
73@item -mppc64bridge
74Generate code for PowerPC 64, including bridge insns.
75
76@item -mbooke
77Generate code for 32-bit BookE.
78
79@item -ma2
80Generate code for A2 architecture.
81
82@item -me300
83Generate code for PowerPC e300 family.
84
85@item -maltivec
86Generate code for processors with AltiVec instructions.
87
88@item -mvsx
89Generate code for processors with Vector-Scalar (VSX) instructions.
90
91@item -mpower4
92Generate code for Power4 architecture.
93
94@item -mpower5
95Generate code for Power5 architecture.
96
97@item -mpower6
98Generate code for Power6 architecture.
99
100@item -mpower7
101Generate code for Power7 architecture.
102
103@item -mcell
104Generate code for Cell Broadband Engine architecture.
105
106@item -mcom
107Generate code Power/PowerPC common instructions.
108
109@item -many
110Generate code for any architecture (PWR/PWRX/PPC).
111
112@item -mregnames
113Allow symbolic names for registers.
114
115@item -mno-regnames
116Do not allow symbolic names for registers.
117
118@item -mrelocatable
119Support for GCC's -mrelocatable option.
120
121@item -mrelocatable-lib
122Support for GCC's -mrelocatable-lib option.
123
124@item -memb
125Set PPC_EMB bit in ELF flags.
126
127@item -mlittle, -mlittle-endian
128Generate code for a little endian machine.
129
130@item -mbig, -mbig-endian
131Generate code for a big endian machine.
132
133@item -msolaris
134Generate code for Solaris.
135
136@item -mno-solaris
137Do not generate code for Solaris.
138@end table
139
140
141@node PowerPC-Pseudo
142@section PowerPC Assembler Directives
143
144@cindex directives for PowerPC
145@cindex PowerPC directives
146A number of assembler directives are available for PowerPC. The
147following table is far from complete.
148
149@table @code
150@item .machine "string"
151This directive allows you to change the machine for which code is
152generated. @code{"string"} may be any of the -m cpu selection options
153(without the -m) enclosed in double quotes, @code{"push"}, or
154@code{"pop"}. @code{.machine "push"} saves the currently selected
155cpu, which may be restored with @code{.machine "pop"}.
156@end table