Kuinka saadaan pinovedos vikailmoitusta varten

Jos lähetät Bugzillalla vikailmoituksen kaatumisesta, siihen tulisi myös liittää pinovedos (stacktrace, call stack). Pinovedos kertoo Mozillan kehittäjille, mikä kaatui ja tarjoaa lähtökohdan kaatumisen syyn selvittämiseksi. Tässä artikkelissa kuvataan, kuinka Mozillan kaatumisenilmoitusohjelmalla (Crash Reporter, Breakpad) hankitaan kaatumistunnus (Crash ID), jonka avulla kehittäjämme voivat hankkia pinovedoksen. Tässä artikkelissa kerrotaan myös vaihtoehtoisia tapoja pinovedoksen hankkimiseen, jos et pysty hankkimaan kaatumistunnusta.

Vaatimukset

Tarvitset binääripaketin Firefoxista Mozilla.org:sta. Myös SeaMonkey ja Thunderbird tukevat kaatumisilmoitusta.

Mozillan kaatumisilmoitusten palvelimella on nykyisellään virheenkorjaustietoja (debug information) ainoastaan Mozillan jakeluista ja siksi kaatumisilmoitus ei toimi, jos käytät esimerkiksi Linux-jakelun mukana tullutta versiota tai olet itse kääntänyt ohjelman lähdekoodista. Näissä tapauksissa on käytettävä yhtä alla luetelluista vaihtoehtoisista tavoista.

Huomaa: Kun täytät kaatumisilmoitusta, on tärkeää tietää, tapahtuuko kaatuminen myös Firefoxin vikasietotilassa. Tämä auttaa kehittäjiä päättelemään, aiheuttaako kaatumisen mahdollisesti jokin laajennus tai liitännäinen.

Kaatumistunnuksen hankkiminen Mozillan kaatumisilmoitusohjelmalla

1. Lähetä kaatumisen jälkeen ilmoitus järjestelmäämme.

Mozillan kaatumisilmoitusohjelman ikkunan pitäisi ilmestyä automaattisesti, kun Firefox kaatuu. Jos sinulla on mitään lisätietoja kaatumisesta, kuten mitä olit tekemässä kun kaatuminen tapahtui, kirjoita nämä lisätietokenttään. Varmista, että valintaruutu "Lähetä Mozillalle kaatumisilmoitus, jotta ongelma voidaan korjata" on valittu ja napsauta uudelleenkäynnistys-painiketta. Kaatumisenilmoitusohjelman pitäisi nyt lähettää kaatumisilmoitus ja Firefoxin tulisi käynnistyä uudelleen.

"Lisätietoja"-painikketta napsauttamalla saat lisää informaatiota kaatumisesta. Nämä tietot eivät kuitenkaan ole hyödyllisiä vikailmoituksessa.

2. Kerro meille lähettämäsi kaatumisilmoituksen kaatumistunnus (Crash ID).

Voit tarkastella kaikkia lähetettyjä ilmoituksia kirjoittamalla "about:crashes" Firefox osoitepalkkiin ja painamalla enter. Firefox avaa luettelon lähetetyistä kaatumisilmoituksista, jossa näkyy myös kaatumistunnus. Kopioi kaksi tai kolme kaatumisen ajankohtaan parhaiten sopivista kaatumistunnuksista ja liitä ne Bugzillan vikailmoitukseen. Tarkistathan, että ilmoituksen lähetysaika ajoittuu kaatumisen ajankohtaan, jottta et turhaan lähetä kaatumistunnuksia, joilla ei ole mitään tekemistä tämän kaatumisen kanssa.

Voit liittää kaatumistunnuksen alkuun "bp-", jolloin Bugzilla muodostaa tunnuksista linkit: bp-a70759c6-1295-4160-aa30-bc4772090918

Kaatumistunnuksen hankkiminen jos Firefox kaatuu jo käynnistyksessä

Jos Firefox kaatuu jo käynnistyessään voit silti tarkastella lähetettyjä kaatumisilmoituksia. Kaatumisilmoituksia pääsee tarkastelemaan kaikilla Firefoxin profiileilla, joten jos uusi profiili ei kaada Firefoxia, voit tarkastella sen avulla kaatumisilmoituksia "about:crashes" -sivulla yllä kuvatulla tavalla.

Kaatumistunnuksen löytäminen Firefoxin ollessa suljettu

Jos et voi käynnistää Firefoxia ollenkaan, löydät kaatumisilmoitukset käyttöjärjestelmästäsi riippuen jostain seuraavista sijainneista:

Windows : %APPDATA%\Mozilla\Firefox\Crash Reports\submitted\
OS X : ~/Library/Application Support/Firefox/Crash Reports/submitted/
Linux : ~/.mozilla/firefox/Crash Reports/submitted/

Kansion jokainen tiedosto sisältää yhden lähetetyn kaatumisilmoituksen kaatumistunnuksen. Voit tarkastella tiedoston luonti- tai muokkausaikaa päätelläksesi, mitkä kaatumisilmoitukset liittyvät vikailmoitukseesi.

Vaihtoehtoisia tapoja pinovedoksen hankkimiseen

Jos Mozillan kaatumisenilmoitusohjelma ei ilmesty tai ei ole käytetävissä, on pinovedos hankittava käsin:

Windows

Pinovedoksen hankkimiseen löydät ohjeet artikkelista Create a stacktrace with Windbg.

Prosessin täydellisen tilannevedoksen hankkiminen kuvataan artikkelissa How to get a process dump with Windows Task Manager [en-US]

OS X

Suorita /Applications/Utilities/Console.app. Laajenna "~/Library/Logs" ja "CrashReporter". Etsi sitten "firefox-bin" -lokeja.

Linux

Huomaa, että useimmissa distroissa pakkaus, jolle on löydettävä symbolit, on jotain sen tyyppistä kuin "xulrunner", ei "firefox".

Kaatumisilmoitustiedostot koneellasi

Kun kaatumisilmoitusohjelma (Breakpad) havaitsee kaatumisen, se ensin kirjoittaa kaatumisilmoitustiedostot (esim. .dump ja .extra -tiedostot) 'Crash Reports' -kansion alikansioon 'pending'.

Jos Breakpad onnistuu lähettämään kaatumisilmoituksen palvelimelle, oletusarvoisesti 'pending' kansiossa olevat kaatumiseen liittyvät tiedostot poistetaan ja 'submitted' kansioon lisätään tekstitiedosto (.txt), joka sisältää kaatumistunnuksen, jolla palvelin tallensi kaatumisilmoituksen. Jos haluat, että Breakpad jättää .dump ja .extra -tiedostot koneellesi, jotta voit tarkastella niitä paikallisesti, aseta ympäristömuuttuja MOZ_CRASHREPORTER_NO_DELETE_DUMP arvoon 1.

Ubuntu: Instructions from the Ubuntu Team
openSUSE: General instructions from openSUSE
Fedora: Capturing Stack Traces
Gentoo: Debugging using GDB