[PATCH] cciss: Documentation update

* [PATCH] cciss: Documentation update
@ 2004-12-26 13:17 James Nelson
  2004-12-26 13:18 ` [PATCH] cciss: Correct mailing list address in source code James Nelson
  2004-12-26 13:18 ` [PATCH] cpqarray: " James Nelson
  0 siblings, 2 replies; 6+ messages in thread
From: James Nelson @ 2004-12-26 13:17 UTC (permalink / raw)
  To: linux-kernel, iss_storagedev; +Cc: akpm, James Nelson

Patch still applies to 2.6.10.

Updates to cciss documentation.

mkdev.cciss is no longer needed, since it is handled by the MAKEDEV program.

diffstat output:

 00-INDEX    |    2 --
 cciss.txt   |   27 +++++++++++++--------------
 mkdev.cciss |   40 ----------------------------------------
 3 files changed, 13 insertions(+), 56 deletions(-)

Signed-off-by: James Nelson <james4765@gmail.com>

diff -urN --exclude='*~' linux-2.6.10-original/Documentation/00-INDEX linux-2.6.10/Documentation/00-INDEX

--- linux-2.6.10-original/Documentation/00-INDEX	2004-12-24 16:34:26.000000000 -0500
+++ linux-2.6.10/Documentation/00-INDEX	2004-12-26 08:12:16.241315851 -0500
@@ -174,8 +174,6 @@
 	- info on typical Linux memory problems.
 mips/
 	- directory with info about Linux on MIPS architecture.
-mkdev.cciss
-	- script to make /dev entries for SMART controllers (see cciss.txt).
 mono.txt
 	- how to execute Mono-based .NET binaries with the help of BINFMT_MISC.
 moxa-smartio
diff -urN --exclude='*~' linux-2.6.10-original/Documentation/cciss.txt linux-2.6.10/Documentation/cciss.txt
--- linux-2.6.10-original/Documentation/cciss.txt	2004-12-24 16:34:00.000000000 -0500
+++ linux-2.6.10/Documentation/cciss.txt	2004-12-26 08:12:16.241315851 -0500
@@ -17,25 +17,27 @@
 	* SA 6422
 	* SA V100
 
-If nodes are not already created in the /dev/cciss directory
+If nodes are not already created in the /dev/cciss directory, run as root:
 
-# mkdev.cciss [ctlrs]
-
-Where ctlrs is the number of controllers you have (defaults to 1 if not
-specified).
+# cd /dev
+# ./MAKEDEV cciss
 
 Device Naming:
 --------------
 
-You need some entries in /dev for the cciss device.  The mkdev.cciss script
+You need some entries in /dev for the cciss device.  The MAKEDEV script
 can make device nodes for you automatically.  Currently the device setup
 is as follows:
 
 Major numbers:
 	104	cciss0	
 	105	cciss1	
-	106	cciss2 
-	etc...
+	106	cciss2
+	105	cciss3
+	108	cciss4
+	109	cciss5
+	110	cciss6
+	111	cciss7
 
 Minor numbers:
         b7 b6 b5 b4 b3 b2 b1 b0
@@ -45,7 +47,7 @@
              |
              +-------------------- Logical Volume number
 
-The suggested device naming scheme is:
+The device naming scheme is:
 /dev/cciss/c0d0			Controller 0, disk 0, whole device
 /dev/cciss/c0d0p1		Controller 0, disk 0, partition 1
 /dev/cciss/c0d0p2		Controller 0, disk 0, partition 2
@@ -117,16 +119,13 @@
 
 Note that the naming convention of the /proc filesystem entries 
 contains a number in addition to the driver name.  (E.g. "cciss0" 
-instead of just "cciss" which you might expect.)   This is because 
-of changes to the 2.4 kernel PCI interface related to PCI hot plug
-that imply the driver must register with the SCSI mid layer once per
-adapter instance rather than once per driver.
+instead of just "cciss" which you might expect.)
 
 Note: ONLY sequential access devices and medium changers are presented 
 as SCSI devices to the SCSI mid layer by the cciss driver.  Specifically, 
 physical SCSI disk drives are NOT presented to the SCSI mid layer.  The 
 physical SCSI disk drives are controlled directly by the array controller 
-hardware and it is important to prevent the OS from attempting to directly 
+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.
 
diff -urN --exclude='*~' linux-2.6.10-original/Documentation/mkdev.cciss linux-2.6.10/Documentation/mkdev.cciss
--- linux-2.6.10-original/Documentation/mkdev.cciss	2004-12-24 16:33:52.000000000 -0500
+++ linux-2.6.10/Documentation/mkdev.cciss	1969-12-31 19:00:00.000000000 -0500
@@ -1,40 +0,0 @@
-#!/bin/sh
-# Script to create device nodes for SMART array controllers
-# Usage:
-#	mkdev.cciss [num controllers] [num log volumes] [num partitions]
-#
-# With no arguments, the script assumes 1 controller, 16 logical volumes,
-# and 16 partitions/volume, which is adequate for most configurations.
-#
-# If you had 5 controllers and were planning on no more than 4 logical volumes
-# each, using a maximum of 8 partitions per volume, you could say:
-#
-# mkdev.cciss 5 4 8
-#
-# Of course, this has no real benefit over "mkdev.cciss 5" except that it
-# doesn't create so many device nodes in /dev/cciss.
-
-NR_CTLR=${1-1}
-NR_VOL=${2-16}
-NR_PART=${3-16}
-
-if [ ! -d /dev/cciss ]; then
-	mkdir -p /dev/cciss
-fi
-
-C=0; while [ $C -lt $NR_CTLR ]; do
-	MAJ=`expr $C + 104`
-	D=0; while [ $D -lt $NR_VOL ]; do
-		P=0; while [ $P -lt $NR_PART ]; do
-			MIN=`expr $D \* 16 + $P`
-			if [ $P -eq 0 ]; then
-				mknod /dev/cciss/c${C}d${D} b $MAJ $MIN
-			else
-				mknod /dev/cciss/c${C}d${D}p${P} b $MAJ $MIN
-			fi
-			P=`expr $P + 1`
-		done
-		D=`expr $D + 1`
-	done
-	C=`expr $C + 1`
-done

^ permalink raw reply	[flat|nested] 6+ messages in thread