gas/doc/c-ppc.texi

   1 @c Copyright 2001, 2002, 2003, 2005, 2006, 2007, 2008, 2009, 2010, 2011
   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 @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 -mspe
  92 Generate code for Motorola SPE instructions.
  93
  94 @item -mtitan
  95 Generate code for AppliedMicro Titan core complex.
  96
  97 @item -mppc64bridge
  98 Generate code for PowerPC 64, including bridge insns.
  99
 100 @item -mbooke
 101 Generate code for 32-bit BookE.
 102
 103 @item -ma2
 104 Generate code for A2 architecture.
 105
 106 @item -me300
 107 Generate code for PowerPC e300 family.
 108
 109 @item -maltivec
 110 Generate code for processors with AltiVec instructions.
 111
 112 @item -mvsx
 113 Generate code for processors with Vector-Scalar (VSX) instructions.
 114
 115 @item -mpower4, -mpwr4
 116 Generate code for Power4 architecture.
 117
 118 @item -mpower5, -mpwr5, -mpwr5x
 119 Generate code for Power5 architecture.
 120
 121 @item -mpower6, -mpwr6
 122 Generate code for Power6 architecture.
 123
 124 @item -mpower7, -mpwr7
 125 Generate code for Power7 architecture.
 126
 127 @item -mcell
 128 Generate code for Cell Broadband Engine architecture.
 129
 130 @item -mcom
 131 Generate code Power/PowerPC common instructions.
 132
 133 @item -many
 134 Generate code for any architecture (PWR/PWRX/PPC).
 135
 136 @item -mregnames
 137 Allow symbolic names for registers.
 138
 139 @item -mno-regnames
 140 Do not allow symbolic names for registers.
 141
 142 @item -mrelocatable
 143 Support for GCC's -mrelocatable option.
 144
 145 @item -mrelocatable-lib
 146 Support for GCC's -mrelocatable-lib option.
 147
 148 @item -memb
 149 Set PPC_EMB bit in ELF flags.
 150
 151 @item -mlittle, -mlittle-endian, -le
 152 Generate code for a little endian machine.
 153
 154 @item -mbig, -mbig-endian, -be
 155 Generate code for a big endian machine.
 156
 157 @item -msolaris
 158 Generate code for Solaris.
 159
 160 @item -mno-solaris
 161 Do not generate code for Solaris.
 162
 163 @item -nops=@var{count}
 164 When aligning, more than @var{count} nops uses a branch.
 165 @end table
 166 @c man end
 167
 168
 169 @node PowerPC-Pseudo
 170 @section PowerPC Assembler Directives
 171
 172 @cindex directives for PowerPC
 173 @cindex PowerPC directives
 174 A number of assembler directives are available for PowerPC.  The
 175 following table is far from complete.
 176
 177 @table @code
 178 @item .machine "string"
 179 This directive allows you to change the machine for which code is
 180 generated.  @code{"string"} may be any of the -m cpu selection options
 181 (without the -m) enclosed in double quotes, @code{"push"}, or
 182 @code{"pop"}.  @code{.machine "push"} saves the currently selected
 183 cpu, which may be restored with @code{.machine "pop"}.
 184 @end table
 185
 186 @node PowerPC-Syntax
 187 @section PowerPC Syntax
 188 @menu
 189 * PowerPC-Chars::                Special Characters
 190 @end menu
 191
 192 @node PowerPC-Chars
 193 @subsection Special Characters
 194
 195 @cindex line comment character, PowerPC
 196 @cindex PowerPC line comment character
 197 The presence of a @samp{#} on a line indicates the start of a comment
 198 that extends to the end of the current line.
 199
 200 If a @samp{#} appears as the first character of a line then the whole
 201 line is treated as a comment, but in this case the line could also be
 202 a logical line number directive (@pxref{Comments}) or a preprocessor
 203 control command (@pxref{Preprocessing}).
 204
 205 If the assembler has been configured for the ppc-*-solaris* target
 206 then the @samp{!} character also acts as a line comment character.
 207 This can be disabled via the @option{-mno-solaris} command line
 208 option.
 209
 210 @cindex line separator, PowerPC
 211 @cindex statement separator, PowerPC
 212 @cindex PowerPC line separator
 213 The @samp{;} character can be used to separate statements on the same
 214 line.