요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
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: xen-devel@lists.xenproject.org
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: xen-devel@lists.xenproject.org
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Guest PCI configuration-register quirks
1-16| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/pci/drivers/pciback/quirks |
| Date | 2011년 10월 |
| KernelVersion | 3.1 |
| Contact | xen-devel@lists.xenproject.org |
| 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 | xen-devel@lists.xenproject.org |
| 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를 읽고 쓸 수 있습니다.