aboutsummaryrefslogtreecommitdiffstats
path: root/docs/research/058-portable-authenticated-peer-check.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/research/058-portable-authenticated-peer-check.md')
-rw-r--r--docs/research/058-portable-authenticated-peer-check.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/docs/research/058-portable-authenticated-peer-check.md b/docs/research/058-portable-authenticated-peer-check.md
new file mode 100644
index 0000000..0928468
--- /dev/null
+++ b/docs/research/058-portable-authenticated-peer-check.md
@@ -0,0 +1,38 @@
+# 058 — 선택형 인증 피어의 휴대형 실작업 검사
+
+첫 공개 체크포인트에서는 Pure 간 연결이 같은 앱 정의와 문서 작업을 실제로
+교환해야 한다. 기존 인증 피어 검사는 서버의 `/proc` RSS를 읽어 Linux 외
+환경에서 시작할 수 없었다. `check-portable-peer`는 그 수집만 제외하고
+같은 TLS 클라이언트·서버 작업을 실행한다. 실행 코어와 C 피어 코드는
+변경하지 않았고, TLS는 여전히 선택한 빌드에만 링크된다.
+
+```sh
+make -C prototypes/connections check-portable-peer
+```
+
+OpenSSL 헤더·라이브러리·명령행 도구와 Python 3가 필요하다. 검사기는 임시
+인증서를 만들고 실제 루프백 소켓에서 상호 인증, 서버 이름·ALPN·앱 소스 해시
+불일치, C 피어와 외부 Python 클라이언트의 문서 읽기·편집·충돌·복구, 조각난
+1 MiB 요청, 잘못된 프레임, 연결 기한, 서버 재시작 후 복원을 확인한다.
+
+| Linux AArch64 실제 실행 | 결과 |
+|---|---|
+| [범용 피어 휴대형 검사](../../prototypes/connections/results/2026-09-24-portable-peer/client-server-linux-aarch64.json) | 9개 실작업 시나리오 통과, RSS 미수집 |
+| [서버 전용 휴대형 검사](../../prototypes/connections/results/2026-09-24-portable-peer/server-only-linux-aarch64.json) | 같은 9개 시나리오 통과, RSS 미수집 |
+| [범용 피어 Linux 회귀](../../prototypes/connections/results/2026-09-24-portable-peer/client-server-linux-rss-regression.json), [코드 경계](../../prototypes/connections/results/2026-09-24-portable-peer/client-server-profile.json) | `text` 46,934 B, 유휴 7,968 KiB·1 MiB 작업 후 9,712 KiB RSS |
+| [서버 전용 Linux 회귀](../../prototypes/connections/results/2026-09-24-portable-peer/server-only-linux-rss-regression.json), [코드 경계](../../prototypes/connections/results/2026-09-24-portable-peer/server-only-profile.json) | `text` 43,462 B, 유휴 7,968 KiB·1 MiB 작업 후 9,712 KiB RSS |
+
+새 [소스 묶음](../../prototypes/connections/results/2026-09-24-portable-peer-source/pure-source-preview.tar.gz)은
+165개 파일, 압축 321,958 B이며 SHA-256은
+`bf51f79c400f820b48dbf78522449cda6625563ce860809e86d76a8023377dbb`다.
+[이동 후 검사](../../prototypes/connections/results/2026-09-24-portable-peer-source/source-check-linux-aarch64.json)는
+manifest 해시·C 동작·두 TUI의 실제 PTY 작업·변경된 `.pure` 결과·선택형
+TLS 두 서버·Linux 릴리스 크기와 RSS 상한을 깨끗한 디렉터리에서 통과했다.
+압축 소스 묶음 크기는 실행 중 메모리가 아니다. TLS 서버의 위 RSS에는
+선택한 OpenSSL 공유 라이브러리와 실제 작업 비용이 포함되며, 기본 실행
+코어의 크기를 대신하지도 않는다.
+
+Apple Silicon macOS에서 이 명령을 컴파일하거나 실행한 증거는 아직 없다.
+특히 macOS의 OpenSSL 헤더·라이브러리 경로와 저장소 디렉터리 동기화는
+별도 검증이 필요하다. 휴대형 결과의 RSS 필드는 `null`이며 Linux 메모리
+측정을 대체하지 않는다.