/GENPROFILE, /FASTGENPROFILE (Hasilkan Pembuatan Profil berinstrumentasi)

  • Artikel

Menentukan pembuatan .pgd file oleh linker untuk mendukung pengoptimalan yang dipandu profil (PGO). /GENPROFILE dan /FASTGENPROFILE gunakan parameter default yang berbeda. Gunakan /GENPROFILE untuk mendukung presisi atas kecepatan dan penggunaan memori selama pembuatan profil. Gunakan /FASTGENPROFILE untuk mendukung penggunaan memori dan kecepatan yang lebih kecil daripada presisi.

Sintaks

/GENPROFILE[:profile-argument[,profile-argument ...]]
/FASTGENPROFILE[:profile-argument[,profile-argument ...]] \

profile-argument
 { COUNTER32 | COUNTER64 }
 { EXACT | NOEXACT }
 MEMMAX=value
 MEMMIN=value
 { PATH | NOPATH }
 { TRACKEH | NOTRACKEH }
 PGD=filename

Argumen

profile-argument Salah satu argumen dapat ditentukan ke /GENPROFILE atau /FASTGENPROFILE. Argumen yang tercantum di sini dipisahkan oleh karakter pipa (|) saling eksklusif. Gunakan karakter koma (,) untuk memisahkan argumen. Jangan letakkan spasi di antara argumen, koma, atau setelah titik dua (:).

COUNTER32 | COUNTER64
Gunakan COUNTER32 untuk menentukan penggunaan penghitung pemeriksaan 32-bit, dan COUNTER64 untuk menentukan penghitung pemeriksaan 64-bit. Saat Anda menentukan /GENPROFILE, defaultnya adalah COUNTER64. Saat Anda menentukan /FASTGENPROFILE, defaultnya adalah COUNTER32.

EXACT | NOEXACT
Gunakan EXACT untuk menentukan kenaikan yang saling mengunci utas untuk pemeriksaan. NOEXACT menentukan operasi peningkatan yang tidak terlindungi untuk pemeriksaan. Default adalah NOEXACT.

MEMMAX=nilai, MEMMIN=nilai
Gunakan MEMMAX dan MEMMIN untuk menentukan ukuran reservasi maksimum dan minimum untuk data pelatihan dalam memori. Nilainya adalah jumlah memori yang akan dicadangkan dalam byte. Secara default, nilai-nilai ini ditentukan oleh heuristik internal.

PATH | NOPATH
Gunakan PATH untuk menentukan sekumpulan penghitung PGO terpisah untuk setiap jalur unik ke fungsi. Gunakan NOPATH untuk menentukan hanya satu set penghitung untuk setiap fungsi. Saat Anda menentukan /GENPROFILE, defaultnya adalah PATH . Saat Anda menentukan /FASTGENPROFILE, defaultnya adalah NOPATH .

TRACKEH | NOTRACKEH
Menentukan apakah akan menggunakan penghitung tambahan untuk menyimpan jumlah yang akurat ketika pengecualian dilemparkan selama pelatihan. Gunakan TRACKEH untuk menentukan penghitung tambahan untuk jumlah yang tepat. Gunakan NOTRACKEH untuk menentukan penghitung tunggal untuk kode yang tidak menggunakan penanganan pengecualian atau yang tidak mengalami pengecualian dalam skenario pelatihan Anda. Saat Anda menentukan /GENPROFILE, defaultnya adalah TRACKEH . Saat Anda menentukan /FASTGENPROFILE, defaultnya adalah NOTRACKEH .

PGD=filename
Menentukan nama file dasar untuk file tersebut .pgd . Secara default, linker menggunakan nama file gambar dasar yang dapat dieksekusi dengan .pgd ekstensi.

Keterangan

Opsi /GENPROFILE dan /FASTGENPROFILE memberi tahu linker untuk menghasilkan file instrumentasi pembuatan profil yang diperlukan untuk mendukung pelatihan aplikasi untuk pengoptimalan yang dipandu profil (PGO). Opsi ini baru di Visual Studio 2015. Lebih suka opsi ini ke opsi , , dan yang tidak digunakan /LTCG:PGINSTRUMENTlagi, dan ke PogoSafeModevariabel lingkungan , VCPROFILE_ALLOC_SCALE, dan VCPROFILE_PATH ./POGOSAFEMODE/PGD Informasi pembuatan profil yang dihasilkan oleh pelatihan aplikasi digunakan sebagai input untuk pengoptimalan seluruh program yang ditargetkan selama build. Anda juga dapat mengatur opsi lain untuk mengontrol berbagai fitur pembuatan profil untuk performa selama pelatihan dan build aplikasi. Opsi default yang ditentukan dengan /GENPROFILE memberikan hasil yang paling akurat, terutama untuk aplikasi multi-utas yang besar dan kompleks. Opsi ini /FASTGENPROFILE menggunakan default yang berbeda untuk jejak memori yang lebih rendah dan performa yang lebih cepat selama pelatihan, dengan mengorbankan akurasi.

Informasi pembuatan profil diambil saat Anda menjalankan aplikasi berinstrumen setelah Anda membuat dengan menggunakan /GENPROFILE/FASTGENPROFILE. Informasi ini diambil saat Anda menentukan /USEPROFILE opsi linker untuk melakukan langkah pembuatan profil lalu digunakan untuk memandu langkah build yang dioptimalkan. Untuk informasi selengkapnya tentang cara melatih aplikasi Anda dan detail tentang data yang dikumpulkan, lihat Pengoptimalan yang dipandu profil.

Selalu tentukan /LTCG kapan Anda menentukan /GENPROFILE atau /FASTGENPROFILE.

Untuk mengatur opsi linker ini di lingkungan pengembangan Visual Studio

  1. Buka kotak dialog Halaman Properti proyek. Untuk detailnya, lihat Mengatur pengkompilasi C++ dan membuat properti di Visual Studio.

  2. Pilih halaman properti Properti Konfigurasi>Penaut>Baris Perintah.

  3. /GENPROFILE Masukkan opsi atau /FASTGENPROFILE dan argumen ke dalam kotak Opsi Tambahan. Pilih OK untuk menyimpan perubahan Anda.

Untuk menyetel opsi linker ini secara terprogram

Baca juga

Referensi linker MSVC
Opsi linker MSVC
/LTCG (Pembuatan kode waktu tautan)