Share via

Symbooldownloader (dotnet-symbool)

  • Artikel

Dit artikel is van toepassing op: ✔️ .NET Core 2.1 SDK en latere versies

Installeren

Als u de nieuwste versie van het NuGet-pakket wilt installeren, gebruikt u de installatieopdracht van het dotnet-symbol dotnet-hulpprogramma:

dotnet tool install --global dotnet-symbol

Samenvatting

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

Beschrijving

Het dotnet-symbol algemene hulpprogramma downloadt bestanden (symbolen, DAC, modules, enzovoort) die nodig zijn voor het opsporen van fouten in kerndumps en minidumps. Dit kan handig zijn bij het opsporen van fouten in dumps die zijn vastgelegd op een andere computer. dotnet-symbol kan modules en symbolen downloaden die nodig zijn om de dump te analyseren.

Opties

  • --microsoft-symbol-server

    Symboolserverpad toevoegen http://msdl.microsoft.com/download/symbols (standaard).

  • --server-path <symbol server path>

    Voeg een symboolserver toe aan het serverpad.

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

    Voeg een geverifieerde symboolserver toe aan het serverpad met behulp van een persoonlijk toegangstoken (PAT).

  • --cache-directory <file cache directory>

    Voegt een cachemap toe.

  • --recurse-subdirectories

    Invoerbestanden verwerken in alle submappen.

  • --host-only

    Download alleen het hostprogramma (dat wil gezegd dotnet) dat lldb nodig heeft voor het laden van kerndumps.

  • --symbols

    Download symboolbestanden (.pdb, .dbg, .dwerg).

  • --modules

    Download de modulebestanden (.dll, .so, .dylib).

  • --debugging

    Download de speciale foutopsporingsmodules (DAC, DBI, SOS).

  • --windows-pdbs

    Dwing het downloaden van de Windows-PDF's af wanneer draagbare PDF's ook beschikbaar zijn.

  • -o, --output <output directory>

    Stel de uitvoermap in. Anders schrijft u naast het invoerbestand (standaard).

  • -d, --diagnostics

    Schakel diagnostische uitvoer in.

  • -h|--help

    Toont opdrachtregelhulp.

Symbolen downloaden

Als dotnet-symbol u een dumpbestand uitvoert, worden standaard alle modules, symbolen en DAC/DBI-bestanden gedownload die nodig zijn om fouten op te sporen in de dump, inclusief de beheerde assembly's. Omdat SOS nu symbolen kan downloaden wanneer dat nodig is, kunnen de meeste Linux-kerndumps worden geanalyseerd met behulp van lldb met alleen de host (dotnet) en foutopsporingsmodules. Ga als volgt te werk om deze bestanden op te halen die nodig zijn voor het diagnosticeren van een kerndump met lldb:

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

Problemen oplossen

  • 404 Niet gevonden tijdens het downloaden van symbolen.

    Het downloaden van symbolen wordt alleen ondersteund voor officiële .NET Core runtime-versies die zijn verkregen via officiële kanalen, zoals de officiële website en de standaardbronnen in de dotnet-installatiescripts. Een 404-fout tijdens het downloaden van foutopsporingsbestanden kan erop wijzen dat de dump is gemaakt met een .NET Core-runtime van een andere bron, zoals een die lokaal is gebouwd op basis van de bron of voor een bepaalde Linux-distributie, of van communitysites zoals archlinux. In dergelijke gevallen moet het bestand dat nodig is voor foutopsporing (dotnet, libcoreclr.so en libmscordaccore.so) worden gekopieerd uit deze bronnen of uit de omgeving waarin het dumpbestand is gemaakt.

Zie ook