Differences

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

Link to this comparison view

--- en:multiasm:papc:chapter_6_8 [2025/11/25 09:50] – [Callig Linux system functions] ktokarz
+++ en:multiasm:papc:chapter_6_8 [2025/11/25 12:46] (current) – [Calling the system functions] ktokarz
@@ Line 75: / Line 75: @@
 ===== Calling the system functions =====
-The operating systems offer a set of functions which help write an application. These functions include reading characters and text from standard input, usually the keyboard, displaying characters or text on standard output, usually the monitor, handling files, data streams and many others. In previous generations of operating systems, the software interrupt mechanism was used. In Microsoft DOS, it was **int 21h** while in 32-bit versions of Linux it was **int 80h**. Calling the system function required preparing the arguments in scratch registers and signalling the software interrupt.
+The operating systems offer a set of functions which help write an application. These functions include reading characters and text from standard input, usually the keyboard, displaying characters or text on standard output, usually the monitor, handling files, data streams and many others. In previous generations of operating systems, the software interrupt mechanism was used. In Microsoft DOS, it was **int 21h** while in 32-bit versions of Linux it was **int 80h** (or in the C-style hex notation int 0x80). Calling the system function required preparing the arguments in scratch registers and signalling the software interrupt.
 <note>
 You can still find many examples using the software interrupt system call on the Internet. In Linux, they should work properly, although they are slower than the new method. In 64-bit Windows, the **int 21** method is no longer supported.
@@ Line 85: / Line 85: @@
 Let's see the Hello World example written in the Windows API.
 <code asm>
+; include the library with system functions
+includelib kernel32.lib
+; define function names as external symbols
+EXTERN GetStdHandle: PROC
+EXTERN WriteConsoleA: PROC
+; data section with constants and variables definitions
+.DATA
+STD_OUTPUT_HANDLE = -11
+stdout_handle     dq 0
+hello_msg         db "Hello World", 0
+dummy             dq 0
+; code section
+.CODE
+MyAssemblerFunction PROC
+; the stack must be aligned to an address divisible by 16 - mod(16)
+; after the function call is aligned to mod(8)
+; the Windows requires the shadow space on the stack
+    push  rbp        ; push rpb to the stack
+    mov   rbp, rsp   ; store rsp to rbp
+    sub   rsp, 48    ; shadow space (32 bytes) and stack alignment (additional 8 bytes)
+; we need the handle of the console window
+    mov   rcx, STD_OUTPUT_HANDLE
+    call  GetStdHandle
+    mov   stdout_handle, rax
+; display the text in the console window
+    mov   rcx, stdout_handle
+    mov   rdx, offset hello_msg
+    mov   r8,  sizeof hello_msg
+    mov   r9,  dummy
+    call  WriteConsoleA
+; restore the stack pointer and rbp
+    mov   rsp, rbp
+    pop   rbp
+; return from the function
+    ret
+MyAssemblerFunction ENDP
+END
 </code>
 ===== Callig Linux system functions =====
-The Linux operating system still supports the traditional calling of system functions using software interrupts. It is based on the **int 80h** interrupt, which recognises the number of the function in the EAX register and up to six arguments in EBX, ECX, EDX, ESI, EDI, and EBP.
+The Linux operating system still supports the traditional calling of system functions using software interrupts. It is based on the **int 0x80** interrupt, which recognises the number of the function in the EAX register and up to six arguments in EBX, ECX, EDX, ESI, EDI, and EBP.
 The example of the Hello World program in Linux interrupt-based system call is shown in the following code.
 <code asm>
+section   .text
+global    _start
+_start:
+; write function
+     mov   ebx, 1    ; first argument - stdio
+     mov   ecx, msg  ; second argument - text buffer
+     mov   edx, len  ; third argument - text length
+     mov   eax, 4    ; function number - write
+     int   0x80
+; exit from program
+     mov   eax, 1    ; function number - exit
+     int   0x80
+section    .data
+msg  db    "Hello World!", 10
+len  equ   $ - msg
 </code>
@@ Line 98: / Line 160: @@
 <code asm>
+global	_start
+section	 .text
+_start:
+; write function
+     mov   rdi, 1    ; first argument of the function - stdout
+     mov   rsi, msg  ; second argument - text buffer
+     mov   rdx, len  ; third argument - number of characters
+     mov   rax, 1    ; write function
+     syscall
+; exit from program
+     mov   rdi, 0    ; result code of the program
+     mov   rax, 60   ; exit function
+     syscall
+msg: db    "Hello World!", 10
+len  equ   $ - msg
 </code>

en/multiasm/papc/chapter_6_8.1764064236.txt.gz · Last modified: 2025/11/25 09:50 by ktokarz