← Documents Documentation/ABI/testing/sysfs-bus-css GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

s390 channel subsystem sysfs ABI

s390 channel subsystem의 subchannel type·modalias, I/O channel paths와 PIM/PAM/POM masks, 제한된 driver override binding 규칙을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-bus-css
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Subchannel type과 module alias

sysfs-bus-css:1-12

모든 subchannel types에 hardware-reported type과 css:t<type> 형식의 uevent module alias를 제공합니다.

I/O subchannel path IDs

sysfs-bus-css:14-22

chpids는 subchannel recognition 중 channel subsystem이 보고한, 해당 I/O subchannel이 사용하는 channel path IDs를 제공합니다.

PIM, PAM과 POM values

sysfs-bus-css:24-33

pimpampom은 common I/O layer가 마지막으로 조회했을 때 보고된 PIM/PAM/POM values이며 현재 channel-subsystem 상태와 일치하지 않을 수 있습니다.

Driver override binding

sysfs-bus-css:35-56

driver_override는 단일 driver name으로 binding 후보를 제한하지만 자동 unbind·module load는 하지 않으며 device subchannel type의 기본 matching rule도 우회하지 않습니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/bus/css/devices/.../type
2 Date: March 2008
4 Description: Contains the subchannel type, as reported by the hardware.
5 This attribute is present for all subchannel types.
6
7 What: /sys/bus/css/devices/.../modalias
8 Date: March 2008
10 Description: Contains the module alias as reported with uevents.
11 It is of the format css:t<type> and present for all
12 subchannel types.
13
14 What: /sys/bus/css/drivers/io_subchannel/.../chpids
15 Date: December 2002
17 Description: Contains the ids of the channel paths used by this
18 subchannel, as reported by the channel subsystem
19 during subchannel recognition.
20
21 Note: This is an I/O-subchannel specific attribute.
22 Users: s390-tools, HAL
23
24 What: /sys/bus/css/drivers/io_subchannel/.../pimpampom
25 Date: December 2002
27 Description: Contains the PIM/PAM/POM values, as reported by the
28 channel subsystem when last queried by the common I/O
29 layer (this implies that this attribute is not necessarily
30 in sync with the values current in the channel subsystem).
31
32 Note: This is an I/O-subchannel specific attribute.
33 Users: s390-tools, HAL
34
35 What: /sys/bus/css/devices/.../driver_override
36 Date: June 2019
38 Description: This file allows the driver for a device to be specified. When
39 specified, only a driver with a name matching the value written
40 to driver_override will have an opportunity to bind to the
41 device. The override is specified by writing a string to the
42 driver_override file (echo vfio-ccw > driver_override) and
43 may be cleared with an empty string (echo > driver_override).
44 This returns the device to standard matching rules binding.
45 Writing to driver_override does not automatically unbind the
46 device from its current driver or make any attempt to
47 automatically load the specified driver. If no driver with a
48 matching name is currently loaded in the kernel, the device
49 will not bind to any driver. This also allows devices to
50 opt-out of driver binding using a driver_override name such as
51 "none". Only a single driver may be specified in the override,
52 there is no support for parsing delimiters.
53
54 Note that unlike the mechanism of the same name for pci, this
55 file does not allow to override basic matching rules. I.e.,
56 the driver must still match the subchannel type of the device.
57

3. 한국어 전문 번역

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

Subchannel identity

1-12
WhatDate / Contact전문 번역
/sys/bus/css/devices/.../type2008년 3월 / [email protected]Hardware가 보고한 subchannel type을 포함합니다. 이 attribute는 모든 subchannel types에 존재합니다.
/sys/bus/css/devices/.../modalias2008년 3월 / [email protected]Uevents와 함께 보고되는 module alias를 포함합니다. 형식은 css:t<type>이며 모든 subchannel types에 존재합니다.

I/O subchannel channel-path IDs

14-22
항목전문 번역
What/sys/bus/css/drivers/io_subchannel/.../chpids
Date2002년 12월
Contact[email protected]
DescriptionSubchannel recognition 중 channel subsystem이 보고한, 이 subchannel에서 사용하는 channel paths의 IDs를 포함합니다. I/O-subchannel 전용 attribute입니다.
Userss390-tools, HAL

I/O subchannel PIM/PAM/POM

24-33
항목전문 번역
What/sys/bus/css/drivers/io_subchannel/.../pimpampom
Date2002년 12월
Contact[email protected]
DescriptionCommon I/O layer가 마지막으로 조회했을 때 channel subsystem이 보고한 PIM/PAM/POM values를 포함합니다. 따라서 이 attribute가 channel subsystem의 현재 values와 반드시 동기화되어 있지는 않습니다. I/O-subchannel 전용 attribute입니다.
Userss390-tools, HAL

CSS driver override rules

35-56
항목전문 번역
What/sys/bus/css/devices/.../driver_override
Date2019년 6월
Contact[email protected]
Description이 file은 device에 사용할 driver를 지정할 수 있게 합니다. 값을 지정하면 driver_override에 쓴 값과 이름이 일치하는 driver만 device에 bind할 기회를 얻습니다. driver_override에 문자열을 써서 override를 지정하고 빈 문자열을 써서 해제할 수 있으며, 해제하면 device는 표준 matching rules binding으로 돌아갑니다. driver_override에 써도 현재 driver에서 device를 자동으로 unbind하거나 지정한 driver를 자동 load하지 않습니다. 일치하는 이름의 driver가 현재 kernel에 load되어 있지 않으면 device는 어떤 driver에도 bind되지 않습니다. none 같은 driver_override name으로 device가 driver binding을 거부하게 할 수도 있습니다. Override에는 driver 하나만 지정할 수 있고 delimiters parsing은 지원하지 않습니다. PCI의 같은 이름 mechanism과 달리 basic matching rules를 override할 수 없으므로 driver는 여전히 device의 subchannel type과 일치해야 합니다.
echo vfio-ccw > driver_override
# override 해제
echo > driver_override
CSS driver_override binding flow
Write one driver nameName matches driver_overrideSubchannel type also matchesLoaded driver may bind
Write empty stringClear overrideStandard matching rules
Write noneNo matching driverOpt out of binding

Override name은 후보 driver를 제한하지만 subchannel-type match와 driver load 상태를 계속 요구합니다.