Provided by: manpages-es-extra_0.8a-14ubuntu1_all bug

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ÓN

       El proposito de un depurador como GDB es permitir al usuario ver lo que
       está ocurriendo ‘‘dentro’’  de  otro  programa  mientras  que  se  está
       ejecutando — o lo que estaba haciendo en el momento que falló.

       GDB  puede hacer cuatro tipo de cosas (más otras cosas para dar soporte
       a éstas) para ayudarte a capturar errores en el acto:

          ·   Comenzar tu programa, especificando  cualquier  cosa  que  pueda
              afectar a su comportamiento.

          ·   Hacer  que  tu  programa  se  pare  al cumplirse las condiciones
              especificadas.

          ·   Examinar que ha pasado, cuando tu programa se ha parado.

          ·   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 añadirá cuando esté listo un compilador GNU
       Fortran.

       GDB se invoca con la orden  de  shell  gdb.   Una  vez  comenzado,  lee
       órdenes  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  más
       común  de  comenzar  GDB  es con uno o dos argumentos, especificando un
       programa ejecutable con el argumento:

       gdb programa

       También puedes comenzar con un programa ejecutable y  un  fichero  core
       específico:

       gdb programa core

       Puedes,  en  su  lugar,  especificar  un  ID  de  proceso  como segundo
       argumento, si quieres depurar un proceso en ejecución:

       gdb programa 1234

       ligaría GDB al proceso 1234 (al menos que  también  tengas  un  fichero
       denominado ‘1234’; GDB busca un fichero core en primer lugar).

       Aquí están las ordenes más frecuentemente necesitadas en GDB:

       break [fichero:]funcin
               Pone un punto de ruptura en funcin (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 expresión.

       c      Continua  ejecutando  tu  programa (después de parar, p.e. en un
              punto de ruptura).

       next   Ejecuta la siguiente línea del programa (después de parar); pasa
              sobre cualquier llamada a función que apareciera en la línea.

       step   Ejecuta  la  siguiente  línea  del  programa  (despué de parar);
              entrando en cualquier llamada a función  que  apareciera  en  la
              línea.

       help [nombre]
              Muestra  información  sobre  la  orden GDB nombre, o información
              general sobre como utilizar GDB.

       quit   Salir de GDB.

       Para todos los detaller sobre GDB, véase Using GDB: A Guide to the  GNU
       Source-Level  Debugger, by Richard M. Stallman and Roland H. Pesch.  El
       mismo texto está disponible en línea 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 opción asociada es equivalente a
       la opción ‘-se’, y el segundo, si existe, es equivalente  a  la  opción
       ‘-c’  si  es  el  nombre  de  un fichero.  Muchas opciones tienen tanto
       formato largo como corto; ambos se muestra aquí.  Los  formatos  largos
       también se reconocen si los truncas, siempre que sea lo suficientemente
       largo para que la opción que representa no sea ambigüa.  (Si lo deseas,
       puedes  indicar  los  argumentos  de  opción con ‘+’ en  lugar de  ‘-’,
       aunque nosotros mostramos la convención más usual.)

       Todas las opciones y argumentos en la  línea  de  ordenes  que  des  se
       procesann  en orden secuencial. El orden es importante cuando se usa la
       opción ‘-x’.

       -help

       -h     Lista todas las opciones, con explicaciones breves.

       -symbols=fichero

       -s fichero
               Lee la tabla de símbolos 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 unión
              con un volcado core.

       -se=fichero
               Lee la tabla de símbolos 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
                Añade directorio al camino de búsqueda de los ficheros fuente.

       -nx

       -n     No ejecuta las  ordenes  de  ningún  fichero  de  inicialización
              ‘.gdbinit’.   Normalmente,  las  ordenes  de  estos  ficheros se
              ejecutan después 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 también se suprimen en  el  modo  de
              trabajo por lotes.

       -batch Se  ejecuta  en  modo  trabajo por lotes.  Finaliza con estado 0
              después de procesar todos los ficheros de ordenes  especificados
              con  ‘-x’  (y ‘.gdbinit’, si no está inhibido).  Finaliza con un
              estado distinto del cero si ocurre un error durante la ejecución
              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 más útil, el
              mensaje

              Program exited normally.

              (que se muestra normalmente siempre que un programa ejecutándose
              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 opción cuando ejecuta GDB como un subproceso.
              Indica al GDB que saque el nombre  completo  del  fichero  y  el
              número de línea de manera estándar y reconocible cada vez que se
              muestra una porción 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 número  de
              línea  y  la  posición  del  caracter separados por comas, y una
              nueva línea.  El programa de interface Emacs-a-GDB usa  los  dos
              caracteres program uses the two ‘ 32’ como una señal para mostra
              el código fuente para la porción.

       -b bps  Fija la velocidad de la línea (ratio  de  baudios  o  bits  por
              segundo)  de  cualquier  interface  serie  usado por GDB para la
              depuración remota.

       -tty=dispositivo
               Se ejecuta usando dispositivo como la entrada y salida estándar
              de tu programa.

VÉASE TAMBIÉN

       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.