[OpenBSD]

Kaip pranešti apie problemą


Išleistų versijų pranešimai apie klaidas

Prieš pranešant apie klaidą/problemą išleistose versijose, peržvelk šį sąrašą:
  1. Pirmiausiai patikrink pataisymų ir pastabų apie leidinį puslapį.
  2. Išsiaiškink ar yra išleista nauja laida.
  3. Paskutinis dalykas, kurį turėtum patikrinti yra pakeitimų tarp OpenBSD versijų puslapis.

Jeigu aukščiau pateiktas sąrašas neišsprendžia tavo problemos, tuomet prašome susipažinti su sendbug(1) prieš siunčiant pranešimą apie klaidą.

Skaitykite toliau apie norimus pranešimų apie klaidas tipus.

Einamosios laidos pranešimai apie problemas

Jeigu tavo problema yra su current išeities tekstų medžiu, o ne release arba stable medžiu,
  1. Testuok problemą bent du kartus, su atnaujintu kelių dienų senumo išeities tekstu.
  2. Nesiųsk pranešimų apie išeities tekstų kompiliavimo problemas, nebent jos tęsiasi. Jos praktiškai visuomet yra tavo klaida arba jos jau taisomos, kol tu su jomis susiduri. Žmonės, dirbantys projekte, paleidžia make build bent kartą per dieną ir dažnai keletą kartų per dieną, skirtingose architektūrose.
  3. Prisimink, kad anoncvs serveriai yra šiek tiek senesnės kopijos, negu pats išeities tekstų medis.
  4. Tikrink pasikeitimus tarp OpenBSD versijų, kad pamatytum, ar problema jau išspręsta.
  5. Yra dedama daug pastangų į dieninius kompiliavimus. Kartais klaida yra padaryta, ir mūsų atsiprašymai yra ištisiniai. Skaitymas/rašymas į el. pašto konferencijas yra labiau tinkamas, negu klaidos pranešimo siuntimas.

Kaip sukurti pranešimą apie klaidą

Visuomet pateik kiek įmanoma daugiau informacijos. Bandyk tiksliai nurodyti problemą. Niekada neduok neaiškių instrukcijų, arba neaiškių problemos detalių tokių, kaip "nulūžta" arba "Iškyla keistos problemos su pertraukimais viename kompiuteryje, kurį aš sumontavau." Kalbėk su kitais IRC arba kokiame kitame forume, kad patvirtintum, jog tai yra nauja, pakartotina ir t.t., ir įsitikink, kad tai nėra tavo lokali problema.

Prašome nepradėti spręsti problemų, kuri reikalauja žymaus darbo, kol kol neesi tikras, kad tu jas supranti, ypač per išleidimo periodus, kai mes negalime pakeisti pagrindinių kodo sekcijų. Jeigu tu ketini parašyti didelį kodo kiekį, patikrink įvairius forumus, kad įsitikintum, kad kažkas kitkas nedirba prie šios problemos (išvengiant dvigubo darbo).

Šie dalykai turėtų būti pranešime apie klaidą:

  1. Tiksli žingsnių seka nuo įkrovimo, būtina pakartoti problemą. Tai turėtų būti visavertiška; neužtenka išsiųsti tik komandą be argumentų ar kitų duomenų, pateiktų jai. Jeigu klaida reikalauja tam tikros įvykių sekos, prašome nurodyti jas. Tu neturėtum sumažinti savo pavyzdžio dydžio, bet tai nėra visiškai būtina. Jeigu klaida yra pakartojama, mes surasime ją bet kurio būdu.

  2. Gauta išvestis. Prašome nesakyti, kad tai "nesuveikė" arba "nepavyko". Jeigu yra klaidos pranešimas, parodykite jį, net jeigu tu jo nesupranti. Jeigu OpenBSD panikuoja su tam tikra klaida, pasakyk kuria. Jeigu nieko neatsitinka, nurodyk. Net jeigu tavo testo atveju programa išsijungė arba priešingai, tai gali neatsitikti testuojant mums. Lengviausias dalykas yra nukopijuoti išvestį į terminalą, jeigu įmanoma.

    Pastaba: Kritinių klaidų atveju, pateikta klaidos žinutė nebūtinai gali turėti visos galimos informacijos. Tokiu atveju, taip pat žiūrėk į sistemos žurnalo failų išvestį, tie failai yra laikomi /var/log. Taip pat, jeigu tu susiduri su aplikacija, kuri turi savo nuosavus žurnalų failus, tokia, kaip httpd, patikrink klaidas, kur ji laiko savo žurnalus (httpd atveju, tai yra /var/www/logs).

  3. OpenBSD branduolio išvestis. Tu gauni ją su dmesg komanda, bet yra įmanoma, kad tavo dmesg išvestis neturi visos informacijos kuri yra perimta /var/run/dmesg.boot. Jeigu taip yra įtrauk informaciją iš abiejų. Prašome įtraukti tai visuose klaidų pranešimuose.

  4. Jeigu tu leidi trečiųjų-šalių programinę įrangą, kuri įtakoja tavo klaidą, pasakyk taip, įtraukdamas visą jos versijos numerį. Jeigu tu šneki apie CVS arba FTP dieninę kompiliaciją, paminėk tai, įtraukdamas jos datą ir laiką.

  5. Pėdsakus savo branduolio panikos. Jeigu tavo branduolys supanikavo, ir tu esi ddb> eilutėje, tuomet prašome pateikti panikos žinutę, taip pat trace ir ps komandų išvestis savo klaidos pranešime, kaip patarta. Jeigu sistema pakimba, pamėginkite įjungti sysctl ddb.console=1 prieš pakibimą ir persijungti į DDB naudojant Ctrl+Alt+Esc klaviatūroje (negalite būti tuo metu X), arba išsiųsti BREAK jeigu naudojate serial konsolę.
    Jeigu, dėl kažkokios priežasties, panikos žinutė nėra matoma, tu gali ją gauti vėl su show panic komanda.
    Tai yra visuomet būtina. Panikos reportai be panikos žinutės, pėdsakų ir ps išvesties yra beverčiai.
    show registers išvestis gali būti taip pat dominanti. Tu gali tuomet persikrauti su boot dump taip, kad branduolio atvaizdas galėtų būti išsaugotas savecore(8) tolesniam derinimui, kaip aprašyta crash(8) žinyne.

  6. Jeigu tu praneši apie klaidą, susijusia su X langų sistema architektūroje, kuri naudoja X.Org serverį, prašome įtraukti pilną /var/log/Xorg.0.log failą savo pranešime, kaip priedą prie dmesg.boot informacijos.

Neišsigąsk, jeigu tavo pranešimas apie klaidą pasidaro ganėtinai didelis. Tai yra gyvenimo faktas. Geriau pranešti viską vieną kartą, negu priversti mus spausti iš tavęs faktus. Kita vertus, jeigu tavo įvesties failai yra milžiniški, būtų teisinga pirma paklausti ar kas nors susidomėtų į jį žiūrėti.

Pagaliau, kai rašai pranešimą apie klaidą, prašome pasirinkti ne painią terminologiją.

Pranešimų apie klaidas siuntimas

Jeigu įmanoma, naudok sendbug(1) komandą, kad nusiųstum pranešimą apie klaidą į mūsų sekimo sistemą. Tu gali stebėti sekimo sistemą šiame puslapyje. Sendbug reikalauja, kad tavo sistema galėtų tinkamai siųsti el. paštą internetu. Jeigu tu negali naudoti sendbug funkcionalioje OpenBSD sistemoje, prašome siųsti savo pranešimą apie klaidą adresu bugs@openbsd.org.

Galbūt tai, ką tu siunti yra funkcija, o ne klaida. Naujos funkcijos yra priimtinos, ypač su programiniu kodu, kuris implementuoja tavo naujos funkcijos pasiūlymą. Jeigu kas nors kitas parašo programinį kodą tavo naujai funkcijai, gali būti, kad pakeitimas buvo nesusipratimas ir sukurtas taip, kad tu jo nesuprasi.

Kad pašalintume kai kurias problemas, mums reikia įrangos, kuri turi problemą. Prašome prisiminti, kad OpenBSD projekto resursai yra limituoti. Tu gali paaukoti tech. įrangą.

Klaidų pranešimų tipai, pageidaujamumo tvarka:

  1. Pakartotinos problemos su išeities teksto pataisymais yra labiausiai pageidaujamos.
  2. Pakartotinos problemos, nepriklausančios nuo tavo techninės/programinės įrangos.
  3. Pakartotinos problemos, specifinės tavo programinei įrangai.
  4. Pakartotinos problemos, specifinės tavo techninei įrangai.
  5. Nepakartotinos problemos arba problemos, kurių nenorėtum pakartoti.

OpenBSD www@openbsd.org
$OpenBSD: report.html,v 1.7 2009/05/16 08:59:13 ajacoutot Exp $