From: Dmitry V. Levin <ldv@altlinux.org>
Date: Wed, 9 Dec 2015 15:55:33 +0000 (+0000)
Subject: Document that syscall names match kernel __NR_* constants
X-Git-Tag: v4.11~21
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a5c16b865625189ddb041be43fef89851944f0e2;p=strace

Document that syscall names match kernel __NR_* constants

* strace.1: Note syscall naming difference between architectures
and the rule of choosing the right syscall name in each case.
---

diff --git a/strace.1 b/strace.1
index c1f87e9d..f40add8b 100644
--- a/strace.1
+++ b/strace.1
@@ -654,6 +654,18 @@ discrepancies are normal but idiosyncratic characteristics of the
 system call interface and are accounted for by C library wrapper
 functions.
 .LP
+Some system calls have different names in different architectures and
+personalities.  In these cases, system call filtering and printing
+uses the names that match corresponding
+.BR __NR_ *
+kernel macros of the tracee's architecture and personality.
+There are two exceptions from this general rule:
+.BR arm_fadvise64_64 (2)
+ARM syscall and
+.BR xtensa_fadvise64_64 (2)
+Xtensa syscall are filtered and printed as
+.BR fadvise64_64 (2).
+.LP
 On some platforms a process that is attached to with the
 .B \-p
 option may observe a spurious EINTR return from the current