ARM Assembler komut satırı başvurusu
Microsoft ARM derleyicileri, armasm ve armasm64, çeşitli komut satırı seçeneklerini destekler. Varsayılan olarak, armasm ARMv7 Thumb derleme dilini Ortak Nesne Dosya Biçimi'nin (COFF) Microsoft uygulamasına derler. armasm64 assembler, ARM64 ve ARM64EC hedefleri için COFF nesne kodu oluşturur. Bağlayıcı hem ARM derleyicisi hem de C/C++ derleyicisi tarafından üretilen COFF kod nesnelerini bağlayabilir. Kitaplık oluşturucu tarafından oluşturulan nesne kitaplıklarıyla birlikte bağlanabilir.
Sözdizimi
armasm[options] source_file object_file
armasm[seçenekler] source_file
armasm64[options] source_file object_file
armasm64[seçenekler] source_file
Parametreler
Seçenekler
Aşağıdaki seçeneklerden sıfır veya daha fazlasının birleşimi:
-16
Yalnızca armasm'de kullanılabilir. Kaynağı 16 bit Başparmak yönergeleri olarak bir araya getirme. Bu seçenek varsayılandır.-32
Yalnızca armasm'de kullanılabilir. Kaynağı 32 bit ARM yönergeleri olarak bir araya getirme.-coff_thumb2_only
Yalnızca armasm'de kullanılabilir. Yalnızca Thumb-2 koduna izin ver.-errorReport:seçenek
Bu seçenek kullanım dışıdır. Windows Vista ve sonraki sürümlerde hata raporlama, Windows Hata Bildirimi (WER) ayarları tarafından denetlenilir.-errorsDosyaadı
-eDosyaadı
Hata ve uyarı iletilerini dosya adına yeniden yönlendirin. Varsayılan olarak, bu iletiler adresinestdoutgönderilir.-funcOverride:function_name
Yalnızca armasm64'te kullanılabilir. function_name desteğini geçersiz kılma işlevi.-g
Hata ayıklama bilgileri oluşturun.-gh:SHA1
Hata ayıklama bilgilerinde her kaynak dosyanın sağlama toplamını oluşturmak için SHA-1 şifreleme karma algoritmasını kullanın. geçersiz kılar-gh:SHA256.-gh:SHA256
Hata ayıklama bilgilerinde her kaynak dosyanın sağlama toplamını oluşturmak için SHA-256 şifreleme karma algoritmasını kullanın. Visual Studio 2022 sürüm 17.0 ve sonraki sürümlerde bu seçenek varsayılan olarak açıktır.-guard:ehcont[-]
bir ikili dosya için tüm geçerli özel durum işleme devamlılık hedeflerinin göreli sanal adreslerinin (RVA) sıralanmış bir listesini oluşturun. ve yönerge işaretçisi doğrulaması içinNtContinueSetThreadContextçalışma zamanında kullanılır. Varsayılan olarak kapalıdır-guard:ehcontve açıkça etkinleştirilmesi gerekir. Bu seçeneği açıkça devre dışı bırakmak için kullanın-guard:ehcont-. Bu seçenek Visual Studio 2019 sürüm 16.7 ve sonraki sürümlerde kullanılabilir. Bu özellik, 64 bit işletim sistemindeki 64 bit işlemler için desteklenir.-help
-h
Komut satırı yardım iletisini yazdırın.-idir[;dir]
Ekleme arama yoluna belirtilen bir veya daha fazla dizin ekleyin. Dizinleri noktalı virgül (;kullanarak) ayırın.-ignorewarning_number
Belirtilen uyarı numarasını devre dışı bırakın. Olası değerler için bkz . ARM Assembler tanılama iletileri.-listlist_file
list_file için oluşturulan derleme dilinin ayrıntılı bir listesini oluşturun. list_file parametresi isteğe bağlıdır. Atlanırsa, derleyici listeleme dosyasını oluşturmak için source_file temel adına ekler.lst.-machinemakine
PE üst bilgisinde ayarlanacağı makine türünü belirtin. Armasm'de makine için olası değerler şunlardır:- ARM—Makine türünü olarak
IMAGE_FILE_MACHINE_ARMNTayarlar. Bu seçenek varsayılandır. - BAŞPARMAK—Makine türünü olarak
IMAGE_FILE_MACHINE_THUMBayarlar.
armasm64'te olası değerler şunlardır:
- ARM64—Makine türünü olarak
IMAGE_FILE_MACHINE_ARM64ayarlar. Bu seçenek varsayılandır. - ARM64EC—Makine türünü olarak
IMAGE_FILE_MACHINE_ARM64ECayarlar.
- ARM—Makine türünü olarak
-noesc
-noe
veya\tgibi\nC stili kaçış özel karakterlerini yoksayma.-nologo
Telif hakkı başlığını gizleme.-nowarn
-now
Tüm uyarı iletilerini devre dışı bırakın.-oobject_file
Nesne (çıkış) dosyasının adını belirtin. seçenek-oisteğe bağlıdır; bunun yerine komut satırının son öğesi olarak bir nesne dosyası adı belirtebilirsiniz.-oldit
Yalnızca armasm'de kullanılabilir. ARMv7 stili BT blokları oluşturun. Varsayılan olarak, ARMv8 uyumlu BT blokları oluşturulur.-predefineYönergesi
-pdYönergesi
Simgeyi önceden belirtmek için BIR SETA, SETL veya SETS yönergesi belirtin.
Örnek:armasm.exe -predefine "COUNT SETA 150" source.asm
Daha fazla bilgi için bkz . ARM Derleyicisi armasm Başvuru Kılavuzu.-sourcelink:sourcelink_filename
sourcelink_filename, hata ayıklayıcıda görüntülenecek kaynak dosyaların URL'lerine yerel dosya yollarının basit bir eşlemesini içeren JSON biçimli bir yapılandırma dosyası belirtir. Bu dosyanın biçimi hakkında daha fazla bilgi için bkz . Kaynak Bağlantısı JSON Şeması. Kaynak Bağlantı, ikili dosyalar için kaynak hata ayıklama sağlamaya yönelik dil ve kaynak denetimi belirsiz bir sistemdir. Kaynak Bağlantısı, Visual Studio 2017 sürüm 15.8'den başlayarak yerel ikili dosyalar için desteklenir. Kaynak Bağlantısına genel bakış için bkz . Kaynak Bağlantısı. Projelerinizde Kaynak Bağlantı'nın nasıl kullanılacağı ve projenizin bir parçası olarak SourceLink dosyasının nasıl oluşturulacağı hakkında bilgi için bkz . Kaynak Bağlantısını Kullanma.-viaDosyaadı
Dosya adından ek komut satırı bağımsız değişkenlerini okuyun.
source_file
Kaynak dosyanın adı.
object_file
Komut satırının son öğesi nesne (çıkış) dosyasının adını belirtebilir. Atlanırsa ve seçenek belirtilmezse-o, derleyici nesne dosyasını oluşturmak için source_file temel adına ekler.obj.
Açıklamalar
Aşağıdaki örnekte tipik bir senaryoda armasm'nin nasıl kullanılacağı gösterilmektedir. İlk olarak, bir nesne (.obj) dosyasına derleme dili kaynak (.asm) dosyası oluşturmak için armasm kullanın. Ardından, kaynak (.c) dosyasını derlemek için CL komut satırı C derleyicisini kullanın ve ARM nesne dosyasını bağlamak için bağlayıcı seçeneğini belirtin.
armasm -o myasmcode.obj myasmcode.asm
cl myccode.c /link myasmcode.obj