forked from PurpleI2P/i2pd_docs_en
104 lines
2.8 KiB
Markdown
104 lines
2.8 KiB
Markdown
# 在 i2pd 上进行开发（Hacking on i2pd）
|
||
|
||
本文包含在 i2pd 上进行开发的笔记
|
||
|
||
## 先决条件
|
||
|
||
本指南假设你具备：
|
||
|
||
* 对 C++ 有较好的理解
|
||
* 对 I2P 在 I2NP 层及以上的工作机制有基本了解
|
||
|
||
## 总体结构
|
||
|
||
关于多线程的注意事项
|
||
|
||
* 每个组件都在其各自的线程中运行
|
||
|
||
* 每个组件（通常）都有一个公共函数 `GetService()`，可用于获取其使用的 `boost::asio::io_service`。
|
||
|
||
* 在组件/线程之间通信时，务必使用 `GetService().post()`，并注意栈上分配的内存。
|
||
|
||
### NetDb
|
||
|
||
#### NetDb.h
|
||
|
||
`i2p::data::netdb` 是一个 `i2p::data::NetDb` 实例，用于处理和分发从传输层传入的入站 I2NP 消息。
|
||
|
||
自 2.10.1 起在 `i2p::data::netdb` 处作为全局单例。
|
||
|
||
#### NetDbRequests.h
|
||
|
||
用于挂起的 RouterInfo/LeaseSet 查找与存储请求。
|
||
|
||
### ClientContext
|
||
|
||
#### ClientContext.h
|
||
|
||
`i2p::client::ClientContext` 会生成 I2P 路由器使用的所有目的地（Destination），包括共享的本地目的地。
|
||
|
||
自 2.10.1 起在 `i2p::client::context` 处作为全局单例。
|
||
|
||
### Daemon
|
||
|
||
文件：Daemon.cpp
|
||
|
||
`i2p::util::Daemon_Singleton_Private` 的子类实现守护进程的启动与关闭，并创建 HTTP WebUI 和 I2P 控制服务器。
|
||
|
||
### Destinations
|
||
|
||
#### Destination.h
|
||
|
||
每个目的地都在其自己的线程中运行。
|
||
|
||
##### i2p::client::LeaseSetDestination
|
||
|
||
`i2p::client::ClientDestination` 的基类。
|
||
|
||
##### i2p::client::ClientDestination
|
||
|
||
能够创建（TCP/I2P）流以及数据报会话的目的地。
|
||
|
||
#### Streaming.h
|
||
|
||
##### i2p::stream::StreamingDestination
|
||
|
||
不实现任何与目的地相关的成员，这个名字有点误导性。
|
||
|
||
持有一个 `i2p::client::ClientDestination`，并在目的地线程中运行。
|
||
|
||
任何在目的地线程之外创建或使用流的人都必须了解多线程 C++ 的后果 :^)
|
||
|
||
如果你使用 Streaming，请考虑通过 `ClientDestination::GetService().post()` 在目的地线程内运行所有代码。
|
||
|
||
#### Garlic.h
|
||
|
||
提供目的地间（Inter-Destination）的路由原语。
|
||
|
||
##### i2p::garlic::GarlicDestination
|
||
|
||
`i2p::client::LeaseSetDestination` 的子类，用于沿共享的路由路径发送消息。
|
||
|
||
##### i2p::garlic::GarlicRoutingSession
|
||
|
||
我们与另一个目的地之间的点对点对话。
|
||
|
||
##### i2p::garlic::GarlicRoutingPath
|
||
|
||
当前路由会话所使用的一条路由路径。指定应使用哪个出站隧道，以及在 `OBEP` 到 `IBGW` 的跨隧道通信中使用哪个远程 LeaseSet。
|
||
|
||
成员：
|
||
|
||
* outboundTunnel (OBEP)
|
||
* remoteLease (IBGW)
|
||
* rtt（往返时间）
|
||
* updatedTime（此路径的 IBGW/OBEP 上次更新的时间）
|
||
* numTimesUsesd（此路径被使用的次数）
|
||
|
||
### Transports
|
||
|
||
每个传输（transport）都在其自身的线程中运行。
|
||
|
||
#### Transports.h
|
||
|
||
`i2p::transport::Transports` 包含 NTCP 和 SSU 传输实例。 |