ccontrol - Online în cloud

PROGRAM:

NUME

ccontrol - wrapper pentru a controla distcc, ccache și multe altele

REZUMAT

gcc ...

cc ...

c ++ ...

face ...

ld ...

ccontrol [--sectiune= ] ...

ccontrol [--sectiune= ]

DESCRIERE

ccontrol(1) programul preia rolurile compilatorului și linkerului și citește a
fișier de configurare pentru a decide ce să facă înainte de a le invoca. Acest lucru este deosebit de util
pentru control centralizat asupra comenzilor și opțiunilor, cum ar fi activarea distcc(1) și
ccache(1).

Cand ccontrol(1) se invocă sub nume propriu fără argumente, se tipărește
setările care se aplică în acest director (cu excepția cazului în care --secțiune este specificat).

Versiunile sunt numite după ultima persoană care a raportat o eroare.

OPŢIUNI

În mod normal ccontrol(1) este invocat ca link simbolic către cc, make, etc, astfel încât să se poată identifica
ceea ce este invocat prin examinarea propriului nume. Poate fi invocat și pe cont propriu
nume, caz în care pot fi furnizate argumente specifice ccontrol. Prima non-opțiune
argumentul va fi folosit pentru a identifica invocarea, de ex. "ccontrol gcc ...".

Următoarele opțiuni sunt acceptate atunci când sunt invocate ca ccontrol:

--sectiune=
Acesta este tratat ca „directorul curent” în scopul evaluării
Fișier de configurare. Deoarece toate directoarele reale trebuie să înceapă cu un „/” folosind un argument
ceea ce nu, este o modalitate bună de a suprascrie configurația pentru acest particular
invocare.

CONFIGURARE FILE

Fișierul de configurare al lui ccontrol este $HOME/.ccontrol/config. Dacă acest lucru nu poate fi citit (și
scris), toate compilațiile tale vor eșua. Este normal să ai mai multe diferite
fișierele de configurare din acest director și faceți implicit o legătură simbolică.

SINTAXĂ

Un fișier de configurare este format din secțiuni, conduse de un antet „[cale]” și urmate de
intrări indentate „nume = valoare”. Prima secțiune este de obicei etichetată „[*]” pentru a configura
implicite. Cel puțin, trebuie să setați valorile „cc”, „c++”, „make” și „ld”.

ccontrol va citi fiecare secțiune care se potrivește cu directorul curent, astfel încât să puteți suprascrie
valorile pe director. Antetul „[cale]” al fiecărei secțiuni este în stil shell
wildcard (vezi glob(7)) care indică directorul sau directoarele la care se aplică. Obișnuit
aceasta se va termina cu un „*” pentru a include toate subdirectoarele.

Toate căile care încep cu „~” sunt relative la directorul principal al utilizatorului. O cale poate fi
specificat ca director, caz în care ccontrol va adăuga numele programului la
director.

Sunt disponibile următoarele setări:

cc
Urmat de = specifică calea compilatorului care urmează să fie invocată atunci când ccontrol este
invocat ca „cc” sau „gcc”. ccontrol nu va compila programe C dacă nu este setat.

c ++
Urmat de = specifică calea compilatorului care urmează să fie invocată atunci când ccontrol este
invocat ca „c” sau „g”. ccontrol nu va compila programe C++ dacă nu este setat.

ld
Urmat de = specifică calea linkerului care urmează să fie invocat atunci când este invocat ccontrol
ca „ld”. ccontrol nu va reuși să conecteze programele dacă nu este setat.

face
Urmat de = specifică calea binarului care va fi invocat atunci când este invocat ccontrol
ca „a face”. ccontrol nu va reuși dacă nu este setat.

ccache
Urmat de = specifică calea „ccache” și indică faptul că ccache trebuie utilizat
acolo unde este cazul. Dacă este urmată de dezactivați, sau nesetat, ccache nu va fi folosit.

distcc
Urmat de = specifică calea „distcc” și indică faptul că distcc va fi utilizat
acolo unde este cazul. Dacă este urmată de dezactivați, sau nu este setat, sau distcc-hosts nu este setat,
distcc nu va fi folosit.

distcc-hosts
Urmat de = specifică serverele distcc de utilizat, conform mediului DISTCC_HOSTS
variabilă în distcc(1). Urmată de dezactivați dezactivează distcc.

distc++-gazde
La fel ca distcc-hosts, dar se aplică numai Ccompilations. Dacă nu este setat, distcc-hosts
este folosit. Astfel, puteți dezactiva distcc pentru compilațiile C setând „distc++-hosts
dezactivați”.

CPU
Urmat de = și un număr de procesoare, setat la numărul de procesoare pe care le aveți (prestabilit este
„1”). ccontrol folosește acest lucru pentru a regla gradul de paralelism.

fără paralel
Urmat de = și o listă de caractere joker separate prin spațiu, suprimă paralele
orice face tinta care se potriveste cu una dintre acestea. Această opțiune este necesară deoarece ccontrol(1)
de obicei forţe face(1) pentru a efectua toate acțiunile în paralel, dar acest lucru poate fi confuz
atunci când apare o eroare și rupe fișierele make prost scrise. Urmată de dezactivați,
permite realizarea paralelă pentru toate țintele: aceasta este utilă pentru a reactiva realizarea paralelă în a
subdirector.

frumos
Urmat de = iar un nivel de prioritate de la -19 la 20, face ca ccontrol să încerce să-și seteze
prioritate la această valoare. Implicit este 10.

include
Urmat de = specifică un fișier de inclus în punctul curent. Efectul este exact
ca și cum conținutul fișierului inclus ar fi inserat literalmente. Poate fi folosit la dosar
nivel pentru a include secțiuni. Poate fi folosit și în cadrul secțiunilor pentru a include secțiune
fragmente.

adăugați face
Urmat de = specifică un argument de adăugat la fiecare invocare a face. Acesta poate
fie specificat de mai multe ori pentru a adăuga mai multe argumente. Urmată de dezactivați elimină orice
argumentele specificate anterior.

adauga env
Urmat de = specifică o variabilă de mediu care trebuie setată, cum ar fi „add env =
CCACHE_DIR=/ tmp". Acest lucru poate fi specificat de mai multe ori pentru a seta mai multe medii
variabile. Urmată de dezactivați elimină orice argument specificat anterior.

prolix
În sine, indică faptul că ccontrol(1) este a scuipa o mulțime de prostii la eroare standard
despre ce face linia ta de comandă nevinovată.

dosar de blocare
Specificați un anumit fișier de blocare de utilizat.

EXEMPLE

Acesta este fișierul de configurare minimă:

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

Dacă aveți mai multe locații (cum ar fi un laptop), este obișnuit să aveți un fișier „global”.
care este inclus din fiecare fișier de configurare, astfel:

# Fișier de configurare pentru când sunt la serviciu. O mulțime de gazde distcc!
include = ~/.ccontrol/global

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

Iată un fișier de configurare complet cu mai multe scenarii comune:

[*]
cc = /usr/bin/gcc-4.0
c++ = /usr/bin/g++-4.0
ld = /usr/bin/ld
face = /usr/bin/make
# Comentați acest lucru înapoi pentru depanare
# verbose
distcc = /usr/bin/distcc
distcc-hosts = snab swarm1 swarm3 swarm4 swarm5 fandango2 mingo
distc++-hosts = snab mingo
ccache = /usr/bin/ccache
# make check nu ar trebui, în general, să fie rulat în paralel
no-parallel = verifica

# Wesnoth nu se compila cu g++ 4.0
[*wesnoth*]
c++ = /usr/bin/g++-3.4

# Modulele terțe stupide nu se construiesc în paralel.
[/usr/src/modules/*]
fara paralel = *

# Utilizarea distcc la testarea module-init-tools provoacă efecte ciudate.
[*module-init-tools*/teste/*]
distcc dezactivare

Utilizați ccontrol online folosind serviciile onworks.net