Share via

Referensi baris perintah Perakitan ARM

  • Artikel

Perakitan Microsoft ARM, armasm, dan armasm64, mendukung beberapa opsi baris perintah. Secara default, armasm merakit bahasa rakitan ARMv7 Thumb ke dalam implementasi Microsoft dari Format File Objek Umum (COFF). Perakitan armasm64 membuat kode objek COFF untuk target ARM64 dan ARM64EC. Linker dapat menautkan objek kode COFF yang dihasilkan oleh perakit ARM dan pengkompilasi C/C++. Ini dapat ditautkan bersama dengan pustaka objek yang dibuat oleh pustakawan.

Sintaks

armasm[opsi] object_file source_file
armasm [opsi] source_file

armasm64[opsi] object_file source_file
armasm64 [opsi] source_file

Parameter

opsi
Kombinasi nol atau lebih dari opsi berikut:

  • -16
    Hanya tersedia di armasm. Kumpulkan sumber sebagai instruksi Thumb 16-bit. Ini adalah opsi default.

  • -32
    Hanya tersedia di armasm. Kumpulkan sumber sebagai instruksi ARM 32-bit.

  • -coff_thumb2_only
    Hanya tersedia di armasm. Izinkan hanya kode Thumb-2.

  • -errorReport:Pilihan
    Opsi ini tidak digunakan lagi. Di Windows Vista dan yang lebih baru, pelaporan kesalahan dikontrol oleh pengaturan Pelaporan Galat Windows (WER).

  • -errorsfilename
    -efilename
    Alihkan kesalahan dan pesan peringatan ke nama file. Secara default, pesan ini dikirim ke stdout.

  • -funcOverride:function_name
    Hanya tersedia di armasm64. Memancarkan dukungan penggantian fungsi untuk function_name.

  • -g
    Hasilkan informasi penelusuran kesalahan.

  • -gh:SHA1
    Gunakan algoritma hash kriptografi SHA-1 untuk menghasilkan checksum dari setiap file sumber dalam info debug. Mengambil alih -gh:SHA256.

  • -gh:SHA256
    Gunakan algoritma hash kriptografi SHA-256 untuk menghasilkan checksum dari setiap file sumber dalam info debug. Opsi ini aktif secara default di Visual Studio 2022 versi 17.0 dan yang lebih baru.

  • -guard:ehcont[-]
    Buat daftar yang diurutkan dari alamat virtual relatif (RVA) dari semua target kelanjutan penanganan pengecualian yang valid untuk biner. Ini digunakan pada runtime untuk NtContinue dan SetThreadContext validasi pointer instruksi. Secara default, -guard:ehcont nonaktif dan harus diaktifkan secara eksplisit. Untuk menonaktifkan opsi ini secara eksplisit, gunakan -guard:ehcont-. Opsi ini tersedia di Visual Studio 2019 versi 16.7 dan yang lebih baru. Fitur ini didukung untuk proses 64-bit pada OS 64-bit.

  • -help
    -h
    Cetak pesan bantuan baris perintah.

  • -idir[;dir]
    Tambahkan satu atau beberapa direktori yang ditentukan ke jalur pencarian sertakan. Pisahkan direktori dengan menggunakan titik koma (;).

  • -ignorewarning_number
    Nonaktifkan nomor peringatan yang ditentukan. Untuk nilai yang mungkin, lihat pesan diagnostik Arm Assembler.

  • -listlist_file
    Buat daftar terperinci bahasa rakitan yang dihasilkan untuk list_file. Parameter list_file bersifat opsional. Jika dihilangkan, perakit menambahkan .lst ke nama dasar source_file untuk membuat file daftar.

  • -machineMesin
    Tentukan jenis komputer yang akan diatur di header PE. Dalam armasm, nilai yang mungkin untuk mesin adalah:

    • ARM—Mengatur jenis komputer ke IMAGE_FILE_MACHINE_ARMNT. Ini adalah opsi default.
    • THUMB—Mengatur jenis komputer ke IMAGE_FILE_MACHINE_THUMB.

    Dalam armasm64, nilai yang mungkin adalah:

    • ARM64—Mengatur jenis komputer ke IMAGE_FILE_MACHINE_ARM64. Ini adalah opsi default.
    • ARM64EC—Mengatur jenis komputer ke IMAGE_FILE_MACHINE_ARM64EC.

  • -noesc
    -noe
    Abaikan karakter khusus yang lolos gaya C, seperti \n atau \t.

  • -nologo
    Tekan banner hak cipta.

  • -nowarn
    -now
    Nonaktifkan semua pesan peringatan.

  • -oobject_file
    Tentukan nama file objek (output). Opsi -o bersifat opsional; Anda dapat menentukan nama file objek sebagai elemen terakhir dari baris perintah.

  • -oldit
    Hanya tersedia di armasm. Hasilkan blok TI bergaya ARMv7. Secara default, blok TI yang kompatibel dengan ARMv8 dihasilkan.

  • -predefineDirektif
    -pdDirektif
    Tentukan direktif SETA, SETL, atau SETS untuk menentukan simbol sebelumnya.
    Contoh: armasm.exe -predefine "COUNT SETA 150" source.asm
    Untuk informasi selengkapnya, lihat Panduan Referensi ARM Compiler armasm.

  • -sourcelink:sourcelink_filename
    sourcelink_filename menentukan file konfigurasi berformat JSON yang berisi pemetaan sederhana jalur file lokal ke URL agar file sumber ditampilkan di debugger. Untuk informasi selengkapnya tentang format file ini, lihat Skema JSON Tautan Sumber. Tautan Sumber adalah sistem agnostik kontrol bahasa dan sumber untuk menyediakan penelusuran kesalahan sumber untuk biner. Source Link didukung untuk biner asli yang dimulai di Visual Studio 2017 versi 15.8. Untuk gambaran umum Tautan Sumber, lihat Tautan Sumber. Untuk informasi tentang cara menggunakan Tautan Sumber di proyek Anda, dan cara membuat file SourceLink sebagai bagian dari proyek Anda, lihat Menggunakan Tautan Sumber.

  • -viafilename
    Baca argumen baris perintah tambahan dari nama file.

source_file
Nama file sumber.

object_file
Elemen terakhir dari baris perintah dapat menentukan nama file objek (output). Jika dihilangkan, dan tidak ada -o opsi yang ditentukan, perakit menambahkan .obj ke nama dasar source_file untuk membuat file objek.

Keterangan

Contoh berikut menunjukkan cara menggunakan armasm dalam skenario umum. Pertama, gunakan armasm untuk membangun file assembly language source (.asm) ke file objek (.obj). Kemudian, gunakan compiler C baris perintah CL untuk mengkompilasi file sumber (.c), dan juga menentukan opsi linker untuk menautkan file objek ARM.

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

Baca juga

Pesan diagnostik Perakitan ARM
Arahan Arm Assembler