| 1 | @c Copyright (C) 2001-2015 Free Software Foundation, Inc. |
| 2 | @c This is part of the GAS manual. |
| 3 | @c For copying conditions, see the file as.texinfo. |
| 4 | @c man end |
| 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 | * PowerPC-Syntax:: PowerPC Syntax |
| 20 | @end menu |
| 21 | |
| 22 | @node PowerPC-Opts |
| 23 | @section Options |
| 24 | |
| 25 | @cindex options for PowerPC |
| 26 | @cindex PowerPC options |
| 27 | @cindex architectures, PowerPC |
| 28 | @cindex PowerPC architectures |
| 29 | The PowerPC chip family includes several successive levels, using the same |
| 30 | core instruction set, but including a few additional instructions at |
| 31 | each level. There are exceptions to this however. For details on what |
| 32 | instructions each variant supports, please see the chip's architecture |
| 33 | reference manual. |
| 34 | |
| 35 | The following table lists all available PowerPC options. |
| 36 | |
| 37 | @c man begin OPTIONS |
| 38 | @table @gcctabopt |
| 39 | @item -a32 |
| 40 | Generate ELF32 or XCOFF32. |
| 41 | |
| 42 | @item -a64 |
| 43 | Generate ELF64 or XCOFF64. |
| 44 | |
| 45 | @item -K PIC |
| 46 | Set EF_PPC_RELOCATABLE_LIB in ELF flags. |
| 47 | |
| 48 | @item -mpwrx | -mpwr2 |
| 49 | Generate code for POWER/2 (RIOS2). |
| 50 | |
| 51 | @item -mpwr |
| 52 | Generate code for POWER (RIOS1) |
| 53 | |
| 54 | @item -m601 |
| 55 | Generate code for PowerPC 601. |
| 56 | |
| 57 | @item -mppc, -mppc32, -m603, -m604 |
| 58 | Generate code for PowerPC 603/604. |
| 59 | |
| 60 | @item -m403, -m405 |
| 61 | Generate code for PowerPC 403/405. |
| 62 | |
| 63 | @item -m440 |
| 64 | Generate code for PowerPC 440. BookE and some 405 instructions. |
| 65 | |
| 66 | @item -m464 |
| 67 | Generate code for PowerPC 464. |
| 68 | |
| 69 | @item -m476 |
| 70 | Generate code for PowerPC 476. |
| 71 | |
| 72 | @item -m7400, -m7410, -m7450, -m7455 |
| 73 | Generate code for PowerPC 7400/7410/7450/7455. |
| 74 | |
| 75 | @item -m750cl |
| 76 | Generate code for PowerPC 750CL. |
| 77 | |
| 78 | @item -mppc64, -m620 |
| 79 | Generate code for PowerPC 620/625/630. |
| 80 | |
| 81 | @item -me500, -me500x2 |
| 82 | Generate code for Motorola e500 core complex. |
| 83 | |
| 84 | @item -me500mc |
| 85 | Generate code for Freescale e500mc core complex. |
| 86 | |
| 87 | @item -me500mc64 |
| 88 | Generate code for Freescale e500mc64 core complex. |
| 89 | |
| 90 | @item -me5500 |
| 91 | Generate code for Freescale e5500 core complex. |
| 92 | |
| 93 | @item -me6500 |
| 94 | Generate code for Freescale e6500 core complex. |
| 95 | |
| 96 | @item -mspe |
| 97 | Generate code for Motorola SPE instructions. |
| 98 | |
| 99 | @item -mtitan |
| 100 | Generate code for AppliedMicro Titan core complex. |
| 101 | |
| 102 | @item -mppc64bridge |
| 103 | Generate code for PowerPC 64, including bridge insns. |
| 104 | |
| 105 | @item -mbooke |
| 106 | Generate code for 32-bit BookE. |
| 107 | |
| 108 | @item -ma2 |
| 109 | Generate code for A2 architecture. |
| 110 | |
| 111 | @item -me300 |
| 112 | Generate code for PowerPC e300 family. |
| 113 | |
| 114 | @item -maltivec |
| 115 | Generate code for processors with AltiVec instructions. |
| 116 | |
| 117 | @item -mvle |
| 118 | Generate code for Freescale PowerPC VLE instructions. |
| 119 | |
| 120 | @item -mvsx |
| 121 | Generate code for processors with Vector-Scalar (VSX) instructions. |
| 122 | |
| 123 | @item -mhtm |
| 124 | Generate code for processors with Hardware Transactional Memory instructions. |
| 125 | |
| 126 | @item -mpower4, -mpwr4 |
| 127 | Generate code for Power4 architecture. |
| 128 | |
| 129 | @item -mpower5, -mpwr5, -mpwr5x |
| 130 | Generate code for Power5 architecture. |
| 131 | |
| 132 | @item -mpower6, -mpwr6 |
| 133 | Generate code for Power6 architecture. |
| 134 | |
| 135 | @item -mpower7, -mpwr7 |
| 136 | Generate code for Power7 architecture. |
| 137 | |
| 138 | @item -mpower8, -mpwr8 |
| 139 | Generate code for Power8 architecture. |
| 140 | |
| 141 | @item -mcell |
| 142 | @item -mcell |
| 143 | Generate code for Cell Broadband Engine architecture. |
| 144 | |
| 145 | @item -mcom |
| 146 | Generate code Power/PowerPC common instructions. |
| 147 | |
| 148 | @item -many |
| 149 | Generate code for any architecture (PWR/PWRX/PPC). |
| 150 | |
| 151 | @item -mregnames |
| 152 | Allow symbolic names for registers. |
| 153 | |
| 154 | @item -mno-regnames |
| 155 | Do not allow symbolic names for registers. |
| 156 | |
| 157 | @item -mrelocatable |
| 158 | Support for GCC's -mrelocatable option. |
| 159 | |
| 160 | @item -mrelocatable-lib |
| 161 | Support for GCC's -mrelocatable-lib option. |
| 162 | |
| 163 | @item -memb |
| 164 | Set PPC_EMB bit in ELF flags. |
| 165 | |
| 166 | @item -mlittle, -mlittle-endian, -le |
| 167 | Generate code for a little endian machine. |
| 168 | |
| 169 | @item -mbig, -mbig-endian, -be |
| 170 | Generate code for a big endian machine. |
| 171 | |
| 172 | @item -msolaris |
| 173 | Generate code for Solaris. |
| 174 | |
| 175 | @item -mno-solaris |
| 176 | Do not generate code for Solaris. |
| 177 | |
| 178 | @item -nops=@var{count} |
| 179 | If an alignment directive inserts more than @var{count} nops, put a |
| 180 | branch at the beginning to skip execution of the nops. |
| 181 | @end table |
| 182 | @c man end |
| 183 | |
| 184 | |
| 185 | @node PowerPC-Pseudo |
| 186 | @section PowerPC Assembler Directives |
| 187 | |
| 188 | @cindex directives for PowerPC |
| 189 | @cindex PowerPC directives |
| 190 | A number of assembler directives are available for PowerPC. The |
| 191 | following table is far from complete. |
| 192 | |
| 193 | @table @code |
| 194 | @item .machine "string" |
| 195 | This directive allows you to change the machine for which code is |
| 196 | generated. @code{"string"} may be any of the -m cpu selection options |
| 197 | (without the -m) enclosed in double quotes, @code{"push"}, or |
| 198 | @code{"pop"}. @code{.machine "push"} saves the currently selected |
| 199 | cpu, which may be restored with @code{.machine "pop"}. |
| 200 | @end table |
| 201 | |
| 202 | @node PowerPC-Syntax |
| 203 | @section PowerPC Syntax |
| 204 | @menu |
| 205 | * PowerPC-Chars:: Special Characters |
| 206 | @end menu |
| 207 | |
| 208 | @node PowerPC-Chars |
| 209 | @subsection Special Characters |
| 210 | |
| 211 | @cindex line comment character, PowerPC |
| 212 | @cindex PowerPC line comment character |
| 213 | The presence of a @samp{#} on a line indicates the start of a comment |
| 214 | that extends to the end of the current line. |
| 215 | |
| 216 | If a @samp{#} appears as the first character of a line then the whole |
| 217 | line is treated as a comment, but in this case the line could also be |
| 218 | a logical line number directive (@pxref{Comments}) or a preprocessor |
| 219 | control command (@pxref{Preprocessing}). |
| 220 | |
| 221 | If the assembler has been configured for the ppc-*-solaris* target |
| 222 | then the @samp{!} character also acts as a line comment character. |
| 223 | This can be disabled via the @option{-mno-solaris} command line |
| 224 | option. |
| 225 | |
| 226 | @cindex line separator, PowerPC |
| 227 | @cindex statement separator, PowerPC |
| 228 | @cindex PowerPC line separator |
| 229 | The @samp{;} character can be used to separate statements on the same |
| 230 | line. |