Condividi tramite

Downloader di simboli (dotnet-symbol)

  • Articolo

Questo articolo si applica a: ✔️ .NET Core 2.1 SDK e versioni successive

Installare

Per installare la versione più recente del dotnet-symbolpacchetto NuGet, usare il comando dotnet tool install:

dotnet tool install --global dotnet-symbol

Riepilogo

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

Descrizione

Lo strumento globale dotnet-symbol scarica i file (simboli, applicazione livello dati, moduli e così via) necessari per il debug di dump di base e minidump. Ciò può essere utile quando si esegue il debug dei dump acquisiti in un altro computer. dotnet-symbol può scaricare moduli e simboli necessari per analizzare il dump.

Opzioni

  • --microsoft-symbol-server

    Aggiungi il percorso server dei simboli http://msdl.microsoft.com/download/symbols (impostazione predefinita).

  • --server-path <symbol server path>

    Aggiungi un server di simboli al percorso del server.

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

    Aggiungi un server di simboli autenticato al percorso server usando un token di accesso personale.

  • --cache-directory <file cache directory>

    Aggiungi una directory della cache.

  • --recurse-subdirectories

    Elabora i file di input in tutte le sottodirectory.

  • --host-only

    Scarica solo il programma host (ovvero dotnet) necessario per caricare i dump core.

  • --symbols

    Scarica i file di simboli (.pdb, .dbg, .dwarf).

  • --modules

    Scarica i file del modulo (.dll, .so, .dylib).

  • --debugging

    Scarica i moduli di debug speciali (DAC, DBI, SOS).

  • --windows-pdbs

    Forza il download dei PDB di Windows quando sono disponibili anche PDB portabili.

  • -o, --output <output directory>

    Imposta la directory di output. In caso contrario, scrivi accanto al file di input (impostazione predefinita).

  • -d, --diagnostics

    Abilita l'output di diagnostica.

  • -h|--help

    Mostra la Guida della riga di comando.

Scaricare i simboli

L'esecuzione di dotnet-symbol su un file di dump consente, per impostazione predefinita, di scaricare tutti i moduli, i simboli e i file DAC/DBI necessari per eseguire il debug del dump, inclusi gli assembly gestiti. Poiché SOS ora può scaricare i simboli quando necessario, la maggior parte dei dump core Linux può essere analizzata usando lldb con solo l'host (dotnet) e i moduli di debug. Per ottenere questi file necessari per la diagnosi di un dump core con lldb esegui:

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

Risoluzione dei problemi

  • 404 Non trovato durante il download dei simboli.

    Il download dei simboli è supportato solo per le versioni di runtime ufficiali di .NET Core acquisite tramite canali ufficiali come il sito Web ufficiale e le origini predefinite negli script di installazione dotnet . Un errore 404 durante il download dei file di debug può indicare che il dump è stato creato con un runtime .NET Core da un'altra origine, ad esempio una creata dall'origine in locale o per una distribuzione Linux specifica, oppure da siti della community come archlinux. In questi casi, il file necessario per il debug (dotnet, libcoreclr.so e libmscordaccore.so) deve essere copiato da tali origini o dall'ambiente in cui è stato creato il file di dump.

Vedi anche