| 1 | @c Copyright 2001, 2002, 2003, 2005, 2006 |
| 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 |
| 28 | The PowerPC chip family includes several successive levels, using the same |
| 29 | core instruction set, but including a few additional instructions at |
| 30 | each level. There are exceptions to this however. For details on what |
| 31 | instructions each variant supports, please see the chip's architecture |
| 32 | reference manual. |
| 33 | |
| 34 | The following table lists all available PowerPC options. |
| 35 | |
| 36 | @table @code |
| 37 | @item -mpwrx | -mpwr2 |
| 38 | Generate code for POWER/2 (RIOS2). |
| 39 | |
| 40 | @item -mpwr |
| 41 | Generate code for POWER (RIOS1) |
| 42 | |
| 43 | @item -m601 |
| 44 | Generate code for PowerPC 601. |
| 45 | |
| 46 | @item -mppc, -mppc32, -m603, -m604 |
| 47 | Generate code for PowerPC 603/604. |
| 48 | |
| 49 | @item -m403, -m405 |
| 50 | Generate code for PowerPC 403/405. |
| 51 | |
| 52 | @item -m440 |
| 53 | Generate code for PowerPC 440. BookE and some 405 instructions. |
| 54 | |
| 55 | @item -m7400, -m7410, -m7450, -m7455 |
| 56 | Generate code for PowerPC 7400/7410/7450/7455. |
| 57 | |
| 58 | @item -mppc64, -m620 |
| 59 | Generate code for PowerPC 620/625/630. |
| 60 | |
| 61 | @item -me500, -me500x2 |
| 62 | Generate code for Motorola e500 core complex. |
| 63 | |
| 64 | @item -mspe |
| 65 | Generate code for Motorola SPE instructions. |
| 66 | |
| 67 | @item -mppc64bridge |
| 68 | Generate code for PowerPC 64, including bridge insns. |
| 69 | |
| 70 | @item -mbooke64 |
| 71 | Generate code for 64-bit BookE. |
| 72 | |
| 73 | @item -mbooke, mbooke32 |
| 74 | Generate code for 32-bit BookE. |
| 75 | |
| 76 | @item -me300 |
| 77 | Generate code for PowerPC e300 family. |
| 78 | |
| 79 | @item -maltivec |
| 80 | Generate code for processors with AltiVec instructions. |
| 81 | |
| 82 | @item -mpower4 |
| 83 | Generate code for Power4 architecture. |
| 84 | |
| 85 | @item -mpower5 |
| 86 | Generate code for Power5 architecture. |
| 87 | |
| 88 | @item -mpower6 |
| 89 | Generate code for Power6 architecture. |
| 90 | |
| 91 | @item -mcell |
| 92 | Generate code for Cell Broadband Engine architecture. |
| 93 | |
| 94 | @item -mcom |
| 95 | Generate code Power/PowerPC common instructions. |
| 96 | |
| 97 | @item -many |
| 98 | Generate code for any architecture (PWR/PWRX/PPC). |
| 99 | |
| 100 | @item -mregnames |
| 101 | Allow symbolic names for registers. |
| 102 | |
| 103 | @item -mno-regnames |
| 104 | Do not allow symbolic names for registers. |
| 105 | |
| 106 | @item -mrelocatable |
| 107 | Support for GCC's -mrelocatable option. |
| 108 | |
| 109 | @item -mrelocatable-lib |
| 110 | Support for GCC's -mrelocatable-lib option. |
| 111 | |
| 112 | @item -memb |
| 113 | Set PPC_EMB bit in ELF flags. |
| 114 | |
| 115 | @item -mlittle, -mlittle-endian |
| 116 | Generate code for a little endian machine. |
| 117 | |
| 118 | @item -mbig, -mbig-endian |
| 119 | Generate code for a big endian machine. |
| 120 | |
| 121 | @item -msolaris |
| 122 | Generate code for Solaris. |
| 123 | |
| 124 | @item -mno-solaris |
| 125 | Do not generate code for Solaris. |
| 126 | @end table |
| 127 | |
| 128 | |
| 129 | @node PowerPC-Pseudo |
| 130 | @section PowerPC Assembler Directives |
| 131 | |
| 132 | @cindex directives for PowerPC |
| 133 | @cindex PowerPC directives |
| 134 | A number of assembler directives are available for PowerPC. The |
| 135 | following table is far from complete. |
| 136 | |
| 137 | @table @code |
| 138 | @item .machine "string" |
| 139 | This directive allows you to change the machine for which code is |
| 140 | generated. @code{"string"} may be any of the -m cpu selection options |
| 141 | (without the -m) enclosed in double quotes, @code{"push"}, or |
| 142 | @code{"pop"}. @code{.machine "push"} saves the currently selected |
| 143 | cpu, which may be restored with @code{.machine "pop"}. |
| 144 | @end table |