From: Eugene Syromyatnikov <evgsyr@gmail.com>
Date: Sun, 13 Aug 2017 17:33:58 +0000 (+0200)
Subject: Make description of discrepancies between libc and kernel APIs more relevant
X-Git-Tag: v4.19~146
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=d720877b1f6992454cb78b66657f378fceb0b58e;p=strace

Make description of discrepancies between libc and kernel APIs more relevant

Looks like this part was untouched since the days strace supported OSes
other than Linux. Well, it's time to make it more contemporary.

* strace.1.in (.SH NOTES): Use faccessat(2) and setrlimit(2)/prlimit(2)
instead of time(2) and stat(2)/xstat(2) as examples of libc/kernel API
discrepancies.
---

diff --git a/strace.1.in b/strace.1.in
index 1cea01e5..dc830086 100644
--- a/strace.1.in
+++ b/strace.1.in
@@ -859,14 +859,15 @@ sometimes possible to make deductive inferences about process
 behavior using inputs and outputs as propositions.
 .LP
 In some cases, a system call will differ from the documented behavior
-or have a different name.  For example, on System V-derived systems
-the true
-.BR time (2)
-system call does not take an argument and the
-.B stat
-function is called
-.B xstat
-and takes an extra leading argument.  These
+or have a different name.  For example, the
+.BR faccessat (2)
+system call does not have
+.I flags
+argument, and the
+.BR setrlimit (2)
+library function uses
+.BR prlimit (2)
+system call on modern (2.6.38+) kernels.  These
 discrepancies are normal but idiosyncratic characteristics of the
 system call interface and are accounted for by C library wrapper
 functions.