Import 2.4.0-test2pre7
[davej-history.git] / Documentation / 00-INDEX
blob93386cb2e756473d8768de32531a22b334df70b6
1 This is a brief list of all the files in ./linux/Documentation and what
2 they contain. If you add a documentation file, please list it here in 
3 alphabetical order as well, or risk being hunted down like a rabid dog. 
4 Note that subdirectories have their own index files too. Please try and
5 keep the descriptions small enough to fit on one line.
6                                                          Thanks -- Paul G.
8 00-INDEX
9         - this file.
10 BUG-HUNTING
11         - brute force method of doing binary search of patches to find bug.
12 Changes
13         - list of changes that break older software packages.
14 CodingStyle
15         - how the boss likes the C code in the kernel to look.
16 Configure.help
17         - text file that is used for help when you run "make config"
18 IO-APIC.txt
19         - info on using the enhanced interrupt hardware on SMP boards.
20 IO-mapping.txt
21         - how to access I/O mapped memory from within device drivers.
22 README.DAC960
23         - info on Mylex DAC960/DAC1100 PCI RAID Controller Driver for Linux
24 VGA-softcursor.txt
25         - how to change your VGA cursor from a blinking underscore.
26 arm/
27         - directory with info about Linux on the ARM architecture.
28 atm.txt
29         - info on Linux ATM support
30 binfmt_misc.txt
31         - info on the kernel support for extra binary formats.
32 cdrom/
33         - directory with information on the CD-ROM drivers that Linux has.
34 computone.txt
35         - info on Computone Intelliport II/Plus Multiport Serial Driver
36 cpqarray.txt
37         - info on using Compaq's SMART2 Intelligent Disk Array Controllers.
38 devices.tex
39         - LaTeX source listing of all the nodes in /dev/ with major minor #'s
40 devices.txt
41         - plain ASCII listing of all the nodes in /dev/ with major minor #'s
42 digiboard.txt
43         - info on the Digiboard PC/X{i,e,eve} multiport boards.
44 digiepca.txt
45         - info on Digi Intl. {PC,PCI,EISA}Xx and Xem series cards.
46 exception.txt
47         - how Linux v2.2 handles exceptions without verify_area etc.
48 fb/
49         - directory with info on the frame buffer graphics abstraction layer.
50 filesystems/
51         - directory with info on the various filesystems that Linux supports.
52 ftape.txt
53         - notes about the floppy tape device driver
54 hayes-esp.txt
55         - info on using the Hayes ESP serial driver.
56 i386/
57         - directory with info about Linux on the intel ix86 architecture.
58 ide.txt
59         - important info for users of ATA devices (IDE/EIDE disks and CD-ROMS)
60 initrd.txt
61         - how to use the RAM disk as an initial/temporary root filesystem.
62 ioctl-number.txt
63         - how to implement and register device/driver ioctl calls.
64 isapnp.txt
65         - info on Linux ISA Plug & Play support
66 isdn/
67         - directory with info on the Linux ISDN support, and supported cards.
68 java.txt
69         - info on the in-kernel binary support for Java(tm)
70 joystick-api.txt
71         - API specification for applications that will be using the joystick.
72 joystick-parport.txt 
73         - info on how to hook joysticks/gamepads to the parallel port.
74 joystick.txt
75         - info on using joystick devices (and driver) with Linux.
76 kbuild/
77         - directory with info about the kernel build process
78 kernel-docs.txt
79         - listing of various WWW + books that document kernel internals.
80 kernel-parameters.txt
81         - summary listing of command line / boot prompt args for the kernel.
82 kmod.txt
83         - info on the kernel module loader/unloader (kerneld replacement).
84 locks.txt
85         - info on file locking implementations, flock() vs. fcntl(), etc.
86 logo.gif
87         - Full colour GIF image of Linux logo (penguin)
88 logo.txt
89         - Info on creator of above logo & site to get additional images from.
90 m68k/
91         - directory with info about Linux on Motorola 68k architecture.
92 magic-number.txt
93         - list of magic numbers used to mark/protect kernel data structures.
94 mandatory.txt
95         - info on the Linux implementation of Sys V mandatory file locking.
96 mca.txt
97         - info on supporting Micro Channel Architecture (e.g. PS/2) systems.
98 md.txt
99         - info on boot arguments for the multiple devices driver
100 memory.txt
101         - info on typical Linux memory problems.
102 mkdev.ida
103         - script to make /dev entries for Intelligent Disk Array Controllers.
104 modules.txt
105         - short guide on how to make kernel parts into loadable modules
106 mtrr.txt
107         - how to use PPro Memory Type Range Registers to increase performance
108 nbd.txt
109         - info on a TCP implementation of a network block device.
110 networking/
111         - directory with info on various aspects of networking with Linux.
112 nfsroot.txt
113         - short guide on setting up a diskless box with NFS root filesystem
114 nmi_watchdog.txt
115         - info on NMI watchdog for SMP systems
116 oops-tracing.txt
117         - how to decode those nasty internal kernel error dump messages.
118 paride.txt
119         - information about the parallel port IDE subsystem.
120 parport.txt
121         - how to use the parallel-port driver.
122 pci.txt
123         - info on the PCI subsystem for device driver authors
124 pcwd-watchdog.txt
125         - info and sample code for using with the PC Watchdog reset card.
126 pm.txt
127         - info on Linux power management support
128 powerpc/
129         - directory with info on using Linux with the PowerPC.
130 proc_usb_info.txt
131         - info on /proc/bus/usb direcory generated for USB devices
132 ramdisk.txt
133         - short guide on how to set up and use the RAM disk.
134 riscom8.txt
135         - notes on using the RISCom/8 multi-port serial driver.
136 rtc.txt
137         - notes on how to use the Real Time Clock (aka CMOS clock) driver.
138 scsi-generic.txt
139         - info on the sg driver for generic (non-disk/CD/tape) SCSI devices.
140 scsi.txt
141         - short blurb on using SCSI support as a module.
142 serial-console.txt
143         - how to set up Linux with a serial line console as the default.
144 sgi-visws.txt
145         - short blurb on the SGI Visual Workstations.
146 smart-config.txt
147         - description of the Smart Config makefile feature.
148 smp.tex
149         - LaTeX document describing implementation of Multiprocessor Linux
150 smp.txt
151         - a few more notes on symmetric multi-processing
152 sound/
153         - directory with info on sound card support
154 specialix.txt
155         - info on hardware/driver for specialix IO8+ multiport serial card.
156 spinlocks.txt
157         - info on using spinlocks to provide exclusive access in kernel.
158 stallion.txt
159         - info on using the Stallion multiport serial driver.
160 svga.txt
161         - short guide on selecting video modes at boot via VGA BIOS.
162 sx.txt
163         - info on the Specialix SX/SI multiport serial driver.
164 sysctl/
165         - directory with info on the /proc/sys/* files
166 sysrq.txt
167         - info on the magic SysRq key
168 unicode.txt
169         - info on the Unicode character/font mapping used in Linux.
170 video4linux/
171         - directory with info regarding video/TV/radio cards and linux.
173         - directory with info on the Linux vm code.
174 watchdog.txt
175         - how to auto-reboot Linux if it has "fallen and can't get up". ;-)
176 xterm-linux.xpm
177         - XPM image of penguin logo (see logo.txt) sitting on an xterm.