On 01/18/2015 08:22 AM, Kees Cook wrote:
> Added mips to tables. Extra column added for boolean error register, since
> both ia64 and mips use this convention. Added explicit non-register argument
> passing note for mips/o32.
>
> Added arm64 to tables.
Thanks Kees. I applied, but then tweaked. Because I do not want the tables
to render wider than 80 columns, I took the 'bool error' piece into a
paragraph below the table. See my commit eb83484fc.
Could you double check the result in the Git please.
Cheers,
Michael
>
> Signed-off-by: Kees Cook <keescook@xxxxxxxxxxxx>
> ---
> man2/syscall.2 | 47 +++++++++++++++++++++++++++--------------------
> 1 file changed, 27 insertions(+), 20 deletions(-)
>
> diff --git a/man2/syscall.2 b/man2/syscall.2
> index 3e76e56..05bf042 100644
> --- a/man2/syscall.2
> +++ b/man2/syscall.2
> @@ -36,6 +36,8 @@
> .\"
> .\" 2002-03-20 Christoph Hellwig <hch@xxxxxxxxxxxxx>
> .\" - adopted for Linux
> +.\" 2015-01-17, Kees Cook <keescook@xxxxxxxxxxxx>
> +.\" Added mips and arm64.
> .\"
> .TH SYSCALL 2 2014-12-31 "Linux" "Linux Programmer's Manual"
> .SH NAME
> @@ -148,29 +150,29 @@ The first table lists the instruction used to transition to kernel mode,
> so you might have to refer to
> .BR vdso (7)),
> the register used to indicate the system call number,
> -and the register used to return the system call result.
> +the register used to return the system call result,
> +and the register used to indicate simple boolean failure of
> +the system call.
> .if t \{\
> .ft CW
> \}
> .TS
> -l l1 l l1 l.
> -arch/ABI instruction syscall # retval Notes
> +l l l l l l.
> +arch/ABI instruction syscall # retval bool error Notes
> _
> -arm/OABI swi NR - a1 NR is syscall #
> -arm/EABI swi 0x0 r7 r0
> -blackfin excpt 0x0 P0 R0
> -i386 int $0x80 eax eax
> -ia64 break 0x100000 r15 r10/r8 T{
> -bool error/
> -.br
> -errno value
> -T}
> -parisc ble 0x100(%sr2, %r0) r20 r28
> -s390 svc 0 r1 r2 See below
> -s390x svc 0 r1 r2 See below
> -sparc/32 t 0x10 g1 o0
> -sparc/64 t 0x6d g1 o0
> -x86_64 syscall rax rax
> +arm/OABI swi NR - a1 - NR is syscall #
> +arm/EABI swi 0x0 r7 r0 -
> +arm64 svc #0 x8 x0 -
> +blackfin excpt 0x0 P0 R0 -
> +i386 int $0x80 eax eax -
> +ia64 break 0x100000 r15 r8 r10
> +mips syscall v0 v0 a3
> +parisc ble 0x100(%sr2, %r0) r20 r28 -
> +s390 svc 0 r1 r2 - See below
> +s390x svc 0 r1 r2 - See below
> +sparc/32 t 0x10 g1 o0 -
> +sparc/64 t 0x6d g1 o0 -
> +x86_64 syscall rax rax -
> .TE
> .PP
> For s390 and s390x, NR (the system call number)
> @@ -185,14 +187,17 @@ The second table shows the registers used to pass the system call arguments.
> .ft CW
> \}
> .TS
> -l l l l l l l l.
> -arch/ABI arg1 arg2 arg3 arg4 arg5 arg6 arg7
> +l l l l l l l l l.
> +arch/ABI arg1 arg2 arg3 arg4 arg5 arg6 arg7 Notes
> _
> arm/OABI a1 a2 a3 a4 v1 v2 v3
> arm/EABI r0 r1 r2 r3 r4 r5 r6
> +arm64 x0 x1 x2 x3 x4 x5 -
> blackfin R0 R1 R2 R3 R4 R5 -
> i386 ebx ecx edx esi edi ebp -
> ia64 out0 out1 out2 out3 out4 out5 -
> +mips/o32 a0 a1 a2 a3 - - - See below
> +mips/n32,64 a0 a1 a2 a3 a4 a5 -
> parisc r26 r25 r24 r23 r22 r21 -
> s390 r2 r3 r4 r5 r6 r7 -
> s390x r2 r3 r4 r5 r6 r7 -
> @@ -200,6 +205,8 @@ sparc/32 o0 o1 o2 o3 o4 o5 -
> sparc/64 o0 o1 o2 o3 o4 o5 -
> x86_64 rdi rsi rdx r10 r8 r9 -
> .TE
> +.PP
> +The mips/o32 syscall convention passes arguments 5 through 8 on the user stack.
> .if t \{\
> .in
> .ft P
>
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
