sysfs-ata 4.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140
  1. What: /sys/class/ata_*
  2. Description:
  3. Provide a place in sysfs for storing the ATA topology of the
  4. system. This allows retrieving various information about ATA
  5. objects.
  6. Files under /sys/class/ata_port
  7. -------------------------------
  8. For each port, a directory ataX is created where X is the ata_port_id of the
  9. port. The device parent is the ata host device.
  10. What: /sys/class/ata_port/ataX/nr_pmp_links
  11. What: /sys/class/ata_port/ataX/idle_irq
  12. Date: May, 2010
  13. KernelVersion: v2.6.37
  14. Contact: Gwendal Grignou <[email protected]>
  15. Description:
  16. nr_pmp_links: (RO) If a SATA Port Multiplier (PM) is
  17. connected, the number of links behind it.
  18. idle_irq: (RO) Number of IRQ received by the port while
  19. idle [some ata HBA only].
  20. What: /sys/class/ata_port/ataX/port_no
  21. Date: May, 2013
  22. KernelVersion: v3.11
  23. Contact: Gwendal Grignou <[email protected]>
  24. Description:
  25. (RO) Host local port number. While registering host controller,
  26. port numbers are tracked based upon number of ports available on
  27. the controller. This attribute is needed by udev for composing
  28. persistent links in /dev/disk/by-path.
  29. Files under /sys/class/ata_link
  30. -------------------------------
  31. Behind each port, there is a ata_link. If there is a SATA PM in the topology, 15
  32. ata_link objects are created.
  33. If a link is behind a port, the directory name is linkX, where X is ata_port_id
  34. of the port. If a link is behind a PM, its name is linkX.Y where X is
  35. ata_port_id of the parent port and Y the PM port.
  36. What: /sys/class/ata_link/linkX[.Y]/hw_sata_spd_limit
  37. What: /sys/class/ata_link/linkX[.Y]/sata_spd_limit
  38. What: /sys/class/ata_link/linkX[.Y]/sata_spd
  39. Date: May, 2010
  40. KernelVersion: v2.6.37
  41. Contact: Gwendal Grignou <[email protected]>
  42. Description:
  43. hw_sata_spd_limit: (RO) Maximum speed supported by the
  44. connected SATA device.
  45. sata_spd_limit: (RO) Maximum speed imposed by libata.
  46. sata_spd: (RO) Current speed of the link
  47. eg. 1.5, 3 Gbps etc.
  48. Files under /sys/class/ata_device
  49. ---------------------------------
  50. Behind each link, up to two ata devices are created.
  51. The name of the directory is devX[.Y].Z where:
  52. - X is ata_port_id of the port where the device is connected,
  53. - Y the port of the PM if any, and
  54. - Z the device id: for PATA, there is usually 2 devices [0,1], only 1 for SATA.
  55. What: /sys/class/ata_device/devX[.Y].Z/spdn_cnt
  56. What: /sys/class/ata_device/devX[.Y].Z/gscr
  57. What: /sys/class/ata_device/devX[.Y].Z/ering
  58. What: /sys/class/ata_device/devX[.Y].Z/id
  59. What: /sys/class/ata_device/devX[.Y].Z/pio_mode
  60. What: /sys/class/ata_device/devX[.Y].Z/xfer_mode
  61. What: /sys/class/ata_device/devX[.Y].Z/dma_mode
  62. What: /sys/class/ata_device/devX[.Y].Z/class
  63. Date: May, 2010
  64. KernelVersion: v2.6.37
  65. Contact: Gwendal Grignou <[email protected]>
  66. Description:
  67. spdn_cnt: (RO) Number of times libata decided to lower the
  68. speed of link due to errors.
  69. gscr: (RO) Cached result of the dump of PM GSCR
  70. register. Valid registers are:
  71. 0: SATA_PMP_GSCR_PROD_ID,
  72. 1: SATA_PMP_GSCR_REV,
  73. 2: SATA_PMP_GSCR_PORT_INFO,
  74. 32: SATA_PMP_GSCR_ERROR,
  75. 33: SATA_PMP_GSCR_ERROR_EN,
  76. 64: SATA_PMP_GSCR_FEAT,
  77. 96: SATA_PMP_GSCR_FEAT_EN,
  78. 130: SATA_PMP_GSCR_SII_GPIO
  79. Only valid if the device is a PM.
  80. ering: (RO) Formatted output of the error ring of the
  81. device.
  82. id: (RO) Cached result of IDENTIFY command, as
  83. described in ATA8 7.16 and 7.17. Only valid if
  84. the device is not a PM.
  85. pio_mode: (RO) PIO transfer mode used by the device.
  86. Mostly used by PATA devices.
  87. xfer_mode: (RO) Current transfer mode. Mostly used by
  88. PATA devices.
  89. dma_mode: (RO) DMA transfer mode used by the device.
  90. Mostly used by PATA devices.
  91. class: (RO) Device class. Can be "ata" for disk,
  92. "atapi" for packet device, "pmp" for PM, or
  93. "none" if no device was found behind the link.
  94. What: /sys/class/ata_device/devX[.Y].Z/trim
  95. Date: May, 2015
  96. KernelVersion: v4.10
  97. Contact: Gwendal Grignou <[email protected]>
  98. Description:
  99. (RO) Shows the DSM TRIM mode currently used by the device. Valid
  100. values are:
  101. unsupported: Drive does not support DSM TRIM
  102. unqueued: Drive supports unqueued DSM TRIM only
  103. queued: Drive supports queued DSM TRIM
  104. forced_unqueued: Drive's queued DSM support is known to
  105. be buggy and only unqueued TRIM commands
  106. are sent