contrib/binutils-2.24/gas/doc/c-ppc.texi

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