HeapInspect 项目使用教程

HeapInspect 项目使用教程

heapinspect🔍Heap analysis tool for CTF pwn.项目地址:https://gitcode.com/gh_mirrors/he/heapinspect

1. 项目目录结构及介绍

heapinspect/
├── docs/
│   └── ...  # 项目文档文件
├── heapinspect/
│   ├── core/
│   │   └── ...  # 核心功能模块
│   ├── img/
│   │   └── ...  # 项目相关图片
│   ├── __init__.py
│   ├── HeapInspect.py
│   └── ...  # 其他相关文件
├── .gitignore
├── HeapInspect.py
├── LICENSE
├── README.md
└── gdbscript.py

目录结构介绍

• docs/: 存放项目的文档文件，包括使用说明、API文档等。
• heapinspect/: 项目的主要代码目录，包含核心功能模块和相关文件。
  • core/: 核心功能模块，负责处理堆内存的检查和分析。
  • img/: 存放项目相关的图片文件。
  • init.py: Python包的初始化文件。
  • HeapInspect.py: 项目的主要启动文件。
• .gitignore: Git忽略文件，指定不需要版本控制的文件和目录。
• HeapInspect.py: 项目的启动文件，负责解析命令行参数并启动堆内存检查。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的说明文件，包含项目的基本信息、使用方法等。
• gdbscript.py: GDB脚本文件，可能用于与GDB集成。

2. 项目启动文件介绍

HeapInspect.py

HeapInspect.py 是项目的启动文件，负责解析命令行参数并启动堆内存检查。以下是该文件的主要功能和结构：

import argparse
from heapinspect.core import *

if __name__ == '__main__':
    parser = argparse.ArgumentParser(
        prog='HeapInspect.py',
        description='''Inspect your heap by a given pid.
        Author: matrix1001
        Github: https://github.com/matrix1001/heapinspect'''
    )
    parser.add_argument(
        '--raw',
        action='store_true',
        help='show more detailed chunk info'
    )
    parser.add_argument(
        '--rela',
        action='store_true',
        help='show relative detailed chunk info'
    )
    parser.add_argument(
        'pid',
        type=int,
        help='pid of the process'
    )
    parser.add_argument(
        '-x',
        action='store_false',
        help='ignore: heapchunks'
    )
    args = parser.parse_args()
    pid = args.pid
    hi = HeapInspector(pid)
    if args.rela:
        hs = HeapShower(hi)
        hs.relative()

功能介绍

• 命令行参数解析: 使用 argparse 模块解析命令行参数，支持 --raw、--rela、pid 和 -x 等选项。
• 堆内存检查: 通过 HeapInspector 类对指定进程的堆内存进行检查，并根据参数显示详细信息。

3. 项目配置文件介绍

配置文件

HeapInspect 项目没有明确的配置文件，其主要配置通过命令行参数进行设置。以下是一些常用的命令行参数：

• --raw: 显示更详细的内存块信息。
• --rela: 显示相对详细的内存块信息。
• pid: 指定要检查的进程ID。
• -x: 忽略堆内存块信息。

使用示例

python HeapInspect.py --rela 1234

该命令将检查进程ID为1234的堆内存，并显示相对详细的内存块信息。

---

以上是 HeapInspect 项目的使用教程，涵盖了项目的目录结构、启动文件和配置文件的介绍。希望这些信息能帮助你更好地理解和使用该项目。

heapinspect🔍Heap analysis tool for CTF pwn.项目地址:https://gitcode.com/gh_mirrors/he/heapinspect