arch: Add a virtual asBytes function to the StaticInst class.
authorGabe Black <gabeblack@google.com>
Wed, 24 Jan 2018 07:57:48 +0000 (23:57 -0800)
committerGabe Black <gabeblack@google.com>
Mon, 26 Mar 2018 22:33:52 +0000 (22:33 +0000)
commit81050be736f0d7ac71e7f862a4f34b1ed6787716
tree7270526d3375cf0464c07a6c4e2feefbb16faba1
parentf6a28e5fc2e698cb7c6f35bb2476a1cce9f689d2
arch: Add a virtual asBytes function to the StaticInst class.

This function takes a pointer to a buffer and the current size of the
buffer as a pass by reference argument. If the size of the buffer is
sufficient, the function stores a binary representation of itself
(generally the ISA defined instruction encoding) in the buffer, and
sets the size argument to how much space it used. This could be used
by ISAs which have two instruction sizes (ARM and thumb, for example).
If the buffer size isn't sufficient, then the size parameter should be
set to what size is required, and then the function should return
without modifying the buffer.

The buffer itself should be aligned to the same standard as memory
returned by new, specifically "The pointer returned shall be suitably
aligned so that it can be converted to a pointer of any complete object
type and then used to access the object or array in the storage
allocated...". This will avoid having to memcpy buffers to avoid
unaligned accesses.

To standardize the representation of the data, it should be stored in
the buffer as little endian. Since most hosts (including ARM and x86
hosts) will be little endian, this will almost always be a no-op.

Change-Id: I2f31aa0b4f9c0126b44f47a881c2901243279bd6
Reviewed-on: https://gem5-review.googlesource.com/7562
Reviewed-by: Andreas Sandberg <andreas.sandberg@arm.com>
Maintainer: Gabe Black <gabeblack@google.com>
src/arch/alpha/isa/main.isa
src/arch/arm/insts/static_inst.hh
src/arch/mips/isa/base.isa
src/arch/power/insts/static_inst.hh
src/arch/riscv/insts/static_inst.hh
src/arch/sparc/insts/static_inst.hh
src/cpu/static_inst.hh