Bagikan melalui

Pengunduh simbol (simbol-dotnet)

  • Artikel

Artikel ini berlaku untuk: ✔️ .NET Core 2.1 SDK dan versi yang lebih baru

Instal

Untuk menginstal versi rilis terbaru paket dotnet-symbol NuGet, gunakan perintah penginstalan alat dotnet:

dotnet tool install --global dotnet-symbol

Sinopsis

dotnet-symbol [-h|--help] [options] <FILES>

Deskripsi

Alat dotnet-symbol global mengunduh file (simbol, DAC, modul, dll.) yang diperlukan untuk men-debug cadangan inti dan minidump. Ini dapat berguna saat men-debug cadangan yang diambil di komputer lain. dotnet-symbol dapat mengunduh modul dan simbol yang diperlukan untuk menganalisis cadangan.

Opsi

  • --microsoft-symbol-server

    Tambahkan http://msdl.microsoft.com/download/symbols jalur server simbol (default).

  • --server-path <symbol server path>

    Tambahkan server simbol ke jalur server.

  • authenticated-server-path <pat> <server path>

    Tambahkan server simbol terautentikasi ke jalur server menggunakan token akses pribadi (PAT).

  • --cache-directory <file cache directory>

    Menambahkan direktori cache.

  • --recurse-subdirectories

    Proses file input di semua subdirektori.

  • --host-only

    Unduh hanya program host (yaitu, dotnet) yang dibutuhkan lldb untuk memuat cadangan inti.

  • --symbols

    Unduh file simbol (.pdb, .dbg, .dwarf).

  • --modules

    Unduh file modul (.dll, .so, .dylib).

  • --debugging

    Unduh modul penelusuran kesalahan khusus (DAC, DBI, SOS).

  • --windows-pdbs

    Paksa pengunduhan PDB Windows saat PDB Portabel juga tersedia.

  • -o, --output <output directory>

    Atur direktori output. Jika tidak, tulis di samping file input (default).

  • -d, --diagnostics

    Aktifkan output diagnostik.

  • -h|--help

    Tampilkan bantuan baris perintah.

Mengunduh Simbol

Berjalan dotnet-symbol terhadap file cadangan akan, secara default, mengunduh semua modul, simbol, dan file DAC/DBI yang diperlukan untuk men-debug cadangan termasuk rakitan terkelola. Karena SOS sekarang dapat mengunduh simbol ketika diperlukan, sebagian besar cadangan inti Linux dapat dianalisis menggunakan lldb hanya dengan host (dotnet) dan modul debugging. Untuk mendapatkan file-file ini yang diperlukan untuk mendiagnosis cadangan inti dengan eksekusi lldb:

dotnet-symbol --host-only --debugging <dump file path>

Pecahkan masalah

  • 404 Tidak Ditemukan saat mengunduh simbol.

    Unduhan simbol hanya didukung untuk versi runtime .NET Core resmi yang diperoleh melalui saluran resmi seperti situs web resmi dan sumber default dalam skrip penginstalan dotnet. Kesalahan 404 saat mengunduh file penelusuran kesalahan dapat menunjukkan bahwa cadangan dibuat dengan runtime .NET Core dari sumber lain, seperti yang dibangun dari sumber secara lokal atau untuk distro Linux tertentu, atau dari situs komunitas seperti archlinux. Dalam kasus seperti itu, file yang diperlukan untuk penelusuran kesalahan (dotnet, libcoreclr.so, dan libmscordaccore.so) harus disalin dari sumber tersebut atau dari lingkungan tempat file cadangan dibuat.

Lihat juga