GNU Info

(nasm.info)Section 2.1.3

---

Next: Section 2.1.4 Prev: Section 2.1.2 Up: Section 2.1

---

Enter node , (file) or (file)node

2.1.3. The `-l' Option: Generating a Listing File
-------------------------------------------------

   If you supply the `-l' option to NASM, followed (with the usual
optional space) by a file name, NASM will generate a source-listing file
for you, in which addresses and generated code are listed on the left,
and the actual source code, with expansions of multi-line macros
(except those which specifically request no expansion in source
listings: see *Note Section 4.3.9::) on the right. For example:

     nasm -f elf myfile.asm -l myfile.lst

   If a list file is selected, you may turn off listing for a section
of your source with `[list -]', and turn it back on with `[list +]',
(the default, obviously). There is no "user form" (without the
brackets). This can be used to list only sections of interest, avoiding
excessively long listings.