Syscall documentation for int80

Question

I am learning x86 assembly and I was wondering if someone could help me understand why the documentation is telling me a completely different thing to what I see in practice?

To invoke a system call I use int 80h software interrupt. I put the arguments in the first 3 registers in rbx,rcx,rdx registers and the number of the syscall in the rax. And it works, the read syscall for example works and I can see data going in the desired location in memory. However if I read man syscall it says I should put arguments to the syscall in rdi, rsi, rdx, r10, r8, r9 in that order from 1-6 for x86_64. Doing that does not work also seems a bit insane, I've seen a few resources online suggesting the same registers for syscall arguments. Is that just an error in documentation?

Same question for syscall numbers. Online people suggest looking at /usr/include/x86_64-linux-gnu/asm/unistd_64.h but there the number for read is 0 and it doesn't work, using 3 how the book suggests works, why is that?

Answer 1

Okay I've figured it out. Will post an answer here just in case someone will have a similar question reading through Jeff Duntemann's book on Assembly.

So even though you can translate assembly for 64 bit with NASM, the specific instruction int 080h somehow, it seems, invokes 32 bit mode. Not sure how R registers can be used in 32 bit mode but apparently either they can or some other mechanism interprets it as 32 bit program. Which is why syscall numbers are completely different (they are listed in the /usr/include/x86_64-linux-gnu/asm/unistd_32.h). So program exit is #1 in 32 bit and #60 in 64 bit.

What should be used instead is syscall instruction without any arguments. Than everything in the documentation will be correct and work. The strand naming convention is strange going from a, b, c, d but can be sort of explained. rdi,rsi,rdx are registers 6-5-4 so basically reverse order, register rcx is destroyed after a syscall (says so in the documentation and r11 too) so then it is substituted with r10 and then other R registers are used from the beginning.