SPDConvert

Örnek Profil Rehberli Optimizasyon (SPGO) için örnek profil verilerini hazırlamak ve yönetmek üzere SPDConvert kullanın.

Bu araç, SPT dosyalarındaki ham donanım örneklerini SPD'deki kod yapısıyla ilişkilendirmektedir. Bu adım örnek bağıntı, akış düzeltme ve boyut/hız kararları gerçekleştirir ve akış grafiğinde açıklamalı yürütme sayılarıyla zenginleştirilmiş bir SPD dosyası oluşturur.

Laboratuvar karşılaştırmaları, iç izleme ve üretim telemetrisi gibi birden çok kaynaktaki verileri tek bir dönüştürmede birleştirebilirsiniz. Belirli bir senaryonun önemini vurgumak için SPT dosyasını birden çok kez belirtebilirsiniz. Kritik bir SPT kıyaslamasını üç kez listelemek, ağırlığını fiilen üç katına çıkarır.

Bu araç üç modda çalışır:

• İçe aktarın .SPT verilerini /SPGO derlemeleri için bir .SPD dosyasına
• bir .PDB dosyasından gömülü bir .SPD dosyası çıkarın
• Birleştirin ayrı profilleme çalıştırmalarından birden çok .SPD dosyasını

SPDConvert üç dosya türüyle çalışır:

• ETL (Olay İzleme Günlüğü) Tarafından kaydedilen ham donanım performansı olayları xperf
• SPT (Örnek Profil İzi) SPTAggregate tarafından ETL dosyalarından üretilen paketlenmiş örnek olaylar
• SPD (Örnek Profil Veritabanı) İyileştirilmiş bir derleme sırasında derleyici tarafından kullanılan işlenmiş profil verileri. SPD dosyalarını bir /spdembed derleme sırasında PDB sembol dosyalarına da katıştırabilirsiniz

Syntax

SPT verilerini mevcut bir SPD dosyasına aktar:

SPDConvert [seçenekler] spdfilesptfile(lar)

Eklenmiş SPD dosyasını PDB'den ayıklayın:

SPDConvert /extractpdbfilespdfile

Birden çok SPD dosyasını tek bir dosyada birleştirin:

SPDConvert /mergeoutputspdfilespdfile(s)

Parametreler

İÇERI AKTARMA MODU

Seçenekler
İçeri aktarma modunda aşağıdaki seçenekleri belirtin:

• /Modu:<IP|LBR> Profil modunu seçin. Komut işaretçisi profil verileri için IP (varsayılan) veya son dal kaydı profil verileri için LBR kullanın.
• /Sıfırlamak: Sayıyı 0 olarak sıfırlayın. Bu işlem SPT'leri göz ardı eder. Yeni verileri içeri aktarmadan önce bir SPD dosyasını sıfırlamak veya belirtilen dosya yoksa boş bir SPD dosyası oluşturmak için bu seçeneği kullanın.
• /sptlist:<Dosya> Bir metin dosyasında, satır başına bir dosya adıyla SPT dosya adlarını belirtin.
• /Özet SPD dosyasının özetini yazdırın.
• /Yardım Yardım bilgilerini görüntüleme.

spdfile
Örnek verilerin içeri aktarıldığı SPD dosyası.

sptfiles
İçeri aktarılacağınız bir veya daha fazla SPT dosyası. SPT dosyaları SPTAggregate tarafından üretilir.

AYIKLAMA MODU (/extract)

pdbfile
Katıştırılmış SPD içeren PDB dosyası.

spdfile
Oluşturulacak çıktı SPD dosyası.

BİRLEŞTİrME MODU (/birleştirme)

outputspdfile
Oluşturulacak SPD çıktı dosyası.

/retire:<N> Profil verilerinin kullanımdan kaldırma oranını N/16 olarak ayarlayın; burada 0 ≤ N ≤ 16. Varsayılan değer 8'dir. Bu değer, yeni SPT verileri eklerken SPD'deki mevcut verilerin ne kadarının silindiğini denetler. Örneğin, /retire:8 yeni SPT verileri eklemeden önce mevcut verilerin 16/8'ini (yarısı) siler. Bu ayar, eski verilerin yarısını göz ardı ettiği için daha yeni profil verilerine daha fazla ağırlık verir. En yaygın iki kullanım, /retire:0 tüm profil çalıştırmalarına eşit ağırlık veren veya /retire:16 tüm eski verileri sildiği için yalnızca en yeni veri sayısını veren kullanımlardır. /retire:N öğesinin eski profil verilerini ne kadar güçlü bir şekilde daha az öne çıkaracağını kontrol etmek için SPDConvert kullanın. Bu "carry forward" kavramı, yeni profilleme verileriyle yeniden başlamak zorunda kalmadan mevcut SPD verilerini kullanarak bir profili yenilemenizi sağlar; bu işlem zaman alıcıdır. Bu kavram , SPGO öğreticisi - SPD bilgilerini derlemeler arasında yeniden kullanmak bölümünde daha ayrıntılı olarak ele alınıyor.

spdfiles
Birleştirilecek bir veya daha fazla SPD dosyası.

Remarks

Note

Bu aracı bir Visual Studio geliştirici komut isteminden çalıştırın.

SPDConvert SPGO iş akışındaki ana dönüştürme aracıdır. xperf kullanarak bir iz topladıktan ve bunu SPTAggregate kullanarak bir SPT dosyasına dönüştürdükten sonra, örnek verileri bir SPD dosyasına aktarmak için SPDConvert kullanın. Optimize edilmiş bir ikili dosya oluşturmak için elde edilen SPD dosyasını /SPGO bayrağını kullanarak derleyiciye iletin.

Bir /SPGO derlemesi sırasında PDB’ye eklenen bir SPD dosyasını kurtarmak için /extract kullanın. Yeniden oluşturmadan önce birden çok profil oluşturma oturumundaki SPD dosyalarını birleştirmek için kullanın /merge .

İkili dosyanın GUID’si ve yaşı, SPT ve SPD dosyaları arasında aynı olmalıdır. Eşleşmiyorsa, SPDConvert "SPD sürümü uyumsuz" hatasını bildirir. SPT dosyasındaki ikili tanımlayıcıları denetlemek için SPTDump /progid ve SPD dosyasını denetlemek için SPDDump /header kullanın.

SPD dosyasına kaydedilen ikili dosyanın GUID'i ve yaşı SPT dosyasıyla eşleşmelidir. Bu hatayı tanılamak için SPT dosyasındaki ikili tanımlayıcıları incelemek ve SPTDump /progid SPD dosyasını incelemek için kullanınSPDDump /header. Mümkün olduğunca geçerli bir SPD dosyası kullanılır. Programın denetim akışını değiştirmeyen kodda küçük güncelleştirmeler kabul edilir. Değişmemiş işlevler de iyileştirme için verileri kullanır. Geçerli ancak ilgisiz bir SPD sağlarsanız işlem çalışır, ancak iyileştirme için büyük olasılıkla hiçbir veri kullanılamaz.

Example

Bu örnek, LBR profil verilerini bir SPT dosyasından SPD dosyasına aktarır:

SPDConvert /mode:LBR sample.spd sample.spt

Bu örnek, SPT dosyalarının listesini kullanarak IP profili verilerini içeri aktarır:

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

Bu örnek, bir SPD dosyasındaki profil verilerinin özetini yazdırır:

SPDConvert /summary sample.spd

Bu örnek, eklenmiş SPD'yi bir PDB dosyasından ayıklar:

SPDConvert /extract sample.pdb sample_extracted.spd

Bu örnek, farklı profil oluşturma çalıştırmalarından iki SPD dosyasını birleştirir:

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

Ayrıca bakınız

Öğretici: Performansı iyileştirmek için Örnek Profil Kılavuzlu Optimizasyonunu (SPGO) kullanma
SPDDump
SPTAggregate
SPTDump