Index général des pages de man   Index Section man 1   Table des Matières de as   Imprime la page de man as en mode Texte   Recherche dans les pages de man   Page de man en français      Commandes destinées aux utilisateurs (section 1)

as

 
  

Nom

as - L'assembleur GNU portable.

Synopsis

as [-a[dhlns][=fichier]] [-D] [--defsym SYM=VAL] [-f] [--gstabs] [-I chemin] [-K] [-L] [-M | --mri] [-o fichobj] [-R] [--traditional-format] [-v] [-w] [-- | fichiers...]

options spécifiques i960 :
[-ACA|-ACA_A|-ACB|-ACC|-AKA|-AKB|-AKC|-AMC] [-b] [-no-relax]

options spécifiques m680x0 :
[-l] [-mc68000|-mc68010|-mc68020]

Description

GNU as est en réalité une famille d'assembleurs. Si vous utilisez (ou avez utilisé) l'assembleur GNU sur une architecture, vous devriez trouver un environnemnt assez similaire quand vous l'utilisez sur une autre architecture. Chaque version a de plus en plus en commun avec les autres, ceci incluant les formats de fichiers objets, la plupart des directives assembleur (souvent appelées pseudo-ops) et la syntaxe de l'assembleur.

Pour obtenir de l'information sur la syntaxe et les pseudo-opérations utilisées par GNU as, voyez l'entrée `as' dans info (ou le manuel Using as: The GNU Assembler).

as est prévu en premier lieu pour assembler la sortie du compilateur C GNU gcc ou pour être utilisé par l'éditeur de liens ld. Néanmoins, nous avons essayé de faire en sorte que as assemble correctement tout ce qu'un assembleur natif ferait. Cela ne signifie pas pour autant que as utilise toujours la même syntaxe qu'un autre assembleur pour la même architecture; par exemple, nous connaissons beaucoup de versions de syntaxes de langages d'assemblage incompatibles.

Chaque fois que vous lancez as, il assemble exactement un programme source. Le programme source est constitué d'un ou de plusieurs fichiers. (L'entrée standard étant également un fichier).

Si aucun nom de fichier n'est fourni à as, il essaiera de lire un fichier d'entrée à partir de l'entrée standard de as, qui est normalement votre terminal. Vous pouvez avoir à taper ctrl-D pour indiquer à as qu'il n'y a plus de programme à assembler. Utilisez `--' si vous devez explicitement nommer le fichier d'entrée standard sur la ligne de commandes.

as peut émettre des avertissements et des messages d'erreurs dans la sortie standard d'erreur (en général votre terminal). Ceci ne se produirait pas si as est lancé automatiquement depuis un compilateur. Les avertissements rapportent des suppositions effectuées de sorte que as puisse continuer à assembler un programme contenant des défauts; les erreurs rapportent un grave problème qui provoque l'arrêt de l'assemblage.

Options

-a
Activer les listings d'assemblage. Il y a des sous-options variées. d omet les directives de déboggage. h inclut le code source de haut niveau; cette option n'est disponible que si le fichier source peut être trouvé, et si le code a été compilé avec l'option -g. l inclut un listing d'assemblage. n omet les traitements de formes. s inclut un listing des symboles. = fichier est le nom du fichier de listing; ceci doit être la dernière sous-option. Les sous-options par défaut sont hls.
-D
Cette option n'est acceptée que pour assurer la compatibilité avec des scripts contenant des appels à d'autres assembleurs; elle n'a pas d'effet sur as.
--defsym SYM=VAL
Définir le symbole SYM de valeur VAL avant l'assemblage du fichier d'entrée. VAL doit être une constante entière. Comme en C, un préfixe 0x indique une valeur hexadécimale, et un 0 en tête indique une valeur octale.
-f
``fast''--ne pas lancer le préprocesseur (supposer que la source est une sortie de compilateur).
-I chemin
Ajouter chemin à la liste des chemins de recherche pour les directives .include.
--gstabs
Générer des informations de déboggage au format stabs pour chaque ligne d'assembleur. Ceci peut aider au déboggage du code assembleur, si le déboggeur le supporte.
-K
Emettre des avertissements quand des tables de différences sont altérées pour des longs déplacements.
-L
Garder (dans la table des symboles) les symboles locaux débutant par `L'
-M, --mri
Assembler dans le mode de compatibilité MRI.
-o fichobj
Nommer le fichier objet généré par as en fichobj.
-R
joindre les segments de données et de texte (code).
--traditional-format
Utiliser le même format qu'un assembleur natif, quand c'est possible.
-v
Afficher le numéro de version de as.
-W, --no-warn
Supprimer les messages d'avertissemennt.
--fatal-warnings
Considérer que tout avertissement est fatal.
--warn
Uniquement mentionner les avertissements.
-- | files...
Fichiers sources à assembler, ou entrée standard (--)
-Avar
(Quand configuré pour Intel 960.) Spécifier quelle variante de l'architecture 960 est la cible.
-b
(Quand configuré pour Intel 960.) Ajouter du code pour obtenir des statistiques sur les branchements utilisés.
-no-relax
(Quand configuré pour Intel 960.) Ne pas modifier les instructions compare-and-branch pour les longs déplacements, même si c'est nécessaire.
-l
(Quand configuré pour Motorola 68000).
Raccourcir les références aux symboles indéfinis à un mot au lieu de deux.
-mc68000|-mc68010|-mc68020
(Quand configuré pour Motorola 68000).
Spécifier quel processeur de la famille 68000 est la cible (68020 par défaut)

Les options peuvent être placées dans n'importe quel ordre, et peuvent être mises avant, après ou entre des noms de fichiers. Par contre, l'ordre des noms de fichier a une importance.

`--' (deux traits d'union) représente explicitement le flux d'entrée standard, comme un des fichiers que doit assembler as.

Sauf pour `--', tout argument de ligne de commandes qui commence par un trait d'union (`-') est une option. Chaque option modifie le comportement de as. Aucune option ne modifie le comportement d'une autre option. Une option est constituée d'un `-' suivi par une ou plusieurs lettres. La casse est importante. Toutes les options sont optionelles.

L'option `-o' s'attend à être suivie par exactement un nom de fichier. Le nom de fichier peut ou bien immédiatement suivre la letrre d'option (pour être compatibles avec des assembleurs plus anciens), ou bien être l'argument suivant sur la ligne de commandes (standard GNU).

Ces deux lignes de commandes sont ésuivalentes :
as  -o  mon-fichier-objet.o  mumble.s
as  -omon-fichier-objet.o  mumble.s

Voir Aussi

l'entrée `as' dans info; Using as: The GNU Assembler; gcc(1) , ld(1) .

Copyright

Copyright (c) 1991, 1992 Free Software Foundation, Inc.

L'autorisation est donnée de créer et de distribuer des copies textuelles de ce manuel, à condition que la notice de copyright et la notice de permission soient préservées dans toutes les copies.

L'autorisation est donnée de copier et distribuer des versions modifiées de ce manuel sous les conditions de copie textuelle, à condition que l'entièreté du travail dérivé résultant soit distribuée sous les termes d'une autorisation identique à celle-ci.

L'autorisation est donnée de copier et distribuer des traductions de ce manuel dans n'importe quel autre langue, sous les conditions ci-dessus pour les versions modifiées, sauf que cette notice de permission peut être incluse dans des traductions approuvées par la Free Software Foundation au lieu de l'anglais originel.

Traduction

Frédéric Delanoy, 2000.


Table des matières


Haut de page

© 1996-2000 Adaptation française "Christophe Blaess"