Commit 39443104 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab

docs: blockdev: convert to ReST

Rename the blockdev documentation files to ReST, add an
index for them and adjust in order to produce a nice html
output via the Sphinx build system.

The drbd sub-directory contains some graphs and data flows.
Add those too to the documentation.

At its new index.rst, let's add a :orphan: while this is not linked to
the main index.rst file, in order to avoid build warnings.
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab+samsung@kernel.org>
parent e0ae1544
...@@ -1249,7 +1249,7 @@ ...@@ -1249,7 +1249,7 @@
See also Documentation/fault-injection/. See also Documentation/fault-injection/.
floppy= [HW] floppy= [HW]
See Documentation/blockdev/floppy.txt. See Documentation/blockdev/floppy.rst.
force_pal_cache_flush force_pal_cache_flush
[IA-64] Avoid check_sal_cache_flush which may hang on [IA-64] Avoid check_sal_cache_flush which may hang on
...@@ -2234,7 +2234,7 @@ ...@@ -2234,7 +2234,7 @@
memblock=debug [KNL] Enable memblock debug messages. memblock=debug [KNL] Enable memblock debug messages.
load_ramdisk= [RAM] List of ramdisks to load from floppy load_ramdisk= [RAM] List of ramdisks to load from floppy
See Documentation/blockdev/ramdisk.txt. See Documentation/blockdev/ramdisk.rst.
lockd.nlm_grace_period=P [NFS] Assign grace period. lockd.nlm_grace_period=P [NFS] Assign grace period.
Format: <integer> Format: <integer>
...@@ -3268,7 +3268,7 @@ ...@@ -3268,7 +3268,7 @@
pcd. [PARIDE] pcd. [PARIDE]
See header of drivers/block/paride/pcd.c. See header of drivers/block/paride/pcd.c.
See also Documentation/blockdev/paride.txt. See also Documentation/blockdev/paride.rst.
pci=option[,option...] [PCI] various PCI subsystem options. pci=option[,option...] [PCI] various PCI subsystem options.
...@@ -3512,7 +3512,7 @@ ...@@ -3512,7 +3512,7 @@
needed on a platform with proper driver support. needed on a platform with proper driver support.
pd. [PARIDE] pd. [PARIDE]
See Documentation/blockdev/paride.txt. See Documentation/blockdev/paride.rst.
pdcchassis= [PARISC,HW] Disable/Enable PDC Chassis Status codes at pdcchassis= [PARISC,HW] Disable/Enable PDC Chassis Status codes at
boot time. boot time.
...@@ -3527,10 +3527,10 @@ ...@@ -3527,10 +3527,10 @@
and performance comparison. and performance comparison.
pf. [PARIDE] pf. [PARIDE]
See Documentation/blockdev/paride.txt. See Documentation/blockdev/paride.rst.
pg. [PARIDE] pg. [PARIDE]
See Documentation/blockdev/paride.txt. See Documentation/blockdev/paride.rst.
pirq= [SMP,APIC] Manual mp-table setup pirq= [SMP,APIC] Manual mp-table setup
See Documentation/x86/i386/IO-APIC.rst. See Documentation/x86/i386/IO-APIC.rst.
...@@ -3642,7 +3642,7 @@ ...@@ -3642,7 +3642,7 @@
prompt_ramdisk= [RAM] List of RAM disks to prompt for floppy disk prompt_ramdisk= [RAM] List of RAM disks to prompt for floppy disk
before loading. before loading.
See Documentation/blockdev/ramdisk.txt. See Documentation/blockdev/ramdisk.rst.
psi= [KNL] Enable or disable pressure stall information psi= [KNL] Enable or disable pressure stall information
tracking. tracking.
...@@ -3664,7 +3664,7 @@ ...@@ -3664,7 +3664,7 @@
pstore.backend= Specify the name of the pstore backend to use pstore.backend= Specify the name of the pstore backend to use
pt. [PARIDE] pt. [PARIDE]
See Documentation/blockdev/paride.txt. See Documentation/blockdev/paride.rst.
pti= [X86_64] Control Page Table Isolation of user and pti= [X86_64] Control Page Table Isolation of user and
kernel address spaces. Disabling this feature kernel address spaces. Disabling this feature
...@@ -3693,7 +3693,7 @@ ...@@ -3693,7 +3693,7 @@
See Documentation/admin-guide/md.rst. See Documentation/admin-guide/md.rst.
ramdisk_size= [RAM] Sizes of RAM disks in kilobytes ramdisk_size= [RAM] Sizes of RAM disks in kilobytes
See Documentation/blockdev/ramdisk.txt. See Documentation/blockdev/ramdisk.rst.
random.trust_cpu={on,off} random.trust_cpu={on,off}
[KNL] Enable or disable trusting the use of the [KNL] Enable or disable trusting the use of the
......
================================
kernel data structure for DRBD-9
================================
This describes the in kernel data structure for DRBD-9. Starting with This describes the in kernel data structure for DRBD-9. Starting with
Linux v3.14 we are reorganizing DRBD to use this data structure. Linux v3.14 we are reorganizing DRBD to use this data structure.
...@@ -10,7 +14,7 @@ device is represented by a block device locally. ...@@ -10,7 +14,7 @@ device is represented by a block device locally.
The DRBD objects are interconnected to form a matrix as depicted below; a The DRBD objects are interconnected to form a matrix as depicted below; a
drbd_peer_device object sits at each intersection between a drbd_device and a drbd_peer_device object sits at each intersection between a drbd_device and a
drbd_connection: drbd_connection::
/--------------+---------------+.....+---------------\ /--------------+---------------+.....+---------------\
| resource | device | | device | | resource | device | | device |
......
.. The here included files are intended to help understand the implementation
Data flows that Relate some functions, and write packets
========================================================
.. kernel-figure:: DRBD-8.3-data-packets.svg
:alt: DRBD-8.3-data-packets.svg
:align: center
.. kernel-figure:: DRBD-data-packets.svg
:alt: DRBD-data-packets.svg
:align: center
Sub graphs of DRBD's state transitions
======================================
.. kernel-figure:: conn-states-8.dot
:alt: conn-states-8.dot
:align: center
.. kernel-figure:: disk-states-8.dot
:alt: disk-states-8.dot
:align: center
.. kernel-figure:: node-states-8.dot
:alt: node-states-8.dot
:align: center
==========================================
Distributed Replicated Block Device - DRBD
==========================================
Description Description
===========
DRBD is a shared-nothing, synchronously replicated block device. It DRBD is a shared-nothing, synchronously replicated block device. It
is designed to serve as a building block for high availability is designed to serve as a building block for high availability
...@@ -7,10 +12,8 @@ Description ...@@ -7,10 +12,8 @@ Description
Please visit http://www.drbd.org to find out more. Please visit http://www.drbd.org to find out more.
The here included files are intended to help understand the implementation .. toctree::
:maxdepth: 1
DRBD-8.3-data-packets.svg, DRBD-data-packets.svg
relates some functions, and write packets.
conn-states-8.dot, disk-states-8.dot, node-states-8.dot data-structure-v9
The sub graphs of DRBD's state transitions figures
This file describes the floppy driver. =============
Floppy Driver
=============
FAQ list: FAQ list:
========= =========
A FAQ list may be found in the fdutils package (see below), and also A FAQ list may be found in the fdutils package (see below), and also
at <http://fdutils.linux.lu/faq.html>. at <http://fdutils.linux.lu/faq.html>.
LILO configuration options (Thinkpad users, read this) LILO configuration options (Thinkpad users, read this)
====================================================== ======================================================
The floppy driver is configured using the 'floppy=' option in 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. This option can be typed at the boot prompt, or entered in the
lilo configuration file. lilo configuration file.
Example: If your kernel is called linux-2.6.9, type the following line Example: If your kernel is called linux-2.6.9, type the following line
at the lilo boot prompt (if you have a thinkpad): at the lilo boot prompt (if you have a thinkpad)::
linux-2.6.9 floppy=thinkpad linux-2.6.9 floppy=thinkpad
You may also enter the following line in /etc/lilo.conf, in the description You may also enter the following line in /etc/lilo.conf, in the description
of linux-2.6.9: of linux-2.6.9::
append = "floppy=thinkpad" append = "floppy=thinkpad"
Several floppy related options may be given, example: Several floppy related options may be given, example::
linux-2.6.9 floppy=daring floppy=two_fdc linux-2.6.9 floppy=daring floppy=two_fdc
append = "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 If you give options both in the lilo config file and on the boot
prompt, the option strings of both places are concatenated, the boot prompt, the option strings of both places are concatenated, the boot
prompt options coming last. That's why there are also options to prompt options coming last. That's why there are also options to
restore the default behavior. restore the default behavior.
...@@ -38,21 +40,23 @@ restore the default behavior. ...@@ -38,21 +40,23 @@ restore the default behavior.
Module configuration options Module configuration options
============================ ============================
If you use the floppy driver as a module, use the following syntax: If you use the floppy driver as a module, use the following syntax::
modprobe floppy floppy="<options>"
modprobe floppy floppy="<options>"
Example::
Example:
modprobe floppy floppy="omnibook messages" modprobe floppy floppy="omnibook messages"
If you need certain options enabled every time you load the floppy driver, If you need certain options enabled every time you load the floppy driver,
you can put: you can put::
options floppy floppy="omnibook messages" options floppy floppy="omnibook messages"
in a configuration file in /etc/modprobe.d/. in a configuration file in /etc/modprobe.d/.
The floppy driver related options are: The floppy driver related options are:
floppy=asus_pci floppy=asus_pci
Sets the bit mask to allow only units 0 and 1. (default) Sets the bit mask to allow only units 0 and 1. (default)
...@@ -70,8 +74,7 @@ in a configuration file in /etc/modprobe.d/. ...@@ -70,8 +74,7 @@ in a configuration file in /etc/modprobe.d/.
Tells the floppy driver that you have only one floppy controller. Tells the floppy driver that you have only one floppy controller.
(default) (default)
floppy=two_fdc floppy=two_fdc / floppy=<address>,two_fdc
floppy=<address>,two_fdc
Tells the floppy driver that you have two floppy controllers. Tells the floppy driver that you have two floppy controllers.
The second floppy controller is assumed to be at <address>. The second floppy controller is assumed to be at <address>.
This option is not needed if the second controller is at address This option is not needed if the second controller is at address
...@@ -84,8 +87,7 @@ in a configuration file in /etc/modprobe.d/. ...@@ -84,8 +87,7 @@ in a configuration file in /etc/modprobe.d/.
floppy=0,thinkpad floppy=0,thinkpad
Tells the floppy driver that you don't have a Thinkpad. Tells the floppy driver that you don't have a Thinkpad.
floppy=omnibook floppy=omnibook / floppy=nodma
floppy=nodma
Tells the floppy driver not to use Dma for data transfers. Tells the floppy driver not to use Dma for data transfers.
This is needed on HP Omnibooks, which don't have a workable This is needed on HP Omnibooks, which don't have a workable
DMA channel for the floppy driver. This option is also useful DMA channel for the floppy driver. This option is also useful
...@@ -144,14 +146,16 @@ in a configuration file in /etc/modprobe.d/. ...@@ -144,14 +146,16 @@ in a configuration file in /etc/modprobe.d/.
described in the physical CMOS), or if your BIOS uses described in the physical CMOS), or if your BIOS uses
non-standard CMOS types. The CMOS types are: non-standard CMOS types. The CMOS types are:
0 - Use the value of the physical CMOS == ==================================
1 - 5 1/4 DD 0 Use the value of the physical CMOS
2 - 5 1/4 HD 1 5 1/4 DD
3 - 3 1/2 DD 2 5 1/4 HD
4 - 3 1/2 HD 3 3 1/2 DD
5 - 3 1/2 ED 4 3 1/2 HD
6 - 3 1/2 ED 5 3 1/2 ED
16 - unknown or not installed 6 3 1/2 ED
16 unknown or not installed
== ==================================
(Note: there are two valid types for ED drives. This is because 5 was (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. initially chosen to represent floppy *tapes*, and 6 for ED drives.
...@@ -162,8 +166,7 @@ in a configuration file in /etc/modprobe.d/. ...@@ -162,8 +166,7 @@ in a configuration file in /etc/modprobe.d/.
Print a warning message when an unexpected interrupt is received. Print a warning message when an unexpected interrupt is received.
(default) (default)
floppy=no_unexpected_interrupts floppy=no_unexpected_interrupts / floppy=L40SX
floppy=L40SX
Don't print a message when an unexpected interrupt is received. This Don't print a message when an unexpected interrupt is received. This
is needed on IBM L40SX laptops in certain video modes. (There seems is needed on IBM L40SX laptops in certain video modes. (There seems
to be an interaction between video and floppy. The unexpected to be an interaction between video and floppy. The unexpected
...@@ -199,47 +202,54 @@ in a configuration file in /etc/modprobe.d/. ...@@ -199,47 +202,54 @@ in a configuration file in /etc/modprobe.d/.
Sets the floppy DMA channel to <nr> instead of 2. Sets the floppy DMA channel to <nr> instead of 2.
floppy=slow floppy=slow
Use PS/2 stepping rate: Use PS/2 stepping rate::
" PS/2 floppies have much slower step rates than regular floppies.
PS/2 floppies have much slower step rates than regular floppies.
It's been recommended that take about 1/4 of the default speed It's been recommended that take about 1/4 of the default speed
in some more extreme cases." in some more extreme cases.
Supporting utilities and additional documentation: Supporting utilities and additional documentation:
================================================== ==================================================
Additional parameters of the floppy driver can be configured at Additional parameters of the floppy driver can be configured at
runtime. Utilities which do this can be found in the fdutils package. runtime. Utilities which do this can be found in the fdutils package.
This package also contains a new version of mtools which allows to 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!). 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 also contains additional documentation about the floppy driver.
The latest version can be found at fdutils homepage: The latest version can be found at fdutils homepage:
http://fdutils.linux.lu http://fdutils.linux.lu
The fdutils releases can be found at: The fdutils releases can be found at:
http://fdutils.linux.lu/download.html http://fdutils.linux.lu/download.html
http://www.tux.org/pub/knaff/fdutils/ http://www.tux.org/pub/knaff/fdutils/
ftp://metalab.unc.edu/pub/Linux/utils/disk-management/ ftp://metalab.unc.edu/pub/Linux/utils/disk-management/
Reporting problems about the floppy driver Reporting problems about the floppy driver
========================================== ==========================================
If you have a question or a bug report about the floppy driver, mail If you have a question or a bug report about the floppy driver, mail
me at Alain.Knaff@poboxes.com . If you post to Usenet, preferably use me at Alain.Knaff@poboxes.com . If you post to Usenet, preferably use
comp.os.linux.hardware. As the volume in these groups is rather high, comp.os.linux.hardware. As the volume in these groups is rather high,
be sure to include the word "floppy" (or "FLOPPY") in the subject be sure to include the word "floppy" (or "FLOPPY") in the subject
line. If the reported problem happens when mounting floppy disks, be line. If the reported problem happens when mounting floppy disks, be
sure to mention also the type of the filesystem in the subject line. sure to mention also the type of the filesystem in the subject line.
Be sure to read the FAQ before mailing/posting any bug reports! Be sure to read the FAQ before mailing/posting any bug reports!
Alain Alain
Changelog Changelog
========= =========
10-30-2004 : Cleanup, updating, add reference to module configuration. 10-30-2004 :
Cleanup, updating, add reference to module configuration.
James Nelson <james4765@gmail.com> James Nelson <james4765@gmail.com>
6-3-2000 : Original Document 6-3-2000 :
Original Document
:orphan:
===========================
The Linux RapidIO Subsystem
===========================
.. toctree::
:maxdepth: 1
floppy
nbd
paride
ramdisk
zram
drbd/index
==================================
Network Block Device (TCP version) Network Block Device (TCP version)
================================== ==================================
...@@ -28,4 +29,3 @@ max_part ...@@ -28,4 +29,3 @@ max_part
nbds_max nbds_max
Number of block devices that should be initialized (default: 16). Number of block devices that should be initialized (default: 16).
==========================================
Using the RAM disk block device with Linux Using the RAM disk block device with Linux
------------------------------------------ ==========================================
Contents: .. Contents:
1) Overview 1) Overview
2) Kernel Command Line Parameters 2) Kernel Command Line Parameters
...@@ -42,7 +43,7 @@ rescue floppy disk. ...@@ -42,7 +43,7 @@ rescue floppy disk.
2a) Kernel Command Line Parameters 2a) Kernel Command Line Parameters
ramdisk_size=N ramdisk_size=N
============== Size of the ramdisk.
This parameter tells the RAM disk driver to set up RAM disks of N k size. The This parameter tells the RAM disk driver to set up RAM disks of N k size. The
default is 4096 (4 MB). default is 4096 (4 MB).
...@@ -50,15 +51,12 @@ default is 4096 (4 MB). ...@@ -50,15 +51,12 @@ default is 4096 (4 MB).
2b) Module parameters 2b) Module parameters
rd_nr rd_nr
=====
/dev/ramX devices created. /dev/ramX devices created.
max_part max_part
========
Maximum partition number. Maximum partition number.
rd_size rd_size
=======
See ramdisk_size. See ramdisk_size.
3) Using "rdev -r" 3) Using "rdev -r"
...@@ -71,11 +69,11 @@ to 2 MB (2^11) of where to find the RAM disk (this used to be the size). Bit ...@@ -71,11 +69,11 @@ to 2 MB (2^11) of where to find the RAM disk (this used to be the size). Bit
prompt/wait sequence is to be given before trying to read the RAM disk. Since prompt/wait sequence is to be given before trying to read the RAM disk. Since
the RAM disk dynamically grows as data is being written into it, a size field the RAM disk dynamically grows as data is being written into it, a size field
is not required. Bits 11 to 13 are not currently used and may as well be zero. is not required. Bits 11 to 13 are not currently used and may as well be zero.
These numbers are no magical secrets, as seen below: These numbers are no magical secrets, as seen below::
./arch/x86/kernel/setup.c:#define RAMDISK_IMAGE_START_MASK 0x07FF ./arch/x86/kernel/setup.c:#define RAMDISK_IMAGE_START_MASK 0x07FF
./arch/x86/kernel/setup.c:#define RAMDISK_PROMPT_FLAG 0x8000 ./arch/x86/kernel/setup.c:#define RAMDISK_PROMPT_FLAG 0x8000
./arch/x86/kernel/setup.c:#define RAMDISK_LOAD_FLAG 0x4000 ./arch/x86/kernel/setup.c:#define RAMDISK_LOAD_FLAG 0x4000
Consider a typical two floppy disk setup, where you will have the Consider a typical two floppy disk setup, where you will have the
kernel on disk one, and have already put a RAM disk image onto disk #2. kernel on disk one, and have already put a RAM disk image onto disk #2.
...@@ -92,20 +90,23 @@ sequence so that you have a chance to switch floppy disks. ...@@ -92,20 +90,23 @@ sequence so that you have a chance to switch floppy disks.
The command line equivalent is: "prompt_ramdisk=1" The command line equivalent is: "prompt_ramdisk=1"
Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word. Putting that together gives 2^15 + 2^14 + 0 = 49152 for an rdev word.
So to create disk one of the set, you would do: So to create disk one of the set, you would do::
/usr/src/linux# cat arch/x86/boot/zImage > /dev/fd0 /usr/src/linux# cat arch/x86/boot/zImage > /dev/fd0
/usr/src/linux# rdev /dev/fd0 /dev/fd0 /usr/src/linux# rdev /dev/fd0 /dev/fd0
/usr/src/linux# rdev -r /dev/fd0 49152 /usr/src/linux# rdev -r /dev/fd0 49152
If you make a boot disk that has LILO, then for the above, you would use: If you make a boot disk that has LILO, then for the above, you would use::
append = "ramdisk_start=0 load_ramdisk=1 prompt_ramdisk=1" append = "ramdisk_start=0 load_ramdisk=1 prompt_ramdisk=1"
Since the default start = 0 and the default prompt = 1, you could use:
Since the default start = 0 and the default prompt = 1, you could use::
append = "load_ramdisk=1" append = "load_ramdisk=1"
4) An Example of Creating a Compressed RAM Disk 4) An Example of Creating a Compressed RAM Disk
---------------------------------------------- -----------------------------------------------
To create a RAM disk image, you will need a spare block device to To create a RAM disk image, you will need a spare block device to
construct it on. This can be the RAM disk device itself, or an construct it on. This can be the RAM disk device itself, or an
...@@ -120,11 +121,11 @@ a) Decide on the RAM disk size that you want. Say 2 MB for this example. ...@@ -120,11 +121,11 @@ a) Decide on the RAM disk size that you want. Say 2 MB for this example.
Create it by writing to the RAM disk device. (This step is not currently Create it by writing to the RAM disk device. (This step is not currently
required, but may be in the future.) It is wise to zero out the required, but may be in the future.) It is wise to zero out the
area (esp. for disks) so that maximal compression is achieved for area (esp. for disks) so that maximal compression is achieved for
the unused blocks of the image that you are about to create. the unused blocks of the image that you are about to create::
dd if=/dev/zero of=/dev/ram0 bs=1k count=2048 dd if=/dev/zero of=/dev/ram0 bs=1k count=2048
b) Make a filesystem on it. Say ext2fs for this example. b) Make a filesystem on it. Say ext2fs for this example::
mke2fs -vm0 /dev/ram0 2048 mke2fs -vm0 /dev/ram0 2048
...@@ -133,11 +134,11 @@ c) Mount it, copy the files you want to it (eg: /etc/* /dev/* ...) ...@@ -133,11 +134,11 @@ c) Mount it, copy the files you want to it (eg: /etc/* /dev/* ...)
d) Compress the contents of the RAM disk. The level of compression d) Compress the contents of the RAM disk. The level of compression
will be approximately 50% of the space used by the files. Unused will be approximately 50% of the space used by the files. Unused
space on the RAM disk will compress to almost nothing. space on the RAM disk will compress to almost nothing::
dd if=/dev/ram0 bs=1k count=2048 | gzip -v9 > /tmp/ram_image.gz dd if=/dev/ram0 bs=1k count=2048 | gzip -v9 > /tmp/ram_image.gz
e) Put the kernel onto the floppy e) Put the kernel onto the floppy::
dd if=zImage of=/dev/fd0 bs=1k dd if=zImage of=/dev/fd0 bs=1k
...@@ -146,13 +147,13 @@ f) Put the RAM disk image onto the floppy, after the kernel. Use an offset ...@@ -146,13 +147,13 @@ f) Put the RAM disk image onto the floppy, after the kernel. Use an offset
(possibly larger) kernel onto the same floppy later without overlapping (possibly larger) kernel onto the same floppy later without overlapping
the RAM disk image. An offset of 400 kB for kernels about 350 kB in the RAM disk image. An offset of 400 kB for kernels about 350 kB in
size would be reasonable. Make sure offset+size of ram_image.gz is size would be reasonable. Make sure offset+size of ram_image.gz is
not larger than the total space on your floppy (usually 1440 kB). not larger than the total space on your floppy (usually 1440 kB)::
dd if=/tmp/ram_image.gz of=/dev/fd0 bs=1k seek=400 dd if=/tmp/ram_image.gz of=/dev/fd0 bs=1k seek=400
g) Use "rdev" to set the boot device, RAM disk offset, prompt flag, etc. g) Use "rdev" to set the boot device, RAM disk offset, prompt flag, etc.
For prompt_ramdisk=1, load_ramdisk=1, ramdisk_start=400, one would For prompt_ramdisk=1, load_ramdisk=1, ramdisk_start=400, one would
have 2^15 + 2^14 + 400 = 49552. have 2^15 + 2^14 + 400 = 49552::
rdev /dev/fd0 /dev/fd0 rdev /dev/fd0 /dev/fd0
rdev -r /dev/fd0 49552 rdev -r /dev/fd0 49552
...@@ -160,15 +161,17 @@ g) Use "rdev" to set the boot device, RAM disk offset, prompt flag, etc. ...@@ -160,15 +161,17 @@ g) Use "rdev" to set the boot device, RAM disk offset, prompt flag, etc.
That is it. You now have your boot/root compressed RAM disk floppy. Some That is it. You now have your boot/root compressed RAM disk floppy. Some
users may wish to combine steps (d) and (f) by using a pipe. users may wish to combine steps (d) and (f) by using a pipe.
--------------------------------------------------------------------------
Paul Gortmaker 12/95 Paul Gortmaker 12/95
Changelog: Changelog:
---------- ----------
10-22-04 : Updated to reflect changes in command line options, remove 10-22-04 :
Updated to reflect changes in command line options, remove
obsolete references, general cleanup. obsolete references, general cleanup.
James Nelson (james4765@gmail.com) James Nelson (james4765@gmail.com)
12-95 : Original Document 12-95 :
Original Document
...@@ -11076,7 +11076,7 @@ M: Josef Bacik <josef@toxicpanda.com> ...@@ -11076,7 +11076,7 @@ M: Josef Bacik <josef@toxicpanda.com>
S: Maintained S: Maintained
L: linux-block@vger.kernel.org L: linux-block@vger.kernel.org
L: nbd@other.debian.org L: nbd@other.debian.org
F: Documentation/blockdev/nbd.txt F: Documentation/blockdev/nbd.rst
F: drivers/block/nbd.c F: drivers/block/nbd.c
F: include/trace/events/nbd.h F: include/trace/events/nbd.h
F: include/uapi/linux/nbd.h F: include/uapi/linux/nbd.h
...@@ -12086,7 +12086,7 @@ PARIDE DRIVERS FOR PARALLEL PORT IDE DEVICES ...@@ -12086,7 +12086,7 @@ PARIDE DRIVERS FOR PARALLEL PORT IDE DEVICES
M: Tim Waugh <tim@cyberelk.net> M: Tim Waugh <tim@cyberelk.net>
L: linux-parport@lists.infradead.org (subscribers-only) L: linux-parport@lists.infradead.org (subscribers-only)
S: Maintained S: Maintained
F: Documentation/blockdev/paride.txt F: Documentation/blockdev/paride.rst
F: drivers/block/paride/ F: drivers/block/paride/
PARISC ARCHITECTURE PARISC ARCHITECTURE
...@@ -13367,7 +13367,7 @@ F: drivers/net/wireless/ralink/rt2x00/ ...@@ -13367,7 +13367,7 @@ F: drivers/net/wireless/ralink/rt2x00/
RAMDISK RAM BLOCK DEVICE DRIVER RAMDISK RAM BLOCK DEVICE DRIVER
M: Jens Axboe <axboe@kernel.dk> M: Jens Axboe <axboe@kernel.dk>
S: Maintained S: Maintained
F: Documentation/blockdev/ramdisk.txt F: Documentation/blockdev/ramdisk.rst
F: drivers/block/brd.c F: drivers/block/brd.c
RANCHU VIRTUAL BOARD FOR MIPS RANCHU VIRTUAL BOARD FOR MIPS
...@@ -17723,7 +17723,7 @@ R: Sergey Senozhatsky <sergey.senozhatsky.work@gmail.com> ...@@ -17723,7 +17723,7 @@ R: Sergey Senozhatsky <sergey.senozhatsky.work@gmail.com>
L: linux-kernel@vger.kernel.org L: linux-kernel@vger.kernel.org
S: Maintained S: Maintained
F: drivers/block/zram/ F: drivers/block/zram/
F: Documentation/blockdev/zram.txt F: Documentation/blockdev/zram.rst
ZS DECSTATION Z85C30 SERIAL DRIVER ZS DECSTATION Z85C30 SERIAL DRIVER
M: "Maciej W. Rozycki" <macro@linux-mips.org> M: "Maciej W. Rozycki" <macro@linux-mips.org>
......
...@@ -31,7 +31,7 @@ config BLK_DEV_FD ...@@ -31,7 +31,7 @@ config BLK_DEV_FD
If you want to use the floppy disk drive(s) of your PC under Linux, If you want to use the floppy disk drive(s) of your PC under Linux,
say Y. Information about this driver, especially important for IBM say Y. Information about this driver, especially important for IBM
Thinkpad users, is contained in Thinkpad users, is contained in
<file:Documentation/blockdev/floppy.txt>. <file:Documentation/blockdev/floppy.rst>.
That file also contains the location of the Floppy driver FAQ as That file also contains the location of the Floppy driver FAQ as
well as location of the fdutils package used to configure additional well as location of the fdutils package used to configure additional
parameters of the driver at run time. parameters of the driver at run time.
...@@ -96,7 +96,7 @@ config PARIDE ...@@ -96,7 +96,7 @@ config PARIDE
your computer's parallel port. Most of them are actually IDE devices your computer's parallel port. Most of them are actually IDE devices
using a parallel port IDE adapter. This option enables the PARIDE using a parallel port IDE adapter. This option enables the PARIDE
subsystem which contains drivers for many of these external drives. subsystem which contains drivers for many of these external drives.
Read <file:Documentation/blockdev/paride.txt> for more information. Read <file:Documentation/blockdev/paride.rst> for more information.
If you have said Y to the "Parallel-port support" configuration If you have said Y to the "Parallel-port support" configuration
option, you may share a single port between your printer and other option, you may share a single port between your printer and other
...@@ -261,7 +261,7 @@ config BLK_DEV_NBD ...@@ -261,7 +261,7 @@ config BLK_DEV_NBD
userland (making server and client physically the same computer, userland (making server and client physically the same computer,
communicating using the loopback network device). communicating using the loopback network device).
Read <file:Documentation/blockdev/nbd.txt> for more information, Read <file:Documentation/blockdev/nbd.rst> for more information,
especially about where to find the server code, which runs in user especially about where to find the server code, which runs in user
space and does not need special kernel support. space and does not need special kernel support.
...@@ -303,7 +303,7 @@ config BLK_DEV_RAM ...@@ -303,7 +303,7 @@ config BLK_DEV_RAM
during the initial install of Linux. during the initial install of Linux.
Note that the kernel command line option "ramdisk=XX" is now obsolete. Note that the kernel command line option "ramdisk=XX" is now obsolete.
For details, read <file:Documentation/blockdev/ramdisk.txt>. For details, read <file:Documentation/blockdev/ramdisk.rst>.
To compile this driver as a module, choose M here: the To compile this driver as a module, choose M here: the
module will be called brd. An alias "rd" has been defined module will be called brd. An alias "rd" has been defined
......
...@@ -4424,7 +4424,7 @@ static int __init floppy_setup(char *str) ...@@ -4424,7 +4424,7 @@ static int __init floppy_setup(char *str)
pr_cont("\n"); pr_cont("\n");
} else } else
DPRINT("botched floppy option\n"); DPRINT("botched floppy option\n");
DPRINT("Read Documentation/blockdev/floppy.txt\n"); DPRINT("Read Documentation/blockdev/floppy.rst\n");
return 0; return 0;
} }
......
...@@ -12,7 +12,7 @@ config ZRAM ...@@ -12,7 +12,7 @@ config ZRAM
It has several use cases, for example: /tmp storage, use as swap It has several use cases, for example: /tmp storage, use as swap
disks and maybe many more. disks and maybe many more.
See Documentation/blockdev/zram.txt for more information. See Documentation/blockdev/zram.rst for more information.
config ZRAM_WRITEBACK config ZRAM_WRITEBACK
bool "Write back incompressible or idle page to backing device" bool "Write back incompressible or idle page to backing device"
...@@ -26,7 +26,7 @@ config ZRAM_WRITEBACK ...@@ -26,7 +26,7 @@ config ZRAM_WRITEBACK
With /sys/block/zramX/{idle,writeback}, application could ask With /sys/block/zramX/{idle,writeback}, application could ask
idle page's writeback to the backing device to save in memory. idle page's writeback to the backing device to save in memory.
See Documentation/blockdev/zram.txt for more information. See Documentation/blockdev/zram.rst for more information.
config ZRAM_MEMORY_TRACKING config ZRAM_MEMORY_TRACKING
bool "Track zRam block status" bool "Track zRam block status"
...@@ -36,4 +36,4 @@ config ZRAM_MEMORY_TRACKING ...@@ -36,4 +36,4 @@ config ZRAM_MEMORY_TRACKING
of zRAM. Admin could see the information via of zRAM. Admin could see the information via
/sys/kernel/debug/zram/zramX/block_state. /sys/kernel/debug/zram/zramX/block_state.
See Documentation/blockdev/zram.txt for more information. See Documentation/blockdev/zram.rst for more information.
...@@ -37,4 +37,4 @@ Commands required for testing: ...@@ -37,4 +37,4 @@ Commands required for testing:
- mkfs/ mkfs.ext4 - mkfs/ mkfs.ext4
For more information please refer: For more information please refer:
kernel-source-tree/Documentation/blockdev/zram.txt kernel-source-tree/Documentation/blockdev/zram.rst
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment