synced with r27326
[mplayer/glamo.git] / DOCS / xml / hu / bugreports.xml
blob9f152aff4a2ae7fed196a2763b640ded623e3136
1 <?xml version="1.0" encoding="utf-8"?>
2 <!-- synced with r26990 -->
3 <appendix id="bugreports">
4 <title>Hogyan jelentsd a hibákat</title>
6 <para>
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.
15 </para>
18 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
21 <sect1 id="bugreports_security">
22 <title>Biztonsági hibák jelentése</title>
24 <para>
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:&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;">&#115;&#101;&#99;&#117;&#114;&#105;&#116;&#121;&#64;&#109;&#112;&#108;&#97;&#121;&#101;&#114;&#104;&#113;&#46;&#104;&#117;</ulink>
29 címen.
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.
35 </para>
36 </sect1>
39 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
42 <sect1 id="bugreports_fix">
43 <title>Hogyan javíts hibákat</title>
45 <para>
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.
51 </para>
52 </sect1>
55 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
58 <sect1 id="bugreports_regression_test">
59 <title>Hogyan tesztelj a Subversion segítségével</title>
61 <para>
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
65 felhasználóknak szól.
66 </para>
68 <para>
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>.
72 </para>
74 <para>
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:
77 <screen>
78 cd mplayer/
79 svn update -r {"2004-08-23"}
80 </screen>
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>.
85 </para>
87 <para>
88 Majd folytasd, mint egy normális frissítést:
89 <screen>
90 ./configure
91 make
92 </screen>
93 </para>
95 <para>
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 &mdash; ekkor
98 a hiba helyét a keresési intervallum ismételt felezéseivel határozza
99 meg.
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,
103 és így tovább.
104 </para>
106 <para>
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.)
114 </para>
116 <para>
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:
120 <screen>
121 svn update -r {"2004-08-23 15:17:25"}
122 </screen>
123 Így könnyen megtalálod azt a javítást, ami okozta.
124 </para>
126 <para>
127 Ha megvan a javítás, ami a problémát okozta, majdnem győztél is;
128 jelentsd az
129 <ulink url="http://bugzilla.mplayerhq.hu/">MPlayer Bugzilla</ulink>-n vagy
130 iratkozz fel az
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
135 is van a hiba :-).
136 </para>
137 </sect1>
140 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
143 <sect1 id="bugreports_report">
144 <title>Hogyan jelentsd a hibákat</title>
146 <para>
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
158 jelentsd.
159 </para>
161 <para>
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.
166 </para>
168 <para>
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.
177 </para>
179 <para>
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.
184 Van egy másik is, a
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.
190 </para>
191 </sect1>
194 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
197 <sect1 id="bugreports_where">
198 <title>Hol kell jelezni a hibákat</title>
200 <para>
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.
207 </para>
209 <para>
210 Ha inkább azt szeretnéd, használhatod a vadi új
211 <ulink url="http://bugzilla.mplayerhq.hu/">Bugzillánkat</ulink> is.
212 </para>
214 <para>
215 Ezen lista nyelve az <emphasis role="bold">angol</emphasis> (a -felhasználóké magyar).
216 Kövesd a szabványos
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
221 el ezt a
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.
226 </para>
227 </sect1>
230 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
233 <sect1 id="bugreports_what">
234 <title>Mit jelents</title>
236 <para>
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.
243 </para>
245 <!-- ********** -->
247 <sect2 id="bugreports_system">
248 <title>Rendszer információk</title>
250 <para>
251 <itemizedlist>
252 <listitem><para>
253   A Linux disztribúciód vagy operációs rendszered verziója, pl.:
254   <itemizedlist>
255     <listitem><para>Red Hat 7.1</para></listitem>
256     <listitem><para>Slackware 7.0 + 7.1-es fejlesztői csomagjai ...</para></listitem>
257   </itemizedlist>
258 </para></listitem>
259 <listitem><para>
260   kernel verziója:
261   <screen>uname -a</screen>
262 </para></listitem>
263 <listitem><para>
264   libc verziója:
265   <screen>ls -l /lib/libc[.-]*</screen>
266 </para></listitem>
267 <listitem><para>
268   gcc és ld verziója:
269   <screen>
270 gcc -v
271 ld -v<!--
272   --></screen>
273 </para></listitem>
274 <listitem><para>
275   binutils verziója:
276   <screen>as --version</screen>
277 </para></listitem>
278 <listitem><para>
279   Ha a teljes képernyős lejátszással van gondod:
280   <itemizedlist>
281     <listitem><para>Ablakezelő tíusa és verziója</para></listitem>
282   </itemizedlist>
283 </para></listitem>
284 <listitem><para>
285   Ha az XVIDIX-szel van problémád:
286   <itemizedlist>
287     <listitem><para>
288     X szín mélység:
289     <screen>xdpyinfo | grep "depth of root"</screen>
290     </para></listitem>
291   </itemizedlist>
292 </para></listitem>
293 <listitem><para>
294   Ha csak a GUI a hibás:
295   <itemizedlist>
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>
299   </itemizedlist>
300 </para></listitem>
301 </itemizedlist>
302 </para>
303 </sect2>
305 <!-- ********** -->
307 <sect2 id="bugreports_hardware">
308 <title>Hardver és vezérlők</title>
310 <para>
311 <itemizedlist>
312 <listitem><para>
313   CPU infó (csak Linuxon működik):
314   <screen>cat /proc/cpuinfo</screen>
315 </para></listitem>
316 <listitem><para>
317   Videó kártya gyártója és modellje, pl.:
318   <itemizedlist>
319     <listitem><para>ASUS V3800U chip: nVidia TNT2 Ultra pro 32MB SDRAM</para></listitem>
320     <listitem><para>Matrox G400 DH 32MB SGRAM</para></listitem>
321   </itemizedlist>
322 </para></listitem>
323 <listitem><para>
324   Videó vezérlő típusa &amp; verziója, pl.:
325   <itemizedlist>
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>
330   </itemizedlist>
331 </para></listitem>
332 <listitem><para>
333   Hangkártya típusa &amp; vezérlője, pl.:
334   <itemizedlist>
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>
338   </itemizedlist>
339 </para></listitem>
340 <listitem><para>
341   Ha nem vagy biztos benne, csatold az <command>lspci -vv</command> kimenetét (Linux alatt).
342 </para></listitem>
343 </itemizedlist>
344 </para>
345 </sect2>
347 <!-- ********** -->
349 <sect2 id="bugreports_configure">
350 <title>Konfigurációs problémák</title>
352 <para>
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.
359 </para>
360 </sect2>
362 <sect2 id="bugreports_compilation">
363 <title>Fordítási problémák</title>
365 <para>
366 Kérlek csatold a következő fájlokat:
367 <itemizedlist>
368   <listitem><para>config.h</para></listitem>
369   <listitem><para>config.mak</para></listitem>
370 </itemizedlist>
371 </para>
372 </sect2>
374 <!-- ********** -->
376 <sect2 id="bugreports_playback">
377 <title>Lejátszási problémák</title>
379 <para>
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:
385 <screen>
386 mplayer -v <replaceable>options</replaceable> <replaceable>filename</replaceable> &gt; mplayer.log 2&gt;&amp;1
387 </screen>
388 </para>
390 <para>
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/"/>
393 </para>
395 <para>
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:
401 <screen>
402 dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5
403 </screen>
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
410 is elegendő.
411 </para>
412 </sect2>
414 <!-- ********** -->
416 <sect2 id="bugreports_crash">
417 <title>Összeomlások</title>
419 <para>
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:
423 </para>
425 <sect3 id="bugreports_debug">
426 <title>Hogyan tárolhatóak a reprodukálható összeomlás információi</title>
428 <para>
429 Fordítsd újra az <application>MPlayer</application>t a debug-oló kód engedélyezésével:
430 <screen>
431 ./configure --enable-debug=3
432 make
433 </screen>
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:
437 <screen>
438 run -v <replaceable>kapcsolok-az-mplayernek</replaceable> <replaceable>fajlnev</replaceable>
439 </screen>
440 és reprodukáld az összeomlást. Amint megtörtént, a gdb visszaadja a parancssort, ahol
441 be kell írnod:
442 <screen>
444 disass $pc-32 $pc+32
445 info all-registers
446 </screen>
447 </para>
448 </sect3>
451 <sect3 id="bugreports_core">
452 <title>Hogyan szedd ki a hasznos információkat a core dump-ból</title>
454 <para>
455 Hozd létre a következő parancs fájlt:
456 <screen>
458 disass $pc-32 $pc+32
459 info all-registers
460 </screen>
461 Majd add ki ezt a parancsot:
462 <screen>
463 gdb mplayer --core=core -batch --command=<replaceable>command_file</replaceable> &gt; mplayer.bug
464 </screen>
465 </para>
466 </sect3>
467 </sect2>
468 </sect1>
471 <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
474 <sect1 id="bugreports_advusers">
475 <title>Tudom hogy mit csinálok...</title>
477 <para>
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.
484 </para>
486 <para>
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...
493 </para>
494 </sect1>
496 </appendix>