term% cat index.txt SDAHCI(3) Library Functions Manual SDAHCI(3)
NAME
sdahci - AHCI (Advanced Host Controller Interface) SATA (Serial ATA)
storage device drivers
SYNOPSIS
bind -a #S /dev
/dev/sdctl
/dev/sdEn/ctl
/dev/sdEn/raw
/dev/sdEn/data
...
DESCRIPTION
The sdahci driver provides access to AHCI devices via the sd(3) inter‐
face. The AHCI programming interface supports up to 32 hot-swappable
ATAPI or hard disk-like devices per controller. The legacy IDE inter‐
face provided by sdata.c supports up to four drives which are not hot-
swappable. Controller drive letters are assigned from onward.
AHCI controllers are detected automatically. Currently Intel and AMD
controllers are detected. Intel controllers need to have AHCI enabled
in the BIOS. For 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 following control
messages for sdahci:
iahci debug
Toggle debug messages. Default is off.
iahci idprint
Toggle printing of drive identification messages. Default is
on. Prints short messages when a drive is identified or re‐
moved.
iahci 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 seconds 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 re‐
sult in the error string
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 persistent 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 manually);
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
periodically).
For devices present at boot, the transition is from state new to state
ready.
SOURCE
/sys/src/9/pc/sdiahci.c
SEE ALSO
sd(3)
http://download.intel.com/technology/serialata/pdf/rev1_2.pdf.
BUGS
None of enclosure management, LED control and port multipliers are sup‐
ported.
ATAPI devices may not be reset when they have outstanding commands.
SDAHCI(3)