Documentation/ABI/testing/sysfs-class-mic

Source file repositories/reference/linux-study-clean/Documentation/ABI/testing/sysfs-class-mic

File Facts

System
Linux kernel
Corpus path
Documentation/ABI/testing/sysfs-class-mic
Extension
[no extension]
Size
7020 bytes
Lines
179
Domain
Support Tooling And Documentation
Bucket
Documentation
Inferred role
Support Tooling And Documentation: Documentation
Status
atlas-only

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

Dependency Surface

Detected Declarations

Annotated Snippet

What:		/sys/class/mic/
Date:		October 2013
KernelVersion:	3.13
Contact:	Sudeep Dutt <sudeep.dutt@intel.com>
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 <sudeep.dutt@intel.com>
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 <sudeep.dutt@intel.com>
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 <sudeep.dutt@intel.com>
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 <sudeep.dutt@intel.com>
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.
		==========  ===================================================

Annotation

Implementation Notes