IDA Pro > IDA Pro教程 > 技术问题 > IDA Pro反编译器SDK

IDA Pro反编译器SDK

发布时间:2022-10-11 17: 28: 46

Below is the full source code of a sample plugin. It performs a quite useful transformation of the pseudocode: replaces zeroes in pointer contexts with NULLs. A NULL immediately conveys the idea that the current expression is pointer-related. This is especially useful for unknown function arguments.

 

The plugin is fully automatic. It hooks to the decompiler events and waits for the pseudocode to be ready. At that moment it takes control and modifies the ctree.

 

The conversion is performed by the convert_zeroes() function. It visits all expressions of the ctree and checks for pointer contexts. If a expression has a pointer type, then the make_null_if_zero() function is called for it. This function checks if the expression is a zero constant and converts it if necessary.

 

The plugin can be turned on or off by its menu item in the Plugins submenu.

 

The code is short and straightforward. Use it as a template for your plugins.

 

 

/*
*      Hex-Rays Decompiler project
*      Copyright (c) 2007-2019 by Hex-Rays, support@hex-rays.com
*      ALL RIGHTS RESERVED.
*
*      Sample plugin for Hex-Rays Decompiler.
*      It automatically replaces zeroes in pointer contexts with NULLs.
*      For example, expression like
*
*              funcptr = 0;
*
*      will be displayed as
*
*              funcptr = NULL;
*
*      Due to highly dynamic nature of the decompier output, we must
*      use the decompiler events to accomplish the task. The plugin will
*      wait for the ctree structure to be ready in the memory and will
*      replace zeroes in pointer contexts with NULLs.
*
*/

#include

// Hex-Rays API pointer
hexdsp_t *hexdsp = NULL;

static bool inited = false;

static const char nodename[] = “$ hexrays NULLs”;
static const char null_type[] = “MACRO_NULL”;
//————————————————————————–
// Is the plugin enabled?
// The user can disable it. The plugin will save the on/off switch in the
// current database.
static bool is_enabled(void)
{
 netnode n(nodename); // use a netnode to save the state
 return n.altval(0) == 0; // if the long value is positive, then disabled
}

//————————————————————————–
// If the expression is zero, convert it to NULL
static void make_null_if_zero(cexpr_t *e)
{
 if ( e->is_zero_const() && !e->type.is_ptr() )
 { // this is plain zero, convert it
   number_format_t &nf = e->n->nf;
   nf.flags = enum_flag();
   nf.serial = 0;
   nf.type_name = null_type;
   e->type = tinfo_t::get_stock(STI_PVOID);
 }
}

//————————————————————————–
// Convert zeroes of the ctree to NULLs
static void convert_zeroes(cfunc_t *cfunc)
{
 // To represent NULLs, we will use the MACRO_NULL enumeration
 // Normally it is present in the loaded tils but let’s verify it
 if ( !get_named_type(NULL, null_type, NTF_TYPE) )
 {
   msg(“%s type is missing, cannot convert zeroes to NULLs\n”, null_type);
   return;
 }

 // We derive a helper class from ctree_visitor_t
 // The ctree_visitor_t is a base class to derive
 // ctree walker classes.
 // You have to redefine some virtual functions
 // to do the real job. Here we redefine visit_expr() since we want
 // to examine and modify expressions.
 struct ida_local zero_converter_t : public ctree_visitor_t
 {
   zero_converter_t(void) : ctree_visitor_t(CV_FAST) {}
   int idaapi visit_expr(cexpr_t *e)
   {
     // verify if the current expression has pointer expressions
     // we handle the following patterns:
     //  A. ptr = 0;
     //  B. func(0); where argument is a pointer
     //  C. ptr op 0 where op is a comparison
     switch ( e->op )
     {
       case cot_asg:   // A
         if ( e->x->type.is_ptr() )
           make_null_if_zero(e->y);
         break;

       case cot_call:  // B
         {
           carglist_t &args = *e->a;
           for ( int i=0; i < args.size(); i++ ) // check all arguments
           {
             carg_t &a = args[i];
             if ( a.formal_type.is_ptr_or_array() )
               make_null_if_zero(&a);
           }
         }
         break;

       case cot_eq:    // C
       case cot_ne:
       case cot_sge:
       case cot_uge:
       case cot_sle:
       case cot_ule:
       case cot_sgt:
       case cot_ugt:
       case cot_slt:
       case cot_ult:
         // check both sides for zeroes
         if ( e->y->type.is_ptr() )
           make_null_if_zero(e->x);
         if ( e->x->type.is_ptr() )
           make_null_if_zero(e->y);
         break;

       default:
         break;

     }
     return 0; // continue walking the tree
   }
 };
 zero_converter_t zc;
 // walk the whole function body
 zc.apply_to(&cfunc->body, NULL);
}

//————————————————————————–
// This callback will detect when the ctree is ready to be displayed
// and call convert_zeroes() to create NULLs
static ssize_t idaapi callback(void *, hexrays_event_t event, va_list va)
{
 if ( event == hxe_maturity )
 {
   cfunc_t *cfunc = va_arg(va, cfunc_t*);
   ctree_maturity_t mat = va_argi(va, ctree_maturity_t);
   if ( mat == CMAT_FINAL ) // ctree is ready, time to convert zeroes to NULLs
     convert_zeroes(cfunc);
 }
 return 0;
}

//————————————————————————–
// Initialize the plugin.
int idaapi init(void)
{
 if ( !init_hexrays_plugin() )
   return PLUGIN_SKIP; // no decompiler
 if ( is_enabled() ) // null plugin is enabled?
 {
   install_hexrays_callback(callback, NULL);
   const char *hxver = get_hexrays_version();
   msg(“Hex-rays version %s has been detected, %s ready to use\n”, hxver, PLUGIN.wanted_name);
 }
 inited = true;
 return PLUGIN_KEEP;
}

//————————————————————————–
void idaapi term(void)
{
 if ( inited )
 {
   // clean up
   remove_hexrays_callback(callback, NULL);
   term_hexrays_plugin();
 }
}

//————————————————————————–
bool idaapi run(size_t)
{
 // since all real work is done in the callbacks, use the main plugin entry
 // to turn it on and off.
 // display a message explaining the purpose of the plugin:
 int code = askbuttons(
      “~E~nable”,
      “~D~isable”,
      “~C~lose”,
      –1,
      “AUTOHIDE NONE\n”
      “Sample plugin for Hex-Rays decompiler.\n”
      “\n”
      “This plugin is fully automatic.\n”
      “It detects zeroes in pointer contexts and converts them into NULLs.\n”
      “\n”
      “The current state of the plugin is: %s\n”,
      is_enabled() ? “ENABLED” : “DISABLED”);
 switch ( code )
 {
   case –1:    // close
     break;
   case 0:     // disable
   case 1:     // enable
     netnode n;
     n.create(nodename);
     n.altset(0, code == 0);
     if ( code )
       install_hexrays_callback(callback, NULL);
     else
       remove_hexrays_callback(callback, NULL);
     info(“The %s plugin has been %s.”, PLUGIN.wanted_name, code ? “ENABLED” : “DISABLED”);
     break;
 }
 return true;
}

//————————————————————————–
static char comment[] = “Sample2 plugin for Hex-Rays decompiler”;

//————————————————————————–
//
//      PLUGIN DESCRIPTION BLOCK
//
//————————————————————————–
plugin_t PLUGIN =
{
 IDP_INTERFACE_VERSION,
 0,                    // plugin flags
 init,                 // initialize
 term,                 // terminate. this pointer may be NULL.
 run,                  // invoke plugin
 comment,              // long comment about the plugin
                       // it could appear in the status line
                       // or as a hint
 “”,                   // multiline help about the plugin
 “Hex-Rays NULL converter”, // the preferred short name of the plugin
 “”                    // the preferred hotkey to run the plugin
};

 

中文翻译如下:

以下是一个示例插件的完整源代码。它执行一个非常有用的伪代码转换:将指针上下文中的零替换为NULL。NULL立即传达了当前表达式与指针相关的概念。这对于未知的函数参数尤其有用。

 

该插件是完全自动化的。它钩入反编译器事件并等待伪代码准备就绪。在那一刻,它接管并修改ctree。

 

转换是由convert_zeroes()函数执行的。它访问ctree的所有表达式并检查指针上下文。如果一个表达式具有指针类型,则为它调用make_null_if_zero()函数。此函数检查表达式是否为零常量并在必要时进行转换。

 

该插件可以通过插件子菜单中的菜单项打开或关闭。

 

代码短小简单。可以将其用作插件的模板。

/*

* Hex-Rays Decompiler project

* Copyright (c) 2007-2019 by Hex-Rays, support@hex-rays.com

* ALL RIGHTS RESERVED.

*

* Sample plugin for Hex-Rays Decompiler.

* It automatically replaces zeroes in pointer contexts with NULLs.

* For example, expression like

*

* funcptr = 0;

*

* will be displayed as

*

* funcptr = NULL;

*

* Due to highly dynamic nature of the decompier output, we must

* use the decompiler events to accomplish the task. The plugin will

* wait for the ctree structure to be ready in the memory and will

* replace zeroes in pointer contexts with NULLs.

*

*/

 

#include

 

// Hex-Rays API pointer

hexdsp_t *hexdsp = NULL;

 

static bool inited = false;

 

static const char nodename[] = “$ hexrays NULLs”;

static const char null_type[] = “MACRO_NULL”;

//————————————————————————–

// Is the plugin enabled?

// The user can disable it. The plugin will save the on/off switch in the

// current database.

static bool is_enabled(void)

{

netnode n(nodename); // use a netnode to save the state

return n.altval(0) == 0; // if the long value is positive, then disabled

}

 

//————————————————————————–

// If the expression is zero, convert it to NULL

static void make_null_if_zero(cexpr_t *e)

{

if ( e->is_zero_const() && !e->type.is_ptr() )

{ // this is plain zero, convert it

number_format_t &nf = e->n->nf;

nf.flags = enum_flag();

nf.serial = 0;

nf.type_name = null_type;

e->type = tinfo_t::get_stock(STI_PVOID);

}

}

 

//————————————————————————–

// Convert zeroes of the ctree to NULLs

static void convert_zeroes(cfunc_t *cfunc)

{

// To represent NULLs, we will use the MACRO_NULL enumeration

// Normally it is present in the loaded tils but let’s verify it

if ( !get_named_type(NULL, null_type, NTF_TYPE) )

{

msg(“%s type is missing, cannot convert zeroes to NULLs\n”, null_type);

return;

}

 

// We derive a helper class from ctree_visitor_t

// The ctree_visitor_t is a base class to derive

// ctree walker classes.

// You have to redefine some virtual functions

// to do the real job. Here we redefine visit_expr() since we want

// to examine and modify expressions.

struct ida_local zero_converter_t : public ctree_visitor_t

{

zero_converter_t(void) : ctree_visitor_t(CV_FAST) {}

int idaapi visit_expr(cexpr_t *e)

{

// verify if the current expression has pointer expressions

// we handle the following patterns:

// A. ptr = 0;

// B. func(0); where argument is a pointer

// C. ptr op 0 where op is a comparison

switch ( e->op )

{

case cot_asg: // A

if ( e->x->type.is_ptr() )

make_null_if_zero(e->y);

break;

 

case cot_call: // B

{

carglist_t &args = *e->a;

for ( int i=0; i < args.size(); i++ ) // check all arguments

{

carg_t &a = args[i];

if ( a.formal_type.is_ptr_or_array() )

make_null_if_zero(&a);

}

}

break;

 

case cot_eq: // C

case cot_ne:

case cot_sge:

case cot_uge:

case cot_sle:

case cot_ule:

case cot_sgt:

case cot_ugt:

case cot_slt:

case cot_ult:

// check both sides for zeroes

if ( e->y->type.is_ptr() )

make_null_if_zero(e->x);

if ( e->x->type.is_ptr() )

make_null_if_zero(e->y);

break;

 

default:

break;

 

}

return 0; // continue walking the tree

}

};

zero_converter_t zc;

// walk the whole function body

zc.apply_to(&cfunc->body, NULL);

}

 

//————————————————————————–

// This callback will detect when the ctree is ready to be displayed

// and call convert_zeroes() to create NULLs

static ssize_t idaapi callback(void *, hexrays_event_t event, va_list va)

{

if ( event == hxe_maturity )

{

cfunc_t *cfunc = va_arg(va, cfunc_t*);

ctree_maturity_t mat = va_argi(va, ctree_maturity_t);

if ( mat == CMAT_FINAL ) // ctree is ready, time to convert zeroes to NULLs

convert_zeroes(cfunc);

}

return 0;

}

 

//————————————————————————–

// Initialize the plugin.

int idaapi init(void)

{

if ( !init_hexrays_plugin() )

return PLUGIN_SKIP; // no decompiler

if ( is_enabled() ) // null plugin is enabled?

{

install_hexrays_callback(callback, NULL);

const char *hxver = get_hexrays_version();

msg(“Hex-rays version %s has been detected, %s ready to use\n”, hxver, PLUGIN.wanted_name);

}

inited = true;

return PLUGIN_KEEP;

}

 

//————————————————————————–

void idaapi term(void)

{

if ( inited )

{

// clean up

remove_hexrays_callback(callback, NULL);

term_hexrays_plugin();

}

}

 

//————————————————————————–

bool idaapi run(size_t)

{

// since all real work is done in the callbacks, use the main plugin entry

// to turn it on and off.

// display a message explaining the purpose of the plugin:

int code = askbuttons(

“~E~nable”,

“~D~isable”,

“~C~lose”,

–1,

“AUTOHIDE NONE\n”

“Sample plugin for Hex-Rays decompiler.\n”

“\n”

“This plugin is fully automatic.\n”

“It detects zeroes in pointer contexts and converts them into NULLs.\n”

“\n”

“The current state of the plugin is: %s\n”,

is_enabled() ? “ENABLED” : “DISABLED”);

switch ( code )

{

case –1: // close

break;

case 0: // disable

case 1: // enable

netnode n;

n.create(nodename);

n.altset(0, code == 0);

if ( code )

install_hexrays_callback(callback, NULL);

else

remove_hexrays_callback(callback, NULL);

info(“The %s plugin has been %s.”, PLUGIN.wanted_name, code ? “ENABLED” : “DISABLED”);

break;

}

return true;

}

 

//————————————————————————–

static char comment[] = “Sample2 plugin for Hex-Rays decompiler”;

 

//————————————————————————–

//

// PLUGIN DESCRIPTION BLOCK

//

//————————————————————————–

plugin_t PLUGIN =

{

IDP_INTERFACE_VERSION,

0, // plugin flags

init, // initialize

term, // terminate. this pointer may be NULL.

run, // invoke plugin

comment, // long comment about the plugin

// it could appear in the status line

// or as a hint

“”, // multiline help about the plugin

“Hex-Rays NULL converter”, // the preferred short name of the plugin

“” // the preferred hotkey to run the plugin

};

展开阅读全文

标签:

读者也访问过这里:
邀请您进入交流群 点击扫码
400-8765-888 kefu@makeding.com

专业销售为您服务

欢迎添加好友,了解更多IDA优惠信息,领逆向工程学习资料礼包1份!
热门文章
exe反编译工具哪个好?反编译能力强的工具盘点
随着软件技术的发展,exe(可执行文件)已经成为了电脑、手机等多个平台上的主要软件运行格式,而对于exe文件的反编译也成为了逆向工程中不可缺少的一个步骤。本文将介绍一些常用的exe反编译工具,并评价其优缺点,帮助读者选择合适的工具。
2023-04-12
idapro怎么改为中文
IDA Pro是一款功能强大的反汇编和反编译工具,广泛应用于逆向工程和软件开发领域。在使用IDA Pro时,如果我们不习惯英文界面,可以将其改为中文界面。本文将介绍IDA Pro怎么改为中文界面。IDA Pro界面改成中文主要有两种方法,下面是详细介绍。
2023-04-19
c++反编译工具有哪些
反编译C++代码的工具一般是针对可执行文件和库文件的反汇编和逆向分析工具。本文将给大家介绍c++反编译工具有哪些的内容。市面说的c++反编译工具有很多,下面介绍几款使用认识较多的软件。
2023-04-23
ida如何转伪代码 ida伪代码怎么看
IDA Pro是一款常用的反汇编和反编译工具,可以帮助我们分析二进制文件的实现细节和执行过程,以便更好地理解程序的执行过程和逻辑。在进行逆向工程的过程中,我们经常需要将反汇编结果转换为伪代码,以便更好地进行分析和修改。本文将介绍如何使用IDA Pro转换为伪代码,并简单讲解ida伪代码怎么看。
2023-04-14
IDA反汇编流程视图的常用基本操作设置
IDA中反汇编窗口中有两种不同的形式,分别是列表模式和图形模式,IDA默认打开是图形模式,就是反汇编流程视图,可以用来分析程序函数的具体运行情况。
2021-06-15
最新文章
二进制文件的反编译难吗?如何通过IDA操作二进制文件的反汇编与反编译?
在信息安全和软件开发领域,二进制文件的反编译和反汇编是逆向工程的重要组成部分。通过这些技术,研究人员和开发人员可以理解软件的内部工作机制,发现潜在的安全漏洞或进行功能分析。然而,二进制文件的反编译难吗?如何通过IDA操作二进制文件的反汇编与反编译?本文将详细探讨这些问题,并介绍IDA支持的常见文件类型,帮助读者更好地理解和应用这些技术。
2024-06-19
反编译后代码怎么定位?如何利用IDA反编译功能定位关键代码?
在软件开发和安全领域中,反编译是一项重要的技术。反编译后代码怎么定位?如何利用IDA反编译功能定位关键代码?这些问题常常困扰着初学者和经验丰富的逆向工程师。在这篇文章中,我们将深入探讨这些问题,并提供详细的解决方案。
2024-06-13
二进制代码怎么反编译?如何通过IDA软件反编译功能分析二进制代码?
在软件开发和信息安全领域,反汇编和反编译工具的使用非常普遍。这些工具不仅能够帮助开发人员分析已有软件的内部机制,还能用于逆向工程,帮助发现软件中的潜在漏洞或安全隐患。本文将围绕“二进制代码怎么反编译?如何通过IDA软件反编译功能分析二进制代码?”这一主题,详细介绍相关内容。
2024-06-06
常用的反汇编工具有哪些?如何利用IDA软件进行高效的反汇编操作?
在现代信息安全和软件开发领域,反汇编工具扮演着至关重要的角色。通过这些工具,开发人员和安全专家可以深入了解程序的内部结构,从而实现漏洞挖掘、恶意软件分析以及代码优化等任务。那么,常用的反汇编工具有哪些?如何利用IDA软件进行高效的反汇编操作?本文将为您详细解答这些问题。
2024-06-04
逆向工程流程图怎么做?用IDA制作逆向工程流程图的方法
逆向工程作为软件分析领域的一项核心技术,对于理解和分析未知或复杂的二进制应用程序至关重要。制作逆向工程流程图是这一过程中的关键步骤,可以帮助分析师可视化程序的执行流程。IDA Pro,作为当前最先进的逆向工程工具之一,提供了强大的流程图生成功能。本文将详细介绍逆向工程流程图的制作方法,特别是如何利用IDA Pro来实现这一目标,并探讨进行逆向工程所需要的基本理论知识。
2024-05-28
ida lumina是什么?ida lumina的应用场景有哪些?
在软件开发和逆向工程领域,IDA Pro是一个广为人知的工具,用于反编译和分析二进制文件。而IDA Lumina是IDA Pro中的一个新功能,专注于提高反编译和分析的效率。那么,IDA Lumina具体是什么?它有哪些应用场景?本文将详细解答这些问题,并介绍IDA的不同版本。
2024-05-22

通过微信咨询我们

欢迎添加好友,了解更多IDA优惠信息,领取逆向工程学习资料礼包1份!