Provided by: manpages-es-extra_0.8a-17_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'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.