Ubuntu Manpage: ar - crea, modifica y extrae de archivos

Provided by: manpages-es-extra_0.8a-16_all

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