Options de la ligne de commande

Options concernant les fichiers:

Option concernant les chemins en entrée

-I<chemin>

Spécifie un chemin pour lire les fichiers que RASM ne trouvera pas dans le répertoire courant. Il est possible de cumuler autant de répertoires que l'on veut en succédant plusieurs fois l'option. Les fichiers seront alors recherchés dans l'ordre des répertoires définis.

Options générales de nommage de fichier

-oa

Cette option prendra pour racine de fichier, le nom du fichier en entrée (sans extension)

-o <racine>

Choisir un nom pour tous les fichiers en sortie (sans extension)

-or <racine>

Options spécifiques de nommage de fichier

Choisir un nom pour les fichiers ROM en sortie

-ob <nom complet>

Choisir un nom pour le fichier binaire en sortie

-oc <nom complet>

Choisir un nom pour le fichier cartouche en sortie

-oi <nom complet>

Choisir un nom pour le fichier snapshot en sortie

-os <nom complet>

Choisir un nom pour le fichier des symboles en sortie

-ot <nom complet>

Choisir un nom pour le fichier K7 en sortie

-ok <nom complet>

Choisir un nom pour le fichier des points d'arrêt en sortie

-ol <nom complet>

Choisir un nom pour le fichier des labels de ROM

Option spéciale

-no

désactive toute sortie de fichier

Options de dépendance:

-depend=make

produit les dépendances du source sur une seule ligne, pour intégration dans un makefile.

-depend=list

produit les dépendances du source en tant que liste, pour être parsé ultérieurement par exemple.

Options d'export des symboles et points d'arrêt

-wu

Avertir si des symboles déclarés n'ont pas été utilisés

-s

Exporter les symboles au format RASM (label, adresse, banque)

LABEL1 #100 B0
LABEL2 #4378 B2

-sp

Exporter les symboles au format Pasmo

LABEL1 EQU 00100H
LABEL2 EQU 04378H

-sw

Exporter les symboles au format Winape

LABEL1 #100
LABEL2 #1234

-er

Exporter les labels des ROM. Quand on assigne des libellés à des ROM avec la directive NAMEBANK, ces noms peuvent être exportés dans un fichier. L'extension par défaut du fichier est ".romlabel" ajouté à la racine courante.

0: Libellé de la ROM 0
1: Libellé de la ROM 1

-eb

Exporter les points d'arrêt

-ec

Exporter les labels avec la casse originale (peut prendre quelques secondes sur d'énormes projets)

-sm

Exporter les symboles à raison d'un fichier par banque mémoire utilisée

-ss

Exporter les symboles dans les snapshots (chunk SYMB pour ACE emulator)

-sc <format>

Exporter les symboles avec un format particulier. La chaine de format ne doit posséder que deux champs. Le premier champ sera systématiquement %s et le deuxième doit être un champ numérique de type %d %x ou autre, avec un formatage possible. À utiliser avec précaution.

Note

Il est possible de définir des blocs de code pour lesquels l'exportation de symbole est désactivée.

Options de compatibilité:

-m

RASM réalisera les calculs à la manière de l'assembleur Maxam ou Dams. Les valeurs utilisées seront tronquées, non signées et 16 bits. La priorité des opérateurs ne sera pas respectée.

-dams

Utiliser la convention de nommage des labels avec le point

-amper

Convertir tous les & en # avant assemblage, surtout utile pour traiter de vieux sources DAMS

-ass

Comportement similaire à l'assembleur AS80 (premières versions)

-uz

Comportement similaire à l'assembleur UZ80 (premières versions)

-pasmo

Comportement similaire à l'assembleur Pasmo (Anciennes versions, je ne m'amuse pas à suivre chaque assembleur)

-msep <separateur>

Choisir le caractère séparateur pour les modules (par défaut, le "_" )

-utf8

L'usage de cette option permet la conversion des symboles UTF8 ¿ ¡ ù é è ç à Ñ ñ présents sur les claviers français ou espagnol dans leur équivalent du Basic Azerty ou Hispanique. La conséquence directe de la présence de cette option est qu'il n'est plus possible de mettre n'importe quoi entre quotes, il faut utiliser l'option -fq (décrite ci-dessous) pour garder une compatibilité avec RASM 1.6

à = 64 ou @
ç = 92 ou
é = 123 ou {
ù = 124 ou |
è = 125 ou }
Ñ = 161
ñ = 171
¿ = 174
¡ = 175

-fq

Ne pas sortir en erreur si un caractère UTF8 est présent dans une chaine de caractère

Options hors catégorie ^_^

-quick

Utiliser le mode rapide pour la compression ZX0

-cprquiet

Ne pas produire le listing d'information des ROM d'une cartouche

-map

Assemblage verbeux, produire le listing, les adresses et les opcodes à la volée. Les valeurs immédiates sont à zéro, à cause du comportement mono-passe de RASM.

Bnk|Real|Logic  Bytecode  [Time] Assembly
-----------------------------------------
 IX EQU 0 ; alias definition
 IY EQU 0 ; alias definition
000|0000     |                 LZ4_DECOMPRESS_RAW:
000|0000     | D5          [04]     PUSH DE   (L4:decrunch/lz4_docent.asm)
000|0001     | E5          [04]     PUSH HL   (L5:decrunch/lz4_docent.asm)
000|0002     | 09          [03]     ADD HL,BC   (L6:decrunch/lz4_docent.asm)
000|0003     | 44          [01]     LD B,H   (L7:decrunch/lz4_docent.asm)
000|0004     | 4D          [01]     LD C,L   (L8:decrunch/lz4_docent.asm)
000|0005     | E1          [03]     POP HL   (L9:decrunch/lz4_docent.asm)
000|0006     | C5          [04]     PUSH BC   (L10:decrunch/lz4_docent.asm)
000|0007     | 06 00       [02]     LD B,0   (L12:decrunch/lz4_docent.asm)
000|0009     |                 LZ4_GETTOKEN:
000|0009     | AF          [01]     XOR A   (L16:decrunch/lz4_docent.asm)
000|000A     | 7E          [02]     LD A,(HL)   (L17:decrunch/lz4_docent.asm)
000|000B     | 23          [02]     INC HL   (L18:decrunch/lz4_docent.asm)

-eo

Écraser les fichiers présents sur la disquette en modification, si ils ont le même nom que les fichiers à écrire

Options pour les snapshots

-sb

Exporter les points d'arrêt (chunks BRKS et BRKC pour Winape et ACE)

-ss

Exporter les symboles (chunk SYMB pour ACE)

-v2

Exporter un snapshot version 2 plutôt que version 3, par exemple pour la carte M4 qui ne sait pas les gérer

Options d'analyse

-me <valeur>

Définir un nombre maximum d'erreurs. Utiliser la valeur zéro signifie une désactivation de la limite.

-twe

Considérer les avertissements comme des erreurs

-xr

Affichage étendu des erreurs (ligne du source sous le message d'erreur)

-w

Désactiver les avertissements (déconseillé)

-void

Forcer l'utilisation du paramètre (void) avec les macros sans paramètre (option vivement recommandée)

-mml

Autoriser l'envoi des paramètres d'une macro sur plusieurs lignes

_COPY   Scanline_RAM_End-Scanline_RAM_Begin, 
        ROM_BonusStage, 
        ROM_BonusStageAnimFrames, 
        #E000, 
        RAM_BonusStage_ScanlineRoutines
Sauf mention contraire, le contenu de cette page est protégé par la licence Creative Commons Attribution-ShareAlike 3.0 License