요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
SATA link power-management policy
sysfs-class-scsi_host:31-62Power saving과 latency·performance 사이의 tradeoff에 따라 네 가지 link power policy를 선택합니다.
Enclosure-management messages
sysfs-class-scsi_host:64-80AHCI LED message read/write와 driver가 사용하는 LED·SAF-TE·SES-2·SGPIO enclosure protocol을 제공합니다.
AHCI capabilities and EM buffer
sysfs-class-scsi_host:82-119AHCI command/capability register attributes, specification version, vendor-defined EM buffer access와 supported message type을 제공합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/scsi_host/hostX/isci_id
2
Date: June 2011
3
Contact: Dave Jiang <dave.jiang@intel.com>
4
Description:
5
This file contains the enumerated host ID for the Intel
6
SCU controller. The Intel(R) C600 Series Chipset SATA/SAS
7
Storage Control Unit embeds up to two 4-port controllers in
8
a single PCI device. The controllers are enumerated in order
9
which usually means the lowest number scsi_host corresponds
10
with the first controller, but this association is not
11
guaranteed. The 'isci_id' attribute unambiguously identifies
12
the controller index: '0' for the first controller,
13
'1' for the second.
15
What: /sys/class/scsi_host/hostX/acciopath_status
16
Date: November 2013
17
Contact: Stephen M. Cameron <scameron@beardog.cce.hp.com>
18
Description: This file contains the current status of the "SSD Smart Path"
19
feature of HP Smart Array RAID controllers using the hpsa
20
driver. SSD Smart Path, when enabled permits the driver to
21
send i/o requests directly to physical devices that are part
22
of a logical drive, bypassing the controllers firmware RAID
23
stack for a performance advantage when possible. A value of
24
'1' indicates the feature is enabled, and the controller may
25
use the direct i/o path to physical devices. A value of zero
26
means the feature is disabled and the controller may not use
27
the direct i/o path to physical devices. This setting is
28
controller wide, affecting all configured logical drives on the
29
controller. This file is readable and writable.
31
What: /sys/class/scsi_host/hostX/link_power_management_policy
32
Date: Oct, 2007
33
KernelVersion: v2.6.24
34
Contact: linux-ide@vger.kernel.org
35
Description:
36
(RW) This parameter allows the user to read and set the link
37
(interface) power management.
39
There are four possible options:
41
min_power: Tell the controller to try to make the link use the
42
least possible power when possible. This may sacrifice some
43
performance due to increased latency when coming out of lower
44
power states.
46
max_performance: Generally, this means no power management.
47
Tell the controller to have performance be a priority over power
48
management.
50
medium_power: Tell the controller to enter a lower power state
51
when possible, but do not enter the lowest power state, thus
52
improving latency over min_power setting.
54
med_power_with_dipm: Identical to the existing medium_power
55
setting except that it enables dipm (device initiated power
56
management) on top, which makes it match the Windows IRST (Intel
57
Rapid Storage Technology) driver settings. This setting is also
58
close to min_power, except that:
60
a) It does not use host-initiated slumber mode, but it does
61
allow device-initiated slumber
62
b) It does not enable low power device sleep mode (DevSlp).
64
What: /sys/class/scsi_host/hostX/em_message
65
What: /sys/class/scsi_host/hostX/em_message_type
66
Date: Jun, 2008
67
KernelVersion: v2.6.27
68
Contact: linux-ide@vger.kernel.org
69
Description:
70
em_message: (RW) Enclosure management support. For the LED
71
protocol, writes and reads correspond to the LED message format
72
as defined in the AHCI spec.
74
The user must turn sw_activity (under `/sys/block/*/device/`)
75
OFF it they wish to control the activity LED via the em_message
76
file.
78
em_message_type: (RO) Displays the current enclosure management
79
protocol that is being used by the driver (for eg. LED, SAF-TE,
80
SES-2, SGPIO etc).
82
What: /sys/class/scsi_host/hostX/ahci_port_cmd
83
What: /sys/class/scsi_host/hostX/ahci_host_caps
84
What: /sys/class/scsi_host/hostX/ahci_host_cap2
85
Date: Mar, 2010
86
KernelVersion: v2.6.35
87
Contact: linux-ide@vger.kernel.org
88
Description:
89
[to be documented]
91
What: /sys/class/scsi_host/hostX/ahci_host_version
92
Date: Mar, 2010
93
KernelVersion: v2.6.35
94
Contact: linux-ide@vger.kernel.org
95
Description:
96
(RO) Display the version of the AHCI spec implemented by the
97
host.
99
What: /sys/class/scsi_host/hostX/em_buffer
100
Date: Apr, 2010
101
KernelVersion: v2.6.35
102
Contact: linux-ide@vger.kernel.org
103
Description:
104
(RW) Allows access to AHCI EM (enclosure management) buffer
105
directly if the host supports EM.
107
For eg. the AHCI driver supports SGPIO EM messages but the
108
SATA/AHCI specs do not define the SGPIO message format of the EM
109
buffer. Different hardware(HW) vendors may have different
110
definitions. With the em_buffer attribute, this issue can be
111
solved by allowing HW vendors to provide userland drivers and
112
tools for their SGPIO initiators.
114
What: /sys/class/scsi_host/hostX/em_message_supported
115
Date: Oct, 2009
116
KernelVersion: v2.6.39
117
Contact: linux-ide@vger.kernel.org
118
Description:
119
(RO) Displays supported enclosure management message types.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Intel SCU controller index
1-13| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/isci_id |
| Date | 2011년 6월 |
| Contact | Dave Jiang <dave.jiang@intel.com> |
| Description | Intel SCU controller의 enumerated host ID를 보관합니다. Intel(R) C600 Series Chipset SATA/SAS Storage Control Unit는 하나의 PCI device에 최대 두 개의 4-port controller를 내장합니다. 보통 가장 낮은 scsi_host 번호가 첫 controller에 대응하지만 enumeration 순서로 인한 이 관계는 보장되지 않습니다. isci_id는 controller index를 모호함 없이 식별하며 0은 첫 controller, 1은 두 번째 controller입니다. |
isci_idController
0First embedded 4-port controller
1Second embedded 4-port controller
scsi_host 번호 대신 controller index를 명확하게 식별합니다.
HP SSD Smart Path status
15-29| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/acciopath_status |
| Date | 2013년 11월 |
| Contact | Stephen M. Cameron <scameron@beardog.cce.hp.com> |
| Description | hpsa driver를 사용하는 HP Smart Array RAID controller의 current SSD Smart Path status를 보관합니다. Enable하면 가능한 경우 driver가 logical drive에 속한 physical device로 IO request를 직접 보내 controller firmware RAID stack을 우회해 성능을 높일 수 있습니다. 1은 feature enabled로 direct IO path를 사용할 수 있음을, 0은 disabled로 direct path를 사용할 수 없음을 뜻합니다. 이 read/write 설정은 controller 전체에 적용되어 모든 configured logical drive에 영향을 줍니다. |
Logical-drive IO request→acciopath_status 확인→Enabled이고 direct path 가능→Physical device로 직접 IO→그 밖에는 firmware RAID stack
Enabled 상태에서는 가능한 IO가 firmware RAID stack을 우회할 수 있습니다.
SATA link power-management policy
31-62| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/link_power_management_policy |
| Date | 2007년 10월 |
| KernelVersion | v2.6.24 |
| Contact | linux-ide@vger.kernel.org |
| Description | (RW) Link(interface) power management policy를 읽고 설정합니다. min_power는 가능한 가장 낮은 power를 사용하지만 low-power state에서 나올 때 latency가 늘어 성능이 낮아질 수 있습니다. max_performance는 일반적으로 power management를 사용하지 않고 성능을 우선합니다. medium_power는 가능한 lower-power state에 들어가되 lowest state는 피하여 min_power보다 latency를 개선합니다. med_power_with_dipm은 medium_power에 DIPM(device-initiated power management)을 enable해 Windows IRST 설정과 맞춥니다. min_power와 비슷하지만 host-initiated slumber를 사용하지 않고 device-initiated slumber는 허용하며, DevSlp(low-power device sleep)는 enable하지 않습니다. |
PolicyPower/latency behavior
min_power최저 power 우선, wake latency 증가 가능
max_performancePower management보다 performance 우선
medium_powerLowest state를 피해서 min_power보다 latency 개선
med_power_with_dipmmedium_power + DIPM, host slumber/DevSlp 미사용
Power saving, latency와 device-initiated 기능의 차이입니다.
AHCI enclosure-management messages
64-80| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/em_message |
| What | /sys/class/scsi_host/hostX/em_message_type |
| Date | 2008년 6월 |
| KernelVersion | v2.6.27 |
| Contact | linux-ide@vger.kernel.org |
| Description | em_message는 (RW) enclosure-management support를 제공합니다. LED protocol에서는 AHCI specification이 정의한 LED message format에 따라 읽고 씁니다. em_message로 activity LED를 control하려면 user가 /sys/block/*/device/ 아래 sw_activity를 OFF로 설정해야 합니다. em_message_type은 (RO) driver가 현재 사용하는 enclosure-management protocol을 표시하며 예로 LED, SAF-TE, SES-2, SGPIO 등이 있습니다. |
AttributeAccess역할
em_messageRWAHCI LED message format read/write
em_message_typeROLED, SAF-TE, SES-2, SGPIO 등 current protocol
sw_activityControl prerequisiteManual activity LED control 전에 OFF
Message payload와 active protocol type의 역할을 구분합니다.
AHCI command and capability attributes
82-89| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/ahci_port_cmd |
| What | /sys/class/scsi_host/hostX/ahci_host_caps |
| What | /sys/class/scsi_host/hostX/ahci_host_cap2 |
| Date | 2010년 3월 |
| KernelVersion | v2.6.35 |
| Contact | linux-ide@vger.kernel.org |
| Description | [문서화 예정] |
Implemented AHCI specification version
91-97| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/ahci_host_version |
| Date | 2010년 3월 |
| KernelVersion | v2.6.35 |
| Contact | linux-ide@vger.kernel.org |
| Description | (RO) Host가 구현한 AHCI specification version을 표시합니다. |
Raw AHCI enclosure-management buffer
99-112| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/em_buffer |
| Date | 2010년 4월 |
| KernelVersion | v2.6.35 |
| Contact | linux-ide@vger.kernel.org |
| Description | (RW) Host가 EM을 지원하면 AHCI enclosure-management buffer에 직접 접근할 수 있습니다. AHCI driver는 SGPIO EM message를 지원하지만 SATA/AHCI specification은 EM buffer의 SGPIO message format을 정의하지 않아 hardware vendor별 정의가 다를 수 있습니다. em_buffer를 통해 vendor가 SGPIO initiator용 userland driver와 tool을 제공할 수 있습니다. |
Supported enclosure message types
114-119| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/scsi_host/hostX/em_message_supported |
| Date | 2009년 10월 |
| KernelVersion | v2.6.39 |
| Contact | linux-ide@vger.kernel.org |
| Description | (RO) 지원하는 enclosure-management message type을 표시합니다. |
Attribute group역할
ahci_port_cmd / ahci_host_caps / ahci_host_cap2원문에서 상세 설명 미제공
ahci_host_versionImplemented AHCI specification version
em_bufferVendor-defined raw EM buffer access
em_message_supportedSupported EM message types
Command/capability, version, raw buffer와 supported message attributes의 역할입니다.
Controller identity and direct IO path
sysfs-class-scsi_host:1-29Intel SCU dual-controller index와 HP Smart Array SSD Smart Path의 controller-wide enable state를 제공합니다.