ccontrol - Online na nuvem

PROGRAMA:

NOME

ccontrol - wrapper para controlar distcc, ccache e mais

SINOPSE

gcc ...

cc ...

c ++ ...

fazer ...

ld ...

ccontrol [--section = ] ...

ccontrol [--section = ]

DESCRIÇÃO

A ccontrol(1) programa assume as funções de compilador e vinculador, e lê um
arquivo de configuração para decidir o que fazer antes de invocá-los. Isso é particularmente útil
para controle centralizado sobre comandos e opções, como habilitar distcc(1) e
cache(1).

Quando ccontrol(1) é invocado com seu próprio nome sem argumentos, ele imprime o
configurações que se aplicam a este diretório (a menos que --seção é especificado).

As versões são nomeadas após a última pessoa a relatar um bug.

OPÇÕES

Normalmente ccontrol(1) é invocado como um link de simbolização para cc, make, etc, para que possa identificar
o que está sendo invocado examinando seu próprio nome. Ele também pode ser invocado por conta própria
nome, caso em que argumentos específicos de ccontrol podem ser fornecidos. A primeira não opção
argumento será usado para identificar a invocação, por exemplo. "ccontrol gcc ...".

As seguintes opções são suportadas, quando chamadas como ccontrol:

--section =
Este é tratado como o "diretório atual" para fins de avaliação do
arquivo de configuração. Como todos os diretórios reais devem começar com "/" usando um argumento
o que não é, é uma boa maneira de substituir a configuração para este
invocação.

CONFIGURAÇÃO ARQUIVO

O arquivo de configuração do ccontrol é $ HOME / .ccontrol / config. Se isto não puder ser lido (e
escrito), todas as suas compilações falharão. É normal ter vários
arquivos de configuração neste diretório e tornar padrão um link simbólico.

SINTAXE

Um arquivo de configuração consiste em seções, lideradas por um cabeçalho "[caminho]" e seguido por
entradas de "nome = valor" recuadas. A primeira seção geralmente é identificada como "[*]" para configurar o
padrões. No mínimo, você deve definir os valores "cc", "c ++", "make" e "ld".

ccontrol irá ler cada seção que corresponda ao diretório atual, então você pode sobrescrever
valores por diretório. O cabeçalho "[path]" de cada seção é um estilo de shell
curinga (ver glob(7)) que indica o diretório ou diretórios aos quais se aplica. Usualmente
isso terminará em um "*" para incluir todos os subdiretórios.

Todos os caminhos que começam com "~" são relativos ao diretório inicial do usuário. Um caminho pode ser
especificado como um diretório, caso em que ccontrol anexará o nome do programa ao
diretório.

As seguintes configurações estão disponíveis:

cc
Seguido por = especifica o caminho do compilador a ser chamado quando ccontrol é
invocado como "cc" ou "gcc". ccontrol falhará ao compilar programas C se isso não for definido.

c ++
Seguido por = especifica o caminho do compilador a ser chamado quando ccontrol é
chamado como "c" ou "g". ccontrol falhará ao compilar programas C ++ se isto não for definido.

ld
Seguido por = especifica o caminho do linker a ser invocado quando ccontrol é invocado
como "ld". O ccontrol falhará ao vincular programas se isso não for definido.

fazer
Seguido por = especifica o caminho do binário a ser invocado quando ccontrol é invocado
como "fazer". O ccontrol falhará em fazer se não estiver definido.

cache
Seguido por = especifica o caminho de "ccache" e indica que ccache deve ser usado
onde apropriado. Se seguido por desabiltar, ou não definido, o ccache não será usado.

distcc
Seguido por = especifica o caminho de "distcc" e indica que distcc deve ser usado
onde apropriado. Se seguido por desabiltar, ou não definido, ou distcc-hosts não está definido,
distcc não será usado.

hosts distcc
Seguido por = especifica os servidores distcc a serem usados, de acordo com o ambiente DISTCC_HOSTS
variável em distcc(1). Seguido pela desabiltar desabilita distcc.

distc ++ - hosts
O mesmo que distcc-hosts, mas se aplica apenas a Ccompilations. Se não for definido, distcc-hosts
é usado. Você pode, portanto, desabilitar distcc para compilações C definindo "distc ++ - hosts
desativar ".

CPU
Seguido por = e um número de CPUs, definido para o número de CPUs que você tem (o padrão é
"1"). ccontrol usa isso para ajustar o grau de paralelismo.

sem paralelo
Seguido por = e uma lista de caracteres curinga separados por espaço, suprime o make paralelo para
qualquer um faz o alvo coincidir com um daqueles. Esta opção é necessária porque ccontrol(1)
normalmente força fazer(1) para realizar todas as ações em paralelo, mas isso pode ser confuso
quando ocorre um erro, e quebra makefiles mal escritos. Seguido pela desabiltar,
ativa o make paralelo para todos os alvos: isso é útil para reativar o make paralelo em um
subdiretório.

agradável
Seguido por = e um nível de prioridade de -19 a 20, faz com que ccontrol tente definir seu
prioridade a este valor. O padrão é 10.

incluir
Seguido por = especifica um arquivo a ser incluído no ponto atual. O efeito é exatamente
como se o conteúdo do arquivo incluído fosse inserido literalmente. Pode ser usado no arquivo
nível para incluir seções. Também pode ser usado dentro das seções para incluir a seção
fragmentos.

adicionar make
Seguido por = especifica um argumento a ser adicionado a cada invocação de fazer. Isso pode
ser especificado várias vezes para adicionar vários argumentos. Seguido pela desabiltar remove qualquer
argumentos especificados anteriormente.

adicionar env
Seguido por = especifica uma variável de ambiente a ser definida, como "add env =
CCACHE_DIR =/ Tmp". Isso pode ser especificado várias vezes para definir vários ambientes
variáveis. Seguido pela desabiltar remove todos os argumentos especificados anteriormente.

detalhado
Por si só, indica que ccontrol(1) é cuspir muita besteira com o erro padrão
sobre o que está fazendo com sua linha de comando inocente.

arquivo de bloqueio
Especifique um arquivo de bloqueio específico a ser usado.

EXEMPLOS

Este é o arquivo de configuração mínimo:

[*]
cc = / usr / bin / gcc
c ++ = / usr / bin / g ++
ld = / usr / bin / ld
fazer = / usr / bin / make

Se você tiver vários locais (como um laptop), é comum ter um arquivo "global"
que é incluído em cada arquivo de configuração, assim:

# Arquivo de configuração para quando estou no trabalho. Muitos hosts distcc!
incluir = ~ / .ccontrol / global

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

Aqui está um arquivo de configuração completo com vários cenários comuns:

[*]
cc = /usr/bin/gcc-4.0
c ++ = /usr/bin/g++-4.0
ld = / usr / bin / ld
fazer = / usr / bin / make
# Comente isso de volta para depuração
# detalhado
distcc = / usr / bin / distcc
distcc-hosts = snab swarm1 swarm3 swarm4 swarm5 fandango2 mingo
distc ++ - hosts = snab mingo
ccache = / usr / bin / ccache
# make check geralmente não deve ser executado em paralelo
sem paralelo = verificar

# Wesnoth não compila com g ++ 4.0
[* wesnoth *]
c ++ = /usr/bin/g++-3.4

# Módulos estúpidos de terceiros não são construídos em paralelo.
[/ usr / src / modules / *]
sem paralelo = *

# O uso do distcc ao testar as ferramentas do module-init causa efeitos estranhos.
[* module-init-tools * / tests / *]
desabilitar distcc

Use ccontrol online usando serviços onworks.net