Skip to content

Commit 671b3a1

Browse files
tigercosmosclaude
tigercosmos
and
claude
committed
translation: add AI sync contract and refresh zh-TW / kor
- Add translation/ai_translation_prompt.md: a contract any AI agent (Claude, Codex, Gemini, GPT, etc.) follows to verify and sync the translated READMEs against the canonical English README. Defines triggers, a structural verification matrix, GitHub anchor-slug rules, badge alt-text and HTML-embed policies, and a mandatory "synced using AI" caution that must appear at the top of every translated file. - Refresh translation/README-zh-tw.md to match the current English README: add Cisco HDLC at L2 #1 and renumber L2-L7 (50 -> 56 protocols); add 5 missing L7 entries (Cryptographic key decoders, DoIP, Modbus, PEM, X509); fix broken TOC anchors and Homebrew case; localize stale inline anchors (#download, #provide-feedback); align L6 heading text with the TOC; correct code-fence info strings for vcpkg/conan blocks; add the "synced using AI" caution at top. - Refresh translation/README-kor.md to match the current English README: add Cisco HDLC and the 5 missing L7 entries; renumber L2-L7; add the missing TLS Fingerprinting bullet to Feature Overview; fix TOC anchors and section/heading mismatches (#download, 라이센스, 기여, 성능 벤치마크); add the "synced using AI" caution at top. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent cf2b617 commit 671b3a1

3 files changed

Lines changed: 332 additions & 116 deletions

File tree

‎translation/README-kor.md‎

Lines changed: 64 additions & 55 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
> ⚠️ **참고:** 이 번역은 AI를 사용하여 유지·동기화되며, 최신 영어 버전과 차이가 있을 수 있습니다. 부정확한 내용을 발견하시면 GitHub 이슈를 등록하거나 PR을 제출해 주세요.
2+
13
<div align="center">
24

35
[![PcapPlusPlus 로고](https://pcapplusplus.github.io/img/logo/logo_color.png)](https://pcapplusplus.github.io)
@@ -43,8 +45,8 @@ PcapPlusPlus는 다양한 네트워크 프로토콜을 디코딩하고 생성할
4345
- [DPDK 및 PF_RING 지원](#dpdk-및-pf_ring-지원)
4446
- [벤치마크](#벤치마크)
4547
- [피드백 제공](#피드백-제공)
46-
- [기여](#기여)
47-
- [라이센스](#라이센스)
48+
- [기여하기](#기여하기)
49+
- [라이선스](#라이선스)
4850

4951
## 다운로드
5052

@@ -121,6 +123,7 @@ gh attestation verify <패키지 파일 경로> --repository seladb/PcapPlusPlus
121123
- __멀티 플랫폼 지원__: Linux, MacOS, Windows, Android 및 FreeBSD에서 완전 지원
122124
- __패킷 재조합__: __TCP 재조합__ 및 __IP 단편화와 재조합__ [[더 알아보기](https://pcapplusplus.github.io/docs/features#packet-reassembly)]
123125
- __패킷 필터링__: libpcap의 BPF 필터를 더 간편하게 사용 [[더 알아보기](https://pcapplusplus.github.io/docs/features#packet-filtering)]
126+
- __TLS 핑거프린팅__: [JA3 및 JA3S](https://github.com/salesforce/ja3) TLS 핑거프린팅의 C++ 구현 [[더 알아보기](https://pcapplusplus.github.io/docs/features#tls-fingerprinting)]
124127

125128
## 시작하기
126129

@@ -185,85 +188,91 @@ PcapPlusPlus 웹사이트의 [API 문서 섹션](https://pcapplusplus.github.io/
185188
186189
## 멀티 플랫폼 지원
187190
188-
PcapPlusPlus는 현재 __Windows__, __Linux__, __MacOS__, __Android__, __FreeBSD__에서 지원됩니다. PcapPlusPlus 웹사이트에서 [지원 플랫폼](https://pcapplusplus.github.io/docs/platforms) 전체 목록을 확인할 수 있으며, [다운로드](#download) 섹션을 참조하여 해당 플랫폼에서 PcapPlusPlus를 시작하세요.
191+
PcapPlusPlus는 현재 __Windows__, __Linux__, __MacOS__, __Android__, __FreeBSD__에서 지원됩니다. PcapPlusPlus 웹사이트에서 [지원 플랫폼](https://pcapplusplus.github.io/docs/platforms) 전체 목록을 확인할 수 있으며, [다운로드](#다운로드) 섹션을 참조하여 해당 플랫폼에서 PcapPlusPlus를 시작하세요.
189192
190193
## 지원되는 네트워크 프로토콜
191194
192195
PcapPlusPlus는 현재 다음 프로토콜의 패킷을 파싱, 편집 및 생성할 수 있습니다:
193196
194197
### 데이터 링크 계층 (L2)
195198
196-
1. Ethernet II
197-
2. IEEE 802.3 Ethernet
198-
3. LLC (BPDU만 지원)
199-
4. Null/Loopback
200-
5. Packet trailer (패킷 패딩)
201-
6. PPPoE
202-
7. SLL (Linux cooked capture)
203-
8. SLL2 (Linux cooked capture v2)
204-
9. STP
205-
10. VLAN
206-
11. VXLAN
207-
12. Wake on LAN (WoL)
208-
13. NFLOG (Linux Netfilter NFLOG) - 파싱만 가능 (편집 불가)
199+
1. Cisco HDLC
200+
2. Ethernet II
201+
3. IEEE 802.3 Ethernet
202+
4. LLC (BPDU만 지원)
203+
5. Null/Loopback
204+
6. Packet trailer (패킷 패딩)
205+
7. PPPoE
206+
8. SLL (Linux cooked capture)
207+
9. SLL2 (Linux cooked capture v2)
208+
10. STP
209+
11. VLAN
210+
12. VXLAN
211+
13. Wake on LAN (WoL)
212+
14. NFLOG (Linux Netfilter NFLOG) - 파싱만 가능 (편집 불가)
209213
210214
### 네트워크 계층 (L3)
211215
212-
14. ARP
213-
15. GRE
214-
16. ICMP
215-
17. ICMPv6
216-
18. IGMP (IGMPv1, IGMPv2, IGMPv3 지원)
217-
19. IPv4
218-
20. IPv6
219-
21. MPLS
220-
22. NDP
221-
23. Raw IP (IPv4 & IPv6)
222-
24. VRRP (IPv4 & IPv6)
223-
25. WireGuard
216+
15. ARP
217+
16. GRE
218+
17. ICMP
219+
18. ICMPv6
220+
19. IGMP (IGMPv1, IGMPv2, IGMPv3 지원)
221+
20. IPv4
222+
21. IPv6
223+
22. MPLS
224+
23. NDP
225+
24. Raw IP (IPv4 & IPv6)
226+
25. VRRP (IPv4 & IPv6)
227+
26. WireGuard
224228
225229
### 전송 계층 (L4)
226230
227-
26. COTP
228-
27. GTP (v1 & v2)
229-
28. IPSec AH & ESP - 파싱만 가능 (편집 불가)
230-
29. TCP
231-
30. TPKT
232-
31. UDP
231+
27. COTP
232+
28. GTP (v1 & v2)
233+
29. IPSec AH & ESP - 파싱만 가능 (편집 불가)
234+
30. TCP
235+
31. TPKT
236+
32. UDP
233237
234238
### 세션 계층 (L5)
235239
236-
32. SDP
237-
33. SIP
240+
33. SDP
241+
34. SIP
238242
239-
### 표현 계층 (L6)
243+
### 프레젠테이션 계층 (L6)
240244
241-
34. SSL/TLS - 파싱만 가능 (편집 불가)
245+
35. SSL/TLS - 파싱만 가능 (편집 불가)
242246
243247
### 응용 계층 (L7)
244248
245-
35. ASN.1 인코더 및 디코더
246-
36. BGP (v4)
247-
37. DHCP
248-
38. DHCPv6
249-
39. DNS
250-
40. FTP
251-
41. HTTP 헤더 (요청 및 응답)
252-
42. LDAP
253-
43. NTP (v3, v4)
254-
44. Radius
255-
45. S7 Communication (S7comm)
256-
46. SMTP
257-
47. SOME/IP
258-
48. SSH - 파싱만 가능 (편집 불가)
259-
49. Telnet - 파싱만 가능 (편집 불가)
260-
50. 일반 페이로드
249+
36. ASN.1 인코더 및 디코더
250+
37. BGP (v4)
251+
38. 암호화 키 디코더
252+
39. DHCP
253+
40. DHCPv6
254+
41. DNS
255+
42. DoIP
256+
43. FTP
257+
44. HTTP 헤더 (요청 및 응답)
258+
45. LDAP
259+
46. Modbus
260+
47. NTP (v3, v4)
261+
48. PEM 인코더 및 디코더
262+
49. Radius
263+
50. S7 Communication (S7comm)
264+
51. SMTP
265+
52. SOME/IP
266+
53. SSH - 파싱만 가능 (편집 불가)
267+
54. Telnet - 파싱만 가능 (편집 불가)
268+
55. X509 인증서 - 파싱만 가능 (편집 불가)
269+
56. 일반 페이로드
261270
262271
## DPDK 및 PF_RING 지원
263272
264273
[DPDK](https://www.dpdk.org/)는 빠른 패킷 처리를 위한 데이터 플레인 라이브러리 세트이며, [PF_RING™](https://www.ntop.org/products/packet-capture/pf_ring/)은 패킷 캡처 속도를 대폭 향상시키는 새로운 유형의 네트워크 소켓입니다. PcapPlusPlus는 DPDK 및 PF_RING에 대한 C++ 추상화 계층을 제공합니다. 자세한 내용은 PcapPlusPlus 웹사이트의 [DPDK](https://pcapplusplus.github.io/docs/dpdk) 및 [PF_RING](https://pcapplusplus.github.io/docs/features#pf_ring-support) 지원 페이지에서 확인하세요.
265274
266-
## 성능 벤치마크
275+
## 벤치마크
267276
268277
PcapPlusPlus는 다른 C++ 라이브러리(`libtins`, `libcrafter` 등)와 성능을 비교하기 위해 Matias Fontanini의 [packet-capture-benchmarks](https://github.com/mfontanini/packet-capture-benchmarks) 프로젝트를 사용했습니다. 성능 결과는 PcapPlusPlus 웹사이트의 [벤치마크](https://pcapplusplus.github.io/docs/benchmark) 페이지에서 확인할 수 있습니다.
269278

‎translation/README-zh-tw.md‎

Lines changed: 68 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
> ⚠️ **注意：** 本翻譯由 AI 協助維護與同步，可能與最新的英文版本存在差異。若您發現任何錯誤，歡迎開立 GitHub issue 或提交 PR。
2+
13
<div align="center">
24

35
[![PcapPlusPlus 標誌](https://pcapplusplus.github.io/img/logo/logo_color.png)](https://pcapplusplus.github.io)
@@ -24,23 +26,23 @@ PcapPlusPlus 支援對多種網路協議進行解析和建構，並對常見的
2426
- [目錄](#目錄)
2527
- [下載](#下載)
2628
- [GitHub 發佈頁面](#github-發佈頁面)
27-
- [Homebrew](#Homebrew)
29+
- [Homebrew](#homebrew)
2830
- [Vcpkg](#vcpkg)
2931
- [Conan](#conan)
30-
- [自行建置](#自行建置])
32+
- [自行建置](#自行建置)
3133
- [驗證您的套件](#驗證您的套件)
3234
- [功能概述](#功能概述)
3335
- [快速入門](#快速入門)
3436
- [API 文件](#api-文件)
3537
- [跨平台支援](#跨平台支援)
3638
- [支援的網路協定](#支援的網路協定)
37-
- [資料連接層 (L2)](#資料鏈路層-l2)
39+
- [資料連接層 (L2)](#資料連接層-l2)
3840
- [網路層 (L3)](#網路層-l3)
3941
- [傳輸層 (L4)](#傳輸層-l4)
4042
- [對話層 (L5)](#對話層-l5)
41-
- [表現層 (L6)](#表現層-l6)
43+
- [表示層 (L6)](#表示層-l6)
4244
- [應用層 (L7)](#應用層-l7)
43-
- [DPDK 與 PF_RING 支援](#dpdk-和-pf_ring-支援)
45+
- [DPDK 和 PF_RING 支援](#dpdk-和-pf_ring-支援)
4446
- [基準測試](#基準測試)
4547
- [提供回饋](#提供回饋)
4648
- [貢獻](#貢獻)
@@ -68,22 +70,21 @@ Homebrew 套件頁面: <https://formulae.brew.sh/formula/pcapplusplus>
6870

6971
Windows:
7072

71-
```shell
73+
```text
7274
.\vcpkg install pcapplusplus
7375
```
7476

7577
MacOS/Linux:
7678

77-
```shell
79+
```text
7880
vcpkg install pcapplusplus
7981
```
8082

8183
Vcpkg 套件頁面: <https://github.com/microsoft/vcpkg/tree/master/ports/pcapplusplus>
8284

83-
8485
### Conan
8586

86-
```shell
87+
```text
8788
conan install "pcapplusplus/[>0]@" -u
8889
```
8990

@@ -183,7 +184,7 @@ PcapPlusPlus 包含三個函式庫：
183184
2. __Pcap++__ - 用於攔截和發送封包、提供網路和網卡資訊、統計等功能的函式庫。實際上是對封包擷取引擎（如 libpcap、WinPcap、Npcap、DPDK 和 PF_RING）的 C++ 封裝
184185
3. __Common++__ - 包含 Packet++ 和 Pcap++ 共用的一些通用程式碼工具函式庫
185186
186-
您可以在 PcapPlusPlus 網站的 [API 文件區](https://pcapplusplus.github.io/docs/api) 找到詳細的 API 文件。如果您發現有任何遺漏的資料，請[聯繫我們](#provide-feedback)。
187+
您可以在 PcapPlusPlus 網站的 [API 文件區](https://pcapplusplus.github.io/docs/api) 找到詳細的 API 文件。如果您發現有任何遺漏的資料，請[聯繫我們](#提供回饋)。
187188
188189
## 跨平台支援
189190
@@ -208,79 +209,85 @@ __FreeBSD__
208209
<picture>
209210
<img src="https://github.com/PcapPlusPlus/pcapplusplus.github.io/raw/master/static/img/os-logos/logo-freebsd.png" alt="" width="16" height="16"/>
210211
</picture>。
211-
請訪問 PcapPlusPlus 網站查看所有[支援的平台](https://pcapplusplus.github.io/docs/platforms)，並參考[下載](#download)區開始在您的平台上使用 PcapPlusPlus。
212+
請訪問 PcapPlusPlus 網站查看所有[支援的平台](https://pcapplusplus.github.io/docs/platforms)，並參考[下載](#下載)區開始在您的平台上使用 PcapPlusPlus。
212213
213214
## 支援的網路協定
214215
215216
PcapPlusPlus 目前支援解析、編輯和建構以下網路協定的封包：
216217
217218
### 資料連接層 (L2)
218219
219-
1. Ethernet II
220-
2. IEEE 802.3 Ethernet
221-
3. LLC（僅支援 BPDU）
222-
4. Null/Loopback
223-
5. Packet trailer（又稱 footer 或 padding）
224-
6. PPPoE
225-
7. SLL（Linux 擷取協定）
226-
8. SLL2（Linux 擷取協定 v2）
227-
9. STP
228-
10. VLAN
229-
11. VXLAN
230-
12. Wake on LAN (WoL)
231-
13. NFLOG（Linux Netfilter NFLOG）- 僅支援解析（不支援編輯）
220+
1. Cisco HDLC
221+
2. Ethernet II
222+
3. IEEE 802.3 Ethernet
223+
4. LLC（僅支援 BPDU）
224+
5. Null/Loopback
225+
6. Packet trailer（又稱 footer 或 padding）
226+
7. PPPoE
227+
8. SLL（Linux 擷取協定）
228+
9. SLL2（Linux 擷取協定 v2）
229+
10. STP
230+
11. VLAN
231+
12. VXLAN
232+
13. Wake on LAN (WoL)
233+
14. NFLOG（Linux Netfilter NFLOG）- 僅支援解析（不支援編輯）
232234
233235
### 網路層 (L3)
234236
235-
14. ARP
236-
15. GRE
237-
16. ICMP
238-
17. ICMPv6
239-
18. IGMP（支援 IGMPv1、IGMPv2 和 IGMPv3）
240-
19. IPv4
241-
20. IPv6
242-
21. MPLS
243-
22. NDP
244-
23. Raw IP（IPv4 和 IPv6）
245-
24. VRRP（IPv4 和 IPv6）
246-
25. WireGuard
237+
15. ARP
238+
16. GRE
239+
17. ICMP
240+
18. ICMPv6
241+
19. IGMP（支援 IGMPv1、IGMPv2 和 IGMPv3）
242+
20. IPv4
243+
21. IPv6
244+
22. MPLS
245+
23. NDP
246+
24. Raw IP（IPv4 和 IPv6）
247+
25. VRRP（IPv4 和 IPv6）
248+
26. WireGuard
247249
248250
### 傳輸層 (L4)
249251
250-
26. COTP
251-
27. GTP (v1 & v2)
252-
28. IPSec AH 和 ESP - 僅支援解析（不支援編輯）
253-
29. TCP
254-
30. TPKT
255-
31. UDP
252+
27. COTP
253+
28. GTP (v1 & v2)
254+
29. IPSec AH 和 ESP - 僅支援解析（不支援編輯）
255+
30. TCP
256+
31. TPKT
257+
32. UDP
256258
257259
### 對話層 (L5)
258260
259-
32. SDP
260-
33. SIP
261+
33. SDP
262+
34. SIP
261263
262264
### 表示層 (L6)
263265
264-
34. SSL/TLS - 僅支援解析（不支援編輯）
266+
35. SSL/TLS - 僅支援解析（不支援編輯）
265267
266268
### 應用層 (L7)
267269
268-
35. ASN.1 編碼器與解碼器
269-
36. BGP (v4)
270-
37. DHCP
271-
38. DHCPv6
272-
39. DNS
273-
40. FTP
274-
41. HTTP 標頭（請求和響應）
275-
42. LDAP
276-
43. NTP (v3, v4)
277-
44. Radius
278-
45. S7 通訊（S7comm）
279-
46. SMTP
280-
47. SOME/IP
281-
48. SSH - 僅支援解析（不支援編輯）
282-
49. Telnet - 僅支援解析（不支援編輯）
283-
50. 通用酬載（Generic Payload）
270+
36. ASN.1 編碼器與解碼器
271+
37. BGP (v4)
272+
38. 加密金鑰解碼器
273+
39. DHCP
274+
40. DHCPv6
275+
41. DNS
276+
42. DoIP
277+
43. FTP
278+
44. HTTP 標頭（請求和響應）
279+
45. LDAP
280+
46. Modbus
281+
47. NTP (v3, v4)
282+
48. PEM 編碼器與解碼器
283+
49. Radius
284+
50. S7 通訊（S7comm）
285+
51. SMTP
286+
52. SOME/IP
287+
53. SSH - 僅支援解析（不支援編輯）
288+
54. Telnet - 僅支援解析（不支援編輯）
289+
55. X509 憑證 - 僅支援解析（不支援編輯）
290+
56. 通用酬載（Generic Payload）
284291
285292
## DPDK 和 PF_RING 支援
286293

0 commit comments

Comments
 (0)