SPDConvert

Gebruik SPDConvert dit voor het voorbereiden en beheren van voorbeeldprofielgegevens voor SpGO (Sample Profile-Guided Optimization).

Dit hulpprogramma correleert de onbewerkte hardwarevoorbeelden in SPT-bestanden met de codestructuur in de SPD. Deze stap voert voorbeeldcorrelatie, stroomvereffening en beslissingen over grootte/snelheid uit en produceert een verrijkt SPD-bestand met uitvoeringsaantallen geannoteerd in de stroomgrafiek.

U kunt gegevens uit meerdere bronnen, zoals testbenchmarks, interne bewaking en productietelemetrie, combineren in één conversie. Als u het belang van een bepaald scenario wilt benadrukken, kunt u het SPT-bestand meerdere keren opgeven. Het drie keer vermelden van een kritieke benchmark SPT verdrievoudigt in feite de weging ervan.

Dit hulpprogramma werkt in drie modi:

• importeren . SPT-gegevens in een . SPD-bestand voor /SPGO-builds
• een ingesloten .SPD-bestand extraheren uit een .PDB
• samenvoegen van meerdere .SPD-bestanden uit afzonderlijke profileringssessies

SPDConvert werkt met drie bestandstypen:

• ETL (logboek voor gebeurtenistracering) Onbewerkte hardwareprestatiegebeurtenissen vastgelegd door xperf
• Met SPT (Sample Profile Trace) verpakte voorbeeldgebeurtenissen geproduceerd door SPTAggregate ETL-bestanden
• SPD (Sample Profile Database) Verwerkte profielgegevens die door de compiler worden gebruikt tijdens een geoptimaliseerde build. U kunt ook SPD-bestanden insluiten in PDB-symboolbestanden tijdens een /spdembed build

Syntax

SPT-gegevens importeren in een bestaand SPD-bestand:

SPDConvert [opties] spdfilesptfile(s)

Pak een ingesloten SPD-bestand uit een PDB:

SPDConvert /extractpdbfilespdfile

Meerdere SPD-bestanden samenvoegen in één:

SPDConvert /mergeoutputspdfilespdfile(s)

Parameters

IMPORTMODUS

Opties
Geef de volgende opties op in de importmodus:

• /Modus:<IP|LBR> Selecteer de profielmodus. Gebruik IP voor instructiepointerprofielgegevens (standaard) of LBR voor profielgegevens van laatste vertakkingsrecord.
• /Opnieuw instellen: Stel het aantal opnieuw in op 0. Met deze actie worden SPT's genegeerd. Gebruik deze optie om een SPD-bestand opnieuw in te stellen voordat u nieuwe gegevens importeert of om een leeg SPD-bestand te maken als het opgegeven bestand niet bestaat.
• /sptlist:<Bestand> Geef SPT-bestandsnamen op in een tekstbestand, met één bestandsnaam per regel.
• /Samenvatting Een samenvatting van het SPD-bestand afdrukken.
• /Help Help-informatie weergeven.

spdfile
Het SPD-bestand waarin voorbeeldgegevens worden geïmporteerd.

sptfiles
Een of meer SPT-bestanden die u wilt importeren. SPT-bestanden worden geproduceerd door SPTAggregate.

EXTRACT-MODUS (/extract)

pdbfile
Het PDB-bestand dat een ingesloten SPD bevat.

spdfile
Het SPD-uitvoerbestand dat moet worden gemaakt.

SAMENVOEGMODUS (/samenvoegen)

outputspdfile
Het SPD-uitvoerbestand dat moet worden gemaakt.

/retire:<N> Stel de retire-snelheid van de profielgegevens in op N/16, waarbij 0 ≤ N ≤ 16. De standaardwaarde is 8. Deze waarde bepaalt hoeveel van de bestaande gegevens in een SPD moeten worden verwijderd bij het toevoegen van nieuwe SPT-gegevens. Verwijdert bijvoorbeeld /retire:8 8/16 (helft) van de bestaande gegevens voordat u nieuwe SPT-gegevens toevoegt. Met deze instelling worden nieuwere profielgegevens zwaarder gewogen omdat de helft van de oudere gegevens wordt verwijderd. De twee meest voorkomende toepassingen zijn /retire:0, die evenveel gewicht geven aan alle profielruns, of /retire:16, waardoor alleen de nieuwste gegevens meetellen, omdat alle oudere gegevens worden verwijderd. Gebruik /retire:N om te bepalen hoe agressief SPDConvert oudere profielgegevens minder nadruk geeft. Met dit concept 'overdracht' kunt u een profiel vernieuwen met behulp van bestaande SPD-gegevens zonder opnieuw te beginnen met nieuwe profileringsgegevens, wat tijdrovend is. Dit concept wordt meer besproken in de SPGO-zelfstudie : SPD-informatie hergebruiken in builds.

spdfiles
Een of meer SPD-bestanden die moeten worden samengevoegd.

Opmerkingen

SPDConvert is het belangrijkste conversieprogramma in de SPGO-werkstroom. Nadat u met xperf een trace hebt verzameld en deze met SPTAggregate naar een SPT-bestand hebt geconverteerd, gebruikt u SPDConvert om de voorbeeldgegevens in een SPD-bestand te importeren. Geef het resulterende SPD-bestand door aan de compiler met behulp van de /SPGO vlag om een geoptimaliseerd binair bestand te maken.

Gebruik /extract om een SPD-bestand te herstellen dat tijdens een /SPGO buildproces in een PDB is ingesloten. Gebruik /merge dit om SPD-bestanden uit meerdere profileringssessies te combineren voordat u het opnieuw opbouwt.

De GUID en de leeftijd van een binair bestand moeten overeenkomen tussen de SPT- en SPD-bestanden. Als deze niet overeenkomen, meldt SPDConvert de fout 'SPD-versie incompatibel'. Gebruik SPTDump /progid dit om de binaire id's in het SPT-bestand te controleren en SPDDump /header om het SPD-bestand te controleren.

De GUID en de leeftijd van het binaire bestand dat in het SPD-bestand is vastgelegd, moeten overeenkomen met het SPT-bestand. Als u deze fout wilt diagnosticeren, gebruikt SPTDump /progid u om de binaire id's in het SPT-bestand te inspecteren en SPDDump /header om het SPD-bestand te inspecteren. Er wordt een geldig SPD-bestand gebruikt voor zover mogelijk. Kleine updates van de code die de controlestroom van het programma niet wijzigt, worden getolereerd. Ongewijzigde functies gebruiken ook de gegevens voor optimalisatie. Als u een geldige, maar verder niet-gerelateerde SPD opgeeft, werkt het proces wel, maar zijn de gegevens waarschijnlijk niet bruikbaar voor optimalisatiedoeleinden.

Example

In dit voorbeeld worden LBR-profielgegevens uit een SPT-bestand geïmporteerd in een SPD-bestand:

SPDConvert /mode:LBR sample.spd sample.spt

In dit voorbeeld worden IP-profielgegevens geïmporteerd met behulp van een lijst met SPT-bestanden:

SPDConvert /mode:IP /sptlist:mysptfiles.txt sample.spd

In dit voorbeeld wordt een samenvatting van de profielgegevens in een SPD-bestand afgedrukt:

SPDConvert /summary sample.spd

In dit voorbeeld wordt de ingesloten SPD uit een PDB-bestand geëxtraheerd:

SPDConvert /extract sample.pdb sample_extracted.spd

In dit voorbeeld worden twee SPD-bestanden uit verschillende profileringsuitvoeringen samengevoegd:

SPDConvert /merge combined.spd run1.spd run2.spd

Zie ook

Zelfstudie: Voorbeeld Profile-Guided Optimization (SPGO) gebruiken om de prestaties te verbeteren
SPDDump
SPTAggregate
SPTDump