Provided by:
manpages-es-extra_0.8a-17_all 
NOMBRE
ar - crea, modifica y extrae de archivos
SINOPSIS
ar [-]{dmpqrtx}[abcilosSuvV] [nombre_miembro] archivo ficheros...
DESCRIPCI'ON
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 extraccion.
El programa ar de GNU puede mantener ficheros cuyos miembros tengan
nombres de cualquier longitud; sin embargo, dependiendo de como se
configure ar en su sistema, se puede imponer un limite a la longitud de
los nombres de los miembros (para compatibilizar con formatos de
archivo mantenidos por otras herramientas). Si existe, el limite es
frecuentemente 15 caracteres (tipico de formatos referidos a a.out) o
16 caracteres (tipico de formatos relacionados con COFF).
ar se considera una utilidad binaria porque los archivos de esta forma
son usados con mas frecuencia como bibliotecas que contienen las
subrutinas necesarias.
ar creara un indice hacia los simbolos definidos en los modulos objetos
reubicables del archivo cuando especifique el modificador `s'. Una
vez creado, este indice se actualiza en el archivo cuando ar efectua
un cambio en sus contenidos (guardados para la operacion de
actualizacion `q'). Un archivo con tal indice acelera el enlace para
la biblioteca, y permite que las rutinas de la biblioteca se llamen
unas a otras sin importar su situacion en el archivo.
Puede usar `nm -s' o `nm --print-armap' para obtener una lista de estas
tablas de indices. Si un archivo carece de la tabla, se puede emplear
otra forma de ar llamada ranlib para anadir la tabla.
ar insiste en recibir al menos dos argumentos para ejecutarse: uno, la
letra que especifica la operaci'on (opcionalmente acompanada por otras
letras que especifican los modificadores), y el nombre del archivo
sobre el que actuar.
Muchas operaciones pueden tambien aceptar mas argumentos fichero que
especifican ficheros particulares para operar.
OPCIONES
El programa ar de GNU le permite mezclar el codigo de operacion p y
opciones modificadoras mod en cualquier orden, con el primer argumento
de la linea de mandatos.
Si quiere, puede comenzar el primer argumento de la linea de ordenes
con un signo menos.
La letra p especifica que operacion ejecutar; puede ser cualquiera de
las siguientes, pero debe especificar solo una de ellas:
d Borra (delete) modulos del archivo. Especifica los nombres que
seran eliminados como ficheros; el archivo permanece intacto si
no especifica ficheros para borrar.
Si especifica el modificador `v', ar mostrara cada modulo que
se borre.
m Use esta operacion para mover miembros de un archivo.
La ordenacion de los miembros de un archivo puede originar
diferencias en como los programas se enlazan al usar la
biblioteca, si un simbolo esta definido en mas 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 estandar. Si se especifica el modificador,
`v' muestra el nombre del miembro antes de copiarlo a la salida
estandar.
Si no especifica ficheros, se imprimen todos los ficheros del
archivo.
q A~nadido r'apido (quick append) ; anade ficheros al final del
archivo, sin comprobar posibles sustituciones.
Los modificadores `a', `b', e `i' , no afectan a esta operacion;
los nuevos miembros siempre se situan al final del archivo.
El modificador `v' hace que ar liste cada fichero que es anada.
Como el objetivo de esta operacion es la velocidad, la tabla
indice de simbolos del archivo no se actualiza, incluso si
existe; puede usar `ar s' o ranlib explicitamente para
actualizar el indice de la tabla de simbolos.
Sin embargo, demasiados sistemas diferentes suponen que el
anadido rapido reconstruye el indice, por lo que ar de GNU
implementa `q' como un sinonimo de `r'.
r Inserta ficheros en un archivo (con sustituci'on). Esta operacion
difiere de `q' en que cualesquiera miembros existentes se borran
si sus nombres coinciden con los que son anadidos.
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 omision, los nuevos miembros se anaden al final del fichero;
pero puede usar alguno de los modificadores `a', `b', o `i'
para requerir una ubicacion relativa a algun miembro existente.
El modificador `v' utilizado con esta operacion genera una linea
de salida por cada fichero insertado, con una de estas letras
`a' o `r' para indicar si el fichero fue anadido (no antiguos
miembros borrados) o sustituido.
t Muestra una tabla que lista el contenido del archivo, o aquellos
ficheros listados en ficheros que esten presentes en el archivo.
Normalmente solo se muestra el nombre del miembro; si tambien
quiere ver los modos (permisos), tiempos, propietario, grupo y
tamano, puede pedirlo tambien especificando el modificador `v '
.
Si no especifica ningun fichero, se listan todos los ficheros
del archivo.
Si hay mas de un fichero con el mismo nombre (digamos, `fie') en
un archivo (digamos `b.a'), `ar t b.a fie' solo listara la
primera aparicion; 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 operacion, para solicitar que ar liste
cada nombre mientras lo extrae.
Si no especifica ningun fichero, se extraen todos los ficheros
de este archivo.
Un numero de modificadores (mod) puede seguir inmediatamente a la letra
p para especificar variaciones en el comportamiento de la operacion:
a Anade 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 especificacion de archivo.
b Anade 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 especificacion de archivo. (igual que
`i').
c Crea el archivo. El archivo especificado siempre se crea si no
existia, cuando se solicita una actualizacion. 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
permitira nombres de ficheros de cualquier longitud. Esto
ocasionara que se creen archivos que no son compatibles con el
ar nativo de algunos sistemas. Si esto es de interes, el
modificador f se puede usar para truncar los nombres de ficheros
poniendolos 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 especificacion 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
extraidos del archivo se marcaran con el instante de la
extraccion.
s Escribe un indice objeto-fichero en el archivo, o actualiza uno
existente, incluso si no se han efectuado cambios en el archivo.
Puede usar esta opcion modificadora bien con operaciones o bien
sola. Ejecutar `ar s' en un archivo es equivalente a ejecutar
`ranlib' en el.
S No genera una tabla de simbolos del archivo. Esto puede acelerar
la construccion de grandes bibliotecas en varios pasos. El
archivo resultante no se puede usar con el enlazador. Para
construir una tabla de simbolos, debe de omitir el modificador
`S' en la ultima ejecucion de `ar', o debera ejecutar `ranlib'
sobre el archivo.
u Normalmente, ar r... inserta todos los ficheros listados en el
archivo. Si quisiera insertar s'olo aquellos ficheros listados
que son mas recientes que los miembros existentes del mismo
nombre, use este modificador. El modificador `u' se permite
solo para la operacion `r' (replace, reemplazar). En
particular, la combinacion `qu' no se permite, ya que las
verificaciones de los tiempos haria perder cualquier ventaja de
velocidad de la operacion `q'.
v Este modificador (verbose) solicita la version prolija de una
operacion. Muchas operaciones muestran informacion adicional,
tales como nombres de ficheros procesados cuado se anade el
modificador `v'.
V Este modificador muestra el numero de version de ar.
V'EASE TAMBI'EN
La entrada del menu `Binutils' en Info; Las Utilidades de Binarios de
GNU, Roland H. Pesch (Octubre de 1991). nm(1), ranlib(1).
DERECHOS DE COPIA
Copyright (C) 1991 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the
entire resulting derived work is distributed under the terms of a
permission notice identical to this one.
Permission is granted to copy and distribute translations of this
manual into another language, under the above conditions for modified
versions, except that this permission notice may be included in
translations approved by the Free Software Foundation instead of in the
original English.
N. del T.: Solo tiene validez legal el aviso de copyright original. En
el fichero fuente de esta pagina de manual puede encontar una
traduccion.