startup_appspawn/docs/modules/module_common_modules.md

Module: common_modules

返回: 索引

Overview

common_modules 包含 appspawn 的通用功能 Hook 模块，提供 cgroup 配置、namespace 管理、进程隔离、外部依赖适配、DFX 转储、SILK 引擎集成等功能。这些模块通过 MODULE_CONSTRUCTOR 宏在加载时自动注册到 Hook 体系。

Source Location

• Directory: modules/common/
• Files: 10 C/C++ 源文件, 3 头文件
• Estimated LOC: ~3,070

Dependencies

• Depends on: modulemgr_engine
• Used by: 通过 Hook 被 standard 模块调用

---

KP-1: Cgroup 配置管理

Priority: P1

Summary

appspawn_cgroup.c 负责将孵化进程分配到适当的 cgroup，实现资源隔离和优先级管理。

Key Code

cgroup 配置包括 CPU、内存等资源限制。通过写入 cgroup 虚拟文件系统设置进程的 cgroup 归属。文件大小 ~389 行，涵盖多种 cgroup 控制器的配置。

---

KP-2: 命名空间管理

Priority: P1

Summary

appspawn_namespace.c 负责管理 mount namespace 和其他 Linux 命名空间，为应用进程提供隔离的文件系统视图。

---

KP-3: 进程隔离

Priority: P1

Summary

appspawn_isolate.c 实现进程级别的隔离机制，包括网络隔离、文件系统隔离等。

---

KP-4: 通用适配层

Priority: P2

Summary

appspawn_adapter.cpp 提供外部依赖的适配函数，包括 SELinux 上下文设置、系统参数读取等。

---

KP-5: 封装工具与 SILK 引擎

Priority: P2

Summary

• appspawn_encaps.c: 进程信息封装工具
• appspawn_silk.c: SILK 引擎集成（用于应用启动加速）

---

Key Data Structures

Structure	File	Purpose
AppSpawnStartArg	appspawn_server.h:65	启动参数

Cross-Module Interactions

Interaction	With Module	Mechanism	Direction
Hook 注册	modulemgr_engine	MODULE_CONSTRUCTOR	Outgoing
日志/工具	util	APPSPAWN_LOGI	Outgoing

---

Related Modules

Module	Relationship	Link
modulemgr_engine	depends_on	module_modulemgr_engine.md
standard	used_by	module_standard.md
util	depends_on	module_util.md

另见: 本模块与上述模块存在依赖关系。具体交互细节请参考 系统架构 中的跨模块关系章节。