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
@@ -10,23 +10,23 @@
## Elements and evidence
- **QEMU** (service): KVM 핸들을 열고 VM 과 vCPU 를 만드는 유저공간 프로세스. vcpu ioctl 은 그 vcpu 를 만든 스레드에서 낸다. Evidence: L1102L1108.
- **VFIO** (service): IOMMU 보호 아래 장치 접근을 유저공간에 여는 프레임워크. 소유 단위가 IOMMU 그룹이다. Evidence: L1131L1146.
- **물리 PCI 장치** (service): 호스트 드라이버에서 떼어 vfio-pci 에 묶은 장치. Evidence: L1131L1133, L1144L1146.
- **IOMMU** (service): 장치가 아무 메모리나 건드리지 못하게 막는 리매핑 장치. Evidence: L1144L1146.
- **KVM** (service): mmap 한 공유 메모리로 나온 이유를 유저공간에 알리는 커널 쪽. Evidence: L1105L1108.
- **물리 CPU** (service): VM entry 때 guest-state 영역에서 상태를 싣고 VM exit 때 그리로 저장하는 프로세서. Evidence: L1111L1113.
- **게스트 코드** (service): VMX non-root 로 물리 CPU 에서 도는 게스트 명령. Evidence: L1111L1113.
- **게스트 virtio 드라이버** (service): 게스트가 보는 반가상화 장치의 드라이버. 주고받는 통로가 virtqueue 다. Evidence: L1116L1118.
- **vhost** (service): virtqueue 를 QEMU 밖과 나누는 커널 구현. vhost-user 규약이 이것을 제어하는 ioctl 인터페이스를 보완한다. Evidence: L1125L1129.
- **QEMU** (service): KVM 핸들을 열고 VM 과 vCPU 를 만드는 유저공간 프로세스. vcpu ioctl 은 그 vcpu 를 만든 스레드에서 낸다. Evidence: L3441L3447.
- **VFIO** (service): IOMMU 보호 아래 장치 접근을 유저공간에 여는 프레임워크. 소유 단위가 IOMMU 그룹이다. Evidence: L3470L3485.
- **물리 PCI 장치** (service): 호스트 드라이버에서 떼어 vfio-pci 에 묶은 장치. Evidence: L3470L3472, L3483L3485.
- **IOMMU** (service): 장치가 아무 메모리나 건드리지 못하게 막는 리매핑 장치. Evidence: L3483L3485.
- **KVM** (service): mmap 한 공유 메모리로 나온 이유를 유저공간에 알리는 커널 쪽. Evidence: L3444L3447.
- **물리 CPU** (service): VM entry 때 guest-state 영역에서 상태를 싣고 VM exit 때 그리로 저장하는 프로세서. Evidence: L3450L3452.
- **게스트 코드** (service): VMX non-root 로 물리 CPU 에서 도는 게스트 명령. Evidence: L3450L3452.
- **게스트 virtio 드라이버** (service): 게스트가 보는 반가상화 장치의 드라이버. 주고받는 통로가 virtqueue 다. Evidence: L3455L3457.
- **vhost** (service): virtqueue 를 QEMU 밖과 나누는 커널 구현. vhost-user 규약이 이것을 제어하는 ioctl 인터페이스를 보완한다. Evidence: L3464L3468.
## Relationships
- **물리 CPU → 게스트 코드:** VMX non-root. Evidence: L1111L1112.
- **물리 PCI 장치 → IOMMU:** DMA. Evidence: L1144L1146.
- **KVM → 물리 CPU:** VM entry. Evidence: L1111L1112.
- **QEMU → VFIO:** 장치 fd. Evidence: L1138L1141.
- **QEMU → KVM:** KVM_RUN. Evidence: L1104L1106.
- **QEMU → vhost:** 제어 ioctl. Evidence: L1125L1129.
- **QEMU → 게스트 virtio 드라이버:** virtqueue. Evidence: L1116L1118, L1128L1128.
- **VFIO → 물리 PCI 장치:** vfio-pci 결합. Evidence: L1144L1146.
- **물리 CPU → 게스트 코드:** VMX non-root. Evidence: L3450L3451.
- **물리 PCI 장치 → IOMMU:** DMA. Evidence: L3483L3485.
- **KVM → 물리 CPU:** VM entry. Evidence: L3450L3451.
- **QEMU → VFIO:** 장치 fd. Evidence: L3477L3480.
- **QEMU → KVM:** KVM_RUN. Evidence: L3443L3445.
- **QEMU → vhost:** 제어 ioctl. Evidence: L3464L3468.
- **QEMU → 게스트 virtio 드라이버:** virtqueue. Evidence: L3455L3457, L3467L3467.
- **VFIO → 물리 PCI 장치:** vfio-pci 결합. Evidence: L3483L3485.