← Documents Documentation/ABI/testing/debugfs-vfio GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

VFIO device migration debugfs ABI

VFIO core의 공통 device debugfs directory와 live migration 지원 device의 migration state·features 조회 경로를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-vfio
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

VFIO core와 migration directories

debugfs-vfio:1-17

/sys/kernel/debug/vfio는 모든 VFIO device의 공통 root이며 VFIO core가 device subdirectory를 만듭니다. Live migration 지원 device는 그 아래 migration directory를 사용합니다.

Migration state와 features

debugfs-vfio:19-31

state는 vfio_device_mig_state enum에 대응하는 live migration 상태를, features는 VFIO device의 migration 기능을 읽어 제공합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/kernel/debug/vfio
2 Date: December 2023
3 KernelVersion: 6.8
4 Contact: Longfang Liu <[email protected]>
5 Description: This debugfs file directory is used for debugging
6 of vfio devices, it's a common directory for all vfio devices.
7 Vfio core will create a device subdirectory under this
8 directory.
9
10 What: /sys/kernel/debug/vfio/<device>/migration
11 Date: December 2023
12 KernelVersion: 6.8
13 Contact: Longfang Liu <[email protected]>
14 Description: This debugfs file directory is used for debugging
15 of vfio devices that support live migration.
16 The debugfs of each vfio device that supports live migration
17 could be created under this directory.
18
19 What: /sys/kernel/debug/vfio/<device>/migration/state
20 Date: December 2023
21 KernelVersion: 6.8
22 Contact: Longfang Liu <[email protected]>
23 Description: Read the live migration status of the vfio device.
24 The contents of the state file reflects the migration state
25 relative to those defined in the vfio_device_mig_state enum
26
27 What: /sys/kernel/debug/vfio/<device>/migration/features
28 Date: Oct 2025
29 KernelVersion: 6.18
30 Contact: Cédric Le Goater <[email protected]>
31 Description: Read the migration features of the vfio device.
32

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

VFIO debugfs directory 계층

1-17
What전문 번역
/sys/kernel/debug/vfio이 debugfs file directory는 VFIO device를 debugging하는 데 사용하며 모든 VFIO device의 공통 directory입니다. VFIO core는 이 directory 아래에 device subdirectory를 만듭니다.
/sys/kernel/debug/vfio/<device>/migration이 debugfs file directory는 live migration을 지원하는 VFIO device를 debugging하는 데 사용합니다. Live migration을 지원하는 각 VFIO device의 debugfs를 이 directory 아래에 만들 수 있습니다.
공통 항목내용
Date2023년 12월
KernelVersion6.8
ContactLongfang Liu <[email protected]>

VFIO live migration state와 features

19-31
항목StateFeatures
What/sys/kernel/debug/vfio/<device>/migration/state/sys/kernel/debug/vfio/<device>/migration/features
Date2023년 12월2025년 10월
KernelVersion6.86.18
ContactLongfang Liu <[email protected]>Cédric Le Goater <[email protected]>
DescriptionVFIO device의 live migration status를 읽습니다. State file 내용은 vfio_device_mig_state enum에 정의된 migration state에 대응합니다.VFIO device의 migration features를 읽습니다.
VFIO live migration debugfs hierarchy
/sys/kernel/debug/vfio<device>migrationstatevfio_device_mig_state value
/sys/kernel/debug/vfio<device>migrationfeaturesMigration feature set

VFIO core가 공통 root 아래 device를 만들고 live-migration-capable device만 migration subtree의 상태와 기능을 노출한다.