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 -mpower4, -mpwr4
 125 Generate code for Power4 architecture.
 126
 127 @item -mpower5, -mpwr5, -mpwr5x
 128 Generate code for Power5 architecture.
 129
 130 @item -mpower6, -mpwr6
 131 Generate code for Power6 architecture.
 132
 133 @item -mpower7, -mpwr7
 134 Generate code for Power7 architecture.
 135
 136 @item -mcell
 137 Generate code for Cell Broadband Engine architecture.
 138
 139 @item -mcom
 140 Generate code Power/PowerPC common instructions.
 141
 142 @item -many
 143 Generate code for any architecture (PWR/PWRX/PPC).
 144
 145 @item -mregnames
 146 Allow symbolic names for registers.
 147
 148 @item -mno-regnames
 149 Do not allow symbolic names for registers.
 150
 151 @item -mrelocatable
 152 Support for GCC's -mrelocatable option.
 153
 154 @item -mrelocatable-lib
 155 Support for GCC's -mrelocatable-lib option.
 156
 157 @item -memb
 158 Set PPC_EMB bit in ELF flags.
 159
 160 @item -mlittle, -mlittle-endian, -le
 161 Generate code for a little endian machine.
 162
 163 @item -mbig, -mbig-endian, -be
 164 Generate code for a big endian machine.
 165
 166 @item -msolaris
 167 Generate code for Solaris.
 168
 169 @item -mno-solaris
 170 Do not generate code for Solaris.
 171
 172 @item -nops=@var{count}
 173 If an alignment directive inserts more than @var{count} nops, put a
 174 branch at the beginning to skip execution of the nops.
 175 @end table
 176 @c man end
 177
 178
 179 @node PowerPC-Pseudo
 180 @section PowerPC Assembler Directives
 181
 182 @cindex directives for PowerPC
 183 @cindex PowerPC directives
 184 A number of assembler directives are available for PowerPC.  The
 185 following table is far from complete.
 186
 187 @table @code
 188 @item .machine "string"
 189 This directive allows you to change the machine for which code is
 190 generated.  @code{"string"} may be any of the -m cpu selection options
 191 (without the -m) enclosed in double quotes, @code{"push"}, or
 192 @code{"pop"}.  @code{.machine "push"} saves the currently selected
 193 cpu, which may be restored with @code{.machine "pop"}.
 194 @end table
 195
 196 @node PowerPC-Syntax
 197 @section PowerPC Syntax
 198 @menu
 199 * PowerPC-Chars::                Special Characters
 200 @end menu
 201
 202 @node PowerPC-Chars
 203 @subsection Special Characters
 204
 205 @cindex line comment character, PowerPC
 206 @cindex PowerPC line comment character
 207 The presence of a @samp{#} on a line indicates the start of a comment
 208 that extends to the end of the current line.
 209
 210 If a @samp{#} appears as the first character of a line then the whole
 211 line is treated as a comment, but in this case the line could also be
 212 a logical line number directive (@pxref{Comments}) or a preprocessor
 213 control command (@pxref{Preprocessing}).
 214
 215 If the assembler has been configured for the ppc-*-solaris* target
 216 then the @samp{!} character also acts as a line comment character.
 217 This can be disabled via the @option{-mno-solaris} command line
 218 option.
 219
 220 @cindex line separator, PowerPC
 221 @cindex statement separator, PowerPC
 222 @cindex PowerPC line separator
 223 The @samp{;} character can be used to separate statements on the same
 224 line.