XeLabs/asm_book
2
0
Fork 0
mirror of https://github.com/pkivolowitz/asm_book.git synced 2026-06-21 02:26:59 +08:00
Code Issues Projects Releases Packages Wiki Activity

updated talk of MacOS

Browse source
This commit is contained in:
Perry Kivolowitz 2023-09-08 07:41:32 -05:00
parent d62f2e5de3
commit 5a015d438a
2 changed files with 14 additions and 33 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

47
README.md
View file

@ -45,44 +45,25 @@ an outsized role in determining how assembly language programs are
constructed. A "calling convention" refers to how functions are called constructed. A "calling convention" refers to how functions are called
and how parameters are passed. and how parameters are passed.
In this book we will use the ARM LINUX conventions. This means: Originally, this book taught only the ARM LINUX conventions. However,
over time, we developed a suite of macros that make it much easier to
write code once and use it on MacOS or on LINUX.
* You *may* need to run a ARM Linux VM on the Macintosh - even on The macros are a work in progress. [This link](./macros/) will lead to a
ARM-based Macs. Why? Apple uses a different calling convention. Keep current copy of them as well as documentation. Macros that make
reading before you get upset. programming a bit easier are also included.
The convention used in this book should work on all ARM Linux [This chapter](./more/apple_silicon/) provides some additional
machines while the Apple calling convention is specific to Apple information about Apple Silicon assembly language programming.
Silicon-based machines.
This necessity for a VM even when running on an Apple Silicon machine
did not sit well with some, who made this criticism known. We assessed
this to be a valid and constructive criticism and have responded.
We now have a chapter devoted to bringing Linux and Apple code
together to the degree possible.
* The macros are a work in progress. [This link](./macros/) will lead
to a current copy of them as well as documentation. Macros that make
programming a bit easier are also included.
* [This chapter](./more/apple_silicon/) provides some additional
information about Apple Silicon assembly language programming.
* You will need to run WSL (Windows Subsystem for Linux) on ARM-based
Windows machines. These do exist!
* You will need to run an ARM Linux VM on x86-based Windows machines.
This is true even if you are on an ARM-based Windows machine as there
are so many differences between a Unix-like environment and Windows.
You'll notice that we make use of the C-runtime directly rather than You'll notice that we make use of the C-runtime directly rather than
make OS system calls. So, for instance, if we want to call `write()`, make OS system calls. So, for instance, if we want to call `write()`,
we call `write` from the assembly language. This version of the system we call `write` from the assembly language.
call `write` is a wrapper function built into the C-runtime (CRT) which
handles the lower level details of performing a system call. See the This version of the system call `write` is a wrapper function built into
[here](./more/system_calls/README.md) on what actually happens inside the C-runtime (CRT) which handles the lower level details of performing
these wrapper functions. a system call. See the [here](./more/system_calls/README.md) on what
actually happens inside these wrapper functions.
The benefit of using the CRT wrappers is that there are details, The benefit of using the CRT wrappers is that there are details,
explained in the chapter, that differ from system to system and explained in the chapter, that differ from system to system and

BIN
README.pdf
View file

Binary file not shown.