diff --git a/man4/cciss.4 b/man4/cciss.4 index 3168f1374..b1bcc2590 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -182,10 +182,8 @@ A symbolic link to .IR /sys/block/cciss!cXdY . .TP .I /sys/bus/pci/devices//ccissX/rescan -.\" FIXME The following is not clear. How is the rescan kicked off? -.\" Do you write something to this file? -Kicks off a rescan of the controller to discover -logical drive topology changes. +When this file is written to, the driver rescans the controller +to discover any new, removed or modified logical drives. .TP .I /sys/bus/pci/devices//ccissX/resettable A value of 1 displayed in this file indicates that @@ -296,13 +294,14 @@ as SCSI devices to the SCSI midlayer by the driver. Specifically, physical SCSI disk drives are .I not -presented to the SCSI midlayer. -.\" FIXME The following sentence doesn't quite parse smantically, and it -.\" presents multiple ideas. Please rewrite as shorter sentences. -The physical SCSI disk drives are controlled directly by the array controller -hardware and it is important to prevent the kernel from attempting to directly -access these devices too, as if the array controller were merely a SCSI -controller in the same way that we are allowing it to access SCSI tape drives. +presented to the SCSI midlayer. The only disk devices +which are presented to the kernel are are logical +drives which the array controller constructs from regions on +the physical drives. The logical drives are presented to the +block layer not the SCSI midlayer. It is important for the driver +to prevent the kernel from accessing the physical drives directly +since these drives are used by the array controller to construct +the logical drives. .SS SCSI error handling for tape drives and medium changers The Linux SCSI midlayer provides an error-handling protocol which is initiated whenever a SCSI command fails to complete within a @@ -320,9 +319,6 @@ If that doesn't work, the SCSI bus is reset. .IP * If that doesn't work the host bus adapter is reset. .LP -.\" FIXME Check the following. There was a very long sentence here that -.\" was hard to parse. I broke it into 3 sentences. Is the meaning still -.\" correctly conveyed? The .B cciss driver is a block