Addrwatch 技术文档

1. 安装指南

在编译 addrwatch 前，您需要确保安装以下共享库：

• libpcap
• libevent
• mysqlclient（可选）

若要编译带有 MySQL 支持的 addrwatch，请执行以下命令：

./configure --enable-mysql
make
make install

若要编译基本的 addrwatch 版本，请执行以下命令：

./configure
make
make install

如果您不希望将 addrwatch 安装到系统中，可以跳过 make install 步骤。您可以找到主 addrwatch 二进制文件和所有输出 addrwatch_* 二进制文件在 'src' 目录中。

2. 项目的使用说明

要尝试使用 addrwatch，可以无参数启动它：

addrwatch

当以这种方式启动时，addrwatch 将打开第一个非环回接口并开始将事件记录到控制台，而不会将任何内容写入磁盘。所有事件都会打印到 stdout，调试、警告和错误消息会发送到 syslog 并打印到 stderr。

如果您收到错误消息：

addrwatch: ERR: No suitable interfaces found!

通常意味着您以普通用户身份启动了 addrwatch，并且没有足够的权限在网络接口上启动嗅探。您应该以 root 用户身份启动 addrwatch：

sudo addrwatch

您可以通过传递接口名称作为参数来指定应监视哪些网络接口或接口。例如：

addrwatch eth0 tap0

要了解更多使用选项，请运行：

addrwatch --help

在生产环境中，建议以守护进程模式启动主 addrwatch 二进制文件，并使用单独的输出进程来记录数据。例如：

./addrwatch -d eth0
./addrwatch_stdout

3. 项目API使用文档

本项目的 API 使用文档未在提供的资料中明确说明，通常这类工具的 API 主要是针对其输出格式进行开发，例如解析 addrwatch 的日志文件格式等。用户可参考日志格式和源代码中的相关处理逻辑来自行开发。

4. 项目安装方式

项目的安装方式已在“安装指南”一节中详细说明。以下是简要的步骤：

• 确保安装所需的共享库（libpcap、libevent 和可选的 mysqlclient）。
• 使用 ./configure 命令进行配置，根据需要添加 --enable-mysql 参数。
• 使用 make 命令编译源代码。
• 使用 make install 命令安装编译好的二进制文件到系统中。

请确保按照以上步骤操作，以成功安装 addrwatch。