refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
@@ -14,11 +14,11 @@
"long_description": "위에서 아래로 읽는다. 맨 위 Guest Userspace 구역에 PostgreSQL / Keycloak 이 있고 write() 가 게스트 커널로 내려간다. Guest Kernel 구역 안에서 VFS 가 먼저 받고, ext4 / XFS 가 파일을 block 공간에 배치하고, Guest Page Cache 가 그 내용을 dirty page 로 받아 두었다가 writeback 으로 Guest Block Layer 에 내려보낸다. Guest Block Layer 는 그것을 WRITE 나 FLUSH 요청으로 바꿔 /dev/vda 에 걸고, virtio-blk Frontend 가 그 요청을 virtqueue 에 게시한다. virtqueue 아래의 VM Boundary 부터는 QEMU 와 호스트 계층이라 이 그림에서 잘랐다. 완료가 같은 virtqueue 로 되돌아오는 역방향은 SSOT 의 다른 절이 대는 사실이라 이 그림에 넣지 않았고 본문 문단이 맡는다.",
"source_context": {
"document": "docs/virtualization/final/document.md",
"document_sha256": "181e2b3cc8a45bae81e7e8193d026937c4d586ae4495d3b2c323eb7e6abcfadd",
"document_sha256": "8c4ecc64c8cea9a4450ed7131fdd9cb2048dc092b66cd969f6346ed77887c210",
"anchor": {
"kind": "heading",
"value": "128. 전체 구조",
"line": 5804
"line": 5817
}
},
"composition": {
@@ -38,8 +38,8 @@
"description": "게스트 사용자 공간. 저장장치를 직접 다루지 않는다.",
"evidence": [
{
"start_line": 5807,
"end_line": 5809
"start_line": 5820,
"end_line": 5822
}
],
"assumption": false
@@ -51,8 +51,8 @@
"description": "게스트 커널 공간. VM Boundary 위쪽 계층이 전부 여기 있다.",
"evidence": [
{
"start_line": 5815,
"end_line": 5833
"start_line": 5828,
"end_line": 5846
}
],
"assumption": false
@@ -69,16 +69,16 @@
"description": "파일 연산을 요청하는 게스트 프로세스.",
"evidence": [
{
"start_line": 5807,
"end_line": 5809
"start_line": 5820,
"end_line": 5822
},
{
"start_line": 5885,
"end_line": 5885
"start_line": 5898,
"end_line": 5898
},
{
"start_line": 5811,
"end_line": 5813
"start_line": 5824,
"end_line": 5826
}
],
"assumption": false,
@@ -97,12 +97,12 @@
"description": "열린 파일이 어느 filesystem 구현에 속하는지 보고 연산을 넘기는 공통 계층.",
"evidence": [
{
"start_line": 5815,
"end_line": 5817
"start_line": 5828,
"end_line": 5830
},
{
"start_line": 5905,
"end_line": 5905
"start_line": 5918,
"end_line": 5918
}
],
"assumption": false
@@ -117,8 +117,8 @@
"description": "파일과 디렉터리를 block 공간에 배치하는 게스트 filesystem.",
"evidence": [
{
"start_line": 5819,
"end_line": 5819
"start_line": 5832,
"end_line": 5832
}
],
"assumption": false
@@ -133,8 +133,8 @@
"description": "게스트 RAM 에 있는 cache. write() 가 성공해도 데이터는 아직 여기까지만 확정된다.",
"evidence": [
{
"start_line": 5821,
"end_line": 5821
"start_line": 5834,
"end_line": 5834
}
],
"assumption": false
@@ -149,8 +149,8 @@
"description": "파일 세계의 요청을 block device 세계의 요청으로 바꾸는 계층.",
"evidence": [
{
"start_line": 5825,
"end_line": 5825
"start_line": 5838,
"end_line": 5838
}
],
"assumption": false
@@ -165,12 +165,12 @@
"description": "게스트 Linux 가 하나의 block device 로 인식하는 이름.",
"evidence": [
{
"start_line": 5829,
"end_line": 5829
"start_line": 5842,
"end_line": 5842
},
{
"start_line": 5879,
"end_line": 5879
"start_line": 5892,
"end_line": 5892
}
],
"assumption": false
@@ -185,12 +185,12 @@
"description": "그 가상 block device 를 제어하는 게스트 커널 driver.",
"evidence": [
{
"start_line": 5831,
"end_line": 5831
"start_line": 5844,
"end_line": 5844
},
{
"start_line": 5789,
"end_line": 5789
"start_line": 5802,
"end_line": 5802
}
],
"assumption": false
@@ -206,8 +206,8 @@
"description": "요청이 실리는 자리. 바로 아래가 VM Boundary 다.",
"evidence": [
{
"start_line": 5833,
"end_line": 5835
"start_line": 5846,
"end_line": 5848
}
],
"assumption": false
@@ -224,12 +224,12 @@
"order": 1,
"evidence": [
{
"start_line": 5811,
"end_line": 5813
"start_line": 5824,
"end_line": 5826
},
{
"start_line": 5890,
"end_line": 5890
"start_line": 5903,
"end_line": 5903
}
],
"assumption": false
@@ -244,8 +244,8 @@
"order": 2,
"evidence": [
{
"start_line": 5817,
"end_line": 5819
"start_line": 5830,
"end_line": 5832
}
],
"assumption": false
@@ -260,8 +260,8 @@
"order": 3,
"evidence": [
{
"start_line": 5819,
"end_line": 5821
"start_line": 5832,
"end_line": 5834
}
],
"assumption": false
@@ -276,8 +276,8 @@
"order": 4,
"evidence": [
{
"start_line": 5823,
"end_line": 5825
"start_line": 5836,
"end_line": 5838
}
],
"assumption": false
@@ -292,8 +292,8 @@
"order": 5,
"evidence": [
{
"start_line": 5827,
"end_line": 5829
"start_line": 5840,
"end_line": 5842
}
],
"assumption": false
@@ -308,8 +308,8 @@
"order": 6,
"evidence": [
{
"start_line": 5829,
"end_line": 5831
"start_line": 5842,
"end_line": 5844
}
],
"assumption": false
@@ -324,8 +324,8 @@
"order": 7,
"evidence": [
{
"start_line": 5831,
"end_line": 5833
"start_line": 5844,
"end_line": 5846
}
],
"assumption": false