요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
Interrupt-control device allowlist
sysfs-driver-pciback:17-28INTx·MSI·MSI-X control은 HVM에 실제 device를 배정한 stubdomain qemu용으로만 허용해야 하며 PV guest에는 안전하지 않습니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
1
What: /sys/bus/pci/drivers/pciback/quirks
2
Date: Oct 2011
3
KernelVersion: 3.1
4
Contact: [email protected]
5
Description:
6
If the permissive attribute is set, then writing a string in
7
the format of DDDD:BB:DD.F-REG:SIZE:MASK will allow the guest
8
to write and read from the PCI device. That is Domain:Bus:
9
Device.Function-Register:Size:Mask (Domain is optional).
10
For example::
12
#echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirks
14
will allow the guest to read and write to the configuration
15
register 0x0E.
17
What: /sys/bus/pci/drivers/pciback/allow_interrupt_control
18
Date: Jan 2020
19
KernelVersion: 5.6
20
Contact: [email protected]
21
Description:
22
List of devices which can have interrupt control flag (INTx,
23
MSI, MSI-X) set by a connected guest. It is meant to be set
24
only when the guest is a stubdomain hosting device model (qemu)
25
and the actual device is assigned to a HVM. It is not safe
26
(similar to permissive attribute) to set for a devices assigned
27
to a PV guest. The device is automatically removed from this
28
list when the connected pcifront terminates.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
Guest PCI configuration-register quirks
1-16| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/drivers/pciback/quirks |
| Date | 2011년 10월 |
| KernelVersion | 3.1 |
| Contact | [email protected] |
| Description | permissive attribute가 설정된 경우 DDDD:BB:DD.F-REG:SIZE:MASK 형식의 string을 쓰면 guest가 해당 PCI device를 읽고 쓸 수 있습니다. 각 field는 Domain:Bus:Device.Function-Register:Size:Mask이며 Domain은 생략할 수 있습니다. 아래 example은 guest가 configuration register 0x0E를 읽고 쓰도록 허용합니다. |
#echo 00:19.0-E0:2:FF > /sys/bus/pci/drivers/pciback/quirksFieldMeaning
DDDDPCI Domain; optional
BBBus
DD.FDevice.Function
REGConfiguration register
SIZERegister access size
MASKAllowed bits
Guest configuration-space access rule의 각 field를 분리했습니다.
Guest interrupt-control allowlist
17-28| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/drivers/pciback/allow_interrupt_control |
| Date | 2020년 1월 |
| KernelVersion | 5.6 |
| Contact | [email protected] |
| Description | Connected guest가 interrupt control flag(INTx, MSI, MSI-X)를 설정할 수 있는 devices의 list입니다. Guest가 device model(qemu)을 host하는 stubdomain이고 실제 device가 HVM에 assign된 경우에만 설정하기 위한 것입니다. permissive attribute와 마찬가지로 PV guest에 assign된 device에는 설정해도 안전하지 않습니다. Connected pcifront가 terminate하면 device는 이 list에서 자동으로 제거됩니다. |
Permissive PCI register quirks
sysfs-driver-pciback:1-16permissive mode에서 DDDD:BB:DD.F-REG:SIZE:MASK 형식을 쓰면 guest가 지정 PCI configuration register를 읽고 쓸 수 있습니다.