Pig 项目使用文档

Pig 项目使用文档

pig A Linux packet crafting tool. 项目地址: https://gitcode.com/gh_mirrors/pig2/pig

1. 项目目录结构及介绍

Pig 项目的目录结构如下：

pig/
├── doc/
├── etc/
├── pigsty/
├── src/
│   ├── bin/
│   └── ...
├── .gitmodules
├── COPYING
├── README.md
├── RELNOTES.md
└── ...

目录介绍：

• doc/: 存放项目的文档文件。
• etc/: 存放项目的配置文件或其他相关文件。
• pigsty/: 存放 Pigsty 文件，这些文件用于定义数据包签名。
• src/: 项目的源代码目录，包含主要的代码文件和生成的二进制文件。
  • bin/: 存放编译生成的二进制文件。
• .gitmodules: Git 子模块配置文件。
• COPYING: 项目的许可证文件。
• README.md: 项目的介绍和基本使用说明。
• RELNOTES.md: 项目的发布说明。

2. 项目启动文件介绍

Pig 项目的启动文件是 src/bin/pig，这是一个二进制文件，用于启动 Pig 工具。要启动 Pig，首先需要确保已经按照以下步骤编译并安装了项目：

编译步骤：

1. 克隆项目仓库：

   git clone https://github.com/rafael-santiago/pig.git
   cd pig
   

2. 初始化子模块：

   git submodule update --init
   

3. 使用 Hefesto 工具编译项目：

   cd src
   hefesto
   

编译完成后，pig 二进制文件将位于 src/bin/ 目录下。

启动 Pig：

./src/bin/pig --signatures=pigsty/ddos.pigsty --gateway=10.0.2.2 --net-mask=255.255.255.0 --lo-iface=eth0

3. 项目配置文件介绍

Pig 项目的配置文件主要位于 pigsty/ 目录下，这些文件用于定义数据包签名。每个 Pigsty 文件都是一个文本文件，包含一组数据包签名的定义。

Pigsty 文件示例：

[ signature = "Hello"
  ip.version = 4
  ip.ihl = 5
  ip.tos = 0
  ip.src = 192.30.70.10
  ip.dst = 192.30.70.3
  ip.protocol = 17
  udp.dst = 1008
  udp.src = 32000
  udp.payload = "Hello, "
]

配置文件字段说明：

• signature: 签名的名称。
• ip.version: IP 版本号。
• ip.ihl: IP 头长度。
• ip.tos: 服务类型。
• ip.src: 源 IP 地址。
• ip.dst: 目标 IP 地址。
• ip.protocol: 协议类型（如 TCP、UDP、ICMP）。
• udp.dst: UDP 目标端口。
• udp.src: UDP 源端口。
• udp.payload: UDP 数据包的有效载荷。

通过这些配置文件，用户可以定义各种数据包签名，用于测试 IDS/IPS 系统或其他网络工具。

pig A Linux packet crafting tool. 项目地址: https://gitcode.com/gh_mirrors/pig2/pig