1ASM<DIALECT>
2------------
3
4.. include:: ENV_VAR.txt
5
6Preferred executable for compiling a specific dialect of assembly language
7files. ``ASM<DIALECT>`` can be ``ASM``, ``ASM_NASM`` (Netwide Assembler),
8``ASM_MASM`` (Microsoft Assembler) or ``ASM-ATT`` (Assembler AT&T).
9Will only be used by CMake on the first configuration to determine
10``ASM<DIALECT>`` compiler, after which the value for ``ASM<DIALECT>`` is stored
11in the cache as
12:variable:`CMAKE_ASM<DIALECT>_COMPILER <CMAKE_<LANG>_COMPILER>`. For subsequent
13configuration runs, the environment variable will be ignored in favor of
14:variable:`CMAKE_ASM<DIALECT>_COMPILER <CMAKE_<LANG>_COMPILER>`.
15
16.. note::
17  Options that are required to make the compiler work correctly can be included;
18  they can not be changed.
19
20.. code-block:: console
21
22  $ export ASM="custom-compiler --arg1 --arg2"
23