ar(1)

NOMBRE
ar - crea, modifica y extrae de archivos

SINOPSIS
ar [-] {dmpqrtx}[abcilosSuvV] [nombre_miembro ] archivo ficheros ...

DESCRIPCIÓN
El programa de GNU ar crea, modifica, y extrae de archivos. Un archivo es un simple fichero que contiene un conjunto de otros ficheros en una estructura que hace posible recuperar los ficheros individuales originales (llamados miembros del archivo). El contenido de los ficheros originales, modos (permisos), tiempos, propietario y grupo se mantienen en el archivo, y se pueden reconstituir en la extracción. El programa ar de GNU puede mantener ficheros cuyos miembros tengan nombres de cualquier longitud; sin embargo, dependiendo de cómo se configure ar en su sistema, se puede imponer un límite a la longitud de los nombres de los miembros (para compatibilizar con formatos de archivo mantenidos por otras herramientas). Si existe, el límite es frecuentemente 15 caracteres (típico de formatos referidos a a.out) ó 16 caracteres (típico de formatos relacionados con COFF). ar se considera una utilidad binaria porque los archivos de esta forma son usados con más frecuencia como bibliotecas que contienen las subrutinas necesarias. ar creará un índice hacia los símbolos definidos en los módulos objetos reubicables del archivo cuando especifique el modificador `s '. Una vez creado, este índice se actualiza en el archivo cuando ar efectúa un cambio en sus contenidos (guardados para la operación de actualización `q '). Un archivo con tal índice acelera el enlace para la biblioteca, y permite que las rutinas de la biblioteca se llamen unas a otras sin importar su situación en el archivo. Puede usar `nm -s ' o `nm --print-armap ' para obtener una lista de estas tablas de índices. Si un archivo carece de la tabla, se puede emplear otra forma de ar llamada ranlib para añadir la tabla. ar insiste en recibir al menos dos argumentos para ejecutarse: uno, la letra que especifica la operación (opcionalmente acompañada por otras letras que especifican los modificadores ), y el nombre del archivo sobre el que actuar. Muchas operaciones pueden también aceptar más argumentos fichero que especifican ficheros particulares para operar.

OPCIONES
El programa ar de GNU le permite mezclar el código de operación p y opciones modificadoras mod en cualquier orden, con el primer argumento de la línea de mandatos. Si quiere, puede comenzar el primer argumento de la línea de órdenes con un signo menos. La letra p especifica qué operación ejecutar; puede ser cualquiera de las siguientes, pero debe especificar sólo una de ellas:

d   Borra (delete) módulos del archivo. Especifica los nombres que serán eliminados como ficheros ; el archivo permanece intacto si no especifica ficheros para borrar. Si especifica el modificador `v ', ar mostrará cada módulo que se borre.

m   Use esta operación para mover miembros de un archivo. La ordenación de los miembros de un archivo puede originar diferencias en cómo los programas se enlazan al usar la biblioteca, si un símbolo está definido en más de un miembro. Si no se usan modificadores con m , cualquier miembro que nombre en los argumentos ficheros se mueven al final del archivo; puede usar los modificadores `a ', `b ', o `i ' para moverlos a las posiciones especificadas.

p   Muestra (print) el miembro especificado del archivo en el fichero de salida estándar. Si se especifica el modificador, `v ' muestra el nombre del miembro antes de copiarlo a la salida estándar. Si no especifica ficheros , se imprimen todos los ficheros del archivo.

q   Añadido rápido (quick append) ; añade ficheros al final del archivo , sin comprobar posibles sustituciones. Los modificadores `a ', `b ', e `i ' , no afectan a esta operación; los nuevos miembros siempre se sitúan al final del archivo. El modificador `v ' hace que ar liste cada fichero que es añada. Como el objetivo de esta operación es la velocidad, la tabla índice de símbolos del archivo no se actualiza, incluso si existe; puede usar `ar s ' o ranlib explícitamente para actualizar el índice de la tabla de símbolos. Sin embargo, demasiados sistemas diferentes suponen que el añadido rápido reconstruye el índice, por lo que ar de GNU implementa `q ' como un sinónimo de `r '.

r   Inserta ficheros en un archivo (con sustitución ). Esta operación difiere de `q ' en que cualesquiera miembros existentes se borran si sus nombres coinciden con los que son añadidos. Si uno de los ficheros nombrados en ficheros no existe, ar muesta un mensaje de error, y deja intacto cualquier miembro que exista coincidiendo con ese nombre. Por omisión, los nuevos miembros se añaden al final del fichero; pero puede usar alguno de los modificadores `a ', `b ', o `i ' para requerir una ubicación relativa a algún miembro existente. El modificador `v ' utilizado con esta operación genera una línea de salida por cada fichero insertado, con una de estas letras `a ' o `r ' para indicar si el fichero fue añadido (no antiguos miembros borrados) o sustituido.

t   Muestra una tabla que lista el contenido del archivo , o aquellos ficheros listados en ficheros que estén presentes en el archivo. Normalmente sólo se muestra el nombre del miembro; si también quiere ver los modos (permisos), tiempos, propietario, grupo y tamaño, puede pedirlo también especificando el modificador `v
     ' . Si no especifica ningún fichero , se listan todos los ficheros del archivo. Si hay más de un fichero con el mismo nombre (digamos, `fie ') en un archivo (digamos `b.a '), `ar t b.a fie ' sólo listará la primera aparición; para verlos todos, tiene que solicitar un listado completo: en nuestro ejemplo, `ar t b.a '.

x   Extrae miembros (llamados ficheros ) del archivo. Puede usar el modificador `v ' con esta operación, para solicitar que ar liste cada nombre mientras lo extrae. Si no especifica ningún fichero , se extraen todos los ficheros de este archivo.

Un número de modificadores (mod ) puede seguir inmediatamente a la letra p para especificar variaciones en el comportamiento de la operación:

a   Añade nuevos ficheros tras un miembro existente del archivo. Si usa el modificador a , tiene que estar presente el nombre de un miembro del archivo como argumento nombre-de-miembro, antes de la especificación de archivo .

b   Añade nuevos ficheros antes de un miembro existente del archivo. Si usa el modificador b , tiene que estar presente el nombre de un miembro del archivo como argumento nombre-de-miembro, antes de la especificación de archivo. (igual que `i ').

c   Crea el archivo. El archivo especificado siempre se crea si no existía, cuando se solicita una actualización. Pero se produce un aviso salvo que especifique previamente que espera crearlo usando este modificador.

f   Trunca los nombres que hay en el archivo. ar normalmente permitirá nombres de ficheros de cualquier longitud. Esto ocasionará que se creen archivos que no son compatibles con el ar nativo de algunos sistemas. Si esto es de interés, el modificador f se puede usar para truncar los nombres de ficheros poniéndolos en el archivo.

i   Inserta nuevos ficheros antes de un miembro existente del archivo. Si usa el modificador i , tiene que estar presente el nombre de un miembro existente del archivo como el argumento nombre_de_miembro antes de la especificación del archivo . (igual que `b ').

l   Este modificador se acepta pero no se usa.

o   Preserva las fechas originales de los miembros cuando se extraen. Si no especifica este modificador, los ficheros extraídos del archivo se marcarán con el instante de la extracción.

s   Escribe un índice objeto-fichero en el archivo, o actualiza uno existente, incluso si no se han efectuado cambios en el archivo. Puede usar esta opción modificadora bien con operaciones o bien sola. Ejecutar `ar s ' en un archivo es equivalente a ejecutar `ranlib ' en él.

S   No genera una tabla de símbolos del archivo. Esto puede acelerar la construcción de grandes bibliotecas en varios pasos. El archivo resultante no se puede usar con el enlazador. Para construir una tabla de símbolos, debe de omitir el modificador `S ' en la última ejecución de `ar ', o deberá ejecutar `ranlib ' sobre el archivo.

u   Normalmente, ar r ... inserta todos los ficheros listados en el archivo. Si quisiera insertar sólo aquellos ficheros listados que son más recientes que los miembros existentes del mismo nombre, use este modificador. El modificador `u ' se permite sólo para la operación `r ' (replace, reemplazar). En particular, la combinación `qu ' no se permite, ya que las verificaciones de los tiempos haría perder cualquier ventaja de velocidad de la operación `q '.

v   Este modificador (verbose) solicita la versión prolija de una operación. Muchas operaciones muestran información adicional, tales como nombres de ficheros procesados cuado se añade el modificador `v '.

V   Este modificador muestra el número de versión de ar.

VÉASE TAMBIÉN
La entrada del menú `Binutils' en Info; Las Utilidades de Binarios de GNU, Roland H. Pesch (Octubre de 1991). nm(1) , ranlib(1) .

DERECHOS DE COPIA
Copyright © 1991 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English.

N. del T.: Sólo tiene validez legal el aviso de copyright original. En el fichero fuente de esta página de manual puede encontar una traducción.