- Add shim to simplify migration to the CAM-based ATA. For each new adaX

device in /dev/ create symbolic link with adY name, trying to mimic old ATA
numbering. Imitation is not complete, but should be enough in most cases to
mount file systems without touching /etc/fstab.
 - To know what behavior to mimic, restore ATA_STATIC_ID option in cases
where it was present before.
 - Add some more details to UPDATING.

1 files changed, 11 insertions, 2 deletions

diff --git a/UPDATING b/UPDATING
index 217d141..d7901f8 100644
--- a/UPDATING
+++ b/UPDATING
@@ -30,7 +30,17 @@ NOTE TO PEOPLE WHO THINK THAT FreeBSD 9.x IS SLOW:
 	them respectively (adX -> adaY, acdX -> cdY, afdX -> daY, astX -> saY,
 	where 'Y's are the sequential numbers starting from zero for each type
 	in order of detection, unless configured otherwise with tunables,
-	see cam(4)).
+	see cam(4)). There will be symbolic links created in /dev/ to map
+	old adX devices to the respective adaY. They should provide basic
+	compatibility for file systems mounting in most cases, but they do
+	not support old user-level APIs and do not have respective providers
+	in GEOM. Consider using updated management tools with new device names.
+
+	It is possible to load devices ahci, ata, siis and mvs as modules,
+	but option ATA_CAM should remain in kernel configuration to make ata
+	module work as CAM driver supporting legacy ATA controllers. Device ata
+	still can be used in modular fashion (atacore + ...). Modules atadisk
+	and atapi* are not used and won't affect operation in ATA_CAM mode.
 
 	ataraid(4) functionality is now supported by the RAID GEOM class.
 	To use it you can load geom_raid kernel module and use graid(8) tool
@@ -49,7 +59,6 @@ NOTE TO PEOPLE WHO THINK THAT FreeBSD 9.x IS SLOW:
 	    device         atapicd         # ATAPI CDROM drives
 	    device         atapifd         # ATAPI floppy drives
 	    device         atapist         # ATAPI tape drives
-	    options        ATA_STATIC_ID   # Static device numbering
 
 20110423:
 	The default NFS server has been changed to the new server, which