einj.txt 2.0 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. APEI Error INJection
  2. ~~~~~~~~~~~~~~~~~~~~
  3. EINJ provides a hardware error injection mechanism
  4. It is very useful for debugging and testing of other APEI and RAS features.
  5. To use EINJ, make sure the following are enabled in your kernel
  6. configuration:
  7. CONFIG_DEBUG_FS
  8. CONFIG_ACPI_APEI
  9. CONFIG_ACPI_APEI_EINJ
  10. The user interface of EINJ is debug file system, under the
  11. directory apei/einj. The following files are provided.
  12. - available_error_type
  13. Reading this file returns the error injection capability of the
  14. platform, that is, which error types are supported. The error type
  15. definition is as follow, the left field is the error type value, the
  16. right field is error description.
  17. 0x00000001 Processor Correctable
  18. 0x00000002 Processor Uncorrectable non-fatal
  19. 0x00000004 Processor Uncorrectable fatal
  20. 0x00000008 Memory Correctable
  21. 0x00000010 Memory Uncorrectable non-fatal
  22. 0x00000020 Memory Uncorrectable fatal
  23. 0x00000040 PCI Express Correctable
  24. 0x00000080 PCI Express Uncorrectable fatal
  25. 0x00000100 PCI Express Uncorrectable non-fatal
  26. 0x00000200 Platform Correctable
  27. 0x00000400 Platform Uncorrectable non-fatal
  28. 0x00000800 Platform Uncorrectable fatal
  29. The format of file contents are as above, except there are only the
  30. available error type lines.
  31. - error_type
  32. This file is used to set the error type value. The error type value
  33. is defined in "available_error_type" description.
  34. - error_inject
  35. Write any integer to this file to trigger the error
  36. injection. Before this, please specify all necessary error
  37. parameters.
  38. - param1
  39. This file is used to set the first error parameter value. Effect of
  40. parameter depends on error_type specified. For memory error, this is
  41. physical memory address.
  42. - param2
  43. This file is used to set the second error parameter value. Effect of
  44. parameter depends on error_type specified. For memory error, this is
  45. physical memory address mask.
  46. For more information about EINJ, please refer to ACPI specification
  47. version 4.0, section 17.5.