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.