Menyediakan Stack Trace

Stack trace (kadang-kadang juga disebut backtrace) adalah daftar panggilan fungsi yang mengarah ke suatu titik dalam program. Alat debugging seperti gdb atau bug-buddy dapat mengambil stack trace dari aplikasi yang mengalami crash sehingga pengembang dapat mengetahui apa yang salah.

Sebuah stack trace tipikal terlihat mirip dengan berikut ini:

Sebuah backtrace yang lebih baik, dengan simbol debuginfo (lihat di bawah), terlihat seperti ini:

Perhatikan nama file dan nomor baris di mana fungsi-fungsi tersebut dipanggil.

Ketika sebuah program dikompilasi dengan opsi khusus untuk menghasilkan simbol debugging (opsi kompiler -g), informasi tambahan disimpan dalam berkas program. Informasi ini dapat digunakan untuk menghasilkan jejak tumpukan (stack trace) yang mengandung informasi yang jauh lebih detail, seperti nomor baris tepat pada berkas sumber di mana kesalahan terjadi. Tanpa informasi ini, sangat sulit untuk menentukan apa yang salah dengan melihat jejak tumpukan.

Fedora menyertakan jenis khusus RPM yang disebut debuginfo RPM. RPM ini dibuat secara otomatis dan berisi informasi debugging dari berkas program, namun dipindahkan ke berkas eksternal. Semua alat yang menangani informasi debugging tahu cara secara otomatis mencari berkas-berkas ini. Hal ini memungkinkan Anda dengan mudah menginstal informasi debugging saat Anda membutuhkannya. Anda harus menginstal versi dan arsitektur debuginfo yang persis sama dengan aplikasi yang ingin Anda debug.

Contoh: Memverifikasi Versi dan Arsitektur yang Sesuai

Setiap paket yang berisi file biner dalam distribusi memiliki paket debuginfo yang sesuai.

Pertama, pastikan Anda telah menginstal paket debuginfo untuk aplikasi yang sedang Anda debug dan semua perpustakaan terkait. Seorang pengembang sering menyarankan Anda untuk menginstal paket debuginfo tertentu karena ia dapat mengetahui dari jejak tumpukan (stack trace) perpustakaan mana yang terlibat dalam kegagalan (crash). Lihat di bawah ini untuk paket yang direkomendasikan untuk beberapa jenis aplikasi umum.

Ada beberapa cara untuk mendapatkan stack trace:

Setidaknya, Anda perlu menginstal paket debuginfo untuk aplikasi yang mengalami crash. Anda dapat mengetahui paket mana yang berisi aplikasi tersebut dengan mengetikkan rpm -qf path-of-program.

Untuk jenis program tertentu, sangat berguna untuk menginstal beberapa paket default yang berguna untuk hampir semua stack trace:

Pertama, jalankan perintah berikut untuk memulai gdb:

Di mana nama-program adalah nama program yang mengalami crash (misalnya: /usr/bin/gnome-panel).

Kemudian, di prompt gdb, ketik:

Jika Anda perlu memberikan argumen kepada program, berikan argumen tersebut setelah perintah run, seperti:

Setelah program berjalan, ulangi kesalahan tersebut dan kembali ke terminal tempat Anda menjalankan gdb. Prompt gdb seharusnya ditampilkan - jika tidak, tekan Control+C untuk masuk ke debugger. Di prompt debugger gdb, ketik:

Jika cara tersebut tidak berhasil (artinya Anda tidak mendapatkan output apa pun—hal ini mungkin terjadi pada program yang tidak menggunakan multi-threading), ketik <code>bt</code> sebagai gantinya. Jika Anda masih tidak mendapatkan output apa pun, baca [[#special| catatan ini]] tentang cara mendapatkan stack trace dalam kondisi khusus. Output yang ditampilkan adalah stack trace. Salin dan tempel seluruhnya ke dalam berkas teks.

Anda dapat keluar dari gdb dengan mengetikkan quit.

Terkadang, jejak (trace) bisa cukup besar dan sulit untuk disalin dan ditempelkan. Dalam situasi seperti itu, menyimpan jejak ke dalam berkas (file) sangat praktis:

Jika program yang mengalami crash meninggalkan file core dump, Anda dapat menggunakan GDB untuk mendapatkan stack trace. File core dump disimpan dalam file di hard disk Anda dan biasanya diberi nama seperti "core" atau "core.3124". Untuk mendapatkan stack trace dari salah satu file tersebut, jalankan perintah berikut:

Di mana name-of-program adalah nama program yang mengalami crash (misalnya: /usr/bin/gnome-panel), dan core-file-name adalah nama file core yang berisi dump core (misalnya: core.7812).

Kemudian, di prompt gdb, ketik:

Jika cara tersebut tidak berhasil (artinya Anda tidak mendapatkan output apa pun—hal ini mungkin terjadi pada program yang tidak mendukung multi-threading), ketik bt sebagai gantinya. Jika Anda masih tidak mendapatkan output apa pun, baca catatan ini tentang cara mendapatkan stack trace dalam kondisi khusus. Output yang ditampilkan adalah stack trace. Salin dan tempel seluruhnya ke dalam berkas teks.

Anda dapat keluar dari gdb dengan mengetikkan quit.

Perhatikan bahwa pembuatan file inti dinonaktifkan secara default di Fedora (di /etc/profile). Untuk mengaktifkannya untuk sesi shell, ketik di prompt shell:

Jika Anda menginstal Fedora melalui image LiveCD, ABRT seharusnya sudah terinstal. Anda dapat memulainya melalui Aplikasi → Alat Sistem → Alat Pelaporan Bug Otomatis. Jika ABRT tidak terinstal, karena alasan apa pun, Anda dapat menginstalnya secara manual dengan melakukan langkah-langkah berikut di baris perintah:

atau buka Sistem → Administrasi → Tambah/Hapus Perangkat Lunak di Gnome, lalu ketik abrt di kotak pencarian dan pilih Temukan. Pilih paket abrt dan terapkan perubahan.

Buka Aplikasi → Alat Sistem → Alat Pelaporan Bug Otomatis dan pilih opsi tersebut untuk menjalankannya secara manual. Setelah jendela antarmuka pengguna (GUI) muncul, pilih Edit → Plugins, lalu dari jendela Pengaturan, gulir ke bawah, sorot Bugzilla, dan pilih Konfigurasi Plugin. URL Bugzilla harus https://bugzilla.redhat.com dan masukkan nama pengguna dan kata sandi Bugzilla Anda di kotak yang sesuai.

Selanjutnya, jika program Anda mengalami crash dan ABRT terpicu, saat Anda mengklik "Laporkan", ABRT akan dapat secara otomatis masuk ke Bugzilla dan mengirimkan Laporan Bug untuk Anda.

(Berikut ini mengasumsikan Gnome sebagai lingkungan desktop …​ orang lain harus memperbarui untuk KDE/lainnya)

Jika ABRT mendeteksi program yang mengalami crash, Anda akan menerima peringatan ABRT. Peringatan ini akan ditandai secara visual dengan lampu merah berkedip di area sistem tray. Klik kiri pada lampu peringatan, dan Alat Pelaporan Bug Otomatis (ABRT) akan dimulai, menampilkan semua crash yang telah terdaftar. Untuk melaporkan bug, klik kanan pada bug tersebut dan pilih “Laporkan”. ABRT akan mengumpulkan log yang diperlukan untuk dilaporkan bersama bug, lalu akan memberi tahu Anda bahwa ia akan mengirimkan laporan bug atas nama Anda. Jika Anda telah mengonfigurasi ABRT seperti pada bagian sebelumnya, ABRT akan meminta Anda untuk memverifikasi apakah akan menyertakan berbagai log, lalu secara otomatis akan terhubung ke Bugzilla dan membuka bug, menyertakan log ke dalam bug tersebut. ABRT kemudian akan menampilkan nomor bug sehingga Anda dapat melacak bug tersebut saat ditangani.

Ketika Anda mengklik kanan pada sebuah bug di ABRT dan memilih Laporkan, ABRT akan mencoba mengunduh log yang diperlukan untuk dikirim sebagai bagian dari laporan bug. Pengembang telah menambahkan kode untuk mendeteksi apakah jejak simbolik termasuk dalam backtrace, dan jika tidak ditemukan, ABRT akan memberi tahu Anda tentang hal ini, serta menampilkan perintah yang perlu dijalankan. Ini sama dengan yang ditampilkan di bagian debuginfo.

Jika Anda tidak mendapatkan output apa pun dari gdb setelah mengetik thread apply all bt atau bt, hal ini mungkin disebabkan karena program dijalankan sebagai root atau sebagai pengguna lain. Misalnya, dalam GNOME, hal ini terjadi saat menjalankan gnome-games. Dalam kasus seperti ini, Anda perlu menjadi root untuk menangkap jejak. Oleh karena itu, keluar dari gdb, masuk sebagai root, lalu ulangi langkah-langkah tersebut untuk mendapatkan stack trace.