Linux 6.7-rc7
[linux-modified.git] / Documentation / ABI / testing / sysfs-platform-mellanox-bootctl
1 What:           /sys/bus/platform/devices/MLNXBF04:00/lifecycle_state
2 Date:           Oct 2019
3 KernelVersion:  5.5
4 Contact:        "Liming Sun <lsun@mellanox.com>"
5 Description:
6                 The Life-cycle state of the SoC, which could be one of the
7                 following values.
8
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                 ==============  =============================================
15
16 What:           /sys/bus/platform/devices/MLNXBF04:00/post_reset_wdog
17 Date:           Oct 2019
18 KernelVersion:  5.5
19 Contact:        "Liming Sun <lsun@mellanox.com>"
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.
24
25 What:           /sys/bus/platform/devices/MLNXBF04:00/reset_action
26 Date:           Oct 2019
27 KernelVersion:  5.5
28 Contact:        "Liming Sun <lsun@mellanox.com>"
29 Description:
30                 The source of the boot stream for the next reset. It could be
31                 one of the following values:
32
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                 ===========  ===============================================
38
39 What:           /sys/bus/platform/devices/MLNXBF04:00/second_reset_action
40 Date:           Oct 2019
41 KernelVersion:  5.5
42 Contact:        "Liming Sun <lsun@mellanox.com>"
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.
47
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                 ===========  ===============================================
55
56 What:           /sys/bus/platform/devices/MLNXBF04:00/secure_boot_fuse_state
57 Date:           Oct 2019
58 KernelVersion:  5.5
59 Contact:        "Liming Sun <lsun@mellanox.com>"
60 Description:
61                 The state of eFuse versions with the following values.
62
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                 =======  ===============================================
71
72 What:           /sys/bus/platform/devices/MLNXBF04:00/bootfifo
73 Date:           Apr 2023
74 KernelVersion:  6.4
75 Contact:        "Liming Sun <limings@nvidia.com>"
76 Description:
77                 The file used to access the BlueField boot fifo.
78
79 What:           /sys/bus/platform/devices/MLNXBF04:00/rsh_log
80 Date:           May 2023
81 KernelVersion:  6.4
82 Contact:        "Liming Sun <limings@nvidia.com>"
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.
87
88 What:           /sys/bus/platform/devices/MLNXBF04:00/oob_mac
89 Date:           August 2023
90 KernelVersion:  6.5
91 Contact:        "David Thompson <davthompson@nvidia.com>"
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.
96
97 What:           /sys/bus/platform/devices/MLNXBF04:00/opn
98 Date:           August 2023
99 KernelVersion:  6.5
100 Contact:        "David Thompson <davthompson@nvidia.com>"
101 Description:
102                 The "opn" sysfs attribute holds the board's part number.
103                 This value is provided on a board-level label.
104
105 What:           /sys/bus/platform/devices/MLNXBF04:00/sku
106 Date:           August 2023
107 KernelVersion:  6.5
108 Contact:        "David Thompson <davthompson@nvidia.com>"
109 Description:
110                 The "sku" sysfs attribute holds the board's SKU number.
111                 This value is provided on a board-level label.
112
113 What:           /sys/bus/platform/devices/MLNXBF04:00/modl
114 Date:           August 2023
115 KernelVersion:  6.5
116 Contact:        "David Thompson <davthompson@nvidia.com>"
117 Description:
118                 The "modl" sysfs attribute holds the board's model number.
119                 This value is provided on a board-level label.
120
121 What:           /sys/bus/platform/devices/MLNXBF04:00/sn
122 Date:           August 2023
123 KernelVersion:  6.5
124 Contact:        "David Thompson <davthompson@nvidia.com>"
125 Description:
126                 The "sn" sysfs attribute holds the board's serial number.
127                 This value is provided on a board-level label.
128
129 What:           /sys/bus/platform/devices/MLNXBF04:00/uuid
130 Date:           August 2023
131 KernelVersion:  6.5
132 Contact:        "David Thompson <davthompson@nvidia.com>"
133 Description:
134                 The "uuid" sysfs attribute holds the board's UUID.
135                 This value is provided by the manufacturing team.
136
137 What:           /sys/bus/platform/devices/MLNXBF04:00/rev
138 Date:           August 2023
139 KernelVersion:  6.5
140 Contact:        "David Thompson <davthompson@nvidia.com>"
141 Description:
142                 The "rev" sysfs attribute holds the board's revision.
143                 This value is provided on a board-level label.
144
145 What:           /sys/bus/platform/devices/MLNXBF04:00/mfg_lock
146 Date:           August 2023
147 KernelVersion:  6.5
148 Contact:        "David Thompson <davthompson@nvidia.com>"
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.