summaryrefslogtreecommitdiffstats
path: root/tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook
diff options
context:
space:
mode:
Diffstat (limited to 'tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook')
-rw-r--r--tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook339
1 files changed, 339 insertions, 0 deletions
diff --git a/tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook b/tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook
new file mode 100644
index 00000000000..e82b35ee638
--- /dev/null
+++ b/tde-i18n-et/docs/kdevelop/kdevelop/debugger.docbook
@@ -0,0 +1,339 @@
+<chapter id="debugger">
+<title
+>Siluriliides</title>
+<indexterm zone="debugger"
+><primary
+>silur</primary
+></indexterm>
+
+<para
+>C ja C++ programmeerimise jaoks sisaldab &kdevelop; seesmist, otseselt redaktoriga põimitud silurit. Tehniliselt kujutab see endast &GNU; siluri <application
+>gdb</application
+> kasutajaliidest. Siluri saab käivitada mitmel moel: </para>
+
+<itemizedlist>
+<listitem>
+<para
+>Menüükäsuga <menuchoice
+><guimenu
+>Silumine</guimenu
+><guimenuitem
+>Käivita</guimenuitem
+></menuchoice
+> laetakse sinu projekti põhiprogramm silurisse. </para>
+</listitem>
+
+<listitem>
+<para
+>Menüükäsuga <menuchoice
+><guimenu
+>Silumine</guimenu
+> <guimenuitem
+>Käivita (muu)</guimenuitem
+> <guimenuitem
+>Uuri core-faili</guimenuitem
+></menuchoice
+> saab laadida mällu core-faili, mille loob operatsioonisüsteemi kernel, kui programmi tabab krahh (core-faili tekitamine võib olla küll sinu süsteemis välja lülitatud, vaata <application
+>ulimit(1)</application
+>). Sellest on abi programmi nii-öelda surmajärgseks uurimiseks. </para>
+</listitem>
+
+<listitem>
+<para
+>Menüükäsuga <menuchoice
+><guimenu
+>Silumine</guimenu
+> <guimenuitem
+>Käivita (muu)</guimenuitem
+> <guimenuitem
+>Seonda protsessiga</guimenuitem
+></menuchoice
+> saab siluri välja kutsuga juba töötava rakenduse jaoks. Sulle näidatakse protsesside nimekirja, kus saad valida protsessi, mille silur peab enda hooleks võtma. </para>
+</listitem>
+
+<listitem>
+<para
+>Pane tähele, et silumine on võimalik ainult siis, kui projekt on kompileeritud silumisinfot lubades. Selle saab sisse lülitada dialoogis <guibutton
+>Kompilaatori seadistused</guibutton
+>. Kui see valik on sisse lülitatud, tekitab kompilaator lisaandmed, mis lubavad siluril siduda failinimed ja reanumbrid käivitatava faili aadressidega. </para>
+</listitem>
+</itemizedlist>
+
+<para
+>Siluriliides pakub mitut vaadet protsessi <quote
+>sisse</quote
+>: </para>
+
+<para
+>Kui üritad siluda ilma silumisinfota projekti, näed olekuribal teadet <computeroutput
+>No source...</computeroutput
+> Kui üritad määrata katkestuspunkti, näed katkestuspunktide aknas (vaata allpool) teadet <computeroutput
+>Ootel (lisa)</computeroutput
+>. </para>
+
+<variablelist>
+<varlistentry>
+<term
+>Muutujad</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>muutujate jälgimine</primary
+></indexterm>
+<para
+>See aken näitab kõigi kohalike muutujate väärtusi programmi täitmise hetkeasukohas. See hõlmab muutujaid kogu väljakutsete pinus, &ie; funktsiooni, kus protsess katsestati, funktsiooni, mis selle funktsiooni välja kutsus, ja nii edasi kuni funktsioonini <function
+>main()</function
+>. </para>
+
+<para
+>Muutujate teine haru sisaldab jälgitavaid muutujaid. Seda, milliseid muutujaid siin näeb, saad ise määrata. Jälgida saab nii kohalikke kui ka globaalseid muutujaid. Muutujaid saab lisada kas klõpsuga nupule <guibutton
+>Lisa</guibutton
+> või vajutades klahvi <keycap
+>Return</keycap
+> ajal, mil valitud on mõni element harus <guilabel
+>Jälgimine</guilabel
+>. Kontekstimenüüga saab muutujaid ka eemaldada. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>Pinuvaade</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>pinuvaade</primary
+></indexterm>
+<para
+>(... veel kirjutamata ...) </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>Katkestuspunktid</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>katkestuspunktid</primary
+></indexterm>
+<para
+>See aken võimaldab näha katkestuspunkte ja nendega üht-teist ette võtta. Pane tähele, et &kdevelop; kasutab <application
+>GDB</application
+>-d, mistõttu &kdevelop;i silumisvõimaluste täielikuks mõistmiseks oleks kasulik omada mingit ülevaadet <ulink url="http://www.gnu.org/software/gdb"
+>GDB-st</ulink
+>. </para>
+
+<para
+>Kui soovid näha lähtekoodi, siis katkestuspunktid on defineeritud failis <filename
+>kdevelop/languages/cpp/debugger/breakpoint.h</filename
+>. </para>
+
+<para
+>Akna vasakus servas on mõned nupud:</para>
+
+<itemizedlist>
+<listitem
+><para
+>Lisa tühi katkestuspunkt</para
+></listitem>
+<listitem
+><para
+>Muuda valitud katkestuspunkti</para
+></listitem>
+ <listitem
+><para
+>Kustuta valitud katkestuspunkt</para
+></listitem>
+<listitem
+><para
+>Eemalda kõik katkestuspunktid</para
+></listitem>
+</itemizedlist>
+
+<para
+>Akna põhiosa koosneb seitsme veeruga tabelist. Iga tabeli rida tähistab katkestuspunkti. Veerud on järgmised:</para>
+
+<orderedlist>
+<listitem
+><para
+>Valikukast</para
+></listitem>
+<listitem
+><para
+>Tüüp: kas vigane, fail:rida, jälgimispunkt, aadress või funktsioon</para
+></listitem>
+<listitem
+><para
+>Olek. Väärtused on järgmised:</para>
+<itemizedlist>
+ <listitem
+><para
+>Aktiivne</para
+></listitem>
+ <listitem
+><para
+>Keelatud: iga katkestuspunkt võib olla <quote
+>lubatud</quote
+> või <quote
+>keelatud</quote
+>; viimasel juhul ei mõjuta see sinu programmi, kuni sa seda taas ei aktiveeri.</para
+></listitem>
+ <listitem
+><para
+>Ootel (lisa): katkestuspunkt märgitakse nii juhul, kui silumisinfot pole saadaval. GDB info-lehekülg selgitab seda nii: <blockquote
+><para
+>Kui määratud katkestuspunkti asukohta ei leita, võib tegemist olla asjaoluga, et asukoht paikneb jagatud teegis, mis pole veel laaditud. Sel juhul võib GDB luua spetsiaalse katkestuspunkti (nimetatakse <quote
+>ootel katkestuspunktiks</quote
+>), mis üritab end lahendada tulevikus, kui laaditakse vajalik jagatud teek.</para
+></blockquote
+> </para
+></listitem>
+</itemizedlist>
+</listitem>
+<listitem
+><para
+>Ootel (puhasta)</para
+></listitem>
+<listitem
+><para
+>Ootel (muuda)</para
+></listitem>
+<listitem
+><para
+>Asukoht kujul failinimi:reanumber</para
+></listitem>
+<listitem
+><para
+>Tingimus</para
+></listitem>
+<listitem
+><para
+>Ignoreerimiste arv: kui arv <varname
+>COUNT</varname
+> on suurem kui null, siis järgmisel <varname
+>COUNT</varname
+> korral, mil katkestuspunktini jõutakse, ei katkestada programmi täitmist; <application
+>gdb</application
+> ei tee sel juhul muud, kui ainult kahandab ignoreerimiste arvu.</para
+></listitem>
+<listitem
+><para
+>Päringuid: näitab, mitu korda on katkestuspunktini jõutud.</para
+></listitem>
+</orderedlist>
+
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>Pöördtransleerimine</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>pöördtransleerimine</primary
+></indexterm>
+<para
+>(... veel kirjutamata ...)</para>
+
+</listitem>
+</varlistentry>
+</variablelist>
+
+
+<sect1 id="settingbreakpoints">
+<title
+>Katkestuspunktide määramine</title>
+
+<para
+>(... veel kirjutamata ...) </para>
+
+</sect1
+> <!-- settingbreakpoints -->
+
+<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
+
+<sect1 id ="debuggeroptions">
+<title
+>Seadistused</title>
+
+<variablelist>
+<varlistentry>
+<term
+>Segatud nimede näitamine</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>nimede segamine</primary
+></indexterm>
+<indexterm zone="debugger"
+><primary
+>segamine</primary
+><secondary
+>nimi</secondary
+></indexterm>
+
+<para
+>C++ korral on funktsioonide nimed käivitatavas failis <quote
+>segatud</quote
+>, &ie; funktsioonide nimed sisaldavad infot argumentide tüüpide kohta. See on vajalik funktsioonide ülelaadimise toetuseks. Segamisalgoritm pole standardiseeritud ning on erinevates &GNU; C++ kompilaatorites erinev. </para>
+
+<para
+>Pöördassembleerimise aknas näidatakse tavaliselt segamata nimesid, nii et funktsioonide signatuurid on samasugused nagu lähtekoodis, et neid oleks hõlpus lugeda. Aga soovi korral võid lasta näidata ka segatud nimesid. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>Teegi laadimiselpüütakse seada katkestuspunkte</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>laisad katkestuspunktid</primary
+></indexterm>
+<indexterm zone="debugger"
+><primary
+>katkestuspunktid</primary
+><secondary
+>laisk</secondary
+></indexterm>
+
+<para
+>Siluri taustaprogramm <application
+>gdb</application
+> ei luba seada katkestuspunkte koodis, mis ei ole parajasti laaditud. Suure moodulite arvuga rakenduses, kus kood laaditakse tihtipeale ainult nõudmisel pluginana (kasutades libc funktsiooni <function
+>dlopen(3)</function
+>), ei pruugi see just mugav olla. Seepörast toetab &kdevelop; omalt poolt katkestuspunkte jagatud teekides. Selle valiku sisselülitamisel saab seada katkestuspunkte teekides, mis ei ole laetud. Kui seejärel <application
+>gdb</application
+> tuvastab, et teek on laaditud, püüab &kdevelop; seada ootel katkestuspunktid. </para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+>Liikuva tööriistariba lubamine</term>
+<listitem>
+<indexterm zone="debugger"
+><primary
+>siluririba</primary
+></indexterm>
+<indexterm zone="debugger"
+><primary
+>tööriistariba</primary
+><secondary
+>silur</secondary
+></indexterm>
+
+<para
+>(... veel kirjutamata ...) </para>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</sect1
+> <!-- debuggeroptions -->
+
+</chapter
+> <!-- debugger -->