/MP (Erstellen mit mehreren Prozessen)
Die /MP Option kann die gesamte Zeit Quelldateien in der Befehlszeile zu kompilieren.Mit der /MP-Option wird der Compiler veranlasst, jeweils in einem getrennten Prozess eine oder mehrere Kopien von sich selbst zu erstellen.Anschließend kompilieren diese Kopien gleichzeitig die Quelldateien.Infolgedessen kann die Gesamtzeit für die Erstellung der Quelldateien bedeutend reduziert werden.
/MP[processMax]
Argumente
processMax
(Optional) Die maximale Anzahl von Prozessen, die der Compiler erstellen kann.Das processMax-Argument muss zwischen 1 und 65536 liegen.Andernfalls ignoriert der Compiler warnmeldung Problem D9014, das processMax-Argument und setzt voraus, dass die maximale Anzahl von Prozessen 1 ist.
Wenn Sie das processMax-Argument nicht angeben, ruft der Compiler die Anzahl der effektiven Prozessoren auf dem Computer vom Betriebssystem ab und erstellt für jeden Prozessor einen Prozess.
Hinweise
Wenn Sie zahlreiche Dateien kompilieren, kann die /MP-Compileroption die Buildzeit beträchtlich reduzieren.Zur Erstellungszeit zu verbessern, erstellt der Compiler bis zu processMax Kopien von sich selbst und verwendet dann diese Kopien um die Quelldateien gleichzeitig zu kompilieren.Die /MP-Option gilt für Kompilierungen, aber nicht für das Verknüpfen oder die Codegenerierung beim Verknüpfen.Standardmäßig ist die /MP Option aus.
Die Verbesserung der Buildzeit hängt ab von der Anzahl der Prozessoren auf einem Computer, der Anzahl der zu kompilierenden Dateien und der Verfügbarkeit von Systemressourcen, z. B. der E/A-Kapazität.Experimentieren Sie mit der /MP-Option, um die beste Einstellung zum Erstellen eines bestimmten Projekts zu bestimmen.Ratschläge, die Sie bei dieser Entscheidung unterstützen, finden Sie unter Richtlinien.
Nicht kompatible Optionen und Sprachfeatures
Die /MP-Option ist mit einigen Compileroptionen und Sprachfeatures nicht kompatibel.Wenn Sie eine nicht kompatible Compileroption mit der /MP-Option verwenden, gibt der Compiler die Warnung D9030 aus und ignoriert die /MP-Option.Wenn Sie eine nicht kompatible Sprachfunktion verwenden, setzt die Enden Compiler C2813Problem fehler-, oder Sie dann je nachdem, welche aktuellen Compilerwarnungs Option auf Weiter.
.gif "Hinweis") Hinweis |
|---|
Die meisten Optionen sind nicht kompatibel, denn wenn sie zulässig wären, würden die gleichzeitig ausgeführten Compiler ihre Ausgabe zur gleichen Zeit auf der Konsole oder in eine bestimmte Datei schreiben.Als Ergebnis würde sich die Ausgabe vermischen und würde verstümmelt.In einigen Fällen würde die Kombination von Optionen die Leistung verschlechtern. |
In der folgenden Tabelle werden Compileroptionen und Sprachfeatures aufgelistet, die mit der /MP-Option nicht kompatibel sind:
Option oder Sprachfeature |
Beschreibung |
|---|---|
#import-Präprozessordirektive |
Konvertiert die Typen in einer Typbibliothek in C++-Klassen und schreibt diese Klassen dann in eine Headerdatei. |
Kopiert die Präprozessorausgabe in die Standardausgabe (stdout). |
|
Ermöglicht eine inkrementelle erneute Erstellung. |
|
Schreibt eine Liste von Includedateien in den Standardfehler (stderr). |
|
Schreibt eine vorkompilierte Headerdatei. |
Diagnosemeldungen
Wird eine mit der /MP-Option nicht kompatible Option bzw. ein nicht kompatibles Sprachfeature angegeben, erhalten Sie eine Diagnosemeldung.In der folgenden Tabelle werden die Meldungen und das Verhalten des Compilers aufgelistet:
Diagnosemeldung |
Beschreibung |
Compilerverhalten |
|---|---|---|
C2813 |
Die #import-Direktive ist nicht kompatibel mit der /MP-Option. |
Die Kompilierung endet, sofern nicht durch eine Option für die Warnstufe des Compilers etwas anderes angegeben wird. |
D9014 |
Für das processMax-Argument wurde ein ungültiger Wert angegeben. |
Der Compiler ignoriert den ungültigen Wert und geht vom Wert 1 aus. |
D9030 |
Die angegebene Option ist mit /MP nicht kompatibel. |
Der Compiler ignoriert die /MP-Option. |
Richtlinien
.gif "Bb385193.collapse_all(de-de,VS.110).gif")
Messen der Leistung
Verwenden Sie die gesamte Buildzeit zum Messen der Leistung.Sie können die Buildzeit mit einer physischen Uhr messen oder mit Software die Differenz zwischen Anfang und Ende des Builds berechnen.Wenn der Computer mehrere Prozessoren besitzt, führt eine physische Uhr möglicherweise zu genaueren Ergebnissen als eine Zeitmessung per Software.
Effektive Prozessoren
Ein Computer kann für jeden seiner physischen Prozessoren einen oder mehrere virtuelle Prozessoren besitzen, die auch als effektive Prozessoren bekannt sind.Jeder physische Prozessor kann einen oder mehrere Kerne besitzen, und wenn das Betriebssystem für einen Kern Hyperthreading ermöglicht, erscheint jeder Kern als zwei virtuelle Prozessoren.
Ein Computer besitzt z. B. einen effektiven Prozessor, wenn er einen physischen Prozessor mit einem Kern besitzt und Hyperthreading deaktiviert ist.Im Gegensatz dazu besitzt ein Computer acht effektive Prozessoren, wenn er zwei physische Prozessoren mit jeweils zwei Kernen besitzt und für alle Kerne Hyperthreading aktiviert ist.Das heißt: (8 effektive Prozessoren) = (2 physische Prozessoren) x (2 Kerne pro physischem Prozessor) x (2 effektive Prozessoren pro Kern wegen Hyperthreading).
Wenn Sie das processMax-Argument in der /MP-Option nicht angeben, ruft der Compiler die Anzahl der effektiven Prozessoren vom Betriebssystem ab und erstellt dann für jeden effektiven Prozessor einen Prozess.Der Compiler kann jedoch nicht gewährleisten, dass Prozesse auf einem bestimmten Prozessor ausgeführt werden. Diese Entscheidung wird vom Betriebssystem getroffen.
Anzahl der Prozesse
Der Compiler berechnet die Anzahl der Prozesse, mit denen er die Quelldateien kompiliert.Der Wert ist der niedrigere der beiden folgenden Werte: der Anzahl der Quelldateien, die Sie in der Befehlszeile angeben, und der Anzahl der Prozesse, die Sie mit der /MP-Option explizit oder implizit angeben.Sie können die maximale Anzahl von Prozessen mit dem processMax-Argument der /MP-Option festlegen.Sie haben auch die Möglichkeit, das processMax-Argument nicht anzugeben und den Standard zu verwenden, der der Anzahl der effektiven Prozessoren in einem Computer entspricht.
Angenommen, Sie geben z. B. die folgende Befehlszeile an:
cl /MP7 a.cpp b.cpp c.cpp d.cpp e.cpp
In diesem Fall verwendet der Compiler fünf Prozesse, da es sich bei fünf Quelldateien und maximal sieben Prozessen um den niedrigeren Wert handelt.Gehen Sie alternativ davon aus, dass der Computer zwei effektive Prozessoren hat und Sie die folgende Befehlszeile angeben:
cl /MP a.cpp b.cpp c.cpp
In diesem Fall meldet das Betriebssystem zwei Prozessoren. Daher verwendet der Compiler zwei Prozesse in seiner Berechnung.Als Ergebnis führt der Compiler den Build mit zwei Prozessen aus, da es sich bei zwei Prozessen und drei Quelldateien um den niedrigeren Wert handelt.
Quelldateien und Buildreihenfolge
Die Quelldateien werden möglicherweise nicht in der gleichen Reihenfolge kompiliert, in der sie in der Befehlszeile angezeigt werden.Auch wenn der Compiler einen Satz mit Prozessen erstellt, die Kopien des Compilers enthalten, plant das Betriebssystem die Ausführungszeiten für die einzelnen Prozesse.Infolgedessen können Sie nicht garantieren, dass die Quelldateien in einer bestimmten Reihenfolge kompiliert werden.
Eine Quelldatei wird kompiliert, wenn ein Prozess für ihre Kompilierung verfügbar ist.Wenn es mehr Dateien als Prozesse gibt, wird der erste Dateisatz von den verfügbaren Prozessen kompiliert.Die restlichen Dateien werden verarbeitet, wenn ein Prozess die Behandlung einer vorherigen Datei abgeschlossen hat und für die Bearbeitung einer der restlichen Dateien verfügbar ist.
Geben Sie nicht mehrmals die gleiche Quelldatei in einer Befehlszeile an.Dies könnte z. B. eintreten, wenn ein Tool automatisch eine Makefile erstellt, die auf Abhängigkeitsinformationen in einem Projekt basiert.Wenn Sie die /MP-Option nicht angeben, verarbeitet der Compiler die Liste der Dateien sequenziell und kompiliert eine Datei mit jedem Vorkommen erneut.Wenn Sie aber die /MP-Option angeben, wird dieselbe Datei von verschiedenen Compilern möglicherweise zur gleichen Zeit kompiliert.Infolgedessen versuchen die verschiedenen Compiler, zur gleichen Zeit in die gleiche Ausgabedatei zu schreiben.Ein Compiler erhält exklusiven Schreibzugriff für die Ausgabedatei und kann den Vorgang erfolgreich abschließen. Die anderen Compiler sind nicht erfolgreich und geben einen Dateizugriffsfehler aus.
Verwenden von Typbibliotheken (#import)
Der Compiler unterstützt nicht die Verwendung der #import-Direktive mit dem /MP-Schalter.Führen Sie nach Möglichkeit die folgenden Schritten aus, um dieses Problem zu umgehen:
Verschieben Sie alle #import-Direktiven in den verschiedenen Quelldateien in eine oder mehrere Dateien, und kompilieren Sie dann diese Dateien ohne die /MP-Option.Das Ergebnis ist ein Satz generierter Headerdateien.
Fügen Sie in den restlichen Quelldateien #include-Direktiven ein, die die generierten Header angeben, und kompilieren Sie dann die restlichen Quelldateien mit der /MP-Option.
Visual Studio-Projekteinstellungen
Das MSBUILD.exe-Tool
Visual Studio verwendet das Tool MSBuild.exe, um Projektmappen und Projekte zu erstellen.Mit der Befehlszeilenoption **/maxcpucount:**number (oder **/m:**number) des MSBuild.exe-Tools können mehrere Projekte gleichzeitig erstellt werden.Mit der /MP-Compileroption können außerdem mehrere Kompilierungseinheiten gleichzeitig erstellt werden.Wenn es für Ihre Anwendung angebracht ist, verkürzen Sie die Buildzeit Ihrer Projektmappe dadurch, dass Sie /MP oder /maxcpucount oder beide verwenden.
Die Buildzeit der Projektmappe hängt teilweise von der Anzahl der Prozesse ab, die den Build ausführen.Das number-Argument der /maxcpucount-MSBuild-Option gibt die maximale Anzahl der Projekte an, die gleichzeitig erstellt werden sollen.Entsprechend gibt das processMax-Argument der /MP-Compileroption die maximale Anzahl der Kompilierungseinheiten an, die gleichzeitig erstellt werden können.Wenn die /maxcpucount -Option P Projekte und die /MP-Option C Prozesse angibt, werden maximal PxC Prozesse gleichzeitig ausgeführt.
Für die Entscheidung, ob die MSBuild-Technologie oder die /MP-Technologie zu verwenden ist, gilt folgende Richtlinie:
Wenn es viele Projekte mit wenigen Dateien in jedem Projekt gibt, verwenden Sie das Tool MSBuild.
Wenn es wenige Projekte mit vielen Dateien in jedem Projekt gibt, verwenden Sie die /MP-Option.
Wenn die Anzahl von Projekten und Dateien pro Projekt ausgeglichen ist, verwenden Sie sowohl MSBuild als auch /MP.Legen Sie zunächst die /maxcpucount-Option auf die Anzahl der zu erstellenden Projekte fest, die /MP-Option auf die Anzahl der Prozessoren auf dem Computer.Messen Sie die Leistung, und passen Sie dann die Einstellungen an, um die besten Ergebnisse zu erzielen.Wiederholen Sie diesen Zyklus, bis Sie mit der Buildgesamtzeit zufrieden sind.
Die Compileroption /Gm
Standardmäßig aktiviert ein Projektbuild die Compileroption /Gm (inkrementelle Builds) für Debugbuilds und deaktiviert sie für Releasebuilds.Daher ist die Compileroption /MP in Debugbuilds automatisch deaktiviert, weil sie zu einem Konflikt mit der Standardcompileroption /Gm führt.