API 7.0 Porting Guide

clear IDA 7.0 SDK: Porting from IDA 4.9-6.x API to IDA 7.0 API

Introduction

The SDK now only supports the new 7.0 API in x64 mode. The old SDK 6.95 can be used to develop plugins for IDA 7.0-x86 (which is ABI-compatible with IDA 6.95).

While the API has been revamped somewhat, most basic concepts still hold.

There are still two variants of IDA: one supporting 32-bit (ea_t is 32-bit) and the other 64-bit address space (ea_t is 64-bit). IDA database extensions remain correspondingly '.idb' and '.i64'.

Naming of IDA binaries has been unified across all OS variants:

• The IDA GUI binary has been renamed from 'idaq[.exe]' to just 'ida[.exe]'.

• The IDA text-mode UI has been renamed from 'idaw.exe' (on Windows) and 'idal' (on Linux/Mac OS X) to 'idat[.exe]' on all platforms.

• Plugins, loaders, processor modules, and the kernel now use standard OS-specific suffixes ('.dll', '.so', or '.dylib') instead of custom extensions.

General approaches that were taken when cleaning up the APIs:

• Try to use descriptive names and drop old, cryptic abbreviations.

• Rename functions using camelCase to snake_case (e.g. 'isFlow' -> 'is_flow').

• Move output parameters to the front of the argument list.

• Change input parameters to const references whenever possible.

• Remove obsolete and deprecated functions.

• Rename functioname2/3 to just functioname (e.g. 'validate_name3' -> 'validate_name').

• Rename functions with 64 suffix to the main name (e.g. 'qfseek64' -> 'qfseek').

• File offsets are 64-bit in all functions working with files.

• Get rid of global variables (not complete, but we made good progress).

• Most functions accepting a buffer and size (or limited to MAXSTR) now use 'qstring' or 'bytevec_t' instead (depending on the nature of the data).

• Assume UTF-8 in most functions dealing with text.

• Try to get rid of forced struct packing and rearrange fields to avoid unnecessary gaps as needed.

Porting

Common porting steps for plugins/loaders/modules:

• Add __X64__ to the list of preprocessor defines. You still need to compile with or without __EA64__ defined to select between 32- and 64-bit address space.

• If using custom build system, change output extension to OS-specific suffixes ('.dll', '.so', or '.dylib').

• IDA library link path should start with x64 instead of x86.

Renamed/removed header files

Some headers have been renamed and/or removed:

original name	new name
ints.hpp	<removed>
sistack.h	<removed>
area.hpp	range.hpp
queue.hpp	problems.hpp
srarea.hpp	segregs.hpp

Commonly used renamed structs and fields

original name	new name
area_t	range_t
areavec_t	rangevec_t
endEA	end_ea
startEA	start_ea

area-related methods have been renamed too (e.g. 'prev_area' -> 'prev_range').

Porting plugins.

The plugin entry prototype has been changed from:

• void idaapi run(int);

to:

• bool idaapi run(size_t);

The input parameter is now of type 'size_t', which allows passing a pointer as the argument of run() for extra possibilities.

The rest of the plugin interface is unchanged.

Porting loaders

The prototype for 'accept_file()' has been changed from:

• int idaapi accept_file(linput_t *li, char fileformatname[MAX_FILE_FORMAT_NAME], int n);

to:

• int idaapi accept_file(qstring *fileformatname, qstring *processor, linput_t *li, const char *filename);

The desired processor may be returned in the 'processor' output parameter.

The return value has been extended with flags 'ACCEPT_ARCHIVE' and 'ACCEPT_CONTINUE'.

Loaders can also process and extract archives now. If you detect an archive, the return value for 'accept_file' should be ORed with the 'ACCEPT_ARCHIVE' flag. After extraction, all loaders are queried again, which means IDA can now handle multiply nested archives.

Non-archive loaders should extend the return value with the 'ACCEPT_CONTINUE' flag.

Porting processor modules

WARNING: The global variables 'cmd' and 'uFlag' are gone.

Most APIs return or accept an 'insn_t' structure with instruction details.

The 'processor_t' structure has had many unused and obsolete fields removed, such as 'flag2', 'rFiles', 'rFnames', 'rFdescs', and 'CPUregs'.

Most callbacks are now handled centrally via the 'notify()' function:

original name	new name
header	ev_out_header
footer	ev_out_footer
segstart	ev_out_segstart
segend	ev_out_segend
assumes	ev_out_assumes
u_ana	ev_ana_insn
u_emu	ev_emu_insn
u_out	ev_out_insn
u_outop	ev_out_operand
d_out	ev_out_data
cmp_opnd	ev_cmp_opnd
can_have_type	ev_can_have_type
is_far_jump	ev_is_far_jump
getreg	ev_getreg

ana.cpp

Change the prototype of 'ana' from:

• int idaapi ana(void);

to:

• int idaapi ana(insn_t *_insn);

You may then declare an 'insn_t' reference variable to simplify your code:

• insn_t &insn = *_insn;

Then replace all uses of 'cmd' by 'insn'. You will likely need to pass 'insn' to other helper functions that used 'cmd'.

emu.cpp

Change the prototype of 'emu' from:

• int idaapi emu(void);

to:

• int idaapi emu(const insn_t &insn);

Then replace all uses of 'cmd' by 'insn'. You may need to adjust some code if it was relying on cmd being writeable.

out.cpp

The output functions now use a context structure ('outctx_t') instead of operating on a global buffer.

You must declare a class inheriting from 'outctx_t' and override its methods or add new ones for non-standard functions. For example:

class out_myproc_t : public outctx_t
{
  void outreg(int r) { out_register(ph.reg_names[r]); }
  void outmem(const op_t &x, ea_t ea);
  bool outbit(ea_t ea, int bit);

  bool out_operand(const op_t &x);
  void out_insn(void);
  void out_mnem(void);
}

Then use one of the two macros from idaidp.hpp:

• DECLARE_OUT_FUNCS_WITHOUT_OUTMNEM(out_myproc_t)

or, if you implement 'out_mnem':

• DECLARE_OUT_FUNCS(out_myproc_t)

Then prefix old function names with your class and rename them to match methods. For example, from:

  void idaapi out(void);
  void out_myproc_t::out(void);

to:

  bool idaapi outop(op_t &x);
  bool out_myproc_t::out_operand(const op_t &x);

Then remove calls to 'init_output_buffer()' and uses of the buffer variable.

Other changes that must be made are:

• Replacing references to 'cmd' with 'insn';

• Replacing term_output_buffer()/MakeLine() sequence with flush_outbuf().

Most of the other code can remain intact or can be replaced by the new helper functions.

For other output-related callbacks, convert them to take an 'outctx_t &ctx' parameter and use its methods. For example, from:

• void idaapi header(void);

to:

• void idaapi myproc_header(outctx_t &ctx)

See the changes to 'ua.hpp' below for more information on converting the functions.

Also, see the SDK samples for more ideas.

reg.cpp

Remove the old callbacks from the 'processor_t' structure and call them from the 'notify()' function instead. For example:

    case processor_t::ev_ana_insn:
      {
        insn_t *out = va_arg(va, insn_t *);
        return myproc_ana(out);
      }

For 'ev_out_insn', call 'out_insn()' generated by the macro in out.cpp:

    case processor_t::ev_out_insn:
      {
        outctx_t *ctx = va_arg(va, outctx_t *);
        out_insn(*ctx);
        return 1;
      }

Porting notifications

• When hooking notifications, return 0 for "not handled" instead of 1 as before.

• Many notifications had their arguments types and/or order changed. Double-check your handlers against the new headers.

• Instead of calling ph.notify() or similar, prefer helper inline functions for additional type safety. For example, use 'ph.get_operand_string()' instead of 'ph.notify(processor_t::get_operand_string, ...)'.

• Some IDP events have been moved to the IDB event group (see the table class="table table-sm" below), so they should be handled on the HT_IDB level. You will need to move the corresponding code from the IDP notification hooks to the IDB hooks.

original IDP event	new IDB notification
closebase	closebase
savebase	savebase
auto_empty	auto_empty
auto_empty_finally	auto_empty_finally
determined_main	determined_main
load_idasgn	idasgn_loaded
kernel_config_loaded	kernel_config_loaded
loader_finished	loader_finished
preprocess_chart	flow_chart_created
setsgr	sgr_changed
set_compiler	compiler_changed
move_segm	segm_moved
extlang_changed	extlang_changed
make_code	make_code
make_data	make_data
renamed	renamed
add_func	func_added
del_func	deleting_func
set_func_start	set_func_start
set_func_end	set_func_end

UI: Porting choosers

• Make a new class derived from 'chooser_t' or 'chooser_multi_t'. Its fields are similar to arguments of 'choose2()' from IDA 6.95.

• You should implement at least 2 methods:

• 'get_count()', and

• 'get_row()'.

The 'get_row()' method combines 3 methods of 6.95's old 'chooser_info_t':

• 'get_row()'

• 'get_icon()', and

• 'get_attrs()'

• If you want to show actions Ins/Delete/Edit/Refresh in a popup-menu you should set new bits 'CH_CAN_...' in the 'flags' member.

• The header line is stored in a new 'header' member.

• All indexes are now 0-based. You can use new constant 'NO_SELECTION' for non-existing rows.

• The default value is not stored in the 'chooser_t' structure now and it is passed directly to the 'choose()' function.

• You can prepare a specialized version of the 'choose()' method that takes a special default value (e.g. an effective address). For this you should implement a new 'get_item_index()' method.

• The 'update()' callback has been renamed to 'refresh()' and it returns the cursor position after refresh. If the data has not changed this callback should return a 'NOTHING_CHANGED' hint.

• The returned value of the 'ins()', 'del()', 'edit()' and 'exit()' callbacks are the same as for 'refresh()' callback. E.g. the 'ins()' callback may return the cursor position of the newly inserted item. Or the 'del()' callback may return 'NOTHING_CHANGED' if it asked the user about the removal and he refused.

• The 'initializer()' callback has been renamed to 'init()'. Its use allows you to prepare data when it is really needed (i.e., "lazy" populating).

• The 'destroyer()' callback has been renamed to 'closed()' and it is called when the chooser window is about to close. To clean up the chooser data you should use the destructor.

• The 'CH_MULTI' flag has been removed altogether. If you want to create a chooser with multiple selection, you should derive your class from 'chooser_multi_t'.

• While callbacks for the 'chooser_t' class would receive and return a single value specifying the currently-selected row, callbacks of the 'chooser_multi_t' class will receive a vector of such values instead.

• In a similar fashion, instead of using the 'NO_SELECTION' constant, 'chooser_multi_t' will use an empty vector.

• In contrast to IDA 6.95, the selected items are now all processed at once, in one call to the 'ins()', 'del()', 'edit()' and 'exit()' callbacks (this greatly simplified implementing them.)

Changes per file in the SDK

This section describes in detail the changes to the APIs for each file in the SDK.

auto.hpp

NOTE: global variables 'auto_state', 'auto_display', and 'autoEnabled' have been removed.

• [1] output argument moved to beginning of argument list

original name	new name	[1]	Notes
autoGetName	<removed>
autoStep	<removed>
<added>	auto_apply_tail
<added>	auto_recreate_insn
<added>	enable_auto		to be used instead of 'autoEnabled'
<added>	get_auto_display		to be used instead of 'auto_display'
<added>	get_auto_state		to be used instead of 'auto_state'
<added>	is_auto_enabled		to be used instead of 'autoEnabled'
<added>	set_auto_state		to be used instead of 'auto_state'
analyze_area	plan_and_wait		added 'final_pass' argument (true for analyze_area behaviour)
autoCancel	auto_cancel
autoIsOk	auto_is_ok
autoMark	auto_mark
autoUnmark	auto_unmark
autoWait	auto_wait
auto_get		*
noUsed	plan_ea		(ea_t ea) variant
noUsed	plan_range		(ea_t sEA, ea_t eEA) variant
setStat	set_ida_state
showAddr	show_addr
showAuto	show_auto

bitrange.hpp

original name	Notes
bitrange_t::extract	argument type: 'int' changed to 'size_t'
bitrange_t::inject	argument type: 'int' changed to 'size_t'

bytes.hpp

NOTE: The misleading term "ASCII string" has been replaced by "string literal" (strlit).

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
clrFlbits	<removed>
do3byte	<removed>
doASCI	<removed>
doVar	<removed>
do_unknown	<removed>			use 'del_items' instead
do_unknown_range	<removed>			use 'del_items' instead
f_is3byte	<removed>
getRadixEA	<removed>
get_3byte	<removed>
get_many_bytes	<removed>			use 'get_bytes' instead
get_many_bytes_ex	<removed>			use 'get_bytes' instead
is3byte	<removed>
isVar	<removed>
noImmd	<removed>
setFlags	<removed>
setFlbits	<removed>
tribyteflag	<removed>
<added>	add_mapping
<added>	attach_custom_data_format
<added>	del_items
<added>	del_mapping
<added>	detach_custom_data_format
<added>	get_bytes
<added>	get_first_hidden_range
<added>	get_last_hidden_range
<added>	get_mapping
<added>	get_mappings_qty
<added>	is_attached_custom_data_format
<added>	revert_byte
<added>	update_hidden_range
<added>	use_mapping
add_hidden_area	add_hidden_range
alignflag	align_flag
asciflag	strlit_flag
binflag	bin_flag
byteflag	byte_flag
charflag	char_flag
chunksize	chunk_size
chunkstart	chunk_start
codeflag	code_flag
custflag	cust_flag
custfmtflag	custfmt_flag
decflag	dec_flag
delValue	del_value
del_hidden_area	del_hidden_range
do16bit	create_16bit_data
do32bit	create_32bit_data
doAlign	create_align
doByte	create_byte
doCustomData	create_custdata
doDouble	create_double
doDwrd	create_dword
doFloat	create_float
doImmd	set_immd
doOwrd	create_oword
doPackReal	create_packed_real
doQwrd	create_qword
doStruct	create_struct
doTbyt	create_tbyte
doWord	create_word
doYwrd	create_yword
doZwrd	create_zword
do_data_ex	create_data
doubleflag	double_flag
dwrdflag	dword_flag
enumflag	enum_flag
f_hasRef	f_has_xref
f_isASCII	f_is_strlit
f_isAlign	f_is_align
f_isByte	f_is_byte
f_isCode	f_is_code
f_isCustom	f_is_custom
f_isData	f_is_data
f_isDouble	f_is_double
f_isDwrd	f_is_dword
f_isFloat	f_is_float
f_isHead	f_is_head
f_isNotTail	f_is_not_tail
f_isOwrd	f_is_oword
f_isPackReal	f_is_pack_real
f_isQwrd	f_is_qword
f_isStruct	f_is_struct
f_isTail	f_is_tail
f_isTbyt	f_is_tbyte
f_isWord	f_is_word
f_isYwrd	f_is_yword
floatflag	float_flag
fltflag	flt_flag
freechunk	free_chunk
getDefaultRadix	get_default_radix
getFlags	get_full_flags			WARNING: 'getFlags' has not been renamed to 'get_flags'
get_long	get_dword
get_full_byte	get_wide_byte
get_full_word	get_wide_word
get_full_long	get_wide_dword
get_original_long	get_original_dword
put_long	put_dword
patch_long	patch_dword
add_long	add_dword
getRadix	get_radix
get_ascii_contents2	get_strlit_contents	q	*	return type changed from 'bool' to 'ssize_t'; output argument 'usedsize' (in bytes) changed to 'maxcps' (in codepoints)
get_cmt		q	*
get_custom_data_format				removed 'dtid' argument
get_data_value		*
get_enum_id		*
get_flags_novalue	get_flags			WARNING: 'getFlags' has not been renamed to 'get_flags'
get_forced_operand		q	*
get_hidden_area	get_hidden_range			return type: 'hidden_area_t *' has been renamed to 'hidden_range_t *'
get_hidden_area_num	get_hidden_range_num
get_hidden_area_qty	get_hidden_range_qty
get_manual_insn		q	*	return type changed from 'char *' to 'ssize_t';
get_max_ascii_length	get_max_strlit_length
get_next_hidden_range	get_next_hidden_area			return type: 'hidden_area_t *' has been renamed to 'hidden_range_t *'
get_opinfo		*
get_predef_insn_cmt		q	*	moved from ints.hpp
get_prev_hidden_range	get_prev_hidden_area			return type: 'hidden_area_t *' has been renamed to 'hidden_range_t *'
get_stroff_path		*
get_zero_areas	get_zero_ranges			argument type: 'areaset_t' has been renamed to 'rangeset_t'
getn_hidden_area	getn_hidden_range			return type: 'hidden_area_t *' has been renamed to 'hidden_range_t *'
hasExtra	has_extra_cmts
hasRef	has_xref
hasValue	has_value
hexflag	hex_flag
isASCII	is_strlit
isAlign	is_align
isByte	is_byte
isChar	is_char
isChar0	is_char0
isChar1	is_char1
isCode	is_code
isCustFmt	is_custfmt
isCustFmt0	is_custfmt0
isCustFmt1	is_custfmt1
isCustom	is_custom
isData	is_data
isDefArg	is_defarg
isDefArg0	is_defarg0
isDefArg1	is_defarg1
isDouble	is_double
isDwrd	is_dword
isEnabled	is_mapped
isEnum	is_enum
isEnum0	is_enum0
isEnum1	is_enum1
isFloat	is_float
isFloat0	is_float0
isFloat1	is_float1
isFlow	is_flow
isFltnum	is_fltnum
isFop	is_manual
isFunc	is_func
isHead	is_head
isImmd	has_immd
isLoaded	is_loaded
isNotTail	is_not_tail
isNum	is_numop
isNum0	is_numop0
isNum1	is_numop1
isOff	is_off
isOff0	is_off0
isOff1	is_off1
isOwrd	is_oword
isPackReal	is_pack_real
isQwrd	is_qword
isSeg	is_seg
isSeg0	is_seg0
isSeg1	is_seg1
isStkvar	is_stkvar
isStkvar0	is_stkvar0
isStkvar1	is_stkvar1
isStroff	is_stroff
isStroff0	is_stroff0
isStroff1	is_stroff1
isStruct	is_struct
isTail	is_tail
isTbyt	is_tbyte
isUnknown	is_unknown
isVoid	is_suspop
isWord	is_word
isYwrd	is_yword
isZwrd	is_zword
make_ascii_string	create_strlit
nextaddr	next_addr
nextchunk	next_chunk
nextthat	next_that
noType	clr_op_type
numflag	num_flag
octflag	oct_flag
offflag	off_flag
op_stroff				converted input 'ea_t' argument to 'const insn_t &'
owrdflag	oword_flag
packrealflag	packreal_flag
patch_many_bytes	patch_bytes
prevaddr	prev_addr
prevchunk	prev_chunk
prevthat	prev_that
print_ascii_string_type	print_strlit_type	q	*	return type changed from 'char *' to 'bool'; added 'out_tooltip' and 'flags' arguments
put_many_bytes	put_bytes
qwrdflag	qword_flag
register_custom_data_format				removed 'dtid' argument
segflag	seg_flag
set_opinfo				added 'suppress_events' argument
stkvarflag	stkvar_flag
stroffflag	stroff_flag
struflag	stru_flag
tbytflag	tbyte_flag
unregister_custom_data_format				removed 'dtid' argument
wordflag	word_flag
ywrdflag	yword_flag
zwrdflag	zword_flag

compress.hpp

original name	new name
process_zipfile64	process_zipfile
process_zipfile_entry64	process_zipfile_entry

config.hpp (NEW file)

original name	Notes
cfg_get_cc_header_path	moved from idp.hpp
cfg_get_cc_parm	moved from idp.hpp
cfg_get_cc_predefined_macros	moved from idp.hpp
cfgopt_t__apply	moved from idp.hpp
parse_config_value	moved from idp.hpp
read_config	moved from idp.hpp
read_config_file	moved from idp.hpp
read_config_string	moved from idp.hpp

dbg.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
get_process_info	<removed>			use 'get_processes' instead
get_process_qty	<removed>			use 'get_processes' instead
getn_process	<removed>			use 'get_processes' instead
<added>	bpt_t::get_cnd_elang_idx
<added>	get_ip_val
<added>	get_sp_val
bpt_location_t::print			*
choose_trace_file			*
create_source_viewer				argument type: 'TWinControl' and 'TCustomControl' changed to 'TWidget'; added 'out_ccv' argument
get_dbg_byte		*
get_trace_file_desc		q	*
internal_get_sreg_base		*
load_trace_file		q	*
source_file_t::open_srcview				argument type: 'TCustomControl' changed to 'TWidget'
source_item_t::get_hint		q
source_item_t::get_kind	source_item_t::get_item_kind

diskio.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] return type changed from '[u]int32' to '[u]int64'/'qoff64_t'

• [4] input argument changed from '[u]int32' to '[u]int64'/'qoff64_t'

original name	new name	[1]	[2]	[3]	[4]	Notes
create_generic_linput	<removed>
echsize64	<removed>
ecreateT	<removed>
eseek64	<removed>
free_ioports	<removed>
qfsize64	<removed>
qlgetz64	<removed>
qlseek64	<removed>
qlsize64	<removed>
qltell64	<removed>
choose_ioport_device		q	*
echsize					*
eseek					*
find_ioport						input argument converted to 'const ioports_t &'
find_ioport_bit						input argument converted to 'const ioports_t &'
get_special_folder		*
getdspace	get_free_disk_space
qfsize				*
qlgetz					*
qlseek				*	*
qlsize				*
qltell				*
read_ioports						return type changed from 'ioport_t *' to 'ssize_t'; output argument converted 'ioports_t'

entry.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] added 'flags' argument

original name	[1]	[2]	[3]
add_entry			*
get_entry_forwarder	q	*
get_entry_name	q	*
rename_entry			*
set_entry_forwarder			*

enum.hpp

NOTE: global variable 'enums' has been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]
add_selected_enum	<removed>
get_bmask_node	<removed>
get_selected_enum	<removed>
init_enums	<removed>
save_enums	<removed>
set_enum_flag	<removed>
term_enums	<removed>
unmark_selected_enums	<removed>
get_bmask_cmt		q	*
get_enum_cmt		q	*
get_enum_member_cmt		q	*
get_first_serial_enum_member		*
get_last_serial_enum_member		*
get_next_serial_enum_member		*
get_prev_serial_enum_member		*

err.h

original name	Notes
qstrerror	buf argument removed; returns string in static buffer (thread-safe)

expr.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] input argument changed from pointer to reference

original name	new name	[1]	[2]	[3]	Notes
ExecuteFile	<removed>				use 'exec_idc_script' instead
ExecuteLine, execute	<removed>				use 'eval_idc_snippet' instead
call_idc_method	<removed>
call_script_method	<removed>				use 'extlang_t::call_method' instead
compile_script_file	<removed>				use 'extlang_t::compile_file' instead
compile_script_func	<removed>				use 'extlang_t::compile_expr' instead
create_idc_object	<removed>
create_script_object	<removed>				use 'extlang_t::create_object' instead
extlang_call_method_exists	<removed>				'extlang_t::call_method' should always exist
extlang_compile_file	<removed>				use 'extlang_t::compile_file' instead
extlang_compile_file_exists	<removed>				'extlang_t::compile_file' should always exist
extlang_create_object_exists	<removed>				'extlang_t::create_object' should always exist
extlang_get_attr_exists	<removed>				'extlang_t::get_attr' should always exist
extlang_run_statements_exists	<removed>				replaced by 'extlang_t::eval_statements', which should always exist
extlang_set_attr_exists	<removed>				'extlang_t::set_attr' should always exist
extlang_unload_procmod	<removed>				use 'extlang_t::unload_procmod' instead
get_extlang_fileext	<removed>				use 'extlang_t::fileext' instead
get_extlangs	<removed>				use 'for_all_extlangs' instead
get_idc_func_body	<removed>
get_script_attr	<removed>				use 'extlang_t::get_attr' instead
run_script_func	<removed>				use 'extlang_t::call_func' instead
run_statements	<removed>				use 'extlang_t::eval_statements' instead
set_idc_func_body	<removed>
set_idc_func_ex	<removed>				use 'add_idc_func'/'del_idc_func' instead
set_script_attr	<removed>				use 'extlang_t::set_attr' instead
<added>	add_idc_func				to be used instead of 'set_idc_func_ex'
<added>	compile_idc_snippet
<added>	del_idc_func				to be used instead of 'set_idc_func_ex'
<added>	eval_idc_snippet
<added>	find_extlang_by_index
<added>	find_idc_func
<added>	for_all_extlangs
<added>	get_extlang				always returns non-NULL
Compile, CompileEx	compile_idc_file	q	*
CompileLine, CompileLineEx	compile_idc_text		*		added 'resolver' argument
Run	call_idc_func	*	*		swapped 'argsnum' and 'args'; argument type: 'int' changed to 'size_t'; added 'resolver' argument
VarAssign	copy_idcv			*
VarCopy	deep_copy_idcv			*
VarDelAttr	del_idcv_attr
VarDeref	deref_idcv
VarFirstAttr	first_idcv_attr
VarFloat	idcv_float
VarFree	free_idcv
VarGetAttr	get_idcv_attr	*
VarGetClassName	get_idcv_class_name	q
VarGetSlice	get_idcv_slice	*
VarInt64	idcv_int64
VarLastAttr	last_idcv_attr
VarLong	idcv_long
VarMove	move_idcv
VarNextAttr	next_idcv_attr
VarNum	idcv_num
VarObject	idcv_object
VarPrevAttr	prev_idcv_attr
VarPrint	print_idcv			*
VarRef	create_idcv_ref
VarSetAttr	set_idcv_attr			*
VarSetSlice	set_idcv_slice			*
VarString2	idcv_string
VarSwap	swap_idcvs
calc_idc_expr	eval_idc_expr	*	*
calcexpr	eval_expr	*	*
calcexpr_long	eval_expr_long	*	*
dosysfile	exec_system_script				argument order has swapped
find_extlang_by_ext					return type changed from 'const extlang_t *' to 'extlang_object_t'
find_extlang_by_name					return type changed from 'const extlang_t *' to 'extlang_object_t'
install_extlang					removed const from 'el' argument; return type changed from 'bool' to 'ssize_t'
remove_extlang					removed const from 'el' argument
select_extlang					removed const from 'el' argument

fixup.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] input argument changed from pointer to reference

original name	new name	[1]	[2]	[3]	Notes
get_fixup_base	<removed>				use 'fd.get_base()' instead
get_fixup_extdef_ea	<removed>				use 'fd.get_base() + fd.off' instead
get_fixup_segdef_sel	<removed>				use 'fd.sel' instead
set_custom_fixup	<removed>				use 'set_fixup' instead
set_custom_fixup_ex	<removed>				use 'set_fixup' instead
set_fixup_ex	<removed>
<added>	calc_fixup_size
<added>	exists_fixup
<added>	find_custom_fixup				to be used instead of 'create_custom_fixup' (from idp.hpp)
<added>	get_fixup_handler
<added>	get_fixup_value
<added>	get_fixups
<added>	is_fixup_custom
<added>	patch_fixup_value
get_fixup		*
get_fixup_desc		q	*	*	return type changed from 'char *' to 'const char *'
register_custom_fixup					input argument changed from 'const fixup_handler_t *' to 'const custom_fixup_handler_t *'; return type changed from 'int' to 'fixup_type_t'
set_fixup				*
unregister_custom_fixup					input argument changed from 'int' to 'fixup_type_t'

fpro.h

• [1] input argument changed from 'int32' to 'qoff64_t'

• [2] return type changed from 'int32' to 'qoff64_t'

original name	new name
<added>	qaccess
<added>	qgetline
qcopyfile64	qcopyfile
qfseek64	qfseek	*
qftell64	qftell		*

frame.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] input argument 'func_t *pfn' made const

original name	new name	[1]	[2]	[3]	Notes
add_auto_stkpnt2	add_auto_stkpnt
add_stkvar2	define_stkvar
add_stkvar3	add_stkvar				added 'const insn_t &' input argument
build_stkvar_name		q	*	*	return type changed from 'char *' to 'ssize_t'
calc_stkvar_struc_offset					converted input 'ea_t' argument to 'const insn_t &'
frame_off_args				*
frame_off_lvars				*
frame_off_retaddr				*
frame_off_savregs				*
get_frame_part		*		*	argument type: 'area_t' changed to 'range_t'
get_frame_retsize				*
get_frame_size				*
get_stkvar		*			added 'const insn_t &' input argument
is_funcarg_off				*
lvar_off				*

funcs.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
a2funcoff	<removed>
apply_idasgn	<removed>
clear_func_struct	<removed>
del_func_cmt	<removed>			use 'set_func_cmt("")' instead
std_gen_func_header	<removed>			use 'outctx_base_t::gen_func_header' instead
<added>	is_same_func
<added>	lock_func_range
<added>	reanalyze_noret_flag
add_func				second 'ea_t' argument made optional
add_regarg2	add_regarg
find_func_bounds		*		removed 'ea' argument
func_item_iterator_t::decode_preceding_insn				added 'insn_t *' output argument
func_item_iterator_t::decode_prev_insn				added 'insn_t *' output argument
func_setend	set_func_end
func_setstart	set_func_start
get_func_bits				input argument 'func_t *' made const
get_func_bytes				input argument 'func_t *' made const
get_func_cmt		q	*	return type changed from 'char *' to 'ssize_t'
get_func_limits	get_func_ranges	*		output argument converted from 'area_t *' to 'rangeset_t *'; return type changed from 'bool' to 'ea_t'
get_func_name2	get_func_name
get_idasgn_desc		q	*
get_idasgn_title		q	*	return type changed from 'char *' to 'ssize_t'
set_func_cmt				input argument 'func_t *' made const

gdl.hpp

original name	Notes
create_multirange_qflow_chart	argument type: 'areavec_t' has been renamed to 'rangevec_t'

graph.hpp

• [1] input argument changed from 'TCustomControl *' to 'graph_viewer_t *'

original name	new name	[1]	Notes
set_graph_dispatcher	<removed>		use 'hook_to_notification_point(HT_GRAPH, [...])' instead
viewer_add_menu_item	<removed>		use 'viewer_attach_menu_item' instead
viewer_del_menu_item	<removed>
<added>	viewer_get_gli
clr_node_info2	clr_node_info
create_disasm_graph			argument type: 'areavec_t' has been renamed to 'rangevec_t'
create_graph_viewer			added 'title' argument; 'parent' argument made optional and reordered
del_node_info2	del_node_info
get_graph_viewer			input argument changed from 'TForm *' to 'TWidget *'
get_node_info2	get_node_info
get_viewer_graph		*
grentry			'grentry' has been converted from a global variable to an inline function
refresh_viewer		*
set_node_info2	set_node_info
viewer_center_on		*
viewer_create_groups		*
viewer_del_node_info		*
viewer_delete_groups		*
viewer_fit_window		*
viewer_get_curnode		*
viewer_get_node_info		*
viewer_set_gli		*	added 'flags' argument
viewer_set_groups_visibility		*
viewer_set_node_info		*

help.h

original name	new name
askyn	ask_yn
askyn_v	vask_yn

ida.hpp

original name	new name
ansi2idb	<removed>
dto_copy_from_inf	<removed>
dto_copy_to_inf	<removed>
dto_init	<removed>
idb2scr	<removed>
scr2idb	<removed>
showAllComments	show_all_comments
showComments	show_comments
showRepeatable class="table table-sm"s	show_repeatable class="table table-sm"s
toEA	to_ea

idd.hpp

• [1] output argument moved to beginning of argument list

original name	[1]	Notes
dbg_appcall	*	swapped 'argnum' and 'argv'; argument type: 'int' changed to 'size_t'

idp.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
get_reg_info2	get_reg_info
get_reg_name		q	*
invoke_callbacks				moved from loader.hpp
hook_to_notification_point				moved from loader.hpp
unhook_from_notification_point				moved from loader.hpp
set_processor_type				return type changed from 'char' to 'bool'; argument type: 'int' changed to 'setproc_level_t'
parse_reg_name		*
cfg_get_cc_header_path				moved to config.hpp
cfg_get_cc_parm				moved to config.hpp
cfg_get_cc_predefined_macros				moved to config.hpp
cfgopt_t__apply				moved to config.hpp
parse_config_value				moved to config.hpp
read_config				moved to config.hpp
read_config_file				moved to config.hpp
read_config_string				moved to config.hpp
InstrIsSet	has_insn_feature
str2regf	<removed>
create_custom_fixup	<removed>
gen_spcdef	<removed>			use 'outctx_t::out_specea' instead
gen_abssym	<removed>			use 'outctx_t::out_specea' instead
gen_comvar	<removed>			use 'outctx_t::out_specea' instead
gen_extern	<removed>			use 'outctx_t::out_specea' instead
intel_data	<removed>			use 'outctx_t::out_data' instead
is_basic_block_end				added 'const insn_t &' input argument
is_call_insn				converted input 'ea_t' argument to 'const insn_t &'
is_indirect_jump_insn				converted input 'ea_t' argument to 'const insn_t &'
is_ret_insn				converted input 'ea_t' argument to 'const insn_t &'

ieee.h

• [1] output argument moved to beginning of argument list

original name	[1]
eetol	*
eetol64	*
eetol64u	*
realtoasc	*

ints.hpp (REMOVED)

original name	new name	Notes
get_predef_cmt	<removed>
get_vxd_func_name	<removed>
get_predef_insn_cmt		moved to bytes.hpp

kernwin.hpp

NOTE: Please note that in IDA version 6.7 we introduced the Actions API, which deprecated many functions related to augmenting functionality in IDA.

Those previously deprecated functions have been removed. For more details about the Actions API, please visit our old blog post from 2014:

http://www.hexblog.com/?p=886

NOTE: 'TForm', 'TCustomControl', and 'TWinControl' have been replaced by 'TWidget'

NOTE: global variable 'dirty_infos' has been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] input argument changed from pointer to reference

• [4] return type changed from 'TForm *' to 'TWidget *'

• [5] input argument changed from 'TCustomControl *' to 'TWidget *'

original name	new name	[1]	[2]	[3]	[4]	[5]	Notes
askfile_c	<removed>
askfile_cv	<removed>
askstr	<removed>
close_form	<removed>						use 'form_actions_t::close' instead
close_tform	<removed>						use 'close_widget' instead
create_tform	<removed>						use 'find_widget' or 'create_empty_widget' instead
enable_menu_item	<removed>						superseded by the Actions API (see blog post above)
entab	<removed>
find_tform	<removed>						use 'find_widget' instead
get_current_tform	<removed>						use 'get_current_widget' instead
get_highlighted_identifier	<removed>						use 'get_current_viewer' and 'get_highlight' instead
get_tform_idaview	<removed>						use the 'TWidget *' directly instead of obtaining the IDAView
get_tform_title	<removed>						use 'get_widget_title' instead
get_tform_type	<removed>						use 'get_widget_type' instead
get_viewer_name	<removed>						use 'get_widget_title' instead
init_kernel	<removed>
is_chooser_tform	<removed>						use 'is_chooser_widget' instead
print_disp	<removed>						use 'append_disp' instead
set_menu_item_icon	<removed>						superseded by the Actions API (see blog post above)
switchto_tform	<removed>						use 'activate_widget' instead
term_kernel	<removed>
umsg	<removed>
vaskstr	<removed>
vumsg	<removed>
<added>	activate_widget
<added>	append_disp
<added>	close_widget
<added>	create_empty_widget
<added>	find_widget
<added>	get_current_widget
<added>	get_highlight
<added>	get_widget_title
<added>	get_widget_type
<added>	is_buttoncb_t_type
<added>	is_chooser_widget
<added>	is_formchgcb_t_type
<added>	qcleanline
<added>	set_highlight
<added>	unpack_ds_to_buf
AskUsingForm_c	ask_form
AskUsingForm_cv	vask_form
OpenForm_c	open_form				*
OpenForm_cv	vopen_form				*
askaddr	ask_addr
askbuttons_c	ask_buttons
askbuttons_cv	vask_buttons
askfile2_c	ask_file						'filters' argument merged into 'format'
askfile2_cv	vask_file						'filters' argument merged into 'format'
askident	ask_ident		*				return type changed from 'char *' to 'bool'
asklong	ask_long
askqstr	ask_str						added 'hist' argument
askseg	ask_seg
asktext	ask_text	q	*				return type changed from 'char *' to 'bool'
askyn_c	ask_yn
askyn_cv	vask_yn
atob32		*
atob64		*
atoea		*
atos		*
attach_action_to_popup							input argument changed from 'TForm *' to 'TWidget *'
attach_dynamic_action_to_popup			*				input argument changed from 'TForm *' to 'TWidget *'
b2a32		*
b2a64		*
back_char							moved to pro.h
choose, choose2, choose3	choose						choosers should use the new 'chooser_base_t' interface
choose_srcp							return type changed from 'segreg_area_t *' to 'sreg_range_t *'
choose_til			*
clearBreak	clr_cancelled
clear_refresh_request							to be used instead of 'dirty_infos'
create_code_viewer							return type changed from 'TCustomControl *' to 'TWidget *'; 'parent' argument made optional and reordered
create_custom_viewer							return type changed from 'TCustomControl *' to 'TWidget *'; 'parent' argument made optional and reordered
custom_viewer_jump						*
destroy_custom_viewer						*
detach_action_from_popup							input argument changed from 'TForm *' to 'TWidget *'
ea2str		*
ea_viewer_history_push_and_jump						*
gen_disasm_text		*
get_8bit				*
get_action_label		*
get_action_shortcut		*
get_action_tooltip		*
get_chooser_data							argument type: 'uint32' changed to 'int'
get_current_viewer							return type changed from 'TCustomControl *' to 'TWidget *'
get_custom_viewer_curline						*
get_custom_viewer_place						*
get_ea_viewer_history_info						*
get_kernel_version							return type changed from 'bool' to 'ssize_t'
get_output_curline			*
get_output_selected_text			*
get_view_renderer_type						*
get_viewer_place_type						*
get_viewer_user_data						*
is_idaview						*
is_refresh_requested							to be used instead of 'dirty_infos'
jumpto						*
linearray_t::down							return type changed from 'char *' to 'const qstring *'
linearray_t::up							return type changed from 'char *' to 'const qstring *'
open_bpts_window						*
open_bpts_window					*
open_calls_window					*
open_disasm_window					*		input argument changed from 'const areavec_t *' to 'const rangevec_t *'
open_enums_window					*
open_exports_window					*
open_frame_window					*
open_funcs_window					*
open_hexdump_window					*
open_imports_window					*
open_loctypes_window					*
open_modules_window					*
open_names_window					*
open_navband_window					*
open_notepad_window					*
open_problems_window					*
open_segments_window					*
open_segregs_window					*
open_selectors_window					*
open_signatures_window					*
open_stack_window					*
open_strings_window					*
open_structs_window					*
open_tform	display_widget						input argument changed from 'TForm *' to 'TWidget *'
open_threads_window					*
open_tils_window					*
open_trace_window					*
open_xrefs_window					*
qstr2user							moved to pro.h
r50_to_asc		*
read_range_selection	read_selection					*	WARNING: 'read_selection' has changed meaning
read_selection	read_range_selection						WARNING: 'read_selection' has changed meaning; added 'TWidget *' argument
refresh_custom_viewer						*
repaint_custom_viewer						*
request_refresh							added 'cnd' argument
setBreak	set_cancelled
set_code_viewer_handler						*
set_code_viewer_is_source						*
set_code_viewer_line_handlers						*
set_code_viewer_lines_alignment						*
set_code_viewer_lines_icon_margin						*
set_code_viewer_lines_radix						*
set_code_viewer_user_data						*
set_custom_viewer_handler						*
set_custom_viewer_handlers						*
set_custom_viewer_qt_aware						*
set_custom_viewer_range						*
set_view_renderer_type						*
show_hex_file							argument type: 'int32' changed to 'int64'
skipSpaces	skip_spaces
stoa		q	*
str2ea		*
str2ea_ex		*
str2user							moved to pro.h
ui_load_new_file							added 'temp_file' and 'ploaders'; input argument 'filename' changed from 'const char *' to 'qstring *'
user2qstr							moved to pro.h
user2str							moved to pro.h
vaskqstr	vask_str						added 'hist' argument
vasktext	vask_text	q	*				return type changed from 'char *' to 'bool'
vshow_hex_file							argument type: 'int32' changed to 'int64'
wasBreak	user_cancelled

lex.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]
lex_define	lex_define_macro
lex_undef	lex_undefine_macro
lxascii	lex_print_token	q	*
lxget	lex_get_token
lxgetserr	lex_get_file_line
lxgetsini	lex_init_file
lxgetstrm	lex_term_file
lxini	lex_init_string

lines.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] return type changed from 'void' to 'bool'

original name	new name	[1]	[2]	[3]	Notes
MakeBorder	<removed>				use 'outctx_base_t::gen_border_line(false)' instead
MakeLine	<removed>				use 'outctx_base_t::flush_buf' instead
MakeNull	<removed>				use 'outctx_base_t::gen_empty_line' instead
MakeSolidBorder	<removed>				use 'outctx_base_t::gen_border_line(true)' instead
add_long_cmt_v	<removed>				use 'vadd_extra_line' instead
close_comment	<removed>				use 'outctx_base_t::close_comment' instead
describex	<removed>				use 'vadd_extra_line' instead
finish_makeline	<removed>				use 'outctx_base_t::term_outctx' instead
gen_cmt_line	<removed>				use 'outctx_base_t::gen_cmt_line' instead
gen_cmt_line_v	<removed>				use 'outctx_base_t::gen_cmt_line_v' instead
gen_collapsed_line	<removed>				use 'outctx_base_t::gen_collapsed_line' instead
gen_colored_cmt_line_v	<removed>				use 'outctx_base_t::gen_colored_cmt_line_v' instead
generate_big_comment	<removed>				use 'outctx_base_t::gen_block_cmt' instead
generate_many_lines	<removed>				use 'outctx_base_t::gen_many_lines(-1, NULL, [...])' instead
init_lines	<removed>
init_lines_array	<removed>				use 'outctx_base_t::init_lines_array' instead
printf_line	<removed>				use 'outctx_base_t::gen_printf' instead
printf_line_v	<removed>				use 'outctx_base_t::gen_vprintf' instead
save_line_in_array	<removed>				use 'outctx_base_t::save_buf' instead
save_lines	<removed>
save_sourcefiles	<removed>
setup_makeline	<removed>				use 'outctx_base_t::setup_outctx' instead
tag_addchr	<removed>
tag_addstr	<removed>
tag_off	<removed>
tag_on	<removed>
<added>	get_last_pfxlen
<added>	vadd_extra_line
add_long_cmt	add_extra_cmt
add_pgm_cmt				*
describe	add_extra_line			*
generate_disasm_line		q	*
generate_disassembly		q	*		output argument is 'qstrvec_t'
get_extra_cmt		q	*
get_sourcefile					argument type: 'area_t *' changed to 'range_t *'
tag_addr		q	*		return type changed from 'char *' to 'void'; added 'ins' argument
tag_remove		q	*		added 'init_level' argument

llong.hpp

• [1] output argument moved to beginning of argument list

• [2] output argument changed from reference to pointer

original name	new name	[1]	[2]
print	<removed>
llong_div		*	*
llong_udiv		*	*

loader.hpp

NOTE: global variables 'database_flags', 'command_line_file', 'idb_path', and 'id0_path' have been removed.

NOTE: class 'loader_jump' has been renamed to 'loader_failure_t'

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] input argument changed from 'int32' to 'qoff64_t'

• [3] return type changed from 'int32' to 'qoff64_t'

original name	new name	[1]	[2]	[3]	Notes
enum_plugins	<removed>
init_loader_options	<removed>
<added>	find_plugin
<added>	process_archive
accept_file		q	*		added 'processor' output argument (optional)
base2file			*
build_loaders_list					added 'filename' argument (name of the input file for archives)
clr_database_flag					to be used instead of 'database_flags'
extract_module_from_archive		*
file2base			*
get_fileregion_ea			*
get_fileregion_offset				*
get_path					to be used instead of 'idb_path'
hook_to_notification_point					moved to idp.hpp
invoke_callbacks					moved to idp.hpp
is_database_flag					to be used instead of 'database_flags'
load_and_run_plugin					argument type: 'int' changed to 'size_t'
load_binary_file			*		argument type: 'uint32' changed to 'uint64'
load_dll_or_say	load_core_module	*			added 'entry' argument (name of plugin 'entrypoint' symbol)
mem2base			*
run_plugin					argument type: 'int' changed to 'size_t'
save_database_ex	save_database
set_database_flag					to be used instead of 'database_flags'
set_path					to be used instead of 'idb_path'
unhook_from_notification_point					moved to idp.hpp

moves.hpp

NOTE: 'curloc_t' and 'location_t' have been replaced by 'lochist_t'.

original name	new name
curloc_get	<removed>
curloc_get_entry	<removed>
curloc_hide_if_necessary	<removed>
curloc_jump	<removed>
curloc_jump_push	<removed>
curloc_linkTo	<removed>
curloc_mark	<removed>
curloc_markdesc	<removed>
curloc_markedpos	<removed>
curloc_pop	<removed>
curloc_unhide_if_necessary	<removed>
location_get	<removed>
location_get_entry	<removed>
location_jump	<removed>
location_linkTo	<removed>
location_mark	<removed>
location_pop	<removed>
location_push_and_jump	<removed>
<added>	graph_location_info_t::deserialize
<added>	graph_location_info_t::serialize
<added>	renderer_info_pos_t::deserialize
<added>	renderer_info_pos_t::serialize

nalt.hpp

NOTE: global variable 'import_node' has been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
_del_item_color	<removed>
_del_strid	<removed>
_set_item_color	<removed>
_set_item_color	<removed>
_set_strid	<removed>
del__segtrans	<removed>
del_enum_id0	<removed>
del_enum_id1	<removed>
del_fop1	<removed>
del_fop2	<removed>
del_fop3	<removed>
del_fop4	<removed>
del_fop5	<removed>
del_fop6	<removed>
del_graph_groups0	<removed>
del_jumptable class="table table-sm"_info	<removed>
del_linnum0	<removed>
del_manual_insn0	<removed>
del_nalt_cmt	<removed>
del_nalt_rptcmt	<removed>
del_stroff0	<removed>
del_stroff1	<removed>
del_wide_value	<removed>
get__segtrans	<removed>
get_auto_plugins	<removed>
get_custom_refinfos	<removed>			use 'get_refinfo_descs' instead
get_enum_id0	<removed>
get_enum_id1	<removed>
get_fop1	<removed>
get_fop2	<removed>
get_fop3	<removed>
get_fop4	<removed>
get_fop5	<removed>
get_fop6	<removed>
get_graph_groups0	<removed>
get_jumptable class="table table-sm"_info	<removed>
get_linnum0	<removed>
get_manual_insn0	<removed>
get_nalt_cmt	<removed>
get_nalt_rptcmt	<removed>
get_stroff0	<removed>
get_stroff1	<removed>
get_wide_value	<removed>
is_unicode	<removed>			use 'get_strtype_bpu' instead
set__segtrans	<removed>
set_auto_plugins	<removed>
set_enum_id0	<removed>
set_enum_id1	<removed>
set_fop1	<removed>
set_fop2	<removed>
set_fop3	<removed>
set_fop4	<removed>
set_fop5	<removed>
set_fop6	<removed>
set_graph_groups0	<removed>
set_jumptable class="table table-sm"_info	<removed>
set_linnum0	<removed>
set_manual_insn0	<removed>
set_nalt_cmt	<removed>
set_nalt_rptcmt	<removed>
set_stroff0	<removed>
set_stroff1	<removed>
set_wide_value	<removed>
<added>	clr_notproc
<added>	delete_imports			to be used instead of 'auto_display'
<added>	ea2node
<added>	find_custom_refinfo
<added>	get_abi_name
<added>	get_archive_path
<added>	get_custom_refinfo
<added>	get_custom_refinfo_handler
<added>	get_encoding_bpu
<added>	get_gotea
<added>	get_refinfo_descs
<added>	get_strtype_bpu
<added>	getnode
<added>	is_notproc
<added>	is_reftype_target_optional
<added>	node2ea
<added>	set_archive_path
<added>	set_gotea
<added>	set_notproc
change_encoding_name	rename_encoding
del_switch_info_ex	del_switch_info
del_tinfo2	del_tinfo
del_tinfo2(,n)	del_op_tinfo
get_array_parameters		*		removed 'bufsize' argument
get_asm_inc_file			*
get_custom_data_type_ids		*		removed 'bufsize' argument
get_default_encoding_idx				argument type: 'int32' changed to 'int'
get_encodings_count	get_encoding_qty
get_import_module_name		q	*
get_op_tinfo2	get_op_tinfo	*
get_refinfo		*
get_str_type_code				return type changed from 'char' to 'uchar'; argument type: 'uval_t' changed to 'int32'
get_strid				return type changed from 'ea_t' to 'tid_t'
get_switch_info_ex	get_switch_info	*		removed 'bufsize' argument
get_tinfo2	get_tinfo	*
get_xrefpos		*		removed 'bufsize' argument
read_struc_path		*		argument type: 'netnode' changed to 'ea_t'
set_default_encoding_idx				argument type: 'int32' changed to 'int'
set_op_tinfo2	set_op_tinfo
set_switch_info_ex	set_switch_info			input argument changed from 'const switch_info_ex_t *' to 'const switch_info_t &'
set_tinfo2	set_tinfo
write_struc_path				argument type: 'netnode' changed to 'ea_t'

name.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] output argument changed from reference to pointer

original name	new name	[1]	[2]	[3]	Notes
gen_name_decl	<removed>				use 'outctx_base_t::gen_name_decl' instead
<added>	is_strlit_cp
<added>	is_valid_cp
<added>	set_cp_validity
append_struct_fields2	append_struct_fields	*
demangle_name2	demangle_name
do_name_anyway	force_name				removed 'maxlen' argument
extract_name2	extract_name
get_debug_name2	get_debug_name
get_debug_names		*		*
get_ea_name					removed const from 'gtni' argument
get_name_expr		q	*
get_name_value		*
get_nice_colored_name		q	*
get_struct_operand		*
get_true_name	get_name
is_ident_char	is_ident_cp
is_visible_char	is_visible_cp
isident	is_ident
validate_name3	validate_name				added 'type' and 'flags' arguments

netnode.hpp

original name	new name	Notes
<added>	netnode::altdel_ea	to be used instead of 'netnode::altdel' for addresses (ea_t)
<added>	netnode::altset_ea	to be used instead of 'netnode::altset' for addresses (ea_t)
<added>	netnode::altval_ea	to be used instead of 'netnode::altval' for addresses (ea_t)
<added>	netnode::blobsize_ea	to be used instead of 'netnode::blobsize' for addresses (ea_t)
<added>	netnode::chardel_ea	to be used instead of 'netnode::chardel' for addresses (ea_t)
<added>	netnode::charset_ea	to be used instead of 'netnode::charset' for addresses (ea_t)
<added>	netnode::charval_ea	to be used instead of 'netnode::charval' for addresses (ea_t)
<added>	netnode::delblob_ea	to be used instead of 'netnode::delblob' for addresses (ea_t)
<added>	netnode::eadel
<added>	netnode::eadel_idx8
<added>	netnode::eaget
<added>	netnode::eaget_idx8
<added>	netnode::easet
<added>	netnode::easet_idx8
<added>	netnode::getblob_ea	to be used instead of 'netnode::getblob' for addresses (ea_t)
<added>	netnode::setblob_ea	to be used instead of 'netnode::setblob' for addresses (ea_t)
<added>	netnode::supdel_ea	to be used instead of 'netnode::supdel' for addresses (ea_t)
<added>	netnode::supset_ea	to be used instead of 'netnode::supset' for addresses (ea_t)
<added>	netnode::supstr_ea	to be used instead of 'netnode::supstr' for addresses (ea_t)
<added>	netnode::supval_ea	to be used instead of 'netnode::supval' for addresses (ea_t)
netnode::alt1st	netnode::altfirst
netnode::alt1st_idx8	netnode::altfirst_idx8
netnode::altnxt	netnode::altnext
netnode::char1st	netnode::charfirst
netnode::char1st_idx8	netnode::charfirst_idx8
netnode::charnxt	netnode::charnext
netnode::getblob		added variants that work with 'qvector<T> *' and 'qstring *'
netnode::hash1st	netnode::hashfirst	added variant that works with 'qstring *'
netnode::hashlast		added variant that works with 'qstring *'
netnode::hashnxt	netnode::hashnext	added variant that works with 'qstring *'
netnode::hashprev		added variant that works with 'qstring *'
netnode::hashstr		added variant that works with 'qstring *'
netnode::sup1st	netnode::supfirst
netnode::sup1st_idx8	netnode::supfirst_idx8
netnode::supnxt	netnode::supnext
netnode::supstr		added variant that works with 'qstring *'
netnode::valstr		added variant that works with 'qstring *'

offset.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] input argument 'refinfo_t &' made const

original name	new name	[1]	[2]	[3]	Notes
calc_reference_basevalue	<removed>				use 'calc_reference_data' instead
calc_reference_target	<removed>				use 'calc_reference_data' instead
set_offset	<removed>				use 'calc_offset_base' and 'op_plain_offset' instead
<added>	add_refinfo_dref
<added>	calc_basevalue
<added>	calc_offset_base
<added>	calc_reference_data
<added>	op_plain_offset
get_offset_expr		q	*	*
get_offset_expression		q	*

problems.h (RENAMED from queue.hpp)

NOTE: 'qtype_t' has been changed to 'problist_id_t'.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
QueueGet	<removed>
get_long_queue_name	<removed>			Use 'get_problem_name(type, true);' instead
get_short_queue_name	<removed>			Use 'get_problem_name(type, false);' instead
mark_ida_decision	<removed>
unmark_ida_decision	<removed>
<added>	get_problem_name
QueueDel	forget_problem			return type changed from 'void' to 'bool'
QueueGetMessage	get_problem_desc	q	*
QueueGetType	get_problem
QueueIsPresent	is_problem_present
QueueSet	remember_problem

prodir.h

original name	new name
qfindclose64	qfindclose
qfindfirst64	qfindfirst
qfindnext64	qfindnext

pro.h

NOTE: global variables 'codepage' and 'oemcodepage' have been removed.

• [1] output argument moved to beginning of argument list

original name	new name	[1]	Notes
c2ustr	<removed>		use 'utf8_utf16' instead
char2oem	<removed>
convert_codepage	<removed>
create_hit_counter	<removed>
expand_argv	<removed>
get_codepages	<removed>
hit_counter_timer	<removed>
oem2char	<removed>
reg_hit_counter	<removed>
u2cstr	<removed>		use 'utf16_utf8' instead
win_utf2idb	<removed>
<added>	acp_utf8
<added>	change_codepage
<added>	idb_utf8
<added>	is_valid_utf8
<added>	put_utf8_char
<added>	qchdir
<added>	qustrlen
<added>	scr_utf8
<added>	skip_utf8
<added>	utf8_scr
<added>	utf8_wchar16
<added>	utf8_wchar32
back_char			moved from kernwin.hpp
convert_encoding		*	return type changed from 'int' to 'ssize_t'
get_nsec_stamp			output argument changed from 'uint64 *' to the 'uint64' return value
parse_command_line3	parse_command_line	*
qchsize64	qchsize
qfileexist64	qfileexist
qfilesize64	qfilesize
qfstat64	qfstat
qseek64	qseek
qstat64	qstat
qstr2user			moved from kernwin.hpp; added 'nsyms' argument
qtell64	qtell
qwait		*
qwait_for_handles		*
qwait_timed		*
search_path		*
str2user			moved from kernwin.hpp
unicode_utf8	utf16_utf8
user2qstr			moved from kernwin.hpp
user2str			moved from kernwin.hpp
utf8_unicode	utf8_utf16

pronet.h

original name	new name
<added>	qhost2addr

range.h (RENAMED from area.hpp)

NOTE: some classes have been renamed: - 'area_t' has been renamed to 'range_t' - 'areavec_t' has been renamed to 'rangevec_t' - 'areaset_t' has been renamed to 'rangeset_t'

NOTE: the classes 'rangecb_t', 'ranges_cache_t', and 'lock_range' have been removed

registry.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	[1]	[2]	Notes
reg_read_strlist	*
reg_read_string	q	*	removed variant with default value

search.hpp

• [1] output argument moved to beginning of argument list

original name	new name	[1]	Notes
user2bin		*
find_imm			argument type: 'sval_t' changed to 'uval_t'
find_void	find_suspop

segment.hpp

NOTE: global variables 'hidden_ranges', 'funcs', and 'segs' have been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] added 'flags' argument

original name		[1]	[2]	[3]	Notes
del_segment_cmt	<removed>				use 'set_range_cmt("")' instead
vset_segm_name	<removed>
<added>	get_segm_num				to be used instead of 'segs.get_range_num()'
<added>	lock_segm				to be used instead of 'rangecb_t_unlock_range(&segs)'
add_segm				*
ask_selector	sel2para
correct_address					added 'skip_check' argument
del_segment_translations					return type changed from 'bool' to 'void'
get_segm_class		q	*
get_segm_name	get_visible_segm_name				removed variant with 'ea_t' argument
get_segment_cmt		q	*		return type changed from 'char *' to 'ssize_t'; added 'repeatable class="table table-sm"' argument
get_segment_translations					return type changed from 'ea_t *' to 'ssize_t'; output argument converted 'eavec_t'
get_true_segm_name	get_segm_name	q	*	*
getn_selector		*
set_segm_class				*
set_segm_name				*	arguments converted from printf-style to simple 'const char *'
set_segment_cmt					input argument 'segment_t *' made const
set_segment_translations					input argument converted to 'const eavec_t &'
std_gen_segm_footer	std_out_segm_footer				converted to outctx_t; input argument changed to segment_t*

segregs.hpp (RENAMED from srarea.hpp)

NOTE: type 'segreg_area_t' has been renamed to 'sreg_range_t'

original name	new name	Notes
copy_srareas	copy_sreg_ranges
del_srarea	del_sreg_range	WARNING: argument order has swapped
get_prev_srarea	get_prev_sreg_range	argument type: 'segreg_area_t' changed to 'sreg_range_t'
get_segreg	get_sreg
get_srarea2	get_sreg_range	argument type: 'segreg_area_t' changed to 'sreg_range_t'
get_srarea_num	get_sreg_range_num	WARNING: argument order has swapped
get_srareas_qty2	get_sreg_ranges_qty
getn_srarea2	getn_sreg_range	argument type: 'segreg_area_t' changed to 'sreg_range_t'
set_default_segreg_value	set_default_sreg_value
split_srarea	split_sreg_range

sistack.h (REMOVED)

original name	new name
sistack_t_size	<removed>
sistack_t_flush	<removed>

strlist.hpp

• [1] output argument moved to beginning of argument list

original name	new name	[1]	Notes
refresh_strlist	<removed>
set_strlist_options	<removed>
<added>	build_strlist
<added>	clear_strlist
<added>	get_strlist_options
get_strlist_item		*	argument type: 'int' changed to 'size_t'

struct.hpp

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]
get_member_by_fullname		*
get_member_cmt		q	*
get_member_name2	get_member_name
get_member_tinfo2	get_member_tinfo	*
get_or_guess_member_tinfo2	get_or_guess_member_tinfo	*
get_struc_cmt		q	*
retrieve_member_info		*
save_struc2	save_struc
set_member_tinfo2	set_member_tinfo

tryblks.hpp (NEW file)

original name	new name
<added>	add_tryblk
<added>	del_tryblks
<added>	get_tryblks

typeinf.hpp

NOTE: global variable 'idati' has been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

original name	new name	[1]	[2]	Notes
based_ptr_name_and_size	<removed>
callregs_init_regs	<removed>
choose_local_type	<removed>
create_numbered_type_reference	<removed>
equal_types	<removed>
get_de	<removed>
get_default_enum_size	<removed>
get_func_cvtarg_map	<removed>
get_named_type_size	<removed>
get_referred_ordinal	<removed>
get_stkarg_offset	<removed>
get_unk_type_bit	<removed>
is_restype_array	<removed>
is_restype_bitfld	<removed>
is_restype_complex	<removed>
is_restype_const	<removed>
is_restype_floating	<removed>
is_restype_func	<removed>
is_restype_ptr	<removed>
is_restype_union	<removed>
max_ptr_size	<removed>
rename_named_type	<removed>
set_named_type	<removed>			use 'tinfo_t::set_named_type' instead
set_named_type64	<removed>			use 'tinfo_t::set_named_type' instead
<added>	append_abi_opts
<added>	gcc_layout
<added>	get_arg_addrs
<added>	get_idati			to be used instead of 'idati'
<added>	remove_abi_opts
<added>	resolve_typedef
<added>	set_compiler_string
add_til2	add_til
append_tinfo_covered				argument type: 'areaset_t' has been renamed to 'rangeset_t'
apply_callee_tinfo				return type changed from 'void' to 'bool'
apply_cdecl2	apply_cdecl
apply_tinfo2	apply_tinfo
apply_tinfo_to_stkarg				added 'insn' argument
build_anon_type_name			*
calc_c_cpp_name4	calc_c_cpp_name
calc_tinfo_gaps				argument type: 'areaset_t' has been renamed to 'rangeset_t'
choose_local_tinfo				added 'def_ord' argument
choose_named_type2	choose_named_type	*		the original 'choose_named_type' has been removed
create_numbered_type_name		q	*	return type changed from 'size_t' to 'ssize_t'
decorate_name3	decorate_name			added 'type' argument
del_tinfo_attr				added 'make_copy' argument
deref_ptr2	deref_ptr	*
extract_argloc		*
find_tinfo_udt_member		*
format_cdata2	format_cdata
gen_decorate_name3	gen_decorate_name			the original 'gen_decorate_name' has been removed; added 'type' argument
get_c_header_path			*
get_c_macros			*
get_enum_member_expr2	get_enum_member_expr		*
get_idainfo_by_type3	get_idainfo_by_type	*
get_int_type_bit	get_scalar_bt
get_tinfo_pdata		*
get_tinfo_size		*
guess_tinfo2	guess_tinfo	*
load_til2	load_til		*	the original 'load_til' has been removed; added 'tildir' argument
load_til_header			*
lower_type2	lower_type
optimize_argloc				argument type: 'areaset_t' has been renamed to 'rangeset_t'
parse_decl2	parse_decl	q
print_type3	print_type
remove_tinfo_pointer		*
save_tinfo		*
set_abi_name				added 'user_level' argument
set_compiler2	set_compiler
set_numbered_type				return type changed from 'bool' to 'tinfo_code_t'
verify_argloc				argument type: 'areaset_t' has been renamed to 'rangeset_t'

ua.hpp

WARNING: The global variables 'cmd' and 'uFlag' are gone.

All functions previously operating on 'cmd' now accept an 'insn_t' pointer or reference. Use get_flags() (or, if you really need it, get_full_flags()) to read the current flags.

NOTE: The maximum number of instruction operands (UA_MAXOP) has increased to 8.

NOTE: class 'outctx_base_t' has been added to replace functions that generate the disassembly text

NOTE: global variable 'lookback' has been removed.

• [1] output argument moved to beginning of argument list

  • q: argument is a qstring

• [2] output buffer converted to qstring

• [3] added input/output 'insn_t &insn' argument

• [4] added input 'const insn_t &insn' argument

• [5] added output 'insn_t *out' argument

original name	new name	[1]	[2]	[3]	[4]	[5]	Notes
OutBadInstruction	<removed>
OutChar	<removed>						use 'outctx_base_t::out_char' instead
OutImmChar	<removed>						use 'outctx_base_t::out_immchar_cmts' instead
OutLine	<removed>						use 'outctx_base_t::out_line' instead
OutLong	<removed>						use 'outctx_base_t::out_btoa' instead
OutMnem	<removed>						use 'outctx_base_t::out_mnem' instead
OutValue	<removed>						use 'outctx_base_t::out_value' instead
get_output_ptr	<removed>
init_output_buffer	<removed>
out_addr_tag	<removed>						use 'outctx_base_t::out_addr_tag' instead
out_colored_register_line	<removed>						use 'outctx_base_t::out_colored_register_line' instead
out_insert	<removed>						use 'outctx_base_t::outbuf' directly instead
out_line	<removed>						use 'outctx_base_t::out_line' instead
out_long	<removed>						use 'outctx_base_t::out_long' instead
out_name_expr	<removed>						use 'outctx_base_t::out_name_expr' instead
out_one_operand	<removed>						use 'outctx_base_t::out_one_operand' instead
out_snprintf	<removed>						use 'outctx_base_t::out_printf' instead
out_symbol	<removed>						use 'outctx_base_t::out_symbol' instead
out_tagoff	<removed>						use 'outctx_base_t::out_tagoff' instead
out_tagon	<removed>						use 'outctx_base_t::out_tagon' instead
set_output_ptr	<removed>
term_output_buffer	<removed>
ua_dodata2	<removed>						use 'insn_t::create_op_data' instead
ua_next_byte	<removed>						use 'insn_t::get_next_byte' instead
ua_next_long	<removed>						use 'insn_t::get_next_dword' instead
ua_next_qword	<removed>						use 'insn_t::get_next_qword' instead
ua_next_word	<removed>						use 'insn_t::get_next_word' instead
<added>	can_decode
<added>	create_outctx
<added>	get_lookback						to be used instead of 'lookback'
<added>	map_ea
codeSeg	map_code_ea				*		input arguments changed to either 'const op_t &op' or 'ea_t addr, int opnum'
construct_macro				*
create_insn						*
dataSeg, dataSeg_op	map_data_ea				*		input arguments changed to either 'const op_t &op' or 'ea_t addr, int opnum'
dataSeg_opreg	calc_dataseg				*
decode_insn						*
decode_preceding_insn						*
decode_prev_insn						*
get_dtyp_by_size	get_dtype_by_size						return type changed from 'char' to 'op_dtype_t'
get_dtyp_flag	get_dtype_flag						argument type: 'char' changed to 'op_dtype_t'
get_dtyp_size	get_dtype_size						argument type: 'char' changed to 'op_dtype_t'
get_operand_immvals	get_immvals	*					added 'flags_t' and 'cache' arguments
get_spoiled_reg					*
guess_table class="table table-sm"_address					*
guess_table class="table table-sm"_size					*
out_real	print_fpval	*
showAsChar	print_charlit	*
ua_add_cref	<removed>						use 'insn_t::add_cref' instead
ua_add_dref	<removed>						use 'insn_t::add_dref' instead
ua_add_off_drefs2	<removed>						use 'insn_t::add_off_drefs' instead
ua_mnem	print_insn_mnem	q	*
ua_outop2	print_operand	q	*				added 'printop_t' argument
ua_stkvar2	<removed>						use 'insn_t::create_stkvar' instead

xref.hpp

• [1] output argument moved to beginning of argument list

• [2] input argument changed from pointer to reference

original name	[1]	[2]
calc_switch_cases	*	*
create_switch_table class="table table-sm"		*
create_switch_xrefs		*