Provided by: manpages-es-extra_0.8a-17_all bug

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.