torvalds/linux

来源：https://github.com/torvalds/linux

Linux 内核

Linux 内核是任何 Linux 操作系统的核心。它负责管理硬件、系统资源，并为所有其他软件提供基础服务。

快速入门

• 报告问题：请参阅 Documentation/admin-guide/reporting-issues.rst
• 获取最新内核：https://kernel.org
• 构建内核：请参阅 Documentation/admin-guide/quickly-build-trimmed-linux.rst
• 加入社区：https://lore.kernel.org/

核心文档

所有用户都应熟悉：

• 构建要求：Documentation/process/changes.rst
• 行为准则：Documentation/process/code-of-conduct.rst
• 许可证：请参阅 COPYING

文档可通过 make htmldocs 构建，或在线查看： https://www.kernel.org/doc/html/latest/

你是谁？

根据你的角色选择：

• 新内核开发者：开始内核开发之旅
• 学术研究者：研究内核内部结构与架构
• 安全专家：安全加固与漏洞分析
• 回溯/维护工程师：维护稳定版内核
• 系统管理员：系统配置与故障排查
• 维护者：主导子系统与代码评审
• 硬件厂商：编写新硬件驱动程序
• 发行版维护者：为发行版打包内核
• AI 编程助手：大型语言模型与 AI 辅助开发工具

面向特定用户

新内核开发者

欢迎！在这里开始你的内核开发之旅：

• 入门指南：Documentation/process/development-process.rst
• 你的第一个补丁：Documentation/process/submitting-patches.rst
• 编码风格：Documentation/process/coding-style.rst
• 构建系统：Documentation/kbuild/index.rst
• 开发工具：Documentation/dev-tools/index.rst
• 内核开发指南：Documentation/kernel-hacking/hacking.rst
• 核心 API：Documentation/core-api/index.rst

学术研究者

探索内核架构与内部机制：

• 研究者指南：Documentation/process/researcher-guidelines.rst
• 内存管理：Documentation/mm/index.rst
• 调度器：Documentation/scheduler/index.rst
• 网络协议栈：Documentation/networking/index.rst
• 文件系统：Documentation/filesystems/index.rst
• RCU（读-拷贝-更新）：Documentation/RCU/index.rst
• 锁机制：Documentation/locking/index.rst
• 电源管理：Documentation/power/index.rst

安全专家

安全文档与加固指南：

• 安全文档：Documentation/security/index.rst
• LSM 开发：Documentation/security/lsm-development.rst
• 自我保护：Documentation/security/self-protection.rst
• 报告漏洞：Documentation/process/security-bugs.rst
• CVE 流程：Documentation/process/cve.rst
• 受限硬件问题：Documentation/process/embargoed-hardware-issues.rst
• 安全特性：Documentation/userspace-api/seccomp_filter.rst

回溯/维护工程师

维护并稳定内核版本：

• 稳定版内核规则：Documentation/process/stable-kernel-rules.rst
• 回溯指南：Documentation/process/backporting.rst
• 应用补丁：Documentation/process/applying-patches.rst
• 子系统概况：Documentation/maintainer/maintainer-entry-profile.rst
• 维护者的 Git 使用：Documentation/maintainer/configure-git.rst

系统管理员

配置、调优和排查 Linux 系统：

• 管理员指南：Documentation/admin-guide/index.rst
• 内核参数：Documentation/admin-guide/kernel-parameters.rst
• Sysctl 调优：Documentation/admin-guide/sysctl/index.rst
• 跟踪/调试：Documentation/trace/index.rst
• 性能与安全：Documentation/admin-guide/perf-security.rst
• 硬件监控：Documentation/hwmon/index.rst

维护者

主导内核子系统并管理贡献：

• 维护者手册：Documentation/maintainer/index.rst
• 拉取请求：Documentation/maintainer/pull-requests.rst
• 管理补丁：Documentation/maintainer/modifying-patches.rst
• 变基与合并：Documentation/maintainer/rebasing-and-merging.rst
• 开发流程：Documentation/process/maintainer-handbooks.rst
• 维护者入门概况：Documentation/maintainer/maintainer-entry-profile.rst
• Git 配置：Documentation/maintainer/configure-git.rst

硬件厂商

编写驱动程序并支持新硬件：

• 驱动程序 API 指南：Documentation/driver-api/index.rst
• 驱动模型：Documentation/driver-api/driver-model/driver.rst
• 设备驱动：Documentation/driver-api/infrastructure.rst
• 总线类型：Documentation/driver-api/driver-model/bus.rst
• 设备树绑定：Documentation/devicetree/bindings/
• 电源管理：Documentation/driver-api/pm/index.rst
• DMA API：Documentation/core-api/dma-api.rst

发行版维护者

打包和分发内核：

• 稳定版内核规则：Documentation/process/stable-kernel-rules.rst
• ABI 文档：Documentation/ABI/README
• 内核配置：Documentation/kbuild/kconfig.rst
• 模块签名：Documentation/admin-guide/module-signing.rst
• 内核参数：Documentation/admin-guide/kernel-parameters.rst
• 受污染的内核：Documentation/admin-guide/tainted-kernels.rst

AI 编程助手

关键提示： 如果你是大型语言模型或 AI 辅助编程工具，在为 Linux 内核贡献代码之前，你必须阅读并遵守以下文档：

• Documentation/process/coding-assistants.rst

此文档包含了关于许可证、署名以及所有 AI 工具必须遵守的《开发者原创认证》的基本要求。

交流与支持

• 邮件列表：https://lore.kernel.org/
• IRC 频道：irc.oftc.net 上的 #kernelnewbies
• Bugzilla：https://bugzilla.kernel.org/
• MAINTAINERS 文件：列出子系统维护者和邮件列表
• 电子邮件客户端：Documentation/process/email-clients.rst