getdns 项目使用教程

getdns 项目使用教程

getdns A modern asynchronous DNS API https://getdnsapi.net/ 项目地址: https://gitcode.com/gh_mirrors/ge/getdns

1. 项目目录结构及介绍

getdns 项目的目录结构如下：

getdns/
├── AUTHORS
├── CMakeLists.txt
├── COPYING
├── ChangeLog
├── LICENSE
├── NEWS
├── README.md
├── cmake/
├── doc/
├── getdns.pc.in
├── getdns_ext_event.pc.in
├── project-doc/
├── spec/
├── src/
└── stubby/

目录介绍：

• AUTHORS: 项目贡献者列表。
• CMakeLists.txt: CMake 构建文件，用于配置和构建项目。
• COPYING: 许可证文件。
• ChangeLog: 项目变更日志。
• LICENSE: 项目许可证。
• NEWS: 项目新闻和更新信息。
• README.md: 项目自述文件，包含项目的基本信息和使用说明。
• cmake/: 包含 CMake 相关的配置文件和脚本。
• doc/: 包含项目的文档文件，如 Doxygen 生成的文档。
• getdns.pc.in 和 getdns_ext_event.pc.in: 用于生成 pkg-config 文件的模板。
• project-doc/: 包含项目文档的源文件。
• spec/: 包含项目规范和示例代码。
• src/: 包含项目的源代码。
• stubby/: 包含 Stubby 客户端的源代码，Stubby 是一个 DNS Privacy 客户端。

2. 项目启动文件介绍

getdns 项目的主要启动文件是 src/getdns_query.c，它是一个命令行工具，用于测试 getdns 库的功能。该文件提供了一个简单的接口，允许用户通过命令行查询 DNS 记录。

启动文件介绍：

• src/getdns_query.c: 该文件实现了 getdns_query 命令行工具，用户可以通过该工具查询 DNS 记录并查看结果。

使用示例：

getdns_query -s example.com A @8.8.8.8 +return_call_reporting

该命令将查询 example.com 的 A 记录，并使用 Google Public DNS 服务器 8.8.8.8 进行查询。

3. 项目配置文件介绍

getdns 项目的配置文件主要通过 CMake 进行管理。主要的配置文件是 CMakeLists.txt，它定义了项目的构建配置和依赖项。

配置文件介绍：

• CMakeLists.txt: 该文件定义了项目的构建配置，包括源文件、依赖项、编译选项等。

配置示例：

cmake_minimum_required(VERSION 3.0)
project(getdns)

# 添加源文件
set(SOURCE_FILES
    src/getdns_query.c
    src/getdns_server_mon.c
)

# 添加依赖项
find_package(OpenSSL REQUIRED)
find_package(Unbound REQUIRED)
find_package(Libidn2 REQUIRED)

# 配置编译选项
add_executable(getdns_query ${SOURCE_FILES})
target_link_libraries(getdns_query OpenSSL::SSL OpenSSL::Crypto Unbound::Unbound Libidn2::Libidn2)

配置说明：

• cmake_minimum_required: 指定 CMake 的最低版本要求。
• project: 定义项目名称。
• set(SOURCE_FILES): 指定项目的源文件。
• find_package: 查找并配置项目的依赖项。
• add_executable: 定义可执行文件。
• target_link_libraries: 指定可执行文件链接的库。

通过以上配置，用户可以自定义项目的构建过程，并根据需要添加或修改依赖项。

getdns A modern asynchronous DNS API https://getdnsapi.net/ 项目地址: https://gitcode.com/gh_mirrors/ge/getdns