• file
• revisions
• annotate
• diff
• comparison
• raw

src/share/tools/hsdis/hsdis.h@c18cbe5936b8 (annotated)

src/share/tools/hsdis/hsdis.h

Thu, 27 May 2010 19:08:38 -0700

author

trims

date

Thu, 27 May 2010 19:08:38 -0700

changeset 1907

c18cbe5936b8

parent 535

c7c777385a15

child 2314

f95d63e2154a

permissions

-rw-r--r--

6941466: Oracle rebranding changes for Hotspot repositories
Summary: Change all the Sun copyrights to Oracle copyright
Reviewed-by: ohair

jrose@535	1	/*
trims@1907	2	* Copyright (c) 2008, Oracle and/or its affiliates. All rights reserved.
jrose@535	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
jrose@535	4	*
jrose@535	5	* This code is free software; you can redistribute it and/or modify it
jrose@535	6	* under the terms of the GNU General Public License version 2 only, as
jrose@535	7	* published by the Free Software Foundation.
jrose@535	8	*
jrose@535	9	* This code is distributed in the hope that it will be useful, but WITHOUT
jrose@535	10	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
jrose@535	11	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
jrose@535	12	* version 2 for more details (a copy is included in the LICENSE file that
jrose@535	13	* accompanied this code).
jrose@535	14	*
jrose@535	15	* You should have received a copy of the GNU General Public License version
jrose@535	16	* 2 along with this work; if not, write to the Free Software Foundation,
jrose@535	17	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
jrose@535	18	*
trims@1907	19	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
trims@1907	20	* or visit www.oracle.com if you need additional information or have any
trims@1907	21	* questions.
jrose@535	22	*
jrose@535	23	*/
jrose@535	24
jrose@535	25	/* decode_instructions -- dump a range of addresses as native instructions
jrose@535	26	This implements the protocol required by the HotSpot PrintAssembly option.
jrose@535	27
jrose@535	28	The starting and ending addresses are within the current process's address space.
jrose@535	29
jrose@535	30	The option string, if not empty, is interpreted by the disassembler implementation.
jrose@535	31
jrose@535	32	The printf callback is 'fprintf' or any other workalike.
jrose@535	33	It is called as (*printf_callback)(printf_stream, "some format...", some, format, args).
jrose@535	34
jrose@535	35	The event callback receives an event tag (a string) and an argument (a void*).
jrose@535	36	It is called as (*event_callback)(event_stream, "tag", arg).
jrose@535	37
jrose@535	38	Events:
jrose@535	39	<insn pc='%p'> begin an instruction, at a given location
jrose@535	40	</insn pc='%d'> end an instruction, at a given location
jrose@535	41	<addr value='%p'/> emit the symbolic value of an address
jrose@535	42
jrose@535	43	A tag format is one of three basic forms: "tag", "/tag", "tag/",
jrose@535	44	where tag is a simple identifier, signifying (as in XML) a element start,
jrose@535	45	element end, and standalone element. (To render as XML, add angle brackets.)
jrose@535	46	*/
jrose@535	47	extern
jrose@535	48	#ifdef DLL_EXPORT
jrose@535	49	DLL_EXPORT
jrose@535	50	#endif
jrose@535	51	void* decode_instructions(void* start, void* end,
jrose@535	52	void* (*event_callback)(void*, const char*, void*),
jrose@535	53	void* event_stream,
jrose@535	54	int (*printf_callback)(void*, const char*, ...),
jrose@535	55	void* printf_stream,
jrose@535	56	const char* options);
jrose@535	57
jrose@535	58	/* convenience typedefs */
jrose@535	59
jrose@535	60	typedef void* (*decode_instructions_event_callback_ftype) (void*, const char*, void*);
jrose@535	61	typedef int (*decode_instructions_printf_callback_ftype) (void*, const char*, ...);
jrose@535	62	typedef void* (*decode_instructions_ftype) (void* start, void* end,
jrose@535	63	decode_instructions_event_callback_ftype event_callback,
jrose@535	64	void* event_stream,
jrose@535	65	decode_instructions_printf_callback_ftype printf_callback,
jrose@535	66	void* printf_stream,
jrose@535	67	const char* options);