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