blob: cb74ec8543d070729b76fb112d09012e802c56d3 [file] [log] [blame]
/* xtensa-dis.c. Disassembly functions for Xtensa.
Copyright (C) 2003-2024 Free Software Foundation, Inc.
Contributed by Bob Wilson at Tensilica, Inc. (bwilson@tensilica.com)
This file is part of the GNU opcodes library.
This library is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3, or (at your option)
any later version.
It is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
License for more details.
You should have received a copy of the GNU General Public License
along with this file; see the file COPYING. If not, write to the
Free Software Foundation, 51 Franklin Street - Fifth Floor, Boston,
MA 02110-1301, USA. */
#include "sysdep.h"
#include <stdlib.h>
#include <stdio.h>
#include <sys/types.h>
#include <string.h>
#include "xtensa-isa.h"
#include "ansidecl.h"
#include "libiberty.h"
#include "bfd.h"
#include "elf/xtensa.h"
#include "disassemble.h"
#include <setjmp.h>
extern xtensa_isa xtensa_default_isa;
#ifndef MAX
#define MAX(a,b) (a > b ? a : b)
#endif
int show_raw_fields;
struct dis_private
{
bfd_byte *byte_buf;
OPCODES_SIGJMP_BUF bailout;
/* Persistent fields, valid for last_section only. */
asection *last_section;
property_table_entry *insn_table_entries;
int insn_table_entry_count;
/* Cached property table search position. */
bfd_vma insn_table_cur_addr;
int insn_table_cur_idx;
};
static void
xtensa_coalesce_insn_tables (struct dis_private *priv)
{
const int mask = ~(XTENSA_PROP_DATA | XTENSA_PROP_NO_TRANSFORM);
int count = priv->insn_table_entry_count;
int i, j;
/* Loop over all entries, combining adjacent ones that differ only in
the flag bits XTENSA_PROP_DATA and XTENSA_PROP_NO_TRANSFORM. */
for (i = j = 0; j < count; ++i)
{
property_table_entry *entry = priv->insn_table_entries + i;
*entry = priv->insn_table_entries[j];
for (++j; j < count; ++j)
{
property_table_entry *next = priv->insn_table_entries + j;
int fill = xtensa_compute_fill_extra_space (entry);
int size = entry->size + fill;
if (entry->address + size == next->address)
{
int entry_flags = entry->flags & mask;
int next_flags = next->flags & mask;
if (next_flags == entry_flags)
entry->size = next->address - entry->address + next->size;
else
break;
}
else
{
break;
}
}
}
priv->insn_table_entry_count = i;
}
static property_table_entry *
xtensa_find_table_entry (bfd_vma memaddr, struct disassemble_info *info)
{
struct dis_private *priv = (struct dis_private *) info->private_data;
int i;
if (priv->insn_table_entries == NULL
|| priv->insn_table_entry_count < 0)
return NULL;
if (memaddr < priv->insn_table_cur_addr)
priv->insn_table_cur_idx = 0;
for (i = priv->insn_table_cur_idx; i < priv->insn_table_entry_count; ++i)
{
property_table_entry *block = priv->insn_table_entries + i;
if (block->size != 0)
{
if ((memaddr >= block->address
&& memaddr < block->address + block->size)
|| memaddr < block->address)
{
priv->insn_table_cur_addr = memaddr;
priv->insn_table_cur_idx = i;
return block;
}
}
}
return NULL;
}
/* Check whether an instruction crosses an instruction block boundary
(according to property tables).
If it does, return 0 (doesn't fit), else return 1. */
static int
xtensa_instruction_fits (bfd_vma memaddr, int size,
property_table_entry *insn_block)
{
unsigned max_size;
/* If no property table info, assume it fits. */
if (insn_block == NULL || size <= 0)
return 1;
/* If too high, limit nextstop by the next insn address. */
if (insn_block->address > memaddr)
{
/* memaddr is not in an instruction block, but is followed by one. */
max_size = insn_block->address - memaddr;
}
else
{
/* memaddr is in an instruction block, go no further than the end. */
max_size = insn_block->address + insn_block->size - memaddr;
}
/* Crossing a boundary, doesn't "fit". */
if ((unsigned)size > max_size)
return 0;
return 1;
}
static int
fetch_data (struct disassemble_info *info, bfd_vma memaddr)
{
int length, status = 0;
struct dis_private *priv = (struct dis_private *) info->private_data;
int insn_size = xtensa_isa_maxlength (xtensa_default_isa);
insn_size = MAX (insn_size, 4);
/* Read the maximum instruction size, padding with zeros if we go past
the end of the text section. This code will automatically adjust
length when we hit the end of the buffer. */
memset (priv->byte_buf, 0, insn_size);
for (length = insn_size; length > 0; length--)
{
status = (*info->read_memory_func) (memaddr, priv->byte_buf, length,
info);
if (status == 0)
return length;
}
(*info->memory_error_func) (status, memaddr, info);
OPCODES_SIGLONGJMP (priv->bailout, 1);
/*NOTREACHED*/
}
static void
print_xtensa_operand (bfd_vma memaddr,
struct disassemble_info *info,
xtensa_opcode opc,
int opnd,
unsigned operand_val)
{
xtensa_isa isa = xtensa_default_isa;
int signed_operand_val, status;
bfd_byte litbuf[4];
if (show_raw_fields)
{
if (operand_val < 0xa)
(*info->fprintf_func) (info->stream, "%u", operand_val);
else
(*info->fprintf_func) (info->stream, "0x%x", operand_val);
return;
}
(void) xtensa_operand_decode (isa, opc, opnd, &operand_val);
signed_operand_val = (int) operand_val;
if (xtensa_operand_is_register (isa, opc, opnd) == 0)
{
if (xtensa_operand_is_PCrelative (isa, opc, opnd) == 1)
{
(void) xtensa_operand_undo_reloc (isa, opc, opnd,
&operand_val, memaddr);
info->target = operand_val;
(*info->print_address_func) (info->target, info);
/* Also display value loaded by L32R (but not if reloc exists,
those tend to be wrong): */
if ((info->flags & INSN_HAS_RELOC) == 0
&& !strcmp ("l32r", xtensa_opcode_name (isa, opc)))
status = (*info->read_memory_func) (operand_val, litbuf, 4, info);
else
status = -1;
if (status == 0)
{
unsigned literal = bfd_get_bits (litbuf, 32,
info->endian == BFD_ENDIAN_BIG);
(*info->fprintf_func) (info->stream, " (");
(*info->print_address_func) (literal, info);
(*info->fprintf_func) (info->stream, ")");
}
}
else
{
if ((signed_operand_val > -256) && (signed_operand_val < 256))
(*info->fprintf_styled_func) (info->stream, dis_style_immediate,
"%d", signed_operand_val);
else
(*info->fprintf_styled_func) (info->stream, dis_style_immediate,
"0x%x", signed_operand_val);
}
}
else
{
int i = 1;
xtensa_regfile opnd_rf = xtensa_operand_regfile (isa, opc, opnd);
(*info->fprintf_styled_func) (info->stream, dis_style_register,
"%s%u",
xtensa_regfile_shortname (isa, opnd_rf),
operand_val);
while (i < xtensa_operand_num_regs (isa, opc, opnd))
{
operand_val++;
(*info->fprintf_styled_func) (info->stream, dis_style_register,
":%s%u",
xtensa_regfile_shortname (isa, opnd_rf),
operand_val);
i++;
}
}
}
/* Print the Xtensa instruction at address MEMADDR on info->stream.
Returns length of the instruction in bytes. */
int
print_insn_xtensa (bfd_vma memaddr, struct disassemble_info *info)
{
unsigned operand_val;
int bytes_fetched, size, maxsize, i, n, noperands, nslots;
xtensa_isa isa;
xtensa_opcode opc;
xtensa_format fmt;
static struct dis_private priv;
static bfd_byte *byte_buf = NULL;
static xtensa_insnbuf insn_buffer = NULL;
static xtensa_insnbuf slot_buffer = NULL;
int first, first_slot, valid_insn;
property_table_entry *insn_block;
enum dis_insn_type insn_type;
bfd_vma target;
if (!xtensa_default_isa)
xtensa_default_isa = xtensa_isa_init (0, 0);
info->target = 0;
maxsize = xtensa_isa_maxlength (xtensa_default_isa);
/* Set bytes_per_line to control the amount of whitespace between the hex
values and the opcode. For Xtensa, we always print one "chunk" and we
vary bytes_per_chunk to determine how many bytes to print. (objdump
would apparently prefer that we set bytes_per_chunk to 1 and vary
bytes_per_line but that makes it hard to fit 64-bit instructions on
an 80-column screen.) The value of bytes_per_line here is not exactly
right, because objdump adds an extra space for each chunk so that the
amount of whitespace depends on the chunk size. Oh well, it's good
enough.... Note that we set the minimum size to 4 to accomodate
literal pools. */
info->bytes_per_line = MAX (maxsize, 4);
/* Allocate buffers the first time through. */
if (!insn_buffer)
{
insn_buffer = xtensa_insnbuf_alloc (xtensa_default_isa);
slot_buffer = xtensa_insnbuf_alloc (xtensa_default_isa);
byte_buf = (bfd_byte *) xmalloc (MAX (maxsize, 4));
}
priv.byte_buf = byte_buf;
info->private_data = (void *) &priv;
/* Prepare instruction tables. */
if (info->section != NULL)
{
asection *section = info->section;
if (priv.last_section != section)
{
bfd *abfd = section->owner;
if (priv.last_section != NULL)
{
/* Reset insn_table_entries. */
priv.insn_table_entry_count = 0;
free (priv.insn_table_entries);
priv.insn_table_entries = NULL;
}
priv.last_section = section;
/* Read insn_table_entries. */
priv.insn_table_entry_count =
xtensa_read_table_entries (abfd, section,
&priv.insn_table_entries,
XTENSA_PROP_SEC_NAME, false);
if (priv.insn_table_entry_count == 0)
{
free (priv.insn_table_entries);
priv.insn_table_entries = NULL;
/* Backwards compatibility support. */
priv.insn_table_entry_count =
xtensa_read_table_entries (abfd, section,
&priv.insn_table_entries,
XTENSA_INSN_SEC_NAME, false);
}
priv.insn_table_cur_idx = 0;
xtensa_coalesce_insn_tables (&priv);
}
/* Else nothing to do, same section as last time. */
}
if (OPCODES_SIGSETJMP (priv.bailout) != 0)
/* Error return. */
return -1;
/* Fetch the maximum size instruction. */
bytes_fetched = fetch_data (info, memaddr);
insn_block = xtensa_find_table_entry (memaddr, info);
/* Don't set "isa" before the setjmp to keep the compiler from griping. */
isa = xtensa_default_isa;
size = 0;
nslots = 0;
valid_insn = 0;
fmt = 0;
if (!insn_block || (insn_block->flags & XTENSA_PROP_INSN))
{
/* Copy the bytes into the decode buffer. */
memset (insn_buffer, 0, (xtensa_insnbuf_size (isa) *
sizeof (xtensa_insnbuf_word)));
xtensa_insnbuf_from_chars (isa, insn_buffer, priv.byte_buf,
bytes_fetched);
fmt = xtensa_format_decode (isa, insn_buffer);
if (fmt != XTENSA_UNDEFINED
&& ((size = xtensa_format_length (isa, fmt)) <= bytes_fetched)
&& xtensa_instruction_fits (memaddr, size, insn_block))
{
/* Make sure all the opcodes are valid. */
valid_insn = 1;
nslots = xtensa_format_num_slots (isa, fmt);
for (n = 0; n < nslots; n++)
{
xtensa_format_get_slot (isa, fmt, n, insn_buffer, slot_buffer);
if (xtensa_opcode_decode (isa, fmt, n, slot_buffer)
== XTENSA_UNDEFINED)
{
valid_insn = 0;
break;
}
}
}
}
if (!valid_insn)
{
if (insn_block && (insn_block->flags & XTENSA_PROP_LITERAL)
&& (memaddr & 3) == 0 && bytes_fetched >= 4)
{
info->bytes_per_chunk = 4;
return 4;
}
else
{
(*info->fprintf_styled_func) (info->stream,
dis_style_assembler_directive,
".byte");
(*info->fprintf_func) (info->stream, "\t");
(*info->fprintf_styled_func) (info->stream,
dis_style_immediate,
"%#02x", priv.byte_buf[0]);
return 1;
}
}
if (nslots > 1)
(*info->fprintf_func) (info->stream, "{ ");
insn_type = dis_nonbranch;
target = 0;
first_slot = 1;
for (n = 0; n < nslots; n++)
{
int imm_pcrel = 0;
if (first_slot)
first_slot = 0;
else
(*info->fprintf_func) (info->stream, "; ");
xtensa_format_get_slot (isa, fmt, n, insn_buffer, slot_buffer);
opc = xtensa_opcode_decode (isa, fmt, n, slot_buffer);
(*info->fprintf_styled_func) (info->stream,
dis_style_mnemonic, "%s",
xtensa_opcode_name (isa, opc));
if (xtensa_opcode_is_branch (isa, opc))
info->insn_type = dis_condbranch;
else if (xtensa_opcode_is_jump (isa, opc))
info->insn_type = dis_branch;
else if (xtensa_opcode_is_call (isa, opc))
info->insn_type = dis_jsr;
else
info->insn_type = dis_nonbranch;
/* Print the operands (if any). */
noperands = xtensa_opcode_num_operands (isa, opc);
first = 1;
for (i = 0; i < noperands; i++)
{
if (xtensa_operand_is_visible (isa, opc, i) == 0)
continue;
if (first)
{
(*info->fprintf_func) (info->stream, "\t");
first = 0;
}
else
(*info->fprintf_func) (info->stream, ", ");
(void) xtensa_operand_get_field (isa, opc, i, fmt, n,
slot_buffer, &operand_val);
print_xtensa_operand (memaddr, info, opc, i, operand_val);
if (xtensa_operand_is_PCrelative (isa, opc, i))
++imm_pcrel;
}
if (!imm_pcrel)
info->insn_type = dis_nonbranch;
if (info->insn_type != dis_nonbranch)
{
insn_type = info->insn_type;
target = info->target;
}
}
info->insn_type = insn_type;
info->target = target;
info->insn_info_valid = 1;
if (nslots > 1)
(*info->fprintf_func) (info->stream, " }");
info->bytes_per_chunk = size;
info->display_endian = info->endian;
return size;
}