.\" 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 Eszkzk" "GNU Eszkzk"
.SH NV
gdb \- A GNU hibakeres
.SH SSZEGZS
.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 LERS
Egy olyan hibakeres, mint a GDB, clja az, hogy betekintst nyjtson egy
msik program ``belsejbe'', mikzben az fut\(em\&vagy arra, hogy mit
csinlt egy msik program abban a pillanatban, amikor sszeomlott.

A GDB ngy f dologra kpes (s mg nhny egybre is e ngy dolog tmogatshoz),
amelyek segtenek a mkds kzben val hibakeressben:

.TP
\ \ \ \(bu
Elindtja a programot, meghatroz brmely olyan dolgot, amely
befolysolhatja a mkdst.

.TP
\ \ \ \(bu
Meglltja a programot meghatrozott krlmnyek bekvetkeztekor.

.TP
\ \ \ \(bu
Megvizsglja, hogy mi trtnt, amikor a program megllt.

.TP
\ \ \ \(bu
Megvltoztat dolgokat a programban, hogy ksrletezni lehessen a hiba
kvetkezmnyeinek kijavtsa rdekben, s folytathassa a munkt egy msik hibn.
.PP

A GDB C, C++, s Modula-2 nyelv programok hibinak keressre hasznlhat.
Amint a GNU Fortran fordt elkszl, a GDB a Fortran-t is tmogatni fogja.

A GDB-t a \c
.B gdb\c
\& shell paranccsal kell elindtani. Ha elindult, a parancsokat a terminlrl 
olvassa be, egszen addig, amg ki nem lp a \c
.B quit\c
\& parancs hatsra. Sgt a \c
.B help\c
\& paranccsal kaphat.

A \c
.B gdb\c
\& elindthat argumentumok vagy opcik nlkl is; de a leggyakoribb mdja a
GDB elindtsnak egy vagy kt argumentummal trtnik, egy futtathat
programot adva meg argumentumknt:
.sp
.br
gdb\ program
.br
.sp

Elindthat tovbb egy futtathat program s egy core file megadsval:
.sp
.br
gdb\ program\ core
.br
.sp


A core file helyett megadhat egy process azonost msodik argumentumknt, ha egy
mr fut programban kell hibt keresni:
.sp
.br
gdb\ program\ 1234
.br
.sp

ez a parancs hozzkti a GDB-t a \c
.B 1234-as\c
\& folyamathoz (hacsak nincs mr egy `\|\c
.B 1234\c
\&\|' nev file; a GDB elszr a core file jelenltt ellenrzi).

Alant a leggyakrabban szksges GDB parancsok tallhatk:

.TP
.B break \fR[\|\fIfile\fB:\fR\|]\fIfggvny
\&
Trspontot llt be a \c
.I fggvny el\c
\& (a \c
.I file\c
\&-ban).
.TP
.B run \fR[\|\fIargumentum lista\fR\|]
Elindtja a programot (\c
.I argumentum list\c
\&val, ha meg lett adva).
.TP
.B bt
Visszakvets: kirja a programvermet.
.TP
.BI print " kifejezs"\c
\&
Kirja egy kifejezs rtkt.
.TP
.B c
A program futsnak folytatsa (meglls utn, pl. trspontnl).
.TP
.B next
A kvetkez programsor futtatsa (meglls utn); \c
.I tlpi\c
\& a sorban lev fggvnyhvst.
.TP
.B step
A kvetkez programsor futtatsa (meglls utn); \c
.I belp\c
\& a sorban lev fggvnybe.
.TP
.B help \fR[\|\fInv\fR\|]
Sgt r ki a 
.I nv\c
\& nev GDB parancsrl, vagy ltalnos informcit a GDB hasznlatrl.
.TP
.B quit
Kilp a GDB-bl.
.PP
Rszletekbe men informcikrt lsd: Richard M. Stallman s Roland H.
Pesch:
.I 
Using GDB: A Guide to the GNU Source-Level Debugger\c
\&. A knyv elrhet online az \c
.B info\c 
\& program \c
.B gdb\c
\& cmszavaknt.

.SH OPCIK
Brmely olyan argumentum, amely nem opci, egy futtathat fjlt s egy core
file-t (vagy folyamat azonostt) hatroz meg; azaz az els olyan argumentum,
amelyhez nem ktdik opci, megegyzik a `\|\c
.B \-se\c
\&\|' opcival, s a msodik, ha van ilyen, megegyezik a `\|\c
.B \-c\c
\&\|' opcival, ha van ilyen nev file. Sok opcinak van hossz s rvid
formja, itt mindkettt megadtuk. A hossz opcik csonktott
formban is elfogadhatak, amennyiban a hosszuk elegend az egyrtelm
azonostshoz. (Ha gy tetszik, az opci jellhet `\|\c
.B +\c
\&\|'-szal `\|\c
.B \-\c
\&\|' helyett, de mi itt a megszokottabb jellst hasznljuk.)

A GDB egyms utn dolgozza fel az sszes opcit s parancssori argumentumot.
Szmt a sorrend, ha a 
`\|\c
.B \-x\c
\&\|' opci is szerepel.

.TP
.B \-help
.TP
.B \-h
Felsorolja az sszes opcit rvid magyarzattal.

.TP
.BI "\-symbols=" "file"\c
.TP
.BI "\-s " "file"\c
\&
A \c
.I file\c
\& nev fjlbl olvassa be a szimblum tblt.

.TP
.B \-write
A futtathat s a core fjlba trtn rs engedlyezse.

.TP
.BI "\-exec=" "file"\c
.TP
.BI "\-e " "file"\c
\&
A \c
.I file\c
\& nev fjlt hsznlja futtathatknt amennyiben az arra alkalmas, s egy core dumppal
kapcsolatban nyers adatknt.

.TP
.BI "\-se=" "file"\c
\&
A szimblum tblt a \c
.I file\c
\& nev fjlbl veszi, s hasznlja ugyan ezt a fjlt, futtathatknt.

.TP
.BI "\-core=" "file"\c
.TP
.BI "\-c " "file"\c
\&
Hasznlja a \c
.I file\c
\& nev fjlt core dump-nak.

.TP
.BI "\-command=" "file"\c
.TP
.BI "\-x " "file"\c
\&
A GDB parancsokat a \c
.I file\c
\& nev fjlbl olvassa.

.TP
.BI "\-directory=" "katalgus"\c
.TP
.BI "\-d " "directory"\c
\&
Adja hozz a \c
.I katalgus\c
\& katalgust az elrsi tvonalhoz forrsfile-ok keresshez.
.PP

.TP
.B \-nx
.TP
.B \-n
Ne futtassa a `\|\c
.B .gdbinit\c
\&\|' inicializcis fjlban lev parancsokat. Ebben a fjlban lev
parancsok a parancssori argumentumok feldolgozsa utn hajtdnak vgre.

.TP
.B \-quiet
.TP
.B \-q
``Csndes''. Nem rja ki a bevezet s szerzi joggal kapcsolatos
zeneteket. Ezek a zenetek szintn nem rdnak ki ktegelt feldolgozs
sorn.

.TP
.B \-batch
Ktegelt feldolgozs. A program \c
.B 0\c
\&-s rtkkel lp ki az `\|\c
.B \-x\c
\&\|'-szel megadott parancsfile-ok (s a `\|\c
.B .gdbinit\c
\&\|' file, ha nincs letiltva) feldolgozsa utn. Nem-nulla rtkkel akkor
lp ki, ha hiba kvetkezik be parancsfile-okban tallhat GDB parancsok 
vgrehajtsakor.

A ktegelt feldolgozs akkor lehet hasznos, ha a GDB szrknt fut, pldul
hogy letltsn s futtasson egy programot egy msik szmtgpen. Azrt,
hogy ez hasznlhatbb legyen, a 
.sp
.br
Program\ exited\ normally.
.br
.sp

zenet (amely rendszerint akkor rdik ki, amikor egy GDB ltal futtatott
program kilp) nem rdik ki ktegelt feldolgozskor.

.TP
.BI "\-cd=" "katalgus"\c
\&
A GDB munkakatalgusa a 
.I katalgus\c
\& legyen a jelenlegi helyett.

.TP
.B \-fullname
.TP
.B \-f
Az Emacs lltja be ezt az opcit, amikor alfolyamatknt futtatja a GDB-t.
Ez arra kszteti a GDB-t, hogy kirja a teljes file nevet s sorszmot
szabvnyos, felismerhet formban minden alkalommal, amikor egy verem keret
kirdik (amelybe belertend minden alkalom, amikor a program megll). Ez a
felismerhet formtum a kvetkezkppen nz ki: kt `\|\c
.B \032\c
\&\|' karakter, amelyeket a file neve, a sor sorszma s a karakter helye
kvet kettspontokkal elvlasztva, majd egy jsor karakter. Az Emacs-GDB
csatolprogram a kt `\|\c
.B \032\c
\&\|' karaktert hasznlja jelknt a keret forrskdjnak kirshoz.

.TP
.BI "\-b " "bps"\c
\&
Belltja a soros csatol vonali sebessgt (baud szint vagy bit per
msodperc), amelyet a GDB hasznl tvoli hibakeresshez.

.TP
.BI "\-tty=" "eszkz"\c
\&
A \c
.I eszkz\c
\& eszkzt hasznlja szabvnyos bemenetknt s kimenetknt.
.PP

.SH LSD MG
Az 
.B info\c
\& program 
.RB "`\|" gdb "\|'"
cmszavaknt; Richard M. Stallman and Roland H. Pesch: 
.I 
Using GDB: A Guide to the GNU Source-Level Debugger\c
, 1991 jlius. 

.SH MSOLS
Copyright (c) 1991 Free Software Foundation, Inc.
.PP
Megadjuk az engedlyt ezen kzikny sz szerinti msolatainak ltrehozsra
s terjesztsre, amennyiben a szerzi jog cmke s ez az engedly a
msolatokon is szerepel.
.PP
Megadjuk az engedlyt ezen kzikny mdostott msolatainak ltrehozsra
s terjesztsre a sz szerinti msolatokra vonatkoz felttelekkel,
amennyiben a mdostsok eredmnyekppen ltrejv kziknyvet egy ezzel 
azonos engedly alatt terjesztik.
.PP
Megadjuk az engedlyt ezen kzikny ms nyelvekre lefordtott vltozatainak
msolsra s terjesztsre a fenti, mdostsra vonatkoz felttelekkel,
kivve, hogy ezen engedlynek a Free Software Foundation ltal jvhagyott
fordtsa szerepelhet az eredeti angol nyelv vltozat helyett.
.Sh MAGYAR FORDTS
Szakcs Gergely Mrton <case@fornax.hu>