     [file config-local.texi not included]

Una Introducción a GCC
**********************

Este manual proporciona una introducción a los Compiladores de GNU de C y C++, gcc y g++, que son parte de la Colección de Compiladores de GNU (GCC).

El desarrollo de este manual fué realizado enteramente por Network Theory Ltd (http://www.network-theory.co.uk/). Las copias publicadas por Network Theory Ltd traerán dinero para más documentación libre.

Introducción
************

El propósito de este libro es explicar el uso de los compiladores de GNU C y C++, gcc y g++. Después de leer este libro se comprenderá como compilar un programa y, cómo usar las opciones básicas del compilador para optimización y depuración. Este libro no intenta enseñar los lenguajes C o C++ en sí, este material puede ser encontrado en muchos otros lugares (see Lectura adicional).

Los programadores experimentados que están familiarizados con otros sistemas, pero son nuevos en compiladores GNU, pueden saltarse las primeras secciones de los capítulos ``Compilando un programa C'', ``Usando el preprocesador'' y ``Compilando un programa C++''. Las secciones y capítulos restantes proporcionan una buena visión del conjunto de las funcionalidades de GCC para aquellos que ya saben cómo usar otros compiladores.

Una breve historia de GCC
=========================

El autor original del Compilador de C de GNU (GCC) es Richard Stallman, el fundador del Proyecto GNU.

El Proyecto GNU fué iniciado en 1984 para crear un sistema operativo basado en software libre similar a UNIX y, así promover la libertad y la cooperación entre usarios de ordenadores y programadores. Cualquier sistema operativo basado en UNIX necesita un compilador de C, y no había compiladores libres en ese momento, el Proyecto GNU debía desarrollar uno desde cero. Este trabajo fué financiado por donaciones de individuos y compañias a través de la Free Software Foundation, una organización sin ánimo de lucro destinada a dar soporte al trabajo del Proyecto GNU.

La primera entrega de GCC fué hecha en 1987. Esto fué un significativo progreso, siendo el primer compilador portable para optimizar ANSI C liberado como software libre. Desde este momento GCC ha llegado a ser uno de las más importantes herramientas en el desarrollo de software libre.

Un avance importante en el compilador llega con la serie 2.0 en 1992, que añade la capacidad de compilar C++. En 1997, se creó una rama experimental del compilador (EGCS) para mejorar la optimización y el soporte de C++. Después de este trabajo, EGCS fué adoptado como la principal línea de desarrollo de GCC y, estas funcionalidades llegaron a estar ampliamente disponibles en la versión 3.0 de GCC en 2001.

A través del tiempo GCC ha sido extendido para dar soporte a muchos lenguajes adicionales, incluyendo Fortran, ADA, Java y Objective-C. El acrónimo GCC es ahora usado para referir al ``GNU Compiler Collection'' (Colección de Compiladores de GNU). Su desarrollo está guiado por el GCC Steering Committee, un grupo compuesto de representantes de las comunidades de usuarios/as de GCC en la industria, la investigación y la academia.

Importantes características de GCC
==================================

Esta sección describe algunas de las más importantes funcionalidades de GCC.

Lo primero de todo, GCC es un compilador portable ---se ejecuta en la mayoría de las plataformas disponibles hoy, y puede producir salidas para muchos tipos de procesadores. Además de procesadores usados en ordenadores personales, también soporta microcontroladores, DSPs y CPUs de 64 bits.

GCC no es solo un compilador nativo ---también puede compilar cruzado cualquier programa, produciendo ficheros ejecutables para un sistema diferente desde el que GCC está siendo usado. Esto permite compilar software para sistemas embebidos que no son capaces de ejecutar un compilador. GCC está escrito en C con un fuerte enfoque hacia la portabilidad, y puede compilarse a sí mismo, así puede ser adaptado a nuevos sistemas fácilmente.

GCC tiene múltiples frontends, para parsear diferentes lenguajes. Los programas en cada lenguaje pueden ser compilados, o compilados de manera cruzada, para cualquier arquitectura. Por ejemplo, un programa en ADA puede ser compilado para un microcontrolador, o un programa en C para un supercomputador.

GCC tiene un diseño modular, permitiendo que el soporte para nuevos lenguajes y arquitecturas sea añadido. Añadir un nuevo front-end a GCC habilita el uso de este lenguaje en cualquier arquitectura y proporciona que estén disponibles facilidades (tales como librerías) en tiempo de ejecución. De manera similar, si se añade soporte para una nueva arquitectura éste se vuelve disponible para todos los lenguajes.

Finalmente, y de manera más importante, GCC es software libre, distribuido bajo la GNU General Public License (GNU GPL). (Para detalles ver el fichero de licencia COPYING distribuido con GCC.) Esto significa que se tiene la libertad para usar y modificar GCC, como con todo el software de GNU. Si se necesita soporte para un nuevo tipo de CPU, un nuevo lenguaje, o una nueva funcionalidad es posible añadirla uno mismo o contratar a alguien para mejorar GCC de manera personalizada. Se puede contratar a alguien para arreglar un error si esto es importante en el trabajo cotidiano.

Más allá, hay libertad para compartir cualquier mejora hecha a GCC. Como resultado de esta libertad, se pueden usar las mejoras hechas a GCC por otras personas. Las muchas funcionalidades ofrecidas por GCC hoy muestran cómo esta libertad de cooperar funciona en tu beneficio, y en el de cualquiera que use GCC.

Programación en C y C++
=======================

C y C++ son lenguajes que permiten acceso directo a la memoria del ordenador. Históricamente, han sido usados para escribir sistemas software de bajo nivel, y aplicaciones dónde el alto rendimiento o el control a través del uso de recursos son críticos. Sin embargo, se requiere de gran cuidado para asegurar que la memoria es accedida de manera correcta, para evitar la corrupción de otras estructuras de datos. Este libro describe técnicas que ayudarán a detectar potenciales errores durante la compilación, pero los riesgos de usar lenguajes como C o C++ nunca pueden ser eliminados.

Además de C y C++ el Proyecto GNU también proporciona otros lenguajes de alto nivel, tales como GNU Common Lisp (gcl), GNU Smalltalk (gst), el GNU Scheme extension language (guile) y el GNU Compiler para Java (gcj). Estos lenguajes no permiten al usuario acceder a memoria directamente, eliminando la posibilidad de errores de acceso a memoria. Son una alternativa segura a C y C++ para muchas aplicaciones.

Convenciones usadas en este manual
==================================

Este manual contiene muchos ejemplos que pueden ser escritos en el teclado. Un comando introducido en el terminal se muestra como esto,

     $ comando

seguido por su salida. Por ejemplo:

     $ echo "hola mundo"
     hola mundo

El primer carácter en la línea es el prompt del terminal, y no será escrito. El signo del dólar $ es usado como el prompt estándar en este manual, aunque en algunos sistemas puede usar un carácter diferente.

Cuando un comando en un ejemplo es demasiado largo para ajustarse en una sola línea es envuelto e indentado en las líneas subsiguientes, como este:

     $ echo "un ejemplo de una línea que es demasiado
         larga para este manual"

Cuando se introduce en el teclado, el comando entero será escrito en una sola línea.

Los ficheros fuente de ejemplo usados en este manual pueden ser descargados desde el sitio web de la editorial, (Ver http://www.network-theory.co.uk/gcc/intro/) o introducidos a mano usando cualquier editor de texto, tal como el editor estándar de GNU, emacs. Los comandos de compilación de ejemplo usan gcc y g++ como los nombres de los compiladores de GNU de C y de C++ y usan cc para referirse a otros compiladores. Los programas de ejemplo trabajarán con cualquier versión de GCC. Las opciones de estos comandos que están disponibles en versiones recientes de GCC son anotadas en el texto.

Este ejemplo asume el uso de un sistema operativo GNU ---hay pequeñas diferencias en la salida en otros sistemas. Algunos mensajes de salida no esenciales y dependientes del sistema (tal como rutas muy largas) han sido editadas en los ejemplos por brevedad. Los comandos para configurar variables de entorno usan la sintaxis de la shell estándar de GNU (bash), y funcionará con cualquier versión de Bourne shell.

Compilando un programa C
************************

Este capítulo describe cómo compilar programas C usando gcc. Los programas pueden ser compilados desde un solo fichero fuente o desde múltiples ficheros fuente, y pueden usar librerías de sistema y ficheros de cabecera.

La compilación se refiere al proceso de convertir un programa desde el código fuente textual de un lenguaje de programación tal como C o C++, en código máquina, la secuencia de unos y ceros usados para controlar la unidad central de proceso (CPU) del ordenador. Este código máquina es almacenado en un fichero conocido como fichero ejecutable, a veces también llamado fichero binario.

Compilando un pequeño programa C
================================

El clásico programa de ejemplo para el lenguaje C es Hola Mundo. Aquí está el código fuente para nuestra versión del programa:

          [file hola.es.c not included]

Se asume que el código fuente está almacenado en un fichero llamado hola.es.c. Para compilar el fichero hola.es.c con gcc, se puede usar el siguiente comando:

     $ gcc -Wall hola.es.c -o hola

Esto compila el código fuente de hola.es.c a código máquina y lo almacena en el fichero ejecutable hola. El fichero de salida para el código máquina se especifica usando la opción -o. Esta opción normalmente es el último argumento en la línea de comandos. Si se omite, la salida es escrita a un fichero por defecto llamado a.out.

Nótese que si ya existe un fichero con el mismo nombre que el fichero ejecutable en el directorio actual, entonces se sobreescribirá.

La opción -Wall activa todos los avisos más comunes ---¡se recomienda usar siempre esta opción!. Hay muchas otras opciones de avisos que serán discutidas en capítulos posteriores, pero -Wall es la más importante. GCC no producirá avisos a menos que estén activados. Los avisos del compilador son una ayuda esencial detectando problemas al programar en C y C++.

En este caso, el compilador no produce avisos con la opción -Wall, debido a que el programa es completamente válido. El código fuente que no produce avisos se dice que compila limpiamente.

Para ejecutar el programa, escribe la ruta del ejecutable así:

     $ ./hola
     ¡Hola, mundo!

Esto carga el fichero ejecutable en memoria y hace que la CPU empiece a ejecutar las instrucciones que contiene. La ruta ./ se refiere al directorio actual, así ./hola carga y ejecuta el fichero ejecutable hola localizado en el directorio actual.

Encontrando errores en un pequeño programa
==========================================

Como se mencionó antes, los avisos del compilador son una ayuda esencial cuando se programa en C y C++. Para demostrar esto, el programa de debajo contiene un pequeño error: usa la función printf de manera incorrecta, especificando un formato en coma flotante %f para un valor entero:

          [file mal.es.c not included]

Este error no es obvio a primera vista, pero puede ser detectado por el compilador si la opción de aviso -Wall se ha habilitado.

Al compilar el anterior programa, mal.es.c, con la opción -Wall produce el siguiente mensaje:

     $ gcc -Wall bad.c -o bad
     bad.c: In function 'main':
     bad.c:6:3: warning: format '%f' expects argument of
     type 'double', but argument 2 has type 'int' [-Wformat]

Esto indica que un formato de cadena ha sido usado incorrectamente en el fichero mal.es.c en la línea 6. Los mensajes producidos por GCC siempre tienen la forma fichero:número de línea:mensaje. El compilador distingue entre mensajes de error, que impiden una compilación exitosa, y mensajes de aviso que indican posibles problemas (pero no detienen la compilación).

En este caso, el especificador de formato será %d para un argumento entero. Los especificadores de formato permitidos para printf pueden ser encontrados en cualquier libro general de C, tal como el GNU C Library Reference Manual (see Lectura adicional).

Sin la opción de aviso -Wall el programa compila limpiamente, pero produce resultados incorrectos:

     $ gcc mal.es.c -o mal
     $ ./mal
     Dos y dos son 0.000000    (salida incorrecta) example

     El incorrecto formato especificado causa que la salida esté
     corrompida, porque a la función printf se le pasa un entero
     en lugar de un número en coma flotante. Los números enteros y en
     coma flotante son almacenados en diferentes formatos en memoria, por
     lo general ocupan diferente número de bytes, obteniendo un falso
     resultado. La actual salida que se muestra puede diferir, dependiendo
     de la plataforma y el entorno específicos.

     Claramente, es muy peligroso desarrollar un programa sin comprobar los
     avisos de compilación. Si hay alguna función no usada
     correctamente, causará que el programa falle o produzca resultados
     incorrectos. Activando los avisos del compilador con la opción
     -Wall se detectarán muchos de los más habituales errores
     que ocurren programando en C.

Compilando múltiples archivos fuentes
=====================================

Un programa puede ser dividido en múltiples ficheros. Facilitando tanto la edición como la comprensión del código, especialmente en el caso de largos programas ---también permite que las partes individuales sean compiladas de manera independiente.

En el siguiente ejemplo se dividirá el programa Hola Mundo en tres ficheros: main.es.c, hola_fn.es.c y el fichero de cabecera hola.es.h. Aquí está el programa principal main.es.c:

          [file main.es.c not included]

La llamada original a la función de sistema printf en el programa previo hola.es.c ha sido reemplazado por una llamada a una nueva función externa hola, que se definirá en un fichero separado hola_fn.es.c

El programa main también incluye el fichero de cabecera hola.es.h que contendrá la declaración de la función hola. La declaración es usada para asegurar que los tipos de los argumentos y el valor de retorno concuerda correctamente con la llamada de la función y la definición de la función. No se necesita incluir el fichero de cabecera stdio.h en main.es.c para declarar la función printf, ya que el fichero main.es.c no llama a printf directamente.

La declaración en hola.es.h es una simple línea que especifica el prototipo de la función hola

          [file hola1.es.h not included]

La definición de la función hola en sí está contenida en el fichero hola_fn.es.c:

          [file hola_fn.es.c not included]

Esta función imprime el mensaje ``¡Hola, NOMBRE !'' usando como valor de NOMBRE el argumento introducido.

Casualmente, la diferencia entre las dos formas de la instrucción de inclusión #include "FILE.h" y #include <FILE.h> es que la primera busca el archivo FILE.h en el directorio actual antes de buscarlo en los directorios de los archivos de cabeceras del sistema. La instrucción de inclusión #include <FILE.h> busca por defecto los archivos de cabeceras del sistema, pero no busca en el directorio actual.

Para compilar estos ficheros fuente con gcc, se usa el siguiente comando:

     $ gcc -Wall main.es.c hola_fn.es.c -o nuevohola

En este caso, se usa la opción -o para especificar un nombre al fichero de salida diferente para el ejecutable, nuevohola. Nótese que el fichero de cabecera hola.es.h no está especificado en la lista de ficheros en la línea de comandos. La directiva #include "hola.es.h" en los ficheros fuente ordena al compilador incluirlo de forma automática en los puntos apropiados.

Para ejecutar el programa, se escribe la ruta del ejecutable:

     $ ./nuevohola
     ¡Hola, mundo!

Todas las partes del programa han sido combinadas en un solo fichero ejecutable, que produce el mismo resultado que el ejecutable creado desde el fichero fuente usado anteriormente.

Compilando archivos independientes
==================================

Si un programa es almacenado en un solo fichero, entonces cualquier cambio en una función individual requiere que el programa entero sea recompilado para producir un nuevo ejecutable. La recompilación de largos ficheros fuente puede consumir mucho tiempo.

Cuando los programas son almacenados en ficheros fuente independientes, solo los ficheros que han cambiado necesitan ser recompilados después de que el código fuente haya sido modificado. De este modo, los ficheros fuente son compilados separadamente y enlazados juntos ---es un proceso de dos fases. En la primera fase, un fichero es compilado sin crear el ejecutable. El resultado es un fichero objeto, y tiene la extensión .o al usar GCC.

En la segunda fase, los ficheros objeto son unidos por otro programa llamado enlazador. El enlazador combina todos los ficheros objeto creando un solo ejecutable.

Un fichero objeto contiene código máquina en el cual las referencias a direcciones de memoria de funciones (ó variables) de otros ficheros se dejan indefinidas. Esto permite que los ficheros fuentes se compilen sin referencia directa a otros. El enlazador rellena estas direcciones perdidas cuando produce el ejecutable.

Creando archivos objeto desde archivos fuente
---------------------------------------------

La opción -c es usada para compilar un fichero fuente para crear un fichero objeto. Por ejemplo, el siguiente comando compilará el fichero fuente main.es.c para generar un fichero objeto:

     $ gcc -Wall -c main.es.c example

     Esto produce un fichero objeto main.o que contiene el código
     máquina para la función main. Éste contiene una referencia
     la función externa hola, pero la correspondiente dirección
     de memoria se deja indefinida en el fichero objeto en esta fase (se
     introducirá después al enlazarse).

     El correspondiente comando para compilar la función hola en el
     código fuente hola_fn.es.c es:

          $ gcc -Wall -c hola_fn.es.c

     Esto produce el fichero objeto hola_fn.o.

     Nótese que no hay necesidad de usar la opción -o para
     especificar el nombre del fichero de salida en este caso. Al compilar
     con la opción -c el compilador de forma automática crea
     un fichero objeto cuyo nombre es el mismo que el fichero fuente, pero
     con .o en vez de la extensión original.

     No hay necesidad de poner el fichero de cabecera hola.es.h en la
     línea de comandos, ya que se incluye de forma
     automática gracias a las sentencias #include en main.es.c
     y hola_fn.es.c.

Creando ejecutables desde archivos objeto
-----------------------------------------

El paso final para crear un fichero ejecutable es usar gcc para enlazar los ficheros objetos juntos y llenar las direcciones perdidas de funciones externas. Para enlazar ficheros objetos juntos, simplemente se listan en el siguiente comando:

     $ gcc main.o hola_fn.o -o hola

Esta es una de las pocas ocasiones en las que no hay necesidad de usar la opción de avisos -Wall, debido a que los ficheros fuente individuales han sido compilados exitosamente en código objeto. Una vez que los ficheros fuente han sido compilados, enlazar es un proceso ambiguo que tendrá éxito o fallará (falla solo si hay referencias que no pueden ser resueltas).

Para realizar el paso de enlazar gcc usar el enlazador ld, que es un programa separado. En sistemas GNU se usa el enlazador de GNU, GNU ld. Otros sistemas pueden usar el enlazador de GNU con GCC, o pueden tener sus propios enlazadores. El enlazador en sí será discutido después (see Como funciona el compilador). Al ejecutar el enlazador, gcc crea un fichero ejecutable desde los ficheros objeto.

El fichero ejecutable resultante puede ejecutarse ahora:

     $ ./hola
     ¡Hola, mundo!

Se produce la misma salida que en la versión del programa que usa un solo fichero fuente visto en la sección previa.

Recompilando y reenlazando
==========================

Para mostrar cómo los ficheros fuente pueden ser compilados de manera independiente se editará el programa main.es.c para imprimir un saludo para cualquiera en vez de mundo:

          [file main2.es.c not included]

El fichero actualizado main.es.c ahora puede ser recompilado con el siguiente comando:

     $ gcc -Wall -c main2.es.c example

     Esto produce un nuevo fichero objeto main.o. No se necesita crear un
     nuevo fichero objeto para hola_fn.es.c, debido a que el fichero y los

     ficheros relacionados de los que depende, tales como ficheros de cabeceras,
     no han cambiado.

     El nuevo fichero objeto puede ser reenlazado con la función hola
     para crear un nuevo fichero ejecutable:

          $ gcc main2.es.o hola_fn.o -o hola example

          El ejecutable resultante hola ahora usa la nueva función
          main para producir la siguiente salida:

               $ ./hola
               ¡Hola, cualquiera!

          Nótese que solo el fichero main.es.c ha sido recompilado y, por
          tanto,
          reenlazado con el fichero objeto existente para la función hola. Si
          el fichero hola_fn.es.c hubiera sido modificado, se
          podría haber
          recompilado hola_fn.es.c para crear un nuevo fichero objeto
          hola_fn.o y reenlazar este con el fichero main.o. (Si
          el prototipo de una función cambia, es necesario modificar y recompilar
          todos los ficheros fuentes que la usan.)

          En un gran proyecto con muchos ficheros fuente, recompilar solo aquellos
          que han sido modificados crea un significativo ahorro. El proceso de
          recompilar solo los ficheros modificados en un proyecto puede ser
          automatizado con el programa estándar de Unix make.

Un pequeño makefile
===================

Para aquellos no familiarizados con make, esta sección provee una demostración de su uso. make es un programa propio que puede ser encontrado en todos los sistemas Unix. Para aprender más acerca de la versión GNU de make se necesitará consultar el manual de GNU Make escrito por Richard M. Stallman y Roland McGrath (see Lectura adicional).

make lee una descripción de un proyecto desde un archivo conocido por makefile (por defecto, llamado Makefile en el directorio actual). Un makefile especifica un conjunto de reglas de compilación en términos de objetivos (tal como ejecutables) y sus dependencias (tal como ficheros objeto y ficheros fuente) en el siguiente formato:

     objetivo: dependencias
             comando

Por cada objetivo, make chequea el momento de modificación de los correspondientes ficheros de dependencia para determinar si el objetivo necesita ser reconstruido usando el correspondiente comando. Nótese que las líneas de comandos en un makefile deben ser indentadas con un carácter TAB, sin espacios.

GNU Make contiene muchas reglas por defecto, llamadas reglas implícitas, para simplificar la construcción de makefiles. Por ejemplo, estos especifican que ficheros .o pueden ser obtenidos desde ficheros .c al compilarse, y que un ejecutable puede ser creado enlazando ficheros .o juntos. Las reglas implícitas son definidas en términos de variables make, tales como CC (el compilador de C) y CFLAGS (las opciones de compilación para programas C), que pueden ser asignadas usando líneas VARIABLE=VALUE en el makefile. Para C++ las variables equivalentes son CXX y CXXFLAGS, mientras la variable CPPFLAGS asigna las opciones del preprocesador. Las reglas implícitas y las definidas por el usuario se encadenadan juntas de forma automática como GNU Make necesite.

Un Makefile simple para el proyecto anterior puede ser escrito como sigue:

          [file c1makefile2 not included]

El fichero puede ser leido de la manera siguiente: usando el compilador de C gcc, con la opción de compilación -Wall, se construirá el objetivo ejecutable main desde los ficheros objeto main.o y hola_fn.o (estos, en cambio, serán construidos vía reglas implícitas desde main.es.c y hola_fn.es.c. El objetivo clean no tiene dependencias y simplemente elimina todos los ficheros compilados. (Esto asume que no hay ningún fichero llamado clean en el directorio actual ---ver la discusión de `falsos objetivos' en el manual GNU Make para más detalles.) La opción -f (fuerza) que en el comando rm se suprima cualquier mensaje de error si los ficheros no existen.

Para usar el makefile, se escribe make. Al llamarse sin argumentos, se construye el primer objetivo en el makefile, produciendo el ejecutable main.

     $ make
     gcc -Wall -c -o main.o main.es.c
     gcc -Wall -c -o hola_fn.o hola_fn.es.c
     gcc main.o hola_fn.o -o main
     $ ./main
     ¡Hola, mundo!

Para reconstruir el ejecutable después de modificar un fichero fuente, simplemente se escribe make de nuevo. Al comprobar las fechas de modificación de los objetivos y de los ficheros dependientes, make identifica los ficheros que han cambiado y regenera los ficheros intermedios correspondientes y necesarios para actualizar los objetivos:

     $ emacs main.es.c (editar el fichero)
     $ make
     gcc -Wall -c -o main.o main.es.c
     gcc main.o hola_fn.o -o main
     $ ./main
     ¡Hola, cualquiera!

Finalmente, para eliminar los ficheros generados, se escribe make clean:

     $ make clean
     rm -f main main.o hola_fn.o

Un makefile más sofisticado normalmente contiene objetivos adicionales para instalación (make install) y testeo (make check).

Los ejemplos del resto de este libro son suficientemente pequeños para no necesitar makefiles, pero el uso de make se recomienda en programas largos.

Enlazando con librerías externas
================================

Una librería es una colección de ficheros objetos precompilados que pueden ser enlazados dentro de programas. El uso más común de librerías es proporcionar funciones de sistema, tales como la función raíz cuadrada sqrt que se encuentra en la librería matemática de C.

Las librerías suelen almacenarse en ficheros de archivo especiales con la extensión .a, también llamadas librerías estáticas. Éstas son creadas desde ficheros objeto con una herramienta propia, el archivador de GNU ar, y es usado por el enlazador para resolver referencias a funciones en tiempo de compilación. Después veremos cómo crear librerías usando el comando ar (see Utilidades relativas al compilador). Por simplicidad, sólo las librerías estáticas se cubren en esta sección ---el enlazado dinámico en tiempo de ejecución usando librerías compartidas será descrito en el siguiente capítulo.

El sistema de librerías estándar normalmente se encuentra en los directorios /usr/lib y /lib. (En sistemas que soportan versiones de librerías ejecutables de 32 y 64 bits, las versiones de 64 bit se almacenarán frecuentemente en /usr/lib64 y /lib64, y las versiones de 32 bits en /usr/lib y lib.) Las librerías algunas veces pueden ser encontradas en un directorio específico de la arquitectura, como /usr/lib/i386-linux-gnu/. Por ejemplo, la librería matemática de C está almacenada normalmente en el fichero /usr/lib/libm.a en sistemas tipo Unix. Las declaraciones de prototipo correspondientes a las funciones de esta librería se realizan en el fichero de cabecera /usr/include/math.h. La librería estándar de C en sí misma es almacenada en /usr/lib/libc.a y contiene funciones especificadas en el estándar ANSI/ISO C, tal como printf ---esta librería es enlazada por defecto en cada programa C.

Aquí se muestra un programa de ejemplo que realiza una llamada a la función externa sqrt en la librería matemática libm.a:

          [file calc.es.c not included]

Intentar crear un ejecutable desde este único fichero fuente causa que el compilador devuelva un error en la fase de enlace:

     $ gcc -Wall calc.es.c -o calc
     /tmp/ccbR6Ojm.o: In function `main':
     /tmp/ccbR6Ojm.o(.text+0x19): undefined reference
       to `sqrt'

El problema es que la referencia a la función sqrt no puede ser resuelta sin la librería matemática externa libm.a. La función sqrt no está definida en el programa o en la librería por defecto libc.a, y el compilador no enlaza al fichero libm.a a menos que éste esté explícitamente seleccionado. Casualmente, el fichero mencionado el mensaje de error /tmp/ccbR60jm.o es un fichero objeto temporal creado por el compilador desde calc.es.c, para llevar a cabo el proceso de enlace.

Para permitir que el compilador enlace la función sqrt al programa main de calc.es.c es necesario proveer la librería libm.a. Un obvio pero no convencional modo de hacer esto es especificarlo de manera explícita en la línea de comandos:

     $ gcc -Wall calc.es.c /usr/lib/libm.a -o calc

La librería libm.a contiene los ficheros objeto para todas las funciones matemáticas, tales como sin, cos, exp, log y sqrt. El enlazador busca a través de estos para encontrar el fichero objeto conteniendo la función sqrt.

Una vez que el fichero objeto para la función sqrt fué encontrado, el programa main puede ser enlazado y se produce un ejecutable completo:

     $ ./calc
     La raíz cuadrada de 2.000000 es 1.414214

El fichero ejecutable incluye el código máquina para la función main y el código máquina para la función sqrt, copiado desde el archivo objeto correspondiente en la librería libm.a.

Para evitar la necesidad de especificar largas rutas en la línea de comandos, el compilador proporciona una opción de atajo -l para enlazar librerías. Por ejemplo, el siguiente comando,

     $ gcc -Wall calc.es.c -lm -o calc

es equivalente al comando original usando el nombre de la librería completa /usr/lib/libm.a.

En general, la opción del compilador  -lNAME intentará enlazar ficheros objeto con un fichero de librería libNAME.a en los directorios de librería estándar. Los directorios adicionales pueden especificarse con opciones de la línea comandos y variables de entorno, por decirlo resumidamente. Un programa largo normalmente usará muchas opciones -l para enlazar a librerías tales como la librería matemática, librerías gráficas y librerías de red.

Orden de enlace de librerías
----------------------------

El comportamiento tradicional de los enlazadores es buscar funciones externas de izquierda a derecha en las librerías especificadas en la línea de comandos. Esto significa que una librería que contiene la definición de una función debería aparecer después de cualquier fichero fuente o ficheros objeto que la usen. Esto incluye librerías especificadas con la opción -l, como se muestra en el siguiente comando:

     $ gcc -Wall calc.es.c -lm -o calc   (orden correcto)

Con algunos enlazadores el orden opuesto (poner la opción -lm antes del fichero que lo usa) daría como resultado un error,

     $ cc -Wall -lm calc.es.c -o calc    (orden incorrecto)
     main.o: In function `main':
     main.o(.text+0xf): undefined reference to `sqrt'

debido a que no hay librería o fichero objeto que contenga sqrt después de calc.es.c. La opción -lm

debería aparecer después del fichero calc.es.c.

Cuando se usan varias librerías, se debería usar la misma convención que con las librerías en sí. Una librería que llama a una función externa definida en otra librería debería aparecer antes que la librería que contiene la función.

Por ejemplo, un programa data.es.c usando la librería GNU Linear Programming library libglpk.a, que a su vez usa la librería matemática libm.a, se compila así:

     $ gcc -Wall data.es.c -lglpk -lm

debido a que los fichero objetos de libglpk.a usan funciones definidas en libm.a.

La mayoría de los enlazadores actuales buscarán todas las librerías, sin importar el orden, pero debido a que algunos no hacen esto es mejor seguir la convención de ordenar las librerías de izquierda a derecha.

Es útil tener todo esto en mente si se encuentran problemas inesperados con referencias no definidas, y mirar si todas las librerías necesarias aparecen en la línea de comandos.

Usando librerías de archivos de cabeceras
=========================================

Cuando se usa una librería es esencial incluir los ficheros de cabecera apropiados, para así declarar los argumentos de funciones y devolver valores con los tipos correctos. Sin declaraciones, los argumentos de una función pueden pasar el tipo erróneo, causando resultados corruptos.

El siguiente ejemplo muestra otro programa que crea una llamada de función para la librería estándar de C. En este caso, la función strtod es usada para convertir una cadena \"123\" a un número en coma flotante:

          [file badconv.es.c not included]

Sin embargo, el programa contiene un error ---la sentencia #include para la necesaria cabecera stdlib.h no se encuentra, así el prototipo double strtod (const char * string, char * tail) no será visto por el compilador.

La compilación del programa sin opciones de aviso producirá un fichero ejecutable que da resultados incorrectos:

     $ gcc badconv.es.c -lm
     $ ./a.out
     El valor es 966656.000000 (resultado incorrecto,
     debería ser 123.0)

Los resultados están corruptos porque los argumento y el valor devuelto de la llamada a strtod son pasados con tipos incorrectos. (La actual salida anterior puede diferir, dependiendo de la plataforma y el entorno específicos.) Esto puede ser detectado activando la opción de avisos -Wall:

     $ gcc -Wall badconv.es.c -lm
     badconv.es.c: In function `main':
     badconv.es.c:6: warning: implicit declaration of
       function `strtod'

Este ejemplo muestra de nuevo la importancia de usar la opción de aviso -Wall para detectar problemas serios que de otro modo no podrían ser fácilmente localizados.

Opciones de compilación
***********************

Este capítulo describe otras opciones del compilador comúnmente usadas disponibles en GCC. Estas opciones controlan funcionalidades tales como buscar rutas usadas para localizar librerías e incluir ficheros, el uso de avisos adicionales y diagnósticos, macros del preprocesador y dialectos del lenguaje C.

Asignando rutas de búsqueda
===========================

En el último capítulo, se vió cómo enlazar a un programa con funciones de la librería matemática libm.a, usando la opción de atajo -lm y el fichero de cabecera math.h.

Un problema común cuando se compila un programa usando ficheros de cabecera es el error:

     FILE.H: No such file or directory

Esto ocurre si un fichero de cabecera no está presente en los directorios de ficheros include estándar usados por gcc. Un problema similar puede ocurrir en librerías:

     /usr/bin/ld: cannot find LIBRARY

Esto ocurre si una librería usada para enlazar no está presente en los directorios de librería estándar usados por gcc.

Por defecto, gcc busca en los siguientes directorios los ficheros de cabecera:

     /usr/local/include/
     /usr/include/

y los siguientes directorios para librerías:

     /usr/local/lib/
     /usr/lib/

La lista de directorios para ficheros de cabecera son referidos con frecuencia como ruta de include, y la lista de directorios para librerías como ruta de búsqueda de librerías o ruta de enlace.

Los directorios en estas rutas son buscados en orden, desde el primero hasta el último en los dos listados de arriba. (Las rutas de búsqueda por defecto pueden también incluir directorios adicionales y dependientes del sistema o específicos del sitio, y directorios en la instalación de GCC en sí. Por ejemplo, en plataformas de 64 bits directorios adicionales lib64 pueden también ser búscados por defecto.) Por ejemplo, un fichero de cabecera encontrado en /usr/local/include precede a un fichero con el mismo nombre en /usr/include. De manera similar, una librería encontrada en /usr/local/lib precederá a una librería con el mismo nombre en /usr/lib.

Cuando se instalan librerías adicionales en otros directorios es necesario extender las rutas de búsqueda, para que las librerías sean encontradas. Las opciones del compilador -I y -L añaden nuevos directorios al principio de la ruta include y la ruta de búsqueda de librería respectivamente.

Ejemplo de ruta de búsqueda
---------------------------

El siguiente programa de ejemplo usa una librería que podría ser instalada como un paquete adicional en un sistema ---la GNU Database Management Library (GDBM). La librería GDBM almacena pares clave:valor en un fichero DBM, un tipo de fichero de datos que permite que los valores sean almacenados e indexados por una clave (una arbitraria secuencia de caracteres). Aquí está el programa de ejemplo dbmain.es.c, que crea un fichero DBM conteniendo una clave clavetest con el valor valortest:

          [file dbmain.es.c not included]

El programa usa el fichero de cabecera gdbm.h y la librería libgdbm.a. Si la librería ha sido instalada en la localización por defecto /usr/local/lib, con el fichero de cabecera en /usr/local/include, entonces el programa puede ser compilado con el siguiente comando:

     $ gcc -Wall dbmain.es.c -lgdbm

Ambos de estos directorios son parte del gcc por defecto e incluyen enlaces y rutas.

Sin embargo, si GDBM ha sido instalado en una localización diferente, al intentar compilar el programa se obtendrá el siguiente error:

     $ gcc -Wall dbmain.es.c -lgdbm
     dbmain.es.c:1: gdbm.h: No such file or directory

Por ejemplo, si la versión 1.8.3 del paquete GDBM está instalada en el directorio /opt/gdbm-1.8.3 la localización del fichero de cabecera sería,

     /opt/gdbm-1.8.3/include/gdbm.h

que no es parte de la ruta include del gcc por defecto. Añadiendo el directorio apropiado para la ruta include con la opción -I en línea de comandos, permite que el programa se compile, pero no se enlace:

     $ gcc -Wall -I/opt/gdbm-1.8.3/include dbmain.es.c -lgdbm
     /usr/bin/ld: cannot find -lgdbm
     collect2: ld returned 1 exit status

El directorio que contiene la librería no está incluido en la ruta de enlace. Éste puede ser añadido a la ruta de enlace usando la siguiente opción:

     -L/opt/gdbm-1.8.3/lib/

El siguiente comando permite que el programa sea compilado y enlazado:

     $ gcc -Wall -I/opt/gdbm-1.8.3/include
        -L/opt/gdbm-1.8.3/lib dbmain.es.c -lgdbm

Esto produce el ejecutable final enlazado a la librería GDBM. Antes de ver como funciona este ejecutable se dará una breve mirada a las variables de entorno que afecta a las opciones -I y -L.

Nótese que nunca se localizarán las rutas absolutas de los ficheros de cabecera en sentencias #include en el código fuente, ya que esto evitaría que el programa se compilase en otros sistemas. La opción -I o la variable INCLUDE_PATH descrita anteriormente siempre se debería usar para asignar la ruta include para los ficheros de cabecera.

Variables de entorno
--------------------

La búsqueda de rutas para los ficheros de cabecera y librerías puede también ser controlado a través de las variables de entorno en la shell. Estas pueden ser asignadas de manera automática por cada sesión usando el apropiado fichero de acceso, tal como .bash_profile en el caso de GNU Bash.

Los directorios adicionales pueden ser añadidos para la ruta include usando la variable de entorno C_INCLUDE_PATH (para ficheros de cabecera de C). Por ejemplo, los siguientes comandos añadirán /opt/gdbm-1.8.3/include a la ruta include cuando se compilan programas C:

     $ C_INCLUDE_PATH=/opt/gdbm-1.8.3/include
     $ export C_INCLUDE_PATH

y de manera similar para programas C++:

     $ CPLUS_INCLUDE_PATH=/opt/gdbm-1.8.3/include
     $ export CPLUS_INCLUDE_PATH

Este directorio será buscado después de cualquier directorio especificado en el comando con la opción -I, y antes de los directorios estándar por defecto (tales como /usr/local/include y /usr/include). El comando de shell export es necesario para crear la variable de entorno disponible a programas fuera de la shell en sí, tales como el compilador ---es solo necesario unavez por cada variable en cada sesión de shell, y también puede ser asignado en el apropiado fichero de login. (En GNU Bash, la forma corta export VARIABLE=VALOR también se permite.)

De manera similar, directorios adicionales pueden ser añadidos a la ruta de enlace usando la variable de entorno LIBRARY_PATH. Por ejemplo, los siguientes comandos añadirán /opt/gdbm-1.8.3/lib a la ruta de enlace.

     $ LIBRARY_PATH=/opt/gdbm-1.8.3/lib
     $ export LIBRARY_PATH

Este directorio será buscado después de que cualquier directorio especificado en la línea de comandos con la opción -L, y antes que los directorios estándar por defecto (tales como /usr/local/lib y /usr/lib).

Con las configuraciones de las variables de entorno dadas arriba el programa dbmain.es.c puede ser compilado sin las opciones -I

y -L,

     $ gcc -Wall dbmain.es.c -lgdbm

porque la rutas por defecto ahora usan los directorios especificados en las variables de entorno C_INCLUDE_PATH y LIBRARY_PATH. El mismo comando de compilación con g++ debería usar las variables de entorno CPLUS_INCLUDE_PATH y LIBRARY_PATH.

Rutas de búsqueda extendidas
----------------------------

Siguiendo la convención estándar de Unix para la búsqueda de rutas, varios directorios pueden ser especificados en una variable de entorno como una lista cuyos elementos se separan con el carácter dos puntos `:':

     DIR1:DIR2:DIR3:...

Los directorios son buscados de izquierda a derecha. Un punto simple . puede ser usado para especificar el directorio actual. (El directorio actual también puede ser especificado usando una ruta vacía. Por ejemplo, :DIR1:DIR2 es equivalente a .:DIR1:DIR2.)

Por ejemplo, la siguiente configuración crea un include por defecto y enlaza rutas para paquetes instalados en el directorio actual . y en los directorios include y lib bajo /opt/gdbm-1.8.3 y /net respectivamente:

     $ C_INCLUDE_PATH=.:/opt/gdbm-1.8.3/include:/net/include
     $ LIBRARY_PATH=.:/opt/gdbm-1.8.3/lib:/net/lib

Para programas C++, se usa la variable de entorno CPLUS_INCLUDE_PATH en vez de C_INCLUDE_PATH.

Para especificar múltiples rutas de búsqueda en la línea de comandos, las opciones -I y -L pueden ser repetidas. Por ejemplo, el siguiente comando,

     $ gcc -I. -I/opt/gdbm-1.8.3/include -I/net/include
        -L. -L/opt/gdbm-1.8.3/lib -L/net/lib .....

es equivalente a las configuraciones en la variable de entornos dadas anteriormente.

Cuando las variables de entorno y las opciones de comandos son usados juntos el compilador busca los directorios en el siguiente orden:

 1. opciones de comandos -I y -L, de izquierda a derecha

 2. directorios especificados por variables de entornos, tales como C_INCLUDE_PATH (para programas C), CPLUS_INCLUDE_PATH (para programas C++) y LIBRARY_PATH

 3. directorios de sistema por defecto

En el uso del día a día, los directorios son normalmente añadidos a rutas de búsqueda con las opciones -I y -L.

Librerías compartidas y librerías estáticas
===========================================

Aunque el programa de ejemplo de arriba ha sido exitosamente compilado y enlazado, es necesario un paso final antes de ser capaz de cargar y ejecutar el fichero ejecutable.

En un intento por iniciar la ejecución directamente, sucederá el siguiente error en la mayoría de los sistemas:

     $ ./a.out
     ./a.out: error while loading shared libraries:
     libgdbm.so.3: cannot open shared object file:
     No such file or directory

Esto es porque el paquete GDBM proporciona una librería compartida. Este tipo de librería requiere un tratamiento especial ---debe ser cargada desde disco antes de que el ejecutable cargue.

Las librerías externas se proveen normalmente de dos formas: librerías estáticas y librerías compartidas. Las librerías estáticas son los ficheros .a vistos antes. Cuando un programa es enlazado a una librería estática, el código máquina de los ficheros objetos para cualquier función externa usada por el programa es copiado desde la librería al ejecutable final.

Las librerías compartidas son manejadas con una forma más avanzada de enlace, que crea el fichero ejecutable más pequeño. Ellas usan la extensión .so, soportado por los objetos compartidos.

Un fichero ejecutable enlazado a una librería compartida contiene solo una pequeña parte de las funciones requeridas, en vez del código máquina completo de los ficheros para las funciones externas. Antes de que el fichero ejecutable empiece su ejecución, el código máquina de las funciones externas es copiado en memoria desde el fichero de la librería compartida por el sistema operativo ---un proceso referido como enlace dinámico.

El enlace dinámico crea ficheros ejecutables pequeños y reserva espacio en disco, porque una copia de una librería puede ser compartida entre múltiples programas. En la mayoría de los sistemas operativos también se proporciona un mecanismo de memoria virtual que permite que una copia de una librería compartida en memoria física sea usada por todos los programas en ejecución, ahorrando tanto memoria como espacio en disco.

Además, las librerías compartidas hacen posible actualizar una librería sin recompilar los programas que ella usa (la interfaz dada a la librería no cambia).

Por estas ventajas gcc compila programas para usar librerías compartidas por defecto en la mayoría de los sistemas, si éstas están disponibles. Siempre y cuando una librería estática libNAME.a sea usada para enlazarse con la opción -lNAME el compilador primero busca una librería compartida alternativa con el mismo nombre y una extensión .so.

En este caso, cuando el compilador busca la librería libgdbm en la ruta de enlace, éste encuentra los dos ficheros siguientes en el directorio /opt/gdbm-1.8.3/lib:

     $ cd /opt/gdbm-1.8.3/lib
     $ ls libgdbm.*
     libgdbm.a  libgdbm.so

Por consiguiente, el fichero del objeto compartido libgdbm.so es usado de manera preferente a la librería estática libgdbm.a.

Sin embargo, cuando el fichero ejecutable es iniciado su función de carga, debe encontrar la librería compartida para cargarlo en memoria. Por defecto el cargador busca librerías compartidas sólo en un conjunto predefinido de directorios de sistema tales como /usr/local/lib y /usr/lib. Si la librería no está localizada en uno de estos directorios debe ser añadida a la ruta de carga. (Nótese que el directorio que contiene la librería compartida puede, en principio, ser guardado (``hard-coded'') en el propio ejecutable usando la opción del enlazador -rpath, pero esto no es hecho normalmente debido a que da problemas si la librería se ha movido o el ejecutable está copiado a otro sistema.)

El camino más simple para definir la ruta de carga es a través de la variable de entorno LD_LIBRARY_PATH. Por ejemplo, los comandos siguientes definen la ruta de carga a /opt/gdbm-1.8.3/lib y así el fichero libgdbm.so puede ser encontrado:

     $ LD_LIBRARY_PATH=/opt/gdbm-1.8.3/lib
     $ export LD_LIBRARY_PATH
     $ ./a.out
     Almacenado el par clave-valor... hecho.

El ejecutable ahora funciona bien, imprime su mensaje y crea un fichero DBM llamado test conteniendo el par clave:valor clavetest y valortest.

Para ahorrar escritura, la variable de entorno LD_LIBRARY_PATH puede ser definida de forma automática por cada sesión usando el apropiado fichero de login, tal como .bash_profile para la shell GNU Bash.

Varios directorios de librerías compartidas pueden ser fijadas en la ruta de carga, como una lista separada por dos puntos DIR1:DIR2:DIR3:...:DIRN. Por ejemplo, el siguiente comando define la ruta de carga para usar los directorios lib bajo /opt/gdbm-1.8.3 y /opt/gtk-1.4:

     $ LD_LIBRARY_PATH=/opt/gdbm-1.8.3/lib:/opt/gtk-1.4/lib
     $ export LD_LIBRARY_PATH

Si la ruta de carga contiene entradas existentes, puede ser extendida usando la sintaxis LD_LIBRARY_PATH=NEWDIRS:$LD_LIBRARY_PATH. Por ejemplo, el siguiente comando añade el directorio /opt/gsl-1.5/lib a la ruta mostrada arriba:

     $ LD_LIBRARY_PATH=/opt/gsl-1.5/lib:$LD_LIBRARY_PATH
     $ echo $LD_LIBRARY_PATH
     /opt/gsl-1.5/lib:/opt/gdbm-1.8.3/lib:/opt/gtk-1.4/lib

Para el administrador de sistemas es posible definir la variables LD_LIBRARY_PATH para todos los usuarios, añadiéndola al script de login por defecto, normalmente /etc/profile. En sistemas GNU, una ruta de sistema puede ser también definida en el fichero de configuración del cargador /etc/ld.so.conf.

De manera alternativa, el enlace estático puede ser forzado con la opción -static de gcc para evitar el uso de librerías compartidas:

     $ gcc -Wall -static -I/opt/gdbm-1.8.3/include/
         -L/opt/gdbm-1.8.3/lib/ dbmain.es.c -lgdbm

Esto crea un ejecutable enlazado con la librería estática libgdbm.a que puede ser ejecutada sin asignar la variable de entorno LD_LIBRARY_PATH o poniendo librerías compartidas en los directorios por defecto:

     $ ./a.out
     Almacenando el par clave-valor... hecho.

Como ya se comentó, también es posible enlazar directamente con librerías de ficheros individuales especificando la ruta completa a la librería en la línea de comandos. Por ejemplo, el siguiente comando enlazará directamente con la librería estática libgdbm.a,

     $ gcc -Wall -I/opt/gdbm-1.8.3/include
         dbmain.es.c /opt/gdbm-1.8.3/lib/libgdbm.a

y el comando de abajo enlazará con el fichero de librería compartida libgdbm.so:

     $ gcc -Wall -I/opt/gdbm-1.8.3/include
         dbmain.es.c /opt/gdbm-1.8.3/lib/libgdbm.so

En el último caso aún es necesario definir la ruta de carga de librería cuando se ejecuta el ejecutable.

Estándares del lenguaje C
=========================

Por defecto, gcc compila programas usando el dialecto GNU del lenguaje C, llamado como GNU C. Este dialecto incorpora el estándar oficial ANSI/ISO para el lenguaje C con varias extensiones útiles de GNU, tales como funciones anidadas y vectores de tamaño variable. La mayoría de los programas ANSI/ISO compilarán bajo GNU C sin cambios.

Hay varias opciones que controlan el dialecto de C usado por gcc. Las opciones más comúnmente usadas son -ansi y -pedantic. Los dialectos específicos del lenguaje C por cada estándar pueden también ser seleccionadas con la opción -std.

ANSI/ISO
--------

A veces un programa ANSI/ISO puede ser incompatible con las extensiones de GNU C. Para tratar con esta situación, la opción del compilador -ansi inhabilita las extensiones de que están en conflicto con el estándar ANSI/ISO. Los sistemas que usan la GNU C Library (glibc) también deshabilitan las extensiones a la librería estándar de C. Esto permite que los programas escritos para ANSI/ISO sean compilados sin efectos no deseados de extensiones de GNU.

Por ejemplo, aquí hay un programa ANSI/ISO C válido que usa una variable llamada asm:

          [file ansi.es.c not included]

El nombre de variable asm es válido bajo el estándar ANSI/ISO, pero este programa no compilará en GNU C porque asm es una palabra reservada de la extensión GNU C (permite instrucciones de ensamblador nativas para ser usadas en funciones C). Por consiguiente, no puede ser usado como un nombre de variable sin dar un error de compilación:

     $ gcc -Wall ansi.c
     ansi.c: In function 'main':
     ansi.c:6:14: error: expected identifier or '(' before 'asm'
     ansi.c:7:39: error: expected expression before 'asm'

En contraste, usar la opción -ansi inhabilita la palabra clave asm, y permite que el programa anterior sea compilado correctamente:

     $ gcc -Wall -ansi ansi.es.c
     $ ./a.out
     la cadena asm es '6502'

Por referencia, las palabras reservadas no estándar y las macros definidas por las extensiones GNU C son asm, inline, typeof, unix y vax. Se pueden encontrar más detalles en el Manual de Referencia de GCC ``Using GCC'' (see Lectura adicional).

El siguiente ejemplo muestra el efecto de la opción -ansi en sistemas usando la GNU C Library, tales como sistemas GNU/Linux. El programa suguiente imprime el valor de pi, \pi=3.14159..., dado por la definición del preprocesador M_PI en el fichero de cabecera math.h:

          [file pi.es.c not included]

La constante M_PI no es parte de la librería estándar ANSI/ISO de C (viene de la versión BSD de Unix). En este caso, el programa no compilará con la opción -ansi:

     $ gcc -Wall -ansi pi.c
     pi.c: In function 'main':
     pi.c:7:38: error: 'M_PI' undeclared (first use in this
      function)
     pi.c:7:38: note: each undeclared identifier is reported
     only once for each function it appears in

El programa puede ser compilado sin la opción -ansi. En este caso tanto el lenguaje como las extensiones de librería están habilitadas por defecto:

     $ gcc -Wall pi.es.c
     $ ./a.out
     el valor de pi es 3.141593

También es posible compilar el programa usando ANSI/ISO C, habilitando sólo las extensiones en la GNU C Library. Esto puede ser logrado definiendo macros especiales, tales como _GNU_SOURCE, que habilita extensiones en GNU C Library: (La opción -D para la definición de macros será explicada en detalle en el siguiente capítulo.)

     $ gcc -Wall -ansi -D_GNU_SOURCE pi.es.c
     $ ./a.out
     el valor de pi es 3.141593

La GNU C Library (Librería GNU C) proporciona un número de estas macros (referidas como macros de test de funcionalidad) que permiten controlar a través del soporte para extensiones POSIX (_POSIX_C_SOURCE), extensiones BSD (_BSD_SOURCE), extensiones SVID (_SVID_SOURCE), extensiones XOPEN (_XOPEN_SOURCE) y extensiones GNU (_GNU_SOURCE).

La macro _GNU_SOURCE habilita todas las extensiones juntas, siendo las extensiones precedentes al resto en los casos donde haya conflicto. Información adicional acerca de las macros de test de funcionalidad puede ser encontrada en el GNU C Library Reference Manual (see Lectura adicional).

ANSI/ISO estricto
-----------------

La opción -pedantic del comando gcc en combinación con la opción -ansi hará que gcc rechace todas las extensiones de GNU C, no sólo aquellas que son incompatibles con el estándar ANSI/ISO. Esto ayudará a escribir programas portables que siguen el estándar ANSI/ISO.

Aquí hay un programa que usa arrays de tamaño variables, una extensión de GNU C. El array x[n] es declarado con un tamaño especificado por la variable entera n.

          [file gnuarray.es.c not included]

Este programa compilará con la opción -ansi, porque soporta arrays de tamaño variable que no interfieren con la compilación de programas ANSI/ISO válidos ---ésta es una extensión compatible hacia atrás:

     $ gcc -Wall -ansi gnuarray.es.c

Sin embargo, compilar con -ansi -pedantic devuelve avisos de las violaciones del estándar ANSI/ISO:

     $ gcc -Wall -ansi -pedantic gnuarray.es.c
     gnuarray.es.c: In function `main':
     gnuarray.es.c:5: warning: ISO C90 forbids variable-size
       array `x'

Nótese que una ausencia de avisos con -ansi -pedantic no garantiza que un programa cumpla estrictamente con el estándar ANSI/ISO. El estándar en sí especifica sólo un limitado conjunto de circunstancias que deberían generar diagnósticos, y estos son los que se informa con -ansi -pedantic.

Seleccionando estándares específicos
------------------------------------

El estándar específico del lenguaje usado por GCC puede ser controlado con la opción -std. Los siguientes estándares del lenguaje C son soportados:

-std=c89 o -std=iso9899:1990
     El estándar original ANSI/ISO C (ANSI X3.159-1989, ISO/IEC 9899:1990). GCC incorpora las correcciones en los dos ISO Technical Corrigiendo al estándar original.

-std=iso9899:199409
     El lenguaje estándar ISO de C con el ISO Amendment 1, publicado en 1994. Esta enmienda era concerniente principalmente con internacionalización, tales como añadir soporte para caracteres multi-byte a la librería C.

-std=c99 o -std=iso9899:1999
     El lenguaje estándar ISO de C, publicado en 1999 (ISO/IEC 9899:1999).

El lenguaje estándar de C con las extensiones de GNU puede ser seleccionado con las opciones -std=gnu89 y -std=gnu99.

Opciones de aviso en -Wall
==========================

Tal como se describió antes (see Compilando un pequeño programa C), la opción de aviso -Wall habilita avisos para muchos errores comunes, y siempre se debería usar. -Wall puede combinarse con un largo número de otras opciones de aviso, más específicas, que también pueden ser seleccionadas individualmente. Aquí hay un resumen de estas opciones:

-Wcomment (incluida en -Wall)
     Esta opción avisa acerca de comentarios anidados. Los comentarios anidados normalmente surgen cuando una sección de código contiene comentarios después de haber sido ya comentada:

          /* comienzo de comentario
          double x = 1.23 ; /* posición x */
          */

     Los comentarios anidados pueden ser una fuente de confusión ---el camino seguro de ``comentar'' una sección de código que contiene comentarios es usar la directiva del preprocesador #if 0 ... #endif alrededor de ella:

          /* comentario exterior */
          #if 0
          double x = 1.23 ; /* posición x */
          #endif example

     -Wformat (incluida en -Wall)
          Esta opción avisa acerca del incorrecto uso del formato de cadenas
          en funciones tales como printf y scanf, donde el
          especificador de formato no concuerda con el tipo del correspondiente
          argumento de la función.

     -Wunused (incluida en -Wall)
          Esta opción avisa acerca de variables no usadas. Cuando una variable
          es declarada pero no se usa, puede ser debido a que otra variable ha
          sido accidentalmente sustituida en su lugar. Si la variable realmente
          no se necesita, ésta pueder ser eliminada del código fuente.

     -Wimplicit (incluida en -Wall)
          Esta opción avisa de cualquier función que es usada sin haber sido
          declarada. La razón más común para que una función sea usada
          sin haber sido declarada es haber olvidado incluir un fichero de cabecera.

     -Wreturn-type (incluida en -Wall)
          Esta opción avisa de funciones que por su definición no tienen
          tipo de retorno, pero no son declaradas como void. También
          avisa de sentencias con un return vacío en
          funciones que no son declaradas void.

          Por ejemplo, el siguiente programa no usa un valor de retorno
          explícito:

                    [file main4.es.c not included]

          La falta de un valor de retorno en el código de arriba
          podría ser el resultado de una omisión accidental por
          el programador ---el valor devuelto por la función main es el valor
          de retorno de la función printf (el número de caracteres
          impresos). Para evitar ambiguedad, es preferible usar un valor
          explícito en la sentencia de retorno, bien una variable,
          ó bien una constante, como return 0.

El conjunto completo de opciones de aviso incluidas en -Wall puede encontrarse en el Manual de Referencia de GCC ``Using GCC'' (see Lectura adicional). Las opciones incluidas en -Wall tienen la característica común de informar de construcciones son siempre erróneas, o pueden ser fácilmente reescritas en un inambiguo camino correcto. Esta es la razón de que éstos sean tan útiles ---cualquier aviso producido por -Wall puede ser tomado como una indicación de un potencial serio problema.

Opciones de aviso adicionales
=============================

GCC proporciona muchas otras opciones de aviso que no son incluidas en -Wall pero que con frecuencia son útiles. Generalmente estas producen avisos para el código fuente que puede ser técnicamente válido, pero puede causar problemas. El criterio para estas opciones está basado en la experiencia de errores comunes ---estos no son incluidos en -Wall sólo indican posibles problemas o código ``sospechoso''.

Debido a que estos avisos pueden ser resueltos con código válido no es necesario compilar con estas opciones todo el tiempo. Es más apropiado usarlas periódicamente y revisar los resultados, comprobando cualquier cosa inesperada, o habilitarlas para algunos programas o ficheros.

-W
     Esta es una opción general similar a -Wall que avisa acerca de una selección de errores comunes de programación, tales como funciones que no devuelven un valor, y comparaciones entre valores con y sin signo. Por ejemplo, la siguiente función comprueba si un entero sin signo es negativo (lo cual es imposible, claro):

               [file w.es.c not included]

     Tras compilar esta función con -Wall no se produce ningún aviso,

          $ gcc -Wall -c w.es.c

     pero da un aviso con -W:

          $ gcc -W -c w.c
          w.c: In function 'foo':
          w.c:4:3: warning: comparison of unsigned
          expression < 0 is always false [-Wtype-limits]

     En la práctica, las opciones -W y -Wall se usan juntas.

-Wconversion
     Esta opción avisa acerca de conversiones implícitas de tipo que podrían causar resultados inesperados, tales como conversiones entre tipos reales y enteros, entre tipos con y sin signo y entre tipos de diferente tamaño (por ej. enteros long y short). Las conversiones pueden ocurrir en expresiones y asignaciones, y en llamadas a funciones si los tipos de los argumentos no concuerdan con aquellos especificados en el prototipo.

     Por ejemplo, el valor entero de la función absoluto int abs(int i) es fácilmente confundido con la correspondiente función de coma flotante double fabs(double x). Esto puede traer resultados incorrectos, como muestra el siguiente programa:

               [file wabs.es.c not included]

     Tras compilar esta función con -Wall no se produce ningún aviso,

          $ gcc -Wall wabs.es.c
          $ ./a.out
          x = -3.14 |x| = 3  (incorrecto)

     pero da un aviso con -Wconversion:

          $ gcc -Wall -Wconversion wabs.c
          wabs.c: In function 'main':
          wabs.c:8:3: warning: conversion to 'int' from
          'double' may alter its value [-Wconversion]

     La opción -Wconversion también captura errores tales como la asignación de un valor negativo a una variable sin signo, como en el siguiente código,

          unsigned int x = -1;

     Esto está permitido técnicamente por el estándar ANSI/ISO C (con el entero negativo siendo convertido a entero positivo, de acuerdo a la representación de la máquina) pero podría ser un simple error de programación. Si se necesita realizar tal conversión se puede usar un cast explícito, tal como (unsigned int)-1, para evitar avisos con esta opción. En máquinas con complemento a dos el cast de -1 da el máximo número que puede ser representado por un entero sin signo.

-Wshadow
     Esta opción avisa acerca de la redeclaración de un nombre de variable en un contexto en el que ha sido declarado. Esto define una variable oculta, y causa la confusión de qué ocurrencia de la variable corresponde a qué valor.

     La siguiente función declara una variable local y que oculta la declaración en el cuerpo de la función:

               [file shadow.es.c not included]

     Esto es ANSI/ISO C válido, y el valor devuelto es 1. La ocultación de la variable y podría parecer (de manera incorrecta) que el valor devuelto es x, al mirar la línea y = x (especialmente en una larga y complicada función).

     La ocultación también puede ocurrir en nombres de función. Por ejemplo, el siguiente programa intenta definir una variable sin que oculta la función estándar sin(x).

               [file shadow2.es.c not included]

     Este error será detectado con la opción -Wshadow.

-Wcast-qual
     Esta opción avisa de punteros que son transformados para eliminar un calificador de tipo tal como const. Por ejemplo, la siguiente función descarta el calificador const desde su argumento de entrada, permitiéndole ser sobreescrito:

               [file castqual.es.c not included]

     La modificación de los contenidos originales de str es una violación de la propiedad const. Esta opción avisará de la inapropiada transformación de la variable str que permite que la cadena sea modificada.

-Wwrite-strings
     Esta opción implícitamente da a todas las constantes definidas en el programa un calificador const, causando un aviso en tiempo de compilación si hay un intento de sobreescribirlo. El resultado de modificar una cadena constante no está definido por el estándar ANSI/ISO, y el uso de constantes de cadena escribibles está obsoleto en GCC.

-Wtraditional
     Esta opción avisa acerca de partes de código que deberían ser interpretadas de manera diferente por un compilador ANSI/ISO y un compilador ``tradicional'' pre-ANSI. (La forma tradicional del lenguaje C fué descrita en el manual de referencia original de C ``The C Programming Language (First Edition)'' por Kernighan y Ritchie.) Cuando se mantiene software legado puede ser necesario investigar si en el código original se pretendía la interpretación ANSI/ISO o la tradicional para entender los avisos generados por esta opción.

Las opciones anteriores producen mensajes de avisos de diagnóstico, pero permiten la compilación para continuar y producir un fichero objeto o ejecutable. Para programas grandes esto puede ser deseable para capturar todos los avisos deteniendo la compilación siempre que se genera un aviso. La opción -Werror cambia el comportamiento por defecto al convertir los avisos en errores, parando la compilación siempre y cuando ocurra un aviso.

Opciones de aviso recomendadas
==============================

Las siguiente opciones son una buena elección para encontrar problemas en programas C y C++:

     $ gcc -ansi -pedantic -Wall -W -Wconversion
         -Wshadow -Wcast-qual -Wwrite-strings

Aunque esta lista no es exhaustiva, el uso regular de estas opciones capturará muchos errores comunes.

Usando el preprocesador
***********************

Este capítulo describe el uso del preprocesador C GNU cpp, que forma parte del paquete GCC. Este preprocesador expande las macros en los ficheros fuentes antes de ser compilados. Es invocado de forma automática cada vez que GCC procesa un programa C o C++. (En recientes versiones de GCC el preprocesador está integrado dentro del compilador, aunque un comando por separado cpp está siempre incluido.)

Definiendo macros
=================

El siguiente programa demuestra el uso habitual del preprocesador C. Se usa la instrucción condicional del preprocesador #ifdef para comprobar si la macro ya fué definida:

          [file dtest.es.c not included]

Cuando la macro está definida, el preprocesador incluye el código correspondiente antes del comando de cierre #endif. En este ejemplo la macro comprobada es llamada TEST, y la parte condicional del código fuente es la instrucción printf que imprime el mensaje ``Modo test''.

La opción de gcc -DNAME define una macro del preprocesador NAME desde la línea de comandos. Si el programa anterior es compilado con la opción de línea de comandos -DTEST, la macro TEST será definida y el ejecutable resultante imprimirá ambos mensajes:

     $ gcc -Wall -DTEST dtest.es.c
     $ ./a.out
     Modo test
     Ejecutando... example

     Si el programa es compilado sin la opción -D entonces el
     mensaje ``Modo test'' se omite del código fuente después
     del preproceso, y el ejecutable final no incluirá el código para él:

          $ gcc -Wall dtest.es.c
          $ ./a.out
          Ejecutando...

     Las macros están generalmente indefinidas, a menos que sea
     especificada en la línea de comandos, o en un archivo
     fuente (o un archivo de cabecera de librería) con
     #define. Algunas macros son definidas de forma automática por
     el compilador ---habitualmente usan un espacio de nombres reservado
     comenzando con un prefijo de doble subrayado __.

     El conjunto completo de macros predefinidas por el preprocesador puede
     ser listado ejecutanto el preprocesador cpp con la opción
     -dM en un archivo vacio:

          $ cpp -dM /dev/null
          #define __i586 1
          #define __WINT_MAX__ 4294967295U
          #define __ORDER_LITTLE_ENDIAN__ 1234
          #define __SIZE_MAX__ 4294967295U
          .......

     Obsérvese que este listado incluye un pequeño número de macros
     específicas del sistema definidas por gcc que no
     usan el prefijo de doble subrayado. Estas macros no estándar pueden
     ser deshabilitadas con la opción -ansi de gcc.

Macros con valor
================

Cuando es definida, una macro puede además tener asignado un valor. Este valor es sustituido dentro del código fuente en cada lugar donde aparezca la macro. El siguiente programa usa la macro NUM, para representar que será impreso:

          [file dtestval.es.c not included]

Observe las macros no se expanden dentro de la cadena ---solo la ocurrencia de NUM fuera de la cadena es sustituida por el preprocesador.

Para definir una macro con un valor, se usa la opción -D en la línea de comandos en la forma -DNAME=VALUE. Por ejemplo, la siguiente línea de comandos define NUM a 100 mientras se compila el programa anterior:

     $ gcc -Wall -DNUM=100 dtestval.es.c
     $ ./a.out
     El valor de NUM es 100

Este ejemplo usa un número, pero una macro puede tomar valores de cualquier forma. Cuando el valor de un macro está asignado, éste es insertado directamente dentro del código fuente donde la macro aparezca. Por ejemplo, la siguiente definición expande las ocurrencias de NUM a 2+2 durante el preprocesamiento:

     $ gcc -Wall -DNUM="2+2" dtestval.es.c
     $ ./a.out
     El valor de NUM es 4 example

     Una vez que el preprocesador ha realizado la sustitución NUM
     ==> 2+2 es equivalente a compilar el siguiente programa:

               [file dtestval2.es.c not included]

     Observe que una buena idea es encerrar las macros entre paréntesis
     siempre que formen parte de una expresión. Por ejemplo, el programa
     siguiente usa paréntesis para asegurar la correcta precedencia para
     la multiplicación 10*NUM:

               [file dtestval3.es.c not included]

     Con estos paréntesis, se produce el resultado esperado cuando se
     compila con la misma línea de comandos anterior:

          $ gcc -Wall -DNUM="2+2" dtestval3.es.c
          $ ./a.out
          Diez veces NUM es 40 example

          Sin los paréntesis, el programa hubiera producido el valor 22
          desde la forma literal de la expresión 10*2+2 = 22, en vez
          del valor deseado 10*(2+2) = 40.

          Cuando una macro es definida solo con la opción -D,
          gcc usa el valor por defecto 1. Por ejemplo, compilando
          el programa test original con la opción -DNUM se genera un
          ejecutable que produce la siguiente salida:

               $ gcc -Wall -DNUM dtestval.es.c
               $ ./a.out
               El valor de NUM es 1

          Una macro puede ser definida con un valor vacio usando comillas en la
          línea de comandos, -DNAME="". Tal macro
          será tratada como definida por las instrucciones condicionales,
          tal como #ifdef, pero no se expande en nada.

          Una macro que contenga comillas se puede definir usando el carácter de
          escape de la shell. Por ejemplo, la opción
          -DMESSAGE='"¡Hola, Mundo!"' define una macro
          MESSAGE que se expandirá en la secuencia de caracteres
          "¡Hola, Mundo!". Los caracteres de escape
          '...' protegen los comillas de la cadena
          "¡Hola, Mundo!". Para una explicación de los
          diferentes tipos de comillas y secuencias de escape usandas en la
          shell vea ``GNU Bash Reference Manual'',Lectura adicional.

Preprocesando archivos fuentes
==============================

Es posible ver el efecto del preprocesador en los archivos fuentes directamente, usando la opción -E de gcc. Por ejemplo, el fichero siguiente define y usa la macro TEST:

          [file test.es.c not included]

Si este fichero se llama test.es.c el efecto del preprocesador puede ser visto con la siguiente línea de comandos:

     $ gcc -E test.es.c
     # 1 "test.es.c"
     # 1 "<built-in>"
     # 1 "<command-line>"
     # 1 "test.es.c"

     const char str[] = "¡Hola, Mundo!";

La opción -E causa que gcc ejecute el preprocesador, muestre la salida expandida, y termine sin compilar el código fuente resultante. El valor de la macro TEST es sustituido directamente en la salida, produciendo la secuencia de caracteres const char str[] = "¡Hola, Mundo!" ;.

El preprocesador además inserta líneas de registro del archivo fuente y el número de línea en la forma # NÚMERO-DE-LÍNEA "ARCHIVO-FUENTE", para ayudar en la depuración y permite al compilador mostrar los mensajes de error referentes a esta información. Estas líneas no afectan al programa en sí.

La posibilidad de ver los archivos fuentes precompilados puede resultar útil para examinar los efectos de los archivos de cabeceras del sistema, y encontrar las declaraciones de las funciones del sistema. El siguiente programa incluye el archivo de cabecera stdio.h para obtener la declaración de la función printf:

          [file hola.es.c not included]

Es posible examinar las declaraciones incluidas en los archivos de cabeceras preprocesando el archivo con gcc -E:

     $ gcc -E hola.es.c

En un sistema GNU, esto produce una salida similar a lo siguiente:

     # 1 "hola.es.c"
     # 1 "/usr/include/stdio.h" 1 3
     extern FILE *stdin;
     extern FILE *stdout;
     extern FILE *stderr;

     extern int fprintf (FILE * __stream,
                         const char * __format, ...)  ;
     extern int printf (const char * __format, ...)  ;

      [ ... declaraciones adicionales ... ]
     # 1 "hola.es.c" 2
     int
     main (void)
     {
       printf ("¡Hola, Mundo!");
       return 0;
     }

Los archivos de cabeceras del sistema preprocesados suelen generar una extensa salida. Ésta puede ser redirigida a un archivo, o almacenada más convenientemente usando la opción -save-temps:

     $ gcc -c -save-temps hola.es.c example

     Después de ejecutar este comando, la salida del preprocesador
     estará disponible en el archivo hola.i. La opción
     -save-temps además almacena los archivos de ensamblado
     .s y los archivos objetos .o además de los archivos
     preprocesados .i.

Compilando para depuración
**************************

Normalmente, un archivo ejecutable no contiene ninguna referencia del archivo fuente original, tal como nombres de variables o números de línea ---el archivo ejecutable es una simple secuencia de instrucciones en código máquina producidas por el compilador. Esto es insuficiente para depuración, ya que no es una tarea fácil la forma de encontrar la causa del fallo en un programa.

GCC proporciona la opción de depuración -g para guardar información de depuración en los archivos objetos y ejecutables. Esta información de depuración permite seguir la pista de los errores desde una instrucción específica a la correspondiente línea en el código fuente original. La ejecución de un programa compilado con -g puede ser seguido por un depurador, tal como el Depurador GNU gdb (para más informacón vea ``Debugging with GDB: The GNU Source-Level Debugger'', Lectura adicional). Usando un depurador es posible examinar los valores de las variables mientras está en ejecución un programa.

La opción de depuración del compilador funciona almacenando los nombres de funciones y variables y las líneas del código fuente en una tabla de símbolos en el archivo objeto o ejecutable.

Examinando archivos core
========================

Adicionalmente a permitir que un programa se ejecute en un depurador, un importante beneficio de la opción -g es que permite examinar la causa del fallo de un programa a través de un ``core dump''.

Cuando un programa termina de forma anormal (p.e. un fallo) el sistema operativo puede escribir un core file (habitualmente llamado core) que contiene el estado de memoria del programa en el momento del fallo. Este fichero es a menudo referido como un core dump. (Esta terminología data de los tiempos de las memorias magnéticas.) Combinada con la información de la tabla de símbolos producida por la opción -g, se puede usar el core dump para encontrar la línea donde el programa se paró, y los valores de las variables en este punto.

Esto es muy usado tanto durante el desarrollo de software como después del desarrollo ---permite investigar los problemas cuando un programa falla ``a pié de campo''.

Aquí hay un simple ejemplo de un programa que contiene un fallo de acceso inválido a memoria, el cual se usará para producir un archivo core dump:

          [file null.es.c not included]

Este programa intenta referenciar un puntero nulo p, lo cual es una operación inválida. En la mayoría de lo sistemas operativos, esto causa un fallo del programa.  (Históricamente, un puntero nulo correspondía con la posición 0 de memoria, la cual es normalmente restringida por el kernel del sistema operativo. En la práctica no siempre es así como se trata un puntero nulo, pero el resultado es habitualmente el mismo.)

Para que sea posible encontrar la causa de un posterior fallo, se necesitará compilar el programa con la opción -g:

     $ gcc -Wall -g null.es.c

Observe que el puntero nulo sólo causará un problema en tiempo de ejecución, así la opción -Wall no producirá ningún aviso.

Haciendo correr el archivo ejecutable en un sistema x86 GNU/Linux causará que el sistema operativo lo finalice de forma anormal:

     $ ./a.out
     Segmentation fault (core dumped)

Siempre que aparezca el mensaje core dumped, el sistema operativo producirá un archivo denominado core en el directorio en curso.  (Algunos sistemas, tales como FreeBSD y Solaris, se pueden configurados para escribir los archivos core en directorios específicos, p.e. /var/coredumps/, usando los comandos sysctl y coreadm.) Este archivo core contiene una copia completa de las páginas de memoria que el programa mantenía en el momento de su finalización. A propósito, el término segmentation fault se refiere al hecho de que el programa intentó un acceso a un ``segmento'' de memoria restringido fuera del área de memoria que tiene reservada para él.

Algunos sistemas están configurados para no escribir archivos core por defecto, debido a que los archivos pueden ser muy grandes y rápidamente ocupan el espacio disponible en los discos de un sistema. En la shell GNU Bash el comando ulimit -c controla el tamaño máximo de los archivos core. Si el límite de tamaño es 0, no se producirán archivos core. El tamaño límite actual se puede mostrar introduciendo el siguiente comando:

     $ ulimit -c
     0

Si el resultado es cero, como se mostró anteriormente, entonces puede ser incrementado con el siguiente comando para permitir escribir archivos core de cualquier tamaño:  (Este ejemplo usa el comando ulimit en la Bash shell GNU. En otros sistemas operativos el uso de ulimit puede variar, y tener un nombre diferente (la shell tcsh a su vez, usa el nombre limit). El tamaño límite de los archivos core puede ser puesto a un valor específico en kilobytes.)

     $ ulimit -c unlimited

Observe que esta configuración solo aplica en la shell actual. Para poner límite en futuras sesiones el comando se deberá poner en el archivo adecuado de entrada al sistema, tal como .bash_profile para la Bash shell GNU.

Los archivos core pueden ser cargados por el Depurador GNU gdb con el siguiente comando:

     $ gdb FICHERO-EJECUTABLE FICHERO-CORE

Observe que tanto el archivo ejecutable original como el archivo core son requeridos para la depuración ---no es posible depurar un archivo core sin el correspondiente ejecutable. En este ejemplo, podemos cargar los archivos ejecutable y core con el comando:

     $ gdb a.out core

El depurador inmediatamente comienza a imprimir información de diagnóstico, y muestra un listado de la línea donde el programa ha fallado (línea 13):

     $ gdb a.out core
     Core was generated by `./a.out'.
     Program terminated with signal 11, Segmentation fault
     Reading symbols from /lib/libc.so.6...done.
     Loaded symbols for /lib/libc.so.6
     Reading symbols from /lib/ld-linux.so.2...done.
     Loaded symbols for /lib/ld-linux.so.2
     #0  0x080483ed in foo (p=0x0) at null.es.c:13
     13        int y = *p;
     (gdb) example

     La línea final (dbg) es el prompt del depurador
     GNU ---indica que se pueden introducir posteriores comandos en este
     punto. (Los detalles de la salida de diagnóstico pueden
     variar ligeramente dependiendo de que versión de gdb esté
     usando.)

     Para investigar la causa del fallo, mostramos el valor del puntero
     p usando el comando print del depurador:

          (gdb) print p
          $1 = (int *) 0x0

     Se muestra que p es un puntero nulo (0x0) del tipo
     int *, así nosotros sabemos que la referencia a
     él con la expresión p en esta línea a causado
     el fallo.

Mostrando un rastreo
====================

El depurador puede mostrar las llamadas a funciones y sus argumentos hasta el punto actual de ejecución ---esto es llamado pila de rastreo (stack backtrace) y se muestra con el comando backtrace:

     (gdb) backtrace
     #0  0x080483ed in foo (p=0x0) at null.es.c:13
     #1  0x080483d9 in main () at null.es.c:7

En este caso, la pila de llamadas muestra que el fallo ocurrió en la línea 13 después de que la función foo fuera llamada desde main con el argumento p=0x0 en la línea 7 de null.es.c. Es posible moverse por los diferentes niveles de la pila de llamadas, usando los comandos del depurador up y down.

Poniendo un punto de ruptura
============================

Un punto de ruptura (breakpoint) detiene la ejecución del programa y devuelve el control al depurador, donde las variables y la memoria pueden ser examinadas antes de continuar. Los puntos de ruptura pueden ponerse en funciones específicas, líneas o localizaciones de memoria con el comando break.

Para poner un breakpoint en una función, usa el comando break FUNCTION-NAME. Por ejemplo, el siguiente comando pone un breakpoint al inicio de la función main en el programa anterior:

     $ gdb a.out
     (gdb) break main
     Breakpoint 1 at 0x80483c6: file null.es.c, line 6.

El depurador tomará el control del programa cuando la función main sea llamada. Como la función main es la primera función en ser ejecutada en un programa C, el programa se detendrá inmediatamente cuando se ejecute:

     (gdb) run
     Starting program: a.out
     Breakpoint 1, main () at null.es.c:6
     6         int *p = 0;   /* null pointer */
     (gdb)

La consola muestra la línea que será ejecutada en siguiente lugar (el número de línea se muestra a la izquierda). El breakpoint detiene el programa antes de ejecutar la línea, en este instante el puntero p está indefinido y no ha sido puesto a cero aún.

Paso a paso a través de un programa
===================================

Para avanzar y ejecutar la línea mostrada anteriormente, usa el comando step:

     (gdb) step
     7         return foo (p);

Después de ejecutar la línea 6, el depurador muestra la siguiente línea que será ejecutada. El puntero p está ahora puesto a cero (null):

     (gdb) print p
     $1 = (int *) 0x0

El comando step continuará la ejecución del programa interactivamente a través de cualquier función que sea invocada en la línea actual. Si desea avanzar sin hacer un seguimiento de estas llamadas a funciones, use en cambio el comando next.

Modificando variables
=====================

Para arreglar temporalmente el fallo del puntero nulo descubierto anteriormente, podemos cambiar el valor de p en el programa en ejecución usando el comando set variable.

Las variables pueden ser inicializadas a un valor específico, o ser el resultado de una expresión, la cual puede incluir llamadas a funciones. Esta poderosa característica permite a las funciones de un programa ser testeadas interactivamente a través del depurador.

En este caso, interactivamente, se reservará algo de memoria para el puntero p usando la función malloc, almacenando el valor 255 en la localización de memoria resultante:

     (gdb) set variable p = malloc(sizeof(int))
     (gdb) print p
     $2 = (int *) 0x40013f98 (dirección reservada por malloc)
     (gdb) set variable *p = 255
     (gdb) print *p
     $3 = 255 example

     Si ahora continuamos avanzando en el programa con el nuevo valor de
     p el anterior fallo de segmentación no se producirá:

          (gdb) step
          foo (p=0x40013f98) at null.es.c:13
          13        int y = *p;
          (gdb) step
          14        return y;

Continuando la ejecución
========================

El comando finish continua la ejecución hasta el final de la actual función, mostrando el valor de retorno:

     (gdb) finish
     Run till exit from #0 0x08048400 in foo (p=0x40013f98)
     at null.es.c:15
     0x080483d9 in main () at null.es.c:7
     7         return foo (p);
     Value returned is $13 = 255

Para continuar la ejecución hasta que el programa termine (o hasta el siguiente breakpoint) use el comando continue,

     (gdb) continue
     Continuing.
     Program exited with code 0377.

Observe que el código de salida se muestra en notación octal (0377 base 8 = 255 en base 10).

Más información
===============

Por simplicidad, los ejemplos de este capítulo demuestran como usar gdb en la línea de comandos. Existen poderosas herramientas como Emacs en modo GDB (M-x gdb), DDD o INSIGHT, interfaces gráficos de gdb. Los enlaces a estos programas se puede encontrar en la página web del editor de este libro. (http://www.network-theory.co.uk/gcc/intro/)

Una completa descripción de todos los comandos disponibles en gdb se puede encontrar en el manual ``Debugging with GDB: The GNU Soure-Level Debugger'' (see Lectura adicional).

Compilando con optimización
***************************

GCC es un compilador de optimización. Suministra un ámplio rango de opciones que ayudan a incrementar la velocidad, o reducir el tamaño, de los archivos ejecutables generados.

La optimización es un proceso complejo. Para cada comando de alto nivel en el código fuente normalmente hay muchas combinaciones posibles de instrucciones máquina que pueden ser usadas para alcanzar los resultados finales apropiados. El compilador debe considerar todas estas posibilidades y elegir entre ellas.

En general, diferente código es generado para diferentes procesadores, ya que usan ensambladores y lenguajes máquina incompatibles. Cada tipo de procesador tiene sus propias características ---Algunas CPUs proporcionan un gran número de registros para manejar los resultados intermedios de cálculos, mientras que otros muchos deben almacenar y recuperar los resultados intermedios de la memoria. El código apropiado debe generarse en cada caso.

Además, diferentes instrucciones necesitan diferentes cantidades de tiempo, dependiendo de como fueron ordenadas. GCC, cuando compila con optimización, toma estos factores en cuenta e intenta producir el ejecutable más rápido para un sistema determinado.

Optimización a nivel de fuentes
===============================

La primera forma de optimización usada por GCC sucede a nivel de código fuente, y no requiere ningún conocimiento de las instrucciones máquina. Hay muchas técnicas de optimización a nivel de código fuente ---esta sección describe dos formas comunes: eliminación de subexpresión común y expansión de función en línea.

Eliminación de subexpresión común
---------------------------------

Un método de optimización a nivel de código fuente fácil de comprender implica el tratamiento de expresiones en el código fuente con menor número de instrucciones, reutilizando resultados ya calculados. Por ejemplo, la siguiente asignación:

     x = cos(v)*(1+sin(u/2)) + sin(w)*(1-sin(u/2))

puede ser reescrita con una variable temporal t y así eliminar evaluaciones extras innecesarias del término sin(u/2):

     t = sin(u/2)
     x = cos(v)*(1+t) + sin(w)*(1-t)

Esta reescritura es denominada eliminación de subexpresiones comunes (CSE) (Nota del traductor: Siglas en inglés de `Common Subexpression Elimination'), y se realiza de forma automática cuando la optimización está activa. (Los valores introducidos temporalmente por el compilador durante la eliminación de subexpresiones comunes son usados sólo internamente, y no afectan a las variables reales. El nombre de la variable temporal t mostrado anteriormente sólo es a modo ilustrativo) La eliminación de subexpresiones comunes es beneficiosa porque simultáneamente incrementa la velocidad y reduce el tamaño del código.

Expansión de función en línea
-----------------------------

Otro tipo de optimización a nivel de código fuente, denominada expansión de función en línea, incrementa la eficiencia de la llamadas a funciones frecuentes.

Cuando una función se invoca, se requiere una cierta cantidad de tiempo extra de CPU para llevar a cabo la llamada: se almacenan los argumentos de la función en los apropiados registros y localizaciones de memoria, se salta al inicio de la función (trayendo las adecuadas páginas de memoria virtual en memoria física ó en la caché de la CPU si fuera necesario), comienza la ejecución del código, y se vuelve al punto original de ejecución donde la llamada a la función se completa. Este trabajo adicional es llamado sobrecarga de la llamada a función. La expansión de función en línea elimina esta sobrecarga sustituyendo llamadas a funciones por el código mismo de la función (conocido como poner el código en-línea).

En la mayoría de los casos, la sobrecarga de las llamadas a funciones es una fracción insignificante del total de tiempo de ejecución de un programa. Puede ser significativo sólo cuando las funciones contienen relativamente pocas instrucciones y emplean una fracción sustancial de tiempo de ejecución ---en este caso la sobrecarga llega a ser una mayor proporción del tiempo de ejecución.

La expansión de funciones en línea son siempre favorables si hay un único punto de invocación a la función. Esto es incondicionalmente mejor si la invocación a una función requiere más instrucciones (memoria) que mover el cuerpo de la función en linea. Esto es una situación habitual para una simple función de acceso en C++, lo cual puede beneficiar mucho a las funciones en línea. Por otra parte, las funciones en línea pueden facilitar optimizaciones futuras, como la eliminación de subexpresiones comunes, mezclando varias funciones separadas en un sencilla función más grande.

La siguiente función sq(x) es un típico ejemplo de una función que se beneficiaría de la expansión de función en línea. Calcula x^2, el cuadrado del argumento x:

     double
     sq (double x)
     {
       return x * x;
     }

Esta función es pequeña, así la sobrecarga de la llamada es comparable al tiempo tomado en ejecutar una simple multiplicación fuera de la función misma. Si esta función se invoca dentro de un bucle, tal y como sucede más abajo, entonces la sobrecarga de la llamada a la función llegaría a ser sustancial:

     for (i = 0; i < 1000000; i++)
       {
          sum += sq (i + 0.5);
       }

La optimización con expansión de función en línea reemplaza el interior del bucle del programa con el cuerpo de la función, dando el siguiente código:

     for (i = 0; i < 1000000; i++)
       {
         double t = (i + 0.5);  /* variable temporal */
         sum += t * t;
       }

La eliminación de la llamada a la función y realizar la multiplicación en línea permite al bucle ejecutarse con máxima eficiencia.

GCC selecciona funciones para poner expandir en línea usando un número de heurísticas, tal como funciones que son adecuadamente pequeñas. Como optimización, las funciones en línea son llevadas a cabo sólo dentro del archivo objeto. La palabra reservada inline pueder ser usada para requerir explícitamente que una función específica deba ser tratada en línea como sea posible, incluyendo sus usos en otros archivos. (En este caso, la definición de la función en línea debe ser hecha en otro archivo (p.e. en un archivo de cabeceras).) El Manual de Referencia de GCC ''Using GCC'' suministra un completo detalle de la palabra reservada inline, y emplea los calificadores static y extern para controlar el enlazado de las funciones en línea explícitamente (see Lectura adicional).

Dilema velocidad-espacio
========================

Mientras que algunas formas de optimización, tales como la eliminación de subexpresiones comunes, son capaces simultáneamente de incrementar la velocidad y reducir el tamaño de un programa, otros tipos de optimización producen código más rápido a costa de incrementar el tamaño del ejecutable. Esta elección entre velocidad y espacio se denomina dilema velocidad-espacio. Las optimizaciones con el dilema velocidad-espacio se pueden usar en sentido inverso para hacer ejecutables pequeños, a cambio de hacerlos correr más lentos.

Desenrollado de bucle
---------------------

Un primer ejemplo de optimización con el dilema velocidad-espacio es Desenrollado de bucle. Esta forma de optimización incrementa la velocidad de los bucles eliminando la condición de terminación del bucle en cada iteración. Por ejemplo, el siguiente bucle de 0 a 7 comprueba la condición i < 8 en cada iteración:

     for (i = 0; i < 8; i++)
       {
         y[i] = i;
       }

Al final del bucle, esta condición ha sido comprobada 9 veces, y gran parte del tiempo de ejecución fué gastado en la comprobación.

Una forma más eficiente de escribir el mismo código es simplemente desenrollar el bucle y ejecuta las instrucciones directamente:

     y[0] = 0;
     y[1] = 1;
     y[2] = 2;
     y[3] = 3;
     y[4] = 4;
     y[5] = 5;
     y[6] = 6;
     y[7] = 7;

Este tipo de código no requiere ningún test, y se ejecuta a la máxima velocidad. Una vez que cada asignación es independiente, permite ser compilado para usar procesamiento paralelo cuando es soportado. Desenrollado de bucle es una optimización que incrementa la velocidad del ejecutable resultante pero generalmente incrementa su tamaño (a menos que el bucle sea muy corto, con sólo una o dos iteraciones, por ejemplo).

Desenrollado de bucle se hace posible cuando el límite superior de un bucle es desconocido, siempre y cuando las condiciones de inicio y terminación sean manejadas correctamente. Por ejemplo, el mismo bucle con un límite superior arbitrario,

     for (i = 0; i < n; i++)
       {
         y[i] = i;
       }

puede ser reescrito por el compilador como sigue:

     for (i = 0; i < (n % 2); i++)
       {
         y[i] = i;
       }

     for ( ; i + 1 < n; i += 2) /* sin inicializador */
       {
         y[i] = i;
         y[i+1] = i+1;
       }

El primer bucle trata el caso i = 0 cuando n es impar, y el segundo bucle trata el resto de iteraciones. Observe que el segundo bucle no usa un inicializador en el primer argumento de la instrucción for, justo continúa donde el primer bucle terminó. Las instrucciones del segundo bucle pueden ser paralelizadas, y el total del número de tests se reduce en un factor de 2 (aproximadamente). Factores mayores se pueden alcanzar desenrollando más instrucciones dentro del bucle, a cambio de agrandar el tamaño del código.

Planificación
=============

El menor nivel de optimización es la planificación, en el cual el compilador determina el mejor orden para las instrucciones individuales. La mayoría de las CPUs permiten que una o más nuevas instrucciones comiencen a ejecutarse antes de que otras hallan terminado. Muchas CPUs tienen soporte para segmentación, donde múltiples instrucciones se ejecutan en paralelo en la misma CPU.

Cuando la planificación está habilitada, las instrucciones pueden disponer de sus resultados llegando a tener disponible la siguiente instrucción en el tiempo correcto, y a permitir un máximo de ejecución en paralelo. La planificación aumenta la velocidad de un ejecutable sin incrementar su tamaño, pero requiere memoria y tiempo adicional en sus procesos de compilación (dada su complejidad).

Niveles de optimización
=======================

Para controlar los tiempos de compilación y el uso de memoria, y la compensación entre velocidad y espacio para el ejecutable resultante, GCC suministra un rango de niveles generales de optimización, numerados desde 0 al 3, así como opciones individuales para tipos específicos de optimización.

El nivel de optimización se elige con la opción -ONIVEL, donde NIVEL es un número del 0 al 3. Los  efectos de los diferentes niveles de optimización se describen a continuación:

-O0 o sin opción -O (por defecto)
     Este nivel de optimización no realiza ninguna optimización y compila el código fuente de la forma más sencilla posible. Cada comando en el código fuente es convertido directamente a sus correspondientes instrucciones en el archivo ejecutable, sin reorganización. Esta es la mejor opción a usar cuando se depura un programa y es la opción por defecto si no se especifica una opción de nivel de optimización.

-O1 o -O
     Este nivel activado es la optimización más frecuente ya que no requiere compensar entre velocidad y espacio. Con esta opción los ejecutables resultantes deberían ser más pequeños y rápidos que con la opción -O0. La optimización más costosa, como la planificación de instrucciones, no es usada a este nivel.

     Compilar con la opción -O1 puede a menudo tomar menos tiempo que la compilación con la opción -O0, debido a la reducida cantidad de datos que necesitan ser procesados después de una simple optimización.

-O2
     Esta opción activa más optimizaciones, además de las empleadas por -O1. Estas optimizaciones adicionales incluyen la planificación de instrucciones. Sólo se emplearán optimizaciones que no requieren compensanción entre velocidad y espacio, así el ejecutable no aumentará de tamaño. Al compilador le costará más compilar programas y necesitará más memoria que con la opción -O1. Esta opción es la más elegida en el desarrollo de programas, porque suministra un máximo de optimización sin incrementar el tamaño del ejecutable. Es la opción del nivel de optimización por defecto en las versiones de paquetes GNU.

-O3
     Esta opción activa las más costosas optimizaciones, tales como funciones en-línea, además de todas las optimizaciones de niveles inferiores -O2 y -O1. El nivel de optimización -O3 incrementa la velocidad del ejecutable. Bajo algunas circunstancias donde esta optimización no es posible, esta opción podría hacer un programa muy lento.

-funroll-loops

     Esta opción activa el desenrollado de bucles, y es independiente de otras opciones de optimización. Se incrementará el tamaño del ejecutable. Si esta opción produce o no un resultado beneficioso será comprobado sobre una base caso por caso.

-Os
     Esta opción selecciona las optimizaciones que reducen el tamaño del ejecutable. El propósito de esta opción es producir el ejecutable menor posible, para sistemas con restricciones de memoria o espacio de disco. En algunos casos un pequeño ejecutable es más rápido, debido al mejor uso de memoria caché.

Es importante recordar que el beneficio de altos niveles de optimización debe sopesarse contra el coste. El coste de la optimización incluye una gran complejidad en depuración, e incrementa los requerimientos de tiempo y memoria durante la compilación. Para la mayoría de los propósitos es conveniente usar la opción -O0 para depuración, y la opción -O2 para el desarrollo y uso posterior.

Ejemplos
========

El siguiente programa será usado para demostrar los efectos de los diferentes niveles de optimización:

          [file optim.es.c not included]

El programa principal contiene un bucle invocando a la función powern. Esta función calcula la enésima potencia de un número en coma flotante con repetición de multiplicaciones ---esto ha sido elegido así porque es conveniente para funciones en línea y desenrollado de bucles. El tiempo de ejecución de un programa puede ser medido usando el comando time en la GNU Bash shell.

Aquí se muestran los resultados para el programa anterior, compilado en un 566MHz Intel Celeron con 16KB L1-cache y 128KB L2-cache, usando GCC 3.3.1 en un sistema GNU/Linux:

     $ gcc -Wall -O0 optim.es.c -lm
     $ time ./a.out
     real    0m13.388s
     user    0m13.370s
     sys     0m0.010s

     $ gcc -Wall -O1 optim.es.c -lm
     $ time ./a.out
     real    0m10.030s
     user    0m10.030s
     sys     0m0.000s

     $ gcc -Wall -O2 optim.es.c -lm
     $ time ./a.out
     real    0m8.388s
     user    0m8.380s
     sys     0m0.000s

     $ gcc -Wall -O3 optim.es.c -lm
     $ time ./a.out
     real    0m6.742s
     user    0m6.730s
     sys     0m0.000s

     $ gcc -Wall -O3 -funroll-loops optim.es.c -lm
     $ time ./a.out
     real    0m5.412s
     user    0m5.390s
     sys     0m0.000s

La entrada relevante en la salida para comparar la velocidad de los ejecutables resultantes es el tiempo user, el cual da el tiempo de CPU empleado en la ejecución del proceso actual. En otras filas, real y sys, registran el tiempo total real de los procesos que se ejecutan (incluyendo los tiempos de otros procesos que están usando la CPU) y el tiempo empleado en esperar las llamadas al sistema operativo. Aunque sólo se ha mostrado una ejecución, las pruebas de rendimiento serán ejecutadas varias veces para confirmar los resultados.

En los resultados puede apreciarse en este caso que incrementando el nivel de optimización con -O1, -O2 y -O3 se produce un incremento de la velocidad. Añadiendo la opción -funroll-loops se produce la mayor rapidez. La velocidad del programa aumenta al doble de la inicial, cuando va desde el código no optimizado al más alto nivel de optimización.

Observe que un pequeño programa como este puede tener considerables variaciones para versiones de sistemas y compiladores. Por ejemplo, en un sistema Mobile 2.0GHz Intel Pentium 4M la tendencia del resultado usando la misma versión de GCC es similar excepto que el rendimiento con -O2 es ligeramente peor que con -O1. Esto ilustra un importante punto: las optimizaciones no necesariamente hacen programas más rápidos en todos los casos.

Optimización y depuración
=========================

Con GCC es posible usar optimización en combinación con la opción -g de depuración. Otros muchos compiladores no permiten esto.

Cuando se usa depuración y optimización juntas, la reorganización interna llevada a cabo por el optimizador puede hacer difícil ver que está haciendo un programa cuando se examinan programas optimizados con el depurador. Por ejemplo, las variables temporales son a menudo eliminadas, y el orden de las instrucciones puede estar cambiado.

Sin embargo, cuando un programa falla inesperadamente, cualquier información de depuración es mejor que nada ---así el uso de -g se recomienda para programas optimizados, tanto para desarrollo como para mantenimiento. La opción -g de depuración está habilitada por defecto en las versiones de los paquetes GNU, junto con la opción -O2 de optimización.

Optimización y avisos del compilador
====================================

Cuando la optimización está activa, GCC puede producir avisos adicionales que no aparecen cuando se compila sin optimización.

Como parte del proceso de optimización, el compilador examina el uso de todas las variables y sus valores iniciales ---esto es llamado un análisis de flujo de datos. Ésto forma la base de otras estrategias de optimización, tales como la planificación de instrucciones. El efecto del análisis del flujo de datos es que el compilador puede detectar el uso de variables indefinidas.

La opción -Wuninitialized (la cual está incluida en Wall) avisa sobre variables que son leidas sin haber sido inicializadas. Sólo funciona cuando el programa es compilado con optimización, de modo que el análisis del flujo de datos está habilitado. La siguiente función contiene un ejemplo con tales variables:

          [file uninit.es.c not included]

Esta función funciona correctamente para la mayoría de argumentos, pero tiene un fallo cuando x es cero ---en este caso el valor de retorno de la variable s será indefinido.

Compilando el programa con la opción -Wall solamente no produce ningún aviso, porque el análisis del flujo de datos no es llevado a cabo sin optimización:

     $ gcc -Wall -c uninit.es.c

Para producir avisos, el programa debe ser compilado con -Wall y optimización simultáneamente. En la práctica, el nivel de optimización -O2 es necesario para obtener buenos avisos:

     $ gcc -Wall -O2 -c uninit.c
     uninit.c: In function 'sign':
     uninit.c:11:3: warning: 's' may be used uninitialized
       in this function [-Wuninitialized]

Esto detecta correctamente la posibilidad de que la variable s sea empleada sin haber sido definida.

Observe que mientras GCC habitualmente encontrará la mayoría de las variables no inicializadas, se estarán usando heurísticas que ocasionalmente fallarán en algunos casos complicados y otras veces falseando avisos. En esta última situación, es a menudo posible reescribir las líneas relevantes de una forma sencilla que elimine los avisos y mejore la legibilidad del código fuente.

Compilando un programa C++
**************************

Este capítulo describe el uso de GCC para compilar programas escritos en C++. y las opciones específicas de línea de comandos para este lenguaje.

El compilador GNU C++ suministrado por GCC es un verdadero compilador de C++ ---compila código fuente directamente en lenguaje ensamblador. Otros ``compiladores'' C++ hacen la traducción convirtiendo los programas C++ en programas C, y compilan el programa C resultante usando el compilador existente. Un verdadero compilador C++, tal como GCC, es capaz de proveer mejor soporte para informar los errores, depuración y optimización.

Compilando un pequeño programa C++
==================================

El procedimiento para compilar un programa C++ es el mismo que para un programa C, pero usa el comando g++ en vez de gcc. Ambos compiladores son parte de la colección de compiladores GNU.

Para mostrar el uso de g++, aquí está la versión del programa Hola Mundo escrita en C++:

          [file hola.es.cc not included]

El programa puede ser compilado con la siguiente línea de comando:

     $ g++ -Wall hola.es.cc -o hola example

     El frontend C++ de GCC usa muchas opciones similares al compilador de
     C gcc. Además, soporta opciones adicionales para controlar
     las características del lenguaje C++, las cuales serán
     descritas en este capítulo. Observe que el código
     fuente C++ debe darse en una de las extensiones válidas para
     archivos C++ .cc, .cpp, cxx o .C en vez de
     la extensión .c usada por programas C.

     El ejecutable resultante puede ser ejecutado de la misma forma que la
     versión C, simplemente tecleando su nombre:

          $ ./hola
          ¡Hola, mundo!

     El ejecutable produce la misma salida que la versión C del programa
     usando std::cout en vez de la función C printf. Todas
     las opciones usadas en comandos gcc en capítulos
     anteriores pueden aplicarse a g++ sin cambios, al igual que los
     procedimientos para compilar y enlazar archivos y
     librerías (usando g++ en vez de gcc, por
     supuesto). Una natural diferencia es que la opción -ansi
     requiere conformidad con el estándar C++, en vez de con el
     estándar C, cuando es usado con g++.

     Observe que los programas que usan archivos objeto C++ deben ser
     enlazados con g++, con objeto de suministrar las
     librerías necesarias. Intentar enlazar un archivo objeto
     C++ con el compilador de C gcc causará errores del tipo
     ``undefined reference'' para las funciones de la
     librería estándar de C++:

          $ g++ -Wall -c hola.es.cc
          $ gcc hola.o       (debería usar g++)
          hola.o: In function `main':
          hola.o(.text+0x1b): undefined reference to `std::cout'
          .....
          hola.o(.eh_frame+0x11):
            undefined reference to `__gxx_personality_v0' example

          Las referencias indefinidas a funciones internas de
          librerías en tiempo de ejecución, tales como
          __gxx_personality_v0, son pruebas del enlazado de archivos
          objetos C++ con gcc en vez de con g++. (Puesto
          que estas funciones son internas, el error mostrado en este ejemplo
          será diferente en otras versiones del compilador.) Enlazando el
          mismo archivo objeto con g++ suministra todas las
          librerías C++ necesarias y produce un ejecutable que
          funciona:

               $ g++ hola.es.o
               $ ./a.out
               ¡Hola, mundo! example

               Un aspecto que algunas veces causa confusión es que gcc
               actualmente compila código fuente C++ cuando detecta la extensión
               de archivos C++, pero no puede enlazar el archivo objeto resultante.

                    $ gcc -Wall -c hola.es.cc   (correcto, en vez de C++)
                    $ gcc hola.o
                    hola.o: In function `main':
                    hola.o(.text+0x1b): undefined reference to `std::cout' example

                    Para eliminar este problema, use g++ consistentemente para
                    programas C++ y gcc para programas C.

Opciones de compilación en C++
==============================

La mayoría de las opciones pueden ser usadas tanto para programas C como C++, pero además hay unas pocas opciones que son específicas de cada lenguaje. Esta sección describe algunas de las opciones adicionales, y las mejoras de las opciones existentes, que están disponibles en g++.

-Wall y -W
     Cuando se compila con g++, las opciones -Wall y -W incluyen avisos extras específicos de C++ (los avisos relacionan las funciones miembro con las clases virtuales). El uso de estas opciones es siempre recomendado mientras se depura un programa.

-fno-default-inline
     Esta opción deshabilita el inlining por defecto de las funciones miembro definidas en los cuerpos de las clases C++. GCC normalmente inlines todas las funciones posibles cuando la optimización está activada, incluso si no se usó explícitamente la palabra reservada inline. Elija esta opción si desea controlar el inlining por sí mismo, o si desea poner un punto de ruptura en una función miembro que en otro caso sería inlined (ya que no es posible poner un punto de ruptura en una función inlined).

-Weffc++
     Esta opción avisa sobre el código C++ que rompe alguna de las directrices dadas en los libros ``Effective C++'' y ``More Effective C++ de Scott Meyers. Por ejemplo, se mostrará un aviso si una clase usa memoria dinámicamente ubicada si no es definida como copia de un constructor y un operador de asignación. Observe que los archivos cabeceras de las librerías estándar no siguen estas directrices, así se puede usar esta opción para un test ocasional de posibles problemas en su propio código en vez de compilar con ella todo el tiempo.

-Wold-style-cast

     Esta opción destaca cualquier uso de moldes con el estilo de C en programas C++. El lenguaje C++ facilita las palabras reservadas static_cast, dynamic_cast, reinterpret_cast y const_cast para manejar moldes y éstos con preferidos a menudo (aunque los moldes al estilo C son permitidos).

Usando la librería estándar de C++
==================================

Una implementación de la librería estándar de C++ es suministrada como parte de GCC. El siguiente programa usa la clase string de la libraría estándar para reimplementar el programa Hola Mundo:

          [file holastr.es.cc not included]

El programa puede ser compilado y ejecutado usando los comandos siguientes:

     $ g++ -Wall holastr.es.cc
     $./a.out
     ¡Hola, Mundo! example

     Observe que de acuerdo con el estándar C++, los archivos cabeceras
     de las librerías C++ mismas no usan una extensión de
     archivo. Las clases en la librería son además
     definidas dentro del espacio de nombres std, así
     la directiva using namespace std es necesaria para acceder a
     ellas, a menos que el prefijo std:: sea usado en todas partes
     (como en la sección anterior).

Plantillas
==========

Las plantillas facilitan la posibilidad de definir clases C++ que soporten técnicas genéricas de programación. Las plantillas se pueden considerar como una clase poderosa de macro. Cuando una plantilla de clase o función es usada con una clase o tipo específico, tal como float o int, el código correspondiente a la plantilla es compilado con el tipo sustituido en los lugares apropiados.

Usando plantillas de librerías estándar de C++
----------------------------------------------

La librería estándar libstdc++ facilitada con GCC suministra un amplio rango de contenedores de clases genéricas, tales como listas y colas, en adición a algoritmos generales tales como ordenación. Estas clases fueron originalmente parte de la Standard Template Library (STL), la cual era un paquete separado, pero no está incluida en la misma librería estándar C++.

El siguiente programa demuestra el uso de una libraría de plantillas creando una lista de cadenas con la plantilla list<string>:

          [file string.es.cc not included]

No son necesarias opciones especiales para usar las plantillas de clases de las librerías estándar; las opciones de la línea de comandos para compilar este programa son las mismas de antes:

     $ g++ -Wall string.es.cc
     $ ./a.out
     # items = 2 example

     Observe que el ejecutable creado por g++ usando la
     librería estándar de C++ enlazará a la
     librería compartida libstdc++, la cual es
     suministrada como parte de la instalación por defecto de GCC. Hay
     varias versiones de esta librería ---si distribuye
     ejecutables usando la librería estándar de C++
     necesita asegurar que los destinatarios tienen una versión
     compatible de libstdc++, o enlazar su programa estáticamente
     usando la opción de línea de comandos -static.

Proporcionando sus propias plantillas
-------------------------------------

Además de las plantillas de clases suministradas por la librería estándar de C++ puede definir sus propias librerías. La forma recomendada de usar plantillas con g++ es siguiendo el modelo de compilación de inclusión, donde las definiciones de plantillas están puestas en los archivos de cabeceras. Este es el método usado por la librería estándar de C++ suministrada con el mismo GCC. Los archivos de cabeceras pueden ser incluidos con #include en cada archivo fuente donde se necesite.

Por ejemplo, el siguiente archivo de plantilla crea una simple clase Buffer<T> que representará un buffer circular tratando objetos del tipo T.

          [file buffer.es.h not included]

El archivo contiene tanto la declaración de la clase como la definición de las funciones miembro. Esta clase sólo se muestra con propósitos de demostración y no debe ser considerada un ejemplo de buena programación. Obsérvese el uso de guardas include, que comprueban la existencia de una macro BUFFER_H, asegurando que la definición en el archivo de cabecera será sólo considerada una vez si el archivo es incluido múltiples veces en el mismo contexto.

El programa siguiente emplea la plantilla de clase Buffer para crear un buffer de tamaño 10, almacenando los valores en coma flotante 0.25 y 1.25 en el buffer:

          [file tprog.es.cc not included]

Las definiciones de la clase de plantilla y sus funciones están incluidas en el archivo fuente del programa con #include "buffer.es.h" antes de ser usada. El programa puede entonces ser compilado usando la siguiente línea de comandos:

     $ g++ -Wall tprog.es.cc
     $ ./a.out
     valor almacenado = 1.25 example

     En el momento en que las funciones de la plantilla son usadas en el
     código fuente, g++ compila las definiciones apropiadas de los
     archivos de cabeceras y pone las funciones compiladas en el
     correspondiente archivo objeto.

     Si una plantilla de función es usada varias veces en un mismo
     programa será almacenada en más de un archivo objeto. El enlazador
     GNU asegura que sólo una copia será puesta en el ejecutable
     final. Otros enlazadores pueden devolver errores tipo
     ``definición múltiple de símbolo'' cuando
     aparecen más de una copia de una plantilla de función ---un
     método de trabajo con estos enlazadores es descrito más adelante.

Instanciación explícita de plantillas
-------------------------------------

Para tomar un completo control sobre la compilación de plantillas con g++ es posible que se requiera una instanciación explícita de cada ocurrencia de la plantilla, usando la opción -fno-implicit-templates. Este método no se necesita usando el enlazador GNU ---es un alternativa suministrada para sistemas con enlazadores que no pueden eliminar las definiciones duplicadas de funciones de plantillas en los archivos objetos.

Con este enfoque, las funciones de plantillas no son compiladas hasta el momento donde serán usadas, como resultado de la opción -fno-implicit-templates. En cambio, el compilador busca una instanciación explícita de la plantilla usando la palabra reservada template con el tipo específico para forzar su compilación (esto es una extensión de GCC del comportamiento estándar). Estas instanciaciones son normalmente puestas en archivos fuente separados, los cuales serán compilados para hacer los archivos objetos que contengan todas las funciones de plantillas requeridas por el programa. Esto garantiza que cada plantilla aparezca en un único archivo objeto, y que sea compatible con enlazadores que no puedan eliminar definiciones duplicadas en archivos objeto.

Por ejemplo, el siguiente archivo templates.es.cc contiene una instanciación explícita de la clase Buffer<float> usada por el programa tprog.es.cc mostrado antes:

          [file templates.es.cc not included]

El programa completo puede compilarse y enlazarse usando instanciación explícita con el siguiente comando:

     $ g++ -Wall -fno-implicit-templates -c tprog.es.cc
     $ g++ -Wall -fno-implicit-templates -c templates.es.cc
     $ g++ tprog.o templates.o
     $ ./a.out
     valor almacenado = 1.25 example

     El código objeto de todas las funciones de plantillas está
     contenido en el archivo templates.o. No hay código objeto
     para la función de plantilla en tprog.o cuando este es
     compilado con la opción -fno-implicit-templates.

     Si el programa es modificado para usar tipos adicionales, entonces
     podrían añadirse posteriores instanciaciones
     explícitas en el archivo templates.es.cc. Por
     ejemplo, el siguiente código añade instanciaciones de objetos
     Buffer conteniendo valores float, double e int:

               [file templates2.es.cc not included]

     La desventaja de la instanciación explícita es que es
     necesario conocer qué tipos de plantillas son necesarias en un
     programa. Para un programa complicado puede ser difícil
     saberlo por adelantado. Cualquier instanciación de plantilla perdida
     será detectada en tiempo de enlazado, sin embargo, y añadida a la
     lista de instanciaciones explícitas, anotando qué
     funciones están indefinidas.

     La instanciación explícita puede ser empleada para
     hacer librerías de funciones de plantillas
     precompiladas, creando un archivo objeto que contenga todas las
     instanciaciones de una función de plantilla (como en el archivo
     templates.es.cc anterior). Por ejemplo, el archivo objeto creado
     desde la instanciación de plantilla anterior contiene el código
     máquina necesario para las clases Buffer con tipos float,
     double e int, y puede ser distribuida como una
     librería.

La palabra reservada export
---------------------------

En el momento de escribir este libro, GCC no soportaba la nueva palabra reservada C++ export.

Esta palabra reservada era propuesta como una forma de separar la interfaz con las plantillas de su implementación. Sin embargo añadió complejidad al proceso de enlazado, lo cual en la práctica podría quitar méritos a cualquier ventaja.

La palabra reservada export no es ampliamente usada, y la mayoría de los compiladores ni la soportan. El modelo de compilacińn de inclusión descrito anteriormente es recomendado como el más simple y la forma más portable de usar plantillas.

Opciones específicas de plataforma
**********************************

GCC proporciona un rango de opciones específicas de la plataforma para los diferentes tipos de CPUs. Estas opciones controlan las características tales como los modos en coma flotante del hardware, y el uso de instrucciones especiales para diferentes CPUs. Estas pueden seleccionarse con la opción -m en la línea de comandos, y funciona con todos los frontends de lenguajes GCC, tales como gcc y g++.

La siguiente sección describe algunas de las opciones disponibles para las plataformas más comunes. Un listado completo de todas las opciones específicas de la plataforma se puede encontrar en el Manual de Referencia GCC, ``Using GCC'' (see Lectura adicional). Soporte a nuevos procesadores es añadido a GCC tan pronto como éste esté disponible, por eso algunas de las opciones descritas en este capítulo no se encuentran en anteriores versiones de GCC.

Opciones para Intel y AMD x86
=============================

Las características más usadas de las familias de procesadores Intel y AMD x86 (386, 486, Pentium, etc) pueden ser controladas con opciones específicas de la plataforma.

En estas plataformas, GCC produce código ejecutable que es compatible por defecto con todos los procesadores de la familia x86 ---llegando a retroceder hasta el 386. Sin embargo, es posible compilar para un procesador específico para obtener mejores rendimientos.

Por ejemplo, las versiones recientes de GCC tienen soporte específico para los más nuevos procesadores tales como Pentium 4 y Athlon AMD. Estos pueden ser seleccionados para Pentium 4 con la siguiente opción:

     $ gcc -Wall -march=pentium4 hola.es.c example

     y para el Athlon:

          $ gcc -Wall -march=athlon hola.es.c example

          Un listado completo de los tipos de CPUs soportados se puede encontrar
          en el Manual de Referencia GCC.

          El código producido con una opción -march=CPU
          específica puede ser más rápido pero no se
          ejecutará en otros procesadores de la familia x86. Si planea
          distribuir archivos ejecutables para uso general en procesadores Intel
          o AMD, éstos deberían ser compilados sin ninguna
          opción -march.

          Como alternativa, la opción -mcpu=CPU proporciona un
          compromiso entre velocidad y portabilidad ---se genera código que
          será afinado para un procesador específico, en
          términos de planificación de instrucciones, pero no emplea ninguna
          instrucción que no esté disponible en otras CPUs de la faimlia
          x86. (En versiones recientes de GCC esta opción ha sido
          renombrada a -mtune. La antigua forma -mcpu
          continuará funcionando.) El código resultante será compatible
          con todas las CPUs, y tiene una velocidad ventajosa en la CPU
          especificada por -mcpu. Los ejecutables generados con
          -mcpu no pueden lograr el mismo rendimiento que con
          -march, pero en la práctica puede ser más conveniente.

Extensiones x86
---------------

GCC puede obtener ventajas de las instrucciones adicionales en las extenciones MMX, SSE, SSE2, SSE3 y 3dnow de los recientes procesadores Intel y AMD. Las opciones -mmmx, -msse, -msse2, -mss3 y -m3dnow permiten usar instrucciones extra, permitiendo que múltiples palabras de datos sean procesadas en paralelo. Los ejecutables resultantes sólo funcionarán en procesadores que soporten la apropiada extensión ---en otros sistemas pueden fallar con un error Illegal instruction o similar. (En sistemas GNU/Linux, el comando cat /proc/cpuinfo mostrará información de la CPU.)

La opción -mfpmath=sse instruye a GCC para usar las extensiones SSE para aritmética en coma flotante cuando sea posible. Para que esta opción tenga efecto, las extensiones SSE o SSE2 deberían primero estar habilitadas con -msse o -msse2.

Observe que el conjunto de extensiones SSE sólo soporta operaciones de simple precisión ---la aritmética de doble precisión es parte de SSE2. Desde que la mayoría de programas C y C++ declaran las variables en coma flotante como double en vez de como float, las opciones combinadas -msse2 -mfpmmath=sse son frecuentemente necesarias. En procesadores de 64 bits estas opciones están disponibles por defecto.

Procesadores x86 de 64 bits
---------------------------

AMD ha mejorado el conjunto de instrucciones de 32 bits a un conjunto de instruciones de 64 bits denominado x86-64, el cual es implementado en sus procesadores AMD64. (Intel ha añadido soporte para este conjunto de instrucciones como ``Mejoras Intel 64 bits'' a sus CPUs Xeon.) En sistemas AMD64 GCC genera código de 64 bits por defecto. La opción -m32 permite en cambio que sea generado código de 32 bits.

El procesador dispone de varios modelos de memoria diferentes para ejecutar programas en modo de 64 bits. El modelo por defecto es el modelo de código pequeño, el cual permite código y datos de hasta 2GB de tamaño. En el modelo de código medio permite tamaño ilimitado de datos y puede ser seleccionado con -mcmode=medium. También hay un modelo de código grande, el cual soporta tamaño ilimitado de código además del tamaño ilimitado de datos. Este no está actualmente implementado en GCC una vez que el modelo de código medio es suficiente para todos los propósitos prácticos ---los ejecutables con tamaños superiores a 2GB en la práctica no se encuentran.

Un especial modelo de código de kernel -mcmodel=kernel es facilitado para código a nivel de sistema, tales como el kernel Linux. Un importante punto a observar es que por defecto en los AMD64 hay un área de 128-bytes de memoria ubicada por debajo del puntero de pila de los datos temporales, referida como ``zona roja'', la cual no es soportada por el kernel Linux. La compilación del kernel Linux en un AMD64 requiere la opción -mcmmodel=kernel -mno-red-zone.

Opciones para DEC Alpha
=======================

El procesador DEC Alpha tiene por defecto una configuración que maximiza el rendimiento de la aritmética en coma flotante y el coste de un soporte completo para las características de la aritmética del IEEE.

En la configuración por defecto en un procesador DEC Alpha no está habilitado el soporte para el tratamiento del infinito y gradual desbordamiento por defecto (números no normalizados). Las operaciones que producen el valor infinito o desbordamientos por defecto generarán excepciones en coma flotante (también conocidas como traps), y causarán que el programa termine, a menos que el sistema operativo capture y maneje las excepciones (lo cual es, en general, ineficiente). El estándar IEEE especifica que estas operaciones deben producir un resultado especial para representar las cantidades en el formato numérico del IEEE.

En la mayoría de los casos el comportamiento del DEC Alpha es aceptable, ya que la mayoría de los programas no producen ni el valor infinito ni desbordamientos por defectos. Para aplicaciones que requieran estas características, GCC facilita la opción -mieee para habilitar un completo soporte para la aritmética del IEEE.

Para demostrar la diferencia entre los dos casos el siguiente programa divide 1 entre 0:

          [file alpha.es.c not included]

En aritmética del IEEE el resultado de 1/0 es inf (Infinito). Si el programa es compilado para un procesador Alpha con la configuración por defecto generará una excepción, que terminará el programa:

     $ gcc -Wall alpha.es.c
     $ ./a.out
     Floating point exception    (en un procesador Alpha) example

     Usando la opción -mieee se asegura una completa conformidad
     con el IEEE ---La división 1/0 produce correctamente el resultado
     inf y el programa continua ejecutándose correctamente:

          $ gcc -Wall -mieee alpha.es.c
          $ ./a.out
          x/y = inf

     Observe que los programas que generan excepciones en coma flotante
     corren más lentos cuando son compilados con la opción
     -mieee, porque las excepciones son manejadas por software en
     vez de por hardware.

Opciones para SPARC
===================

En el rango de procesadores SPARC la opción -mcpu=CPU genera código específico del procesador. Las opciones válidas para CPU son v7, v8 (SuperSPARC), Sparclite, Sparclet y v9 (UltraSPARC). El código producido con una opción específica no ejecutará en otros procesadores de la familia SPARC, excepto cuando exista una compatibilidad hacia atrás en el mismo procesador.

En sistemas UltraSPARC de 64 bits las opciones -m32 y -m64 controlan la generación de código para entornos de 32 ó 64 bits. El entorno de 32 bits seleccionado por -m32 usa int, long y tipos de puntero con un tamaño de 32 bits. El entorno de 64 bits seleccionado con -m64 usa un tipo int de 32 bits y long y tipos de puntero de 64 bits.

Opciones para POWER/PowerPC
===========================

En sistemas que usan la familia de procesadores POWER/PowerPC la opción -mcpu=CPU selecciona la generación de código específico para los modelos de CPU. Los posibles valores de CPU incluyen power, power2, powerpc, powerpc64 y common, además de otros números de modelos específicos. El código generado con la opción -mcpu=common se ejecutará en cualquiera de los procesadores. La opción -maltivec habilita el uso del vector Altivec de procesamiento de instrucciones, si el soporte del hardware apropiado está disponible.

Los procesadores POWER/PowerPC incluyen una instrucción combinada ``multiplicación y suma'' a * x + b, la cual realiza las dos operaciones simultáneamente para ganar en velocidad ---esto es referido como una fusión de multiplicaciones y sumas, y es usado por defecto en GCC. Debido a las diferentes formas en que los valores intermedios son redondeados, el resultado de una instrucción fundida puede no tener exactamente igual rendimiento que dos operaciones separadas. En los casos en que es requerida estrictamente la aritmética IEEE, el uso de las instrucciones combinadas puede ser deshabilitado con la opción -mno-fuser-madd.

En sistemas AIX, la opción -mminimal-toc disminuye el número de entradas GCC puestas en la tabla de contextos global (TOC) de los ejecutables para anular los errores ``TOC overflow'' en tiempo de enlazado. La opción -mxl-call realiza el enlazado de archivos objetos de GCC compatible con los compiladores de IBM's XL. Para aplicaciones que usan hilos POSIX, AIX siempre requiere la opción -pthread en compilación, incluso cuando el programa sólo se ejecute en modo hilo simple.

Soporte de múltiples arquitecturas
==================================

Un número de plataformas puede ejecutar código para más de una arquitectura. Por ejemplo, plataformas de 64 bits como AMD64, MIPS64, Sparc64 y PowerPC64 soportan la ejecución de código tanto de 32 como de 64 bits. De forma análoga, los procesadores ARM soportan tanto código de ARM como un código más compacto denominado ``Thumb''. GCC puede ser construido para soportar múltiples arquitecturas en estas plataformas. Por defecto, el compilador generará archivos objetos de 64 bits, pero dando la opción -m32 generará archivos objetos de 32 bits para la correspondiente arquitectura. (Las opciones -maix64 y -maix32 son empleadas en AIX.)

Observe que el soporte de múltiples plataformas depende de la disponibilidad de las librerías correspondientes. En plataformas de 64 bits que soportan ejecutables tanto de 64 como 32 bits, las librerías de 64 bits son a menudo puestas en directorios lib64 en vez de en directorios lib, p.e. en /usr/lib64 y /lib64. Las librerías de 32 bits se encuentran por defecto en directorios lib de otras plataformas. Esto permite que las librerías tanto de 32 bits como de 64 bits puedan existir con el mismo nombre y en el mismo sistema. Otros sistemas, como el IA64/Itanium, emplea los directorios /usr/lib y /lib para las librerías de 64 bits. GCC conoce estos caminos y los emplea apropiadamente cuando compila código para 64 bits ó 32 bits.

Usos de coma flotante
=====================

El estándar IEEE-754 define el comportamiento a nivel de bit de las operaciones aritméticas en coma flotante en todos los procesadores modernos. Esto permite que los programas numéricos sean portados entre diferentes plataformas con idénticos resultados, en principio. En la práctica, hay a menudo pequeñas variaciones causadas por las diferencias en el orden de las operaciones (dependiendo de los niveles de compilación y optimización) pero generalemnte son insignificantes.

Sin embargo, se pueden apreciar más notables discrepancias cuando se portan programas numéricos entre sitemas x86 y otras plataformas, porque la unidad de coma flotante x87 (FPU) en los procesadores x86 procesan los resultados empleando internamente precisión extendida (los valores serán convertidos a doble precisión sólo cuando son almacenados en memoria). En contraste, procesadores como SPARC, PA-RISC, Alpha, MIPS y POWER/PowerPC funcionan con valores en doble precisión nativos. (Los procesadores Motorola 68k también usan registros de precisión extendida, como el x86.) Las diferencias entre estas implementaciones provocan cambiar el comportamiento en el redondeo y en undeflow/overflow, porque los valores intermedios tienen mayor precisión relativa y rango de exponentes cuando son procesados en precisión extendida. (Para tener cantidades en registros
de precisión extendida x87 la precisión relativa es
5.42*10^-20 y el rango del exponente es 10^(+/-4932). Los
valores estándar de doble precisión tienen una precisión
relativa de 2.22*10^-16 y un rango del exponente de
10^(+/-308).) En particular, las comparaciones que afectan a valores en precisión extendida pueden fallar donde los valores en doble precisión equivalente debería comparar igual.

Para evitar esta incompatibilidad, la unidad de coma flotante (FPU) ofrece a menudo un modo del hardware redondeando la doble precisión. En este modo el resultado de cada operación en coma flotante con precisión extendida es redondeada a doble precisión en registros en coma flotante por la FPU. Es importante observar que el redondeo sólo afecta a la precisión, y no al rango del exponente, así el resultado es un formato híbrido de doble precisión con un rango extendido de exponentes.

En sistemas BSD tales como FreeBSD, NetBSD y OpenBSD, el modo hardware de redondeo de doble precisión está por defecto. Alcanzado la mayor compatibilidad con plataformas con doble precisión nativa. En sistemas x86 GNU/Linux el modo por defecto es precisión extendida (con la aspiración de suministrar un incremento en la precisión). Para habilitar el modo de redondeo de doble precisión es necesario anular la configuración por defecto en la base por procesos usando la instrucción de máquina FLDCW ``floating-point load control-word''. (El sistema operativo guarda y recupera la palabra de control cuando alterna entre procesos, así que cada proceso mantiene su propia configuración.) Una simple función puede ser invocada para ejecutar estas instrucciones que se muestran a continuación. Se usa la palabra reservada de la extensión de GCC asm para insertar la instrucción específica en la salida del lenguaje ensamblador:

          [file setfpu.es.c not included]

La apropiada configuración de mode para el redondeo en doble precisión es 0x27F. El valor del modo también controla el comportamiento del manejo de la excepción de coma flotante y la dirección de redondeo (para más detalles vea el manual de referencia de los procesadores Intel y AMD).

En sistemas x86 GNU/Linux, la función anterior puede ser llamada al inicio de cualquier programa para deshabilitar precisión excesiva. Esto reproducirá el resultado de los procesadores de doble precisión nativa, en ausencia de desbordamientos por exceso y por defecto.

El siguiente programa demuestra los diferentes modos de redondeo:

          [file fptest2.es.c not included]

En sistemas x86 GNU/Linux la comparación c == a / b puede producir un resultado inesperado si c es tomado desde memoria (doble precisión) mientras que a / b es procesado en precisión extendida, porque la fracción 3/7 tiene diferentes representaciones en precisión doble y extendida.

     $ gcc -Wall fptest2.c
     $ ./a.out
     unexpecedt result

Configurando el modo de redondeo hardware a doble precisión previene que lo anterior suceda:

     $ gcc -Wall -DDOUBLE fptest2.c
     $ ./a.out
     comparison succeeds

Observe que la palabra de control de la coma flotante afecta al entorno completo del proceso, incluyendo las funciones de librerías C que sean invocadas. Una consecuencia de esto es que la aritmética en coma flotante es reducida eficientemente a doble precisión, desde que se confía en operaciones de precisión extendida.

La palabra de control de la coma flotante sólo afecta al comportamiento de FPU x87. Las operaciones en coma flotante procesadas con instrucciones de SSE y SSE2 son siempre llevadas a cabo en doble precisión nativa. Así, las opciones combinadas

     $ gcc -Wall -msse2 -mfpmath=sse  ... example

     son a menudo suficientes para eliminar los efectos de la precisión
     extendida. Sin embargo, algunas operaciones (tales como funciones
     transcendentales) no están disponibles en las extensiones SSE/SSE2 y
     serán procesadas por el FPU x87.

Portabilidad de los tipos con signo y sin signo
===============================================

Los estándares C y C++ permiten que el tipo carácter char sea con signo o sin signo, dependiendo de la plataforma y el compilador. La mayoría de los sistemas, incluidos x86 GNU/Linux y Microsoft Windows, usan char con signo, pero aquellos basados en PowerPC y procesadores ARM usan habitualmente char sin signo. (MacOS X (Drawin) en PowerPC usa char con signo, por consistencia con otras arquitecturas Darwin.) Esto puede causar resultados inexperados cuando se portan programas entre plataformas que tienen diferentes tipos char por defecto.

El siguiente código demuestra la diferencia entre plataformas con tipos char con signo y sin signo:

          [file signed.es.c not included]

Con un char sin signo, la variable c toma el valor 255, pero con un char con signo viene a ser -1.

La forma correcta de manipular variables char en C es a través de las funciones portables declaradas en ctype.h, tales como isalpha, isdigit y isblank, en vez de sus valores numéricos. El comportamiento de las expresiones condicionales no portables tales como c > 'a' depende del signado del tipo char. Si se requiere explícitamente una versión con signo o sin signo en cierto punto de un programa, se puede especificar usando signed char o unsigned char.

For existing programs which assume that char is signed or unsigned, GCC provides the options -fsigned-char and -funsigned-char to set the default type of char.  Using these options, the example code above compiles cleanly with -Wall -W when char is unsigned:

     $ gcc -Wall -W -funsigned-char signed.c
     $ ./a.out
     char is unsigned (c = 255)

However, when char is signed the value 255 wraps around to -1, giving a warning when compiled with -Wall -W:

     $ gcc -Wall -W -fsigned-char signed.c
     signed.c: In function `main':
     signed.c:7: warning: comparison is always false due to
       limited range of data type
     $ ./a.out
     char is signed (c = -1)

El mensaje de aviso ``comparison es always true/false due to limited range of data type'' es un síntoma de que el código asume una definición de char que difiere del tipo actual.

El problema más común en la escritura de código asumiendo el tipo char con signo ocurre con las funciones getc, fgetc y getchar (las cuales leen caractéres de un archivo). Tienen un tipo de retorno de int, no char, y esto permite el uso de un valor especial -1 (definido como EOF) para indicar un error de final de archivo. Desafortunadamente, muchos programas han sido escritos guardando incorrectamente este valor de retorno directamente en una variable char. Aquí está el típico ejemplo:

          [file testgetc.es.c not included]

Esto sólo funciona en plataformas que por defecto tienen el tipo char con signo. (Esto es además un sutil error en plataformas con char con signo ---el carácter ASCII 255 es falsamente interpretado como una condición de final de archivo.) En plataformas que usan char sin signo el mismo código puede fallar, porque el valor -1 se convierte en un 255 cuando se almacena en un unsigned char. Esto es normalmente causa de bucles infinitos porque el final del archivo no puede ser reconocido. (Si se mostrase, el carácter con código 255 a menudo aparece como "y.) Para ser portable, el programa debe comprobar el valor de retorno como un entero antes de forzarlo a char, como a continuación:

          [file testgetc2.es.c not included]

Las mismas consideraciones de esta sección se aplican a las definiciones de campos orientados a bit en estructuras, las cuales pueden ser por defecto con signo o sin signo. En GCC, el tipo por defecto para los campos orientados a bit puede ser controlado usando las opciones -fsigned-bitfields y -funsigned-bitfields.

Resolución de problemas
***********************

GCC proporciona varias opciones de ayuda para ayudar en la resolución de problemas con el proceso de compilación. Todas las opciones descritas en este capítulo funciona tanto con gcc como con g++.

Opciones de ayuda en línea de comandos
======================================

Para tener un breve recordatorio de varias opciones del comando, GCC tiene una opción de ayuda que muestra un resumen de alto nivel de las opciones del comando GCC:

     $ gcc --help

Para mostrar una lista completa de opciones para gcc y sus programas asociados, tales como el Enlazador de GNU y el Ensamblador de GNU, usa la opción de arriba con la opción verbosa (-v:

     $ gcc -v --help

La lista completa de opciones producidas por este comando es extremadamente larga ---se puede desear paginar a través de ésta usando el comando more, o redirigir la salida a un fichero por referencia:

     $ gcc -v --help 2>&1 | more

Números de versión
==================

Se puede encontrar el número de versión de gcc usando la opción de versión

     $ gcc --version
     gcc (Debian 4.6.1-4) 4.6.1

El número de versión es importante cuando se investigan los problemas de compilación debido a que las versiones antiguas de GCC pueden no tener algunas funcionalidades que un programa usa. El número de versión tiene las forma MAJOR-VERSION.MINOR-VERSION ó MAJOR-VERSION.MINOR-VERSION.MICRO-VERSION, dónde el tercer número de versión ``micro'' (como se muestra arriba) es usado para la subsiguiente entrega de corrección de errores en una serie de entregas.

Pueden encontrarse más detalles acerca de la versión usando -v:

     $ gcc -v
     Using built-in specs.
     COLLECT_GCC=gcc
     COLLECT_LTO_WRAPPER=/usr/lib/i386-linux-gnu/gcc/
       /i486-linux-gnu/4.6.1/lto-wrapper
     Target: i486-linux-gnu
     Configured with: ../src/configure -v
     --with-pkgversion='Debian 4.6.1-4'
     --with-bugurl=file:///usr/share/doc/gcc-4.6/
       /README.Bugs
     --enable-languages=c,c++,fortran,objc,obj-c++,go
     --prefix=/usr --program-suffix=-4.6
     --enable-shared --enable-multiarch
     --with-multiarch-defaults=i386-linux-gnu
     --enable-linker-build-id --with-system-zlib
     --libexecdir=/usr/lib/i386-linux-gnu
     --without-included-gettext --enable-threads=posix
     --with-gxx-include-dir=/usr/include/c++/4.6
     --libdir=/usr/lib/i386-linux-gnu --enable-nls
     --enable-clocale=gnu --enable-libstdcxx-debug
     --enable-libstdcxx-time=yes --enable-plugin
     --enable-objc-gc --enable-targets=all
     --with-arch-32=i586 --with-tune=generic
     --enable-checking=release --build=i486-linux-gnu
     --host=i486-linux-gnu --target=i486-linux-gnu
     Thread model: posix
     gcc version 4.6.1 (Debian 4.6.1-4)

Incluye información en los flags de construcción al mismo compilador y al archivo de configuración instalado, specs.

Compilación verbosa
===================

La opción -v también puede ser usada para mostrar información detallada acerca de la secuencia exacta de comandos usados para compilar y enlazar un programa. Aquí hay un ejemplo que muestra la compilación verbosa del programa Hola Mundo:

     $ gcc -v -Wall hola.es.c Using built-in specs.
     COLLECT_GCC=gcc
     COLLECT_LTO_WRAPPER=/usr/lib/i386-linux-gnu/gcc/
       /i486-linux-gnu/4.6.1/lto-wrapper
     Target: i486-linux-gnu
     Configured with: ../src/configure
     -v --with-pkgversion='Debian 4.6.1-4'
     --with-bugurl=file:///usr/share/doc/gcc-4.6/
       /README.Bugs
     --enable-la nguages=c,c++,fortran,objc,obj-c++,go
     --prefix=/usr --program-suffix=-4.6 --enable-shared
     --enable-multiarch
     --with-multiarch-defaults=i386-linux-gnu
     --enable-linker-build-id --with-system-zlib
     --libexecdir=/usr/lib/i386-linux-gnu
     --without-included-gettext --enable-threads=posix
     --with-gxx-include-dir=/usr/include/c++/4.6
     --libdir=/usr/lib/i386-linux-gnu --enable-nls
     --enable-clocale=gnu --enable-libstdcxx-debug
     --enable-libstdcxx-time=yes --enable-plugin
     --enable-objc-gc --enable-targets=all
     --with-arch-32=i586 --with-tune=generic
     --enable-checking =release --build=i486-linux-gnu
     --host=i486-linux-gnu --target=i486-linux-gnu
     Thread model: posix gcc version 4.6.1
       (Debian 4.6.1-4)
     COLLECT_GCC_OPTIONS='-v' '-Wall' '-mtune=generic'
     '-march=i586'
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/cc1
     -quiet -v hola.es.c -quiet -dumpbase hola.es.c
     -mtune=generic -march=i586 -auxbase hola.es -Wall -version
     -o /tmp/cchpM0t3.s
     GNU C (Debian 4.6.1-4) version 4.6.1
     (i486-linux-gnu) compiled by GNU C version 4.6.1, GMP
     version 5.0.1, MPFR version 3.0.1-p3, MPC version 0.9
     warning: GMP header version 5.0.1 differs from library
     version 5.0.2.
     GGC heuristics: --param ggc-min-expand=46
     --param ggc-min-heapsize=31802
     ignoring nonexistent directory
     "/usr/local/include/i386-linux-gnu"
     ignoring nonexistent directory
     "/usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/../
       /../../../../i486-linux-gnu/include"
     #include "..." search starts here:
     #include <...> search starts here:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/include
     /usr/local/include
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /include-fixed
     /usr/include/i386-linux-gnu /usr/include
     End of searchlist.
     GNU C (Debian 4.6.1-4) version 4.6.1
     (i486-linux-gnu) compiled by GNU C version 4.6.1, GMP
     version 5.0.1, MPFR version 3.0.1-p3, MPC version 0.9
     warning: GMP header version 5.0.1 differs from library
     version 5.0.2.
     GGC heuristics: --param ggc-min-expand=46
     --param ggc-min-heapsize=31802
     Compiler executable checksum:
     2cfae8623c84fd817bfff483158c4341
     COLLECT_GCC_OPTIONS='-v' '-Wall' '-mtune=generic'
     '-march=i586' as --32 -o /tmp/ccQxW8a5.o /tmp/cchpM0t3.s
     COMPILER_PATH=/usr/lib/i386-linux-gnu/gcc/
       /i486-linux-gnu/4.6.1/:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/
     LIBRARY_PATH=/usr/lib/i386-linux-gnu/gcc/
       /i486-linux-gnu/4.6.1/:
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /../../../:
     /lib/:/usr/lib/:/usr/lib/i386-linux-gnu/
     COLLECT_GCC_OPTIONS='-v' '-Wall' '-mtune=generic'
     '-march=i586'
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /collect2
     --build-id --no-add-needed --eh-frame-hdr -m elf_i386
     --hash-style=both -dynamic -linker /lib/ld-linux.so.2
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /../../../crt1.o
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /../../../crti.o
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /crtbegin.o
     -L/usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1
     -L/usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /../../..
     -L/usr/lib/i386-linux-gnu/tmp/ccQxW8a5.o
     -lgcc --as-needed -lgcc_s --no-as-needed
     -lc -l gcc --as-needed -lgcc_s --no-as-needed
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /crtend.o
     /usr/lib/i386-linux-gnu/gcc/i486-linux-gnu/4.6.1/
       /../../../crtn.o

La salida producida por -v puede ser útil siempre y cuando haya un problema con el proceso de compilación en sí. Esto muestra las rutas completas usadas para buscar los ficheros de cabecera y librerías, los símbolos de preprocesador predefinidos, y los ficheros objeto y librerías usadas para enlazar.

Parando un programa en un bucle infinito
========================================

Un programa que se mete en un bucle infinito o se ``cuelga'' puede ser difícil de depurar. En la mayoría de los sistemas un proceso en primer plano puede ser detenido pulsando Control-C, que envía una señal de interrupción (SIGINT). Sin embargo, esto no ayuda en la depuración del problema ---la señal SIGINT termina el proceso sin producir un core dump. Un enfoque más sofisticado es adjuntar el proceso en ejecución a un depurador e inspeccionarlo de manera interactiva.

Por ejemplo, aquí hay un programa simple con un bucle infinito:

          [file bucle.es.c not included]

Para adjuntar el programa y depurarlo, el código debería ser compilado con la opción de depuración -g:

     $ gcc -Wall -g loop.es.c
     $ ./a.out
     (program hangs)

Una vez el ejecutable está ejecutándose, se necesitará encontrar su identificador de proceso (PID). Esto se puede hacer desde otra sesión con el comando ps x:

     $ ps x
     PID   TTY    STAT TIME COMMAND
     ...  .....    ..  ....
     2333 pts/0    R+  0:16 ./a.out

En este caso el identificador de proceso es 2333, y ahora se puede adjuntar con gdb. El depurador debería ser iniciado en el directorio que contiene el ejecutable y su código fuente: (De manera alternativa, las rutas apropiadas pueden ser configuradas en gdb usando los comandos file y directory.)

     $ gdb a.out
     GNU gdb (GDB) 7.3-debian
     ...
     (gdb) attach 2333
     Attaching to program: a.out, process 2333
     Reading symbols from
     /lib/i386-linux-gnu/i686/cmov/libc.so.6...(no
     debugging symbols found)...done.
     Loaded symbols for
     /lib/i386-linux-gnu/i686/cmov/libc.so.6
     Reading symbols from /lib/ld-linux.so.2...(no debugging
     symbols found)...done.
     Loaded symbols for /lib/ld-linux.so.2
     0x080483c5 in main () at loop.c:5
     5         while (1) { i++; };
     (gdb)

La salida muestra la línea que se ejecutó en el punto en el que el depurador se adjuntó al proceso. El programa adjunto se pausa pero todavía `vive' ---este puede examinado interactivamente y continúa o termina (con el comando kill) si es necesario:

     (gdb) print i
     $1 = 1960534048
     (gdb) kill
     Kill the program being debugged? (y or n) y
     (gdb)

Si se quiere parar un proceso inmediatamente y crear un core dump, el comando de shell kill -3 PID (dónde PID es el identificador de proceso) enviará una señal SIGQUIT. La señal SIGQUIT dispara un core dump, no como SIGINT. Nótese que si los core dump fueran deshabilitados cuando el proceso fué iniciado, ningún fichero core se producirá (see Examinando archivos core).

Previniendo un uso excesivo de memoria
======================================

Algunas veces un error de programación hará que un proceso gestione grandes cantidades de memoria, consumiendo toda la RAM en un sistema. Para prevenir esto, el comando GNU Bash ulimit -v LIMIT se puede usar para restringir la cantidad de memoria virtual disponible en cada proceso. El límite es medido en kilobytes y se aplica a nuevos procesos iniciados en la shell actual. Por ejemplo,

     $ ulimit -v 4096

limitará los siguientes procesos a 4 megabytes de memoria virtual (4096k). Por defecto el límite no puede incrementarse en la misma sesión una vez ha sido establecido, así es mejor comenzar una shell distinta para operaciones ulimit reducidas. De manera alternativa, se puede establecer un límite blando (que puede ser deshecho) con las opciones -S -v.

Adicionalmente para prevenir derroche de procesos, limitando la cantidad de memoria que un programa puede reservar permite una forma de comprobar la robusted del manejo de condiciones out of memory. Un artificial límite bajo se puede usar para simular ejecuciones fuera de memoria ---un programa bien escrito no debe fallar en estos casos.

El comando ulimit soporta otras opciones incluyendo -p, que restringe el número de procesos hijos que pueden ser creados, y -t, que establece un límite en el número de segundos de CPU en el que un proceso puede ejecutarse. La lista completa de configuraciones puede mostrarse con el comando ulimit -a. Para mostrar más información acerca del comando ulimit, escribe help ulimit en una Shell de Bash.

Utilidades relativas al compilador
**********************************

Este capítulo describe un conjunto de herramientas que son muy utilizadas junto a GCC. Estas incluyen el archivador GNU ar, para crear librerías, y los programas de comprobación de perfil y cobertura, gprof y gcov.

Creando una librería con el archivador de GNU
=============================================

El archivador GNU ar combina una colección de archivos objeto en un simple fichero de archivo, conocido también como una librería. Un fichero de archivo es simplemente una forma conveniente de distribuir un grán número de archivos objeto juntos (como se describió anteriormente en Enlazando con librerías externas).

Para demostrar el uso del archivador GNU se creará una pequeña librería libhola.a conteniendo dos funciones hola y adios.

El primer archivo objeto será generado desde el código fuente de la función hola, en el archivo hola_fn.es.c:

          [file hola_fn.es.c not included]

El segundo archivo objeto será generado con el archivo fuente adios_fn.es.c, que contiene la función adios:

          [file adios_fn.es.c not included]

Ambas funciones usan el archivo de cabecera hola.es.h, ahora con un prototipo para la función adios():

          [file hola.es.h not included]

El código fuente puede ser compilado a los archivos objeto hola_fn.o y adios_fn.o usando el comando:

     $ gcc -Wall -c hola_fn.es.c
     $ gcc -Wall -c adios_fn.es.c example

     Estos archivos objeto pueden ser combinados en una
     librería usando la siguiente línea de comando:

          $ ar cr libhola.a hola_fn.o adios_fn.o example

          La opción cr significa ``crear y
          reemplazar''. (Observe que ar no requiere el prefijo
          - para estas opciones.) Si la librería no existe,
          primero será creada. Si la librearía ya existe, el
          archivo original con el mismo nombre será reemplazado por el nuevo
          archivo especificado en la línea de comando. El primer
          argumento libhola.a es el nombre de la
          librería. El resto de argumentos son los nombres de los
          archivos objeto que serán copiados a la librería.

          El archivador ar además suministra una opción de ``tabla de
          contenidos'' t para listar los archivos objeto de una
          libraría existente:

               $ at t libhola.a
               hola_fn.o
               adios_fn.o example

               Observe que cuando la librería sea distribuida, los
               archivos cabecera de las funciones y variables públicas será
               suministrado para que también esté disponible, así
               el usuario final puede incluirlos y obtener los prototipos correctos.

               Se puede escribir ahora un programa usando las funciones de la recien
               creada librería:

                         [file main3.es.c not included]

               Este archivo puede ser compilado con la siguiente línea
               de comando, como está descrito en Enlazando con librerías externas, asumiendo que la
               librería libhola.a está almacenada en el
               directorio actual:

                    $ gcc -Wall main3.c libhello.a -o hello

               El programa principal es enlazado junto a los archivos objeto
               encontrados en el archivo de librería libhola.a
               para producir el ejecutable final.

               La opción de atajo de enlazado de la librería se puede
               usar para enlazar el programa, sin necesidad de especificar
               explícitamente un camino completo a la librería:

                    $ gcc -Wall -L. main3.c -lhello -o hello

               La opción -L. es necesaria para añadir el directorio actual
               al camino de búsqueda de librerías. El ejecutable
               resultante se puede ejecutar como habitualmente:

                    $ ./hola
                    ¡Hola, cualquiera!
                    ¡Adios! example

                    Se muestra la salida de ambas funciones hola y adios
                    definidas en la librería.

Usando el profiler gprof
========================

El GNU profiler gprof es una muy usada herramienta para medir el rendimiento de un programa ---graba el número de llamadas de cada función y contabiliza el tiempo que emplea en ello, en una base por función. Las funciones que consumen largas fracciones del tiempo de ejecución pueden ser identificas fácilmente a partir de la salida de gprof. Mejorar la velocidad de un programa requiere primero concentración sobre aquellas funciones que dominan el tiempo de ejecución completamente.

Se usará gprof para examinar el rendimiento de un pequeño programa numérico que procesará una larga secuencia irresuelta Collatz conjeture en matemáticas. (American Mathematical Monthly, Volume 92 (1985), 3--23) La conjetura de Gollatz afecta a secuencias definidas por la regla:

     x_{n+1}  <=    x_{n} / 2  si x_{n} es par
                  3 x_{n} + 1  si x_{n} es impar example

     La secuencia es iterada desde el valor inicial x_0 hasta que
     termina con el valor 1. De acuerdo con la conjetura, todas las
     secuencias terminarán eventualmente ---el programa mostrará las
     largas secuencias como incrementos de x_0. El archivo fuente
     collatz.es.c contiene tres funciones: main, nseq y
     step:

               [file collatz.es.c not included]

     Para usar profiling, el programa debe ser compilado y enlazado con la
     opción de profiling -pg:

          $ gcc -Wall -c -pg collatz.es.c
          $ gcc -Wall -pg collatz.o example

          Esto creará un ejecutable instrumented que contiene
          instrucciones adicionales para registrar el tiempo consumido en cada
          función.

          Si el programa consiste en más de un archivo fuente la opción
          -pg se debe usar cuando se compila cada archivo fuente, y
          será usado en el enlazado de los archivos objetos para crear el
          ejecutable final (como se muestra anteriormente). Es un error común
          olvidar la opción -pg en el enlazado, lo cual evita que el
          profiling registre mucha información útil.

          El ejecutable se debe ejecutar para obtener los datos del profiling:

               $ ./a.out
               (la salida normal del programa es mostrada) example

               Mientras está corriendo el ejecutable instrumentado, datos de
               profiling son silenciosamente escritos en el archivo gmon.out
               en el directorio actual. Puede se analizado con gprof dando el
               nombre del ejecutable como argumento:

                    $ gprof a.out
                    Flat profile:
                    Each sample counts as 0.01 seconds.
                     %     cumul.    self             self   total
                    time  seconds seconds    calls us/call us/call name
                    68.59    2.14    2.14 62135400    0.03    0.03 step
                    31.09    3.11    0.97   499999    1.94    6.22 nseq
                     0.32    3.12    0.01                          main

               La primera columna de los datos muestra que el programa emplea la
               mayoría de su tiempo (casi del 70%) en la función
               step, y el 30% en nseq. Consecuentes esfuerzos para
               decrementar el tiempo de ejecución debe concentrarse en esta
               forma. En comparación, el tiempo empleado en la función
               main es completamente imperceptible (menos del 1%).

               Las otras columnas de la salida suministran información del número
               total de llamadas que son hechas a las funciones, y el tiempo gastado
               en cada función. Información adicional del tiempo de ejecución
               se muestra con gprof pero aquí no se muestra. Un
               completo detalle se puede encontrar en el manual ``GNU gprof
               ---El GNU Profiler'', de Jay Fenlason y Richard Stallman.

Test de cobertura con gcov
==========================

La herramienta de test de cobertura GNU gcov analiza el número de veces que cada línea del programa es ejecutada. Esto permite encontrar áreas del código que no son usadas, o que no se ejecutan en los tests. Cuando se combinan la información de perfilación con la información de cobertura se logra aumentar la velocidad de un programa concentrándose en líneas específicas del código fuente.

Se usará el ejemplo siguiente para demostrar gcov. Este programa recorre los números del 1 al 9 y comprueba su divisibilidad con el operador módulo (%).

          [file cov.es.c not included]

Para habilitar los test de cobertura el programa debe ser compilado con las siguientes opciones:

     $ gcc -Wall -fprofile-arcs -ftest-coverage cov.es.c example

     Esto creará un ejecutable instrumentado que contiene instrucciones
     adicionales que registran el número de veces que cada
     línea del programa es ejecutada. La opción
     -ftest-coverage añade instrucciones para contabilizar el
     número de veces que las líneas individuales son
     ejecutadas, mientras que -fprofile-arcs incorpora
     instrucciones de código por cada bifurcación del programa. Las
     instrucciones de bifurcación registran la frecuencia de los
     diferentes caminos que toman las instrucciones if y otras
     condicionales. El ejecutable debe ser ejecutado para crear los datos
     de cobertura:

          $ ./a.out
          3 es divisible por 3
          6 es divisible por 3
          9 es divisible por 3 example

          Los datos de la ejecución son escritos en varios archivos con
          extensiones .bb, .bbg y .da respectivamente en el
          directorio actual. Estos datos pueden ser analizados usando el comando
          gcov y el nombre del archivo fuente:

               $ gcov cov.es.c
                88.89% of 9 source lines executed in file cov.es.c
               Creating cov.es.c.gcov

          El comando gcov produce una anotación de la versión del
          archivo fuente original, con la extensión .gcov, conteniendo
          los contadores de los números de veces que cada línea
          fué ejecutada:

                    [file cov_c_gcov not included]

          Los contadores de líneas pueden verse en la primera
          columna. Las líneas que no son ejecutadas están
          marcadas con almohadillas ######. El comando grep
          '######' *.gcov se puede usar para encontrar las partes que no
          están siendo usadas.

Como funciona el compilador
***************************

Este capítulo describe en detalle cómo GCC transforma ficheros fuente a un fichero ejecutable. La compilación es un proceso multi-fase involucrando varias herramientas, incluyendo el Compilador de GNU en sí (a través de los frontends gcc o g++), el Ensamblador de GNU as, y el Enlazador de GNU ld. El conjunto completo de herramientas usadas en el proceso de compilación es llamado toolchain.

Una vista de los procesos de compilación
========================================

La secuencia de comandos ejecutados por una simple invocación de GCC consiste en las siguientes fases:

  * preprocesamiento (expandir macros)

  * compilación (desde código fuente a lenguaje ensamblador)

  * ensamblaje (desde lenguaje ensamblador a código máquina)

  * enlace (crear el ejecutable final)

Como ejemplo, se examinarán estas fases de compilación individualmente usando el programa Hola Mundo hola.es.c:

          [file hola.es.c not included]

Nótese que no es necesario usar cualquiera de los comandos individuales descritos en esta sección para compilar un programa. Todos los comandos son ejecutados de manera automática y transparente por GCC internamente, y puede ser visto usando la opción -v descrita antes (see Compilación verbosa). El propósito de este capítulo es proporcionar un entendimiento de cómo el compilador funciona.

Aunque el programa Hola Mundo es muy simple, éste usa cabeceras externas y librerías, y así ejercita todos los pasos importantes del proceso de compilación.

El preprocesador
================

La primera fase del proceso de compilación es el uso del preprocesador para expandir macros y ficheros de cabecera incluidos. Para realizar esta fase, GCC ejecuta el siguiente comando: (Como se mencionó antes, el preprocesador está integrado en el compilador en versiones recientes de GCC. Conceptualmente, el proceso de compilación es el mismo que ejecutar el preprocesar como una aplicación separada.)

     $ cpp hola.es.c > hola.i

El resultado es un fichero hola.i que contiene el código fuente con todas las macros expandidas. Por convención, ficheros preprocesados son dados por la extensión de fichero .i para programas C y .ii para programas C++. En la práctica, el fichero preprocesado no es guardado en disco a menos que la opción -save-temps sea usada.

El compilador
=============

La siguiente fase del proceso es compilación de código fuente preprocesado a lenguaje ensamblador, para un procesador específico. La opción -S dicta a gcc a convertir el código fuente C a lenguaje ensamblador sin crear un fichero objeto:

     $ gcc -Wall -S hola.i

El lenguaje ensamblador resultante es almacenado en el fichero hola.s. Aquí está el lenguaje ensamblador de Hola Mundo para un procesador Intel x86 (i686):

     $ cat hello.s
             .file   "hello.c"
             .section        .rodata
     .LC0:
             .string "Hello, world!"
             .text
             .globl  main
             .type   main, @function
     main:
     .LFB0:
             .cfi_startproc
             pushl   %ebp
             .cfi_def_cfa_offset 8
             .cfi_offset 5, -8
             movl    %esp, %ebp
             .cfi_def_cfa_register 5
             andl    $-16, %esp
             subl    $16, %esp
             movl    $.LC0, (%esp)
             call    puts
             movl    $0, %eax
             leave
             .cfi_restore 5
             .cfi_def_cfa 4, 4
             ret
             .cfi_endproc
     .LFE0:
             .size   main, .-main
             .ident  "GCC: (Debian 4.6.1-4) 4.6.1"
             .section        .note.GNU-stack,"",@progbits

Nótese que el lenguaje ensamblador contiene una llamada a la función externa puts, una versión simple de printf para cadenas que no contienen caracteres formateados.

El ensamblador
==============

El propósito de un ensamblador es convertir lenguaje ensamblador a código máquina y generar un fichero objeto. Cuando hay llamadas a funciones externas en el fichero fuente de ensamblador, el ensamblador deja las direcciones las funciones externas indefinidas, para ser rellenadas después por el enlazador. El ensamblador puede ser invocado con la siguiente línea de comandos:

     $ as hola.s -o hola.o

As with GCC, the output file is specified with the -o option.  The resulting file hello.o contains the machine instructions for the Hello World program, with an undefined reference to puts.

El enlazador
============

La fase final de compilación es el enlace de ficheros objeto para crear un ejecutable. En la práctica, un ejecutable requiere muchas funciones externas del sistema y de librerías C. Por consiguiente, los comandos de enlace actuales usados internamente por GCC son complicados. Por ejemplo, el comando completo para enlazar el programa Hola Mundo es: (El comando preciso varía dependiendo de la versión de gcc y el sistema operativo. Versiones recientes de gcc usan wrapper llamado collect2 que hace algún trabajo adicional antes de llamar a ld.)

     $ ld -dynamic-linker /lib/ld-linux.so.2 \
                          /usr/lib/crt1.o \
                          /usr/lib/crti.o \
            /usr/lib/gcc/i486-linux-gnu/4.3/crtbegin.o \
          -L/usr/lib/gcc/i486-linux-gnu/4.3 hola.o \
          -lgcc -lgcc_eh \
          -lc /usr/lib/gcc/i486-linux-gnu/4.3/crtend.o \
          /usr/lib/crtn.o example

     Afortunadamente nunca se necesita escribir el comando de arriba
     directamente ---el proceso entero de enlace es manejado de manera
     transparente por gcc cuando se invoca como sigue:

          $ gcc hola.o

     Esto enlaza el fichero objeto hola.o a la
     librería estándar de C, y produce un fichero
     ejecutable a.out:

          $ ./a.out
          ¡Hola, mundo!

     Un fichero objeto para un programa C++ puede ser enlazado a la
     librería estándar C++ del mismo modo con un simple
     comando g++.

Examinado archivos compilados
*****************************

Este capítulo describe varias herramientas comunes para examinar el contenido de los archivos objeto y ejecutables.

Identificando archivos
======================

Cuando un archivo fuente ha sido compilado a un archivo objeto o a un ejecutable las opciones usadas en la compilación no son obvias. El comando file examina el contenido del archivo objeto o ejecutable y determina algunas de sus características, tal como si fué compilado para enlazado estático o dinánico.

Por ejemplo, aquí se muestra el resultado del comando file para un ejecutable típico:

     $ file a.out
     a.out: ELF 32-bit LSB executable, Intel 80386,
       version 1 (SYSV), dynamically linked (uses shared
       libs), not stripped

La salida muestra que el archivo ejecutable es enlazado con librerías compartidas dinámicamente, y compilado para procesadores Intel 386 y compatibles. Una completa explicación de la salida se muestra a continuación:

ELF
     El formato interno de un archivo ejecutable (ELF proviene de ''Executable and Linking Format'', otros formatos como el COFF ``Common Object File Format'' fueron usados en antiguos sistemas operativos (p.e. MS-DOS)).

32 bits
     El tamaño de palabra (para algunas plataformas esto sería 64 bits).

LSB
     Compilado para una plataforma con ordenación de palabras donde el primero es el byte menos significativo (LSB, least significat byte), tales como los procesadores Intel y AMD x86 (la alternativa el primero es el byte más significativo (MSB, most significant byte) es usada en otros procesadores, tales como Motorola 680x0) (La ordenación MSB y LSB son conocidas como big-endian y little-endian respectivamente (el término original es de la sátira ``Los viajes de Gulliver'' de Jonathan Swift's, de 1727).). Algunos procesadores como Itanium y MIPS soportan ambas ordenaciones LSB y MSB.

Intel 80386
     Procesador para el cual ha sido complilado el archivo ejecutable.

version 1 (SYSV)
     Esta es la versión del formato interno del archivo.

dynamically linked
     El ejecutable emplea librerías compartidas dinámicas (statically linked indicaría que el programa fué enlazado estáticamente, en el ejemplo usando la opción -static)

not stripped
     El ejecutable contiene una tabla de símbolos ( ésta puede ser eliminada usando el comando strip).

El comando file puede ser usado con archivos objeto, donde dará una salida similiar. El estándar POSIX (POSIX.1 (2003 edition), IEEE Std 1003.1.2003.) para sistemas Unix define el comportamiento del comando file.

Examinando la tabla de símbolos
===============================

Tal y como se describió anteriormente en la discusión sobre depuración, los archivos ejecutables y objeto pueden contener una tabla de símbolos (see Compilando para depuración). Esta tabla almacena la localización de las funciones y variables por nombre, y puede ser mostrada con el comando nm:

     $ nm a.out
     08049534 d _DYNAMIC
     08049608 d _GLOBAL_OFFSET_TABLE_
     ........
     080483e4 T main
              U puts@GLIBC_2.0

Entre el contenido de la tabla de símbolos, la salida muestra que el inicio de la función main está en el desplazamiento hexadecimal 080483e4. La mayoría de símbolos es para uso interno del compilador y del sistema operativo. Una T en la segunda columna indica que esta función está definida en el archivo objeto, mientras que una U indica que esta función está indefinida (y se deberá resolver en el enlazado con otro archivo objeto). Una completa explicación de la salida de nm se puede encontrar en la manual GNU Binutils.

El uso más frecuente del comando nm es para comprobar si una librería contiene la definición de una función específica, observando las entradas T en la segunda columna del nombre de la función.

Encontrando librerías dinámicas enlazadas
=========================================

Cuando un programa ha sido compilado usando librerías compartidas necesita cargar estas librerías dinámicamente en tiempo de ejecución para realizar las llamadas a funciones externas. El comando ldd examina un ejecutable y muestra la lista de librerías compartidas que necesita. Estas librerías son referidas como librerías compartidas dependientes del ejecutable.

Por ejemplo, el siguiente comando muestra como se encuentra la librería compartida como dependencia del programa Hola Mundo:

     $ gcc -Wall hola.es.c
     $ ldd a.out
     libc.so.6 => /lib/libc.so.6 (0x40020000)
     /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000) example

     La salida muestra que el programa Hola Mundo depende de la
     libraría C libc (librería
     compartida versión 6) y de la librería de carga
     dinámica ld-linux (librería compartida
     versión 2).

     Si el programa usa librerías externas, tal como la
     librería matemática, éstas también
     serían mostradas. Por ejemplo, el programa calc
     (el cual usa la función sqrt) genera la siguiente salida:

          $ gcc -Wall calc.es.c -lm -o calc
          $ ldd calc
          libm.so.6 => /lib/libm.so.6 (0x40020000)
          libc.so.6 => /lib/libc.so.6 (0x40041000)
          /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)

     La primera línea muestra que este programa depende de la
     librería matemática libm
     (librería compartida verisón 6), además de las
     librería de C y la librería de carga dinámica.

     El comando ldd puede ser usado para examinar estas mismas
     librerías compartidas, con objeto de seguir la cadena de
     dependencia de librerías compartidas.

Mensajes comunes de error
*************************

Este capítulo describe los errores y avisos más frecuentes producidos por gcc y g++. Cada caso está acompañado por una descripción de las causas, un ejemplo y sugerencias de posibles soluciones. Nótese que los mensajes de error puede variar ligeramente entre las diferentes versiones del compilador. Algunos mensajes puede solo se mostrados con opciones tales -Wall y -W.

Mensajes de error del preprocesador
===================================

No such file or directory

     Este error ocurre si GCC no puede encontrar un fichero pedido en su ruta de búsqueda. El fichero puede haber sido especificado en la línea de comandos, o con una sentencia #include. Si el nombre del fichero ha sido tecleado incorrectamente o el directorio del fichero necesita ser añadido para la ruta include o la ruta de enlace.

     Ejemplo:

               [file msg-file.es.c not included]

     El programa de arriba intenta incluir el fichero inexistente stdoi.h dando el error stdoi.h: No such file or directory. El nombre de fichero correcto es stdio.h.

macro or '#include' recursion too deep
#include nested too deeply

     Este error ocurre si el preprocesador encuentra demasiadas directivas #include anidadas. Esto es normalmente causado por dos ó más ficheros intentando incluir otro, provocando una recursión infinita.

     Ejemplo:

               [file msg-nest1.es.h not included]

               [file msg-nest2.es.h not included]

     La solución a este problema es asegurar que los ficheros no se incluyen mutuamente, o usar `guardas include' (see Proporcionando sus propias plantillas por ejemplo).

invalid preprocessing directive #...

     Este error indica que el preprocesador encontró un comando # irreconocible.

     Ejemplo:

               [file msg-invalidpp.es.c not included]

     La sintaxis de preprocesador requiere #elif para la condición ``else if'' en los bloques #if, en vez de #elseif. En el ejemplo de arriba ocurre un error de directiva inválida en el incorrecto uso de #elseif, pero solo cuando FOO está definido (en otros casos el preprocesador ignora cualquiera de la sentencia #else).

Mensajes de error del compilador
================================

`VARIABLE' undeclared (first use in this function)

     En C y C++ las variables deben ser declaradas antes de poder ser usadas. Este mensaje de error indica que el compilador ha encontrado un nombre de variable que no tiene su declaración correspondiente. Esto puede ser causado por una declaración perdida, o por un error de escritura en el nombre. Los nombres de variables son sensibles a mayúsculas, así foo y Foo representan diferentes variables. Para mantener breve la salida, sólo se informa del primer uso de una variable no declarada.

     Ejemplo:

               [file msg-undeclared.es.c not included]

     La variable j no está declarada y saltará el error `j' undeclared.

parse error before `...'
expected ';' before `...'
syntax error

     Este mensaje de error ocurre cuando el compilador encuentra una entrada inesperada, p.e. secuencias de caracteres que no siguen la sintaxis del lenguaje. Este mensaje de error salta por la ausencia de paréntesis o llaves de cierre o punto y coma precediendo la línea de error, o una palabra reservada inválida.

     Ejemplo:

               [file msg-parse.es.c not included]

     Aquí hay una ausencia de punto y coma después de la primera llamada a printf, dando un error de parseo.

parse error at end of input
expected declaration or statement at end of input

     Este error ocurre si el compilador encuentra un final de archivo inesperadamente, tal como cuando se analizan un número no balanceado de llaves de apertura y cierre. Es a menudo causado por la ausencia de un cierre de llaves en algún lugar.

     Ejemplo:

               [file msg-eoi.es.c not included]

     Una llave de cierre adicional es necesaria en este programa para prevenir el error expected declaration or statement at end of input.

warning: implicit declaration of function `...'
warning: incompatible implicit declaration of built-in function `...'

     Este aviso es generado cuando una función es usada sin un prototipo declarado. Esto puede ser causado por la falta de inclusión de una archivo de cabeceras, o si no olvidando suministrar un prototipo de función.

     Ejemplo:

               [file msg-implicitdecl.es.c not included]

     El archivo de cabeceras del sistema stdio.h no está incluido, así que el prototipo de la función printf no ha sido declarado. El programa necesita una línea inicial #include <stdio.h>.

unterminated string or character constant
missing terminating " character

     Este error es causado por unas comillas de apertura de una cadena o carácter que no tiene su correspondiente comillas de cierre. Las comillas deben aparecer en parejas coincidentes, como una comilla simple 'a' para caracteres o dobles comillas "aaa" para cadenas.

     Ejemplo:

               [file msg-unterm.es.c not included]

     Las dobles comillas de apertura de la cadena en este programa no tiene su correspondiente dobles comillas de cierre, así el compilador lee el resto del archivo como parte de la cadena.

character constant too long

     En C y C++ los caracteres son escritos usando simples comillas, p.e. 'a' da el código ASCII de la letra a (67), y '\n' da el código ASCII de nueva línea (10). Este error ocurre si unas comillas simples son usadas para encerrar más de un carácter.

     Ejemplo:

               [file msg-string2.es.c not included]

     El programa anterior confunde las comillas simples y dobles. Una secuencia de caracteres se debe escribir con comillas dobles, p.e. "¡Hola Mundo!". Este mismo problema ocurre en el siguiente programa C++,

               [file msg-string2.es.cc not included]

     Este error puede ocurrir si la barra de división y la barra invertida son confundidas en una secuencia de escape, p.e. usando '/n' en vez de '\n'. La secuencia /n consiste en dos caracteres separados, / y n.

     Observe que de acuerdo con el estándar C no hay límite en la longitud de una constante carácter, pero el valor de una constante carácter que contiene más de un carácter está definido en la implementación. Versiones más recientes de GCC soportan constantes de carácter multi-byte, y en vez de avisar de un error multiple-character character constant,será generado en este caso warning: character constant too long for its type.

warning: initialization makes integer from pointer without a cast

     Este error indica el uso erróneo de un puntero en un contexto entero. Técnicamente, es posible convertir entre tipos punteros y enteros, pero es raramente necesario fuera de las aplicaciones a nivel de sistema. Más a menudo, este aviso es el resultado de usar un puntero sin desreferenciarlo (p.e. escribiendo int i=p en vez de int i = *p).

     Este aviso puede ocurrir con tipos char y char *, desde que char es un tipo entero.

     Ejemplo:

               [file msg-char.es.c not included]

     La variable c tiene tipo char, mientras que la cadena '\n' se evalua como un puntero a const char * (una zona de 2 bytes de memoria contiene el valor ASCII del carácter nueva línea seguido de un byte a cero '\0', con el cual la cadena está nul-terminada). El código ASCII para el carácter nueva línea se puede encontrar usando char c = '\n';

     Errores similares pueden ocurrir con el uso incorrecto de la macro NULL,

               [file msg-null.es.c not included]

     En C, la macro NULL es definida como ((void *)0) en stdio.h y solamente debería ser usada en un contexto de puntero.

dereferencing pointer to incomplete type

     Este error ocurre cuando un programa intenta acceder a un elemento de una estructura a través de un puntero sin que la estructura haya sido declarada anteriormente. En C y C++ es posible declarar punteros a estructuras antes de la declaración de las estructuras, proporcionando los punteros que no son referenciados ---Esto es conocido como declaración avanzada (forward declaration).

     Ejemplo:

               [file msg-derefincomplete.es.c not included]

     Este programa tiene una declaración posterior de data como estructura btree. Sin embargo, la definición de la estructura es necesaria antes de que el puntero pueda ser referenciado para acceder a sus miembros individualmente.

warning: unknown escape sequence `...'

     Este error es causado por un incorrecto uso del carácter de escape en una cadena. Las secuencias de escape válidas son:

     \n nueva línea
     \t tabulador

     \b retroceso
     \r retorno de carro

     \f alimentación de línea
     \v tabulador vertical

     \a alerta (campana)

     Las combinaciones \\, \', \" y \? pueden ser usadas para caracteres individuales. Las secuencias de escape pueden usar códigos octales \0--\377 y códigos hexadecimales \0x00--\0xFF.

     Ejemplo:

               [file msg-unknownesc.es.c not included]

     La secuencia de escape \N en el programa anterior es inválida ---La correcta secuencia de escape para el carácter de nueva línea es \n.

warning: suggest parentheses around assignment used as truth value

     Este aviso resalta un potencial serio error, usando el operador = en vez del operador de comparación == en el test de la instrucción condicional o en otra expresión lógica. Mientras el operador de asignación puede ser usado como parte de un valor lógico, éste es raramente el comportamiento deseado.

     Ejemplo:

               [file msg-assign.es.c not included]

     El test anterior debería haberse escrito como if (i == 1), en otro caso la variable i será puesta a 1 por la evaluación de la misma instrucción if. El operador = tanto asigna como devuelve el valor de su parte derecha, causando que la variable i sea modificada y se tome una bifurcación inesperada. Similar resultado inesperado sucede con if (i = 0) en  vez de if (i == 0), excepto que en este caso el cuerpo de la instrucción if nunca será ejecutado.

     Este aviso se suprime si la instrucción es encerrada entre paréntesis adicionales para indicar que está siendo usado legítimamente.

warning: control reaches end of non-void function

     Una función que fué declarada con un tipo de retorno, tal como int o double, debe tener siempre una instrucción return devolviendo un valor del correspondiente tipo en todos los puntos de salida posibles ---en otro caso el valor de retorno no está bien definido. Las funciones declaradas void no necesitan instrucciones return.

     Ejemplo:

               [file msg-control.es.c not included]

     El programa anterior alcanza el final de la función display, la cual retorna un tipo int, sin una instrucción return. Una línea adicional como return 0; es necesaria.

     Cuando se usa gcc la función main de un programa C debe devolver un valor de tipo int (el estado de salida del programa). En C++ la instrucción return puede ser omitida en la función main ---el valor de retorno de la función main por defecto es 0 si no es especificado.

warning: unused variable `...'
warning: unused parameter `...'

     Este aviso indica que una variable ha sido declarada como variable local o parámetro de una función, pero no ha sido usada en ningún lugar. Una variable no usada puede ser el resultado de un error de programación, tal como usar accidentalmente el nombre de una variable en vez de otro.

     Ejemplo:

               [file msg-unused.es.c not included]

     En este programa la variable i y el parámetro p nunca son usados. Observe que las variables no usadas son informadas por al opción -Wall, mientras que los parámetros no usados sólo se muestran con -Wall -W.

warning: passing arg of ... as ... due to prototype

     Este aviso ocurrre cuando una función es llamada con un argumento de diferente tipo al especificado en su prototipo. La opción -Wconversion es necesaria para habilitar estos avisos. Vea la descripción de -Wconversion en Opciones de aviso adicionales para ver un ejemplo.

warning: assignment of read-only location
warning: cast discards qualifiers from pointer target type
warning: assignment discards qualifiers ...
warning: initialization discards qualifiers ...
warning: return discards qualifiers ...

     Estos avisos ocurren cuando un puntero es usado de manera incorrecta, violando un calificador de tipo tal como const. Los datos accedidos a través de un puntero marcado como const no se modificará, y el puntero en sí sólo puede ser asignado a otros punteros que también son marcados como const.

     Ejemplo:

               [file msg-const.es.c not included]

     Este programa intenta modificar datos constantes, y descartar la propiedad const del argumento s en el valor devuelto.

initializer element is not a constant

     En C, las variables globales solo pueden ser inicializadas con constantes, tales como valores numéricos, NULL o cadenas. Este error ocurre si un valor no constante es usado.

     Ejemplo:

               [file msg-init.es.c not included]

     Este programa intenta inicializar dos variables desde otras variables. En particular, no se requiere al flujo stdout ser una constante por el estándar de C (aunque en algunos sistemas es una constante). Nótese que inicializadore no constantes son permitidos en C++.

Mensajes de error del enlazador
===============================

file not recognized: File format not recognized

     GCC usa la extensión de un fichero, tal como .c o .cc, para determinar su contenido. Si no hay extensión GCC no puede reconocer el tipo de fichero y dará este error.

     Ejemplo:

               [file msg-ext not included]

     Si el programa de debajo está guardado en un fichero hola sin extensión, entonces al compilarlo dará el siguiente error:

          $ gcc -Wall hola
          hola: file not recognized: File format not
          recognized
          collect2: ld returned 1 exit status example

          La solución es renombrar el fichero para la correcta extensión,
          en este caso hola.es.c.

     undefined reference to `foo'
     collect2: ld returned 1 exit status

          Este error ocurre cuando un programa usa una función o variable que no
          está definida en cualquiera de los ficheros objeto o
          librerías
          suministradas para el enlazador. Esto puede ser causado por una
          librería perdida o el uso de un nombre incorrecto. En el
          mensaje de
          error de debajo, el programa collect2 es parte del enlazador.

          Ejemplo:

                    [file msg-undef.es.c not included]

          Si este programa está compilado sin ser enlazado a una
          librería o fichero
          objeto conteniendo la función foo() habrá una indefinida
          referencia de error.

     /usr/lib/crt1.o(.text+0x18): undefined reference to `main'

          Este error es un caso especial del error de debajo, cuando la función
          perdida es  main. En C y C++, cada programa debe tener una función
           main (dónde la ejecución comienza). Cuando se compila un fichero
          fuente individual sin una función main, usa la opción -c
          (see Creando archivos objeto desde archivos fuente).

Mensajes de error en tiempo de ejecución
========================================

error while loading shared libraries:
cannot open shared object file: No such file or directory

     El programa usa librerías compartidas, pero los necesarios ficheros de las librerías compartidas no pueden ser encontrados por el enlazador dinámico cuando el programa comienza. La ruta de búsqueda para las librerías compartidas es controlada por la variable de entorno LD_LIBRARY_PATH (see Librerías compartidas y librerías estáticas).

Segmentation fault
Bus error
     Estos mensajes en tiempo de ejecución indican un error de acceso a memoria

     Causas comunes incluyen:

       * desreferenciando un puntero nulo o un puntero no inicializado

       * acceso al array fuera de los límites

       * incorrecto uso de malloc, free y funciones relacionadas

       * uso de scanf con argumentos no válidos

     Hay una sutil diferencia entre fallos de segmentación y errores de bus. Un fallo de segmentación ocurre cuando un proceso intenta acceder a memoria protegida por el sistema operativo. Un error de bus ocurre cuando memoria válida es accedida de un modo incorrecto (por ejemplo, intentando leer un no alineado valor en arquitecturas dónde los valores deben ser alineados con 4-bytes).

floating point exception

     Este error en tiempo de ejecución es causado por una excepción aritmética, tal como división por cero, desbordamiento, por exceso y por defecto o una operación no válida (p.e. la raíz cuadrada de -1). El sistema operativo determina qué condiciones producen este error. En sistemas GNU, las funciones feenableexcept y fedisableexcept pueden ser usadas para capturar o enmascarar cada tipo de excepción.

Illegal instruction

     Este error es producido por el sistema operativo cuando se encuentra una instrucción máquina ilegal. Esto ocurre cuando el código ha sido compilado para una arquitectura específica y se ejecuta en otra.

Obteniendo ayuda
****************

Si encuentras un problema no cubierto por esta introducción, hay varios manuales de referencia que describen GCC y asuntos relacionados con el lenguaje en más detalle (see Lectura adicional). Estos manuales contienen respuestas a preguntas comunes, y un cuidadoso estudio de éstas normalmente producirán una solución.

De otro modo, hay muchas compañías y consultores quienes ofrecen soporte comercial para cuestiones de programación relativas a GCC por horas o de forma contínua. En los negocios esto puede ser un camino de costes efectivo para obtener soporte de alta calidad.

Un directorio de compañías que dan soporte al software libre y sus precios actualizados puede ser encontrado en el sitio web (http://www.gnu.org/prep/service.html) del Proyecto GNU. Con software libre, el soporte comercial está disponible en un mercado libre ---compañías de servicios compiten en calidad y precio, y los  usuarios no están atados a una determinada. En contraste, el soporte para el software privativo está normalmente sólo disponible desde el vendedor original.

Un soporte comercial de alto nivel para GCC está disponible desde compañías involucradas en el desarrollo del conjunto de herramientas del compilador de GNU por sí mismo. Un listado de estas compañías puede ser encontrado en la sección de ``Compañías de Desarrollo'' de la página web de la editorial para este libro. (http://www.network-theory.co.uk/gcc/intro/) Estas compañías pueden proporcionar servicios tales como extender GCC para generar código para nuevos procesadores o para arreglar errores encontrados en el compilador.

Lectura adicional
*****************

La guía definitiva para GCC es el manual oficial de referencia, ``Using GCC'', publicado por GNU Press:

     Using GCC (for GCC version 3.3.1) por Richard M. Stallman y the GCC Developer Community (Publicado por GNU Press, ISBN 1-882114-39-6)

Este manual es esencial para cualquiera que trabaje con GCC porque describe cada opción en detalle. Nótese que el manual está actualizado cuando nuevas versiones de GCC llegan a estar disponibles, así el número ISBN puede cambiar en el futuro.

Si eres nuevo programando con GCC también querrás aprender a usar el Depurador de GNU GDB, y a cómo compilar largos programas fácilmente con GNU Make. Éstas herramientas son descritas en los siguientes manuales:

     Debugging with GDB: The GNU Source-Level Debugger por Richard M. Stallman, Roland Pesch, Stan Shebs, et al. (Publicado por GNU Press, ISBN 1-882114-88-4)

     GNU Make: A Program for Directing Recompilation por Richard M. Stallman y Roland McGrath (Publicado por GNU Press, ISBN 1-882114-82-5)

Para una efectiva programación en C es también esencial tener buenos conocimientos de la librería estándar de C. El siguientes manual documenta todas las funciones en la GNU C Library:

     The GNU C Library Reference Manual por Sandra Loosemore con Richard M. Stallman, et al (2 vols) (Publicado por GNU Press, ISBN 1-882114-22-1 y 1-882114-24-8)

Asegúrate de visitar el sitio web http://www.gnupress.org/ para las últimas ediciones impresas de manuales publicados por GNU Press. Los manuales pueden ser adquiridos online usando una tarjeta de crédito en el sitio web de la FSF (http://order.fsf.org/) además de estar disponbles para su compra a través de la mayoría de las librerías usando ISBN. Manuales publicados por GNU Press financian la Free Software Foundation y el Proyecto GNU.

Información acerca de comandos de shell, variables de entorno y reglas de comillas en shell puede ser encontrada en el siguiente libro:

     The GNU Bash Reference Manual por Chet Ramey y Brian Fox (Publicados por Network Theory Ltd, ISBN 0-9541617-7-7)

Otros Manuales de GNU mencionados en este libro (tal como GNU gprof ---The GNU Profiler y The GNU Binutils Manual no estaban disponibles en forma impresa en el momento en que este libro fué a imprenta. Enlaces a copias online pueden ser encontradas en la página web de la editorial para esto book. (http://www.network-theory.co.uk/gcc/intro/)

La página web oficial del Proyecto GNU para GCC puede ser encontrado en http://www.gnu.org/software/gcc/. Éste sitio incluye una lista de preguntas frecuentes, así como la base de datos de errores y gran cantidad de otra información útil acerca de GCC.

Hay muchos libros acerca de los lenguajes C y C++. Dos de los estándares de referencia son:

     The C Programming Language (ANSI edition)  Brian W. Kernighan, Dennis Ritchie (ISBN 0-13110362-8)

     The C++ Programming Language (3rd edition)  Bjarne Stroustrup (ISBN 0-20188954-4)

Cualquiera usando los lenguajes C y C++ en un contexto profesional obtendrá una copia de los estándares oficiales, que están disponibles como libros impresos:

     The C Standard: Incorporating Technical Corrigendum 1 (Publicado por Wiley, ISBN 0-470-84573-2)

     The C++ Standard (Publicado por Wiley, ISBN 0-470-84674-7)

Por referencia, el número estándar C es ISO/IEC 9899:1990, para el original estándar C publicado en 1990 e implementado por GCC. Un estándar de C revisado ISO/IEC 9899:1999 (conocido como C99) fué publicado en 1999, y éste es mayoritariamente (pero todavía no completamente) soportado por GCC. El estándar de C++ es ISO/IEC 14882.

El estándar de aritmética en coma flotante IEEE-754 es importante para cualquier programa involucrados en computación numérica. El estándar está disponible de manera comercial desde el IEEE, y también es descrito en el siguiente libro:

     Numerical Computing with IEEE Floating Point Arithmetic por Michael Overton (Publicado por SIAM, ISBN 0-89871-482-6).

El libro incluye muchos ejemplos para ilustrar la razón fundamental para el estándar.

Reconocimientos
***************

Muchas personas han contribuido a este libro, y es importante recordar sus nombres aquí:

Gracias a Gerald Pfeifer, por su cuidadosa revisión y numerosas sugerencias para mejorar el libro.

Gracias a  Andreas Jaeger, por la información acerca de AMD64 y soporte multi-arquitectura, y sus muchos útiles comentarios.

Gracias a David Edelsohn, por la información acerca de la serie de procesadores POWER/PowerPC.

Gracias a Jamie Lokier, por investigar.

Gracias a Martin Leisner, Mario Pernici, Stephen Compall y Nigel Lowry, por sus útiles correcciones.

Gracias a Gerard Jungman, por sus útiles comentarios.

Gracias a Steven Rubin, por generar la imagen del chip para la cubierta con Electric.

Y de manera más importante, gracias a Richard Stallman, fundador del Proyecto GNU, por escribir GCC y hacer que sea software libre.

Organizaciones de software libre
********************************

El GCC, GNU Compiller Collection (Colección de Compiladores de GNU) es parte del Proyecto GNU, lanzado en 1984 para desarrollar un sistema operativo Unix completo que es software libre: el sistema GNU.

La Free Software Foundation (FSF) es una organización de caridad exenta de impuestos que recoge fondo para el continuo trabajo del Proyecto GNU. Está dedicada a promover el derecho a usar, estudiar, copiar, modificar, y redistribuir programas de ordenador. Uno de los mejores caminos para ayudar al desarrollo del software libre es ser un miembro asociado a la Free Software Foundation, y pagar regularmente cuotas para dar soporte a sus esfuerzos.

Los miembros asociados a la Free Software Foundation reciben muchos beneficios incluyendo noticias, admisión a los encuentros anuales de la FSF, y descuentos en libros y CDROMs publicados por GNU Press. Los costes por ser miembro son deducibles de impuestos en Estados Unidos. Para más información acerca de cómo llegar a ser miembro visita el sitio web de la FSF en http://www.fsf.org/.

La Free Software Foundation Europe (FSFE) es una organización hermana de la Free Software Foundation. La FSFE es activa en la promoción del software libre a todos los niveles en Europa. Por una cuota anual, se puede ser miembro de la FSFE y dar soporte a su trabajo. Los miembros reciben una tarjeta de miembro personalizada y compatible con GPG, permitiendo autenticación digital segura de correo electrónico y ficheros, y obtener acceso a la ``FSFE Fellowship'', una comunidad electrónica por la libertad del software. Para más información, visita el sitio web de la FSFE en http://www.fsfe.org/.

La Foundation for a Free Information Infrastructure (FFII) es otra organización importante en Europa. FFII no se dedica específicamente al software libre, pero trabaja para defender los derechos de todos los programadores y usuarios de ordenadores contra los monopolios en el campo de la computación, tales como patentes de software. Para más información acerca de FFII, o para dar soporte a su trabajo con una donación, visita su sitio web en http://www.ffii.org/.