1@c Copyright 2001, 2002, 2003, 2005
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 -m7400, -m7410, -m7450, -m7455
56Generate code for PowerPC 7400/7410/7450/7455.
57
58@item -mppc64, -m620
59Generate code for PowerPC 620/625/630.
60
61@item -mppc64bridge
62Generate code for PowerPC 64, including bridge insns.
63
64@item -mbooke64
65Generate code for 64-bit BookE.
66
67@item -mbooke, mbooke32
68Generate code for 32-bit BookE.
69
70@item -me300
71Generate code for PowerPC e300 family.
72
73@item -maltivec
74Generate code for processors with AltiVec instructions.
75
76@item -mpower4
77Generate code for Power4 architecture.
78
79@item -mpower5
80Generate code for Power5 architecture.
81
82@item -mcom
83Generate code Power/PowerPC common instructions.
84
85@item -many
86Generate code for any architecture (PWR/PWRX/PPC).
87
88@item -mregnames
89Allow symbolic names for registers.
90
91@item -mno-regnames
92Do not allow symbolic names for registers.
93
94@item -mrelocatable
95Support for GCC's -mrelocatble option.
96
97@item -mrelocatable-lib
98Support for GCC's -mrelocatble-lib option.
99
100@item -memb
101Set PPC_EMB bit in ELF flags.
102
103@item -mlittle, -mlittle-endian
104Generate code for a little endian machine.
105
106@item -mbig, -mbig-endian
107Generate code for a big endian machine.
108
109@item -msolaris
110Generate code for Solaris.
111
112@item -mno-solaris
113Do not generate code for Solaris.
114@end table
115
116
117@node PowerPC-Pseudo
118@section PowerPC Assembler Directives
119
120@cindex directives for PowerPC
121@cindex PowerPC directives
122A number of assembler directives are available for PowerPC.  The
123following table is far from complete.
124
125@table @code
126@item .machine "string"
127This directive allows you to change the machine for which code is
128generated.  @code{"string"} may be any of the -m cpu selection options
129(without the -m) enclosed in double quotes, @code{"push"}, or
130@code{"pop"}.  @code{.machine "push"} saves the currently selected
131cpu, which may be restored with @code{.machine "pop"}.
132@end table
133