Dela via

Kommandoradsreferens för ARM Assembler

Microsoft ARM-assemblers, armasm och armasm64, stöder flera kommandoradsalternativ. Som standard monterar armasm ARMv7 Thumb-sammansättningsspråket i Microsoft-implementeringen av COFF (Common Object File Format). armasm64 assembler skapar COFF-objektkod för ARM64- och ARM64EC-mål. Länkaren kan länka COFF-kodobjekt som skapats av både ARM-monteringsverktyget och C/C++-kompilatorn. Den kan länka ihop med objektbibliotek som skapats av bibliotekarien.

Syntax

armasm [alternativ] source_fileobject_file
armasm [alternativ] source_file

armasm64 [alternativ] source_fileobject_file
armasm64 [alternativ] source_file

Parametrar

alternativ
En kombination av noll eller flera av följande alternativ:

  • -16
    Endast tillgängligt i armasm. Montera källan som 16-bitars tuminstruktioner. Det här alternativet är standardinställningen.

  • -32
    Endast tillgängligt i armasm. Montera källan som 32-bitars ARM-instruktioner.

  • -coff_thumb2_only
    Endast tillgängligt i armasm. Tillåt endast Tum-2-kod.

  • -errorReport: alternativ
    Det här alternativet är inaktuellt. I Windows Vista och senare styrs felrapportering av WINDOWS-felrapportering (WER) inställningar.

  • -errors filnamn
    -e filnamn
    Omdirigeringsfel och varningsmeddelanden till filnamn. Som standard skickas dessa meddelanden till stdout.

  • -funcOverride: function_name
    Endast tillgängligt i armasm64. Generera funktionsöversidosätt stöd för function_name.

  • -g
    Generera felsökningsinformation.

  • -gh:SHA1
    Använd sha-1 kryptografisk hash-algoritm för att generera en kontrollsumma för varje källfil i felsökningsinformationen. Åsidosätter -gh:SHA256.

  • -gh:SHA256
    Använd sha-256 kryptografisk hash-algoritm för att generera en kontrollsumma för varje källfil i felsökningsinformationen. Det här alternativet är aktiverat som standard i Visual Studio 2022 version 17.0 och senare.

  • -guard:ehcont[-]
    Generera en sorterad lista över de relativa virtuella adresserna (RVA) för alla giltiga undantagshanteringsmål för en binär fil. Den används vid körning för validering av NtContinue och SetThreadContext instruktionspekare. Som standard är -guard:ehcont inaktiverad och måste vara explicit aktiverad. Om du uttryckligen vill inaktivera det här alternativet använder du -guard:ehcont-. Det här alternativet är tillgängligt i Visual Studio 2019 version 16.7 och senare. Funktionen stöds för 64-bitarsprocesser i ett 64-bitars operativsystem.

  • -help
    -h
    Skriv ut kommandoradshjälpmeddelandet.

  • -i dir[;dir]
    Lägg till en eller flera angivna kataloger i sökvägen include. Avgränsa kataloger med hjälp av ett semikolon (;).

  • -ignore warning_number
    Inaktivera det angivna varningsnumret. Möjliga värden finns i diagnostikmeddelanden för ARM Assembler.

  • -list list_file
    Skapa en detaljerad lista över det genererade sammansättningsspråket för att list_file. Parametern list_file är valfri. Om det utelämnas lägger assemblern till .lst till basnamnet för source_file för att skapa listfilen.

  • -machine dator
    Ange den datortyp som ska anges i PE-huvudet. I armasmär möjliga värden för dator:

    • ARM– Anger datortypen till IMAGE_FILE_MACHINE_ARMNT. Det här alternativet är standardinställningen.
    • TUMME-– Anger datortypen till IMAGE_FILE_MACHINE_THUMB.

    I armasm64är möjliga värden:

    • ARM64– Anger datortypen till IMAGE_FILE_MACHINE_ARM64. Det här alternativet är standardinställningen.
    • ARM64EC– Anger datortypen till IMAGE_FILE_MACHINE_ARM64EC.

  • -noesc
    -noe
    Ignorera undantagna specialtecken i C-stil, till exempel \n eller \t.

  • -nologo
    Undertryck upphovsrättsbanderollen.

  • -nowarn
    -now
    Inaktivera alla varningsmeddelanden.

  • -o object_file
    Ange namnet på objektfilen (utdata). Alternativet -o är valfritt. Du kan i stället ange ett objektfilnamn som det sista elementet på kommandoraden.

  • -oldit
    Endast tillgängligt i armasm. Generera IT-block i ARMv7-format. Som standard genereras ARMv8-kompatibla IT-block.

  • -predefine direktiv
    -pd direktiv
    Ange ett SETA-, SETL- eller SETS-direktiv för att fördefinierade en symbol.
    Exempel: armasm.exe -predefine "COUNT SETA 150" source.asm
    Mer information finns i armasm-referensguiden ARM Compiler.

  • -sourcelink: sourcelink_filename
    sourcelink_filename anger en JSON-formaterad konfigurationsfil som innehåller en enkel mappning av lokala filsökvägar till URL:er för källfiler som ska visas i felsökningsprogrammet. Mer information om filens format finns i Source Link JSON Schema. Source Link är ett språk- och källkontrollsystem för att tillhandahålla källfelsökning för binärfiler. Source Link stöds för interna binärfiler som börjar i Visual Studio 2017 version 15.8. En översikt över Källlänk finns i Source Link. Information om hur du använder Källlänk i dina projekt och hur du genererar SourceLink-filen som en del av projektet finns i Using Source Link.

  • -via filnamn
    Läs extra kommandoradsargument från filnamn.

source_file
Namnet på källfilen.

object_file
Det sista elementet på kommandoraden kan ange namnet på objektfilen (utdata). Om det utelämnas och inget -o alternativ anges lägger assemblern till .obj till basnamnet för source_file för att skapa objektfilen.

Anmärkningar

I följande exempel visas hur du använder armasm i ett typiskt scenario. Använd först armasm för att skapa en fil för sammansättningsspråkkälla (.asm) till en objektfil (.obj). Använd sedan C-kompilatorn för CL-kommandoraden för att kompilera en källfil (.c) och ange även länkalternativet för att länka ARM-objektfilen.

armasm -o myasmcode.obj myasmcode.asm 
cl myccode.c /link myasmcode.obj

Se även

ARM Assembler-diagnostikmeddelanden
ARM Assembler-direktiv