~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/Documentation/ABI/testing/sysfs-ata

Version: ~ [ linux-6.12-rc7 ] ~ [ linux-6.11.7 ] ~ [ linux-6.10.14 ] ~ [ linux-6.9.12 ] ~ [ linux-6.8.12 ] ~ [ linux-6.7.12 ] ~ [ linux-6.6.60 ] ~ [ linux-6.5.13 ] ~ [ linux-6.4.16 ] ~ [ linux-6.3.13 ] ~ [ linux-6.2.16 ] ~ [ linux-6.1.116 ] ~ [ linux-6.0.19 ] ~ [ linux-5.19.17 ] ~ [ linux-5.18.19 ] ~ [ linux-5.17.15 ] ~ [ linux-5.16.20 ] ~ [ linux-5.15.171 ] ~ [ linux-5.14.21 ] ~ [ linux-5.13.19 ] ~ [ linux-5.12.19 ] ~ [ linux-5.11.22 ] ~ [ linux-5.10.229 ] ~ [ linux-5.9.16 ] ~ [ linux-5.8.18 ] ~ [ linux-5.7.19 ] ~ [ linux-5.6.19 ] ~ [ linux-5.5.19 ] ~ [ linux-5.4.285 ] ~ [ linux-5.3.18 ] ~ [ linux-5.2.21 ] ~ [ linux-5.1.21 ] ~ [ linux-5.0.21 ] ~ [ linux-4.20.17 ] ~ [ linux-4.19.323 ] ~ [ linux-4.18.20 ] ~ [ linux-4.17.19 ] ~ [ linux-4.16.18 ] ~ [ linux-4.15.18 ] ~ [ linux-4.14.336 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.337 ] ~ [ linux-4.4.302 ] ~ [ linux-3.10.108 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.12 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

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

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

sflogo.php