00-INDEX 15 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453
  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. Please keep the descriptions small enough to fit on one line.
  5. Thanks -- Paul G.
  6. Following translations are available on the WWW:
  7. - Japanese, maintained by the JF Project (jf@listserv.linux.or.jp), at
  8. http://linuxjf.sourceforge.jp/
  9. 00-INDEX
  10. - this file.
  11. ABI/
  12. - info on kernel <-> userspace ABI and relative interface stability.
  13. CodingStyle
  14. - nothing here, just a pointer to process/coding-style.rst.
  15. DMA-API.txt
  16. - DMA API, pci_ API & extensions for non-consistent memory machines.
  17. DMA-API-HOWTO.txt
  18. - Dynamic DMA mapping Guide
  19. DMA-ISA-LPC.txt
  20. - How to do DMA with ISA (and LPC) devices.
  21. DMA-attributes.txt
  22. - listing of the various possible attributes a DMA region can have
  23. EDID/
  24. - directory with info on customizing EDID for broken gfx/displays.
  25. IPMI.txt
  26. - info on Linux Intelligent Platform Management Interface (IPMI) Driver.
  27. IRQ-affinity.txt
  28. - how to select which CPU(s) handle which interrupt events on SMP.
  29. IRQ-domain.txt
  30. - info on interrupt numbering and setting up IRQ domains.
  31. IRQ.txt
  32. - description of what an IRQ is.
  33. Intel-IOMMU.txt
  34. - basic info on the Intel IOMMU virtualization support.
  35. Makefile
  36. - It's not of interest for those who aren't touching the build system.
  37. PCI/
  38. - info related to PCI drivers.
  39. RCU/
  40. - directory with info on RCU (read-copy update).
  41. SAK.txt
  42. - info on Secure Attention Keys.
  43. SM501.txt
  44. - Silicon Motion SM501 multimedia companion chip
  45. SubmittingPatches
  46. - nothing here, just a pointer to process/coding-style.rst.
  47. accounting/
  48. - documentation on accounting and taskstats.
  49. acpi/
  50. - info on ACPI-specific hooks in the kernel.
  51. admin-guide/
  52. - info related to Linux users and system admins.
  53. aoe/
  54. - description of AoE (ATA over Ethernet) along with config examples.
  55. arm/
  56. - directory with info about Linux on the ARM architecture.
  57. arm64/
  58. - directory with info about Linux on the 64 bit ARM architecture.
  59. auxdisplay/
  60. - misc. LCD driver documentation (cfag12864b, ks0108).
  61. backlight/
  62. - directory with info on controlling backlights in flat panel displays
  63. bcache.txt
  64. - Block-layer cache on fast SSDs to improve slow (raid) I/O performance.
  65. blackfin/
  66. - directory with documentation for the Blackfin arch.
  67. block/
  68. - info on the Block I/O (BIO) layer.
  69. blockdev/
  70. - info on block devices & drivers
  71. bt8xxgpio.txt
  72. - info on how to modify a bt8xx video card for GPIO usage.
  73. btmrvl.txt
  74. - info on Marvell Bluetooth driver usage.
  75. bus-devices/
  76. - directory with info on TI GPMC (General Purpose Memory Controller)
  77. bus-virt-phys-mapping.txt
  78. - how to access I/O mapped memory from within device drivers.
  79. cachetlb.txt
  80. - describes the cache/TLB flushing interfaces Linux uses.
  81. cdrom/
  82. - directory with information on the CD-ROM drivers that Linux has.
  83. cgroup-v1/
  84. - cgroups v1 features, including cpusets and memory controller.
  85. cgroup-v2.txt
  86. - cgroups v2 features, including cpusets and memory controller.
  87. circular-buffers.txt
  88. - how to make use of the existing circular buffer infrastructure
  89. clk.txt
  90. - info on the common clock framework
  91. cma/
  92. - Continuous Memory Area (CMA) debugfs interface.
  93. conf.py
  94. - It's not of interest for those who aren't touching the build system.
  95. connector/
  96. - docs on the netlink based userspace<->kernel space communication mod.
  97. console/
  98. - documentation on Linux console drivers.
  99. core-api/
  100. - documentation on kernel core components.
  101. cpu-freq/
  102. - info on CPU frequency and voltage scaling.
  103. cpu-hotplug.txt
  104. - document describing CPU hotplug support in the Linux kernel.
  105. cpu-load.txt
  106. - document describing how CPU load statistics are collected.
  107. cpuidle/
  108. - info on CPU_IDLE, CPU idle state management subsystem.
  109. cputopology.txt
  110. - documentation on how CPU topology info is exported via sysfs.
  111. crc32.txt
  112. - brief tutorial on CRC computation
  113. cris/
  114. - directory with info about Linux on CRIS architecture.
  115. crypto/
  116. - directory with info on the Crypto API.
  117. dcdbas.txt
  118. - information on the Dell Systems Management Base Driver.
  119. debugging-modules.txt
  120. - some notes on debugging modules after Linux 2.6.3.
  121. debugging-via-ohci1394.txt
  122. - how to use firewire like a hardware debugger memory reader.
  123. dell_rbu.txt
  124. - document demonstrating the use of the Dell Remote BIOS Update driver.
  125. dev-tools/
  126. - directory with info on development tools for the kernel.
  127. device-mapper/
  128. - directory with info on Device Mapper.
  129. dmaengine/
  130. - the DMA engine and controller API guides.
  131. devicetree/
  132. - directory with info on device tree files used by OF/PowerPC/ARM
  133. digsig.txt
  134. -info on the Digital Signature Verification API
  135. dma-buf-sharing.txt
  136. - the DMA Buffer Sharing API Guide
  137. docutils.conf
  138. - nothing here. Just a configuration file for docutils.
  139. dontdiff
  140. - file containing a list of files that should never be diff'ed.
  141. driver-api/
  142. - the Linux driver implementer's API guide.
  143. driver-model/
  144. - directory with info about Linux driver model.
  145. early-userspace/
  146. - info about initramfs, klibc, and userspace early during boot.
  147. efi-stub.txt
  148. - How to use the EFI boot stub to bypass GRUB or elilo on EFI systems.
  149. eisa.txt
  150. - info on EISA bus support.
  151. extcon/
  152. - directory with porting guide for Android kernel switch driver.
  153. isa.txt
  154. - info on EISA bus support.
  155. fault-injection/
  156. - dir with docs about the fault injection capabilities infrastructure.
  157. fb/
  158. - directory with info on the frame buffer graphics abstraction layer.
  159. features/
  160. - status of feature implementation on different architectures.
  161. filesystems/
  162. - info on the vfs and the various filesystems that Linux supports.
  163. firmware_class/
  164. - request_firmware() hotplug interface info.
  165. flexible-arrays.txt
  166. - how to make use of flexible sized arrays in linux
  167. fmc/
  168. - information about the FMC bus abstraction
  169. fpga/
  170. - FPGA Manager Core.
  171. frv/
  172. - Fujitsu FR-V Linux documentation.
  173. futex-requeue-pi.txt
  174. - info on requeueing of tasks from a non-PI futex to a PI futex
  175. gcc-plugins.txt
  176. - GCC plugin infrastructure.
  177. gpio/
  178. - gpio related documentation
  179. gpu/
  180. - directory with information on GPU driver developer's guide.
  181. hid/
  182. - directory with information on human interface devices
  183. highuid.txt
  184. - notes on the change from 16 bit to 32 bit user/group IDs.
  185. hwspinlock.txt
  186. - hardware spinlock provides hardware assistance for synchronization
  187. timers/
  188. - info on the timer related topics
  189. hw_random.txt
  190. - info on Linux support for random number generator in i8xx chipsets.
  191. hwmon/
  192. - directory with docs on various hardware monitoring drivers.
  193. i2c/
  194. - directory with info about the I2C bus/protocol (2 wire, kHz speed).
  195. x86/i386/
  196. - directory with info about Linux on Intel 32 bit architecture.
  197. ia64/
  198. - directory with info about Linux on Intel 64 bit architecture.
  199. ide/
  200. - Information regarding the Enhanced IDE drive.
  201. iio/
  202. - info on industrial IIO configfs support.
  203. index.rst
  204. - main index for the documentation at ReST format.
  205. infiniband/
  206. - directory with documents concerning Linux InfiniBand support.
  207. input/
  208. - info on Linux input device support.
  209. intel_txt.txt
  210. - info on intel Trusted Execution Technology (intel TXT).
  211. io-mapping.txt
  212. - description of io_mapping functions in linux/io-mapping.h
  213. io_ordering.txt
  214. - info on ordering I/O writes to memory-mapped addresses.
  215. ioctl/
  216. - directory with documents describing various IOCTL calls.
  217. iostats.txt
  218. - info on I/O statistics Linux kernel provides.
  219. irqflags-tracing.txt
  220. - how to use the irq-flags tracing feature.
  221. isapnp.txt
  222. - info on Linux ISA Plug & Play support.
  223. isdn/
  224. - directory with info on the Linux ISDN support, and supported cards.
  225. kbuild/
  226. - directory with info about the kernel build process.
  227. kernel-doc-nano-HOWTO.txt
  228. - outdated info about kernel-doc documentation.
  229. kdump/
  230. - directory with mini HowTo on getting the crash dump code to work.
  231. doc-guide/
  232. - how to write and format reStructuredText kernel documentation
  233. kernel-per-CPU-kthreads.txt
  234. - List of all per-CPU kthreads and how they introduce jitter.
  235. kobject.txt
  236. - info of the kobject infrastructure of the Linux kernel.
  237. kprobes.txt
  238. - documents the kernel probes debugging feature.
  239. kref.txt
  240. - docs on adding reference counters (krefs) to kernel objects.
  241. laptops/
  242. - directory with laptop related info and laptop driver documentation.
  243. ldm.txt
  244. - a brief description of LDM (Windows Dynamic Disks).
  245. leds/
  246. - directory with info about LED handling under Linux.
  247. livepatch/
  248. - info on kernel live patching.
  249. locking/
  250. - directory with info about kernel locking primitives
  251. lockup-watchdogs.txt
  252. - info on soft and hard lockup detectors (aka nmi_watchdog).
  253. logo.gif
  254. - full colour GIF image of Linux logo (penguin - Tux).
  255. logo.txt
  256. - info on creator of above logo & site to get additional images from.
  257. lsm.txt
  258. - Linux Security Modules: General Security Hooks for Linux
  259. lzo.txt
  260. - kernel LZO decompressor input formats
  261. m68k/
  262. - directory with info about Linux on Motorola 68k architecture.
  263. mailbox.txt
  264. - How to write drivers for the common mailbox framework (IPC).
  265. md/
  266. - directory with info about Linux Software RAID
  267. media/
  268. - info on media drivers: uAPI, kAPI and driver documentation.
  269. memory-barriers.txt
  270. - info on Linux kernel memory barriers.
  271. memory-devices/
  272. - directory with info on parts like the Texas Instruments EMIF driver
  273. memory-hotplug.txt
  274. - Hotpluggable memory support, how to use and current status.
  275. men-chameleon-bus.txt
  276. - info on MEN chameleon bus.
  277. metag/
  278. - directory with info about Linux on Meta architecture.
  279. mic/
  280. - Intel Many Integrated Core (MIC) architecture device driver.
  281. mips/
  282. - directory with info about Linux on MIPS architecture.
  283. misc-devices/
  284. - directory with info about devices using the misc dev subsystem
  285. mmc/
  286. - directory with info about the MMC subsystem
  287. mn10300/
  288. - directory with info about the mn10300 architecture port
  289. mtd/
  290. - directory with info about memory technology devices (flash)
  291. namespaces/
  292. - directory with various information about namespaces
  293. netlabel/
  294. - directory with information on the NetLabel subsystem.
  295. networking/
  296. - directory with info on various aspects of networking with Linux.
  297. nfc/
  298. - directory relating info about Near Field Communications support.
  299. nios2/
  300. - Linux on the Nios II architecture.
  301. nommu-mmap.txt
  302. - documentation about no-mmu memory mapping support.
  303. numastat.txt
  304. - info on how to read Numa policy hit/miss statistics in sysfs.
  305. ntb.txt
  306. - info on Non-Transparent Bridge (NTB) drivers.
  307. nvdimm/
  308. - info on non-volatile devices.
  309. nvmem/
  310. - info on non volatile memory framework.
  311. output/
  312. - default directory where html/LaTeX/pdf files will be written.
  313. padata.txt
  314. - An introduction to the "padata" parallel execution API
  315. parisc/
  316. - directory with info on using Linux on PA-RISC architecture.
  317. parport-lowlevel.txt
  318. - description and usage of the low level parallel port functions.
  319. pcmcia/
  320. - info on the Linux PCMCIA driver.
  321. percpu-rw-semaphore.txt
  322. - RCU based read-write semaphore optimized for locking for reading
  323. perf/
  324. - info about the APM X-Gene SoC Performance Monitoring Unit (PMU).
  325. phy/
  326. - ino on Samsung USB 2.0 PHY adaptation layer.
  327. phy.txt
  328. - Description of the generic PHY framework.
  329. pi-futex.txt
  330. - documentation on lightweight priority inheritance futexes.
  331. pinctrl.txt
  332. - info on pinctrl subsystem and the PINMUX/PINCONF and drivers
  333. platform/
  334. - List of supported hardware by compal and Dell laptop.
  335. pnp.txt
  336. - Linux Plug and Play documentation.
  337. power/
  338. - directory with info on Linux PCI power management.
  339. powerpc/
  340. - directory with info on using Linux with the PowerPC.
  341. prctl/
  342. - directory with info on the priveledge control subsystem
  343. preempt-locking.txt
  344. - info on locking under a preemptive kernel.
  345. printk-formats.txt
  346. - how to get printk format specifiers right
  347. process/
  348. - how to work with the mainline kernel development process.
  349. pps/
  350. - directory with information on the pulse-per-second support
  351. pti/
  352. - directory with info on Intel MID PTI.
  353. ptp/
  354. - directory with info on support for IEEE 1588 PTP clocks in Linux.
  355. pwm.txt
  356. - info on the pulse width modulation driver subsystem
  357. rapidio/
  358. - directory with info on RapidIO packet-based fabric interconnect
  359. rbtree.txt
  360. - info on what red-black trees are and what they are for.
  361. remoteproc.txt
  362. - info on how to handle remote processor (e.g. AMP) offloads/usage.
  363. rfkill.txt
  364. - info on the radio frequency kill switch subsystem/support.
  365. robust-futex-ABI.txt
  366. - documentation of the robust futex ABI.
  367. robust-futexes.txt
  368. - a description of what robust futexes are.
  369. rpmsg.txt
  370. - info on the Remote Processor Messaging (rpmsg) Framework
  371. rtc.txt
  372. - notes on how to use the Real Time Clock (aka CMOS clock) driver.
  373. s390/
  374. - directory with info on using Linux on the IBM S390.
  375. scheduler/
  376. - directory with info on the scheduler.
  377. scsi/
  378. - directory with info on Linux scsi support.
  379. security/
  380. - directory that contains security-related info
  381. serial/
  382. - directory with info on the low level serial API.
  383. sgi-ioc4.txt
  384. - description of the SGI IOC4 PCI (multi function) device.
  385. sh/
  386. - directory with info on porting Linux to a new architecture.
  387. smsc_ece1099.txt
  388. -info on the smsc Keyboard Scan Expansion/GPIO Expansion device.
  389. sound/
  390. - directory with info on sound card support.
  391. spi/
  392. - overview of Linux kernel Serial Peripheral Interface (SPI) support.
  393. sphinx/
  394. - no documentation here, just files required by Sphinx toolchain.
  395. sphinx-static/
  396. - no documentation here, just files required by Sphinx toolchain.
  397. static-keys.txt
  398. - info on how static keys allow debug code in hotpaths via patching
  399. svga.txt
  400. - short guide on selecting video modes at boot via VGA BIOS.
  401. sync_file.txt
  402. - Sync file API guide.
  403. sysctl/
  404. - directory with info on the /proc/sys/* files.
  405. target/
  406. - directory with info on generating TCM v4 fabric .ko modules
  407. tee.txt
  408. - info on the TEE subsystem and drivers
  409. this_cpu_ops.txt
  410. - List rationale behind and the way to use this_cpu operations.
  411. thermal/
  412. - directory with information on managing thermal issues (CPU/temp)
  413. trace/
  414. - directory with info on tracing technologies within linux
  415. translations/
  416. - translations of this document from English to another language
  417. unaligned-memory-access.txt
  418. - info on how to avoid arch breaking unaligned memory access in code.
  419. unshare.txt
  420. - description of the Linux unshare system call.
  421. usb/
  422. - directory with info regarding the Universal Serial Bus.
  423. vfio.txt
  424. - info on Virtual Function I/O used in guest/hypervisor instances.
  425. video-output.txt
  426. - sysfs class driver interface to enable/disable a video output device.
  427. virtual/
  428. - directory with information on the various linux virtualizations.
  429. vm/
  430. - directory with info on the Linux vm code.
  431. w1/
  432. - directory with documents regarding the 1-wire (w1) subsystem.
  433. watchdog/
  434. - how to auto-reboot Linux if it has "fallen and can't get up". ;-)
  435. wimax/
  436. - directory with info about Intel Wireless Wimax Connections
  437. core-api/workqueue.rst
  438. - information on the Concurrency Managed Workqueue implementation
  439. x86/x86_64/
  440. - directory with info on Linux support for AMD x86-64 (Hammer) machines.
  441. xillybus.txt
  442. - Overview and basic ui of xillybus driver
  443. xtensa/
  444. - directory with documents relating to arch/xtensa port/implementation
  445. xz.txt
  446. - how to make use of the XZ data compression within linux kernel
  447. zorro.txt
  448. - info on writing drivers for Zorro bus devices found on Amigas.