binutils-gdb/include/opcode
Jens Remus f96fe7f454 s390: Optionally print instruction description in disassembly
Print instruction description as comment in disassembly with s390
architecture specific option "insndesc":

- For objdump it can be enabled with option "-M insndesc"
- In gdb it can be enabled with "set disassembler-options insndesc"

Since comments are not column aligned the output can enhanced for
readability by postprocessing using a filter such as "expand":

... | expand -t 8,16,24,32,40,80

Or when using in combination with objdump option --visualize-jumps:

... | expand | sed -e 's/ *#/\t#/' | expand -t 1,80

Note that the instruction descriptions add about 128 KB to s390-opc.o:

s390-opc.o without instruction descriptions: 216368 bytes
s390-opc.o with instruction descriptions   : 348432 bytes

binutils/
	* NEWS: Mention new s390-specific disassembler option
	  "insndesc".

include/
	* opcode/s390.h (struct s390_opcode): Add field to hold
	  instruction description.

opcodes/
	* s390-mkopc.c: Copy instruction description from s390-opc.txt
	  into generated operation code table s390-opc.tab.
	* s390-opc.c (s390_opformats): Provide NULL as description in
	  .insn pseudo-mnemonics opcode table.
	* s390-dis.c: Add s390-specific disassembler option "insndesc"
	  and optionally print the instruction description as comment in
	  the disassembly when it is specified.

gas/
	* testsuite/gas/s390/s390.exp: Add new test disassembly test
	  case "zarch-insndesc".
	* testsuite/gas/s390/zarch-insndesc.s: New test case for s390-
	  specific disassembler option "insndesc".
	* testsuite/gas/s390/zarch-insndesc.d: Likewise.

Signed-off-by: Jens Remus <jremus@linux.ibm.com>
Reviewed-by: Andreas Krebbel <krebbel@linux.ibm.com>
2023-12-20 11:50:32 +01:00
..
aarch64.h aarch64: Add FEAT_ITE support 2023-12-19 15:35:49 +01:00
alpha.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
arc-attrs.h Revert "arc: Update opcode related include files for ARCv3." 2023-09-25 17:02:41 +03:00
arc-func.h Revert "arc: Update opcode related include files for ARCv3." 2023-09-25 17:02:41 +03:00
arc.h Revert "arc: Update opcode related include files for ARCv3." 2023-09-25 17:02:41 +03:00
arm.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
avr.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
bfin.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
bpf.h bpf: correct neg and neg32 instruction encoding 2023-08-21 10:07:25 -07:00
cgen.h bpf: fix error conversion from long unsigned int to unsigned int [-Werror=overflow] 2023-02-03 11:18:50 -06:00
ChangeLog-0415 binutils ChangeLog rotation 2016-01-01 22:59:17 +10:30
ChangeLog-9103 Add copyright notices 2012-12-10 12:48:03 +00:00
convex.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
cr16.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
cris.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
crx.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
csky.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
d10v.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
d30v.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
dlx.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ft32.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
h8300.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
hppa.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
i386.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ia64.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
kvx.h kvx: New port. 2023-08-16 14:22:54 +01:00
loongarch.h Add support for ilp32 register alias. 2023-11-10 14:45:09 +08:00
m68hc11.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
m68k.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
metag.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
mips.h Add MIPS Allegrex CPU as a MIPS2-based CPU 2023-06-15 04:45:03 +01:00
mmix.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
mn10200.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
mn10300.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
moxie.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
msp430-decode.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
msp430.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
nds32.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
nfp.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
nios2.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
nios2r1.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
nios2r2.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
np1.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ns32k.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
pdp11.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
pj.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
pn.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ppc.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
pru.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
pyr.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
riscv-opc.h RISC-V: Fix the wrong encoding and operand of the XTheadFmv extension. 2023-12-14 09:54:19 +01:00
riscv.h RISC-V: Add SiFive custom vector coprocessor interface instructions v1.0 2023-12-01 09:29:07 +08:00
rl78.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
rx.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
s12z.h Enable building the s12z target on Solaris hosts where REG_Y is defined in system header files. 2020-01-02 12:04:40 +00:00
s390.h s390: Optionally print instruction description in disassembly 2023-12-20 11:50:32 +01:00
score-datadep.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
score-inst.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
sparc.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
spu-insns.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
spu.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic4x.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic6x-control-registers.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic6x-insn-formats.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic6x-opcode-table.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic6x.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic30.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tic54x.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tilegx.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tilepro.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
v850.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
vax.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
visium.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
wasm.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
xgate.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30