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