pub/scm/linux/kernel/git/docs/linux.git  about / heads / tags
corbet's fork of linux.git
$ git log --pretty=format:'%h %s (%cs)%d'
fcb70a56f4d81 Merge tag 'vfs-6.19-rc8.fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs (2026-01-26)
	(HEAD -> master)
63804fed149a6 Linux 6.19-rc7 (2026-01-25)
	(tag: v6.19-rc7)
0237777974728 Merge tag 'scsi-fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/jejb/scsi (2026-01-25)
f9e6e6d210669 Merge tag 'keys-trusted-next-6.19-rc7' of git://git.kernel.org/pub/scm/linux/kernel/git/jarkko/linux-tpmdd (2026-01-25)
0a6dce0a5c66a Merge tag 'char-misc-6.19-rc7' of git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/char-misc (2026-01-25)
11de40c03cf0f Merge tag 'tty-6.19-rc7' of git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/tty (2026-01-25)
913fb068e2590 Merge tag 'i2c-for-6.19-rc7' of git://git.kernel.org/pub/scm/linux/kernel/git/wsa/linux (2026-01-25)
c1a5135e60f1a Merge tag 'input-for-v6.19-rc6' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input (2026-01-25)
6342969dafbc6 keys/trusted_keys: fix handle passed to tpm_buf_append_name during unseal (2026-01-25)
19a5d9ba6208e Input: i8042 - add quirks for MECHREVO Wujie 15X Pro (2026-01-24)
...

$ git cat-file blob HEAD:README
Linux kernel
============

The Linux kernel is the core of any Linux operating system. It manages hardware,
system resources, and provides the fundamental services for all other software.

Quick Start
-----------

* Report a bug: See Documentation/admin-guide/reporting-issues.rst
* Get the latest kernel: https://kernel.org
* Build the kernel: See Documentation/admin-guide/quickly-build-trimmed-linux.rst
* Join the community: https://lore.kernel.org/

Essential Documentation
-----------------------

All users should be familiar with:

* Building requirements: Documentation/process/changes.rst
* Code of Conduct: Documentation/process/code-of-conduct.rst
* License: See COPYING

Documentation can be built with make htmldocs or viewed online at:
https://www.kernel.org/doc/html/latest/


Who Are You?
============

Find your role below:

* New Kernel Developer - Getting started with kernel development
* Academic Researcher - Studying kernel internals and architecture
* Security Expert - Hardening and vulnerability analysis
* Backport/Maintenance Engineer - Maintaining stable kernels
* System Administrator - Configuring and troubleshooting
* Maintainer - Leading subsystems and reviewing patches
* Hardware Vendor - Writing drivers for new hardware
* Distribution Maintainer - Packaging kernels for distros


For Specific Users
==================

New Kernel Developer
--------------------

Welcome! Start your kernel development journey here:

* Getting Started: Documentation/process/development-process.rst
* Your First Patch: Documentation/process/submitting-patches.rst
* Coding Style: Documentation/process/coding-style.rst
* Build System: Documentation/kbuild/index.rst
* Development Tools: Documentation/dev-tools/index.rst
* Kernel Hacking Guide: Documentation/kernel-hacking/hacking.rst
* Core APIs: Documentation/core-api/index.rst

Academic Researcher
-------------------

Explore the kernel's architecture and internals:

* Researcher Guidelines: Documentation/process/researcher-guidelines.rst
* Memory Management: Documentation/mm/index.rst
* Scheduler: Documentation/scheduler/index.rst
* Networking Stack: Documentation/networking/index.rst
* Filesystems: Documentation/filesystems/index.rst
* RCU (Read-Copy Update): Documentation/RCU/index.rst
* Locking Primitives: Documentation/locking/index.rst
* Power Management: Documentation/power/index.rst

Security Expert
---------------

Security documentation and hardening guides:

* Security Documentation: Documentation/security/index.rst
* LSM Development: Documentation/security/lsm-development.rst
* Self Protection: Documentation/security/self-protection.rst
* Reporting Vulnerabilities: Documentation/process/security-bugs.rst
* CVE Procedures: Documentation/process/cve.rst
* Embargoed Hardware Issues: Documentation/process/embargoed-hardware-issues.rst
* Security Features: Documentation/userspace-api/seccomp_filter.rst

Backport/Maintenance Engineer
-----------------------------

Maintain and stabilize kernel versions:

* Stable Kernel Rules: Documentation/process/stable-kernel-rules.rst
* Backporting Guide: Documentation/process/backporting.rst
* Applying Patches: Documentation/process/applying-patches.rst
* Subsystem Profile: Documentation/maintainer/maintainer-entry-profile.rst
* Git for Maintainers: Documentation/maintainer/configure-git.rst

System Administrator
--------------------

Configure, tune, and troubleshoot Linux systems:

* Admin Guide: Documentation/admin-guide/index.rst
* Kernel Parameters: Documentation/admin-guide/kernel-parameters.rst
* Sysctl Tuning: Documentation/admin-guide/sysctl/index.rst
* Tracing/Debugging: Documentation/trace/index.rst
* Performance Security: Documentation/admin-guide/perf-security.rst
* Hardware Monitoring: Documentation/hwmon/index.rst

Maintainer
----------

Lead kernel subsystems and manage contributions:

* Maintainer Handbook: Documentation/maintainer/index.rst
* Pull Requests: Documentation/maintainer/pull-requests.rst
* Managing Patches: Documentation/maintainer/modifying-patches.rst
* Rebasing and Merging: Documentation/maintainer/rebasing-and-merging.rst
* Development Process: Documentation/process/maintainer-handbooks.rst
* Maintainer Entry Profile: Documentation/maintainer/maintainer-entry-profile.rst
* Git Configuration: Documentation/maintainer/configure-git.rst

Hardware Vendor
---------------

Write drivers and support new hardware:

* Driver API Guide: Documentation/driver-api/index.rst
* Driver Model: Documentation/driver-api/driver-model/driver.rst
* Device Drivers: Documentation/driver-api/infrastructure.rst
* Bus Types: Documentation/driver-api/driver-model/bus.rst
* Device Tree Bindings: Documentation/devicetree/bindings/
* Power Management: Documentation/driver-api/pm/index.rst
* DMA API: Documentation/core-api/dma-api.rst

Distribution Maintainer
-----------------------

Package and distribute the kernel:

* Stable Kernel Rules: Documentation/process/stable-kernel-rules.rst
* ABI Documentation: Documentation/ABI/README
* Kernel Configuration: Documentation/kbuild/kconfig.rst
* Module Signing: Documentation/admin-guide/module-signing.rst
* Kernel Parameters: Documentation/admin-guide/kernel-parameters.rst
* Tainted Kernels: Documentation/admin-guide/tainted-kernels.rst



Communication and Support
=========================

* Mailing Lists: https://lore.kernel.org/
* IRC: #kernelnewbies on irc.oftc.net
* Bugzilla: https://bugzilla.kernel.org/
* MAINTAINERS file: Lists subsystem maintainers and mailing lists
* Email Clients: Documentation/process/email-clients.rst

# heads (aka `branches'):
$ git for-each-ref --sort=-creatordate refs/heads \
	--format='%(HEAD) %(refname:short) %(subject) (%(creatordate:short))'
  docs-mw      Merge branch 'mauro' into docs-mw (2026-05-03)
  docs-next    Merge branch 'mauro' into docs-mw (2026-05-03)
  docs-fixes   scripts/checkpatch: add Assisted-by: tag validation (2026-03-30)
* master       Merge tag 'vfs-6.19-rc8.fixes' of git://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs (2026-01-26)

# tags:
$ git for-each-ref --sort=-creatordate refs/tags \
	--format='%(refname:short) %(subject) (%(creatordate:short))'
docs-7.1     A busier cycle than I had expected for docs, including: (2026-04-12) tar.gz
docs-7.0-2   A handful of small, late-arriving documentation fixes. (2026-02-15) tar.gz
docs-7.0     A slightly calmer cycle for docs this time around, though there is still a fair amount going on, including: (2026-02-09) tar.gz
v6.19-rc7    Linux 6.19-rc7 (2026-01-25) tar.gz
v6.19-rc6    Linux 6.19-rc6 (2026-01-18) tar.gz
v6.19-rc5    Linux 6.19-rc5 (2026-01-11) tar.gz
v6.19-rc4    Linux 6.19-rc4 (2026-01-04) tar.gz
v6.19-rc3    Linux 6.19-rc3 (2025-12-28) tar.gz
v6.19-rc2    Linux 6.19-rc2 (2025-12-21) tar.gz
v6.19-rc1    Linux 6.19-rc1 (2025-12-14) tar.gz
...

# associated public inboxes:
# (number on the left is used for dev purposes)
    1368652 lkml
     418110 stable
     364496 netdev
     275229 linux-arm-kernel
     147777 linux-devicetree
     118949 linux-wireless
     113464 dri-devel
      78563 linuxppc-dev
      77890 linux-fsdevel
      77587 linux-mm
      76432 linux-media
      72862 alsa-devel
      71511 linux-patches
      57818 intel-gfx
      57317 kvm
      53314 linux-scsi
      53093 amd-gfx
      47835 linux-arm-msm
      43474 linux-omap
      42805 linux-mips
      42701 linux-arch
      38820 linux-xfs
      36883 linux-doc
      35184 bpf
      34865 linux-rdma
      33215 linux-nfs
      33204 linux-pm
      33048 linux-crypto
      31533 linux-mediatek
      30685 linux-s390
      29487 linux-samsung-soc
      28915 linux-block
      28094 linux-acpi
      26663 netfilter-devel
      26588 linux-riscv
      26092 linux-perf-users
      25768 linux-renesas-soc
      24948 linux-gpio
      24760 linux-clk
      24705 linux-pci
      24501 linux-mtd
      23732 linux-usb
      23153 linux-iio
      23142 linux-sh
      22768 linux-tegra
      22313 linux-kselftest
      20934 sparclinux
      20353 linux-btrfs
      19857 kernel-janitors
      19602 linux-input
      18288 kvmarm
      17382 linux-ext4
      17026 linux-staging
      16806 linux-iommu
      16657 linux-serial
      16309 xen-devel
      16270 linux-ide
      16086 linux-api
      15690 linux-rockchip
      15561 linux-fbdev
      15474 linux-mmc
      15240 linux-cifs
      14908 virtualization
      14814 u-boot
      14792 linux-kbuild
      13996 driverdev-devel
      13060 linux-bluetooth
      13002 intel-xe
      12957 linux-spi
      12953 linux-security-module
      12834 intel-wired-lan
      12728 linux-parisc
      12309 qemu-devel
      12205 linux-amlogic
      12039 platform-driver-x86
      12037 linux-i2c
      11590 linux-um
      11306 linux-f2fs-devel
      10890 linux-sound
      10818 ceph-devel
      10341 linux-ia64
      10267 dm-devel
      10138 linux-alpha
       9738 linux-m68k
       9061 cgroups
       9058 linux-snps-arc
       8788 linux-nvme
       8747 nouveau
       8562 nvdimm
       8557 linux-sunxi
       8154 loongarch
       7870 linux-can
       7686 linux-trace-kernel
       7643 linux-efi
       7216 cluster-devel
       7066 linux-hwmon
       6826 linux-rtc
       6787 linux-hardening
       6766 linux-raid
       6736 linux-watchdog
       6708 linux-hexagon
       6625 lustre-devel
       6496 containers
       6423 batman
       6394 cip-dev
       6329 openrisc
       6058 ocfs2-devel
       6057 rcu
       5972 kvm-ppc
       5953 dmaengine
       5952 selinux
       5745 io-uring
       5565 llvm
       5527 linux-nvdimm
       5504 linux-rt-users
       5498 linux-integrity
       5425 linux-csky
       5397 imx
       5205 linux-next
       5203 linux-leds
       5192 rust-for-linux
       5174 linux-pwm
       4817 kernel-hardening
       4817 mptcp
       4722 linux-sctp
       4545 linux-hyperv
       4389 linux-cxl
       4312 outreachy
       4232 bridge
       4148 linux-remoteproc
       4100 linux-phy
       4047 ath10k
       4034 dpdk-dev
       3987 git
       3905 kexec
       3810 buildroot
       3804 linux-modules
       3780 keyrings
       3748 lm-sensors
       3682 linux-erofs
       3593 linux-nilfs
       3569 soc
       3479 linux-wpan
       3210 linux-fscrypt
       3209 target-devel
       3111 linux-unionfs
       3021 linux-bcache
       2933 ath11k
       2871 linux-edac
       2842 b4-sent
       2693 ath12k
       2469 openbmc
       2439 asahi
       2341 v9fs
       2295 ath9k-devel
       2287 chrome-platform
       2274 lvs-devel
       2270 linux-hams
       2203 openembedded-core
       2095 phone-devel
       2012 damon
       1979 ntfs3
       1947 linux-audit
       1825 linux-bcachefs
       1690 linux-fpga
       1602 linux-kernel-mentees
       1591 cpufreq
       1571 openembedded-devel
       1533 dccp
       1482 linux-trace-devel
       1456 netfs
       1454 gfs2
       1448 ecryptfs
       1421 reiserfs-devel
       1414 linux-coco
       1377 b43-dev
       1258 historical-speck
       1122 linux-x25
       1090 linux-sgx
       1037 live-patching
       1034 ntb
       1001 fsverity
        959 linux-metag
        908 fstests
        880 oe-kbuild-all
        858 linux-spdx
        840 linux-i3c
        809 ltp
        781 linux-sparse
        759 autofs
        756 audit
        718 sched-ext
        699 igt-dev
        684 netfilter
        670 linux-aspeed
        664 linux-man
        640 cocci
        640 lvm-devel
        637 linux-ppp
        590 linux-toolchains
        548 qemu-riscv
        537 tpmdd-devel
        510 regressions
        488 linux-oxnas
        482 kvm-riscv
        477 yocto
        465 oe-lkp
        421 virtio-dev
        419 linux-rt-devel
        417 spacemit
        392 wireguard
        392 sophgo
        370 acpica-devel
        354 mhi
        344 kernel-tls-handshake
        344 arm-scmi
        339 workflows
        311 linux-nfc
        311 oe-linux-nfc
        290 u-boot-amlogic
        272 brcm80211
        262 lttng-dev
        224 yocto-meta-ti
        224 grub-devel
        219 bitbake-devel
        218 mm-commits
        212 yocto-meta-arago
        202 xfs-stable
        198 backports
        194 ofono
        171 util-linux
        169 kernel-testers
        166 yocto-meta-freescale
        164 fio
        158 xenomai
        158 poky
        150 linux-embedded
        149 xdp-newbies
        149 devicetree-compiler
        149 kvm-ia64
        140 kernelci
        137 yocto-meta-arm
        133 virtio-fs
        131 op-tee
        126 driver-core
        125 x86-cpuid
        124 linux-kernel-announce
        100 iwd
         99 trinity
         96 lkmm
         90 linux-laptop
         89 yocto-meta-virtualization
         86 kernelnewbies
         81 yocto-docs
         80 initramfs
         76 selinux-refpolicy
         76 linux-btrace
         73 ksummit
         72 linux-hotplug
         64 ksummit-discuss
         61 fuego
         59 linux-firmware
         59 perfbook
         57 ell
         57 yocto-toaster
         41 stable-rt
         39 dwarves
         38 timestamp
         38 barebox
         34 virtio-comment
         33 kdevops
         33 yocto-patches
         31 wireless-regdb
         30 qemu-arm
         29 linux-console
         28 devicetree-spec
         28 rpdfs-devel
         27 linux-debuggers
         27 powertop
         25 linux-lvm
         22 oe-kbuild
         19 connman
         18 dash
         17 linux-safety
         16 linux-dash
         16 ultralinux
         13 linux-trace-users
         13 hail-devel
         12 dtrace
         11 mailbox
          9 radiotap
          9 kbd
          9 smatch
          8 tools
          8 tech-board-discuss
          8 opensbi
          7 qemu-rust
          6 ccan
          5 keys
          5 linux-newbie
          5 linux-numa
          5 accel-config
          5 criu
          4 dm-crypt
          4 linux-msdos
          4 lartc
          3 stgt
          3 linux-smp
          3 tpm2
          2 linux-dwarves
          2 oe-chipsec
          2 syzbot
          1 signatures
          1 linux-bugs
          1 cti-tac
          1 linux-config
          1 linux-8086
          1 mlmmj
          1 spdk

git clone https://yhbt.net/lore/pub/scm/linux/kernel/git/docs/linux.git