Changeset 165 for trunk/src/os2ahci/README

Timestamp:

Jul 31, 2013, 8:08:59 PM (12 years ago)

Author:

David Azarewicz

Message:

code cleanup - debug messages
fixed defect in smart ioctl

File:

• trunk/src/os2ahci/README (modified) (5 diffs)

trunk/src/os2ahci/README

@@ -17 +17 @@
 Copyright (c) 2011 thi.guten Software Development
 Copyright (c) 2011-2013 Mensys B.V.
+Portions copyright (c) 2013 David Azarewicz
 
 Authors: Christian Mueller, Markus Thielen
@@ -81 +82 @@
 - Add the following line to CONFIG.SYS:
   BASEDEV=OS2AHCI.ADD
+
+
+Reporting Problems
+==================
+
+If you have problems with this driver, please read the Troubleshooting
+page at:
+
+  http://svn.ecomstation.nl/ahci/wiki/Troubleshooting
+
+You can open a ticket at:
+  http://svn.ecomstation.nl/ahci
 
 
@@ -151 +164 @@
 Option                 Description
 ------------------------------------------------------------------------------
-/s                     Enable SCSI emulation for ATAPI units (default = off)
+/s                     Enable SCSI emulation for ATAPI units (default = on)
                        SCSI emulation is required for tools like cdrecord.
 
@@ -346 +359 @@
 Starting with version 1.22, OS2AHCI supports the IOCTL interface required by
 existing SMART monitoring tools. Since those tools are hard-coded to open
-the character device named "IBMS506$", OS2AHCI will now register a device
-with this name, too.
+the character device named "IBMS506$", they will not work with OS2AHCI unless
+modified to open the OS2AHCI$ device. Previous versions of OS2AHCI used to
+register register a duplicate device with the IBMS506$ name, however since
+that caused so many unacceptable problems, that is no longer done. You must
+have a SMART utility that opens the OS2AHCI$ device to access the AHCI driver.
+
+A patched version of the smartctl.exe program is included in the OS2AHCI
+distribution. This patched version simply has the name "IBMS506$" changed
+to "OS2AHCI$" and is otherwise identical. This patched program has been
+renamed to smartahci.exe to distinguish it from the unpatched version.
+The patched smartahci.exe program is provided AS-IS and is completely
+UNSUPPORTED. Use of this program is at your own risk.
 
 NOTES:
-
- - If multiple drivers exporting this character device name are loaded at
-   the same time, the driver loaded last will receive all [SMART] requests.
-   This means that if both DANIS506 and OS2AHCI are loaded and SMART support
-   for OS2AHCI-controlled hard disks is desired, OS2AHCI will have to be
-   loaded after DANIS506. It also means that DANIS506 may have to be told
-   to ignore type 2 controllers (i.e. controllers supporting both SATA and
-   AHCI) using the command line options "/A:x /I".
 
  - The IOCTL interface for SMART is based on the idea of IDE controllers
@@ -381 +396 @@
 Change Log
 ==========
+
+v.1.30 29-Jun-2013 - David Azarewicz
+  Enhanced debug log output
+  Removed the IBMS506 header that was causing problems and shouldn't
+    be there anyway.
+  Fixed a defect in the SMART IOCtl.
 
 v.1.29 12-Jun-2013 - David Azarewicz