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
@@ -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