ccontrol - 云端在线

程序：

您的姓名

ccontrol - 控制 distcc、ccache 等的包装器

概要

GCC ...

cc ...

C ++ ...

使 ...

ld ...

控制 [--部分= ] ...

控制 [--部分= ]

商品描述

控制(1) 程序接管编译器和链接器的角色，并读取一个
配置文件来决定在调用它们之前要做什么。 这特别有用
用于集中控制命令和选项，例如启用 分区（1）和
缓存（1）。

什么时候 控制(1) 以它自己的名字调用，没有参数，它打印出
适用于此目录的设置（除非 - 部分 指定）。

版本以最后一个报告错误的人命名。

配置

通常情况下 控制(1) 作为cc、make等的符号链接被调用，因此可以识别
通过检查自己的名称来调用什么。 也可以在自己的下调用
名称，在这种情况下，可以提供特定于 ccontrol 的参数。 第一个非选项
参数将用于识别调用，例如。 “ccontrol gcc ...”。

当作为调用时，支持以下选项 控制:

--section=
出于评估的目的，这被视为“当前目录”
配置文件。 由于所有实际目录都必须使用参数以“/”开头
不是，这是覆盖此特定配置的好方法
调用。

配置 文件

ccontrol 的配置文件是 $HOME/.ccontrol/config。 如果无法读取（和
写），您的编译将全部失败。 有几种不同的情况是正常的
此目录中的配置文件，并默认为符号链接。

句法

配置文件由部分组成，以“[path]”标题开头，后跟
缩进的“名称 = 值”条目。 第一部分通常标有“[*]”以设置
默认值。 至少，您必须设置“cc”、“c++”、“make”和“ld”值。

ccontrol 将读取与当前目录匹配的每个部分，因此您可以覆盖
基于每个目录的值。 每个部分的“[path]”标题是一个shell风格的
通配符（见 水珠(7)) 表示它适用的一个或多个目录。 通常
这将以“*”结尾以包含所有子目录。

所有以“~”开头的路径都相对于用户的主目录。 一条路径可能是
指定为目录，在这种情况下，ccontrol 会将程序名称附加到
目录。

以下设置可用：

cc
其次是 = 指定 ccontrol 时要调用的编译器的路径
称为“cc”或“gcc”。 如果未设置，ccontrol 将无法编译 C 程序。

C ++
其次是 = 指定 ccontrol 时要调用的编译器的路径
称为“c”或“g”。 如果未设置，ccontrol 将无法编译 C++ 程序。

ld
其次是 = 指定调用ccontrol时要调用的链接器的路径
作为“ld”。 如果未设置，ccontrol 将无法链接程序。

使
其次是 = 指定调用ccontrol时要调用的二进制文件的路径
作为“制作”。 如果未设置，ccontrol 将无法制作。

缓存
其次是 = 指定“ccache”的路径，表示要使用ccache
在适当情况下。 如果紧随其后 关闭，或未设置，将不会使用 ccache。

分区
其次是 = 指定“distcc”的路径，表示要使用distcc
在适当情况下。 如果紧随其后 关闭，或未设置，或未设置 distcc-hosts，
将不会使用 distcc。

distcc 主机
其次是 = 根据 DISTCC_HOSTS 环境指定要使用的 distcc 服务器
变量 分区(1). 其次是 关闭 禁用 distcc。

distc++-主机
与 distcc-hosts 相同，但仅适用于 Ccompilations。 如果没有设置，distcc-hosts
用来。 因此，您可以通过设置“distc++-hosts”来禁用 C 编译的 distcc
禁用”。

CPU的
其次是 = 和 CPU 数量，设置为您拥有的 CPU 数量（默认为
“1”）。 控制 使用它来调整并行度。

不平行
其次是 = 和以空格分隔的通配符列表，抑制并行 make
任何使目标匹配其中之一。 需要此选项是因为 控制(1)
通常强迫 使(1) 并行执行所有操作，但这可能会造成混淆
当发生错误并破坏编写不佳的 makefile 时。 其次是 关闭,
为所有目标启用并行 make：这对于重新启用并行 make 很有用
子目录。

不错
其次是 = 以及从 -19 到 20 的优先级，导致 ccontrol 尝试设置其
优先考虑这个值。 默认值为 10。

包括
其次是 = 指定要在当前点包含的文件。 效果正是
就好像包含文件的内容是按字面插入的一样。 可以在文件中使用
级别以包括部分。 也可以在节中使用以包含节
碎片。

添加制作
其次是 = 指定要添加到每次调用的参数 使。 这个可以
多次指定以添加多个参数。 其次是 关闭 删除任何
先前指定的参数。

添加环境
其次是 = 指定要设置的环境变量，如“add env =
CCACHE_DIR=/ tmp目录". 这个可以多次指定来设置多个环境
变量。 其次是 关闭 删除先前指定的任何参数。

详细
就其本身而言，表明 控制(1) 是将大量废话吐出到标准错误
关于它对你无辜的命令行做了什么。

锁定文件
指定要使用的特定锁定文件。

示例

这是最小的配置文件：

[*]
cc = /usr/bin/gcc
C++ = /usr/bin/g++
LD= /usr/bin/ld
制作 = /usr/bin/制作

如果您有多个位置（例如笔记本电脑），通常会有一个“全局”文件
它包含在每个配置文件中，如下所示：

# 我工作时的配置文件。 很多distcc主机！
包括 = ~/.ccontrol/全局

[*]
distcc-hosts = snab swarm1 swarm3 swarm4 swarm5 fandango2 Mingo
distc++-hosts = snabmingo

这是一个完整的配置文件，包含几个常见的场景：

[*]
cc = /usr/bin/gcc-4.0
c++ = /usr/bin/g++-4.0
LD= /usr/bin/ld
制作 = /usr/bin/制作
# 将此注释回用于调试
# 详细
distcc = /usr/bin/distcc
distcc-hosts = snab swarm1 swarm3 swarm4 swarm5 fandango2 Mingo
distc++-hosts = snabmingo
ccache = /usr/bin/ccache
# make check 通常不应并行运行
非平行 = 检查

# Wesnoth 不能用 g++ 4.0 编译
[*韦诺*]
c++ = /usr/bin/g++-3.4

# 愚蠢的第三方模块不会并行构建。
[/usr/src/模块/*]
无平行 = *

# 在测试 module-init-tools 时使用 distcc 会导致奇怪的效果。
[*模块初始化工具*/测试/*]
distcc 禁用

使用 onworks.net 服务在线使用 ccontrol