patch-2.3.34 linux/drivers/block/README.fd

Next file: linux/drivers/block/aec6210.c
Previous file: linux/drivers/block/Config.in
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.3.33/linux/drivers/block/README.fd linux/drivers/block/README.fd
@@ -4,7 +4,7 @@
 =========
 
  A FAQ list may be found in the fdutils package (see below), and also
-at http://poboxes.com/Alain.Knaff/floppy/FAQ.html
+at http://fdutils.linux.lu/FAQ.html
 
 
 LILO configuration options (Thinkpad users, read this)
@@ -13,15 +13,15 @@
  The floppy driver is configured using the 'floppy=' option in
 lilo. This option can be typed at the boot prompt, or entered in the
 lilo configuration file.
- Example: If your kernel is called linux-pre2.0.9, type the following line
+ Example: If your kernel is called linux-2.2.13, type the following line
 at the lilo boot prompt (if you have a thinkpad):
- linux-pre2.0.9 floppy=thinkpad
+ linux-2.2.13 floppy=thinkpad
 You may also enter the following line in /etc/lilo.conf, in the description
-of linux-pre2.0.9:
+of linux-2.2.13:
  append = "floppy=thinkpad"
 
  Several floppy related options may be given, example:
- linux-pre2.0.9 floppy=daring floppy=two_fdc
+ linux-2.2.13 floppy=daring floppy=two_fdc
  append = "floppy=daring floppy=two_fdc"
 
  If you give options both in the lilo config file and on the boot
@@ -30,28 +30,19 @@
 restore the default behavior.
 
  If you use the floppy driver as a module, use the following syntax:
- insmod floppy 'floppy="<options>"'
+ insmod floppy <options>
 
 Example:
- insmod floppy 'floppy="daring two_fdc"'
-
- Note that in this case 'floppy=' should only be typed out once, and
-not once for each option. You need at least modules-1.3.57 for this
-method.  However, the older environment variable based syntax is still
-available:
-(sh syntax): floppy="daring two_fdc" insmod floppy
-(csh syntax): setenv floppy "daring two_fdc" ; insmod floppy
+ insmod floppy daring two_fdc
 
  Some versions of insmod are buggy in one way or another. If you have
 any problems (options not being passed correctly, segfaults during
-insmod), first check whether there is a more recent version. If there
-isn't, use the old method using environment variables.
+insmod), first check whether there is a more recent version.
 
  The floppy related options include:
 
  floppy=asus_pci
-	Sets the bit mask to allow only units 0 and 1. Obsolete, as
-	this is the default setting anyways	
+	Sets the bit mask to allow only units 0 and 1. (default)
 
  floppy=daring
 	Tells the floppy driver that you have a well behaved floppy controller.
@@ -63,14 +54,15 @@
 	with caution.
 
  floppy=one_fdc
-	Tells the floppy driver that you have only floppy controller (default)
+	Tells the floppy driver that you have only one floppy controller.
+	(default)
 
  floppy=two_fdc
  floppy=<address>,two_fdc
-	Tells the floppy driver that you have two floppy controllers. The
-	second floppy controller is assumed to be at <address>. This
-	option is not needed if the second controller is at address
-	0x370, and if you use the 'cmos' option	
+	Tells the floppy driver that you have two floppy controllers.
+	The second floppy controller is assumed to be at <address>.
+	This option is not needed if the second controller is at address
+	0x370, and if you use the 'cmos' option.
 
  floppy=thinkpad
 	Tells the floppy driver that you have a Thinkpad. Thinkpads use an
@@ -89,7 +81,7 @@
 	and is thus harder to find, whereas non-dma buffers may be
 	allocated in virtual memory. However, I advise against this if
 	you have an FDC without a FIFO (8272A or 82072). 82072A and
-	later are OK). You also need at least a 486 to use nodma.
+	later are OK. You also need at least a 486 to use nodma.
 	If you use nodma mode, I suggest you also set the FIFO
 	threshold to 10 or lower, in order to limit the number of data
 	transfer interrupts.
@@ -99,8 +91,8 @@
 	If you want to avoid this, explicitely ask for 'yesdma'.
 
  floppy=yesdma
-	Tells the floppy driver that a workable DMA channel is available
-	(the default).
+	Tells the floppy driver that a workable DMA channel is available.
+	(default)
 
  floppy=nofifo
 	Disables the FIFO entirely. This is needed if you get "Bus
@@ -108,7 +100,7 @@
 	from other devices) while accessing the floppy.
 
  floppy=fifo
-	Enables the FIFO (default)
+	Enables the FIFO. (default)
 
  floppy=<threshold>,fifo_depth
 	Sets the FIFO threshold. This is mostly relevant in DMA
@@ -147,18 +139,18 @@
 	(Note: there are two valid types for ED drives. This is because 5 was
 	initially chosen to represent floppy *tapes*, and 6 for ED drives.
 	AMI ignored this, and used 5 for ED drives. That's why the floppy
-	driver handles both)
+	driver handles both.)
 
  floppy=unexpected_interrupts
-	Print a warning message when an unexpected interrupt is received 
-	(default behavior)
+	Print a warning message when an unexpected interrupt is received.
+	(default)
 
  floppy=no_unexpected_interrupts
  floppy=L40SX
 	Don't print a message when an unexpected interrupt is received. This
 	is needed on IBM L40SX laptops in certain video modes. (There seems
-	to be an interaction between video and floppy. The unexpected interrupts
-	only affect performance, and can safely be ignored.)
+	to be an interaction between video and floppy. The unexpected
+	interrupts affect only performance, and can be safely ignored.)
 
  floppy=broken_dcl
 	Don't use the disk change line, but assume that the disk was
@@ -168,53 +160,52 @@
 	floppy operation less efficient due to unneeded cache
 	flushings, and slightly more unreliable. Please verify your
 	cable, connection and jumper settings if you have any DCL
-	problems. However, some older drives, and also some Laptops
+	problems. However, some older drives, and also some laptops
 	are known not to have a DCL.
 
  floppy=debug
-	Print debugging messages
+	Print debugging messages.
 
  floppy=messages
 	Print informational messages for some operations (disk change
 	notifications, warnings about over and underruns, and about
-	autodetection)
+	autodetection).
 
  floppy=silent_dcl_clear
 	Uses a less noisy way to clear the disk change line (which
-	doesn't involve seeks). Implied by daring.
+	doesn't involve seeks). Implied by 'daring' option.
 
  floppy=<nr>,irq
-	Sets the floppy IRQ to <nr> instead of 6
+	Sets the floppy IRQ to <nr> instead of 6.
 
  floppy=<nr>,dma
-	Sets the floppy DMA channel to <nr> instead of 2
+	Sets the floppy DMA channel to <nr> instead of 2.
 
  floppy=slow
 	Use PS/2 stepping rate:
 	 " PS/2 floppies have much slower step rates than regular floppies.
 	   It's been recommended that take about 1/4 of the default speed
 	   in some more extreme cases."
-	 
+
 
 
 Supporting utilities and additional documentation:
 ==================================================
 
- Additional parameters of the floppy driver can be configured at run
-time.  Utilities which do this can be found in the fdutils
-package. This package also contains a new version of mtools which
-allows to access high capacity disks (up to 1992K on a high density 3
-1/2 disk!). It also contains additional documentation about the floppy
-driver. It can be found at:
- linux.wauug.org:/pub/knaff/fdutils/fdutils-4.3.src.tar.gz
- sunsite.unc.edu:/pub/Linux/system/Misc/fdutils-4.3.src.tar.gz
- tsx-11.mit.edu:/pub/linux/sources/sbin/fdutils-4.3.src.tar.gz
-
- Alpha patches to these utilities are at:
- http://www.club.innet.lu/~year3160/fdutils/ALPHA
- All patches contained in this directory are directly against the base
-version, i.e. DON'T APPLY THEM ON TOP OF EACH OTHER. Only apply the
-most recent one.
+ Additional parameters of the floppy driver can be configured at
+runtime. Utilities which do this can be found in the fdutils package.
+This package also contains a new version of mtools which allows to
+access high capacity disks (up to 1992K on a high density 3 1/2 disk!).
+It also contains additional documentation about the floppy driver.
+
+The latest version can be found at fdutils homepage:
+ http://fdutils.linux.lu
+
+The fdutils-5.3 release can be found at:
+ http://fdutils.linux.lu/fdutils-5.3.src.tar.gz
+ http://www.tux.org/pub/knaff/fdutils/fdutils-5.3.src.tar.gz
+ ftp://tsx-11.mit.edu/pub/linux/sources/sbin/fdutils-5.3.src.tar.gz
+ ftp://metalab.unc.edu/pub/Linux/utils/disk-management/fdutils-5.3.src.tar.gz
 
 Reporting problems about the floppy driver
 ==========================================
@@ -228,4 +219,4 @@
 
  Be sure to read the FAQ before mailing/posting any bug reports!
 
- Alain 
+ Alain

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)