Sdílet prostřednictvím

Referenční dokumentace pro použití nástroje assembleru ARM na příkazovém řádku

  • Článek

Assemblery Microsoft ARM, armasm a armasm64 podporují několik možností příkazového řádku. Ve výchozím nastavení armasm sestaví jazyk sestavení ARMv7 Thumb do implementace Common Object File Format (COFF). Assembler armasm64 vytvoří kód objektu COFF pro ARM64 a ARM64EC cíle. Linker může propojit objekty kódu COFF vytvořené assemblerem ARM i kompilátorem C/C++. Může propojit knihovny objektů vytvořené knihovnou knihovny.

Syntaxe

armasm[možnosti] source_file object_file
armasm [možnosti] source_file

armasm64[možnosti] source_file object_file
armasm64 [možnosti] source_file

Parametry

volby
Kombinace nuly nebo více následujících možností:

  • -16
    K dispozici pouze v armasmu. Sestavte zdroj jako 16bitové instrukce thumb. Tato možnost je výchozí.

  • -32
    K dispozici pouze v armasmu. Sestavte zdroj jako 32bitové instrukce ARM.

  • -coff_thumb2_only
    K dispozici pouze v armasmu. Povolit pouze kód Thumb-2.

  • -errorReport: možnost
    Tato možnost je zastaralá. Ve Windows Vista a novějších verzích se zasílání zpráv o chybách řídí nastavením Zasílání zpráv o chybách systému Windows (WER).

  • -errors jméno souboru
    -e jméno souboru
    Přesměrujte chybové a upozorňující zprávy na název souboru. Ve výchozím nastavení se tyto zprávy odesílají do stdout.

  • -funcOverride: function_name
    K dispozici pouze v armasm64. Generování podpory přepsání funkce pro function_name

  • -g
    Generování informací o ladění

  • -gh:SHA1
    Pomocí kryptografického algoritmu hash SHA-1 vygenerujte kontrolní součet každého zdrojového souboru v informacích o ladění. Přepisy -gh:SHA256.

  • -gh:SHA256
    Pomocí kryptografického algoritmu hash SHA-256 vygenerujte kontrolní součet každého zdrojového souboru v informacích o ladění. Tato možnost je ve výchozím nastavení zapnutá v sadě Visual Studio 2022 verze 17.0 a novější.

  • -guard:ehcont[-]
    Vygenerujte seřazený seznam relativních virtuálních adres (RVA) všech platných cílů pokračování zpracování výjimek pro binární soubor. Používá se za běhu pro NtContinueSetThreadContext ověření ukazatele instrukce. Ve výchozím nastavení -guard:ehcont je vypnutá a musí být explicitně povolená. Pokud chcete tuto možnost explicitně zakázat, použijte -guard:ehcont-. Tato možnost je dostupná v sadě Visual Studio 2019 verze 16.7 a novější. Tato funkce je podporována pro 64bitové procesy v 64bitovém operačním systému.

  • -help
    -h
    Vytiskněte zprávu nápovědy příkazového řádku.

  • -i dir[;dir]
    Přidejte do cesty hledání zahrnutí jeden nebo více zadaných adresářů. Oddělte adresáře středníkem (;).

  • -ignore warning_number
    Zakažte zadané číslo upozornění. Možné hodnoty najdete v diagnostických zprávách assembleru ARM.

  • -list list_file
    Vytvořte podrobný seznam vygenerovaného jazyka sestavení pro list_file. Parametr list_file je volitelný. Pokud je vynechán, assembler připojí .lst k základnímu názvu source_file vytvořit soubor výpisu.

  • -machine stroj
    Zadejte typ počítače, který se má nastavit v hlavičce PE. V armasmu jsou možné hodnoty pro stroj :

    • ARM – Nastaví typ počítače na IMAGE_FILE_MACHINE_ARMNT. Tato možnost je výchozí.
    • THUMB – Nastaví typ stroje na IMAGE_FILE_MACHINE_THUMB.

    V armasm64 jsou možné hodnoty:

    • ARM64 – Nastaví typ počítače na IMAGE_FILE_MACHINE_ARM64. Tato možnost je výchozí.
    • ARM64EC – nastaví typ počítače na IMAGE_FILE_MACHINE_ARM64EC.

  • -noesc
    -noe
    Ignorovat řídicí znaky ve stylu C, například \n nebo \t.

  • -nologo
    Potlačit banner s autorskými právy

  • -nowarn
    -now
    Zakažte všechny zprávy upozornění.

  • -o object_file
    Zadejte název souboru objektu (výstupu). Možnost -o je volitelná. Místo toho můžete jako poslední prvek příkazového řádku zadat název souboru objektu.

  • -oldit
    K dispozici pouze v armasmu. Generování bloků IT ve stylu ARMv7 Ve výchozím nastavení se generují bloky IT kompatibilní s ARMv8.

  • -predefine směrnice
    -pd směrnice
    Zadejte direktivu SETA, SETL nebo SETS pro předdefinovaný symbol.
    Příklad: armasm.exe -predefine "COUNT SETA 150" source.asm
    Další informace najdete v referenční příručce kompilátoru ARM armasm.

  • -sourcelink: sourcelink_filename
    sourcelink_filename určuje konfigurační soubor ve formátu JSON, který obsahuje jednoduché mapování místních cest k souborům na adresy URL pro zdrojové soubory, které se mají zobrazit v ladicím programu. Další informace o formátu tohoto souboru najdete v tématu Schéma JSON odkazu na zdroj. Source Link je systém nezávislý na jazyku a správě zdrojového kódu pro poskytování ladění zdrojového kódu pro binární soubory. Zdrojový odkaz je podporovaný pro nativní binární soubory počínaje sadou Visual Studio 2017 verze 15.8. Přehled odkazu na zdroj najdete v tématu Odkaz na zdroj. Informace o tom, jak v projektech používat odkaz na zdroj a jak vygenerovat soubor SourceLink jako součást projektu, najdete v tématu Použití odkazu ke zdroji.

  • -via jméno souboru
    Přečtěte si další argumenty příkazového řádku z názvu souboru.

source_file
Název zdrojového souboru.

object_file
Poslední prvek příkazového řádku může zadat název objektu (výstupního) souboru. Pokud je vynechán a není zadána žádná -o možnost, assembler připojí .obj k základnímu názvu source_file k vytvoření souboru objektu.

Poznámky

Následující příklad ukazuje, jak používat armasm v typickém scénáři. Nejprve pomocí armasmu sestavte soubor zdroje jazyka sestavení (.asm) do objektu (.obj). Potom pomocí kompilátoru jazyka C příkazového řádku CL zkompilujte zdrojový soubor (.c) a také určete možnost linkeru pro propojení souboru objektu ARM.

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

Viz také

Diagnostické zprávy assembleru ARM
Direktivy assembleru ARM