Bagaimana Melaporkan sebuah Masalah

Pelaporan masalah versi rilis

1. Pertama kali periksa perbaikan dan catatan tentang rilis.
2. Kemudian mencari keberadaan sebuah rilis lebih baru yang tersedia.
3. Hal terakhir untuk diperiksa adalah perubahan antar versi OpenBSD.

Jika tidak satupun mengarahkan suatu petunjuk pada masalah anda, maka mari mengenal sendbug(1) sebelum mengirimkan sebuah laporan masalah.

Baca lebih lanjut untuk tipe laporan masalah yang sesuai.

Laporan masalah versi current

1. Periksa masalah paling tidak 2 kali, dengan kode sumber yang terbarui beberapa hari sebelumnya.
2. Jangan melaporkan masalah kompilasi kode sumber, walaupun masalah tersebut masih tetap sedangkan anda sudah berusaha keras. Masalah ini hampir selalu adalah kesalahan anda atau sedang dikerjakan diwaktu anda mendapatkannya. Orang yang bekerja pada proyek melakukan make build paling tidak dua kali sehari, dan biasanya beberapa kali setiap hari dengan arsitektur berbeda-beda.
3. Ingat bahwa server anoncvs diperbarui secara signifikan dibalik pohon kode sumber aktual yang bekerja.
4. Periksa perubahan antar versi OpenBSD untuk melihat jika suatu masalah telah ditemukan solusinya.
5. Perhatian lebih adalah pada pembuatan snapshot . Seringkali kesalahan terjadi, dan permintamaafan kami semakin besar. Membaca/menulis email di mailis lebih tepat daripada mengirimkan laporan masalah.

Bagaimana membuat laporan masalah

Jangan mencoba memperbaiki sendiri suatu masalah yang memebutuhkan penanganan signifikan sampai anda yakin memahami masalah tersebut, terutama selama periode rilis ketika kita harus mengubah bagian utama dari kode sumber. Jika anda akan menulis sejumlah kode sumber yang signifikan, periksa berbagai forum untuk meyakinkan bahwa seseorang lain tidak sedang bekerja menyelesaikan masalah tersebut (mencegah duplikasi pekerjaan).

Hal-hal berikut harus tercantum dalam setiap laporan masalah:

1. Urutan langkah-langkah yang pasti dari awal sangat diperlukan untuk mengikuti timbulnya masalah. Harus terlapor secara langung; tidak cukup jika diberitahukan hanya perintah dasarnya saja tanpa menyertakan argumen dan data lain yang ada saat anda bekerja. Jika sebuah masalah didapat dari sebuah urutan kegiatan tertentu, mohon disampaikan daftar kegiatan yang telah dilakukan. Anda diharapkan mampu untuk meminimasi ukuran dari contoh pesan masalah anda, tapi hal ini bukan suatu keharusan.Jika suatu masalah tersebut dapat di buat lagi, kami akan menemukannya dengan cara yang berlainan.

2. Keluaran yang anda dapat. Mohon jangan berkata "tidak bekerja(didn't work)" atau "gagal(failed)". Jika ada pesan kesalahan, tunjukkan, meskipun anda tidak memahaminya. Jika OpenBSD panik dengan kesalahan tertentu, beritahukan bagian mana. Jika tidak muncul atau terjadi apapun, beritahukan juga. Meskipun jika hasil dari kasus pemeriksaan anda adalah kekacauan program atau justru sangat jelas, mungkin hal ini tidak terjadi dalam pemeriksaan kami. Hal termudah adalah menyalin keluaran dari terminal, sebisa mungkin.

   Catatan: Dalam kasus kegagalan berat, pesan kesalahan yang ada mungkin tidak berisi semua keterangan yang seharusnya ada. Untuk kasus tersebut, lihat juga pada keluaran berkas log sistem, seperti berkas-berkas yang tersimpan di /var/log. Juga, jika masalah anda berkaitan dengan sebuah aplikasi yang mempunyai berkas log sendiri, seperti httpd, periksa kesalahan yang tersimpan di log terkait ( dalam hal httpd ini, lihat di /var/www/logs).

3. Keluaran kernel OpenBSD. Anda bisa mendapatkannya dengan perintah dmesg , tapi bisa juga keluaran dmesg anda tidak berisi semua keterangan yang ditangkap di /var/run/dmesg.boot. JIka hal ini yang terjadi, sertakan keterangan dari keduanya. Mohon sertakan hal ini semua dalam seluruh laporan kesalahan.

4. Jika anda menjalankan peranti lunak tingkat tiga yang menyebabakan kesalahan tersebut, beritahukan, termasuk subversi peranti lunak yang anda pakai. Jika anda berbicara tentang sebuah snapshot lewat CVS atau FTP, sebutkan hal ini, beserta datnggal dan waktunya.

5. Sebuah traceback(penelusuran ulang) dari paniknya kernel anda. Jika kernel anda menjadi panik, dan ada berada di prompt ddb>, kemudian silahkan menyediakan pesan panik, sebagaimana perintah trace dan ps dalam laporan kesalahan anda sangatlah dianjurkan.
   Jika karena suatu alasan tertentu, pesan panik tidak terlihat, anda bisa mendapatkannya kembali dengan perintah x/s *panicstr.
   Hal ini esensial dimana memungkinkan. Laporan panik tanpa pesan panik, traceback, dan keluaran ps adalah laporan tidak berguna.
   Keluaran dari show registers mungkin menarik juga. Anda lalu mungkin ingin reboot dengan boot dump sehingga bisa disimpan oleh citra kernel dengan savecore(8) untuk penelusuran lebih lanjut.

6. Jika anda melaporakan masalah berkait dengan sistem jendela X pada suatu arsitektur yang menggunakan server XFree86, mohon disertakan isi berkas penuh /var/log/XFree86.0.log dalam laporan anda sebagai tambahan dari keterangan dmesg.boot.

Jangan takut jika laporan anda menjadi agak panjang. Hal itu adalah fakta kehidupan. Lebih baik melaporkan semua hal pada kesempatan pertama daripada kami berusaha memeras keluar fakta yang ada dari anda. Di lain pihak, jika masukan anda terlalu besar, adalah wajar untuk meminta seseorang yang tertarik memeriksanya.

Akhirnya, ketika menulis sebuah laporan kesalahan, mohon dipilih terminologi yang tidak membingungkan.

Mengirim laporan kesalahan

Jika memungkinkan, gunakan perintah sendbug(1) untuk mendapatkan kesalahan dalam sistem penelusuran kami. Jika anda mengikuti sistem penelusuran pada halaman web ini. Sendbug membutuhkan sistem anda dapat mengirim email Internet dengan benar. Jika anda tidak dapat menggunakan sendbug pada sebuah mesin OpenBSD fungsional, silahkan kirim laporan anda ke bugs@openbsd.org.

Mungkin apa yang anda kirim adalah permintaan tambahan suatu fitur, bukan sebuah kesalahan yang berarti. Fitur baru diterima, terutama disertai kode sumber yang mengimplementasikan saran anda tentang fitur baru tersebut. Jika seseorang lain telah menulis kode sumber untuk fitur baru yang anda inginkan, ada peluang fitur tersebut akan disalahpahami sampai saat dibuatnya sehingga anda tidak akan mengenalinya.

Untuk pelacakan beberapa masalah, kita harus mempunyai peranti keras yang kedapatan masalah. Harap diingat bahwa sumberdaya proyek OpenBSD terbatas. Anda dapat menyumbangkan beberapa peranti keras.

Tipe-tipe laporan kesalahan supaya sesuai yang diinginkan:

1. Masalah yang bisa diulang disertai kode sumber diperbaiki adalah yang terbaik.
2. Masalah yang bisa diulang dan tidak spesifik pada rancangan peranti keras/lunak anda.
3. Masalah yang bisa diulang dan spesifik pada rancangan peranti lunak anda.
4. Masalah yang bisa diulang dan spesifik pada rancangan peranti keras anda.
5. Masalah yang tak bisa diulang -- atau masalah yang anda harap tidak berulang.