2 This is a brief list of all the files in ./linux/Documentation and what
3 they contain. If you add a documentation file, please list it here in
4 alphabetical order as well, or risk being hunted down like a rabid dog.
5 Please keep the descriptions small enough to fit on one line.
8 Following translations are available on the WWW:
10 - Japanese, maintained by the JF Project (jf@listserv.linux.or.jp), at
11 http://linuxjf.sourceforge.jp/
16 - info on kernel <-> userspace ABI and relative interface stability.
18 - nothing here, just a pointer to process/coding-style.rst.
20 - DMA API, pci_ API & extensions for non-consistent memory machines.
22 - Dynamic DMA mapping Guide
24 - How to do DMA with ISA (and LPC) devices.
26 - listing of the various possible attributes a DMA region can have
28 - directory with DocBook templates etc. for kernel documentation.
30 - directory with info on customizing EDID for broken gfx/displays.
32 - info on Linux Intelligent Platform Management Interface (IPMI) Driver.
34 - how to select which CPU(s) handle which interrupt events on SMP.
36 - info on interrupt numbering and setting up IRQ domains.
38 - description of what an IRQ is.
40 - basic info on the Intel IOMMU virtualization support.
42 - This file does nothing. Removing it breaks make htmldocs and
45 - This file does nothing. Removing it breaks make htmldocs and
48 - info related to PCI drivers.
50 - directory with info on RCU (read-copy update).
52 - info on Secure Attention Keys.
54 - Silicon Motion SM501 multimedia companion chip
56 - nothing here, just a pointer to process/coding-style.rst.
58 - documentation on accounting and taskstats.
60 - info on ACPI-specific hooks in the kernel.
62 - info related to Linux users and system admins.
64 - description of AoE (ATA over Ethernet) along with config examples.
66 - directory with info about Linux on the ARM architecture.
68 - directory with info about Linux on the 64 bit ARM architecture.
70 - misc. LCD driver documentation (cfag12864b, ks0108).
72 - directory with info on controlling backlights in flat panel displays
74 - Block-layer cache on fast SSDs to improve slow (raid) I/O performance.
76 - directory with documentation for the Blackfin arch.
78 - info on the Block I/O (BIO) layer.
80 - info on block devices & drivers
82 - info on how to modify a bt8xx video card for GPIO usage.
84 - info on Marvell Bluetooth driver usage.
86 - directory with info on TI GPMC (General Purpose Memory Controller)
87 bus-virt-phys-mapping.txt
88 - how to access I/O mapped memory from within device drivers.
90 - describes the cache/TLB flushing interfaces Linux uses.
92 - directory with information on the CD-ROM drivers that Linux has.
94 - cgroups v1 features, including cpusets and memory controller.
96 - cgroups v2 features, including cpusets and memory controller.
98 - how to make use of the existing circular buffer infrastructure
100 - info on the common clock framework
102 - Continuous Memory Area (CMA) debugfs interface.
104 - nothing here. Just a configuration file for Sphinx.
106 - docs on the netlink based userspace<->kernel space communication mod.
108 - documentation on Linux console drivers.
110 - documentation on kernel core components.
112 - info on CPU frequency and voltage scaling.
114 - document describing CPU hotplug support in the Linux kernel.
116 - document describing how CPU load statistics are collected.
118 - info on CPU_IDLE, CPU idle state management subsystem.
120 - documentation on how CPU topology info is exported via sysfs.
122 - brief tutorial on CRC computation
124 - directory with info about Linux on CRIS architecture.
126 - directory with info on the Crypto API.
128 - information on the Dell Systems Management Base Driver.
129 debugging-modules.txt
130 - some notes on debugging modules after Linux 2.6.3.
131 debugging-via-ohci1394.txt
132 - how to use firewire like a hardware debugger memory reader.
134 - document demonstrating the use of the Dell Remote BIOS Update driver.
136 - directory with info on development tools for the kernel.
138 - directory with info on Device Mapper.
140 - the DMA engine and controller API guides.
142 - directory with info on device tree files used by OF/PowerPC/ARM
144 -info on the Digital Signature Verification API
146 - the DMA Buffer Sharing API Guide
148 - nothing here. Just a configuration file for docutils.
150 - file containing a list of files that should never be diff'ed.
152 - the Linux driver implementer's API guide.
154 - directory with info about Linux driver model.
156 - info about initramfs, klibc, and userspace early during boot.
158 - information on EDAC - Error Detection And Correction
160 - How to use the EFI boot stub to bypass GRUB or elilo on EFI systems.
162 - info on EISA bus support.
164 - directory with porting guide for Android kernel switch driver.
166 - info on EISA bus support.
168 - dir with docs about the fault injection capabilities infrastructure.
170 - directory with info on the frame buffer graphics abstraction layer.
172 - status of feature implementation on different architectures.
174 - info on the vfs and the various filesystems that Linux supports.
176 - request_firmware() hotplug interface info.
178 - how to make use of flexible sized arrays in linux
180 - information about the FMC bus abstraction
184 - Fujitsu FR-V Linux documentation.
186 - info on requeueing of tasks from a non-PI futex to a PI futex
188 - GCC plugin infrastructure.
190 - gpio related documentation
192 - directory with information on GPU driver developer's guide.
194 - directory with information on human interface devices
196 - notes on the change from 16 bit to 32 bit user/group IDs.
198 - hardware spinlock provides hardware assistance for synchronization
200 - info on the timer related topics
202 - info on Linux support for random number generator in i8xx chipsets.
204 - directory with docs on various hardware monitoring drivers.
206 - directory with info about the I2C bus/protocol (2 wire, kHz speed).
208 - directory with info about Linux on Intel 32 bit architecture.
210 - directory with info about Linux on Intel 64 bit architecture.
212 - Information regarding the Enhanced IDE drive.
214 - info on industrial IIO configfs support.
216 - main index for the documentation at ReST format.
218 - directory with documents concerning Linux InfiniBand support.
220 - info on Linux input device support.
222 - info on intel Trusted Execution Technology (intel TXT).
224 - description of io_mapping functions in linux/io-mapping.h
226 - info on ordering I/O writes to memory-mapped addresses.
228 - directory with documents describing various IOCTL calls.
230 - info on I/O statistics Linux kernel provides.
232 - how to use the irq-flags tracing feature.
234 - info on Linux ISA Plug & Play support.
236 - directory with info on the Linux ISDN support, and supported cards.
238 - directory with info about the kernel build process.
239 kernel-doc-nano-HOWTO.txt
240 - outdated info about kernel-doc documentation.
242 - directory with mini HowTo on getting the crash dump code to work.
244 - how to write and format reStructuredText kernel documentation
245 kernel-per-CPU-kthreads.txt
246 - List of all per-CPU kthreads and how they introduce jitter.
248 - info of the kobject infrastructure of the Linux kernel.
250 - documents the kernel probes debugging feature.
252 - docs on adding reference counters (krefs) to kernel objects.
254 - small unittests for (some) individual codepaths in the kernel.
256 - directory with laptop related info and laptop driver documentation.
258 - a brief description of LDM (Windows Dynamic Disks).
260 - directory with info about LED handling under Linux.
262 - info on kernel live patching.
264 - directory with info about kernel locking primitives
266 - info on soft and hard lockup detectors (aka nmi_watchdog).
268 - full colour GIF image of Linux logo (penguin - Tux).
270 - info on creator of above logo & site to get additional images from.
272 - kernel LZO decompressor input formats
274 - directory with info about Linux on Motorola 68k architecture.
276 - How to write drivers for the common mailbox framework (IPC).
278 - info on shared-device RAID MD cluster.
280 - info on media drivers: uAPI, kAPI and driver documentation.
282 - info on Linux kernel memory barriers.
284 - directory with info on parts like the Texas Instruments EMIF driver
286 - Hotpluggable memory support, how to use and current status.
287 men-chameleon-bus.txt
288 - info on MEN chameleon bus.
290 - directory with info about Linux on Meta architecture.
292 - Intel Many Integrated Core (MIC) architecture device driver.
294 - directory with info about Linux on MIPS architecture.
296 - directory with info about devices using the misc dev subsystem
298 - directory with info about the MMC subsystem
300 - directory with info about the mn10300 architecture port
302 - directory with info about memory technology devices (flash)
304 - directory with various information about namespaces
306 - directory with information on the NetLabel subsystem.
308 - directory with info on various aspects of networking with Linux.
310 - directory relating info about Near Field Communications support.
312 - Linux on the Nios II architecture.
314 - documentation about no-mmu memory mapping support.
316 - info on how to read Numa policy hit/miss statistics in sysfs.
318 - info on Non-Transparent Bridge (NTB) drivers.
320 - info on non-volatile devices.
322 - info on non volatile memory framework.
324 - default directory where html/LaTeX/pdf files will be written.
326 - An introduction to the "padata" parallel execution API
328 - directory with info on using Linux on PA-RISC architecture.
330 - description and usage of the low level parallel port functions.
332 - info on the Linux PCMCIA driver.
333 percpu-rw-semaphore.txt
334 - RCU based read-write semaphore optimized for locking for reading
336 - info about the APM X-Gene SoC Performance Monitoring Unit (PMU).
338 - ino on Samsung USB 2.0 PHY adaptation layer.
340 - Description of the generic PHY framework.
342 - documentation on lightweight priority inheritance futexes.
344 - info on pinctrl subsystem and the PINMUX/PINCONF and drivers
346 - List of supported hardware by compal and Dell laptop.
348 - Linux Plug and Play documentation.
350 - directory with info on Linux PCI power management.
352 - directory with info on using Linux with the PowerPC.
354 - directory with info on the priveledge control subsystem
356 - info on locking under a preemptive kernel.
358 - how to get printk format specifiers right
360 - how to work with the mainline kernel development process.
362 - directory with information on the pulse-per-second support
364 - directory with info on Intel MID PTI.
366 - directory with info on support for IEEE 1588 PTP clocks in Linux.
368 - info on the pulse width modulation driver subsystem
370 - directory with info on RapidIO packet-based fabric interconnect
372 - info on what red-black trees are and what they are for.
374 - info on how to handle remote processor (e.g. AMP) offloads/usage.
376 - info on the radio frequency kill switch subsystem/support.
378 - documentation of the robust futex ABI.
380 - a description of what robust futexes are.
382 - info on the Remote Processor Messaging (rpmsg) Framework
384 - notes on how to use the Real Time Clock (aka CMOS clock) driver.
386 - directory with info on using Linux on the IBM S390.
388 - directory with info on the scheduler.
390 - directory with info on Linux scsi support.
392 - directory that contains security-related info
394 - directory with info on the low level serial API.
396 - description of the SGI IOC4 PCI (multi function) device.
398 - directory with info on porting Linux to a new architecture.
400 -info on the smsc Keyboard Scan Expansion/GPIO Expansion device.
402 - directory with info on sound card support.
404 - overview of Linux kernel Serial Peripheral Interface (SPI) support.
406 - no doumentation here, just files required by Sphinx toolchain.
408 - no doumentation here, just files required by Sphinx toolchain.
410 - info on how static keys allow debug code in hotpaths via patching
412 - short guide on selecting video modes at boot via VGA BIOS.
414 - Sync file API guide.
416 - directory with info on the /proc/sys/* files.
418 - directory with info on generating TCM v4 fabric .ko modules
420 - List rationale behind and the way to use this_cpu operations.
422 - directory with information on managing thermal issues (CPU/temp)
424 - directory with info on tracing technologies within linux
426 - translations of this document from English to another language
427 unaligned-memory-access.txt
428 - info on how to avoid arch breaking unaligned memory access in code.
430 - description of the Linux unshare system call.
432 - directory with info regarding the Universal Serial Bus.
434 - info on Virtual Function I/O used in guest/hypervisor instances.
436 - sysfs class driver interface to enable/disable a video output device.
438 - directory with information on the various linux virtualizations.
440 - directory with info on the Linux vm code.
442 - directory with documents regarding the 1-wire (w1) subsystem.
444 - how to auto-reboot Linux if it has "fallen and can't get up". ;-)
446 - directory with info about Intel Wireless Wimax Connections
447 core-api/workqueue.rst
448 - information on the Concurrency Managed Workqueue implementation
450 - directory with info on Linux support for AMD x86-64 (Hammer) machines.
452 - Overview and basic ui of xillybus driver
454 - directory with documents relating to arch/xtensa port/implementation
456 - how to make use of the XZ data compression within linux kernel
458 - info on writing drivers for Zorro bus devices found on Amigas.