Provided by: manpages-pl_20060617-1_all bug

NAZWA

       gdb - Debugger GNU

SKŁADNIA

       gdb    [-help] [-nx] [-q] [-batch] [-cd=dir] [-f] [-b bps] [-tty=dev]
              [-s symfile] [-e prog] [-se prog] [-c core] [-x cmds] [-d dir]
              [prog[core|procID]]

OPIS

       Celem  [istnienia]  debuggera  takiego  jak  GDB  jest  umożliwienie ci
       oglądania, co dzieje się ``w  środku''  innego  programu  podczas  jego
       wykonywania się \mlub co inny program robił w momencie padu.

       GDB  może robić cztery podstawowe rzeczy (plus inne rzeczy, wspierające
       te), które mogą być pomocne w wychwytywaniu usterek:

          o   Uruchomić program,  podając  wszystko,  co  może  dotyczyć  jego
              zachowania.

          o   Doprowadzić  do zatrzymania programu przy określonych warunkach.

          o   Sprawdzić co się stało po zatrzymaniu programu.

          o   Zmienić rzeczy w programie  tak,  że  możesz  eksperymentować  z
              poprawianiem   efektów  jednej  usterki,  aby  przejść  dalej  i
              dowiedzieć się czegoś o reszcie.

       Możesz używac GDB do debuggowania  programów  napisanych  w  C,  C++  i
       Modula-2.    Wsparcie  dla  fortrana  zostanie  dodane  kiedy  zostanie
       ukończony jego kompilator GNU.

       GDB wywołuje się poleceniem powłoki gdb.   Po  uruchomieniu,  odczytuje
       komendy  z terminala, aż nie powiesz mu, że kończysz pracę, korzystając
       z komendy quit.  Możesz uzyskać pomoc on-line z samego gdb  ,  wpisując
       komendę help.

       Możesz    uruchomić    gdb    bez    argumentów   lub   opcji;   jednak
       najpopularniejszym  sposobem  uruchomienia  GDB  jest  jeden  lub   dwa
       argumenty, określające program wykonywalny jako argument:

       gdb program

       Możesz także uruchomić GDB zarówno z plikiem wykonywalnym, jak i z jego
       plikiem core:

       gdb program core

       Zamiast tego, możesz podać ID procesu (PID) jako kolejny argument. Robi
       się tak, kiedy chcesz debuggować pracujący proces:

       gdb program 1234

       podłączy  GDB  do procesu 1234 (chyba że posiadasz plik nazwany `1234';
       GDB szuka najpierw pliku core).

       Oto kilka z najczęściej używanych komend GDB:

       break [file:]function
               Ustaw breakpoint na funkcji function (w pliku file).

       run [arglist]
              Uruchom program (z  listą  argumentów  arglist,  jeśli  zostanie
              podana).

       bt     Backtrace: wyświetl stos programu.

       print expr
               Wydrukuj wartość wyrażenia.

       c      Kontynuuj   wykonywanie   programu   (po  zastopowaniu,  np.  na
              breakpointcie).

       next   Wykonaj  następną  linię  programu  (po   zastopowaniu);   pomi
              wszystkie [rozwinięcia] wywołań funkcji w linii.

       step   Wykonaj  następną linię programu (po zastopowaniu); rozwi każde
              wywołanie funkcji w linii.

       help [name]
              Pokaż dane o komendzie GDB name, lub ogólne informacje o  użyciu
              GDB.

       quit   Zakończ pracę z GDB.

       Jeśli  interesują  cię  pełne  detale  obsługi GDB, zobacz Using GDB: A
       Guide to the GNU Source-Level Debugger, Richarda M. Stallmana i Rolanda
       H. Pescha. Tenże tekst jest dostępny online jako wpis gdb programu info
       .

OPCJE

       Dowolne argumenty inne niż opcje określają plik wykonywalny i plik core
       (lub  ID  procesu);  tj.  pierwszy  argument,  który jest napotkany bez
       związanej flagi opcji jest równoważny z opcją  `-se'  ,  a  drugi  jest
       równoważny  z  opcją  `-c'  jeśli  jest  to nazwa pliku. Wiele opcji ma
       zarówno długie, jak i krótkie formy; tu  pokazane  są  obydwie.  Długie
       formy  są  także  rozpoznawane, jeśli skrócisz je do długości, w której
       opcja  pozostaje  rozstrzygalna.   (jeśli   wolisz,   możesz   flagować
       argumenty  opcyjne  używając  `+'  zamiast `-', choć opisujemy bardziej
       tradycyjną konwencję.)

       Wszystkie  opcjie  i  argumenty  linii  komend,  które   podajesz,   są
       przetwarzane  w  sekwencyjnej  kolejności.  kolejność powoduje różnicę,
       jeśli zostanie użyta opcja `-x' .

       -help

       -h     Wylistuj wszystkie opcje, wraz z krótkimi opisami.

       -symbols=file

       -s file
               Odczytaj tablicę symboli z pliku file.

       -exec=file

       -e file
               Użyj pliku file jako pliku  wykonywalnego  do  wykonania  kiedy
              potrzeba i do testowania czystych danych w połączeniu ze zrzutem
              core.

       -se=file
               Odczytaj tablicę symboli z pliku  file  i  użyj  go  jako  plik
              wykonywalny.

       -core=file

       -c file
               Użyj pliku file jako zrzut core do porównania.

       -command=file

       -x file
               Wywołaj komendy GDB z pliku file.

       -directory=directory

       -d directory
                Dodaj  katalog  directory  do  ścieżki  przeszukiwania  plików
              źródłowych.

       -nx

       -n     Nie  wywołuj  komend  z  żadnego  z   plików   inicjalizacyjnych
              `.gdbinit'  .   Normalnie,  komendy  z tych plików są wykonywane
              zaraz po przetworzeniu wszystkich argumentów linii komend.

       -quiet

       -q     ``Cicho''.  Nie drukuj wiadomości wprowadzających  i  o  prawach
              kopiowania. Te wiadomości sa także hamowane w trybie wsadowym.

       -batch Uruchom   w   trybie   wsadowym.   Zakończ   ze  statusem  0  po
              przetworzeniu  wszystkich  plików  komend  podanych  w  `-x'  (i
              `.gdbinit',  jeśli  go  nie  wyłączono).   Zakończ  ze  statusem
              niezerowym jeśli pojawił się  błąd  w  wywołaniu  komend  GDB  z
              plików komend.

              Tryb wsadowy może być użyteczny do uruchamiania GDB jako filtru,
              np. do załadowania i uruchomienia programu na innym  komputerze;
              w celu uczynienia tego bardziej użytecznym, wiadomość

              Program exited normally.

              (która  jest  normalnie produkowana za każdym razem, gdy program
              działający pod kontrolą GDB kończy pracę) nie jest wyświetlana w
              trybie wsadowym.

       -cd=directory
                Uruchom GDB, używając katalogu directory jako swojego katalogu
              roboczego, zamiast bieżącego katalogu.

       -fullname

       -f     Emacs ustawia tę opcję kiedy uruchamia GDB jako podproces.  Mówi
              GDB   aby   produkował   pełną  nazwę  pliku  i  numer  linii  w
              standardowym,  rozpoznawalnym  stylu   za   każdym   razem   gdy
              wyświetlana  jest klatka stosu (która jest załączana przy każdym
              zatrzymaniu programu). Ten rozpoznawalny program wygląda jak dwa
              znaki  ` 32'  za  którymi  następuje  nazwa pliku, numer linii i
              pozycja znakowa, oddzielona dwukorpkami i nową linią.  Interfejs
              Emacs-do-GDB   używa   dwóch   znaków  ` 32'  jako  sygnałów  do
              wyświetlenia kodu źródłowego dla klatki.

       -b bps  Ustaw szybkość linii (baud,  lub  bity  na  sekundę)  dowolnego
              interfejsu   szeregowego,   używanego  przez  GDB  dla  zdalnego
              debuggowania.

       -tty=device
               Uruchom się,  używając  urządzenia  device  jako  standardowego
              wejścia i wyjścia programu.

ZOBACZ TAKŻE

       Wpis `gdb' w info; Using GDB: A Guide to the GNU Source-Level Debugger,
       Richard M. Stallman i Roland H. Pesch, July 1991.

KOPIOWANIE

       (Autor nie życzy sobie tłumaczenie poniższej noty bez zatwierdzenia  ze
       strony FSF)

       Copyright (c) 1991 Free Software Foundation, Inc.

       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

       Permission  is granted to copy and distribute modified versions of this
       manual under the conditions for verbatim  copying,  provided  that  the
       entire  resulting  derived  work  is  distributed  under the terms of a
       permission notice identical to this one.

       Permission is granted to  copy  and  distribute  translations  of  this
       manual  into  another language, under the above conditions for modified
       versions, except  that  this  permission  notice  may  be  included  in
       translations approved by the Free Software Foundation instead of in the
       original English.