Dela via

Symbolnedladdare (dotnet-symbol)

  • Artikel

Den här artikeln gäller för: ✔️ .NET Core 2.1 SDK och senare versioner

Installera

Om du vill installera den senaste versionen av dotnet-symbol NuGet-paketet använder du installationskommandot för dotnet-verktyget:

dotnet tool install --global dotnet-symbol

Sammanfattning

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

beskrivning

Det dotnet-symbol globala verktyget laddar ned filer (symboler, DAC, moduler osv.) som behövs för felsökning av kärndumpar och minidumpar. Detta kan vara användbart när du felsöker dumpar som samlats in på en annan dator. dotnet-symbol kan ladda ned moduler och symboler som behövs för att analysera dumpen.

Alternativ

  • --microsoft-symbol-server

    Lägg till http://msdl.microsoft.com/download/symbols symbolserversökväg (standard).

  • --server-path <symbol server path>

    Lägg till en symbolserver i serversökvägen.

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

    Lägg till en autentiserad symbolserver till serversökvägen med hjälp av en personlig åtkomsttoken (PAT).

  • --cache-directory <file cache directory>

    Lägger till en cachekatalog.

  • --recurse-subdirectories

    Bearbeta indatafiler i alla underkataloger.

  • --host-only

    Ladda bara ned det värdprogram (dvs. dotnet) som lldb behöver för att läsa in kärndumpar.

  • --symbols

    Ladda ned symbolfiler (.pdb, .dbg, .dwarf).

  • --modules

    Ladda ned modulfilerna (.dll, .so, .dylib).

  • --debugging

    Ladda ned de särskilda felsökningsmodulerna (DAC, DBI, SOS).

  • --windows-pdbs

    Framtvinga nedladdning av Windows-PDF-filerna när bärbara PDF-filer också är tillgängliga.

  • -o, --output <output directory>

    Ange utdatakatalogen. Annars skriver du bredvid indatafilen (standard).

  • -d, --diagnostics

    Aktivera diagnostiska utdata.

  • -h|--help

    Visar kommandoradshjälp.

Ladda ned symboler

Om du kör dotnet-symbol mot en dumpfil hämtas som standard alla moduler, symboler och DAC/DBI-filer som behövs för att felsöka dumpen, inklusive de hanterade sammansättningarna. Eftersom SOS nu kan ladda ned symboler när det behövs kan de flesta Linux-kärndumpar analyseras med hjälp av lldb med endast värden (dotnet) och felsökningsmoduler. Så här hämtar du de här filerna som krävs för att diagnostisera en kärndumpning med lldb-körning:

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

Felsöka

  • 404 Hittades inte vid nedladdning av symboler.

    Symbolnedladdning stöds endast för officiella .NET Core-körningsversioner som hämtas via officiella kanaler, till exempel den officiella webbplatsen och standardkällorna i dotnet-installationsskripten. Ett 404-fel vid nedladdning av felsökningsfiler kan tyda på att dumpen skapades med en .NET Core-körning från en annan källa, till exempel en som skapats från källan lokalt eller för en viss Linux-distribution eller från community-webbplatser som archlinux. I sådana fall bör den fil som krävs för felsökning (dotnet, libcoreclr.so och libmscordaccore.so) kopieras från dessa källor eller från miljön som dumpfilen skapades i.

Se även