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
IDA反汇编流程视图的常用基本操作设置
IDA中反汇编窗口中有两种不同的形式,分别是列表模式和图形模式,IDA默认打开是图形模式,就是反汇编流程视图,可以用来分析程序函数的具体运行情况。
2021-06-15
IDA一些常用到的功能及其快捷键
通常情况下,我们使用反编译工具是为了在没有源代码的情况下促进对程序的了解,以便于我们分析软件的漏洞、分析编译器生成的代码,以验证编译器的性能和准确性,同时也可以用来分析软件是否带有恶意程序,提高安全性。
2021-05-17
IDA的初始使用说明和界面简介
IDA能帮助我们分析恶意软件、分析系统漏洞、验证编译器的性能,其支持在Mac系统、Windows系统、Linux系统中使用,是一款非常优秀的反编译软件。
2021-03-16
IDA反编译界面之流程预览、函数窗口介绍
在上节《IDA反编译界面之工具栏、导航栏、输出栏介绍》中,我们已经认识了IDA主界面六大窗口中的前三个窗口,接下来我们还需要认识余下的三大窗口,分别是主视图窗口、流程预览窗口和函数窗口。
2021-03-16
使用IDA数据库搜索功能搜索内容
IDA提供了专用的搜索工具,多种不同的搜索方式,帮助我们在IDA数据库中快速搜索内容,并导航到页面上的指定位置。该软件设计了许多类型的数据显示来总结特定类型的信息(如字符串、名称),以方便我们查找这些信息。
2021-03-18
最新文章
IDA是什么软件 IDA的基本用法是什么样的
在当今数字化的时代,软件技术的发展日新月异,反汇编和反编译成为了软件领域中不可或缺的一部分。在众多的反汇编和反编译工具中,IDA(Interactive DisAssembler)以其卓越的功能和灵活性而脱颖而出。本文将深入探讨IDA是什么软件,IDA的基本用法是什么样的,以及它对企业的价值和影响。
2023-09-27
ida怎么搜索函数 ida如何定位main函数
在软件逆向工程的领域中,IDA(Interactive DisAssembler)被广泛认可为一款强大的工具,它为分析人员提供了深入探索程序内部结构和功能的能力。其中,函数搜索和定位主函数(main函数)作为逆向分析的基础技巧,具有重要的地位。本文将为您介绍IDA中如何高效地进行函数搜索以及定位主函数的方法,帮助您在逆向分析过程中更加得心应手。
2023-09-27
ida怎么查找字符串 ida字符串窗口快捷键
在数字化时代,逆向工程作为解密软件和分析程序的关键技术,正日益受到广泛关注。在逆向分析的过程中,IDA(Interactive DisAssembler)是一款备受推崇的工具,它为逆向工程师们提供了强大的功能和灵活的操作。本文将带您深入探讨如何在IDA中查找字符串,优化字符串窗口的使用,并探讨IDA如何将变量转换成字符串,帮助您更加熟练地驾驭这一工具,为逆向分析的世界增添一抹精彩。
2023-09-27
ida怎么修改汇编语言 ida修改后怎么保存
在当今数字化时代,汇编语言作为底层的编程语言,具有无可比拟的重要性。而在逆向工程领域,IDA作为一款卓越的工具,为我们提供了修改汇编语言的能力,极大地拓展了我们的技术边界。本文将深入研究ida怎么修改汇编语言,ida修改后怎么保存的内容。
2023-09-25
渗透测试的基本流程 IDA如何进行渗透测试
在当前数字时代,保护信息安全成了企业和个人都要面临的重要挑战。渗透测试是一项评估信息系统安全的关键技术,它涵盖了对目标系统的全方位攻击模拟,以评估其安全性能。其中,IDA作为一款广泛应用的逆向工程工具,在渗透测试过程中发挥着核心作用。本文将介绍渗透测试的基本流程,IDA如何进行渗透测试和渗透测试的目的的内容,为你深入解读渗透测试的精髓和实施过程。
2023-09-21
ppc反汇编怎么看 IDA如何分析ppc反汇编
通过PPC反汇编技术,开发者能够将复杂的机器码转换为易于理解的汇编指令,从而更好地分析程序的功能和执行过程。在接下来的部分中,我们将探讨ppc反汇编怎么看,IDA如何分析ppc反汇编,为您展示如何深入挖掘程序的内部机制。
2023-09-20

通过微信咨询我们

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