.\" Copyright (c) 1991 Free Software Foundation
.\" See section COPYING for conditions for redistribution
.\" $Id: gdb.1,v 1.4 1999/01/05 00:50:50 jsm Exp $
.\" Hungarian translation by Gergely Szakacs case@fornax.hu 1999-10-18 
.TH gdb 1 "1991 nov. 4." "GNU Eszközök" "GNU Eszközök"
.SH NÉV
gdb \- A GNU hibakereső
.SH ÖSSZEGZÉS
.na
.TP
.B gdb
.RB "[\|" \-help "\|]"
.RB "[\|" \-nx "\|]"
.RB "[\|" \-q "\|]"
.RB "[\|" \-batch "\|]"
.RB "[\|" \-cd=\c
.I dir\c
\|]
.RB "[\|" \-f "\|]"
.RB "[\|" "\-b\ "\c
.IR bps "\|]"
.RB "[\|" "\-tty="\c
.IR dev "\|]"
.RB "[\|" "\-s "\c
.I symfile\c
\&\|]
.RB "[\|" "\-e "\c
.I prog\c
\&\|]  
.RB "[\|" "\-se "\c
.I prog\c
\&\|]
.RB "[\|" "\-c "\c
.I core\c
\&\|]
.RB "[\|" "\-x "\c
.I cmds\c
\&\|]
.RB "[\|" "\-d "\c
.I dir\c
\&\|]
.RB "[\|" \c
.I prog\c
.RB "[\|" \c
.IR core \||\| procID\c
\&\|]\&\|]
.ad b
.SH LEÍRÁS
Egy olyan hibakereső, mint a GDB, célja az, hogy betekintést nyújtson egy
másik program ``belsejébe'', miközben az fut\(em\&vagy arra, hogy mit
csinált egy másik program abban a pillanatban, amikor összeomlott.

A GDB négy fő dologra képes (és még néhány egyébre is e négy dolog támogatásához),
amelyek segítenek a működés közben való hibakeresésben:

.TP
\ \ \ \(bu
Elindítja a programot, meghatároz bármely olyan dolgot, amely
befolyásolhatja a működését.

.TP
\ \ \ \(bu
Megállítja a programot meghatározott körülmények bekövetkeztekor.

.TP
\ \ \ \(bu
Megvizsgálja, hogy mi történt, amikor a program megállt.

.TP
\ \ \ \(bu
Megváltoztat dolgokat a programban, hogy kísérletezni lehessen a hiba
következményeinek kijavítása érdekében, és folytathassa a munkát egy másik hibán.
.PP

A GDB C, C++, és Modula-2 nyelvű programok hibáinak keresésére használható.
Amint a GNU Fortran fordító elkészül, a GDB a Fortran-t is támogatni fogja.

A GDB-t a \c
.B gdb\c
\& shell paranccsal kell elindítani. Ha elindult, a parancsokat a terminálról 
olvassa be, egészen addig, amíg ki nem lép a \c
.B quit\c
\& parancs hatására. Súgót a \c
.B help\c
\& paranccsal kaphat.

A \c
.B gdb\c
\& elindítható argumentumok vagy opciók nélkül is; de a leggyakoribb módja a
GDB elindításának egy vagy két argumentummal történik, egy futtatható
programot adva meg argumentumként:
.sp
.br
gdb\ program
.br
.sp

Elindítható továbbá egy futtatható program és egy core file megadásával:
.sp
.br
gdb\ program\ core
.br
.sp


A core file helyett megadható egy process azonosító második argumentumként, ha egy
már futó programban kell hibát keresni:
.sp
.br
gdb\ program\ 1234
.br
.sp

ez a parancs hozzáköti a GDB-t a \c
.B 1234-as\c
\& folyamathoz (hacsak nincs már egy `\|\c
.B 1234\c
\&\|' nevű file; a GDB először a core file jelenlétét ellenőrzi).

Alant a leggyakrabban szükséges GDB parancsok találhatók:

.TP
.B break \fR[\|\fIfile\fB:\fR\|]\fIfüggvény
\&
Töréspontot állít be a \c
.I függvény elé\c
\& (a \c
.I file\c
\&-ban).
.TP
.B run \fR[\|\fIargumentum lista\fR\|]
Elindítja a programot (\c
.I argumentum listá\c
\&val, ha meg lett adva).
.TP
.B bt
Visszakövetés: kiírja a programvermet.
.TP
.BI print " kifejezés"\c
\&
Kiírja egy kifejezés értékét.
.TP
.B c
A program futásának folytatása (megállás után, pl. töréspontnál).
.TP
.B next
A következő programsor futtatása (megállás után); \c
.I átlépi\c
\& a sorban levő függvényhívást.
.TP
.B step
A következő programsor futtatása (megállás után); \c
.I belép\c
\& a sorban levő függvénybe.
.TP
.B help \fR[\|\fInév\fR\|]
Súgót ír ki a 
.I név\c
\& nevű GDB parancsról, vagy általános információt a GDB használatáról.
.TP
.B quit
Kilép a GDB-ből.
.PP
Részletekbe menő információkért lásd: Richard M. Stallman és Roland H.
Pesch:
.I 
Using GDB: A Guide to the GNU Source-Level Debugger\c
\&. A könyv elérhető online az \c
.B info\c 
\& program \c
.B gdb\c
\& címszavaként.

.SH OPCIÓK
Bármely olyan argumentum, amely nem opció, egy futtatható fájlt és egy core
file-t (vagy folyamat azonosítót) határoz meg; azaz az első olyan argumentum,
amelyhez nem kötődik opció, megegyzik a `\|\c
.B \-se\c
\&\|' opcióval, és a második, ha van ilyen, megegyezik a `\|\c
.B \-c\c
\&\|' opcióval, ha van ilyen nevű file. Sok opciónak van hosszú és rövid
formája, itt mindkettőt megadtuk. A hosszú opciók csonkított
formában is elfogadhatóak, amennyiban a hosszuk elegendő az egyértelmű
azonosításhoz. (Ha úgy tetszik, az opció jelölhető `\|\c
.B +\c
\&\|'-szal `\|\c
.B \-\c
\&\|' helyett, de mi itt a megszokottabb jelölést használjuk.)

A GDB egymás után dolgozza fel az összes opciót és parancssori argumentumot.
Számít a sorrend, ha a 
`\|\c
.B \-x\c
\&\|' opció is szerepel.

.TP
.B \-help
.TP
.B \-h
Felsorolja az összes opciót rövid magyarázattal.

.TP
.BI "\-symbols=" "file"\c
.TP
.BI "\-s " "file"\c
\&
A \c
.I file\c
\& nevű fájlból olvassa be a szimbólum táblát.

.TP
.B \-write
A futtatható és a core fájlba történő írás engedélyezése.

.TP
.BI "\-exec=" "file"\c
.TP
.BI "\-e " "file"\c
\&
A \c
.I file\c
\& nevű fájlt hsználja futtathatóként amennyiben az arra alkalmas, és egy core dumppal
kapcsolatban nyers adatként.

.TP
.BI "\-se=" "file"\c
\&
A szimbólum táblát a \c
.I file\c
\& nevű fájlból veszi, és használja ugyan ezt a fájlt, futtathatóként.

.TP
.BI "\-core=" "file"\c
.TP
.BI "\-c " "file"\c
\&
Használja a \c
.I file\c
\& nevű fájlt core dump-nak.

.TP
.BI "\-command=" "file"\c
.TP
.BI "\-x " "file"\c
\&
A GDB parancsokat a \c
.I file\c
\& nevű fájlból olvassa.

.TP
.BI "\-directory=" "katalógus"\c
.TP
.BI "\-d " "directory"\c
\&
Adja hozzá a \c
.I katalógus\c
\& katalógust az elérési útvonalhoz forrásfile-ok kereséséhez.
.PP

.TP
.B \-nx
.TP
.B \-n
Ne futtassa a `\|\c
.B .gdbinit\c
\&\|' inicializációs fájlban levő parancsokat. Ebben a fájlban levő
parancsok a parancssori argumentumok feldolgozása után hajtódnak végre.

.TP
.B \-quiet
.TP
.B \-q
``Csöndes''. Nem írja ki a bevezető és szerzői joggal kapcsolatos
üzeneteket. Ezek a üzenetek szintén nem íródnak ki kötegelt feldolgozás
során.

.TP
.B \-batch
Kötegelt feldolgozás. A program \c
.B 0\c
\&-s értékkel lép ki az `\|\c
.B \-x\c
\&\|'-szel megadott parancsfile-ok (és a `\|\c
.B .gdbinit\c
\&\|' file, ha nincs letiltva) feldolgozása után. Nem-nulla értékkel akkor
lép ki, ha hiba következik be parancsfile-okban található GDB parancsok 
végrehajtásakor.

A kötegelt feldolgozás akkor lehet hasznos, ha a GDB szűrőként fut, például
hogy letöltsön és futtasson egy programot egy másik számítógépen. Azért,
hogy ez használhatóbb legyen, a 
.sp
.br
Program\ exited\ normally.
.br
.sp

üzenet (amely rendszerint akkor íródik ki, amikor egy GDB által futtatott
program kilép) nem íródik ki kötegelt feldolgozáskor.

.TP
.BI "\-cd=" "katalógus"\c
\&
A GDB munkakatalógusa a 
.I katalógus\c
\& legyen a jelenlegi helyett.

.TP
.B \-fullname
.TP
.B \-f
Az Emacs állítja be ezt az opciót, amikor alfolyamatként futtatja a GDB-t.
Ez arra készteti a GDB-t, hogy kiírja a teljes file nevet és sorszámot
szabványos, felismerhető formában minden alkalommal, amikor egy verem keret
kiíródik (amelybe beleértendő minden alkalom, amikor a program megáll). Ez a
felismerhető formátum a következőképpen néz ki: két `\|\c
.B \032\c
\&\|' karakter, amelyeket a file neve, a sor sorszáma és a karakter helye
követ kettőspontokkal elválasztva, majd egy újsor karakter. Az Emacs-GDB
csatolóprogram a két `\|\c
.B \032\c
\&\|' karaktert használja jelként a keret forráskódjának kiírásához.

.TP
.BI "\-b " "bps"\c
\&
Beállítja a soros csatoló vonali sebességét (baud szint vagy bit per
másodperc), amelyet a GDB használ távoli hibakereséshez.

.TP
.BI "\-tty=" "eszköz"\c
\&
A \c
.I eszköz\c
\& eszközt használja szabványos bemenetként és kimenetként.
.PP

.SH LÁSD MÉG
Az 
.B info\c
\& program 
.RB "`\|" gdb "\|'"
címszavaként; Richard M. Stallman and Roland H. Pesch: 
.I 
Using GDB: A Guide to the GNU Source-Level Debugger\c
, 1991 július. 

.SH MÁSOLÁS
Copyright (c) 1991 Free Software Foundation, Inc.
.PP
Megadjuk az engedélyt ezen kéziköny szó szerinti másolatainak létrehozására
és terjesztésére, amennyiben a szerzői jog címke és ez az engedély a
másolatokon is szerepel.
.PP
Megadjuk az engedélyt ezen kéziköny módosított másolatainak létrehozására
és terjesztésére a szó szerinti másolatokra vonatkozó feltételekkel,
amennyiben a módosítások eredményeképpen létrejövő kézikönyvet egy ezzel 
azonos engedély alatt terjesztik.
.PP
Megadjuk az engedélyt ezen kéziköny más nyelvekre lefordított változatainak
másolására és terjesztésére a fenti, módosításra vonatkozó feltételekkel,
kivéve, hogy ezen engedélynek a Free Software Foundation által jóváhagyott
fordítása szerepelhet az eredeti angol nyelvű változat helyett.
.Sh MAGYAR FORDÍTÁS
Szakács Gergely Márton <case@fornax.hu>