mirror of https://github.com/Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
178 lines
6.9 KiB
178 lines
6.9 KiB
What: /sys/class/mic/ |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
The mic class directory belongs to Intel MIC devices and |
|
provides information per MIC device. An Intel MIC device is a |
|
PCIe form factor add-in Coprocessor card based on the Intel Many |
|
Integrated Core (MIC) architecture that runs a Linux OS. |
|
|
|
What: /sys/class/mic/mic(x) |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
The directories /sys/class/mic/mic0, /sys/class/mic/mic1 etc., |
|
represent MIC devices (0,1,..etc). Each directory has |
|
information specific to that MIC device. |
|
|
|
What: /sys/class/mic/mic(x)/family |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
Provides information about the Coprocessor family for an Intel |
|
MIC device. For example - "x100" |
|
|
|
What: /sys/class/mic/mic(x)/stepping |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
Provides information about the silicon stepping for an Intel |
|
MIC device. For example - "A0" or "B0" |
|
|
|
What: /sys/class/mic/mic(x)/state |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
When read, this entry provides the current state of an Intel |
|
MIC device in the context of the card OS. Possible values that |
|
will be read are: |
|
|
|
|
|
=============== =============================================== |
|
"ready" The MIC device is ready to boot the card OS. |
|
On reading this entry after an OSPM resume, |
|
a "boot" has to be written to this entry if |
|
the card was previously shutdown during OSPM |
|
suspend. |
|
"booting" The MIC device has initiated booting a card OS. |
|
"online" The MIC device has completed boot and is online |
|
"shutting_down" The card OS is shutting down. |
|
"resetting" A reset has been initiated for the MIC device |
|
"reset_failed" The MIC device has failed to reset. |
|
=============== =============================================== |
|
|
|
When written, this sysfs entry triggers different state change |
|
operations depending upon the current state of the card OS. |
|
Acceptable values are: |
|
|
|
|
|
========== =================================================== |
|
"boot" Boot the card OS image specified by the combination |
|
of firmware, ramdisk, cmdline and bootmode |
|
sysfs entries. |
|
"reset" Initiates device reset. |
|
"shutdown" Initiates card OS shutdown. |
|
========== =================================================== |
|
|
|
What: /sys/class/mic/mic(x)/shutdown_status |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
An Intel MIC device runs a Linux OS during its operation. This |
|
OS can shutdown because of various reasons. When read, this |
|
entry provides the status on why the card OS was shutdown. |
|
Possible values are: |
|
|
|
========== =================================================== |
|
"nop" shutdown status is not applicable, when the card OS |
|
is "online" |
|
"crashed" Shutdown because of a HW or SW crash. |
|
"halted" Shutdown because of a halt command. |
|
"poweroff" Shutdown because of a poweroff command. |
|
"restart" Shutdown because of a restart command. |
|
========== =================================================== |
|
|
|
What: /sys/class/mic/mic(x)/cmdline |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
An Intel MIC device runs a Linux OS during its operation. Before |
|
booting this card OS, it is possible to pass kernel command line |
|
options to configure various features in it, similar to |
|
self-bootable machines. When read, this entry provides |
|
information about the current kernel command line options set to |
|
boot the card OS. This entry can be written to change the |
|
existing kernel command line options. Typically, the user would |
|
want to read the current command line options, append new ones |
|
or modify existing ones and then write the whole kernel command |
|
line back to this entry. |
|
|
|
What: /sys/class/mic/mic(x)/firmware |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
When read, this sysfs entry provides the path name under |
|
/lib/firmware/ where the firmware image to be booted on the |
|
card can be found. The entry can be written to change the |
|
firmware image location under /lib/firmware/. |
|
|
|
What: /sys/class/mic/mic(x)/ramdisk |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
When read, this sysfs entry provides the path name under |
|
/lib/firmware/ where the ramdisk image to be used during card |
|
OS boot can be found. The entry can be written to change |
|
the ramdisk image location under /lib/firmware/. |
|
|
|
What: /sys/class/mic/mic(x)/bootmode |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
When read, this sysfs entry provides the current bootmode for |
|
the card. This sysfs entry can be written with the following |
|
valid strings: |
|
a) linux - Boot a Linux image. |
|
b) flash - Boot an image for flash updates. |
|
|
|
What: /sys/class/mic/mic(x)/log_buf_addr |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
An Intel MIC device runs a Linux OS during its operation. For |
|
debugging purpose and early kernel boot messages, the user can |
|
access the card OS log buffer via debugfs. When read, this entry |
|
provides the kernel virtual address of the buffer where the card |
|
OS log buffer can be read. This entry is written by the host |
|
configuration daemon to set the log buffer address. The correct |
|
log buffer address to be written can be found in the System.map |
|
file of the card OS. |
|
|
|
What: /sys/class/mic/mic(x)/log_buf_len |
|
Date: October 2013 |
|
KernelVersion: 3.13 |
|
Contact: Sudeep Dutt <[email protected]> |
|
Description: |
|
An Intel MIC device runs a Linux OS during its operation. For |
|
debugging purpose and early kernel boot messages, the user can |
|
access the card OS log buffer via debugfs. When read, this entry |
|
provides the kernel virtual address where the card OS log buffer |
|
length can be read. This entry is written by host configuration |
|
daemon to set the log buffer length address. The correct log |
|
buffer length address to be written can be found in the |
|
System.map file of the card OS. |
|
|
|
What: /sys/class/mic/mic(x)/heartbeat_enable |
|
Date: March 2015 |
|
KernelVersion: 4.4 |
|
Contact: Ashutosh Dixit <[email protected]> |
|
Description: |
|
The MIC drivers detect and inform user space about card crashes |
|
via a heartbeat mechanism (see the description of |
|
shutdown_status above). User space can turn off this |
|
notification by setting heartbeat_enable to 0 and enable it by |
|
setting this entry to 1. If this notification is disabled it is |
|
the responsibility of user space to detect card crashes via |
|
alternative means such as a network ping. This setting is |
|
enabled by default.
|
|
|