ref: 06221c080dad6650b1e1af88857951775803bf32
dir: /sys/man/3/sdahci/
.TH SDAHCI 3 .SH NAME sdahci \- AHCI (Advanced Host Controller Interface) SATA (Serial ATA) storage device drivers .SH SYNOPSIS .nf .B bind -a #S /dev .sp 0.3v .BI /dev/sdctl .sp 0.3v .BI /dev/sd En /ctl .BI /dev/sd En /raw .BI /dev/sd En /data \&... .fi .SH DESCRIPTION The .I sdahci driver provides access to AHCI devices via the .IR sd (3) interface. The AHCI programming interface supports up to 32 hot-swappable ATAPI or hard disk-like devices per controller. The legacy IDE interface provided by .B sdata.c supports up to four drives which are not hot-swappable. Controller drive letters are assigned from .L E onward. .PP AHCI controllers are detected automatically. Currently Intel and AMD controllers are detected. Intel controllers need to have AHCI enabled in the BIOS. For .L 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 .BR ich9 -based AHCI does not support hot swapping and drives must be connected to the lowest-numbered free port. .PP The top level control file, .BR /dev/sdctl , supports the following control messages for .IR sdahci : .TF "\fLahci idprint" .TP .B ahci debug Toggle debug messages. Default is off. .TP .B ahci idprint Toggle printing of drive identification messages. Default is on. Prints short messages when a drive is identified or removed. .TP .B ahci aprint Print verbose ATAPI debugging messages. Default is off. .PD .PP The device-level .B ctl file supports: .TF \fLsmartdisable .TP .B flushcache Send the ATA/ATAPI .B FLUSH CACHE command .RB ( 0xe7 or .BR 0xea ). This command may take up to 60 seconds to complete. .TP .B identify Send the ATA/ATAPI .B IDENTIFY DEVICE command .RB ( 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 .LR "media or partition has changed" . .TP .BI "mode " speed Change the connection .I speed to one of .BR auto , .BR satai or .BR sataii . .TP .B nop Send the ATA .B NOP command .RB ( 0 ) if the device supports it. Per standard, the result is always an error. .TP .B smart Send the ATA/ATAPI .B SMART RETURN STATUS command .RB ( 0xda ). This will fail unless SMART is enabled on the drive. .TP .B smartdisable Disable SMART on the drive. SMART is a persistent property of the drive. .TP .B smartenable Enable SMART on the drive. .TP .BI "state " state Force a transition to the named .IR state . The states are: .RS .TF portreset .TP .B null ignored (may only be reached manually); .TP .B missing not detected; .TP .B new powered down or newly discovered; .TP .B ready ready for commands; .TP .B reset being reset gently; .TP .B portreset being fully reset; .TP .B offline device failed .B portreset (a port reset will be attempted periodically). .RE .PD .PP For devices present at boot, the transition is from state .B new to state .BR ready . .SH SOURCE .B /sys/src/9/pc/sdiahci.c .SH SEE ALSO .IR sd (3) .br .BR http://download.intel.com/technology/serialata/pdf/rev1_2.pdf . .SH BUGS None of enclosure management, LED control and port multipliers are supported. .PP ATAPI devices may not be reset when they have outstanding commands.