as(1)

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.