Differences

This shows you the differences between two versions of the page.

--- spo600:assembler_basics [2025/01/08 21:50] – [6502 Assembly Language in the Emulator] chris
+++ spo600:assembler_basics [2025/02/11 11:58] (current) – chris
@@ Line 5: / Line 5: @@
 =====  Format of an Assembly Language program  =====
-The traditional extension for assembly-language source files that will be used as input to an assembler is ''.s'' or ".asm", or ''.S'' for files that need to go through the C preprocessor (''cpp'') and compiler (''cc'').
+The traditional extension for assembly-language source files that will be used as input to an assembler is ''.s'' (or __.asm__ on some platforms), or ''.S'' for files that need to go through the C preprocessor (''cpp'') and possibly the compiler (''cc'').
 An assembly-language program consists of:
@@ Line 82: / Line 82: @@
 On a Linux system, you will need to meet three requirements to get your assembly language program to work:
-  -  Code must be placed in the ''.text'' section of the ELF file.
+  -  Code must be placed in the ''.text'' section of the ELF file. (Think of this as the //program text// rather than //string text//).
   -  Data must be placed in either the ''.rodata'' (read-only data) or ''.data'' (read/write data) sections of the ELF file.
   -  There must be a globally-defined symbol which the linker (''ld'') will use to find the entry point to your program. If the code is being directly compiled by the assembler, this symbol must be ''_start'' -- but if the code is being compiled by gcc, this symbol must be called ''main'' (a preamble will be located at ''_start'' which will then transfer control to ''main'').
@@ Line 93: / Line 93: @@
   -  Run the linker: ''ld //test//.o -o //test//''
-Note that the ''-g'' option assembles the program with symbolic debugging information included.
+Note that the ''-g'' option assembles the program with symbolic debugging information included (just as it does in most C compilers).
 ====  Compiling an Assembly Language Program using the NASM Assembler  ====
@@ Line 101: / Line 101: @@
 Notes:
-  -  NASM only works with x86 code.
+  *  NASM only works with x86 code.
-  -  The source file must be written using NASM syntax (which is substantially different from the GNU assembler syntax).
+  *  The source file must be written using NASM syntax (which is substantially different from the GNU assembler syntax).
-  -  The ''-f elf64'' option instructs NASM to assemble the code for a 64-bit target (x86_64).
+  *  The ''-f elf64'' option instructs NASM to assemble the code for a 64-bit target (x86_64).
-  -  The ''-g'' option assembles the program with symbolic debugging information included.
+  *  The ''-g'' option assembles the program with symbolic debugging information included.
 ====  Compiling an Assembly Language program using GCC  ====