Cómo usar el comando ar de Linux para crear bibliotecas estáticas

Utilice el ar comando de Linux  para crear bibliotecas de funciones cuando esté desarrollando software. Este tutorial le mostrará cómo crear una biblioteca estática, modificarla y usarla en un programa, con código de muestra.

El arcomando es un verdadero veterano: existe desde 1971. El nombre hace arreferencia al uso original previsto para la herramienta, que era crear archivos de almacenamiento . Un archivo de almacenamiento es un archivo único que actúa como contenedor de otros archivos. A veces, para muchos otros archivos. Los archivos se pueden agregar, eliminar o extraer del archivo. Las personas que buscan ese tipo de funcionalidad ya no recurren a ellas ar. Ese papel ha sido asumido por otras utilidades como tar.

Sin arembargo, el comando todavía se usa para algunos propósitos especializados. arse utiliza para crear bibliotecas estáticas. Estos se utilizan en el desarrollo de software. Y artambién se utiliza para crear archivos de paquetes como los archivos «.deb» utilizados en la distribución Debian Linux y sus derivados, como Ubuntu.

Vamos a ejecutar los pasos necesarios para crear y modificar una biblioteca estática, y demostraremos cómo usar la biblioteca en un programa. Para hacer eso, necesitamos un requisito para que la biblioteca estática cumpla. El propósito de esta biblioteca es codificar cadenas de texto y decodificar texto codificado.

Tenga en cuenta que este es un truco rápido y sucio para fines de demostración. No use este cifrado para nada que sea de valor. Es el cifrado de sustitución más simple del mundo , donde A se convierte en B, B se convierte en C, y así sucesivamente.

Las funciones cipher_encode () y cipher_decode ()

Vamos a trabajar en un directorio llamado «biblioteca» y luego crearemos un subdirectorio llamado «prueba».

Tenemos dos archivos en este directorio. En un archivo de texto llamado cipher_encode.c tenemos la cipher_encode()función:

cipher_encode vacío (char * texto)
{
 para (int i = 0; texto [i]! = 0x0; i ++) {
   texto [i] ++;
 }

} // fin de cipher_encode

La cipher_decode()función correspondiente está en un archivo de texto llamado cipher_decode.c:

void cipher_decode (char * texto)
{
 para (int i = 0; texto [i]! = 0x0; i ++) {
   texto [i] -;
 }

} // fin de cipher_decode

Los archivos que contienen instrucciones de programación se denominan archivos de código fuente. Vamos a crear un archivo de biblioteca llamado libcipher.a. Contendrá las versiones compiladas de estos dos archivos de código fuente. También crearemos un archivo de texto corto llamado libcipher.h. Este es un archivo de encabezado que contiene las definiciones de las dos funciones en nuestra nueva biblioteca.

Cualquiera que tenga la biblioteca y el archivo de encabezado podrá utilizar las dos funciones en sus propios programas. No necesitan reinventar la rueda y reescribir las funciones; simplemente hacen uso de las copias de nuestra biblioteca.

Compilar los archivos cipher_encode.cy cipher_decode.c

Para compilar los archivos de código fuente, usaremos gccel compilador GNU estándar . La -copción (compilar, sin enlace) le dice gccque compile los archivos y luego se detenga. Produce un archivo intermediario de cada archivo de código fuente llamado archivo objeto. El gccvinculador generalmente toma todos los archivos de objeto y los vincula para crear un programa ejecutable. Nos saltamos ese paso al usar la -copción. Solo necesitamos los archivos de objeto.

Comprobemos que tenemos los archivos que creemos que tenemos.

ls -l

Los dos archivos de código fuente están presentes en este directorio. Usemos gccpara compilarlos en archivos objeto.

gcc -c codificación_cifrado.c

gcc -c código_cifrado.c

No debería haber salida de gccsi todo va bien.

Esto genera dos archivos de objeto con el mismo nombre que los archivos de código fuente, pero con extensiones «.o». Estos son los archivos que debemos agregar al archivo de la biblioteca.

ls -l

Creación de la biblioteca libcipher.a

Para crear el archivo de biblioteca, que en realidad es un archivo de almacenamiento, usaremos ar.

Estamos usando la -copción (crear) para crear el archivo de la biblioteca, la -ropción (agregar con reemplazar) para agregar los archivos al archivo de la biblioteca y la -sopción (índice) para crear un índice de los archivos dentro del archivo de la biblioteca.

Vamos a llamar al archivo de biblioteca libcipher.a. Proporcionamos ese nombre en la línea de comando, junto con los nombres de los archivos objeto que vamos a agregar a la biblioteca.

ar -crs libcipher.a cifrado_encode.o cifrado_decode.o

Si enumeramos los archivos en el directorio, veremos que ahora tenemos un archivo libcipher.a.

ls -l

Si usamos la -topción (tabla) con arpodemos ver los módulos dentro del archivo de la biblioteca.

ar -t libcipher.a

Creación del archivo de encabezado libcipher.h

El archivo libcipher.h se incluirá en cualquier programa que utilice la biblioteca libcipher.a. El archivo libcipher.h debe contener la definición de las funciones que están en la biblioteca.

Para crear el archivo de encabezado, debemos escribir las definiciones de la función en un editor de texto como gedit . Nombra el archivo “libcipher.h” y guárdalo en el mismo directorio que el archivo libcipher.a.

void cipher_encode (char * texto);
void cipher_decode (char * texto);

Usando la biblioteca libcipher

La única forma segura de probar nuestra nueva biblioteca es escribir un pequeño programa para usarla. Primero, crearemos un directorio llamado test.

prueba mkdir

Copiaremos la biblioteca y los archivos de encabezado en el nuevo directorio.

cp libcipher. * ./test

Cambiaremos al nuevo directorio.

prueba de cd

Revisemos que nuestros dos archivos estén aquí.

ls -l

Necesitamos crear un pequeño programa que pueda usar la biblioteca y demostrar que funciona como se esperaba. Escriba las siguientes líneas de texto en un editor. Guarde el contenido del editor en un archivo llamado «test.c» en el directorio de prueba .

#include <stdio.h>
#include <stdlib.h>

#include "libcipher.h"

int main (int argc, char * argv [])
{
 char text [] = "How-To Geek ama Linux";

 pone (texto);

 cifrado_encode (texto);
 pone (texto);

 cipher_decode (texto);
 pone (texto);

 salir (0);

} // fin de main

El flujo del programa es muy simple:

• Incluye el archivo libcipher.h para que pueda ver las definiciones de funciones de la biblioteca.
• Crea una cadena llamada «texto» y almacena las palabras «How-To Geek loves Linux» en ella.
• Imprime esa cadena en la pantalla.
• llama a la cipher_encode()función para codificar la cadena e imprime la cadena codificada en la pantalla.
• Llama cipher_decode()para decodificar la cadena e imprime la cadena decodificada en la pantalla.

Para generar el testprograma, necesitamos compilar el programa test.cy el enlace en la biblioteca. La -oopción (salida) indica gcccómo llamar al programa ejecutable que genera.

gcc test.c libcipher.a -o test

Si gccte devuelve silenciosamente al símbolo del sistema, todo está bien. Ahora probemos nuestro programa. Momento de la verdad:

./prueba

Y vemos el resultado esperado. El testprograma imprime el texto sin formato imprime el texto cifrado y luego imprime el texto descifrado. Está usando las funciones dentro de nuestra nueva biblioteca. Nuestra biblioteca está funcionando.

Éxito. ¿Pero por qué detenerse ahí?

Agregar otro módulo a la biblioteca

Agreguemos otra función a la biblioteca. Agregaremos una función que el programador puede usar para mostrar la versión de la biblioteca que está usando. Necesitaremos crear la nueva función, compilarla y agregar el nuevo archivo de objeto al archivo de biblioteca existente.

Escriba las siguientes líneas en un editor. Guarde el contenido del editor en un archivo llamado cipher_version.c, en el directorio de la biblioteca .

#include <stdio.h>

void cipher_version (vacío)
{
 put ("How-To Geek :: MUY INSEGURE Cipher Library");
 put ("Versión 0.0.1 Alfa \ n");

} // fin de cipher_version

Necesitamos agregar la definición de la nueva función al archivo de encabezado libcipher.h. Agregue una nueva línea al final de ese archivo, para que se vea así:

void cipher_encode (char * texto);
void cipher_decode (char * texto);
void cipher_version (vacío);

Guarde el archivo libcipher.h modificado.

Necesitamos compilar el archivo cipher_version.c para tener un archivo objeto cipher_version.o.

gcc -c cipher_version.c

Esto crea un archivo cipher_version.o. Podemos agregar el nuevo archivo de objeto a la biblioteca libcipher.a con el siguiente comando. La -vopción (verbosa) hace que el usualmente silencioso arnos diga lo que ha hecho.

ar -rsv libcipher.a cipher_version.o

El nuevo archivo de objeto se agrega al archivo de biblioteca. arimprime la confirmación. La «a» significa «agregado».

Podemos usar la -topción (tabla) para ver qué módulos están dentro del archivo de la biblioteca.

ar -t libcipher.a

Ahora hay tres módulos dentro de nuestro archivo de biblioteca. Hagamos uso de la nueva función.

Usando la función cipher_version ().

Eliminemos la biblioteca antigua y el archivo de encabezado del directorio de prueba, copiemos los archivos nuevos y luego cambiemos de nuevo al directorio de prueba.

Eliminaremos las versiones anteriores de los archivos.

rm ./test/libcipher.*

Copiaremos las nuevas versiones en el directorio de prueba.

cp libcipher. * ./test

Cambiaremos al directorio de prueba.

prueba de cd

Y ahora podemos modificar el programa test.c para que use la nueva función de biblioteca.

Necesitamos agregar una nueva línea al programa test.c que llama a la cipher_version()función. Colocaremos esto antes de la primera puts(text);línea.

#include <stdio.h>
#include <stdlib.h> 

#include "libcipher.h" 

int main (int argc, char * argv []) 
{
 char text [] = "How-To Geek ama Linux"; 

 // nueva línea agregada aquí
 cipher_version (); 

 pone (texto); 
 
 cifrado_encode (texto); 
 pone (texto); 
 
 cipher_decode (texto); 
 pone (texto); 

 salir (0); 

} // fin de main

Guarde esto como test.c. Ahora podemos compilarlo y probar que la nueva función está operativa.

gcc test.c libcipher.a -o test

Ejecutemos la nueva versión de test:

La nueva función está funcionando. Podemos ver la versión de la biblioteca al comienzo de la salida de test.

Pero puede haber un problema.

Reemplazo de un módulo en la biblioteca

Esta no es la primera versión de la biblioteca; es el segundo. Nuestro número de versión es incorrecto. La primera versión no tenía ninguna cipher_version()función. Este lo hace. Así que esta debería ser la versión «0.0.2». Necesitamos reemplazar la cipher_version()función en la biblioteca con una corregida.

Afortunadamente, arhace que sea muy fácil de hacer.

Primero, editemos el archivo cipher_version.c en el directorio de la biblioteca . Cambie el texto «Versión 0.0.1 Alfa» a «Versión 0.0.2 Alfa». Debe tener un aspecto como este:

#include <stdio.h>

void cipher_version (vacío)
{
 put ("How-To Geek :: MUY INSEGURE Cipher Library");  
 put ("Versión 0.0.2 Alpha \ n"); 

} // fin de cipher_version

Guarde este archivo. Necesitamos compilarlo nuevamente para crear un nuevo archivo de objeto cipher_version.o.

gcc -c cipher_version.c

Ahora reemplazaremos el objeto cipher_version.o existente en la biblioteca con nuestra versión recién compilada.

Hemos usado la  -ropción (agregar con reemplazar) antes, para agregar nuevos módulos a la biblioteca. Cuando lo usemos con un módulo que ya existe en la biblioteca, arreemplazaremos la versión anterior por la nueva. La -sopción (índice) actualizará el índice de la biblioteca y la -v  opción (detallada) hará que  ar nos diga lo que ha hecho.

ar -rsv libcipher.a cipher_version.o

Esta vez arinforma que ha reemplazado el módulo cipher_version.o. La «r» significa reemplazado.

Uso de la función cipher_version () actualizada

Deberíamos utilizar nuestra biblioteca modificada y comprobar que funciona.

Copiaremos los archivos de la biblioteca al directorio de prueba.

cp libcipher. * ./test

Cambiaremos al directorio de prueba.

cd ./test

Necesitamos compilar nuestro programa de prueba nuevamente con nuestra nueva biblioteca.

gcc test.c libcipher.a -o test

Y ahora podemos probar nuestro programa.

./prueba

El resultado del programa de prueba es lo que esperábamos. El número de versión correcto se muestra en la cadena de versión y las rutinas de cifrado y descifrado están funcionando.

Eliminar módulos de una biblioteca

Parece una pena después de todo eso, pero eliminemos el archivo cipher_version.o del archivo de la biblioteca.

Para hacer esto, usaremos la -dopción (borrar). También usaremos la -vopción (detallada), de modo que arnos diga lo que ha hecho. También incluiremos la -sopción (índice) para actualizar el índice en el archivo de la biblioteca.

ar -dsv libcipher.a cipher_version.o

arinforma que ha eliminado el módulo. La «d» significa «eliminado».

Si pedimos arenumerar los módulos dentro del archivo de la biblioteca, veremos que volvemos a dos módulos.

ar -t libcipher.a

Si va a eliminar módulos de su biblioteca, recuerde eliminar su definición del archivo de encabezado de la biblioteca.

Comparte tu código

Las bibliotecas hacen que el código se pueda compartir de una manera práctica pero privada. Cualquiera a quien le dé el archivo de la biblioteca y el archivo de encabezado puede usar su biblioteca, pero su código fuente real permanece privado.