1 <?xml version="1.0" encoding="utf-8"?>
2 <!-- synced with r26990 -->
3 <appendix id="bugreports">
4 <title>Hogyan jelentsd a hibákat</title>
7 A jó hiba jelentések nagyon értékes hozzájárulások bármilyen szoftver
8 fejlesztéséhez. De, akárcsak jó programot írni, jó probléma jelentést
9 készíteni is némi munkába kerül. Kérlek vedd figyelembe, hogy a fejlesztők
10 többsége roppant elfoglalt és valami hihetetlen mennyiségű levelet kap.
11 Tehát miközben a visszajelzések kritikus és nagyon megbecsült az
12 <application>MPlayer</application> fejlődése szempontjából, kérlek értsd meg,
13 hogy <emphasis role="bold">minden</emphasis> általunk kért információt meg
14 kell adnod és követned kell az ebben a dokumentumban leírt lépéseket.
18 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
21 <sect1 id="bugreports_security">
22 <title>Biztonsági hibák jelentése</title>
25 Ha egy kihasználható hibát találsz és a helyesen akarsz cselekedni,
26 vagyis előbb a mi tudomásunkra akarod hozni, mielőtt publikálnád,
27 szívesen vesszük a biztonsági figyelmeztetésedet a
28 <ulink url="mailto:security@mplayerhq.hu">security@mplayerhq.hu</ulink>
30 Kérjük írd bele a tárgy mezőbe a [SECURITY] vagy [ADVISORY] szót.
31 Figyelj rá, hogy a jelentésed a hiba teljes és részletes analízisét tartalmazza.
32 Nagyon hálásak leszünk, ha javítást is küldesz.
33 Kérjük ne késlekedj a jelentéseddel egy proof-of-concept exploit írása
34 miatt, azt később is elküldheted egy másik levélben.
39 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
42 <sect1 id="bugreports_fix">
43 <title>Hogyan javíts hibákat</title>
46 Ha úgy érzed, hogy képes vagy rá, bátran állj neki és javítsd ki a hibát magad.
47 Vagy talán már meg is tetted? Kérlek olvasd el <ulink url="../../tech/patches.txt">ezt a rövid dokumentumot</ulink>,
48 hogy megtudd, hogyan kerülhet be a kódod az <application>MPlayer</application>be.
49 Az <ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">MPlayer-dev-eng</ulink>
50 levelezési listán lévő emberkék segítenek neked, ha kérdésed van.
55 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
58 <sect1 id="bugreports_regression_test">
59 <title>Hogyan tesztelj a Subversion segítségével</title>
62 Egy néha előforduló probléma, hogy "régen még működött, de most már nem...".
63 Következzék hát egy lépésenkénti leírás, mely segít a probléma
64 megtalálásában. Ez <emphasis role="bold">nem</emphasis> az átlagos
69 Először is, be kell szerezned az MPlayer forrás fáját a Subversionből.
70 Az utasításokat megtalálod a
71 <ulink url="http://www.mplayerhq.hu/design7/dload.html#svn">letöltési oldal Subversion részében</ulink>.
75 Ezután lesz az mplayer/ könyvtárban a Subversion fáról egy pillanatképed,
76 a kliens oldalon. Ezután frissítsd ezt a kívánt dátumúra:
79 svn update -r {"2004-08-23"}
81 A dátum formátum YYYY-MM-DD HH:MM:SS.
82 Ezen dátum formátum használata biztosítja, hogy benne legyen minden olyan
83 javítás, ami az adott dátumig commit-olva lett és bekerült az
84 <ulink url="http://lists.mplayerhq.hu/pipermail/mplayer-cvslog/">MPlayer-cvslog archívumába</ulink>.
88 Majd folytasd, mint egy normális frissítést:
96 Ha olyan olvassa ezt, aki nem programozó, annak gyorsabb megkeresni a
97 probléma forrását bináris keresés használatával — ekkor
98 a hiba helyét a keresési intervallum ismételt felezéseivel határozza
100 Például a probléma előfordult 2003 közepén, akkor kérdezd meg, hogy
101 "Már ott volt a hiba?".
102 Ha igen, akkor menj vissza április elsejére; ha nem, menj október elsejére,
107 Ha nagyon sok hely van a merevlemezeden (egy teljes fordítás jelenleg 100 MB
108 és 300-350 MB körül van a hibakereső szimbólumokkal), másold át a
109 legrégebbi tudvalevőleg működő verziót, mielőtt frissítenél; ezzel időt
110 spórolsz, ha vissza kell lépned.
111 (Általában le kell futtatni a 'make distclean'-t egy régi verzió újrafordítása
112 előtt, így ha nem készítesz mentést az eredeti forrás fádról, újra kell fordítanod
113 mindent, ha visszajössz a jelenbe.)
117 Ha megvan a nap, amikor a probléma megjelent, folytasd a keresést az
118 mplayer-cvslog archívum segítségével (dátum szerint rendezve) és egy sokkal
119 precízebb svn update-tel, melybe órát, percet és másodpercet is írsz:
121 svn update -r {"2004-08-23 15:17:25"}
123 Így könnyen megtalálod azt a javítást, ami okozta.
127 Ha megvan a javítás, ami a problémát okozta, majdnem győztél is;
129 <ulink url="http://bugzilla.mplayerhq.hu/">MPlayer Bugzilla</ulink>-n vagy
131 <ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-users">MPlayer-users</ulink>
132 listára és küldd el oda.
133 Valószínűleg a szerző jelentkezni fog javítási ötlettel.
134 Addig azonban a javításra is gyanakodva tekint, amíg nem tiszta, hogy hol
140 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
143 <sect1 id="bugreports_report">
144 <title>Hogyan jelentsd a hibákat</title>
147 Mindenek előtt kérlek, hogy mindig próbáld ki az <application>MPlayer</application>
148 legújabb Subversion verzióját, hátha az általad felfedezett hibát már kijavították
149 benne. A fejlesztés borzasztó gyorsan halad, a legtöbb, hivatalos kiadásban
150 meglévő problémát napokon vagy akár órákon belül jelentik, így
151 <emphasis role="bold">csak a Subversion felhasználásával</emphasis> küldj hibajelentést.
152 Ebbe beleértendőek az <application>MPlayer</application> bináris csomagjai is.
153 A Subversion utasításokat megtalálod
154 <ulink url="http://www.mplayerhq.hu/dload.html">ennek az oldalnak</ulink>
155 az alján vagy a README fájlban. Ha ez sem segít, olvasd el az
156 <link linkend="bugs">ismert hibák</link> listáját és a dokumentáció többi részét.
157 Ha problémád még nem ismert vagy nem oldódott meg a leírásunk által, akkor kérjük
162 Kérlek ne küljd hibajelentést személyesen egy fejlesztőnek. Ez csapatmunka és
163 így számos embert érdekelhet. Néha más felhasználók is belefutnak a te
164 problémáidba, és esetleg tudják, hogy hogyan lehet megkerülni, még akkor is,
165 ha hiba van az <application>MPlayer</application> kódjában.
169 Kérlek olyan részletesen írd le a problémádat, amilyen részletesen csak lehet.
170 Végezz egy kis felderítő munkát, szűkítsd le azon körülmények körét, amelyek
171 között a hiba előfordul. A hiba csak adott szituációban jön elő? Bizonyos
172 fájlokra vagy fájl típusokra vonatkozóan? Csak egy codec esetén vagy független
173 a használt codec-től? Mindegyik kimeneti vezérlővel elő tudod hozni? Minél több
174 információt adsz meg, annál nagyobb az esély a hiba kijavítására. Kérlek ne
175 felejtsd el mellékelni azon értékes információkat, amit lejjebb írunk, különben
176 képtelenek vagyunk megfelelően megkeresni a problémádat.
180 Egy kitűnő és jól megírt útmutató kérdések publikus fórumokban történő feltevéséhez
181 a <ulink url="http://www.catb.org/~esr/faqs/smart-questions.html">How To Ask Questions The Smart Way</ulink>
182 (<ulink url="http://www.no.info.hu/~kryss/gnu/esr/smart-questions_hu.html">magyarul</ulink>)
183 <ulink url="http://www.catb.org/~esr/">Eric S. Raymond</ulink>-tól.
185 <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</ulink>
186 című <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/">Simon Tatham</ulink>-tól.
187 Ha követed ezeket a leírásokat, kapsz segítséget. De kérlek értsd meg, hogy a
188 levelezési listákat önként, a szabad időnkben nézzük. Van más dolgunk is, és nem
189 tudjuk garantálni, hogy kapsz megoldást vagy egyáltalán választ a problémádra.
194 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
197 <sect1 id="bugreports_where">
198 <title>Hol kell jelezni a hibákat</title>
201 Iratkozz fel az MPlayer-users levelezési listára:
202 <ulink url="http://lists.mplayerhq.hu/mailman/listinfo/mplayer-users"/>
203 (vagy a magyar nyelvűre itt: <ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok"/>)
204 és küldd el a hibajelentéseidet a
205 <ulink url="mailto:mplayer-users@mplayerhq.hu"/> (illetve
206 <ulink url="mailto:mplayer-felhasznalok@mplayerhq.hu"/>) címre, ahol meg lehet vitatni.
210 Ha inkább azt szeretnéd, használhatod a vadi új
211 <ulink url="http://bugzilla.mplayerhq.hu/">Bugzillánkat</ulink> is.
215 Ezen lista nyelve az <emphasis role="bold">angol</emphasis> (a -felhasználóké magyar).
217 <ulink url="http://www.ietf.org/rfc/rfc1855.txt">Netiquette Irányelveket</ulink>
218 és <emphasis role="bold">ne küldj HTML levelet</emphasis> egyik levelezési
219 listánkra se. Ha nem így teszel, akkor vagy egyszerűen figyelmen kívül hagynak
220 vagy kitiltanak. Ha nem tudod mi az a HTML levél vagy hogy miért rossz az, olvasd
222 <ulink url="http://expita.com/nomime.html">frankó leírást</ulink>. Mindent
223 részletesen megmagyaráz és tanácsokat ad a HTML kikapcsolásához. Szintén tartsd
224 észben, hogy nem CC-zünk (carbon-copy) egyéneknek, így jól teszed, ha
225 feliratkozol, hogy megkapd te is a választ.
230 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
233 <sect1 id="bugreports_what">
234 <title>Mit jelents</title>
237 A hibajelentésedhez csatolnod kell a log-ot, konfigurációs vagy minta fájlokat.
238 Ha ezek közül valamelyik nagy, jobb ha feltöltöd az
239 <ulink url="ftp://upload.mplayerhq.hu/MPlayer/incoming/">FTP szerverünkre</ulink> tömörített
240 formátumban (gzip és bzip2 a javasolt) és csak az elérési utat és a fájl nevet írod
241 bele a hiba jelentésedbe. A levelezési listáinkon az üzenet mérete maximum 80k lehet,
242 ha ennél nagyobb fájlod van, tömörítened kell, vagy feltöltened.
247 <sect2 id="bugreports_system">
248 <title>Rendszer információk</title>
253 A Linux disztribúciód vagy operációs rendszered verziója, pl.:
255 <listitem><para>Red Hat 7.1</para></listitem>
256 <listitem><para>Slackware 7.0 + 7.1-es fejlesztői csomagjai ...</para></listitem>
261 <screen>uname -a</screen>
265 <screen>ls -l /lib/libc[.-]*</screen>
276 <screen>as --version</screen>
279 Ha a teljes képernyős lejátszással van gondod:
281 <listitem><para>Ablakezelő tíusa és verziója</para></listitem>
285 Ha az XVIDIX-szel van problémád:
289 <screen>xdpyinfo | grep "depth of root"</screen>
294 Ha csak a GUI a hibás:
296 <listitem><para>GTK verziója</para></listitem>
297 <listitem><para>GLIB verziója</para></listitem>
298 <listitem><para>GUI szituáció, ahol a hiba előjön</para></listitem>
307 <sect2 id="bugreports_hardware">
308 <title>Hardver és vezérlők</title>
313 CPU infó (csak Linuxon működik):
314 <screen>cat /proc/cpuinfo</screen>
317 Videó kártya gyártója és modellje, pl.:
319 <listitem><para>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</para></listitem>
320 <listitem><para>Matrox G400 DH 32MB SGRAM</para></listitem>
324 Videó vezérlő típusa & verziója, pl.:
326 <listitem><para>X built-in driver</para></listitem>
327 <listitem><para>nVidia 0.9.623</para></listitem>
328 <listitem><para>Utah-GLX CVS 2001-02-17</para></listitem>
329 <listitem><para>DRI from X 4.0.3</para></listitem>
333 Hangkártya típusa & vezérlője, pl.:
335 <listitem><para>Creative SBLive! Gold with OSS driver from oss.creative.com</para></listitem>
336 <listitem><para>Creative SB16 with kernel OSS drivers</para></listitem>
337 <listitem><para>GUS PnP with ALSA OSS emulation</para></listitem>
341 Ha nem vagy biztos benne, csatold az <command>lspci -vv</command> kimenetét (Linux alatt).
349 <sect2 id="bugreports_configure">
350 <title>Konfigurációs problémák</title>
353 Ha a <command>./configure</command> futtatása közben fordult elő valami hiba,
354 vagy valaminek az automatikus detektálása nem sikerült, olvasd el a <filename>configure.log</filename>
355 fájlt. Ott megtalálod a választ, például ugyanazon függvénykönyvtár több verziója elszórva
356 a rendszerben, vagy elfelejtetted telepíteni a fejlesztői csomagokat (amiknek -dev
357 utótagjuk van). Ha úgy hiszed, hogy hibát találtál, csatold a <filename>configure.log</filename>
358 fájlt a hibajelentésedhez.
362 <sect2 id="bugreports_compilation">
363 <title>Fordítási problémák</title>
366 Kérlek csatold a következő fájlokat:
368 <listitem><para>config.h</para></listitem>
369 <listitem><para>config.mak</para></listitem>
376 <sect2 id="bugreports_playback">
377 <title>Lejátszási problémák</title>
380 Írd meg az <application>MPlayer</application> kimenetét az 1. szintű
381 beszédességgel, de figyelj rá, hogy
382 <emphasis role="bold">ne szerkeszd át a kimenetet</emphasis>,
383 amikor beilleszted a levélbe. A fejlesztőknek szükségük van azokra az üzenetekre,
384 hogy pontosan diagnosztizálják a problémát. A kimenetet átirányíthatod fájlba így:
386 mplayer -v <replaceable>options</replaceable> <replaceable>filename</replaceable> > mplayer.log 2>&1
391 Ha a probléma egy vagy több fájl esetén specifikus, kérlek töltsd fel ide:
392 <ulink url="ftp://upload.mplayerhq.hu/MPlayer/incoming/"/>
396 Tölts fel egy apró, a fájloddal megegyező nevű, de .txt kiterjesztésű szöveges
397 fájlt is. Írd le a problémát, ami az adott fájllal jelentkezik és írd bele az
398 e-mail címed valamint az <application>MPlayer</application> kimenetét 1. szintű
399 beszédességgel. Általában a fájl első 1-5 MB-ja elég a hiba reprodukálásához,
400 de a biztonság kedvéért:
402 dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5
404 Ez az első 5 megabájtot a '<emphasis role="bold">your-file</emphasis>'-ból átírja
405 a '<emphasis role="bold">small-file</emphasis>'-ba. Ezután próbáld ki ezt a kicsi
406 fájlt is és ha a hiba még mindig jelentkezik, akkor ez elegendő lesz nekünk.
407 Kérlek <emphasis role="bold">soha</emphasis> ne küldj fájlokat mail-en keresztül!
408 Töltsd fel és csak az FTP szerveren élő elérési utat/fájlnevet írd meg. Ha a fájl
409 elérhető a neten, akkor a <emphasis role="bold">pontos</emphasis> URL beküldése
416 <sect2 id="bugreports_crash">
417 <title>Összeomlások</title>
420 Az <application>MPlayer</application>t a <command>gdb</command>-n belül kell
421 futtatnod, és elküldeni a teljes kimenetet vagy ha van <filename>core</filename>
422 dump-od az összeomlásról, abból is kiszedheted a hasznos információkat. Íme így:
425 <sect3 id="bugreports_debug">
426 <title>Hogyan tárolhatóak a reprodukálható összeomlás információi</title>
429 Fordítsd újra az <application>MPlayer</application>t a debug-oló kód engedélyezésével:
431 ./configure --enable-debug=3
434 majd futtasd az <application>MPlayer</application>t a gdb-ben az alábbi paranccsal:
435 <screen>gdb ./mplayer</screen>
436 Most a gdb-ben vagy. Írd be:
438 run -v <replaceable>kapcsolok-az-mplayernek</replaceable> <replaceable>fajlnev</replaceable>
440 és reprodukáld az összeomlást. Amint megtörtént, a gdb visszaadja a parancssort, ahol
451 <sect3 id="bugreports_core">
452 <title>Hogyan szedd ki a hasznos információkat a core dump-ból</title>
455 Hozd létre a következő parancs fájlt:
461 Majd add ki ezt a parancsot:
463 gdb mplayer --core=core -batch --command=<replaceable>command_file</replaceable> > mplayer.bug
471 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
474 <sect1 id="bugreports_advusers">
475 <title>Tudom hogy mit csinálok...</title>
478 Ha készítettél egy megfelelő hibajelentést a fenti utasítások betartásával
479 és biztos vagy benne, hogy az <application>MPlayer</application>ben van a
480 hiba és nem a fordítóban vagy hibás fájl miatt, már elolvastad a dokumentációt
481 és nem tudtad javítani a problémát, a hang vezérlőid rendben vannak, akkor
482 iratkozz fel az MPlayer-advusers listára és küldd el a hibajelentésedet oda
483 a jobb és gyorsabb válaszért.
487 Fontold meg, ha kezdő kérdéseket vagy a leírásban megválaszolt kérdéseket
488 küldesz be, vagy figyelmen kívül hagynak vagy elkezdenek flame-elni válaszolás
489 helyett. Tehát ne flame-elj és csak akkor iratkozz fel az -advusers listára,
490 ha tényleg tudod, hogy mit csinálsz és gyakorlott <application>MPlayer</application>
491 felhasználónak vagy fejlesztőnek érzed magad. Ha megfelesz ezen kritériának,
492 nem fog nehezedre esni, hogy kitaláld, hogy iratkozhatsz fel...