요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Watchdog와 staged boot source
sysfs-platform-mellanox-bootctl:16-71실패한 새 partition에서 이전 state로 복구할 watchdog과 다음/두 번째 reset의 external·eMMC boot source를 설정합니다.
Boot FIFO와 log
sysfs-platform-mellanox-bootctl:72-87Boot FIFO access와 level-prefixed boot message 기록을 제공합니다.
Board identity, manufacturing lock과 battery
sysfs-platform-mellanox-bootctl:88-162Label·manufacturing data에서 board identity를 읽고 EEPROM에 영구 고정하며 RTC battery status를 read-and-clear 방식으로 확인합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/platform/devices/MLNXBF04:00/lifecycle_state
2
Date: Oct 2019
3
KernelVersion: 5.5
4
Contact: "Liming Sun <[email protected]>"
5
Description:
6
The Life-cycle state of the SoC, which could be one of the
7
following values.
9
============== =============================================
10
Production Production state and can be updated to secure
11
GA Secured Secure chip and not able to change state
12
GA Non-Secured Non-Secure chip and not able to change state
13
RMA Return Merchandise Authorization
14
============== =============================================
16
What: /sys/bus/platform/devices/MLNXBF04:00/post_reset_wdog
17
Date: Oct 2019
18
KernelVersion: 5.5
19
Contact: "Liming Sun <[email protected]>"
20
Description:
21
The watchdog setting in seconds for the next booting. It's used
22
to reboot the chip and recover it to the old state if the new
23
boot partition fails.
25
What: /sys/bus/platform/devices/MLNXBF04:00/reset_action
26
Date: Oct 2019
27
KernelVersion: 5.5
28
Contact: "Liming Sun <[email protected]>"
29
Description:
30
The source of the boot stream for the next reset. It could be
31
one of the following values:
33
=========== ===============================================
34
external boot from external source (USB or PCIe)
35
emmc boot from the onchip eMMC
36
emmc_legacy boot from the onchip eMMC in legacy (slow) mode
37
=========== ===============================================
39
What: /sys/bus/platform/devices/MLNXBF04:00/second_reset_action
40
Date: Oct 2019
41
KernelVersion: 5.5
42
Contact: "Liming Sun <[email protected]>"
43
Description:
44
Update the source of the boot stream after next reset. It could
45
be one of the following values and will be applied after next
46
reset.
48
=========== ===============================================
49
external boot from external source (USB or PCIe)
50
emmc boot from the onchip eMMC
51
emmc_legacy boot from the onchip eMMC in legacy (slow) mode
52
swap_emmc swap the primary / secondary boot partition
53
none cancel the action
54
=========== ===============================================
56
What: /sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state
57
Date: Oct 2019
58
KernelVersion: 5.5
59
Contact: "Liming Sun <[email protected]>"
60
Description:
61
The state of eFuse versions with the following values.
63
======= ===============================================
64
InUse burnt, valid and currently in use
65
Used burnt and valid
66
Free not burnt and free to use
67
Skipped not burnt but not free (skipped)
68
Wasted burnt and invalid
69
Invalid not burnt but marked as valid (error state).
70
======= ===============================================
72
What: /sys/bus/platform/devices/MLNXBF04:00/bootfifo
73
Date: Apr 2023
74
KernelVersion: 6.4
75
Contact: "Liming Sun <[email protected]>"
76
Description:
77
The file used to access the BlueField boot fifo.
79
What: /sys/bus/platform/devices/MLNXBF04:00/rsh_log
80
Date: May 2023
81
KernelVersion: 6.4
82
Contact: "Liming Sun <[email protected]>"
83
Description:
84
The file used to write BlueField boot log with the format
85
"[INFO|WARN|ERR|ASSERT ]<msg>". Log level 'INFO' is used by
86
default if not specified.
88
What: /sys/bus/platform/devices/MLNXBF04:00/oob_mac
89
Date: August 2023
90
KernelVersion: 6.5
91
Contact: "David Thompson <[email protected]>"
92
Description:
93
The "oob_mac" sysfs attribute holds the MAC address for
94
the out-of-band 1Gbps Ethernet port. This MAC address is
95
provided on a board-level label.
97
What: /sys/bus/platform/devices/MLNXBF04:00/opn
98
Date: August 2023
99
KernelVersion: 6.5
100
Contact: "David Thompson <[email protected]>"
101
Description:
102
The "opn" sysfs attribute holds the board's part number.
103
This value is provided on a board-level label.
105
What: /sys/bus/platform/devices/MLNXBF04:00/sku
106
Date: August 2023
107
KernelVersion: 6.5
108
Contact: "David Thompson <[email protected]>"
109
Description:
110
The "sku" sysfs attribute holds the board's SKU number.
111
This value is provided on a board-level label.
113
What: /sys/bus/platform/devices/MLNXBF04:00/modl
114
Date: August 2023
115
KernelVersion: 6.5
116
Contact: "David Thompson <[email protected]>"
117
Description:
118
The "modl" sysfs attribute holds the board's model number.
119
This value is provided on a board-level label.
121
What: /sys/bus/platform/devices/MLNXBF04:00/sn
122
Date: August 2023
123
KernelVersion: 6.5
124
Contact: "David Thompson <[email protected]>"
125
Description:
126
The "sn" sysfs attribute holds the board's serial number.
127
This value is provided on a board-level label.
129
What: /sys/bus/platform/devices/MLNXBF04:00/uuid
130
Date: August 2023
131
KernelVersion: 6.5
132
Contact: "David Thompson <[email protected]>"
133
Description:
134
The "uuid" sysfs attribute holds the board's UUID.
135
This value is provided by the manufacturing team.
137
What: /sys/bus/platform/devices/MLNXBF04:00/rev
138
Date: August 2023
139
KernelVersion: 6.5
140
Contact: "David Thompson <[email protected]>"
141
Description:
142
The "rev" sysfs attribute holds the board's revision.
143
This value is provided on a board-level label.
145
What: /sys/bus/platform/devices/MLNXBF04:00/mfg_lock
146
Date: August 2023
147
KernelVersion: 6.5
148
Contact: "David Thompson <[email protected]>"
149
Description:
150
The "mfg_lock" sysfs attribute is write-only.
151
A successful write to this attribute will latch the
152
board-level attributes into EEPROM, making them read-only.
154
What: /sys/bus/platform/devices/MLNXBF04:00/rtc_battery
155
Date: June 2025
156
KernelVersion: 6.15
157
Contact: "Xiangrong Li <[email protected]>"
158
Description:
159
The "rtc_battery" sysfs attribute is read-only.
160
A successful read from this attribute returns the status of
161
the board's RTC battery. The RTC battery status register is
162
also cleared upon successful read operation.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Mellanox BlueField boot-control sysfs ABI: lifecycle state
1-15| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/lifecycle_state |
| Date | 2019년 10월 |
| KernelVersion | 5.5 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/lifecycle_state`는 SoC의 lifecycle state를 표시합니다. `Production`은 production state이며 secure state로 update할 수 있습니다. `GA Secured`는 secure chip이라 state를 변경할 수 없고, `GA Non-Secured`는 non-secure chip이라 state를 변경할 수 없습니다. `RMA`는 Return Merchandise Authorization입니다. |
StateMeaning
ProductionProduction state; can update to secure
GA SecuredSecure chip; state cannot change
GA Non-SecuredNon-secure chip; state cannot change
RMAReturn Merchandise Authorization
원문의 lifecycle-state 표를 변경 가능성과 의미로 다시 그렸습니다.
Mellanox BlueField boot-control sysfs ABI: post reset wdog
16-24| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/post_reset_wdog |
| Date | 2019년 10월 |
| KernelVersion | 5.5 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/post_reset_wdog`는 다음 boot에 사용할 watchdog 설정을 seconds 단위로 담습니다. 새 boot partition이 실패하면 chip을 reboot하고 이전 state로 복구하는 데 사용합니다. |
Configure watchdog seconds→Boot new partition→Partition fails→Reboot chip→Recover old state
새 boot partition 실패를 감지하면 chip을 reboot해 이전 state로 복구합니다.
Mellanox BlueField boot-control sysfs ABI: reset action
25-38| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/reset_action |
| Date | 2019년 10월 |
| KernelVersion | 5.5 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/reset_action`은 다음 reset의 boot stream source를 선택합니다. `external`은 USB 또는 PCIe 같은 external source, `emmc`는 on-chip eMMC, `emmc_legacy`는 legacy slow mode의 on-chip eMMC에서 boot합니다. |
ValueBoot source
externalExternal USB or PCIe
emmcOn-chip eMMC
emmc_legacyOn-chip eMMC legacy slow mode
reset_action이 선택할 수 있는 세 boot stream sources입니다.
Mellanox BlueField boot-control sysfs ABI: second reset action
39-55| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/second_reset_action |
| Date | 2019년 10월 |
| KernelVersion | 5.5 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/second_reset_action`은 다음 reset 이후에 사용할 boot stream source를 update합니다. `external`, `emmc`, `emmc_legacy` 외에 `swap_emmc`는 primary/secondary boot partition을 바꾸고 `none`은 action을 취소합니다. 선택한 action은 다음 reset 뒤에 적용됩니다. |
ValueAction
externalBoot from external USB or PCIe
emmcBoot from on-chip eMMC
emmc_legacyBoot from eMMC legacy slow mode
swap_emmcSwap primary and secondary boot partitions
noneCancel the action
다음 reset 뒤에 적용할 boot source, partition swap 또는 cancellation을 선택합니다.
Mellanox BlueField boot-control sysfs ABI: secure boot fuse state
56-71| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state |
| Date | 2019년 10월 |
| KernelVersion | 5.5 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state`는 eFuse version state를 표시합니다. `InUse`는 burnt·valid·currently in use, `Used`는 burnt·valid, `Free`는 not burnt·free to use, `Skipped`는 not burnt이지만 free가 아닌 skipped state, `Wasted`는 burnt·invalid, `Invalid`는 not burnt이지만 valid로 표시된 error state입니다. |
StateBurntValidAvailability or use
InUseYesYesCurrently in use
UsedYesYesAlready used
FreeNoN/AFree to use
SkippedNoN/ANot free; skipped
WastedYesNoInvalid
InvalidNoMarked validError state
Burnt, validity, availability와 active-use 상태를 결합한 원문 표입니다.
Mellanox BlueField boot-control sysfs ABI: bootfifo
72-78| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/bootfifo |
| Date | 2023년 4월 |
| KernelVersion | 6.4 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/bootfifo`는 BlueField boot FIFO에 access하는 file입니다. |
Mellanox BlueField boot-control sysfs ABI: rsh log
79-87| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/rsh_log |
| Date | 2023년 5월 |
| KernelVersion | 6.4 |
| Contact | "Liming Sun <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/rsh_log`는 `[INFO|WARN|ERR|ASSERT ]<msg>` format으로 BlueField boot log를 쓰는 file입니다. Level을 지정하지 않으면 기본값 `INFO`를 사용합니다. |
FormatLevel
[INFO]<msg>Information
[WARN]<msg>Warning
[ERR]<msg>Error
[ASSERT ]<msg>Assertion
<msg>Defaults to INFO
명시할 수 있는 log levels와 기본 동작을 보존합니다.
Mellanox BlueField boot-control sysfs ABI: oob mac
88-96| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/oob_mac |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/oob_mac`은 out-of-band 1Gbps Ethernet port의 MAC address를 담습니다. 이 MAC address는 board-level label에 표시됩니다. |
AttributeValueSource
oob_macOut-of-band 1Gbps Ethernet MACBoard label
opnPart numberBoard label
skuSKU numberBoard label
modlModel numberBoard label
snSerial numberBoard label
uuidUUIDManufacturing team
revRevisionBoard label
Board identity attribute와 source를 정리합니다.
Mellanox BlueField boot-control sysfs ABI: opn
97-104| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/opn |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/opn`은 board part number를 담으며 board-level label에서 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: sku
105-112| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/sku |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/sku`는 board SKU number를 담으며 board-level label에서 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: modl
113-120| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/modl |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/modl`은 board model number를 담으며 board-level label에서 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: sn
121-128| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/sn |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/sn`은 board serial number를 담으며 board-level label에서 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: uuid
129-136| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/uuid |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/uuid`는 board UUID를 담으며 manufacturing team이 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: rev
137-144| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/rev |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/rev`는 board revision을 담으며 board-level label에서 제공합니다. |
Mellanox BlueField boot-control sysfs ABI: mfg lock
145-153| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/mfg_lock |
| Date | 2023년 8월 |
| KernelVersion | 6.5 |
| Contact | "David Thompson <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/mfg_lock`은 write-only입니다. 이 attribute에 성공적으로 write하면 board-level attributes를 EEPROM에 latch하여 read-only로 만듭니다. |
Populate board-level attributes→Write mfg_lock→Latch values into EEPROM→Attributes become read-only
Write-only mfg_lock이 현재 board data를 EEPROM에 고정합니다.
Mellanox BlueField boot-control sysfs ABI: rtc battery
154-162| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/platform/devices/MLNXBF04:00/rtc_battery |
| Date | 2025년 6월 |
| KernelVersion | 6.15 |
| Contact | "Xiangrong Li <[email protected]>" |
| Description | `/sys/bus/platform/devices/MLNXBF04:00/rtc_battery`는 read-only입니다. 성공적으로 read하면 board RTC battery status를 반환하며, 같은 read operation이 RTC battery status register도 clear합니다. |
Read rtc_battery→Return RTC battery status→Clear status register
한 번의 successful read가 status 반환과 status-register clear를 함께 수행합니다.
Lifecycle과 secure boot state
sysfs-platform-mellanox-bootctl:1-15SoC lifecycle의 변경 가능 여부를 구분하고 production·secured·RMA state를 노출합니다.