[mirror_edk2.git] / ArmPkg / Include / Library / ArmDisassemblerLib.h

/** @file

  Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>

  This program and the accompanying materials
  are licensed and made available under the terms and conditions of the BSD License
  which accompanies this distribution.  The full text of the license may be found at
  http://opensource.org/licenses/bsd-license.php

  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

**/

#ifndef __ARM_DISASSEBLER_LIB_H__
#define __ARM_DISASSEBLER_LIB_H__

/**
  Place a dissasembly of of **OpCodePtr into buffer, and update OpCodePtr to 
  point to next instructin. 
  
  We cheat and only decode instructions that access 
  memory. If the instruction is not found we dump the instruction in hex.
   
  @param  OpCodePtrPtr  Pointer to pointer of ARM Thumb instruction to disassemble.  
  @param  Thumb         TRUE for Thumb(2), FALSE for ARM instruction stream
  @param  Extended      TRUE dump hex for instruction too.
  @param  ItBlock       Size of IT Block\r
  @param  Buf           Buffer to sprintf disassembly into.
  @param  Size          Size of Buf in bytes. 
  
**/
VOID
DisassembleInstruction (
  IN  UINT8     **OpCodePtr,
  IN  BOOLEAN   Thumb,
  IN  BOOLEAN   Extended,
  IN OUT UINT32 *ItBlock,\r
  OUT CHAR8     *Buf,
  OUT UINTN     Size
  );
  
#endif
Commit	Line	Data
097bd461	1	/** @file
097bd461	2
d6ebcab7	3	Copyright (c) 2008 - 2010, Apple Inc. All rights reserved.<BR>
097bd461	4
d6ebcab7	5	This program and the accompanying materials
097bd461	6	are licensed and made available under the terms and conditions of the BSD License
	7	which accompanies this distribution. The full text of the license may be found at
	8	http://opensource.org/licenses/bsd-license.php
	9
	10	THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
	11	WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
	12
	13	**/
	14
	15	#ifndef __ARM_DISASSEBLER_LIB_H__
	16	#define __ARM_DISASSEBLER_LIB_H__
	17
	18	/**
	19	Place a dissasembly of of **OpCodePtr into buffer, and update OpCodePtr to
	20	point to next instructin.
	21
	22	We cheat and only decode instructions that access
	23	memory. If the instruction is not found we dump the instruction in hex.
	24
	25	@param OpCodePtrPtr Pointer to pointer of ARM Thumb instruction to disassemble.
	26	@param Thumb TRUE for Thumb(2), FALSE for ARM instruction stream
f9f937d2	27	@param Extended TRUE dump hex for instruction too.
f3198cba	28	@param ItBlock Size of IT Block\r
097bd461	29	@param Buf Buffer to sprintf disassembly into.
	30	@param Size Size of Buf in bytes.
	31
	32	**/
	33	VOID
	34	DisassembleInstruction (
	35	IN UINT8 **OpCodePtr,
	36	IN BOOLEAN Thumb,
f9f937d2	37	IN BOOLEAN Extended,
f3198cba	38	IN OUT UINT32 *ItBlock,\r
097bd461	39	OUT CHAR8 *Buf,
	40	OUT UINTN Size
	41	);
	42
	43	#endif