XeLabs/asm_book
2
0
Fork 0
mirror of https://github.com/pkivolowitz/asm_book.git synced 2026-06-21 04:16:50 +08:00
Code Issues Projects Releases Packages Wiki Activity
329 commits 3 branches 0 tags 53 MiB
Commit graph

144 commits

Author SHA1 Message Date
Perry Kivolowitz
88c8f496c4 Document hex dump display convention in alignment chapter 
Closes #22.

The alignment chapter's hex dump examples (e.g. "0011 eeff ccdd aabb"
for a little-endian long initialized to 0xaabbccddeeff0011) are correct
under the default hexdump(1) output convention: bytes grouped into
16-bit little-endian words, each word printed most-significant byte
first. But the chapter never told the reader which convention was in
use, so a reader reproducing the example with xxd or hexdump -C (both
byte-oriented, showing raw memory order) would get a different-looking
result and conclude the book had an endianness bug. That is exactly
what issue #22 reported, and it is also part of what the #33 filer
flagged as "there are no instructions about how to do such a thing"
for hex dumps in this chapter.

Fix: one new subsection "A Note on Hex Dumps" placed before Example 1,
stating the convention explicitly and warning xxd / hexdump -C users
that the bytes within each pair will appear swapped relative to the
examples. The examples themselves are unchanged; they were already
self-consistent under the word-oriented convention.

Rejected alternative: rewriting all the examples in byte-oriented
(xxd) form. That would have matched what most modern readers reach
for, but would also have required regenerating every hex dump in the
chapter and losing continuity with any reader who already absorbed
the current notation. A single explanatory paragraph is less invasive
and teaches the distinction, which is useful in its own right.

No test coverage applies; this is prose.
 2026-04-19 02:20:10 -05:00
Perry Kivolowitz
43c188951c corrected sense of compare for error filed almost one year ago and in a different life 2025-01-14 20:56:13 -06:00
Perry Kivolowitz
08406598eb corrected broken link for register interlude. 2025-01-14 20:51:02 -06:00
Perry Kivolowitz
d0fe067eac removed link for Jishnu as it turned into a gambling sitegit add . 2025-01-14 20:40:56 -06:00
Perry Kivolowitz
4c4e8e37fd incorporated gitonthescene feedback 2024-07-04 12:32:47 -05:00
Perry Kivolowitz
f1dd2bea49 changed tabs to spaces in nine_args.s 2024-06-21 11:22:57 -05:00
Perry Kivolowitz
73bad628b4 corrected text to conform to corrected code in nine_args 2024-06-21 11:18:22 -05:00
Perry Kivolowitz
c5143f19db corrected error induced by post/pre increment to stack 2024-06-21 10:54:55 -05:00
Perry Kivolowitz
320f77b04b I guess I didn't sleep well, corrected the corrected gammar 2024-05-05 10:04:33 -05:00
Perry Kivolowitz
c2e75eb0ab grammar 2024-05-05 10:03:41 -05:00
Perry Kivolowitz
5a95744437 up 2024-05-05 10:02:15 -05:00
Perry Kivolowitz
966862042a corrected user name 2024-05-05 09:58:55 -05:00
Perry Kivolowitz
6243dc9b49 correction due to arne 2024-05-05 09:55:48 -05:00
Perry Kivolowitz
88d0bf495a corrected a link 2024-05-03 18:53:46 -05:00
pkivolowitz
27705340d1
Update ldr.md 
AVE changed to SVE
 2024-05-03 18:45:21 -05:00
Perry Kivolowitz
cdf98ea9a5 added pdf version 2024-05-02 09:30:52 -05:00
Perry Kivolowitz
bce4e339e2 added M series code without macros 2024-05-02 09:29:44 -05:00
Perry Kivolowitz
630812d99a added M series code without macros 2024-05-02 09:27:33 -05:00
Perry Kivolowitz
776ebc0545 improvements to text 2024-02-28 16:40:12 -06:00
Perry Kivolowitz
144acfb9d6 improved text 2024-02-28 16:12:29 -06:00
Perry Kivolowitz
7c896ef362 adde pdf 2024-02-28 10:48:54 -06:00
Perry Kivolowitz
697a9c0e87 WTF was I thinking before? 2024-02-28 10:47:55 -06:00
Perry Kivolowitz
c020675cd7 wrote apple-exit.c and s 2024-02-20 13:59:39 -06:00
Perry Kivolowitz
73a4abfb8d something changed 2024-02-17 16:17:36 -06:00
Perry Kivolowitz
a7e89718b1 corrected layout of floats for AARCH64 2024-02-15 13:14:59 -06:00
Perry Kivolowitz
29791113ae additions to hello world - provided addition for loop implementation 2024-02-05 10:54:54 -06:00
Perry Kivolowitz
d9f4ff4c17 added section header to kickstart 2024-01-31 20:22:07 -06:00
Perry Kivolowitz
652f593ca4 more changes to kick 2024-01-31 07:55:32 -06:00
Perry Kivolowitz
dcd6f4505b added to kickstart text 2024-01-31 07:42:22 -06:00
Perry Kivolowitz
1f6f214778 added kick start 2024-01-30 18:30:04 -06:00
Perry Kivolowitz
d3fea6487b updated markdownlint problems plus error in while 2024-01-25 16:08:01 -06:00
pkivolowitz
87ca33264a
Update README.md - formulusblack is gone 2023-12-31 11:31:14 -06:00
Perry Kivolowitz
d62f2e5de3 added this 2023-05-17 10:38:24 -05:00
Perry Kivolowitz
9ad792ddfe added MOD to apple-linux 2023-03-31 09:42:08 -05:00
Perry Kivolowitz
de40ccf20d added structs/practice.S 2023-03-04 15:10:27 -06:00
Perry Kivolowitz
3831e88e53 silly change of a word 2023-03-04 15:09:43 -06:00
Perry Kivolowitz
e1a26d75bd ldr is now fully understood 2023-03-02 13:23:57 -06:00
Perry Kivolowitz
75adc6a9b1 added language about apple avoiding a memory reference with their way of avoiding ldr 2023-03-02 11:47:01 -06:00
Perry Kivolowitz
8b41b3b0f3 moved atomics over to section 3 2023-03-01 14:23:21 -06:00
Perry Kivolowitz
7909ede0ee pdf 2023-02-28 20:49:02 -06:00
Perry Kivolowitz
275e9013a8 beginning section on atomics 2023-02-28 20:48:44 -06:00
Perry Kivolowitz
372a2598f5 typo found by Katie 2023-02-23 14:06:35 -06:00
Perry Kivolowitz
e7a99b1072 typo found by Katie 2023-02-23 14:05:29 -06:00
Perry Kivolowitz
8382853043 updated some samples 2023-02-23 13:42:45 -06:00
Perry Kivolowitz
0813ced99a added AASCIZ 2023-02-17 09:47:44 -06:00
Perry Kivolowitz
60c56840dd corrected MIN and MAX 2023-02-17 09:30:45 -06:00
Perry Kivolowitz
26d3d18f88 will NOT be covering SVE 2023-02-04 17:36:55 -06:00
Perry Kivolowitz
b6b5b96c56 added macro to fetch the address of errno 2023-02-03 10:22:27 -06:00
Perry Kivolowitz
e73fac71b5 freshened pdf file 2023-02-02 15:54:26 -06:00
Perry Kivolowitz
f301a4024a made hello world build on Apple 2023-02-02 15:54:05 -06:00