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

NOMBRE

       GNU as - el ensamblador transportable de GNU

SINOPSIS

       as [-a[dhlns][=fichero]] [-D] [--defsym SÍM=VAL] [-f] [--gstabs] [-I
       camino] [-K] [-L] [-M | --mri] [-o fichobj] [-R] [--traditional-format]
       [-v] [-w] [-- | ficheros...]

       opciones solamente para i960:
       [-ACA|-ACA_A|-ACB|-ACC|-AKA|-AKB|-AKC|-AMC] [-b] [-no-relax]

       opciones solamente para m680x0:
       [-l] [-mc68000|-mc68010|-mc68020]

DESCRIPCIÓN

       GNU  as es realmente una familia de ensambladores.  Si Ud. emplea (o ha
       empleado) el ensamblador de GNU en una arquitectura, debería  encontrar
       un  entorno  bastante  similar  cuando  lo emplee en otra. Cada versión
       tiene mucho en común con las otras,  incluyendo  los  formatos  de  los
       ficheros objeto, la mayoría de las directivas del ensamblador (a menudo
       llamadas pseudo-ops) y la sintaxis del ensamblador.

       Para información sobre la sintaxis y las pseudo-ops empleadas  por  GNU
       as, consulte la entrada de menú ‘as’ en Info (o el manual Empleando as:
       El Ensamblador de GNU).

       as  está  concebido  principalmente  para  ensamblar  la   salida   del
       compilador  de  C de GNU gcc para el uso por el enlazador ld.  De todas
       formas, hemos intentado hacer que as ensamble correctamente todo lo que
       el ensamblador nativo haga.  Esto no significa que as siempre emplee la
       misma sintaxis que otro ensamblador para  la  misma  arquitectura;  por
       ejemplo,  sabemos  de varias versiones incompatibles de la sintaxis del
       lenguaje ensamblador de la familia 680x0.

       Cada vez que Ud. ejecuta as ensambla exactamente un programa fuente. El
       programa  fuente  está  constituido por uno o más ficheros. (La entrada
       estándar es también un fichero.)

       Si se llama a as sin dar nombres de ficheros, intenta leer  un  fichero
       de  entrada  desde  la  entrada  estándar de as,  que es normalmente su
       terminal.  Ud. ha de teclear entonces Ctrl-D para decirle a as  que  no
       hay   más   programa   que   ensamblar.    Use  ‘--’  si  Ud.  necesita
       explícitamente nombrar el fichero de entrada estándar en  su  línea  de
       órdenes.

       as  puede  escribir avisos y mensajes de error en el fichero de errores
       estándar (usualmente su terminal). Esto no debería ocurrir cuando as se
       ejecutara  automáticamente  a  través  de  un  compilador.  Los  avisos
       informan de que supuestamente as podría estar ensamblando  un  programa
       defectuoso;  los  errores  informan  de  un  grave problema que para el
       ensamblado.

OPCIONES

       -a     Activa los listados del ensamblado. Hay varias  subopciones.   d
              omite  las directivas de depuración.  h incluye el código fuente
              de alto nivel; esto sólo está disponible si  el  fichero  fuente
              puede  encontrarse, y si el código se compiló con -g.  l incluye
              un listado del ensamblador.  n omite procesamiento de formas.  s
              incluye  un  listado de símbolos.  = fichero establece el nombre
              del fichero de listado; ésta debe ser la última subopción.   Las
              subopciones predeterminadas son hls.

       -D     Esta  opción  se acepta solamente por compatibilidad con guiones
              que llamen a otros ensambladores; no tiene ningún efecto en  as.

       --defsym SÍM=VALOR
              Define  el  símbolo  SÍM con el valor VALOR antes del ensamblado
              del fichero de entrada. VALOR debe  ser  una  constante  entera.
              Como  en  C,  un  0x inicial indica un valor hexadecimal, y un 0
              inicial indica un valor octal.

       -f     rápido (‘‘fast’’): omite  el  preprocesado  (se  supone  que  la
              fuente es la salida de un compilador).

       -I camino
              Añade  camino a la lista de búsqueda de las directivas .include.

       --gstabs
              Genera información  de  depuración  stabs  para  cada  línea  de
              ensamblador.  Esto puede ayudar a depurar código ensamblador, si
              el depurador puede manejar esta información.

       -K     Lanza mensajes de advertencia cuando tablas  de  diferencias  se
              alteraron para largos desplazamientos.

       -L     Mantiene  (en  la tabla de símbolos) símbolos locales, empezando
              por ‘L-M, --mri
              Ensambla en modo de compatibilidad MRI.

       -o fichobj
              Nombra al fichero objeto de salida de as.

       -R     Despliega la sección de datos en la sección de texto.

       --traditional-format
              Emplea el mismo formato que el  ensamblador  nativo,  cuando  es
              posible.

       -v     Anuncia la versión de as.

       -W     Suprime mensajes de advertencia.

       -- | ficheros...
              Ficheros fuente a ensamblar, o entrada estándar (--)

       -Avar  (Cuando  se  ha  configurado  para  Intel  960.)  Especifica qué
              variante de la arquitectura 960 es el objetivo.

       -b     (Cuando se ha configurado para Intel 960.)   Añade  código  para
              recolectar datos sobre las bifurcaciones tomadas.

       -no-relax
              (Cuando  se  ha  configurado  para  Intel  960.)   No altera las
              instrucciones  comparar-y-saltar  para  desplazamientos  largos;
              produce un error si es necesario.

       -l     (Cuando se ha configurado para Motorola 68000).
              Acorta  las referencias a símbolos sin definir, a una palabra en
              vez de a dos.

       -mc68000|-mc68010|-mc68020
              (Cuando se ha configurado para Motorola 68000).
              Especifica qué procesador de la familia  68000  es  el  objetivo
              (por omisión el 68020).

       Las  opciones  pueden  ir  en  cualquier  orden,  y pueden estar antes,
       después o entre los nombres de ficheros. El orden  de  los  nombres  de
       fichero es significativo.

       ‘--’  (dos  guiones)  por  sí  mismos  nombran al fichero de la entrada
       estándar explícitamente, como uno de  los  ficheros  para  que  as  los
       ensamble.

       Excepto  para  ‘--’,  cualquier  argumento  de  la línea de órdenes que
       comience con un guión (‘-’)  es  una  opción.  Cada  opción  cambia  el
       comportamiento  de  as.   Ninguna opción cambia la forma en que trabaje
       otra opción. Una opción es un ‘-’ seguido por una o más letras; importa
       si son mayúsculas o minúsculas. Todas las opciones se pueden omitir.

       La  opción  ‘-o’  espera exactamente un nombre de fichero tras ella. El
       nombre de fichero puede ir inmediatamente tras la letra  de  la  opción
       (por  compatibilidad  con  ensambladores  más  antiguos) o puede ser el
       siguiente argumento de la orden (siguiendo el estándar de GNU).

       Éstas dos líneas de órdenes son equivalentes:
       as  -o  mi-fichero-objeto.o  grrr.s
       as  -omi-fichero-objeto.o  grrr.s

VÉASE TAMBIÉN

as’ en Info; Empleando as: El Ensamblador de GNU; gcc(1), ld(1).

DERECHOS DE COPIA

       Copyright (c) 1991, 1992 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.