Various pages: retitle EXAMPLE section heading to EXAMPLES

EXAMPLES appears to be the wider majority usage across various
projects' manual pages, and is also what is used in the POSIX
manual pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man1/iconv.1

@@ -178,7 +178,7 @@ Usual system default gconv module configuration file.
 Usual system gconv module configuration cache.
 .SH CONFORMING TO
 POSIX.1-2001.
-.SH EXAMPLE
+.SH EXAMPLES
 Convert text from the ISO 8859-15 character encoding to UTF-8:
 .PP
 .in +4n

man1/locale.1

@@ -136,7 +136,7 @@ Usual default locale archive location.
 Usual default path for locale definition files.
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 $ \fBlocale\fP
 LANG=en_US.UTF\-8

man1/localedef.1

@@ -373,7 +373,7 @@ An output file that contains information about formatting of data and
 time values.
 .SH CONFORMING TO
 POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 Compile the locale files for Finnish in the UTF\-8 character set
 and add it to the default locale archive with the name
 .BR fi_FI.UTF\-8 :

man1/memusage.1

@@ -201,7 +201,7 @@ Exit status is equal to the exit status of profiled program.
 To report bugs, see
 .UR http://www.gnu.org/software/libc/bugs.html
 .UE
-.SH EXAMPLE
+.SH EXAMPLES
 Below is a simple program that reallocates a block of
 memory in cycles that rise to a peak before then cyclically
 reallocating the memory in smaller blocks that return to zero.

man1/memusagestat.1

@@ -82,7 +82,7 @@ Print version information and exit.
 To report bugs, see
 .UR http://www.gnu.org/software/libc/bugs.html
 .UE
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR memusage (1).
 .SH SEE ALSO

man1/pldd.1

@@ -103,7 +103,7 @@ was broken: it just hung when executed.
 .\" glibc commit 1a4c27355e146b6d8cc6487b998462c7fdd1048f
 This problem was fixed in glibc 2.30, and the fix has been backported
 to earlier glibc versions in some distributions.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 $ \fBecho $$\fP               # Display PID of shell
 1143

man1/sprof.1

@@ -76,7 +76,7 @@ Display the program version and exit.
 The
 .B sprof
 command is a GNU extension, not present in POSIX.1.
-.SH EXAMPLE
+.SH EXAMPLES
 The following example demonstrates the use of
 .BR sprof .
 The example consists of a main program that calls two functions

man2/_syscall.2

@@ -139,7 +139,7 @@ passed by-value or by-pointer (for aggregates like structs).
 .\" header file contains the required SYS_foo definition.
 .\" Otherwise, the use of a _syscall macro is required.
 .\"
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #include <stdio.h>
 #include <stdlib.h>

man2/accept.2

@@ -367,7 +367,7 @@ standard wanted to change it into a \fIsize_t\ *\fPC;
 .\" SunOS 5 has 'size_t *'
 later POSIX standards and glibc 2.x have
 .IR "socklen_t\ * ".
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR bind (2).
 .SH SEE ALSO

man2/add_key.2

@@ -221,7 +221,7 @@ A wrapper is provided in the
 package.
 When employing the wrapper in that library, link with
 .IR \-lkeyutils .
-.SH EXAMPLE
+.SH EXAMPLES
 The program below creates a key with the type, description, and payload
 specified in its command-line arguments,
 and links that key into the session keyring.

man2/bind.2

@@ -256,7 +256,7 @@ type, see
 .SH BUGS
 The transparent proxy options are not described.
 .\" FIXME Document transparent proxy options
-.SH EXAMPLE
+.SH EXAMPLES
 An example of the use of
 .BR bind ()
 with Internet domain sockets can be found in

man2/chown.2

@@ -446,7 +446,7 @@ as the old
 has got the same syscall number, and
 .BR chown ()
 got the newly introduced number.
-.SH EXAMPLE
+.SH EXAMPLES
 .PP
 The following program changes the ownership of the file named in
 its second command-line argument to the value specified in its

man2/clock_getres.2

@@ -437,7 +437,7 @@ and
 .BR CLOCK_THREAD_CPUTIME_ID ,
 on systems that provide such an implementation
 (i.e., Linux 2.6.12 and later).
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of
 .BR clock_gettime ()
 and

man2/clone.2

@@ -1771,7 +1771,7 @@ mypid = syscall(SYS_getpid);
 Because of the stale-cache problem, as well as other problems noted in
 .BR getpid (2),
 the PID caching feature was removed in glibc 2.25.
-.SH EXAMPLE
+.SH EXAMPLES
 The following program demonstrates the use of
 .BR clone ()
 to create a child process that executes in a separate UTS namespace.

man2/connect.2

@@ -286,7 +286,7 @@ If
 fails, consider the state of the socket as unspecified.
 Portable applications should close the socket and create a new one for
 reconnecting.
-.SH EXAMPLE
+.SH EXAMPLES
 An example of the use of
 .BR connect ()
 is shown in

man2/copy_file_range.2

@@ -226,7 +226,7 @@ gives filesystems an opportunity to implement "copy acceleration" techniques,
 such as the use of reflinks (i.e., two or more inodes that share
 pointers to the same copy-on-write disk blocks)
 or server-side-copy (in the case of NFS).
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #define _GNU_SOURCE
 #include <fcntl.h>

man2/eventfd.2

@@ -357,7 +357,7 @@ The functions perform the read and write operations on an
 eventfd file descriptor,
 returning 0 if the correct number of bytes was transferred,
 or \-1 otherwise.
-.SH EXAMPLE
+.SH EXAMPLES
 .PP
 The following program creates an eventfd file descriptor
 and then forks to create a child process.

man2/execve.2

@@ -780,7 +780,7 @@ Since UNIX\ V7, both are NULL.
 .\" .BR execve ()
 .\" that could be exploited for denial of service by a suitably crafted
 .\" ELF binary. There are no known problems with 2.0.34 or 2.2.15.
-.SH EXAMPLE
+.SH EXAMPLES
 The following program is designed to be execed by the second program below.
 It just echoes its command-line arguments, one per line.
 .PP

man2/fork.2

@@ -309,7 +309,7 @@ The glibc wrapper invokes any fork handlers that have been
 established using
 .BR pthread_atfork (3).
 .\" and does some magic to ensure that getpid(2) returns the right value.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR pipe (2)
 and

man2/futex.2

@@ -1711,7 +1711,7 @@ various POSIX threads synchronization mechanisms
 .\"
 .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
 .\"
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates use of futexes in a program where a parent
 process and a child process use a pair of futexes located inside a
 shared anonymous mapping to synchronize access to a shared resource:

man2/getdents.2

@@ -228,7 +228,7 @@ instead of these system calls.
 .PP
 These calls supersede
 .BR readdir (2).
-.SH EXAMPLE
+.SH EXAMPLES
 .\" FIXME The example program needs to be revised, since it uses the older
 .\" getdents() system call and the structure with smaller field widths.
 The program below demonstrates the use of

man2/getrlimit.2

@@ -776,7 +776,7 @@ and
 .BR getrlimit ()
 as wrapper functions that call
 .BR prlimit ().
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of
 .BR prlimit ().
 .PP

man2/getxattr.2

@@ -148,7 +148,7 @@ These system calls are Linux-specific.
 .\" and the SGI XFS development team,
 .\" .RI < linux-xfs@oss.sgi.com >.
 .\" Please send any bug reports or comments to these addresses.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR listxattr (2).
 .SH SEE ALSO

man2/inotify_add_watch.2

@@ -140,7 +140,7 @@ is not a directory.
 Inotify was merged into the 2.6.13 Linux kernel.
 .SH CONFORMING TO
 This system call is Linux-specific.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR inotify (7).
 .SH SEE ALSO

man2/ioctl_fat.2

@@ -243,7 +243,7 @@ was introduced in version 3.11
 of the Linux kernel.
 .SH CONFORMING TO
 This API is Linux-specific.
-.SH EXAMPLE
+.SH EXAMPLES
 .SS Toggling the archive flag
 The following program demonstrates the usage of
 .BR ioctl (2)

man2/ioctl_getfsmap.2

@@ -363,7 +363,7 @@ operation first appeared in Linux 4.12.
 .SH CONFORMING TO
 This API is Linux-specific.
 Not all filesystems support it.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .I io/fsmap.c
 in the

man2/ioctl_ns.2

@@ -186,7 +186,7 @@ does not refer to a
 file.
 .SH CONFORMING TO
 Namespaces and the operations described on this page are a Linux-specific.
-.SH EXAMPLE
+.SH EXAMPLES
 The example shown below uses the
 .BR ioctl (2)
 operations described above to perform simple

man2/ioctl_tty.2

@@ -549,7 +549,7 @@ Inappropriate
 .TP
 .B EPERM
 Insufficient permission.
-.SH EXAMPLE
+.SH EXAMPLES
 Check the condition of DTR on the serial port.
 .PP
 .EX

man2/ioctl_userfaultfd.2

@@ -679,7 +679,7 @@ operation that queries features availability and reopened before
 the second
 .BR UFFDIO_API
 operation that actually enables the desired features.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR userfaultfd (2).
 .SH SEE ALSO

man2/kcmp.2

@@ -319,7 +319,7 @@ See
 .BR clone (2)
 for some background information on the shared resources
 referred to on this page.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below uses
 .BR kcmp ()
 to test whether pairs of file descriptors refer to

man2/keyctl.2

@@ -1961,7 +1961,7 @@ When employing the wrapper in that library, link with
 However, rather than using this system call directly,
 you probably want to use the various library functions
 mentioned in the descriptions of individual operations above.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below provide subset of the functionality of the
 .BR request-key (8)
 program provided by the

man2/listen.2

@@ -175,7 +175,7 @@ with the value 128.
 .\" The following is now rather historic information (MTK, Jun 05)
 .\" Don't rely on this value in portable applications since BSD
 .\" (and some BSD-derived systems) limit the backlog to 5.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR bind (2).
 .SH SEE ALSO

man2/listxattr.2

@@ -171,7 +171,7 @@ attribute name list returned by
 .BR listxattr (7).
 If the total size of attribute names attached to a file exceeds this limit,
 it is no longer possible to retrieve the list of attribute names.
-.SH EXAMPLE
+.SH EXAMPLES
 The following program demonstrates the usage of
 .BR listxattr ()
 and

man2/membarrier.2

@@ -270,7 +270,7 @@ Examples where
 .BR membarrier ()
 can be useful include implementations
 of Read-Copy-Update libraries and garbage collectors.
-.SH EXAMPLE
+.SH EXAMPLES
 Assuming a multithreaded application where "fast_path()" is executed
 very frequently, and where "slow_path()" is executed infrequently, the
 following code (x86) can be transformed using

man2/memfd_create.2

@@ -341,7 +341,7 @@ If desired, the second process can apply further seals
 to impose additional restrictions (so long as the
 .BR F_SEAL_SEAL
 seal has not yet been applied).
-.SH EXAMPLE
+.SH EXAMPLES
 Below are shown two example programs that demonstrate the use of
 .BR memfd_create ()
 and the file sealing API.

man2/mmap.2

@@ -904,7 +904,7 @@ however, this doesn't work on
 .BR tmpfs (5)
 (for example, when using the POSIX shared memory interface documented in
 .BR shm_overview (7)).
-.SH EXAMPLE
+.SH EXAMPLES
 .\" FIXME . Add an example here that uses an anonymous shared region for
 .\" IPC between parent and child.
 .PP

man2/mprotect.2

@@ -283,7 +283,7 @@ When called this way, the operation of
 .BR pkey_mprotect ()
 is equivalent to
 .BR mprotect ().
-.SH EXAMPLE
+.SH EXAMPLES
 .\" sigaction.2 refers to this example
 .PP
 The program below demonstrates the use of

man2/msgop.2

@@ -571,7 +571,7 @@ this error was not diagnosed by
 This bug is fixed
 .\" commit 4f87dac386cc43d5525da7a939d4b4e7edbea22c
 in Linux 3.14.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of
 .BR msgsnd ()
 and

man2/open_by_handle_at.2

@@ -467,7 +467,7 @@ in order to produce the
 .IR mount_fd
 argument used by
 .BR open_by_handle_at ().
-.SH EXAMPLE
+.SH EXAMPLES
 The two programs below demonstrate the use of
 .BR name_to_handle_at ()
 and

man2/perf_event_open.2

@@ -3390,7 +3390,7 @@ Various generalized events have had wrong values.
 For example, retired branches measured
 the wrong thing on AMD machines until Linux 2.6.35.
 .\" commit f287d332ce835f77a4f5077d2c0ef1e3f9ea42d2
-.SH EXAMPLE
+.SH EXAMPLES
 The following is a short example that measures the total
 instruction count of a call to
 .BR printf (3).

man2/pidfd_open.2

@@ -193,7 +193,7 @@ furthermore, the file descriptor obtained in this way is
 .I not
 pollable and can't be waited on with
 .BR waitid (2).
-.SH EXAMPLE
+.SH EXAMPLES
 The program below opens a PID file descriptor for the
 process whose PID is specified as its command-line argument.
 It then uses

man2/pidfd_send_signal.2

@@ -176,7 +176,7 @@ if that process terminates,
 .BR pidfd_send_signal ()
 fails with the error
 .BR ESRCH .
-.SH EXAMPLE
+.SH EXAMPLES
 .nf
 #define _GNU_SOURCE
 #include <limits.h>

man2/pipe.2

@@ -216,7 +216,7 @@ wrapper function transparently deals with this.
 See
 .BR syscall (2)
 for information regarding registers used for storing second file descriptor.
-.SH EXAMPLE
+.SH EXAMPLES
 .\" fork.2 refers to this example program.
 The following program creates a pipe, and then
 .BR fork (2)s

man2/pivot_root.2

@@ -271,7 +271,7 @@ at that time that the implementation might change before final release.
 However, the behavior stated in DESCRIPTION
 has remained consistent since this system call
 was first implemented and will not change now.
-.SH EXAMPLE
+.SH EXAMPLES
 .\" FIXME
 .\" Would it be better, because simpler, to use unshare(2)
 .\" rather than clone(2) in the example below?

man2/pkey_alloc.2

@@ -131,7 +131,7 @@ or after it is freed via
 .BR pkey_free ()),
 the kernel may make arbitrary changes to the parts of the
 rights register affecting access to that key.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR pkeys (7).
 .SH SEE ALSO

man2/poll.2

@@ -477,7 +477,7 @@ notion of the sigset.
 See the discussion of spurious readiness notifications under the
 BUGS section of
 .BR select (2).
-.SH EXAMPLE
+.SH EXAMPLES
 The program below opens each of the files named in its command-line
 arguments and monitors the resulting file descriptors for readiness to read
 .RB ( POLLIN ).

man2/process_vm_readv.2

@@ -299,7 +299,7 @@ when using, for example, shared memory or pipes).
 .\" Original user is MPI, http://www.mcs.anl.gov/research/projects/mpi/
 .\" See also some benchmarks at http://lwn.net/Articles/405284/
 .\" and http://marc.info/?l=linux-mm&m=130105930902915&w=2
-.SH EXAMPLE
+.SH EXAMPLES
 The following code sample demonstrates the use of
 .BR process_vm_readv ().
 It reads 20 bytes at the address 0x10000 from the process with PID 10

man2/readlink.2

@@ -272,7 +272,7 @@ glibc constructs a pathname based on the symbolic link in
 that corresponds to the
 .IR dirfd
 argument.
-.SH EXAMPLE
+.SH EXAMPLES
 The following program allocates the buffer needed by
 .BR readlink ()
 dynamically from the information provided by

man2/readv.2

@@ -408,7 +408,7 @@ that the system is running a Linux kernel older than version 2.6.18
 And since glibc 2.20
 (which requires a minimum Linux kernel version of 2.6.32),
 the glibc wrapper functions always just directly invoke the system calls.
-.SH EXAMPLE
+.SH EXAMPLES
 The following code sample demonstrates the use of
 .BR writev ():
 .PP

man2/recv.2

@@ -545,7 +545,7 @@ See
 .BR recvmmsg (2)
 for information about a Linux-specific system call
 that can be used to receive multiple datagrams in a single call.
-.SH EXAMPLE
+.SH EXAMPLES
 An example of the use of
 .BR recvfrom ()
 is shown in

man2/recvmmsg.2

@@ -189,7 +189,7 @@ The error code is expected to be returned on a subsequent call to
 In the current implementation, however, the error code can be overwritten
 in the meantime by an unrelated network event on a socket,
 for example an incoming ICMP packet.
-.SH EXAMPLE
+.SH EXAMPLES
 .PP
 The following program uses
 .BR recvmmsg ()

man2/request_key.2

@@ -444,7 +444,7 @@ A wrapper is provided in the
 package.
 When employing the wrapper in that library, link with
 .IR \-lkeyutils .
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of
 .BR request_key ().
 The

man2/sched_setaffinity.2

@@ -303,7 +303,7 @@ counting those which are set, and stop upon reaching the value returned by
 .BR CPU_COUNT (3)
 (rather than iterating over the number of bits
 requested to be allocated).
-.SH EXAMPLE
+.SH EXAMPLES
 The program below creates a child process.
 The parent and child then each assign themselves to a specified CPU
 and execute identical loops that consume some CPU time.

man2/seccomp.2

@@ -909,7 +909,7 @@ addressing mode modifier yields an immediate mode operand
 whose value is the size of the
 .IR seccomp_data
 buffer.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below accepts four or more arguments.
 The first three arguments are a system call number,
 a numeric architecture identifier, and an error number.

man2/select.2

@@ -710,7 +710,7 @@ system call has the same behavior,
 but the glibc wrapper hides this behavior by internally copying the
 .I timeout
 to a local variable and passing that variable to the system call.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #include <stdio.h>
 #include <stdlib.h>

man2/select_tut.2

@@ -346,7 +346,7 @@ API provides an interface that is more efficient than
 and
 .BR poll (2)
 when monitoring large numbers of file descriptors.
-.SH EXAMPLE
+.SH EXAMPLES
 Here is an example that better demonstrates the true utility of
 .BR select ().
 The listing below is a TCP forwarding program that forwards

man2/semctl.2

@@ -639,7 +639,7 @@ operations.
 This was rectified
 .\" commit a5f4db877177d2a3d7ae62a7bac3a5a27e083d7f
 in Linux 4.6.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR shmop (2).
 .SH SEE ALSO

man2/semget.2

@@ -313,7 +313,7 @@ The name choice
 was perhaps unfortunate,
 .B IPC_NEW
 would more clearly show its function.
-.SH EXAMPLE
+.SH EXAMPLES
 The program shown below uses
 .BR semget ()
 to create a new semaphore set or retrieve the ID of an existing set.

man2/semop.2

@@ -517,7 +517,7 @@ This bug is fixed in kernel 2.6.11.
 .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
 .\" the fix:
 .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
-.SH EXAMPLE
+.SH EXAMPLES
 The following code segment uses
 .BR semop ()
 to atomically wait for the value of semaphore 0 to become zero,

man2/send.2

@@ -458,7 +458,7 @@ Linux may return
 .B EPIPE
 instead of
 .BR ENOTCONN .
-.SH EXAMPLE
+.SH EXAMPLES
 An example of the use of
 .BR sendto ()
 is shown in

man2/sendmmsg.2

@@ -174,7 +174,7 @@ The caller can retry the transmission,
 starting at the first failed message, but there is no guarantee that,
 if an error is returned, it will be the same as the one that was lost
 on the previous call.
-.SH EXAMPLE
+.SH EXAMPLES
 The example below uses
 .BR sendmmsg ()
 to send

man2/setns.2

@@ -253,7 +253,7 @@ a new thread is created using
 .BR clone (2)
 can be changed using
 .BR setns ().
-.SH EXAMPLE
+.SH EXAMPLES
 The program below takes two or more arguments.
 The first argument specifies the pathname of a namespace file in an existing
 .I /proc/[pid]/ns/

man2/shmget.2

@@ -411,7 +411,7 @@ The name choice
 was perhaps unfortunate,
 .B IPC_NEW
 would more clearly show its function.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR shmop (2).
 .SH SEE ALSO

man2/shmop.2

@@ -291,7 +291,7 @@ is the same as the system page size.)
 The implementation places no intrinsic per-process limit on the
 number of shared memory segments
 .RB ( SHMSEG ).
-.SH EXAMPLE
+.SH EXAMPLES
 .PP
 The two programs shown below exchange a string using a shared memory segment.
 Further details about the programs are given below.

man2/sigaction.2

@@ -1035,7 +1035,7 @@ prevents not only the delivered signal from being masked during
 execution of the handler, but also the signals specified in
 .IR sa_mask .
 This bug was fixed in kernel 2.6.14.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR mprotect (2).
 .SH SEE ALSO

man2/sigaltstack.2

@@ -324,7 +324,7 @@ give an error if
 .B SS_ONSTACK
 is specified in
 .IR ss.ss_flags .
-.SH EXAMPLE
+.SH EXAMPLES
 The following code segment demonstrates the use of
 .BR sigaltstack ()
 (and

man2/signalfd.2

@@ -444,7 +444,7 @@ and
 fields are not filled in with the data accompanying a signal sent by
 .BR sigqueue (3).
 .\" The fix also was put into 2.6.24.5
-.SH EXAMPLE
+.SH EXAMPLES
 The program below accepts the signals
 .B SIGINT
 and

man2/socket.2

@@ -485,7 +485,7 @@ families.
 However, already the BSD man page promises: "The protocol
 family generally is the same as the address family", and subsequent
 standards use AF_* everywhere.
-.SH EXAMPLE
+.SH EXAMPLES
 An example of the use of
 .BR socket ()
 is shown in

man2/splice.2

@@ -261,7 +261,7 @@ was required to be a pipe.
 Since Linux 2.6.31,
 .\" commit 7c77f0b3f9208c339a4b40737bb2cb0f0319bb8d
 both arguments may refer to pipes.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR tee (2).
 .SH SEE ALSO

man2/spu_create.2

@@ -262,7 +262,7 @@ See
 .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/
 .UE
 for the recommended libraries.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR spu_run (2)
 for an example of the use of

man2/spu_run.2

@@ -204,7 +204,7 @@ See
 .UR http://www.bsc.es\:/projects\:/deepcomputing\:/linuxoncell/
 .UE
 for the recommended libraries.
-.SH EXAMPLE
+.SH EXAMPLES
 The following is an example of running a simple, one-instruction SPU
 program with the
 .BR spu_run ()

man2/stat.2

@@ -640,7 +640,7 @@ wrapper function is actually called
 or, on some architectures,
 .\" strace(1) shows the name "newfstatat" on x86-64
 .BR newfstatat ().
-.SH EXAMPLE
+.SH EXAMPLES
 The following program calls
 .BR lstat ()
 and displays selected fields in the returned

man2/syscall.2

@@ -369,7 +369,7 @@ arguments 5 through 8 on the user stack.
 .PP
 Note that these tables don't cover the entire calling convention\(emsome
 architectures may indiscriminately clobber other registers not listed here.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #define _GNU_SOURCE
 #include <unistd.h>

man2/sysctl.2

@@ -133,7 +133,7 @@ Not all available objects are properly documented.
 .PP
 It is not yet possible to change operating system by writing to
 .IR /proc/sys/kernel/ostype .
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #define _GNU_SOURCE
 #include <unistd.h>

man2/tee.2

@@ -133,7 +133,7 @@ under the covers,
 .BR tee ()
 assigns data to the output by merely grabbing
 a reference to the input.
-.SH EXAMPLE
+.SH EXAMPLES
 The example below implements a basic
 .BR tee (1)
 program using the

man2/timer_create.2

@@ -335,7 +335,7 @@ and in glibc versions before 2.17,
 .\" glibc commit 93a78ac437ba44f493333d7e2a4b0249839ce460
 the implementation falls back to this technique on systems
 running pre-2.6 Linux kernels.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below takes two arguments: a sleep period in seconds,
 and a timer frequency in nanoseconds.
 The program establishes a handler for the signal it uses for the timer,

man2/timer_getoverrun.2

@@ -126,7 +126,7 @@ if the timer overrun value exceeds the maximum representable integer,
 the counter cycles, starting once more from low values.
 .\" Bug filed: http://bugzilla.kernel.org/show_bug.cgi?id=12665
 .\" http://thread.gmane.org/gmane.linux.kernel/113276/
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR timer_create (2).
 .SH SEE ALSO

man2/timer_settime.2

@@ -206,7 +206,7 @@ is negative or greater than 999,999,999.
 These system calls are available since Linux 2.6.
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR timer_create (2).
 .SH SEE ALSO

man2/timerfd_create.2

@@ -552,7 +552,7 @@ Currently,
 .BR timerfd_create ()
 supports fewer types of clock IDs than
 .BR timer_create (2).
-.SH EXAMPLE
+.SH EXAMPLES
 The following program creates a timer and then monitors its progress.
 The program accepts up to three command-line arguments.
 The first argument specifies the number of seconds for

man2/unshare.2

@@ -460,7 +460,7 @@ Such functionality may be added in the future, if required.
 .\"be incrementally added to unshare without affecting legacy
 .\"applications using unshare.
 .\"
-.SH EXAMPLE
+.SH EXAMPLES
 The program below provides a simple implementation of the
 .BR unshare (1)
 command, which unshares one or more namespaces and executes the

man2/userfaultfd.2

@@ -483,7 +483,7 @@ might be created.
 In this case, a spurious
 .B UFFD_EVENT_FORK
 will be delivered to the userfaultfd monitor.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of the userfaultfd mechanism.
 The program creates two threads, one of which acts as the
 page-fault handler for the process, for the pages in a demand-page zero

man2/wait.2

@@ -618,7 +618,7 @@ is NULL,
 succeeds, and returns the process ID of the waited-for child.
 Applications should avoid relying on this inconsistent,
 nonstandard, and unnecessary feature.
-.SH EXAMPLE
+.SH EXAMPLES
 .\" fork.2 refers to this example program.
 The following program demonstrates the use of
 .BR fork (2)

man3/CPU_SET.3

@@ -312,7 +312,7 @@ and less efficient operation of the macros that
 operate on dynamically allocated CPU sets.
 These bugs are fixed in glibc 2.9.
 .\" http://sourceware.org/bugzilla/show_bug.cgi?id=7029
-.SH EXAMPLE
+.SH EXAMPLES
 The following program demonstrates the use of some of the macros
 used for dynamically allocated CPU sets.
 .PP

man3/__ppc_get_timebase.3

@@ -63,7 +63,7 @@ has been provided since version 2.16 and
 has been available since version 2.17.
 .SH CONFORMING TO
 Both functions are nonstandard GNU extensions.
-.SH EXAMPLE
+.SH EXAMPLES
 The following program will calculate the time, in microseconds, spent
 between two calls to
 .BR __ppc_get_timebase ().

man3/__setfpucw.3

@@ -48,7 +48,7 @@ and
 macros from
 .I <fpu_control.h>
 can be used.
-.SH EXAMPLE
+.SH EXAMPLES
 .B __setfpucw(0x1372)
 .PP
 Set FPU control word on the i386 architecture to

man3/aio_cancel.3

@@ -125,7 +125,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR aio (7).
 .SH SEE ALSO

man3/aio_error.3

@@ -93,7 +93,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR aio (7).
 .SH SEE ALSO

man3/aio_read.3

@@ -155,7 +155,7 @@ The memory areas involved must remain valid.
 Simultaneous I/O operations specifying the same
 .I aiocb
 structure produce undefined results.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR aio (7).
 .SH SEE ALSO

man3/aio_return.3

@@ -89,7 +89,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 See
 .BR aio (7).
 .SH SEE ALSO

man3/atexit.3

@@ -143,7 +143,7 @@ Since glibc 2.2.3,
 .BR on_exit (3))
 can be used within a shared library to establish functions
 that are called when the shared library is unloaded.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 #include <stdio.h>
 #include <stdlib.h>

man3/backtrace.3

@@ -196,7 +196,7 @@ For systems using the GNU linker, it is necessary to use the
 linker option.
 Note that names of "static" functions are not exposed,
 and won't be available in the backtrace.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below demonstrates the use of
 .BR backtrace ()
 and

man3/basename.3

@@ -178,7 +178,7 @@ Before glibc 2.2.1, the glibc version of
 .BR dirname ()
 did not correctly handle pathnames with trailing \(aq/\(aq characters,
 and generated a segfault if given a NULL argument.
-.SH EXAMPLE
+.SH EXAMPLES
 The following code snippet demonstrates the use of
 .BR basename ()
 and

man3/bsearch.3

@@ -89,7 +89,7 @@ T}	Thread safety	MT-Safe
 .sp 1
 .SH CONFORMING TO
 POSIX.1-2001, POSIX.1-2008, C89, C99, SVr4, 4.3BSD.
-.SH EXAMPLE
+.SH EXAMPLES
 The example below first sorts an array of structures using
 .BR qsort (3),
 then retrieves desired elements using

man3/bswap.3

@@ -42,7 +42,7 @@ These macros return the value of their argument with the bytes reversed.
 These macros always succeed.
 .SH CONFORMING TO
 These macros are GNU extensions.
-.SH EXAMPLE
+.SH EXAMPLES
 The program below swaps the bytes of the 8-byte integer supplied as
 its command-line argument.
 The following shell session demonstrates the use of the program:

man3/cacos.3

@@ -49,7 +49,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 C99, POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 /* Link with "\-lm" */
 

man3/cacosh.3

@@ -52,7 +52,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 C99, POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 /* Link with "\-lm" */
 

man3/catan.3

@@ -47,7 +47,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 C99, POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 /* Link with "\-lm" */
 

man3/catanh.3

@@ -49,7 +49,7 @@ T}	Thread safety	MT-Safe
 .TE
 .SH CONFORMING TO
 C99, POSIX.1-2001, POSIX.1-2008.
-.SH EXAMPLE
+.SH EXAMPLES
 .EX
 /* Link with "\-lm" */
 

man3/clock_getcpuclockid.3

@@ -109,7 +109,7 @@ with a
 of 0,
 is the same as using the clock ID
 .BR CLOCK_PROCESS_CPUTIME_ID .
-.SH EXAMPLE
+.SH EXAMPLES
 The example program below obtains the
 CPU-time clock ID of the process whose ID is given on the command line,
 and then uses

man3/cmsg.3

@@ -186,7 +186,7 @@ and
 are constant expressions (assuming their argument is constant),
 meaning that these values can be used to declare the size of global variables.
 This may not be portable, however.
-.SH EXAMPLE
+.SH EXAMPLES
 This code looks for the
 .B IP_TTL
 option in a received ancillary buffer: