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