]> git.ipfire.org Git - thirdparty/man-pages.git/commitdiff
_exit.2, access.2, brk.2, chmod.2, clone.2, epoll_wait.2, eventfd.2, fork.2, getgroup...
authorMichael Kerrisk <mtk.manpages@gmail.com>
Fri, 8 May 2015 11:08:00 +0000 (13:08 +0200)
committerMichael Kerrisk <mtk.manpages@gmail.com>
Fri, 8 May 2015 11:10:04 +0000 (13:10 +0200)
The "ABI" doesn't really convey anything significant in
the title. These subsections are about describing differences
between the kernel and (g)libc interfaces.

Reported-by: Andries E. Brouwer <Andries.Brouwer@cwi.nl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
42 files changed:
man2/_exit.2
man2/access.2
man2/brk.2
man2/chmod.2
man2/clone.2
man2/epoll_wait.2
man2/eventfd.2
man2/fork.2
man2/getgroups.2
man2/gethostname.2
man2/getpid.2
man2/getpriority.2
man2/killpg.2
man2/mmap.2
man2/poll.2
man2/posix_fadvise.2
man2/pread.2
man2/ptrace.2
man2/readv.2
man2/sched_setaffinity.2
man2/select.2
man2/seteuid.2
man2/setgid.2
man2/setresuid.2
man2/setreuid.2
man2/setuid.2
man2/sigaction.2
man2/signalfd.2
man2/sigpending.2
man2/sigprocmask.2
man2/sigreturn.2
man2/sigsuspend.2
man2/sigwaitinfo.2
man2/stat.2
man2/timer_create.2
man2/uname.2
man2/wait.2
man2/wait4.2
man3/mq_notify.3
man3/mq_open.3
man3/sigqueue.3
man7/man-pages.7

index 598959f4197050bbcb23d49598219c092a118d91..4b743bc51e03f568b2b618d0ffaee03b94462633 100644 (file)
@@ -114,7 +114,7 @@ Whether any pending I/O is canceled, and which pending I/O may be
 canceled upon
 .BR _exit (),
 is implementation-dependent.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 In glibc up to version 2.3, the
 .BR _exit ()
 wrapper function invoked the kernel system call of the same name.
index 463e1208742d3d70686d516eaa14c4b3f75c5216..f2f79f85c958bd43ff8d65beeff12d9fee712b2b 100644 (file)
@@ -338,7 +338,7 @@ the server.)
 Similar problems can occur to FUSE mounts.
 .\"
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The raw
 .BR faccessat ()
 system call takes only the first three arguments.
index 0dcfd7417393c0c5795eae6d270b82f5fdc3cde7..be8bf102b116dac136660b12c22dd40485b40b45 100644 (file)
@@ -137,7 +137,7 @@ Common are \fIint\fP, \fIssize_t\fP, \fIptrdiff_t\fP, \fIintptr_t\fP.
 .\" \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc 2.0, 2.1),
 .\" \fIintptr_t\fP (e.g., XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
 .\" Tru64 5.1, glibc2.2).
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The return value described above for
 .BR brk ()
 is the behavior provided by the glibc wrapper function for the Linux
index 89e2e42b2ed4d9d72471e3f520e79f3a5d7a908c..718c9c566c43e1467c11a06bf1b3a6f90377e797 100644 (file)
@@ -335,7 +335,7 @@ library support was added to glibc in version 2.4.
 .BR fchmodat ():
 POSIX.1-2008.
 .SH NOTES
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The GNU C library
 .BR fchmodat ()
 wrapper function implements the POSIX-specified
index afec97f0961ced2770515838483d8baabf642721..d565794a7687cacd39f9bc94e97b55231632afa7 100644 (file)
@@ -790,7 +790,7 @@ space of the calling process at the time of
 Memory writes or file mappings/unmappings performed by one of the
 processes do not affect the other, as with
 .BR fork (2).
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The raw
 .BR clone ()
 system call corresponds more closely to
index 721de043c480eb9af5d0997102f00001daeed68b..963790644d02c409d9031f444ce99ff665c93a80 100644 (file)
@@ -226,7 +226,7 @@ is 4 and the kernel
 .I HZ
 value is 1000,
 this means that timeouts greater than 35.79 minutes are treated as infinity.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The raw
 .BR epoll_pwait ()
 system call has a sixth argument,
index 79db16f49eaaff1897b6ad8d9c2a1484792abe7d..01c2d874aba6cda84d638fde9a0a1eff4161c615 100644 (file)
@@ -299,7 +299,7 @@ interface, these mechanisms could not be multiplexed via
 .BR poll (2),
 or
 .BR epoll (7).)
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 There are two underlying Linux system calls:
 .BR eventfd ()
 and the more recent
index a2bb666112c314747847462dc2a36526f7bc628a..cf900ce9ed74ad72e115a7b2cdfdc76b2e2bbf6f 100644 (file)
@@ -243,7 +243,7 @@ Under Linux,
 is implemented using copy-on-write pages, so the only penalty that it incurs
 is the time and memory required to duplicate the parent's page tables,
 and to create a unique task structure for the child.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 Since version 2.3.3,
 .\" nptl/sysdeps/unix/sysv/linux/fork.c
 rather than invoking the kernel's
index 71d2a3b2e90b988e5ad76594fbbd7c840fe51e33..a2c8b851e5b0b5e88c9e70f123569b73095da495 100644 (file)
@@ -189,7 +189,7 @@ The glibc
 .BR getgroups ()
 wrapper function transparently deals with the variation across kernel versions.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the kernel level, user IDs and group IDs are a per-thread attribute.
 However, POSIX requires that all threads in a process
 share the same credentials.
index 441aa97a5ea9c3dd45eb6fe4731b6da9dcd88be4..5069d61cc757400f12f9b31013d905f36b615c84 100644 (file)
@@ -137,7 +137,7 @@ On Linux,
 .B HOST_NAME_MAX
 is defined with the value 64, which has been the limit since Linux 1.0
 (earlier kernels imposed a limit of 8 bytes).
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The GNU C library does not employ the
 .BR gethostname ()
 system call; instead, it implements
index ca9b38d0ab89a653671522fc0849c137ffaf053d..643c8968e40167e4df76adfdd2aa6e52d9d78736 100644 (file)
@@ -51,7 +51,7 @@ If the caller's parent is in a different PID namespace (see
 .BR getppid ()
 returns 0.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 Since glibc version 2.3.4,
 the glibc wrapper function for
 .BR getpid ()
index 48cc68b184c3b42c3a97f427ea06dd49d3d309c1..7d047b7893a7c2d58383f0389a81f7fcac02bb60 100644 (file)
@@ -207,7 +207,7 @@ structure with fields of type
 defined in
 .IR <sys/time.h> .)
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 Within the kernel, nice values are actually represented
 using the range 40..1
 (since negative numbers are error codes) and these are the values
index 1124cfb64779a36c7e5af54b38674b4229b94f16..9b279361bca50ac49a53152910e704a05b46901d 100644 (file)
@@ -126,7 +126,7 @@ returned when the permission check failed for at least one target process,
 while POSIX documents
 .B EPERM
 only when the permission check failed for all target processes.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux,
 .BR killpg ()
 is implemented as a library function that makes the call
index 456f9a06c9ee56db7d33daf193d824682a7a45f4..bf7f449e1d539d4a16b5980131ae08c6d68b9e61 100644 (file)
@@ -613,7 +613,7 @@ The relevant flags are:
 and
 .BR MAP_STACK .
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 This page describes the interface provided by the glibc
 .BR mmap ()
 wrapper function.
index ffcc04b04f693813a8191d6cd28c98cf2096c17d..f596c2d24c47a136c3cd97028bf4c002e9cfdd01 100644 (file)
@@ -376,7 +376,7 @@ For a discussion of what may happen if a file descriptor being monitored by
 .BR poll ()
 is closed in another thread, see
 .BR select (2).
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The Linux
 .BR ppoll ()
 system call modifies its
index da34e6b053b86b6632778df52f36536c30a12c4c..fb81db42cce21e7f7b3aaf3a99e0eaaf2dcc70ef 100644 (file)
@@ -169,7 +169,7 @@ call
 or
 .BR fdatasync (2)
 first.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The name of the wrapper function in the C library is
 .BR posix_fadvise ().
 The underlying system call is called
index e1aa5425f0874cbdadde8dd0c332dda80890614a..66c8a53752870f676fed247e559db9b29ce52824 100644 (file)
@@ -123,7 +123,7 @@ system calls are especially useful in multithreaded applications.
 They allow multiple threads to perform I/O on the same file descriptor
 without being affected by changes to the file offset by other threads.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux, the underlying system calls were renamed
 in kernel 2.6:
 .BR pread ()
index 532f898ee2de47f89aabd6209913942af40c43b6..258eff023b5b27a176d04f7cfc5ab239fe1b4c25 100644 (file)
@@ -2019,7 +2019,7 @@ Its behavior differs significantly on other flavors of UNIX.
 In any case, use of
 .BR ptrace ()
 is highly specific to the operating system and architecture.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the system call level, the
 .BR PTRACE_PEEKTEXT ,
 .BR PTRACE_PEEKDATA ,
index 756a23f193def72ac43c1e40dc31b424e37e7496..009c944059077379e31d4f74816dd66eda232d92 100644 (file)
@@ -239,7 +239,7 @@ On modern Linux systems, the limit is 1024.
 Back in Linux 2.0 days, this limit was 16.
 \"
 \"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The raw
 .BR preadv ()
 and
@@ -254,7 +254,7 @@ is unpacked by the wrapper functions into two arguments in the system calls:
 
 These arguments contain, respectively, the low order and high order 32 bits of
 .IR offset .
-.SS Historical C library/kernel ABI differences
+.SS Historical C library/kernel differences
 To deal with the fact that
 .B IOV_MAX
 was so low on early versions of Linux,
index 0cd31c3e1800ca06e936ef0097e909d0e58eb19b..f4713fd05fef1e7417827fc29e08a227082159be 100644 (file)
@@ -209,7 +209,7 @@ A child created via
 inherits its parent's CPU affinity mask.
 The affinity mask is preserved across an
 .BR execve (2).
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 This manual page describes the glibc interface for the CPU affinity calls.
 The actual system call interface is slightly different, with the
 .I mask
index ef5f9fc7f35cac631dcf24e846ac998c0f5b9685..eb3d4213471e8de8f92fb07ef32d1a202d7579cd 100644 (file)
@@ -445,7 +445,7 @@ closing the file descriptor in another thread has no effect on
 In summary, any application that relies on a particular behavior
 in this scenario must be considered buggy.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The
 .BR pselect ()
 interface described in this page is implemented by glibc.
index 99fc94316ff43642b17dea0361dbccaf2ec8a81c..0a6d1965c28311fcc0aa847e27f4086c44d9e083 100644 (file)
@@ -129,7 +129,7 @@ need not permit
 .RI ( egid )
 to be the same value as the current effective user (group) ID,
 and some implementations do not permit this.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux,
 .BR seteuid ()
 and
index 01b5efbfb05ddbdfc6d2b3e570a65709ecac8fa7..701799a817a611df063397ab1284c6b92a7eb163 100644 (file)
@@ -83,7 +83,7 @@ The glibc
 .BR setgid ()
 wrapper function transparently deals with the variation across kernel versions.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the kernel level, user IDs and group IDs are a per-thread attribute.
 However, POSIX requires that all threads in a process
 share the same credentials.
index 8042a2596a431a6608244bdc71ea8a59e8f26123..288efac25d9549f00269aaf39c3a31330a1460e0 100644 (file)
@@ -131,7 +131,7 @@ and
 .BR setresgid ()
 wrapper functions transparently deal with the variations across kernel versions.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the kernel level, user IDs and group IDs are a per-thread attribute.
 However, POSIX requires that all threads in a process
 share the same credentials.
index fec65f75cd1c150c3ac43721135386a38778f279..11ed444112dc33cecb1be3810642781aa93f7d83 100644 (file)
@@ -193,7 +193,7 @@ and
 .BR setregid ()
 wrapper functions transparently deal with the variations across kernel versions.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the kernel level, user IDs and group IDs are a per-thread attribute.
 However, POSIX requires that all threads in a process
 share the same credentials.
index 8b53bd4ea119f50a43323bee9c68f9200d7245b4..89c5d19e3c286e499c472b36a9418dbdcdaedd07 100644 (file)
@@ -147,7 +147,7 @@ The glibc
 .BR setuid ()
 wrapper function transparently deals with the variation across kernel versions.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 At the kernel level, user IDs and group IDs are a per-thread attribute.
 However, POSIX requires that all threads in a process
 share the same credentials.
index 069de9f26fc9372936a6f332149f43f9eaf1698d..e12d66d67678a771313a1fb06a5547a747e85370 100644 (file)
@@ -841,7 +841,7 @@ See
 for a list of the async-signal-safe functions that can be
 safely called inside from inside a signal handler.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The glibc wrapper function for
 .BR sigaction ()
 gives an error
index 69328bdd5235c783bc6ed71566cdd68d3d041eeb..47398f1915983a369d5220f04f39f5bba00fd253 100644 (file)
@@ -323,7 +323,7 @@ If a signal appears in the
 .I mask
 of more than one of the file descriptors, then occurrences
 of that signal can be read (once) from any one of the descriptors.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The underlying Linux system call requires an additional argument,
 .IR "size_t sizemask" ,
 which specifies the size of the
index 4022654f3f8ba13c802098398588f09379406b65..db28d1bb5ba419276d07a56527895791344d2d26 100644 (file)
@@ -83,7 +83,7 @@ initially has an empty pending signal set;
 the pending signal set is preserved across an
 .BR execve (2).
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The original Linux system call was named
 .BR sigpending ().
 However, with the addition of real-time signals in Linux 2.2,
index 54eee024a274981050e6c5a1540af5df816a5efd..3f417cbb63344bd6313525af52ad59f9a2d8d962 100644 (file)
@@ -142,7 +142,7 @@ See
 .BR sigsetops (3)
 for details on manipulating signal sets.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The glibc wrapper function for
 .BR sigprocmask ()
 silently ignores attempts to block the two real-time signals that
index 15c808b7507005e1295114f817628f6338e47f72..76a9b88dccf6e5619e1c639e2922686435c035e8 100644 (file)
@@ -121,7 +121,7 @@ and the trampoline code calls the signal handler (and then calls
 .BR sigreturn ()
 once the handler returns).
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The original Linux system call was named
 .BR sigreturn ().
 However, with the addition of real-time signals in Linux 2.2,
index d14322694991b9595b92c8f845b951616be516fb..4ed5fdf2660cd601c87367c2914f787d504e512a 100644 (file)
@@ -106,7 +106,7 @@ See
 .BR sigsetops (3)
 for details on manipulating signal sets.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The original Linux system call was named
 .BR sigsuspend ().
 However, with the addition of real-time signals in Linux 2.2,
index 5689b876d2b72c6c508d1e8397ebc345a06ca23f..6fb1eab085f3eacc3eac934edd06d398e823cf29 100644 (file)
@@ -181,7 +181,7 @@ as a call to
 .BR sigwaitinfo (),
 and indeed this is what is done on Linux.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux,
 .BR sigwaitinfo ()
 is a library function implemented on top of
index 60f10c1a8ed99ac21300dc145a81f1999b8d728f..c165fa23416ba14ac2af7b36a73c1a55c569e5aa 100644 (file)
@@ -831,7 +831,7 @@ ext4 (since Linux 2.6.23).
 Nanosecond timestamps are not supported in ext2, ext3, and Reiserfs.
 On filesystems that do not support subsecond timestamps,
 the nanosecond fields are returned with the value 0.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 Over time, increases in the size of the
 .I stat
 structure have led to three successive versions of
index 83ce18dece20b7f6044837feed5e8fa0190e5ec0..4c234a826aaa29166e10006f5e9069f53c23add0 100644 (file)
@@ -240,7 +240,7 @@ See
 .BR proc (5)
 for further information.
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 Part of the implementation of the POSIX timers API is provided by glibc.
 .\" See nptl/sysdeps/unix/sysv/linux/timer_create.c
 In particular:
index f1c187c20944eb34fc09f432ee543429fe0c945f..c8e9745535d605fa1f388594fdea5a72b17dd9e7 100644 (file)
@@ -135,7 +135,7 @@ Part of the utsname information is also accessible via
 .IR osrelease ,
 .IR version ,
 .IR domainname }.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 .LP
 Over time, increases in the size of the
 .I utsname
index e9ee6bad5cbfa3018811c13df150f8457eec4f78..95bd308d4bbf43e7584585a901b062567c925c4f 100644 (file)
@@ -522,7 +522,7 @@ type ("clone" or "non-clone").
 Do not wait for children of other threads in
 the same thread group.
 This was the default before Linux 2.4.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 .BR wait ()
 is actually a library function that (in glibc) is implemented as a call to
 .BR wait4 (2).
index dd5ee17b338c37fd0d40d4b3cabfb8e581f011c5..8c0686d11622b9a6b2e4a3dc86bcf41f32896071 100644 (file)
@@ -156,7 +156,7 @@ structure with fields of type
 .I struct timeval
 defined in
 .IR <sys/time.h> .)
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux,
 .BR wait3 ()
 is a library function implemented on top of the
index 9b8850a6e822c7ad7a0d52bc0921a9df891efdad..9709e19ac801bd413e16c80370c12630bf194c58 100644 (file)
@@ -175,7 +175,7 @@ notifications for the queue
 POSIX.1-2001.
 .SH NOTES
 .\"
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 In the glibc implementation, the
 .BR mq_notify ()
 library function is implemented on top of the system call of the same name.
index 26932ef68f3195cc2c5b9aa9eeb2a46a54b65048..b5ee2474e7ee010507c22977947b23cb7bc6511e 100644 (file)
@@ -256,7 +256,7 @@ T}  Thread safety   MT-Safe
 .SH CONFORMING TO
 POSIX.1-2001.
 .SH NOTES
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 The
 .BR mq_open ()
 library function is implemented on top of a system call of the same name.
index a0deefc063c5ad5a5086a7cfef8ce3ee3382e336..e9b35f7ad5c71be71ce184d467c37653c0be02ce 100644 (file)
@@ -136,7 +136,7 @@ having it unblocked, or by waiting for it using
 .BR sigwait (3)),
 then at least some signal must be delivered to this thread before this
 function returns.
-.SS C library/kernel ABI differences
+.SS C library/kernel differences
 On Linux,
 .BR sigqueue ()
 is implemented using the
index cacc2448e55f04fa4f4ab89b83ea8725d10cb498..dbc5a5e6b557cbe09c077fbe92ea2855ad71fc5a 100644 (file)
@@ -420,7 +420,7 @@ For Section 2 and 3 man pages you may find it useful to include
 subsections (\fBSS\fP) named \fILinux Notes\fP and \fIGlibc Notes\fP.
 
 In Section 2, use the heading
-.I "C library/kernel ABI differences"
+.I "C library/kernel differences"
 to mark off notes that describe the differences (if any) between
 the C library wrapper function for a system call and
 the raw system call interface provided by the kernel.