ccontrol - Online in de cloud

PROGRAMMA:

NAAM

ccontrol - wrapper om distcc, ccache en meer te beheren

KORTE INHOUD

gcc ...

cc ...

C ++ ...

maken ...

ld ...

controle [--sectie= ] ...

controle [--sectie= ]

PRODUCTBESCHRIJVING

De controle(1) programma neemt de rollen over van de compiler en linker, en leest a
configuratiebestand om te beslissen wat u moet doen voordat u ze aanroept. Dit is bijzonder nuttig
voor gecentraliseerde controle over opdrachten en opties, zoals inschakelen distcc(1) en
ccache(1).

. controle(1) wordt aangeroepen onder zijn eigen naam zonder argumenten, het drukt de
instellingen die van toepassing zijn in deze map (tenzij --sectie is gespecificeerd).

Versies zijn vernoemd naar de laatste persoon die een bug heeft gerapporteerd.

OPTIES

Normaal controle(1) wordt aangeroepen als een symbolische link naar cc, make, enz., zodat het kan worden geïdentificeerd
wat wordt aangeroepen door zijn eigen naam te onderzoeken. Het kan ook op zichzelf worden ingeroepen
naam, in welk geval ccontrol-specifieke argumenten kunnen worden opgegeven. De eerste non-optie
argument zal worden gebruikt om de aanroep te identificeren, bijv. "ccontrol gcc...".

De volgende opties worden ondersteund, wanneer ze worden aangeroepen als controle:

--sectie=
Dit wordt behandeld als de "huidige map" met het oog op het evalueren van de
configuratiebestand. Omdat alle echte mappen moeten beginnen met een "/" met behulp van een argument
wat niet het geval is, is een goede manier om de configuratie voor dit specifieke te overschrijven
aanroeping.

CONFIGURATIE FILE

Het configuratiebestand van ccontrol is $HOME/.ccontrol/config. Als dit niet kan worden gelezen (en
geschreven), zullen je compilaties allemaal mislukken. Het is normaal dat er meerdere zijn
configuratiebestanden in deze map en maak standaard een symbolische link.

SYNTAXIS

Een configuratiebestand bestaat uit secties, voorafgegaan door een header "[path]" en gevolgd door
ingesprongen "naam = waarde"-vermeldingen. De eerste sectie heeft meestal het label "[*]" om de
standaardinstellingen. U moet op zijn minst de waarden "cc", "c++", "make" en "ld" instellen.

ccontrol leest elke sectie die overeenkomt met de huidige map, zodat u deze kunt overschrijven
waarden per map. De kop "[path]" van elke sectie is in shell-stijl
wildcard (zie glob(7)) die de map of mappen aangeeft waarop deze van toepassing is. Gebruikelijk
dit eindigt op een "*" om alle submappen op te nemen.

Alle paden die beginnen met "~" zijn relatief ten opzichte van de thuismap van de gebruiker. Een pad kan zijn
opgegeven als map, in welk geval ccontrol de programmanaam aan het
directory.

De volgende instellingen zijn beschikbaar:

cc
Gevolgd door = specificeert het pad van de compiler die moet worden aangeroepen wanneer ccontrol is
aangeroepen als "cc" of "gcc". ccontrol zal er niet in slagen C-programma's te compileren als dit niet is ingesteld.

C ++
Gevolgd door = specificeert het pad van de compiler die moet worden aangeroepen wanneer ccontrol is
aangeroepen als "c" of "g". ccontrol zal er niet in slagen C++-programma's te compileren als dit niet is ingesteld.

ld
Gevolgd door = specificeert het pad van de linker die moet worden aangeroepen wanneer ccontrol wordt aangeroepen
als "ld". ccontrol zal er niet in slagen programma's te koppelen als dit niet is ingesteld.

maken
Gevolgd door = specificeert het pad van het binaire bestand dat moet worden aangeroepen wanneer ccontrol wordt aangeroepen
als "maken". ccontrol kan niet worden gemaakt als dit niet is ingesteld.

ccache
Gevolgd door = specificeert het pad van "ccache" en geeft aan dat ccache moet worden gebruikt
waar passend. Indien gevolgd door 'disable', of niet ingesteld, zal ccache niet worden gebruikt.

distcc
Gevolgd door = specificeert het pad van "distcc" en geeft aan dat distcc moet worden gebruikt
waar passend. Indien gevolgd door 'disable', of niet ingesteld, of distcc-hosts is niet ingesteld,
distcc wordt niet gebruikt.

distcc-hosts
Gevolgd door = specificeert de distcc-servers die moeten worden gebruikt, volgens de DISTCC_HOSTS-omgeving
variabele in distcc(1). Gevolgd door 'disable' schakelt distcc uit.

distc++-hosts
Hetzelfde als distcc-hosts, maar alleen van toepassing op Ccompilaties. Indien niet ingesteld, distcc-hosts
is gebruikt. U kunt distcc dus uitschakelen voor C-compilaties door "distc++-hosts
uitzetten".

cpu's
Gevolgd door = en een aantal CPU's, ingesteld op het aantal CPU's dat je hebt (de standaardwaarde is
"1"). controle gebruikt dit om de mate van parallellisme af te stemmen.

niet-parallel
Gevolgd door = en een door spaties gescheiden lijst met jokertekens onderdrukt parallelle make-up
elk merkdoel komt overeen met een van deze. Deze optie is nodig omdat controle(1)
meestal krachten maken(1) om alle acties parallel uit te voeren, maar dit kan verwarrend zijn
wanneer er een fout optreedt en slecht geschreven makefiles worden verbroken. Gevolgd door 'disable',
maakt parallelle make-up mogelijk voor alle doelen: dit is handig om parallelle make-up opnieuw in te schakelen in a
submap.

mooi
Gevolgd door = en een prioriteitsniveau van -19 tot 20 zorgt ervoor dat ccontrol probeert zijn prioriteit in te stellen
prioriteit aan deze waarde. Standaard is 10.

omvatten
Gevolgd door = specificeert een bestand dat op het huidige punt moet worden opgenomen. Het effect is precies
alsof de inhoud van het opgenomen bestand letterlijk is ingevoegd. Kan gebruikt worden in dossier
niveau om secties op te nemen. Kan ook binnen secties worden gebruikt om secties op te nemen
fragmenten.

voeg merk toe
Gevolgd door = specificeert een argument dat moet worden toegevoegd aan elke aanroep van maken. Dit kan
meerdere keren worden opgegeven om meerdere argumenten toe te voegen. Gevolgd door 'disable' verwijdert eventuele
eerder opgegeven argumenten.

omv. toevoegen
Gevolgd door = specificeert een omgevingsvariabele die moet worden ingesteld, zoals "add env =
CCACHE_DIR=/ tmp". Dit kan meerdere keren worden opgegeven om meerdere omgevingen in te stellen
variabelen. Gevolgd door 'disable' verwijdert alle eerder opgegeven argumenten.

breedsprakig
Geeft dat op zichzelf al aan controle(1) is om veel onzin uit te spugen op standaardfouten
over wat het met uw onschuldige opdrachtregel doet.

lock-bestand
Geef een bepaald vergrendelingsbestand op dat u wilt gebruiken.

Voorbeelden

Dit is het minimale configuratiebestand:

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

Als u meerdere locaties heeft (zoals een laptop), is het gebruikelijk dat u over een ‘globaal’ bestand beschikt
die is opgenomen in elk configuratiebestand, zoals zo:

# Configuratiebestand voor als ik aan het werk ben. Veel distcc-hosts!
omvatten = ~/.ccontrol/wereldwijd

[*]
distcc-hosts = snab zwerm1 zwerm3 zwerm4 zwerm5 fandango2 mingo
distc++-hosts = snab mingo

Hier is een compleet configuratiebestand met verschillende veelvoorkomende scenario's:

[*]
cc = /usr/bin/gcc-4.0
c++ = /usr/bin/g++-4.0
l = /usr/bin/ld
maak = /usr/bin/make
# Geef hier commentaar op voor foutopsporing
# uitgebreid
distcc = /usr/bin/distcc
distcc-hosts = snab zwerm1 zwerm3 zwerm4 zwerm5 fandango2 mingo
distc++-hosts = snab mingo
ccache = /usr/bin/ccache
# make check mag doorgaans niet parallel worden uitgevoerd
niet-parallel = controleren

# Wesnoth compileert niet met g++ 4.0
[*wesnoth*]
c++ = /usr/bin/g++-3.4

# Stomme modules van derden bouwen niet parallel.
[/usr/src/modules/*]
niet-parallel = *

# Het gebruik van distcc bij het testen van module-init-tools veroorzaakt vreemde effecten.
[*module-init-tools*/tests/*]
distcc uitschakelen

Gebruik ccontrol online met behulp van onworks.net-services