0001 What: /sys/class/ata_*
0002 Description:
0003 Provide a place in sysfs for storing the ATA topology of the
0004 system. This allows retrieving various information about ATA
0005 objects.
0006
0007 Files under /sys/class/ata_port
0008 -------------------------------
0009
0010 For each port, a directory ataX is created where X is the ata_port_id of the
0011 port. The device parent is the ata host device.
0012
0013
0014 What: /sys/class/ata_port/ataX/nr_pmp_links
0015 What: /sys/class/ata_port/ataX/idle_irq
0016 Date: May, 2010
0017 KernelVersion: v2.6.37
0018 Contact: Gwendal Grignou <gwendal@chromium.org>
0019 Description:
0020 nr_pmp_links: (RO) If a SATA Port Multiplier (PM) is
0021 connected, the number of links behind it.
0022
0023 idle_irq: (RO) Number of IRQ received by the port while
0024 idle [some ata HBA only].
0025
0026
0027 What: /sys/class/ata_port/ataX/port_no
0028 Date: May, 2013
0029 KernelVersion: v3.11
0030 Contact: Gwendal Grignou <gwendal@chromium.org>
0031 Description:
0032 (RO) Host local port number. While registering host controller,
0033 port numbers are tracked based upon number of ports available on
0034 the controller. This attribute is needed by udev for composing
0035 persistent links in /dev/disk/by-path.
0036
0037 Files under /sys/class/ata_link
0038 -------------------------------
0039
0040 Behind each port, there is a ata_link. If there is a SATA PM in the topology, 15
0041 ata_link objects are created.
0042
0043 If a link is behind a port, the directory name is linkX, where X is ata_port_id
0044 of the port. If a link is behind a PM, its name is linkX.Y where X is
0045 ata_port_id of the parent port and Y the PM port.
0046
0047
0048 What: /sys/class/ata_link/linkX[.Y]/hw_sata_spd_limit
0049 What: /sys/class/ata_link/linkX[.Y]/sata_spd_limit
0050 What: /sys/class/ata_link/linkX[.Y]/sata_spd
0051 Date: May, 2010
0052 KernelVersion: v2.6.37
0053 Contact: Gwendal Grignou <gwendal@chromium.org>
0054 Description:
0055 hw_sata_spd_limit: (RO) Maximum speed supported by the
0056 connected SATA device.
0057
0058 sata_spd_limit: (RO) Maximum speed imposed by libata.
0059
0060 sata_spd: (RO) Current speed of the link
0061 eg. 1.5, 3 Gbps etc.
0062
0063
0064 Files under /sys/class/ata_device
0065 ---------------------------------
0066
0067 Behind each link, up to two ata devices are created.
0068 The name of the directory is devX[.Y].Z where:
0069 - X is ata_port_id of the port where the device is connected,
0070 - Y the port of the PM if any, and
0071 - Z the device id: for PATA, there is usually 2 devices [0,1], only 1 for SATA.
0072
0073
0074 What: /sys/class/ata_device/devX[.Y].Z/spdn_cnt
0075 What: /sys/class/ata_device/devX[.Y].Z/gscr
0076 What: /sys/class/ata_device/devX[.Y].Z/ering
0077 What: /sys/class/ata_device/devX[.Y].Z/id
0078 What: /sys/class/ata_device/devX[.Y].Z/pio_mode
0079 What: /sys/class/ata_device/devX[.Y].Z/xfer_mode
0080 What: /sys/class/ata_device/devX[.Y].Z/dma_mode
0081 What: /sys/class/ata_device/devX[.Y].Z/class
0082 Date: May, 2010
0083 KernelVersion: v2.6.37
0084 Contact: Gwendal Grignou <gwendal@chromium.org>
0085 Description:
0086 spdn_cnt: (RO) Number of times libata decided to lower the
0087 speed of link due to errors.
0088
0089 gscr: (RO) Cached result of the dump of PM GSCR
0090 register. Valid registers are:
0091
0092 0: SATA_PMP_GSCR_PROD_ID,
0093 1: SATA_PMP_GSCR_REV,
0094 2: SATA_PMP_GSCR_PORT_INFO,
0095 32: SATA_PMP_GSCR_ERROR,
0096 33: SATA_PMP_GSCR_ERROR_EN,
0097 64: SATA_PMP_GSCR_FEAT,
0098 96: SATA_PMP_GSCR_FEAT_EN,
0099 130: SATA_PMP_GSCR_SII_GPIO
0100
0101 Only valid if the device is a PM.
0102
0103 ering: (RO) Formatted output of the error ring of the
0104 device.
0105
0106 id: (RO) Cached result of IDENTIFY command, as
0107 described in ATA8 7.16 and 7.17. Only valid if
0108 the device is not a PM.
0109
0110 pio_mode: (RO) PIO transfer mode used by the device.
0111 Mostly used by PATA devices.
0112
0113 xfer_mode: (RO) Current transfer mode. Mostly used by
0114 PATA devices.
0115
0116 dma_mode: (RO) DMA transfer mode used by the device.
0117 Mostly used by PATA devices.
0118
0119 class: (RO) Device class. Can be "ata" for disk,
0120 "atapi" for packet device, "pmp" for PM, or
0121 "none" if no device was found behind the link.
0122
0123
0124 What: /sys/class/ata_device/devX[.Y].Z/trim
0125 Date: May, 2015
0126 KernelVersion: v4.10
0127 Contact: Gwendal Grignou <gwendal@chromium.org>
0128 Description:
0129 (RO) Shows the DSM TRIM mode currently used by the device. Valid
0130 values are:
0131
0132 unsupported: Drive does not support DSM TRIM
0133
0134 unqueued: Drive supports unqueued DSM TRIM only
0135
0136 queued: Drive supports queued DSM TRIM
0137
0138 forced_unqueued: Drive's queued DSM support is known to
0139 be buggy and only unqueued TRIM commands
0140 are sent
