요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
Kernel driver drivetemp
=======================
References
----------
ANS T13/1699-D
Information technology - AT Attachment 8 - ATA/ATAPI Command Set (ATA8-ACS)
ANS Project T10/BSR INCITS 513
Information technology - SCSI Primary Commands - 4 (SPC-4)
ANS Project INCITS 557
Information technology - SCSI / ATA Translation - 5 (SAT-5)
Description
-----------
This driver supports reporting the temperature of disk and solid state
drives with temperature sensors.
If supported, it uses the ATA SCT Command Transport feature to read
the current drive temperature and, if available, temperature limits
as well as historic minimum and maximum temperatures. If SCT Command
Transport is not supported, the driver uses SMART attributes to read
the drive temperature.
Usage Note
----------
Reading the drive temperature may reset the spin down timer on some drives.
This has been observed with WD120EFAX drives, but may be seen with other
drives as well. The same behavior is observed if the 'hdtemp' or 'smartd'
tools are used to access the drive.
With the WD120EFAX drive, reading the drive temperature using the drivetemp
driver is still possible _after_ it transitioned to standby mode, and
reading the drive temperature in this mode will not cause the drive to
change its mode (meaning the drive will not spin up). It is unknown if other
drives experience similar behavior.
A known workaround for WD120EFAX drives is to read the drive temperature at
intervals larger than twice the spin-down time. Otherwise affected drives
will never spin down.
Sysfs entries
-------------
Only the temp1_input attribute is always available. Other attributes are
available only if reported by the drive. All temperatures are reported in
milli-degrees Celsius.
======================= =====================================================
temp1_input Current drive temperature
temp1_lcrit Minimum temperature limit. Operating the device below
this temperature may cause physical damage to the
device.
temp1_min Minimum recommended continuous operating limit
temp1_max Maximum recommended continuous operating temperature
temp1_crit Maximum temperature limit. Operating the device above
this temperature may cause physical damage to the
device.
temp1_lowest Minimum temperature seen this power cycle
temp1_highest Maximum temperature seen this power cycle
======================= =====================================================
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
ATA·SCSI 표준과 drive temperature
1-32이 GPL-2.0 드라이버의 참조 표준은 ANS T13/1699-D ATA8-ACS, ANS Project T10/BSR INCITS 513 SCSI Primary Commands 4(SPC-4), ANS Project INCITS 557 SCSI/ATA Translation 5(SAT-5)입니다.
드라이버는 temperature sensor가 있는 disk와 solid-state drive의 온도를 보고합니다.
지원되는 경우 ATA SCT Command Transport로 현재 drive temperature를 읽고, 제공된다면 temperature limit와 이 power cycle의 historical minimum·maximum도 읽습니다. SCT Command Transport를 지원하지 않으면 SMART attribute로 drive temperature를 읽습니다.
Drive capability에 따라 SCT 또는 SMART를 선택합니다.
Capability 확인 뒤 가장 풍부한 interface를 선택합니다.
.. SPDX-License-Identifier: GPL-2.0
Kernel driver drivetemp
=======================
References
----------
ANS T13/1699-D
Information technology - AT Attachment 8 - ATA/ATAPI Command Set (ATA8-ACS)
ANS Project T10/BSR INCITS 513
Information technology - SCSI Primary Commands - 4 (SPC-4)
ANS Project INCITS 557
Information technology - SCSI / ATA Translation - 5 (SAT-5)
Description
-----------
This driver supports reporting the temperature of disk and solid state
drives with temperature sensors.
If supported, it uses the ATA SCT Command Transport feature to read
the current drive temperature and, if available, temperature limits
as well as historic minimum and maximum temperatures. If SCT Command
Transport is not supported, the driver uses SMART attributes to read
the drive temperature.
Spin-down timer와 WD120EFAX 주의
33-50일부 drive에서는 temperature를 읽는 행위가 spin-down timer를 reset할 수 있습니다. WD120EFAX에서 관찰됐지만 다른 drive에서도 발생할 수 있습니다. `hdtemp`나 `smartd`가 drive에 접근할 때도 같은 동작이 관찰됩니다.
WD120EFAX는 standby mode로 전환된 뒤에도 drivetemp로 온도를 읽을 수 있고, 이 상태에서 읽어도 mode가 바뀌지 않아 spin-up하지 않습니다. 다른 drive도 같은지는 알려지지 않았습니다.
WD120EFAX의 알려진 workaround는 drive 온도 읽기 간격을 spin-down time의 두 배보다 크게 설정하는 것입니다. 그렇지 않으면 영향받는 drive가 절대 spin-down하지 못할 수 있습니다.
온도 polling과 power state의 알려진 관계입니다.
Drive sleep을 방해하지 않도록 간격을 잡습니다.
Usage Note
----------
Reading the drive temperature may reset the spin down timer on some drives.
This has been observed with WD120EFAX drives, but may be seen with other
drives as well. The same behavior is observed if the 'hdtemp' or 'smartd'
tools are used to access the drive.
With the WD120EFAX drive, reading the drive temperature using the drivetemp
driver is still possible _after_ it transitioned to standby mode, and
reading the drive temperature in this mode will not cause the drive to
change its mode (meaning the drive will not spin up). It is unknown if other
drives experience similar behavior.
A known workaround for WD120EFAX drives is to read the drive temperature at
intervals larger than twice the spin-down time. Otherwise affected drives
will never spin down.
Drive temperature sysfs ABI
51-70`temp1_input`만 항상 존재합니다. 나머지 attribute는 drive가 해당 값을 보고할 때만 제공됩니다. 모든 temperature는 millidegree Celsius입니다.
`temp1_input`은 current drive temperature입니다. `temp1_lcrit`은 이보다 낮게 동작하면 physical damage가 생길 수 있는 minimum limit이고, `temp1_crit`은 이보다 높게 동작하면 physical damage가 생길 수 있는 maximum limit입니다.
`temp1_min`은 recommended continuous operating minimum, `temp1_max`는 recommended continuous operating maximum입니다. `temp1_lowest`와 `temp1_highest`는 이번 power cycle에서 관측한 minimum·maximum입니다.
항상 제공되는 값과 drive 선택 제공 값을 구분합니다.
현재값을 권장 범위와 critical 범위에 비교합니다.
Sysfs entries
-------------
Only the temp1_input attribute is always available. Other attributes are
available only if reported by the drive. All temperatures are reported in
milli-degrees Celsius.
======================= =====================================================
temp1_input Current drive temperature
temp1_lcrit Minimum temperature limit. Operating the device below
this temperature may cause physical damage to the
device.
temp1_min Minimum recommended continuous operating limit
temp1_max Maximum recommended continuous operating temperature
temp1_crit Maximum temperature limit. Operating the device above
this temperature may cause physical damage to the
device.
temp1_lowest Minimum temperature seen this power cycle
temp1_highest Maximum temperature seen this power cycle
======================= =====================================================
요약·해설
drivetemp.rst:1-70Drive capability에 따라 SCT 또는 SMART에서 온도와 optional limit를 읽습니다.
원문 분량과 핵심 범위입니다.
장치 동작의 기본 순서입니다.