요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
PAPR-SCM counters
sysfs-bus-papr-pmem:36-64perf_stats를 지원하는 장치는 controller reset, 전원 시간, 수명, host·media·cache I/O 등 16개 알려진 통계를 한 줄에 하나씩 제공합니다.
Simulated health bitmap
sysfs-bus-papr-pmem:65-74health_bitmap_inject는 H_SCM_HEALTH bitmap에 강제로 적용할 bit를 보고하며 ndctl 같은 도구가 health 또는 shutdown 상태를 모의하는 데 사용합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/nd/devices/nmemX/papr/flags
2
Date: Apr, 2020
3
KernelVersion: v5.8
4
Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
5
Description:
6
(RO) Report flags indicating various states of a
7
papr-pmem NVDIMM device. Each flag maps to a one or
8
more bits set in the dimm-health-bitmap retrieved in
9
response to H_SCM_HEALTH hcall. The details of the bit
10
flags returned in response to this hcall is available
11
at 'Documentation/arch/powerpc/papr_hcalls.rst' . Below are
12
the flags reported in this sysfs file:
14
* "not_armed"
15
Indicates that NVDIMM contents will not
16
survive a power cycle.
17
* "flush_fail"
18
Indicates that NVDIMM contents
19
couldn't be flushed during last
20
shut-down event.
21
* "restore_fail"
22
Indicates that NVDIMM contents
23
couldn't be restored during NVDIMM
24
initialization.
25
* "encrypted"
26
NVDIMM contents are encrypted.
27
* "smart_notify"
28
There is health event for the NVDIMM.
29
* "scrubbed"
30
Indicating that contents of the
31
NVDIMM have been scrubbed.
32
* "locked"
33
Indicating that NVDIMM contents can't
34
be modified until next power cycle.
36
What: /sys/bus/nd/devices/nmemX/papr/perf_stats
37
Date: May, 2020
38
KernelVersion: v5.9
39
Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
40
Description:
41
(RO) Report various performance stats related to papr-scm NVDIMM
42
device. This attribute is only available for NVDIMM devices
43
that support reporting NVDIMM performance stats. Each stat is
44
reported on a new line with each line composed of a
45
stat-identifier followed by it value. Below are currently known
46
dimm performance stats which are reported:
48
* "CtlResCt" : Controller Reset Count
49
* "CtlResTm" : Controller Reset Elapsed Time
50
* "PonSecs " : Power-on Seconds
51
* "MemLife " : Life Remaining
52
* "CritRscU" : Critical Resource Utilization
53
* "HostLCnt" : Host Load Count
54
* "HostSCnt" : Host Store Count
55
* "HostSDur" : Host Store Duration
56
* "HostLDur" : Host Load Duration
57
* "MedRCnt " : Media Read Count
58
* "MedWCnt " : Media Write Count
59
* "MedRDur " : Media Read Duration
60
* "MedWDur " : Media Write Duration
61
* "CchRHCnt" : Cache Read Hit Count
62
* "CchWHCnt" : Cache Write Hit Count
63
* "FastWCnt" : Fast Write Count
65
What: /sys/bus/nd/devices/nmemX/papr/health_bitmap_inject
66
Date: Jan, 2022
67
KernelVersion: v5.17
68
Contact: linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev,
69
Description:
70
(RO) Reports the health bitmap inject bitmap that is applied to
71
bitmap received from PowerVM via the H_SCM_HEALTH. This is used
72
to forcibly set specific bits returned from Hcall. These is then
73
used to simulate various health or shutdown states for an nvdimm
74
and are set by user-space tools like ndctl by issuing a PAPR DSM.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
PAPR NVDIMM health flag
1-35| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/nd/devices/nmemX/papr/flags |
| Date | 2020년 4월 |
| KernelVersion | v5.8 |
| Contact | linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev |
| Description | (RO) PAPR-PMEM NVDIMM 장치의 여러 상태를 나타내는 flag를 보고합니다. 각 flag는 H_SCM_HEALTH hcall 응답으로 가져온 dimm-health-bitmap에서 설정된 하나 이상의 bit에 대응합니다. |
| Reference | Documentation/arch/powerpc/papr_hcalls.rst |
| Flag | 한국어 의미 |
|---|---|
| not_armed | NVDIMM 내용이 power cycle 뒤에도 유지되지 않음을 나타냅니다. |
| flush_fail | 마지막 shutdown event 동안 NVDIMM 내용을 flush하지 못했음을 나타냅니다. |
| restore_fail | NVDIMM 초기화 중 내용을 복원하지 못했음을 나타냅니다. |
| encrypted | NVDIMM 내용이 암호화되어 있습니다. |
| smart_notify | NVDIMM에 health event가 있습니다. |
| scrubbed | NVDIMM 내용이 scrub되었음을 나타냅니다. |
| locked | 다음 power cycle까지 NVDIMM 내용을 수정할 수 없음을 나타냅니다. |
PAPR-SCM NVDIMM performance 통계
36-64| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/nd/devices/nmemX/papr/perf_stats |
| Date | 2020년 5월 |
| KernelVersion | v5.9 |
| Contact | linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev |
| Description | (RO) PAPR-SCM NVDIMM 장치와 관련된 여러 performance 통계를 보고합니다. NVDIMM performance 통계 보고를 지원하는 장치에서만 사용할 수 있습니다. 각 통계는 새 줄에 보고되며 각 줄은 stat identifier와 그 값으로 구성됩니다. |
| Stat identifier | 의미 |
|---|---|
| CtlResCt | Controller Reset Count |
| CtlResTm | Controller Reset Elapsed Time |
| PonSecs | Power-on Seconds |
| MemLife | Life Remaining |
| CritRscU | Critical Resource Utilization |
| HostLCnt | Host Load Count |
| HostSCnt | Host Store Count |
| HostSDur | Host Store Duration |
| HostLDur | Host Load Duration |
| MedRCnt | Media Read Count |
| MedWCnt | Media Write Count |
| MedRDur | Media Read Duration |
| MedWDur | Media Write Duration |
| CchRHCnt | Cache Read Hit Count |
| CchWHCnt | Cache Write Hit Count |
| FastWCnt | Fast Write Count |
Health bitmap injection
65-74| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/nd/devices/nmemX/papr/health_bitmap_inject |
| Date | 2022년 1월 |
| KernelVersion | v5.17 |
| Contact | linuxppc-dev <linuxppc-dev@lists.ozlabs.org>, nvdimm@lists.linux.dev |
| Description | (RO) PowerVM에서 H_SCM_HEALTH를 통해 받은 bitmap에 적용되는 health bitmap injection bitmap을 보고합니다. Hcall이 반환한 특정 bit를 강제로 설정하는 데 사용합니다. 이렇게 설정된 bit는 NVDIMM의 여러 health 또는 shutdown 상태를 모의하는 데 사용되며, ndctl 같은 user-space 도구가 PAPR DSM을 실행해 설정합니다. |
Power, flush, and security state
sysfs-bus-papr-pmem:1-35flags는 H_SCM_HEALTH hcall의 dimm-health-bitmap을 해석해 persistence, flush·restore, encryption, health event, scrub, lock 상태를 보고합니다.