^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 1) What: /sys/class/scsi_host/hostX/isci_id
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 2) Date: June 2011
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 3) Contact: Dave Jiang <dave.jiang@intel.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 4) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 5) This file contains the enumerated host ID for the Intel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 6) SCU controller. The Intel(R) C600 Series Chipset SATA/SAS
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 7) Storage Control Unit embeds up to two 4-port controllers in
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 8) a single PCI device. The controllers are enumerated in order
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 9) which usually means the lowest number scsi_host corresponds
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 10) with the first controller, but this association is not
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 11) guaranteed. The 'isci_id' attribute unambiguously identifies
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 12) the controller index: '0' for the first controller,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 13) '1' for the second.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 14)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 15) What: /sys/class/scsi_host/hostX/acciopath_status
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 16) Date: November 2013
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 17) Contact: Stephen M. Cameron <scameron@beardog.cce.hp.com>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 18) Description: This file contains the current status of the "SSD Smart Path"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 19) feature of HP Smart Array RAID controllers using the hpsa
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 20) driver. SSD Smart Path, when enabled permits the driver to
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 21) send i/o requests directly to physical devices that are part
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 22) of a logical drive, bypassing the controllers firmware RAID
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 23) stack for a performance advantage when possible. A value of
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 24) '1' indicates the feature is enabled, and the controller may
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 25) use the direct i/o path to physical devices. A value of zero
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 26) means the feature is disabled and the controller may not use
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 27) the direct i/o path to physical devices. This setting is
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 28) controller wide, affecting all configured logical drives on the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 29) controller. This file is readable and writable.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 30)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 31) What: /sys/class/scsi_host/hostX/link_power_management_policy
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 32) Date: Oct, 2007
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 33) KernelVersion: v2.6.24
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 34) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 35) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 36) (RW) This parameter allows the user to read and set the link
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 37) (interface) power management.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 38)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 39) There are four possible options:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 40)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 41) min_power: Tell the controller to try to make the link use the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 42) least possible power when possible. This may sacrifice some
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 43) performance due to increased latency when coming out of lower
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 44) power states.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 45)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 46) max_performance: Generally, this means no power management.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 47) Tell the controller to have performance be a priority over power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 48) management.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 49)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 50) medium_power: Tell the controller to enter a lower power state
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 51) when possible, but do not enter the lowest power state, thus
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 52) improving latency over min_power setting.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 53)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 54) med_power_with_dipm: Identical to the existing medium_power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 55) setting except that it enables dipm (device initiated power
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 56) management) on top, which makes it match the Windows IRST (Intel
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 57) Rapid Storage Technology) driver settings. This setting is also
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 58) close to min_power, except that:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 59)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 60) a) It does not use host-initiated slumber mode, but it does
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 61) allow device-initiated slumber
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 62) b) It does not enable low power device sleep mode (DevSlp).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 63)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 64) What: /sys/class/scsi_host/hostX/em_message
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 65) What: /sys/class/scsi_host/hostX/em_message_type
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 66) Date: Jun, 2008
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 67) KernelVersion: v2.6.27
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 68) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 69) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 70) em_message: (RW) Enclosure management support. For the LED
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 71) protocol, writes and reads correspond to the LED message format
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 72) as defined in the AHCI spec.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 73)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 74) The user must turn sw_activity (under `/sys/block/*/device/`)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 75) OFF it they wish to control the activity LED via the em_message
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 76) file.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 77)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 78) em_message_type: (RO) Displays the current enclosure management
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 79) protocol that is being used by the driver (for eg. LED, SAF-TE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 80) SES-2, SGPIO etc).
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 81)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 82) What: /sys/class/scsi_host/hostX/ahci_port_cmd
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 83) What: /sys/class/scsi_host/hostX/ahci_host_caps
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 84) What: /sys/class/scsi_host/hostX/ahci_host_cap2
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 85) Date: Mar, 2010
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 86) KernelVersion: v2.6.35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 87) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 88) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 89) [to be documented]
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 90)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 91) What: /sys/class/scsi_host/hostX/ahci_host_version
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 92) Date: Mar, 2010
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 93) KernelVersion: v2.6.35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 94) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 95) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 96) (RO) Display the version of the AHCI spec implemented by the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 97) host.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 98)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 99) What: /sys/class/scsi_host/hostX/em_buffer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) Date: Apr, 2010
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) KernelVersion: v2.6.35
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) (RW) Allows access to AHCI EM (enclosure management) buffer
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) directly if the host supports EM.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) For eg. the AHCI driver supports SGPIO EM messages but the
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) SATA/AHCI specs do not define the SGPIO message format of the EM
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) buffer. Different hardware(HW) vendors may have different
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) definitions. With the em_buffer attribute, this issue can be
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) solved by allowing HW vendors to provide userland drivers and
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) tools for their SGPIO initiators.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) What: /sys/class/scsi_host/hostX/em_message_supported
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) Date: Oct, 2009
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) KernelVersion: v2.6.39
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) Contact: linux-ide@vger.kernel.org
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) Description:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) (RO) Displays supported enclosure management message types.