ccontrol – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

ccontrol – Wrapper zur Steuerung von distcc, ccache und mehr

ZUSAMMENFASSUNG

gcc ...

cc ...

c ++ ...

um ...

ld ...

ccontrol [--section= ] ...

ccontrol [--section= ]

BESCHREIBUNG

Das ccontrol(1) Das Programm übernimmt die Rolle des Compilers und Linkers und liest a
Konfigurationsdatei, um zu entscheiden, was zu tun ist, bevor Sie sie aufrufen. Dies ist besonders nützlich
zur zentralen Steuerung von Befehlen und Optionen, wie z. B. der Aktivierung distcc(1) und
Cache(1).

Wann ccontrol(1) wird unter seinem eigenen Namen ohne Argumente aufgerufen und gibt die aus
Einstellungen, die in diesem Verzeichnis gelten (es sei denn --Sektion angegeben).

Versionen werden nach der letzten Person benannt, die einen Fehler gemeldet hat.

OPTIONAL

Normalerweise ccontrol(1) wird als symbolischer Link zu cc, make usw. aufgerufen, damit es identifiziert werden kann
was aufgerufen wird, indem man seinen eigenen Namen untersucht. Es kann auch eigenständig aufgerufen werden
Name, in diesem Fall können ccontrol-spezifische Argumente angegeben werden. Die erste Nicht-Option
Das Argument wird verwendet, um den Aufruf zu identifizieren, z. „ccontrol gcc ...“.

Die folgenden Optionen werden unterstützt, wenn sie als aufgerufen werden ccontrol:

--section=
Für die Zwecke der Auswertung wird dieses als „aktuelles Verzeichnis“ behandelt
Konfigurationsdatei. Da alle echten Verzeichnisse mit einem „/“ und einem Argument beginnen müssen
was nicht der Fall ist, ist eine gute Möglichkeit, die Konfiguration für diesen speziellen Fall zu überschreiben
Aufruf.

CONFIGURATION FILE

Die Konfigurationsdatei von ccontrol ist $HOME/.ccontrol/config. Wenn dies nicht gelesen werden kann (und
geschrieben), werden Ihre Kompilierungen alle fehlschlagen. Es ist normal, mehrere verschiedene zu haben
Konfigurationsdateien in diesem Verzeichnis und legen Sie als Standard einen symbolischen Link fest.

SYNTAX

Eine Konfigurationsdatei besteht aus Abschnitten, angeführt von einem „[Pfad]“-Header und gefolgt von
eingerückte „Name = Wert“-Einträge. Der erste Abschnitt trägt normalerweise die Bezeichnung „[*]“, um den einzurichten
Standardwerte. Zumindest müssen Sie die Werte „cc“, „c++“, „make“ und „ld“ festlegen.

ccontrol liest jeden Abschnitt, der mit dem aktuellen Verzeichnis übereinstimmt, sodass Sie ihn überschreiben können
Werte pro Verzeichnis. Der „[Pfad]“-Header jedes Abschnitts ist im Shell-Stil gehalten
Platzhalter (siehe Klacks(7)), der das Verzeichnis oder die Verzeichnisse angibt, für die es gilt. Normalerweise
Dies endet mit einem „*“, um alle Unterverzeichnisse einzuschließen.

Alle mit „~“ beginnenden Pfade beziehen sich auf das Home-Verzeichnis des Benutzers. Ein Weg kann sein
als Verzeichnis angegeben. In diesem Fall hängt ccontrol den Programmnamen an das Verzeichnis an
Verzeichnis.

Folgende Einstellungen stehen zur Verfügung:

cc
Gefolgt von = Gibt den Pfad des Compilers an, der aufgerufen werden soll, wenn ccontrol vorhanden ist
aufgerufen als „cc“ oder „gcc“. ccontrol kann C-Programme nicht kompilieren, wenn dies nicht festgelegt ist.

c ++
Gefolgt von = Gibt den Pfad des Compilers an, der aufgerufen werden soll, wenn ccontrol vorhanden ist
aufgerufen als „c“ oder „g“. ccontrol kann C++-Programme nicht kompilieren, wenn dies nicht festgelegt ist.

ld
Gefolgt von = Gibt den Pfad des Linkers an, der aufgerufen werden soll, wenn ccontrol aufgerufen wird
als „ld“. ccontrol kann keine Programme verknüpfen, wenn dies nicht festgelegt ist.

um
Gefolgt von = Gibt den Pfad der Binärdatei an, die aufgerufen werden soll, wenn ccontrol aufgerufen wird
als „machen“. ccontrol schlägt fehl, wenn dies nicht festgelegt ist.

Cache
Gefolgt von = Gibt den Pfad von „ccache“ an und gibt an, dass ccache verwendet werden soll
gegebenenfalls. Wenn gefolgt von deaktivieren, oder nicht gesetzt, wird der Cache nicht verwendet.

distcc
Gefolgt von = Gibt den Pfad von „distcc“ an und gibt an, dass distcc verwendet werden soll
gegebenenfalls. Wenn gefolgt von deaktivieren, oder nicht gesetzt, oder distcc-hosts ist nicht gesetzt,
distcc wird nicht verwendet.

distcc-hosts
Gefolgt von = Gibt die zu verwendenden Distcc-Server gemäß der DISTCC_HOSTS-Umgebung an
Variable in distcc(1). gefolgt von deaktivieren deaktiviert distcc.

distc++-hosts
Dasselbe wie distcc-hosts, gilt jedoch nur für Ccompilations. Wenn nicht festgelegt, distcc-hosts
wird eingesetzt. Sie können daher distcc für C-Kompilierungen deaktivieren, indem Sie „distc++-hosts
deaktivieren".

CPU
Gefolgt von = und eine Anzahl von CPUs, eingestellt auf die Anzahl Ihrer CPUs (der Standardwert ist).
"1"). ccontrol nutzt dies, um den Grad der Parallelität abzustimmen.

nicht parallel
Gefolgt von = und eine durch Leerzeichen getrennte Liste von Platzhaltern, unterdrückt paralleles Make for
Jedes Make-Ziel passt zu einem dieser Elemente. Diese Option wird benötigt, weil ccontrol(1)
normalerweise Kräfte um(1) alle Aktionen parallel auszuführen, aber das kann verwirrend sein
wenn ein Fehler auftritt und schlecht geschriebene Makefiles beschädigt werden. gefolgt von deaktivieren,
Aktiviert die parallele Erstellung für alle Ziele: Dies ist nützlich, um die parallele Erstellung in einem wieder zu aktivieren
Unterverzeichnis.

schön
Gefolgt von = und eine Prioritätsstufe von -19 bis 20, veranlasst ccontrol, zu versuchen, seine festzulegen
Priorität auf diesen Wert. Der Standardwert ist 10.

das
Gefolgt von = Gibt eine Datei an, die an der aktuellen Stelle eingefügt werden soll. Der Effekt ist genau
als ob der Inhalt der enthaltenen Datei buchstäblich eingefügt würde. Kann in der Datei verwendet werden
Ebene, um Abschnitte einzuschließen. Kann auch innerhalb von Abschnitten verwendet werden, um Abschnitte einzuschließen
Fragmente.

hinzufügen machen
Gefolgt von = Gibt ein Argument an, das jedem Aufruf von hinzugefügt werden soll um. Das kann
mehrfach angegeben werden, um mehrere Argumente hinzuzufügen. gefolgt von deaktivieren entfernt alle
zuvor angegebene Argumente.

env hinzufügen
Gefolgt von = Gibt eine festzulegende Umgebungsvariable an, z. B. „add env =“.
CCACHE_DIR=/ Tmp". Dies kann mehrmals angegeben werden, um mehrere Umgebungen festzulegen
Variablen. gefolgt von deaktivieren Entfernt alle zuvor angegebenen Argumente.

ausführlich
Das allein deutet darauf hin ccontrol(1) besteht darin, eine Menge Mist auf den Standardfehler auszuspucken
darüber, was es mit Ihrer unschuldigen Befehlszeile macht.

Sperrdatei
Geben Sie eine bestimmte Sperrdatei an, die verwendet werden soll.

Beispiele:

Dies ist die minimale Konfigurationsdatei:

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

Wenn Sie mehrere Standorte haben (z. B. einen Laptop), ist es üblich, eine „globale“ Datei zu haben
die in jeder Konfigurationsdatei enthalten ist, etwa so:

# Konfigurationsdatei für die Arbeit. Viele Distcc-Hosts!
include = ~/.ccontrol/global

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

Hier ist eine vollständige Konfigurationsdatei mit mehreren gängigen Szenarien:

[*]
cc = /usr/bin/gcc-4.0
c++ = /usr/bin/g++-4.0
ld = /usr/bin/ld
machen = /usr/bin/make
# Kommentieren Sie dies erneut zum Debuggen
# ausführlich
distcc = /usr/bin/distcc
distcc-hosts = snab swarm1 swarm3 swarm4 swarm5 fandango2 mingo
distc++-hosts = snab mingo
ccache = /usr/bin/ccache
# make check sollte grundsätzlich nicht parallel ausgeführt werden
no-parallel = prüfen

# Wesnoth kompiliert nicht mit g++ 4.0
[*wesnoth*]
c++ = /usr/bin/g++-3.4

# Dumme Module von Drittanbietern werden nicht parallel erstellt.
[/usr/src/modules/*]
no-parallel = *

# Die Verwendung von distcc beim Testen von module-init-tools führt zu seltsamen Effekten.
[*module-init-tools*/tests/*]
distcc deaktivieren

Nutzen Sie ccontrol online über die Dienste von onworks.net