mirror of
https://review.haiku-os.org/userguide
synced 2024-11-23 07:08:25 +01:00
187 lines
20 KiB
HTML
187 lines
20 KiB
HTML
<?xml version="1.0" encoding="UTF-8"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="pl" xml:lang="pl">
|
||
<head>
|
||
<!--
|
||
*
|
||
* Copyright 2008-2020, Haiku. All rights reserved.
|
||
* Distributed under the terms of the MIT License.
|
||
*
|
||
* Authors:
|
||
* Niels Reedijk, Matt Madia and Ingo Weinhold who wrote
|
||
* http://dev.haiku-os.org/wiki/ and http://dev.haiku-os.org/wiki/ReportingBugs
|
||
* Humdinger <humdingerb@gmail.com>
|
||
* Translators:
|
||
* Kacper Kasper
|
||
*
|
||
-->
|
||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
||
<meta name="robots" content="all" />
|
||
<title>Zgłaszanie błędów</title>
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||
<link rel="stylesheet" type="text/css" href="../Haiku-doc.css" />
|
||
</head>
|
||
<body>
|
||
|
||
<div id="banner">
|
||
<div><span>Podręcznik użytkownika</span></div>
|
||
</div>
|
||
|
||
<div class="nav">
|
||
<div class="inner">
|
||
<ul class="lang-menu">
|
||
<li class="now">Polski <span class="dropdown-caret">▼</span></li>
|
||
<li><a href="../id/bugreports.html">Bahasa Indonesia</a></li>
|
||
<li><a href="../ca/bugreports.html">Català</a></li>
|
||
<li><a href="../de/bugreports.html">Deutsch</a></li>
|
||
<li><a href="../en/bugreports.html">English</a></li>
|
||
<li><a href="../es/bugreports.html">Español</a></li>
|
||
<li><a href="../eo/bugreports.html">Esperanto</a></li>
|
||
<li><a href="../fr/bugreports.html">Français</a></li>
|
||
<li><a href="../fur/bugreports.html">Furlan</a></li>
|
||
<li><a href="../it/bugreports.html">Italiano</a></li>
|
||
<li><a href="../hu/bugreports.html">Magyar</a></li>
|
||
<li><a href="../pt_PT/bugreports.html">Português</a></li>
|
||
<li><a href="../pt_BR/bugreports.html">Português (Brazil)</a></li>
|
||
<li><a href="../ro/bugreports.html">Română</a></li>
|
||
<li><a href="../sk/bugreports.html">Slovenčina</a></li>
|
||
<li><a href="../fi/bugreports.html">Suomi</a></li>
|
||
<li><a href="../sv_SE/bugreports.html">Svenska</a></li>
|
||
<li><a href="../tr/bugreports.html">Türkçe</a></li>
|
||
<li><a href="../zh_CN/bugreports.html"> 中文 ［中文］</a></li>
|
||
<li><a href="../ru/bugreports.html">Русский</a></li>
|
||
<li><a href="../uk/bugreports.html">Українська</a></li>
|
||
<li><a href="../jp/bugreports.html">日本語</a></li>
|
||
</ul>
|
||
<span>
|
||
<a href="../welcome_pl.html" class="uplink">Welcome</a>
|
||
</span></div>
|
||
</div>
|
||
|
||
<div id="content">
|
||
<div>
|
||
<div class="box-info">Tłumaczenie tej strony jest niekompletne. Nieukończone części wyświetlane są w języku angielskim.</div>
|
||
|
||
<table class="index" id="index" summary="index">
|
||
<tr class="heading"><td>Indeks</td></tr>
|
||
<tr class="index"><td><a href="#account">Zakładanie konta Trac</a><br />
|
||
<a href="#report">Otwieranie zgłoszenia</a><br />
|
||
<a href="#app">Błędy w aplikacjach</a><br />
|
||
<a href="#server">Błędy w serwerach</a><br />
|
||
<a href="#kernel">Błędy w jądrze</a><br />
|
||
<a href="#kdl">Tryb krokowy jądra (KDL)</a><br />
|
||
<a href="#syslog">Syslog</a><br />
|
||
<a href="#onscreen">Wypis dziennika na ekran</a><br />
|
||
<a href="#hardware">Błędy sprzętowe/w sterownikach</a><br />
|
||
<a href="#next">Co dalej?</a></td></tr>
|
||
</table>
|
||
|
||
<h1>Zgłaszanie błędów</h1>
|
||
|
||
<p>Nasi deweloperzy nie są w stanie przetestować każdej możliwej kombinacji sprzętu ani każdego możliwego sposobu interakcji z systemem. Z tego powodu polegamy na użytkownikach, licząc na to, że dadzą nam znać jak Haiku działa na ich komputerach. Ponieważ Haiku jest projektem dość młodym, istnieje duże prawdopodobieństwo, że natkniesz się na błędy. Dziękujemy za czas poświęcony na ich zgłoszenie. Razem możemy ulepszyć Haiku, krok po kroku.</p>
|
||
<p>Aby ułatwić na śledzenie problemów ważne jest przestrzeganie <a href="http://dev.haiku-os.org/wiki/BugTrackerEtiquette">Etykiety systemu śledzenia błędów</a> (ang.).</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="account" name="accout">Zakładanie konta Trac</a></h2>
|
||
<p>Aby zgłosić problem, potrzebujesz konta w <a href="http://dev.haiku-os.org/register" title="Register at Haiku's Bugtracker">systemie śledzenia błędów Haiku</a>.<br />
|
||
Zakładając konto koniecznie <b>podaj swój adres e-mail</b> ponieważ jest on niezbędny do otrzymania podstawowych uprawinień modyfikacji zgłoszeń. Nie zapomnij <b>sprawdzić katalogu ze spamem</b> maile weryfikacyjne zwykle tam trafiają.</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="report" name="report">Otwieranie zgłoszenia</a></h2>
|
||
<p>Przed otworzeniem zgłoszenia <a href="http://dev.haiku-os.org/query?status=new&status=assigned&status=reopened&status=closed&summary=%7Etext+you+want+to+search+for&order=priority">upewnij się</a>, że podobne jeszcze nie istnieje. Możesz do tego użyć funkcji <a href="http://dev.haiku-os.org/search?q=&noquickjump=1&ticket=on">Szukaj</a>.<br />
|
||
Kiedy już ustaliłeś, że Twój problem nie został wcześniej zgłoszony, ustal informacje najdokładniej jak potrafisz:</p>
|
||
<ul>
|
||
<li><p>Spróbuj spowodować problem na najnowszej wersji Haiku. Gotowe obrazy do testów <a href="http://download.haiku-os.org">dostępne</a> są w sieci.</p></li>
|
||
<li><p>Załącz podstawowe informacje, takie jak na czym testujesz Haiku (na sprzęcie, w VMWare, w QEMU, itp.).</p></li>
|
||
<li><p>Napisz jakiej wersji używasz. Znajdziesz tę informację w oknie <span class="menu">O Haiku...</span> dostępnym z menu Deskbara. Istotna jest także architektura systemu (x86_gcc2, x86_64). Obrazy pobrane z sieci mają odpowiednie nazwy, w przypadku systemu zbudowanego samodzielnie powinieneś wiedzieć jakiej jest architektury.</p></li>
|
||
<li><p>Opisz problem najdokładniej jak możesz: zawrzyj nie tylko opis zachowania obserwowanego, ale też zachowania oczekiwanego.</p></li>
|
||
<li><p>Opisz krok po kroku jak wywołać opisane zachowanie. To pomoże deweloperom szybciej naprawić błąd.</p></li>
|
||
<li><p>Załącz jak najwięcej informacji. Jeśli to problem z interfejsem graficznym lub błąd w aplikacji, wykonaj zrzut ekranu klawiszem <span class="key">PRINT</span>.</p></li>
|
||
</ul>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="app" name="app">Błędy w aplikacjach</a></h2>
|
||
<p>Kiedy aplikacja ulegnie awarii, możesz włączyć <a href="../../userguide/pl/applications/debugger.html">Debugger</a>, zapisać raport lub zrzut pamięci (oba na pulpicie). Pliki dołącz do zgłoszenia.</p>
|
||
<p>If it's not a crashing bug, you may get useful information when starting the application from Terminal. Some applications provide logging and other options when started with certain parameters; try <tt>-h</tt> or <tt>--help</tt> to see if that is the case. As example, see the different logging levels of <a href="../../userguide/pl/applications/haikudepot.html#logs">HaikuDepot</a>.</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="server" name="server">Błędy w serwerach</a></h2>
|
||
<p>Gdy krytyczne dla systemu serwery takie jak app server, registrar lub input server ulegają awarii, nie zobaczysz zwyczajnego okna z błędem, jak w przypadku aplikacji. Zamiast tego cały ekran zostanie wyczyszczony na biało i zostanie wystartowana tekstowa sesja Debuggera, której rezultaty pojawią się na ekranie. Prawdopodobnie nadal będziesz mieć możliwość poruszania kursorem, który nadpisze fragmenty ekranu. Wciąż działające aplikacji (takie jak ProcessController lub zegar w Deskbarze) również mogą się tak zachowywać.<br />
|
||
Poza tym, że wszystko będzie brzydsze i mniej wygodne, obowiązują te same zasady co w przypadku błędów w aplikacjach. Co najważniejsze, uzyskaj stos wywołań (komenda <span class="cli">bt</span>). Może być konieczne zrobienie zdjęcia ekranu, ze względu na brak możliwości skopiowania tekstu.<br />
|
||
W zależności od tego, co dokładnie uległo awarii, możesz spróbować zapisać raport lub zrzut pamięci na pulpicie komendami (odpowiednio) <span class="cli">save-report</span> i <span class="cli">write-core</span>, a następnie wcisnąć krótko przycisk zasilania jeden raz, aby wyłączyć komputer. Jeżeli przycisk zasilania nie działa, dostępne są również komendy <span class="cli">shutdown</span> i <span class="cli">reboot</span>.</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="kernel" name="kernel">Błędy w jądrze</a></h2>
|
||
<p>Błędy w jądrze zazwyczaj sprawiają najwięcej problemów, będąc jednocześnie najtrudniejszymi do zbadania. Są różne objawy wskazujące na błąd w jądrze lub sterowniku:</p>
|
||
<ul>
|
||
<li><p>System z własnej woli wchodzi do trybu badania jądra (KDL). Górna część ekranu zostaje wyczyszczona białym kolorem i wypisane zostaje kilka linii tekstu. Druga linia to „<i>Welcome to Kernel Debugging Land...</i>”, ponad nią znajduje się bezpośredni powód wejścia do tego trybu.</p></li>
|
||
<li><p>System spontanicznie się restartuje.</p></li>
|
||
<li><p>System kompletnie się zawiesza. Nie można ruszyć kursorem oraz żadna aplikacja nie przerysowuje ekranu. Ważnym testem w tej sytuacji jest próba wejścia do KDL skrótem <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span> (<span class="key">SysReq</span> to <span class="key">PRINT</span> na większości klawiatur). Poczekaj na efekt przynajmniej minutę.</p></li>
|
||
<li><p>System nie startuje poprawnie. Może uruchamiać się ponownie lub zatrzymywać w którymś momencie (np. na którejś z ikon na ekranie rozruchowym). W drugim przypadku również spróbuj skrótu <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span>.</p></li>
|
||
<li><p>Cały system lub któreś z urządzeń nie zachowuje się poprawnie. Na przykład może być bardzo powolne, powodować błędy lub w ogóle nie działać. Jeśli urządzenie nie działa, pierwszą rzeczą do sprawdzenia jest, czy Haiku ten sprzęt obsługuje (np. pytając na liście mailingowej lub forum).</p></li>
|
||
</ul>
|
||
<p>Mimo że tylko ostatni symptom wskazuje na powiązanie ze sprzętem, wszystkie pozostałe objawy też mogą być spowodowane błędem w sterowniku. Jeżeli podejrzewasz jakieś konkretne urządzenie lub sterownik o powodowanie problemów, sprawdź czy wyłączenie/usunięcie ich robi różnicę. Dla przykładu, podejrzewając WiFi poszukaj w BIOS-ie opcji wyłączenia łączności bezprzewodowej. Możesz również wyłączyć ładowanie odpowiedniego sterownika (zobacz rozdział <a href="../../userguide/pl/bootloader.html">Boot Loader</a>).</p>
|
||
|
||
<h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="kdl" name="kdl">Tryb krokowy jądra (Kernel Debugging Land, KDL)</a></h3>
|
||
<p>Jeżeli system nie wszedł do KDL, możesz to zrobić samodzielnie skrótem klawiszowym <span class="key">ALT</span> <span class="key">SysReq</span> <span class="key">D</span> (<span class="key">SysReq</span> to zazwyczaj <span class="key">Print</span>).<br />
|
||
Weź pod uwagę, że w KDL klawiatura może nie działać. Klawiatury PS/2 działają zawsze, klawiatury USB podłączone do kontrolera UHCI działają tylko, gdy KDL został wywołany z klawiatury przynajmniej raz. USB OHCI nie jest obecnie obsługiwane.</p>
|
||
<p>Sam KDL jest rodzajem powłoki. Można w nim wywoływać komendy zwracające informacje o stanie systemu. Poniższe są szczególnie przydatne:</p>
|
||
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
|
||
<tr><td><span class="cli">bt</span> (lub <span class="cli">sc</span>)</td><td> </td><td>Prints a back trace (aka stack crawl). If the system entered KDL on its on volition, a back trace is normally printed automatically. Enter the command if that didn't happen or part of it is obscured (e.g. when the stack trace is so long that it wrapped around) and your only way of providing the information to developers is by taking a picture of the screen.</td></tr>
|
||
<tr><td><span class="cli">ints</span></td><td> </td><td>Wypisuje obsłużone i nieobsłużone przerwania sprzętowe.</td></tr>
|
||
<tr><td class="onelinetop"><span class="cli">co</span> (lub continue)</td><td> </td><td>Opuszcza tryb badania jądra i wznawia normalną pracę systemu, o ile jest to możliwe.</td></tr>
|
||
<tr><td><span class="cli">reboot</span></td><td> </td><td>Natychmiast restartuje system. Powoduje utratę niezapisanych danych oraz tych zapisanych, ale nie zrzuconych jeszcze na dysk.</td></tr>
|
||
</table>
|
||
<p>Więcej informacji w artykule <a href="http://www.haiku-os.org/documents/dev/welcome_to_kernel_debugging_land">Welcome to Kernel Debugging Land</a> (ang.).</p>
|
||
<p>Wyjście KDL jest kopiowane na port szeregowy (jeśli komputer jest wyposażony w taki port, a ponadto masz odpowiedni kabel i drugi komputer, możesz je przechwycić korzystając z terminala) oraz do dziennika systemu. To ostatnie nie będzie możliwe, jeżeli nie możesz wyjść z KDL. Istnieje opcja boot loadera pozwalająca przechwycić informacje z KDL mimo tego (patrz niżej).</p>
|
||
<p>Możesz wygenerować kody QR z wynikiem KDL, które mogą być potem odczytane na smartfonie lub podobnym urządzeniu. Zobacz wpis <a href="http://www.haiku-os.org/blog/mmlr/2012-07-01_qr_encode_your_kdl_output">QR Encode your KDL Output</a> (ang.) na blogu, aby dowiedzieć się jak korzystać z tej możliwości.</p>
|
||
|
||
<h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="syslog" name="syslog">Syslog</a></h3>
|
||
<p><b>Jest to preferowana metoda wyciągnięcia informacji z niestartującego systemu.</b><br />
|
||
Syslog (skrót od ang. <i>system log</i>, dziennik systemu) zawiera wartościowe informacje dotyczące tego, co działo się z systemem, włączając w to sesje KDL. Dobrą praktyką jest dołączanie tego pliku do zgłoszeń dotyczących jądra. Syslog jest zapisywany do pliku <span class="path">/boot/system/var/log/syslog</span>. Ponieważ zapisywanie do pliku wymaga działającego systemu, najświeższe informacje mogą się w nim nie znaleźć, jeżeli wystąpi problem z jądrem (w szczególności przy losowych restartach lub sesjach KDL, z których nie można wyjść).</p>
|
||
<p>The option <span class="menu">Enable debug syslog</span> in the boot loader's <span class="menu">Debug menu</span> makes the syslog persistent. If the option <span class="menu">Save syslog from previous session during boot</span> is activated in the boot loader options (as it is by default), you'll find the syslog of your last session as <span class="path">/boot/system/var/log/previous_syslog</span>.<br />
|
||
If you're not able to boot to get to the previous_syslog, you have to enter the boot loader menu by holding down <span class="key">SHIFT</span> (or <span class="key">SPACE</span> when booting via UEFI) while booting.<br />
|
||
In the boot loader's <span class="menu">Debug menu</span> you should find the entries <span class="menu">Display syslog from previous session</span> and <span class="menu">Save syslog from previous session</span>. The former displays the syslog on screen, the latter allows you to save it as a file to disk. Note that at the moment only FAT32 volumes are supported for saving the file. If you want to use a USB stick, but have plugged it in too late so that it isn't recognized yet, you can reset the machine and re-enter the boot loader menu. Note: Don't accidentally boot any operating system or the data will be lost.</p>
|
||
|
||
<h3><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="onscreen" name="onscreen">Wypis dziennika na ekran</a></h3>
|
||
<p><b>The on-screen debug output is useful only for debugging very specific issues and is known to have (timing) issues. Don't use it, if you don't have to.</b><br />
|
||
This is only relevant when Haiku fails to boot on your machine and the <span class="menu">Debug syslog</span> option doesn't work for some reason. Before the Haiku boot logo appears, hold <span class="key">SHIFT</span> (or <span class="key">SPACE</span> when booting via UEFI) to enter the boot loader menu. Select <span class="menu">Select debug options</span>. Near the bottom, <span class="menu">Enable on screen debug output</span> will be listed. (Note: The other options could be enabled in an attempt to boot Haiku. If Haiku will boot only when one or more options are activated, be sure to mention which ones.)<br />
|
||
Finally select <span class="menu">Return to main menu</span> and then <span class="menu">Continue booting</span>.<br />
|
||
One or more pages of text will display on the screen, only the last few lines need to be included on your ticket. There's more information on the <a href="../../userguide/pl/bootloader.html">Boot Loader</a>.</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="hardware" name="hardware">Błędy sprzętowe/w sterownikach</a></h2>
|
||
<p>Mając do czynienia z błędem dotyczącym sprzętu lub sterownika, do zgłoszenia powinny być załączone jako pliki wyniki następujących komend:</p>
|
||
|
||
<table summary="layout" border="0" cellpadding="2" cellspacing="0">
|
||
<tr><td>- <span class="cli">listdev</span></td><td> </td><td>Szczegółowa lista sprzętu, zawierająca identyfikatory producentów i modeli, odpowiednik linuksowych <span class="cli">lshw</span> i <span class="cli">lspci</span>.</td></tr>
|
||
<tr><td>- <span class="cli">listusb -v</span></td><td> </td><td>W przypadku problemów z USB, odpowiednik <span class="cli">lsusb</span>.</td></tr>
|
||
<tr><td>- <span class="cli">open /var/log/syslog</span></td><td> </td><td>Dziennik systemu opisany <a href="#syslog">wyżej</a>. Komendą <span class="cli">open</span> możesz przyciąć dziennik w edytorze tekstu.</td></tr>
|
||
<tr><td class="onelinetop">- <span class="cli">listimage | grep drivers/</span></td><td> </td><td>Sporządza listę wszystkich używanych sterowników.</td></tr>
|
||
<tr><td>- <span class="cli">usb_hid_report</span></td><td> </td><td>In case of USB input devices, add the <span class="cli">/tmp/usb_hid_report_descriptor_*.bin</span> file.</td></tr>
|
||
<tr><td>- <span class="cli">ints</span></td><td> </td><td>Dostępna tylko w <i>Trybie krokowym jądra (KDL)</i> (patrz wyżej). Wyświetla przerwania. Nie powinno być zbyt wielu współdzielonych przez różne urządzenia.</td></tr>
|
||
<tr><td colspan="3">- On screen debug output (a debug boot time option, see <a href="#onscreen">above</a>).</td></tr>
|
||
</table>
|
||
|
||
<p>Pierwsze cztery komendy należy wpisać w aplikacji Terminal. Dodając <span class="cli"> > output.txt</span> po komendzie, można przekierować jej wynik z ekranu do pliku o nazwie „output.txt”, który później łatwo załączyć do zgłoszenia lub maila.</p>
|
||
|
||
<h2><a href="#"><img src="../images/up.png" style="border:none;float:right" alt="index" /></a>
|
||
<a id="next" name="next">Co dalej?</a></h2>
|
||
<p>Po zgłoszeniu błędu, jeden z deweloperów rzuci na niego okiem i spróbuje go sklasyfikować. Pamiętaj, wszyscy jesteśmy wolontariuszami, czasami zgłoszenie może pozostać przez jakiś czas bez odpowiedzi. Dołączanie nowych informacji zazwyczaj sprawia, że błąd zostanie naprawiony szybciej, ale nie należy „podbijać” zgłoszenia nieistotnymi komentarzami.</p>
|
||
<p>Pamiętaj też, że zgłoszenie błędu to nie jest jednorazowy wysiłek. Po otwarciu zgłoszenia stajesz się częścią procesu jego rozwiązywania. W jego trakcie deweloperzy mogą mieć pytania. Zostań w kontakcie, aby móc na nie odpowiedzieć. Możesz uznać swoje zaangażowanie za „zakończone” dopiero gdy zgłoszenie zostanie oznaczone jako „rozwiązane”.</p>
|
||
|
||
</div>
|
||
</div>
|
||
|
||
<div class="nav">
|
||
<div class="inner"><span>
|
||
<a href="../welcome_pl.html" class="uplink">Welcome</a>
|
||
</span></div>
|
||
</div>
|
||
|
||
</body>
|
||
</html>
|