Linus Torvalds e4fb7e5e8e Merge tag 'probes-fixes-v7.4-rc2' of git://git.kernel.org/pub/scm/linux/kernel/git/trace/linux-trace
Pull probe fixes from Masami Hiramatsu:
 "Fix registration and unregistration error handling:

   - Release the instruction slot via arch_remove_kprobe() and propagate
     the error code when arm_kprobe() fails in
     __register_kprobe() instead of leaking the slot and returning 0.

   - Skip rethook_free() and kretprobe holder cleanup in
     unregister_kretprobes() when __unregister_kprobe_top() fails, and
     clear rp->rh after synchronize_rcu() to avoid double free and NULL
     pointer dereferences.

   - Resolve the target address up-front in register_kretprobe() and
     check for re-registration before allocating resources so
     symbol_name-based re-registration does not corrupt the active
     kretprobe on error.

  Fix optprobe state transitions during forced unoptimization:

   - Disarm a disabled optprobe in unoptimize_kprobe() when forced
     unoptimization moves it directly to a cooling or freeing list, for
     preventing breakpoint callback of freed probes.

   - Skip disarming unhashed optprobes in the optimizer dispatch path so
     a newly registered probe at the same address does not get disarmed
     (or have freed module text written to).

   - Keep a reused cooling optprobe marked disabled in
     reuse_unused_kprobe() so register_aggr_kprobe() or enable_kprobe()
     properly arms it, and skip redundant force-unoptimization cleanup
     for already-unoptimized cooling probes.

  Fix symstr buffer overflow and eprobe triggers:

   - Format symstr symbols into a temporary buffer and copy only up to
     the reserved field length (updating __data_loc accordingly) to
     prevent overwriting the trace record if a probed pointer changes
     between sizing and storing passes.

   - Install and remove the eprobe event trigger for each trace instance
     file that enables the eprobe rather than only on first enable and
     last disable, so secondary instances record events and disabled
     triggers do not reference freed eprobes.

  Replace printk() with trace_printk() in probe handlers:

   - Replace printk() and stack_trace_print() with trace_printk() and
     trace_dump_stack() in kprobe and fprobe sample modules, and depend
     on CONFIG_EVENT_TRACING.

   - Document in kprobes.rst and fprobe.rst that calling printk()
     directly from probe handlers can deadlock on console or scheduler
     locks and recommend trace_printk() instead"

* tag 'probes-fixes-v7.4-rc2' of git://git.kernel.org/pub/scm/linux/kernel/git/trace/linux-trace:
  kprobes: Arm reused optprobe on cooling list
  kprobes: Do not disarm unhashed optprobe on dispatch
  kprobes: Disarm disabled optprobe on forced unoptimization
  tracing/eprobe: Install the trigger for every instance that enables the eprobe
  tracing/probes: bound symstr stores to reserved length
  docs: trace: Warn against using printk() in probe handlers
  samples/fprobe: Use trace_printk() and trace_dump_stack()
  samples/kprobes: Use trace_printk() in probe handlers
  kprobes: Validate re-registration earlier in register_kretprobe()
  kprobes: Fix double free and NULL deref in unregister_kretprobes()
  kprobes: Fix error return and slot leak in __register_kprobe()
2026-11-09 15:36:59 -08:00
2026-01-26 19:07:09 -08:00
2022-09-28 09:02:20 +02:00
…
2025-02-19 14:53:27 -07:00
2026-11-08 16:22:20 -08:00
2026-07-15 10:51:29 -06:00

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
* AI Coding Assistant: LLMs and AI-powered development tools


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

AI Coding Assistant
-------------------

CRITICAL: If you are an LLM or AI-powered coding assistant, you MUST read and
follow the AI coding assistants documentation before contributing to the Linux
kernel:

* Documentation/process/coding-assistants.rst

This documentation contains essential requirements about licensing, attribution,
and the Developer Certificate of Origin that all AI tools must comply with.


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
S
Description
Linux kernel source tree
Readme
7.7 GiB
Languages
C 96.8%
Assembly 0.9%
Rust 0.7%
Shell 0.6%
Python 0.5%
Other 0.3%