---
generated_at: 2026-02-17 11:15:00
metrics:
  claims_total: 35
  claims_with_evidence: 34
  claims_without_evidence: 1
confidence_derived: 0.97
---

# 根拠レポート：75-asyncnet.md

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.97**
  - 根拠あり：34 / 35、根拠なし：1
- 優先レビュー（高）
  1. **epoll/kqueue/IOCP対応の詳細**：プラットフォーム依存の実装詳細

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `lib/pure/asyncnet.nim` 10-11行目（モジュールドキュメント）
- E-02: `lib/pure/asyncnet.nim` 14-49行目（Async IOの階層説明）
- E-03: `lib/pure/asyncnet.nim` 51-58行目（SSLドキュメント）
- E-04: `lib/pure/asyncnet.nim` 108行目（defineSsl定数）
- E-05: `lib/pure/asyncnet.nim` 118-135行目（AsyncSocketDesc型）
- E-06: `lib/pure/asyncnet.nim` 137-163行目（newAsyncSocket AsyncFD版）
- E-07: `lib/pure/asyncnet.nim` 165-178行目（newAsyncSocket 新規作成版）
- E-08: `lib/pure/asyncnet.nim` 298-308行目（dial関数）
- E-09: `lib/pure/asyncnet.nim` 310-327行目（connect関数）
- E-10: `lib/pure/asyncnet.nim` 329-344行目（readIntoテンプレート）
- E-11: `lib/pure/asyncnet.nim` 353-399行目（recvInto関数）
- E-12: `lib/pure/asyncnet.nim` 401-452行目（recv関数）
- E-13: `lib/pure/asyncnet.nim` 454-480行目（send関数）
- E-14: `lib/pure/asyncnet.nim` 482-504行目（acceptAddr関数）
- E-15: `lib/pure/asyncnet.nim` 506-522行目（accept関数）
- E-16: `lib/pure/asyncnet.nim` 524-613行目（recvLineInto関数）
- E-17: `lib/pure/asyncnet.nim` 615-643行目（recvLine関数）
- E-18: `lib/pure/asyncnet.nim` 645-652行目（listen関数）
- E-19: `lib/pure/asyncnet.nim` 654-672行目（bindAddr関数）
- E-20: `lib/pure/asyncnet.nim` 681-710行目（connectUnix関数）
- E-21: `lib/pure/asyncnet.nim` 712-720行目（bindUnix関数）
- E-22: `lib/pure/asyncnet.nim` 734-759行目（close関数）
- E-23: `lib/pure/asyncnet.nim` 767-783行目（wrapSocket関数）
- E-24: `lib/pure/asyncnet.nim` 785-808行目（wrapConnectedSocket関数）
- E-25: `lib/pure/asyncnet.nim` 268-296行目（sslLoopテンプレート）
- E-26: `lib/pure/asyncnet.nim` 589-590行目（maxLength DOS対策コメント#3847）
- E-27: `lib/pure/asyncnet.nim` 42-46行目（シングルスレッド、ノンブロッキング説明）

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | asyncnetは高レベル非同期ソケットAPIを提供 | E-01 | ○ |
| C-02 | asyncdispatchモジュールをベースとする | E-01, E-02 | ○ |
| C-03 | シングルスレッドで完全にノンブロッキング | E-27 | ○ |
| C-04 | AsyncSocketDesc型が非同期ソケット状態を管理 | E-05 | ○ |
| C-05 | fd、closed、isBuffered、bufferフィールドを持つ | E-05 (119-124行目) | ○ |
| C-06 | SSL関連フィールドはwhen defineSslで条件コンパイル | E-05 (126-131行目) | ○ |
| C-07 | newAsyncSocketでAsyncFDから作成 | E-06 | ○ |
| C-08 | setBlockingでノンブロッキングモードに設定 | E-06 (155行目) | ○ |
| C-09 | setInheritableで継承制御 | E-06 (156-157行目) | ○ |
| C-10 | dialでIPv4/IPv6自動選択 | E-08 | ○ |
| C-11 | connectで接続とSSLハンドシェイク | E-09 | ○ |
| C-12 | SNIを設定（IPアドレスでない場合） | E-09 (320-323行目) | ○ |
| C-13 | readIntoテンプレートで読み取り基本処理 | E-10 | ○ |
| C-14 | SSL使用時はsslRead経由 | E-10 (336-340行目) | ○ |
| C-15 | recvIntoはバッファ対応の受信 | E-11 | ○ |
| C-16 | recvは文字列を返す受信 | E-12 | ○ |
| C-17 | sendでデータ送信 | E-13 | ○ |
| C-18 | SSL使用時はsslLoop経由でsslWrite | E-13 (461-464行目) | ○ |
| C-19 | acceptAddrでクライアントソケットとアドレス取得 | E-14 | ○ |
| C-20 | acceptでクライアントソケットのみ取得 | E-15 | ○ |
| C-21 | recvLineIntoで行単位受信（FutureVar版） | E-16 | ○ |
| C-22 | recvLineで行単位受信 | E-17 | ○ |
| C-23 | maxLengthでDOS攻撃対策（#3847） | E-26 | ○ |
| C-24 | listenで接続待機開始 | E-18 | ○ |
| C-25 | bindAddrでアドレスをバインド | E-19 | ○ |
| C-26 | connectUnixでUnixソケット接続 | E-20 | ○ |
| C-27 | bindUnixでUnixソケットバインド | E-21 | ○ |
| C-28 | closeでソケットクローズとSSLシャットダウン | E-22 | ○ |
| C-29 | SSL_in_init確認でシャットダウンスキップ | E-22 (750行目) | ○ |
| C-30 | wrapSocketでSSLラッピング | E-23 | ○ |
| C-31 | BIOをメモリバッファとして設定 | E-23 (779-781行目) | ○ |
| C-32 | wrapConnectedSocketで接続済みソケットラッピング | E-24 | ○ |
| C-33 | sslLoopでSSL読み書きループ | E-25 | ○ |
| C-34 | SSL_ERROR_WANT_READ/WRITEで自動リトライ | E-25 (287-296行目) | ○ |
| C-35 | epoll/kqueue/IOCP対応の詳細実装 | **根拠なし**（asyncdispatch側） | △ |

## 4) 不足情報（Unknown / Missing）
- epoll/kqueue/IOCPの具体的な実装詳細
  - 候補：asyncdispatch.nimの実装を参照

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - 基本的な機能説明
- 0: 低リスク - データ構造の説明
- 1: 中リスク - SSL処理のセキュリティ警告（Disclaimer）
- 1: 中リスク - DOS攻撃対策の実装
- 0: 低リスク - エラー処理の説明

## 6) レビュアーチェックリスト（最小）
- [ ] AsyncSocketDesc型のフィールドがすべて文書化されているか確認
- [ ] SSL接続処理のsslLoopが正確に説明されているか確認
- [ ] maxLength DOS対策の動作が正確か確認
- [ ] Unixソケット関数がPOSIX環境でのみ利用可能と説明されているか確認
- [ ] wrapSocket/wrapConnectedSocketのDisclaimerが適切か確認
