remove Documentation/smp.txt
[GitHub/mt8127/android_kernel_alcatel_ttab.git] / Documentation / 00-INDEX
CommitLineData
1da177e4
LT
1
2This is a brief list of all the files in ./linux/Documentation and what
3they contain. If you add a documentation file, please list it here in
4alphabetical order as well, or risk being hunted down like a rabid dog.
5Please try and keep the descriptions small enough to fit on one line.
6 Thanks -- Paul G.
7
8Following translations are available on the WWW:
9
10 - Japanese, maintained by the JF Project (JF@linux.or.jp), at
11 http://www.linux.or.jp/JF/
12
1300-INDEX
14 - this file.
f6b07d39
JJ
15ABI/
16 - info on kernel <-> userspace ABI and relative interface stability.
1da177e4
LT
17BUG-HUNTING
18 - brute force method of doing binary search of patches to find bug.
19Changes
20 - list of changes that break older software packages.
21CodingStyle
22 - how the boss likes the C code in the kernel to look.
23DMA-API.txt
24 - DMA API, pci_ API & extensions for non-consistent memory machines.
5ef43567
RL
25DMA-ISA-LPC.txt
26 - How to do DMA with ISA (and LPC) devices.
1da177e4
LT
27DMA-mapping.txt
28 - info for PCI drivers using DMA portably across all platforms.
29DocBook/
30 - directory with DocBook templates etc. for kernel documentation.
d36cc9d0 31HOWTO
f6b07d39 32 - the process and procedures of how to do Linux kernel development.
1da177e4
LT
33IO-mapping.txt
34 - how to access I/O mapped memory from within device drivers.
35IPMI.txt
36 - info on Linux Intelligent Platform Management Interface (IPMI) Driver.
37IRQ-affinity.txt
38 - how to select which CPU(s) handle which interrupt events on SMP.
f6b07d39
JJ
39IRQ.txt
40 - description of what an IRQ is.
1da177e4
LT
41ManagementStyle
42 - how to (attempt to) manage kernel hackers.
43MSI-HOWTO.txt
44 - the Message Signaled Interrupts (MSI) Driver Guide HOWTO and FAQ.
f6b07d39
JJ
45PCIEBUS-HOWTO.txt
46 - a guide describing the PCI Express Port Bus driver.
1da177e4
LT
47RCU/
48 - directory with info on RCU (read-copy update).
49README.DAC960
50 - info on Mylex DAC960/DAC1100 PCI RAID Controller Driver for Linux.
f6b07d39
JJ
51README.cycladesZ
52 - info on Cyclades-Z firmware loading.
1da177e4
LT
53SAK.txt
54 - info on Secure Attention Keys.
5ef43567
RL
55SM501.txt
56 - Silicon Motion SM501 multimedia companion chip
f6b07d39
JJ
57SecurityBugs
58 - procedure for reporting security bugs found in the kernel.
59SubmitChecklist
60 - Linux kernel patch submission checklist.
1da177e4
LT
61SubmittingDrivers
62 - procedure to get a new driver source included into the kernel tree.
63SubmittingPatches
64 - procedure to get a source patch included into the kernel tree.
65VGA-softcursor.txt
66 - how to change your VGA cursor from a blinking underscore.
f6b07d39
JJ
67accounting/
68 - documentation on accounting and taskstats.
69aoe/
70 - description of AoE (ATA over Ethernet) along with config examples.
754c7976
JJ
71applying-patches.txt
72 - description of various trees and how to apply their patches.
1da177e4
LT
73arm/
74 - directory with info about Linux on the ARM architecture.
f6b07d39
JJ
75atomic_ops.txt
76 - semantics and behavior of atomic and bitmask operations.
77auxdisplay/
78 - misc. LCD driver documentation (cfag12864b, ks0108).
1da177e4
LT
79basic_profiling.txt
80 - basic instructions for those who wants to profile Linux kernel.
81binfmt_misc.txt
82 - info on the kernel support for extra binary formats.
f6b07d39
JJ
83blackfin/
84 - directory with documentation for the Blackfin arch.
1da177e4
LT
85block/
86 - info on the Block I/O (BIO) layer.
87cachetlb.txt
88 - describes the cache/TLB flushing interfaces Linux uses.
89cciss.txt
90 - info, major/minor #'s for Compaq's SMART Array Controllers.
91cdrom/
92 - directory with information on the CD-ROM drivers that Linux has.
93cli-sti-removal.txt
94 - cli()/sti() removal guide.
95computone.txt
96 - info on Computone Intelliport II/Plus Multiport Serial Driver.
f6b07d39
JJ
97connector/
98 - docs on the netlink based userspace<->kernel space communication mod.
99console/
100 - documentation on Linux console drivers.
1da177e4
LT
101cpqarray.txt
102 - info on using Compaq's SMART2 Intelligent Disk Array Controllers.
103cpu-freq/
104 - info on CPU frequency and voltage scaling.
f6b07d39
JJ
105cpu-hotplug.txt
106 - document describing CPU hotplug support in the Linux kernel.
107cpu-load.txt
108 - document describing how CPU load statistics are collected.
109cpusets.txt
110 - documents the cpusets feature; assign CPUs and Mem to a set of tasks.
111cputopology.txt
112 - documentation on how CPU topology info is exported via sysfs.
1da177e4
LT
113cris/
114 - directory with info about Linux on CRIS architecture.
115crypto/
116 - directory with info on the Crypto API.
f6b07d39
JJ
117dcdbas.txt
118 - information on the Dell Systems Management Base Driver.
1da177e4
LT
119debugging-modules.txt
120 - some notes on debugging modules after Linux 2.6.3.
f6b07d39
JJ
121dell_rbu.txt
122 - document demonstrating the use of the Dell Remote BIOS Update driver.
1da177e4
LT
123device-mapper/
124 - directory with info on Device Mapper.
125devices.txt
126 - plain ASCII listing of all the nodes in /dev/ with major minor #'s.
127digiepca.txt
128 - info on Digi Intl. {PC,PCI,EISA}Xx and Xem series cards.
129dnotify.txt
130 - info about directory notification in Linux.
f6b07d39
JJ
131dontdiff
132 - file containing a list of files that should never be diff'ed.
1da177e4
LT
133driver-model/
134 - directory with info about Linux driver model.
f6b07d39
JJ
135drivers/
136 - directory with driver documentation (currently only EDAC).
1da177e4
LT
137dvb/
138 - info on Linux Digital Video Broadcast (DVB) subsystem.
139early-userspace/
140 - info about initramfs, klibc, and userspace early during boot.
141eisa.txt
142 - info on EISA bus support.
143exception.txt
144 - how Linux v2.2 handles exceptions without verify_area etc.
f6b07d39
JJ
145fault-injection/
146 - dir with docs about the fault injection capabilities infrastructure.
1da177e4
LT
147fb/
148 - directory with info on the frame buffer graphics abstraction layer.
f6b07d39
JJ
149feature-removal-schedule.txt
150 - list of files and features that are going to be removed.
1da177e4 151filesystems/
4f3b19ca 152 - info on the vfs and the various filesystems that Linux supports.
1da177e4
LT
153firmware_class/
154 - request_firmware() hotplug interface info.
155floppy.txt
156 - notes and driver options for the floppy disk driver.
f6b07d39
JJ
157fujitsu/
158 - Fujitsu FR-V Linux documentation.
159gpio.txt
160 - overview of GPIO (General Purpose Input/Output) access conventions.
1da177e4
LT
161hayes-esp.txt
162 - info on using the Hayes ESP serial driver.
163highuid.txt
164 - notes on the change from 16 bit to 32 bit user/group IDs.
165hpet.txt
166 - High Precision Event Timer Driver for Linux.
f6b07d39
JJ
167hrtimer/
168 - info on the timer_stats debugging facility for timer (ab)use.
169hrtimers/
170 - info on the hrtimers subsystem for high-resolution kernel timers.
1da177e4
LT
171hw_random.txt
172 - info on Linux support for random number generator in i8xx chipsets.
f6b07d39
JJ
173hwmon/
174 - directory with docs on various hardware monitoring drivers.
1da177e4
LT
175i2c/
176 - directory with info about the I2C bus/protocol (2 wire, kHz speed).
177i2o/
178 - directory with info about the Linux I2O subsystem.
179i386/
180 - directory with info about Linux on Intel 32 bit architecture.
181ia64/
182 - directory with info about Linux on Intel 64 bit architecture.
183ide.txt
184 - important info for users of ATA devices (IDE/EIDE disks and CD-ROMS).
f6b07d39
JJ
185infiniband/
186 - directory with documents concerning Linux InfiniBand support.
1da177e4
LT
187initrd.txt
188 - how to use the RAM disk as an initial/temporary root filesystem.
189input/
190 - info on Linux input device support.
191io_ordering.txt
192 - info on ordering I/O writes to memory-mapped addresses.
f6b07d39
JJ
193ioctl/
194 - directory with documents describing various IOCTL calls.
1da177e4
LT
195ioctl-number.txt
196 - how to implement and register device/driver ioctl calls.
197iostats.txt
198 - info on I/O statistics Linux kernel provides.
f6b07d39
JJ
199irqflags-tracing.txt
200 - how to use the irq-flags tracing feature.
1da177e4
LT
201isapnp.txt
202 - info on Linux ISA Plug & Play support.
203isdn/
204 - directory with info on the Linux ISDN support, and supported cards.
205java.txt
206 - info on the in-kernel binary support for Java(tm).
207kbuild/
208 - directory with info about the kernel build process.
f6b07d39
JJ
209kdump/
210 - directory with mini HowTo on getting the crash dump code to work.
1da177e4
LT
211kernel-doc-nano-HOWTO.txt
212 - mini HowTo on generation and location of kernel documentation files.
213kernel-docs.txt
214 - listing of various WWW + books that document kernel internals.
215kernel-parameters.txt
216 - summary listing of command line / boot prompt args for the kernel.
f6b07d39
JJ
217keys-request-key.txt
218 - description of the kernel key request service.
219keys.txt
220 - description of the kernel key retention service.
1da177e4
LT
221kobject.txt
222 - info of the kobject infrastructure of the Linux kernel.
f6b07d39
JJ
223kprobes.txt
224 - documents the kernel probes debugging feature.
225kref.txt
226 - docs on adding reference counters (krefs) to kernel objects.
1da177e4 227laptop-mode.txt
f6b07d39 228 - how to conserve battery power using laptop-mode.
1da177e4
LT
229ldm.txt
230 - a brief description of LDM (Windows Dynamic Disks).
f6b07d39
JJ
231leds-class.txt
232 - documents LED handling under Linux.
233local_ops.txt
234 - semantics and behavior of local atomic operations.
235lockdep-design.txt
236 - documentation on the runtime locking correctness validator.
1da177e4 237logo.gif
f6b07d39 238 - full colour GIF image of Linux logo (penguin - Tux).
1da177e4 239logo.txt
f6b07d39 240 - info on creator of above logo & site to get additional images from.
1da177e4
LT
241m68k/
242 - directory with info about Linux on Motorola 68k architecture.
243magic-number.txt
244 - list of magic numbers used to mark/protect kernel data structures.
1da177e4
LT
245mca.txt
246 - info on supporting Micro Channel Architecture (e.g. PS/2) systems.
247md.txt
248 - info on boot arguments for the multiple devices driver.
f6b07d39
JJ
249memory-barriers.txt
250 - info on Linux kernel memory barriers.
5ef43567
RL
251memory-hotplug.txt
252 - Hotpluggable memory support, how to use and current status.
1da177e4
LT
253memory.txt
254 - info on typical Linux memory problems.
255mips/
256 - directory with info about Linux on MIPS architecture.
257mono.txt
258 - how to execute Mono-based .NET binaries with the help of BINFMT_MISC.
259moxa-smartio
f6b07d39 260 - file with info on installing/using Moxa multiport serial driver.
1da177e4
LT
261mtrr.txt
262 - how to use PPro Memory Type Range Registers to increase performance.
f6b07d39
JJ
263mutex-design.txt
264 - info on the generic mutex subsystem.
2868f89f
PE
265namespaces/
266 - directory with various information about namespaces
1da177e4
LT
267nbd.txt
268 - info on a TCP implementation of a network block device.
8802f616
PM
269netlabel/
270 - directory with information on the NetLabel subsystem.
1da177e4
LT
271networking/
272 - directory with info on various aspects of networking with Linux.
273nfsroot.txt
274 - short guide on setting up a diskless box with NFS root filesystem.
275nmi_watchdog.txt
276 - info on NMI watchdog for SMP systems.
f6b07d39
JJ
277nommu-mmap.txt
278 - documentation about no-mmu memory mapping support.
1da177e4
LT
279numastat.txt
280 - info on how to read Numa policy hit/miss statistics in sysfs.
281oops-tracing.txt
282 - how to decode those nasty internal kernel error dump messages.
283paride.txt
284 - information about the parallel port IDE subsystem.
285parisc/
286 - directory with info on using Linux on PA-RISC architecture.
287parport.txt
288 - how to use the parallel-port driver.
289parport-lowlevel.txt
290 - description and usage of the low level parallel port functions.
f6b07d39
JJ
291pci-error-recovery.txt
292 - info on PCI error recovery.
1da177e4
LT
293pci.txt
294 - info on the PCI subsystem for device driver authors.
f6b07d39
JJ
295pcieaer-howto.txt
296 - the PCI Express Advanced Error Reporting Driver Guide HOWTO.
297pcmcia/
298 - info on the Linux PCMCIA driver.
299pi-futex.txt
300 - documentation on lightweight PI-futexes.
1da177e4
LT
301pm.txt
302 - info on Linux power management support.
303pnp.txt
304 - Linux Plug and Play documentation.
5ef43567
RL
305power_supply_class.txt
306 - Tells userspace about battery, UPS, AC or DC power supply properties
1da177e4
LT
307power/
308 - directory with info on Linux PCI power management.
309powerpc/
310 - directory with info on using Linux with the PowerPC.
311preempt-locking.txt
312 - info on locking under a preemptive kernel.
f6b07d39
JJ
313prio_tree.txt
314 - info on radix-priority-search-tree use for indexing vmas.
1da177e4
LT
315ramdisk.txt
316 - short guide on how to set up and use the RAM disk.
f6b07d39
JJ
317rbtree.txt
318 - info on what red-black trees are and what they are for.
1da177e4
LT
319riscom8.txt
320 - notes on using the RISCom/8 multi-port serial driver.
f6b07d39
JJ
321robust-futex-ABI.txt
322 - documentation of the robust futex ABI.
323robust-futexes.txt
324 - a description of what robust futexes are.
1da177e4
LT
325rocket.txt
326 - info on the Comtrol RocketPort multiport serial driver.
327rpc-cache.txt
328 - introduction to the caching mechanisms in the sunrpc layer.
f6b07d39
JJ
329rt-mutex-design.txt
330 - description of the RealTime mutex implementation design.
331rt-mutex.txt
332 - desc. of RT-mutex subsystem with PI (Priority Inheritance) support.
1da177e4
LT
333rtc.txt
334 - notes on how to use the Real Time Clock (aka CMOS clock) driver.
335s390/
336 - directory with info on using Linux on the IBM S390.
f6b07d39
JJ
337sched-arch.txt
338 - CPU Scheduler implementation hints for architecture specific code.
1da177e4
LT
339sched-coding.txt
340 - reference for various scheduler-related methods in the O(1) scheduler.
341sched-design.txt
342 - goals, design and implementation of the Linux O(1) scheduler.
5ef43567
RL
343sched-design-CFS.txt
344 - goals, design and implementation of the Complete Fair Scheduler.
1da177e4
LT
345sched-domains.txt
346 - information on scheduling domains.
5ef43567
RL
347sched-nice-design.txt
348 - How and why the scheduler's nice levels are implemented.
1da177e4
LT
349sched-stats.txt
350 - information on schedstats (Linux Scheduler Statistics).
351scsi/
352 - directory with info on Linux scsi support.
353serial/
354 - directory with info on the low level serial API.
355serial-console.txt
356 - how to set up Linux with a serial line console as the default.
f6b07d39
JJ
357sgi-ioc4.txt
358 - description of the SGI IOC4 PCI (multi function) device.
1da177e4
LT
359sgi-visws.txt
360 - short blurb on the SGI Visual Workstations.
361sh/
362 - directory with info on porting Linux to a new architecture.
f6b07d39
JJ
363sharedsubtree.txt
364 - a description of shared subtrees for namespaces.
1da177e4
LT
365smart-config.txt
366 - description of the Smart Config makefile feature.
f6b07d39
JJ
367sony-laptop.txt
368 - Sony Notebook Control Driver (SNC) Readme.
1da177e4
LT
369sonypi.txt
370 - info on Linux Sony Programmable I/O Device support.
371sound/
372 - directory with info on sound card support.
373sparc/
374 - directory with info on using Linux on Sparc architecture.
f6b07d39
JJ
375sparse.txt
376 - info on how to obtain and use the sparse tool for typechecking.
1da177e4
LT
377specialix.txt
378 - info on hardware/driver for specialix IO8+ multiport serial card.
f6b07d39
JJ
379spi/
380 - overview of Linux kernel Serial Peripheral Interface (SPI) support.
1da177e4
LT
381spinlocks.txt
382 - info on using spinlocks to provide exclusive access in kernel.
8907e94b
GKH
383stable_api_nonsense.txt
384 - info on why the kernel does not have a stable in-kernel api or abi.
385stable_kernel_rules.txt
386 - rules and procedures for the -stable kernel releases.
1da177e4
LT
387stallion.txt
388 - info on using the Stallion multiport serial driver.
389svga.txt
390 - short guide on selecting video modes at boot via VGA BIOS.
5ef43567
RL
391sysfs-rules.txt
392 - How not to use sysfs.
1da177e4
LT
393sx.txt
394 - info on the Specialix SX/SI multiport serial driver.
395sysctl/
396 - directory with info on the /proc/sys/* files.
397sysrq.txt
398 - info on the magic SysRq key.
399telephony/
400 - directory with info on telephony (e.g. voice over IP) support.
f6b07d39
JJ
401thinkpad-acpi.txt
402 - information on the (IBM and Lenovo) ThinkPad ACPI Extras driver.
1da177e4
LT
403time_interpolators.txt
404 - info on time interpolators.
405tipar.txt
406 - information about Parallel link cable for Texas Instruments handhelds.
407tty.txt
408 - guide to the locking policies of the tty layer.
1da177e4 409uml/
d533f671 410 - directory with information about User Mode Linux.
f6b07d39
JJ
411unicode.txt
412 - info on the Unicode character/font mapping used in Linux.
413unshare.txt
414 - description of the Linux unshare system call.
1da177e4
LT
415usb/
416 - directory with info regarding the Universal Serial Bus.
f6b07d39
JJ
417video-output.txt
418 - sysfs class driver interface to enable/disable a video output device.
1da177e4
LT
419video4linux/
420 - directory with info regarding video/TV/radio cards and linux.
421vm/
422 - directory with info on the Linux vm code.
5ef43567
RL
423volatile-considered-harmful.txt
424 - Why the "volatile" type class should not be used
1da177e4
LT
425voyager.txt
426 - guide to running Linux on the Voyager architecture.
f6b07d39
JJ
427w1/
428 - directory with documents regarding the 1-wire (w1) subsystem.
1da177e4
LT
429watchdog/
430 - how to auto-reboot Linux if it has "fallen and can't get up". ;-)
431x86_64/
432 - directory with info on Linux support for AMD x86-64 (Hammer) machines.
1da177e4
LT
433zorro.txt
434 - info on writing drivers for Zorro bus devices found on Amigas.