clang 源码导读（6）: clang driver 执行命令

[toc]

前言

本篇文章会对 clang driver 的 执行命令 流程进行讲解

执行命令

执行命令 会将 构建 Jobs 流程组建的 jobs 依次执行

正式分享前，我们先按照惯例分享本文涉及的 流程图，方便对 执行命令 的主要流程进行理解

整理后的流程图：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

graph TD

subgraph Driver
	Driver::ExecuteCompilation
end

subgraph Compilation
  Compilation::ExecuteJobs
  for-jobs

  Compilation::ExecuteCommand
  打印即将执行的命令
  Compilation::ExecuteCommand
  CC1Command::Execute
  InputsOk
  ActionFailed
  Command::Execute
end

  main-->Driver::ExecuteCompilation-->Compilation::ExecuteJobs-->for-jobs
  for-jobs--1. 判断前置 job 是否失败了-->InputsOk-->ActionFailed
  for-jobs--2. 执行命令-->

  Compilation::ExecuteCommand--3. 判断是否存在 -v 参数 --> 打印即将执行的命令
  Compilation::ExecuteCommand--> CC1Command::Execute-->Command::Execute
  Compilation::ExecuteCommand--> Command::Execute
  Command::Execute--4. 执行命令-->llvm::sys::ExecuteAndWait-->posix_spawn
  Command::Execute--5. 收集子进程信息-->llvm::sys::Wait-->sys::wait4

执行命令

jobs 构建完成后，会先调用 Driver::ExecuteCompilation 方法

Driver::ExecuteCompilation 方法会依次完成以下任务：

1. 通过 Compilation::ExecuteJobs 执行命令
2. 如果某些命令存在报错，将结果文件移除，并打印相关信息

Compilation::ExecuteJobs

Compilation::ExecuteJobs 会遍历 Jobs，并通过 InputsOk 判断是否需要执行，如果需要执行，则依次调用 Compilation::ExecuteCommand

如果某个 Job 对其它 Job 有依赖，并且依赖的 Job 已经失败了，则不再执行该 Job

比如，ld 依赖 clang -cc1 的构建产物，如果 clang -cc1 执行失败，ld 命令不会被执行

Compilation::ExecuteCommand

Compilation::ExecuteCommand 会依次执行以下两个任务：

1. 存在 -v 参数时，需要打印即将执行的命令
2. 调用 CC1Command::Execute 或 Command::Execute 执行命令

CC1Command::Execute

大部分情况下， CC1Command::Execute 都会直接转发到 Command::Execute 执行命令

Command::Execute

Command::Execute 会将可执行文件路径和参数拼接到一起，并依次执行以下任务：

1. 调用 llvm::sys::ExecuteAndWait 执行命令
2. 调用 llvm::sys::Wait 收集子进程的资源信息

llvm::sys::ExecuteAndWait

llvm::sys::ExecuteAndWait 会先检查可执行文件是否存在，并调用 posix_spawn 创建进程的方式执行该命令

llvm::sys::Wait

llvm::sys::Wait 是通过 sys::wait4 收集子进程的信息

总结

本文通过分析源码的方式，对 clang driver 的 执行命令 涉及的流程进行了完整的分析