1. Home
  2. Help
  3. Crashrapporten

Crashrapporten

If Matt Download Manager closes unexpectedly or stops responding, a crash report window opens. It shows what happened, lets you read the whole report, and can send it to the developers on GitHub. Each report helps fix the problem for everyone.

Het crashrapportvenster nadat MDM niet meer reageerde

Wat u ziet

  • Matt Download Manager closed unexpectedly: MDM crashed, or hit an internal error and closed.
  • Matt Download Manager stopped responding: its window didn't answer for 8 seconds. MDM is still running, frozen. End and restart MDM closes the frozen copy and starts a new one. If MDM answers again by itself, the window says so.

In het venster:

  1. Wat deed u toen het gebeurde? is optioneel. Een paar woorden, zoals "Ik opende URL toevoegen", helpen enorm.
  2. Het rapport toont alles wat zou worden verzonden. Lees het eerst als u wilt.
  3. Verzenden op GitHub opent het Crashrapport-formulier van GitHub in uw browser, al ingevuld, samen met de map die het rapport bevat. Sleep het rapportbestand naar het formulier, controleer het en dien het in. U hebt een GitHub-account nodig. Er wordt niets vanzelf verzonden.
  4. Als iemand hetzelfde probleem al heeft gemeld, meldt het venster dat (Al gemeld als kwestie #…). De gemelde kwestie openen opent deze en plaatst uw rapport op het klembord, zodat u het als opmerking kunt toevoegen.

De andere knoppen kopiëren het rapport, openen de map ervan of starten MDM opnieuw.

Wat een rapport bevat

  • Wat er is gebeurd: de fout en de plaats in de code van MDM waar het gebeurde.
  • De stack: de plaats in de code van MDM waar het crashte of bevroor, en wat elk ander onderdeel ervan aan het doen was.
  • MDM's recente logboek: bijvoorbeeld "commando URL toevoegen" of "venster geopend: add-url".
  • Het systeem: de versie van MDM en hoe u het hebt geïnstalleerd, uw besturingssysteem en de versie ervan, de processor, de taal en het thema, en hoeveel downloads en wachtrijen u hebt. Dit zijn alleen tellingen.

Het bevat niet:

  • uw downloadadressen of bestandsnamen;
  • uw gebruikersnaam, die wordt weergegeven als ~ in mappaden.

Als een foutmelding iets citeert dat u hebt getypt, staat die tekst in het rapport, dus lees het voordat u het verzendt.

Het crashgegevensbestand (.dmp) is een momentopname van wat MDM op dat moment uitvoerde. Het helpt de ontwikkelaars het meest, maar het kan stukjes bevatten van wat MDM in het geheugen had, zoals downloadadressen, cookies en opgeslagen wachtwoorden. Het wordt alleen bijgevoegd als u Ook de crashgegevens bijvoegen aanvinkt.

Waar rapporten worden bewaard

In de gegevensmap van MDM:

  • crashes\: elk rapport (.txt) en de crashgegevens ervan (.dmp);
  • logs\: het logboek van MDM (mdm.log, met oudere als mdm.1.log enzovoort, 2 MB elk).

De gegevensmap van MDM is %APPDATA%\mattdownloadmanager op Windows, ~/Library/Application Support/mattdownloadmanager op macOS en ~/.local/share/mattdownloadmanager op Linux. In de draagbare modus is het de data map naast het programma.

Het logboek registreert wat MDM doet, zodat een rapport kan laten zien wat tot een probleem heeft geleid. Om meer details te loggen, start u MDM met de omgevingsvariabele MDM_LOG=debug.

Voor ontwikkelaars

Hoe het werkt: een tweede kopie van MDM, de monitor, start ernaast met --crash-monitor. De crashcode bevindt zich in crates/crash en crates/app/src/crash.rs.

  • Problemen opsporen. Wanneer MDM crasht (een Windows-uitzondering, een signaal op Linux, een Mach-uitzondering op macOS), panikeert of vastloopt, vraagt het de monitor om een dump. Een vastloper is een vensterframe dat langer dan 8 seconden draait, waargenomen door een watchdog-thread die de tijd die in slaapstand is doorgebracht en de eerste minuut nadat de computer wakker wordt negeert, terwijl de schijf, het netwerk en het scherm weer actief worden: een blokkering wordt dan naar het logboek geschreven en alleen gerapporteerd als deze langer dan die minuut duurt. Het meet beide delen van een frame: wat MDM afhandelt (de binnenkomende commando's, de klok van downloads, wachtrijen en de Planner), wat ook geminimaliseerd draait, en het tekenen; nooit de wachttijd tussen frames. De watchdog meet ook hoeveel processortijd de vensterthread ondertussen heeft gekregen, en het rapport zegt wat dat betekent: het draaide de hele tijd (een lus), het wachtte in een vergrendeling of op I/O (een deadlock), of het draaide nauwelijks in gewone code, wat betekent dat een computer te druk is om MDM uit te voeren of te traag om het van schijf te laden, waarschijnlijk geen bug van MDM (deze delen één handtekening, freeze while the computer was busy). Elk rapport vermeldt ook wat het frame deed toen het stopte (het pictogram in het systeemvak, de voortgang van de downloads, het tekenen van het hoofdvenster). Wanneer de vensterthread al terug is in de gebeurtenissenlus, of in de pauze na een frame van een verborgen venster, tegen de tijd dat de dump wordt geschreven, was de vastloper voor de momentopname voorbij, dus de stack kan het niet verklaren; die rapporten zeggen dat en delen de handtekening freeze over before the snapshot. macOS meet dit nog niet. De monitor schrijft vervolgens een minidump van elke thread van buitenaf, via minidumper en crash-handler. Een gecrasht proces schrijft nooit zijn eigen dump, wat ook de manier is waarop Firefox, Crashpad en Sentry het doen.
  • De dump lezen. De monitor leest de dump met Mozilla's rust-minidump. Het gebruikt de Breakpad-symbolen van de release wanneer deze worden gevonden. Een build vanuit de bron kan ook de native debug-info ernaast lezen (zijn .pdb, DWARF) wanneer gebouwd met --features mdm-crash/native-symbols; de geleverde app wordt zonder die lezer, van enkele MB's, geleverd. De Handtekening van het rapport (bijvoorbeeld freeze in mattdownloadmanager::winui::combo_edit) blijft hetzelfde voor rapporten van één probleem, en het venster zoekt er bestaande problemen mee.
  • Symbols. Release builds keep line tables (debug = "line-tables-only"), but no download includes the debug info. CI turns it into MisterDownloadManager-<version>-symbols-<platform>.zip (one per download that has programs of its own: windows-x64, windows-arm64, windows-x86, linux-x86_64, linux-arm64, macos-arm64, macos-x86_64) (tools/installer/symbols.py, using Mozilla's dump_syms), published beside the release's other files. The report window fetches the zip for its own version when a stack shows bare addresses.
  • Een .dmp van een probleem:

cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp MisterDownloadManager-<version>-symbols-windows-x64.zip

  • Testen. cargo test -p mdm-crash voert een echte vastloper, paniek en crash (examples/crashy.rs) uit en controleert de handtekening van elk rapport. Om het in de app te proberen, start u MDM met MDM_CRASH_TEST=1 en voert u vervolgens mattdownloadmanager /show crash-test:freeze uit (een deadlock; of spin, 12 seconden van een drukke vensterthread, panic, crash, abort). cargo test -p mdm-app --test freeze_report -- --ignored doet dat in een kopie van de app buiten beeld, met het venster zichtbaar en geminimaliseerd.

Gratis, open source, geen advertenties, geen proefversie.

Matt Download Manager downloaden