SDAHCI(3)                                               SDAHCI(3)

          sdahci - AHCI (Advanced Host Controller Interface) SATA
          (Serial ATA) storage device drivers

          bind -a #S /dev
9          /dev/sdctl
9          /dev/sdEn/ctl

          The sdahci driver provides access to AHCI devices via the
          sd(3) interface.  The AHCI programming interface supports up
          to 32 hot-swappable ATAPI or hard disk-like devices per con-
          troller.  The legacy IDE interface provided by sdata.c sup-
          ports up to four drives which are not hot-swappable.  Con-
          troller drive letters are assigned from `E' onward.

          AHCI controllers are detected automatically.  Currently
          Intel and AMD controllers are detected.  Intel controllers
          need to have AHCI enabled in the BIOS.  For `ich' parts this
          typically means enabling enhanced mode and AHCI.  For ESB
          (Enterprise South Bridge) -based parts, only enhanced mode
          needs to be enabled.  Intel ich9-based AHCI does not support
          hot swapping and drives must be connected to the lowest-
          numbered free port.

          The top level control file, /dev/sdctl, supports the follow-
          ing control messages for sdahci:

          ahci debug    Toggle debug messages.  Default is off.
          ahci idprint  Toggle printing of drive identification mes-
                        sages.  Default is on.  Prints short messages
                        when a drive is identified or removed.
          ahci aprint   Print verbose ATAPI debugging messages.
                        Default is off.

          The device-level ctl file supports:

          flushcache    Send the ATA/ATAPI FLUSH CACHE command (0xe7
                        or 0xea).  This command may take up to 60 sec-
                        onds to complete.
          identify      Send the ATA/ATAPI IDENTIFY DEVICE command
                        (0xec).  If device information has changed,
                        the new size, features and serial will be
                        noted.  If changed, I/O on existing file
                        descriptors will result in the error string

     Page 1                       Plan 9             (printed 4/23/24)

     SDAHCI(3)                                               SDAHCI(3)

                        `media or partition has changed'.
          mode speed    Change the connection speed to one of auto,
                        satai or sataii.
          nop           Send the ATA NOP command (0) if the device
                        supports it. Per standard, the result is
                        always an error.
          smart         Send the ATA/ATAPI SMART RETURN STATUS command
                        (0xda).  This will fail unless SMART is
                        enabled on the drive.
          smartdisable  Disable SMART on the drive.  SMART is a per-
                        sistent property of the drive.
          smartenable   Enable SMART on the drive.
          state state   Force a transition to the named state. The
                        states are:
                        null       ignored (may only be reached manu-
                        missing    not detected;
                        new        powered down or newly discovered;
                        ready      ready for commands;
                        reset      being reset gently;
                        portreset  being fully reset;
                        offline    device failed portreset (a port
                                   reset will be attempted periodi-

          For devices present at boot, the transition is from state
          new to state ready.



          None of enclosure management, LED control and port multipli-
          ers are supported.

          ATAPI devices may not be reset when they have outstanding

     Page 2                       Plan 9             (printed 4/23/24)