Provided by:
manpages-es-extra_0.8a-17_all 
NOMBRE
gdb - El depurador GNU
SINOPSIS
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]]
DESCRIPCI'ON
El proposito de un depurador como GDB es permitir al usuario ver lo que
esta ocurriendo ``dentro'' de otro programa mientras que se esta
ejecutando -- o lo que estaba haciendo en el momento que fallo.
GDB puede hacer cuatro tipo de cosas (mas otras cosas para dar soporte
a estas) para ayudarte a capturar errores en el acto:
o Comenzar tu programa, especificando cualquier cosa que pueda
afectar a su comportamiento.
o Hacer que tu programa se pare al cumplirse las condiciones
especificadas.
o Examinar que ha pasado, cuando tu programa se ha parado.
o Cambiar cosas de tu programa, de tal manera que puedas
experimentar corrigiendo los efectos de un fallo y continuar
para descubrir otros.
Puedes usar GDB para depurar programas escritos en C, C++, y Modula-2.
El soporte para Fortran se anadira cuando este listo un compilador GNU
Fortran.
GDB se invoca con la orden de shell gdb. Una vez comenzado, lee
ordenes del terminal hasta que le dices que salga con la orden GDB
quit. Usando la orden help puedes obtener una ayuda directa del gdb.
Se puede ejecutar gdb sin argumentos ni opciones; pero la manera mas
comun de comenzar GDB es con uno o dos argumentos, especificando un
programa ejecutable con el argumento:
gdb programa
Tambien puedes comenzar con un programa ejecutable y un fichero core
especifico:
gdb programa core
Puedes, en su lugar, especificar un ID de proceso como segundo
argumento, si quieres depurar un proceso en ejecucion:
gdb programa 1234
ligaria GDB al proceso 1234 (al menos que tambien tengas un fichero
denominado `1234'; GDB busca un fichero core en primer lugar).
Aqui estan las ordenes mas frecuentemente necesitadas en GDB:
break [fichero:]funci'on
Pone un punto de ruptura en funci'on (en fichero).
run [arglist]
Comienza tu programa (con arglist, si se especifica).
bt Backtrace: muestra la pila del programa.
print expr
Muestra el valor de una expresion.
c Continua ejecutando tu programa (despues de parar, p.e. en un
punto de ruptura).
next Ejecuta la siguiente linea del programa (despues de parar); pasa
sobre cualquier llamada a funcion que apareciera en la linea.
step Ejecuta la siguiente linea del programa (despue de parar);
entrando en cualquier llamada a funcion que apareciera en la
linea.
help [nombre]
Muestra informacion sobre la orden GDB nombre, o informacion
general sobre como utilizar GDB.
quit Salir de GDB.
Para todos los detaller sobre GDB, vease Using GDB: A Guide to the GNU
Source-Level Debugger, by Richard M. Stallman and Roland H. Pesch. El
mismo texto esta disponible en linea como la entrada gdb en el programa
info.
OPCIONES
Cualquier argumento distinto de las opciones indica un fichero
ejecutable y un fichero core (o un ID de proceso); es decir, el primer
argumento encontrado si la bandera de opcion asociada es equivalente a
la opcion `-se', y el segundo, si existe, es equivalente a la opcion
`-c' si es el nombre de un fichero. Muchas opciones tienen tanto
formato largo como corto; ambos se muestra aqui. Los formatos largos
tambien se reconocen si los truncas, siempre que sea lo suficientemente
largo para que la opcion que representa no sea ambigua. (Si lo deseas,
puedes indicar los argumentos de opcion con `+' en lugar de `-',
aunque nosotros mostramos la convencion mas usual.)
Todas las opciones y argumentos en la linea de ordenes que des se
procesann en orden secuencial. El orden es importante cuando se usa la
opcion `-x'.
-help
-h Lista todas las opciones, con explicaciones breves.
-symbols=fichero
-s fichero
Lee la tabla de simbolos del fichero fichero.
-exec=fichero
-e fichero
Usa el fichero fichero como el fichero ejecutable a ejecutar
cuando sea adecuado, y para examinar los datos puros en union
con un volcado core.
-se=fichero
Lee la tabla de simbolos del fichero fichero y la usa como el
fichero ejecutable.
-core=fichero
-c fichero
Usa el fichero fichero como un volcado core para examinar.
-command=fichero
-x fichero
Ejecuta las ordenes GDB del fichero fichero.
-directory=directorio
-d directorio
Anade directorio al camino de busqueda de los ficheros fuente.
-nx
-n No ejecuta las ordenes de ningun fichero de inicializacion
`.gdbinit'. Normalmente, las ordenes de estos ficheros se
ejecutan despues de que todas las opciones de comando y los
argumentos hayan sido procesados.
-quiet
-q ``Quiet''. No imprime los mensajes introductorios y de
copyright. Estos mensajes tambien se suprimen en el modo de
trabajo por lotes.
-batch Se ejecuta en modo trabajo por lotes. Finaliza con estado 0
despues de procesar todos los ficheros de ordenes especificados
con `-x' (y `.gdbinit', si no esta inhibido). Finaliza con un
estado distinto del cero si ocurre un error durante la ejecucion
de las ordenes GDB en los ficheros de ordenes.
El modo de trabajo por lotes puede ser util cuando se ejecuta
GDB como un filtro, pot ejemplo para bajarse y ejecutar un
programa en otro ordenador; para hacer que sea mas util, el
mensaje
Program exited normally.
(que se muestra normalmente siempre que un programa ejecutandose
bajo el control de GDB termina) no se muestra cuando se ejecuta
en modo de trabajo por lotes.
-cd=directorio
Ejecuta GDB usando directorio como directorio de trabajo, en
lugar del directorio actual.
-fullname
-f Emacs activa esta opcion cuando ejecuta GDB como un subproceso.
Indica al GDB que saque el nombre completo del fichero y el
numero de linea de manera estandar y reconocible cada vez que se
muestra una porcion de pila (lo que incluye cada vez que el
programa se para). Este formato reconocible se parece a do
caracteres ` 32', seguidos del nombre del fichero, el numero de
linea y la posicion del caracter separados por comas, y una
nueva linea. El programa de interface Emacs-a-GDB usa los dos
caracteres program uses the two ` 32' como una senal para mostra
el codigo fuente para la porcion.
-b bps Fija la velocidad de la linea (ratio de baudios o bits por
segundo) de cualquier interface serie usado por GDB para la
depuracion remota.
-tty=dispositivo
Se ejecuta usando dispositivo como la entrada y salida estandar
de tu programa.
V'EASE TAMBI'EN
Entrada `gdb' en info; Using GDB: A Guide to the GNU Source-Level
Debugger, Richard M. Stallman and Roland H. Pesch, July 1991.
COPYING
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.