binutils-gdb/gas/doc/c-ppc.texi
Alan Modra 61a457e5da e200 LSP support
It has bothered me for a long time that we have disabled LSP (and SPE)
tests.  Also the LSP test comment indicating there is something wrong
with get_powerpc_dialect.  I don't think there is.  Decoding of a VLE
instruction depends on whether the processor is in VLE mode (some
processors support both VLE and standard PPC) which we flag per
section with SHF_PPC_VLE for decoding when disassembling.

Background: Some versions of powerpc e200 have "Lightweight Signal
Processing" support, examples being e200z215 and e200z425.  As far as
I can tell, LSP and SPE are mutually exclusive.  This seems to be
borne out by insn encoding, for example LSP "zvaddih" and SPE "evaddw"
have the same encoding.  So none of the processor descriptions in
ppc_opts ought to have both PPC_OPCODE_LSP and PPC_OPCODE_SPE/2, if we
want disassembly to work.  I also could not find anything to suggest
that the LSP insns are enabled only in VLE mode, which means the LSP
insns should not be in vle_opcodes.

Fix all this by moving the LSP insns to their own table, and add a new
e200z2 cpu entry with LSP support, removing LSP from -me200z4 and from
-mvle.  (Yes, I know, as I said above some of the e200z4 processors
have LSP.  Others have SPE.  It's hard to choose good options.  Think
of z2 as meaning earlier, z4 as later.)  Also add -mlsp to allow
adding the LSP insn set.

include/
	* opcode/ppc.h (lsp_opcodes, lsp_num_opcodes): Declare.
	(LSP_OP_TO_SEG): Define.
binutils/
	* doc/binutils.texi: Update ppc docs.
gas/
	* config/tc-ppc.c (ppc_setup_opcodes): Add lsp opcodes to ppc_hash.
	* doc/c-ppc.texi: Document e200 and lsp.
	* testsuite/gas/ppc/lsp-checks.d: Assemble with -me200z2.
	* testsuite/gas/ppc/lsp.d: Likewise, disassembly too.
	* testsuite/gas/ppc/ppc.exp: Don't xfail lsp test.
opcodes/
	* ppc-dis.c (ppc_opts): Add e200z2 and lsp.  Don't set
	PPC_OPCODE_LSP for e200z4 or vle.
	(ppc_parse_cpu): Mutually exclude LSP and SPE.
	(LSP_OPCD_SEGS): Define.
	(lsp_opcd_indices): New array.
	(disassemble_init_powerpc): Init lsp_opcd_indices.
	(lookup_lsp): New function.
	(print_insn_powerpc): Call it.
	* ppc-opc.c: Include libiberty.h for ARRAY_SIZE and use throughout.
	(vle_opcodes): Move LSP opcodes to..
	(lsp_opcodes): ..here, and sort.
	(lsp_num_opcodes): New.
2022-10-14 22:07:18 +10:30

252 lines
6.1 KiB
Plaintext

@c Copyright (C) 2001-2022 Free Software Foundation, Inc.
@c This is part of the GAS manual.
@c For copying conditions, see the file as.texinfo.
@c man end
@ifset GENERIC
@page
@node PPC-Dependent
@chapter PowerPC Dependent Features
@end ifset
@ifclear GENERIC
@node Machine Dependencies
@chapter PowerPC Dependent Features
@end ifclear
@cindex PowerPC support
@menu
* PowerPC-Opts:: Options
* PowerPC-Pseudo:: PowerPC Assembler Directives
* PowerPC-Syntax:: PowerPC Syntax
@end menu
@node PowerPC-Opts
@section Options
@cindex options for PowerPC
@cindex PowerPC options
@cindex architectures, PowerPC
@cindex PowerPC architectures
The PowerPC chip family includes several successive levels, using the same
core instruction set, but including a few additional instructions at
each level. There are exceptions to this however. For details on what
instructions each variant supports, please see the chip's architecture
reference manual.
The following table lists all available PowerPC options.
@c man begin OPTIONS
@table @gcctabopt
@item -a32
Generate ELF32 or XCOFF32.
@item -a64
Generate ELF64 or XCOFF64.
@item -K PIC
Set EF_PPC_RELOCATABLE_LIB in ELF flags.
@item -mpwrx | -mpwr2
Generate code for POWER/2 (RIOS2).
@item -mpwr
Generate code for POWER (RIOS1)
@item -m601
Generate code for PowerPC 601.
@item -mppc, -mppc32, -m603, -m604
Generate code for PowerPC 603/604.
@item -m403, -m405
Generate code for PowerPC 403/405.
@item -m440
Generate code for PowerPC 440. BookE and some 405 instructions.
@item -m464
Generate code for PowerPC 464.
@item -m476
Generate code for PowerPC 476.
@item -m7400, -m7410, -m7450, -m7455
Generate code for PowerPC 7400/7410/7450/7455.
@item -m750cl, -mgekko, -mbroadway
Generate code for PowerPC 750CL/Gekko/Broadway.
@item -m821, -m850, -m860
Generate code for PowerPC 821/850/860.
@item -mppc64, -m620
Generate code for PowerPC 620/625/630.
@item -me200z2, -me200z4
Generate code for e200 variants, e200z2 with LSP, e200z4 with SPE.
@item -me300
Generate code for PowerPC e300 family.
@item -me500, -me500x2
Generate code for Motorola e500 core complex.
@item -me500mc
Generate code for Freescale e500mc core complex.
@item -me500mc64
Generate code for Freescale e500mc64 core complex.
@item -me5500
Generate code for Freescale e5500 core complex.
@item -me6500
Generate code for Freescale e6500 core complex.
@item -mlsp
Enable LSP instructions. (Disables SPE and SPE2.)
@item -mspe
Generate code for Motorola SPE instructions. (Disables LSP.)
@item -mspe2
Generate code for Freescale SPE2 instructions. (Disables LSP.)
@item -mtitan
Generate code for AppliedMicro Titan core complex.
@item -mppc64bridge
Generate code for PowerPC 64, including bridge insns.
@item -mbooke
Generate code for 32-bit BookE.
@item -ma2
Generate code for A2 architecture.
@item -maltivec
Generate code for processors with AltiVec instructions.
@item -mvle
Generate code for Freescale PowerPC VLE instructions.
@item -mvsx
Generate code for processors with Vector-Scalar (VSX) instructions.
@item -mhtm
Generate code for processors with Hardware Transactional Memory instructions.
@item -mpower4, -mpwr4
Generate code for Power4 architecture.
@item -mpower5, -mpwr5, -mpwr5x
Generate code for Power5 architecture.
@item -mpower6, -mpwr6
Generate code for Power6 architecture.
@item -mpower7, -mpwr7
Generate code for Power7 architecture.
@item -mpower8, -mpwr8
Generate code for Power8 architecture.
@item -mpower9, -mpwr9
Generate code for Power9 architecture.
@item -mpower10, -mpwr10
Generate code for Power10 architecture.
@item -mfuture
Generate code for 'future' architecture.
@item -mcell
@item -mcell
Generate code for Cell Broadband Engine architecture.
@item -mcom
Generate code Power/PowerPC common instructions.
@item -many
Generate code for any architecture (PWR/PWRX/PPC).
@item -mregnames
Allow symbolic names for registers.
@item -mno-regnames
Do not allow symbolic names for registers.
@item -mrelocatable
Support for GCC's -mrelocatable option.
@item -mrelocatable-lib
Support for GCC's -mrelocatable-lib option.
@item -memb
Set PPC_EMB bit in ELF flags.
@item -mlittle, -mlittle-endian, -le
Generate code for a little endian machine.
@item -mbig, -mbig-endian, -be
Generate code for a big endian machine.
@item -msolaris
Generate code for Solaris.
@item -mno-solaris
Do not generate code for Solaris.
@item -nops=@var{count}
If an alignment directive inserts more than @var{count} nops, put a
branch at the beginning to skip execution of the nops.
@end table
@c man end
@node PowerPC-Pseudo
@section PowerPC Assembler Directives
@cindex directives for PowerPC
@cindex PowerPC directives
A number of assembler directives are available for PowerPC. The
following table is far from complete.
@table @code
@item .machine "string"
This directive allows you to change the machine for which code is
generated. @code{"string"} may be any of the -m cpu selection options
(without the -m) enclosed in double quotes, @code{"push"}, or
@code{"pop"}. @code{.machine "push"} saves the currently selected
cpu, which may be restored with @code{.machine "pop"}.
@end table
@node PowerPC-Syntax
@section PowerPC Syntax
@menu
* PowerPC-Chars:: Special Characters
@end menu
@node PowerPC-Chars
@subsection Special Characters
@cindex line comment character, PowerPC
@cindex PowerPC line comment character
The presence of a @samp{#} on a line indicates the start of a comment
that extends to the end of the current line.
If a @samp{#} appears as the first character of a line then the whole
line is treated as a comment, but in this case the line could also be
a logical line number directive (@pxref{Comments}) or a preprocessor
control command (@pxref{Preprocessing}).
If the assembler has been configured for the ppc-*-solaris* target
then the @samp{!} character also acts as a line comment character.
This can be disabled via the @option{-mno-solaris} command-line
option.
@cindex line separator, PowerPC
@cindex statement separator, PowerPC
@cindex PowerPC line separator
The @samp{;} character can be used to separate statements on the same
line.