]> git.ipfire.org Git - thirdparty/man-pages.git/log
thirdparty/man-pages.git
6 years agoReady for 4.15 man-pages-4.15
Michael Kerrisk [Fri, 2 Feb 2018 06:40:41 +0000 (07:40 +0100)] 
Ready for 4.15

6 years agoRemoved trailing white space at end of lines
Michael Kerrisk [Fri, 2 Feb 2018 06:40:31 +0000 (07:40 +0100)] 
Removed trailing white space at end of lines

6 years agoChanges: Expanded tabs
Michael Kerrisk [Fri, 2 Feb 2018 06:40:31 +0000 (07:40 +0100)] 
Changes: Expanded tabs

6 years agoiconv.1, bpf.2, copy_file_range.2, fcntl.2, memfd_create.2, mlock.2, mount.2, mprotec...
Michael Kerrisk [Fri, 2 Feb 2018 06:38:54 +0000 (07:38 +0100)] 
iconv.1, bpf.2, copy_file_range.2, fcntl.2, memfd_create.2, mlock.2, mount.2, mprotect.2, perf_event_open.2, pkey_alloc.2, prctl.2, read.2, recvmmsg.2, s390_sthyi.2, seccomp.2, sendmmsg.2, syscalls.2, unshare.2, write.2, errno.3, fgetpwent.3, fts.3, pthread_rwlockattr_setkind_np.3, fuse.4, veth.4, capabilities.7, cgroups.7, ip.7, man-pages.7, namespaces.7, network_namespaces.7, sched.7, socket.7, user_namespaces.7, iconvconfig.8: tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoChanges: Ready for 4.15
Michael Kerrisk [Fri, 26 Jan 2018 20:12:50 +0000 (21:12 +0100)] 
Changes: Ready for 4.15

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agovsock.7: Add license and copyright
Michael Kerrisk [Thu, 1 Feb 2018 21:22:18 +0000 (22:22 +0100)] 
vsock.7: Add license and copyright

Stefan noted on the mailing list that selection of the
verbatim license was fine.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: tfix
Jakub Wilk [Fri, 26 Jan 2018 13:40:26 +0000 (14:40 +0100)] 
cgroups.7: tfix

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocapabilities.7: spfix
Michael Kerrisk [Sat, 13 Jan 2018 19:58:51 +0000 (20:58 +0100)] 
capabilities.7: spfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add a detail on delegation of cgroup.threads
Michael Kerrisk [Wed, 10 Jan 2018 23:52:26 +0000 (00:52 +0100)] 
cgroups.7: Add a detail on delegation of cgroup.threads

Some notes from a conversation with Tejun Heo:

    Subject: Re: cgroups(7): documenting cgroups v2 delegation
    Date: Wed, 10 Jan 2018 14:27:26 -0800
    From: Tejun Heo <tj@kernel.org>

    > > 1. When delegating, cgroup.threads should be delegated.  Doing that
    > >    selectively doesn't achieve anything meaningful.
    >
    > Understood. But surely delegating cgroup.threads is effectively
    > meaningless when delegating a "domain" cgroup tree? (Obviously it's
    > not harmful to delegate the the cgroup.threads file in this case;
    > it's just not useful to do so.)

    Yeap, unless we can somehow support non-root mixed domains.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Subhierarchy under delegated subtree will be owned by delegatee
Michael Kerrisk [Wed, 10 Jan 2018 23:38:49 +0000 (00:38 +0100)] 
cgroups.7: Subhierarchy under delegated subtree will be owned by delegatee

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add a detail on delegation of cgroup.threads
Michael Kerrisk [Wed, 10 Jan 2018 23:34:09 +0000 (00:34 +0100)] 
cgroups.7: Add a detail on delegation of cgroup.threads

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Define containment rules for cgroup.threads
Michael Kerrisk [Wed, 10 Jan 2018 22:19:50 +0000 (23:19 +0100)] 
cgroups.7: Define containment rules for cgroup.threads

Reviewed-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Minor wording fixes
Michael Kerrisk [Wed, 10 Jan 2018 19:29:25 +0000 (20:29 +0100)] 
cgroups.7: Minor wording fixes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: cgroup.threads should appear in /sys/kernel/cgroup/delegate
Michael Kerrisk [Wed, 10 Jan 2018 19:15:23 +0000 (20:15 +0100)] 
cgroups.7: cgroup.threads should appear in /sys/kernel/cgroup/delegate

As discussed with Tejun Heo and Roman Gushchin, the
omission of this file from the list is a bug, and
is about to be fixed by a kernel patch from Roman.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add some rationale for the existence of the "domain invalid" cgroup type
Michael Kerrisk [Wed, 10 Jan 2018 04:34:54 +0000 (05:34 +0100)] 
cgroups.7: Add some rationale for the existence of the "domain invalid" cgroup type

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: wfix
Michael Kerrisk [Tue, 9 Jan 2018 23:10:54 +0000 (00:10 +0100)] 
cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Point out that 'nsdelegate' can also be applied on a remount
Michael Kerrisk [Tue, 9 Jan 2018 23:08:28 +0000 (00:08 +0100)] 
cgroups.7: Point out that 'nsdelegate' can also be applied on a remount

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Clarify that cgroup.controllers is read-only
Michael Kerrisk [Tue, 9 Jan 2018 22:51:56 +0000 (23:51 +0100)] 
cgroups.7: Clarify that cgroup.controllers is read-only

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: cgroup.threads is also delegated if delegating a threaded subtree
Michael Kerrisk [Tue, 9 Jan 2018 22:44:53 +0000 (23:44 +0100)] 
cgroups.7: cgroup.threads is also delegated if delegating a threaded subtree

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: cgroup.threads is writable only inside a threaded subtree
Michael Kerrisk [Tue, 9 Jan 2018 22:42:05 +0000 (23:42 +0100)] 
cgroups.7: cgroup.threads is writable only inside a threaded subtree

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: ffix
Michael Kerrisk [Tue, 9 Jan 2018 22:37:27 +0000 (23:37 +0100)] 
cgroups.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: ffix
Michael Kerrisk [Tue, 9 Jan 2018 21:24:19 +0000 (22:24 +0100)] 
cgroups.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add a more complete description of cgroup v1 named hierarchies
Michael Kerrisk [Tue, 9 Jan 2018 20:37:31 +0000 (21:37 +0100)] 
cgroups.7: Add a more complete description of cgroup v1 named hierarchies

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix
Michael Kerrisk [Tue, 9 Jan 2018 20:28:47 +0000 (21:28 +0100)] 
cgroups.7: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Remove accidentally duplicated NOTES and ERRORS sections
Michael Kerrisk [Tue, 9 Jan 2018 20:22:22 +0000 (21:22 +0100)] 
cgroups.7: Remove accidentally duplicated NOTES and ERRORS sections

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Elaborate a little on problems of splitting threads across cgroups in v1
Michael Kerrisk [Tue, 9 Jan 2018 20:20:24 +0000 (21:20 +0100)] 
cgroups.7: Elaborate a little on problems of splitting threads across cgroups in v1

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: tfix
Michael Kerrisk [Tue, 9 Jan 2018 19:56:51 +0000 (20:56 +0100)] 
cgroups.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document 'release_agent' mount option
Michael Kerrisk [Tue, 9 Jan 2018 19:48:48 +0000 (20:48 +0100)] 
cgroups.7: Document 'release_agent' mount option

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Rework text on threads and cgroups v2
Michael Kerrisk [Tue, 9 Jan 2018 19:35:17 +0000 (20:35 +0100)] 
cgroups.7: Rework text on threads and cgroups v2

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: wfix
Michael Kerrisk [Tue, 9 Jan 2018 19:28:40 +0000 (20:28 +0100)] 
cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: wfix
Michael Kerrisk [Tue, 9 Jan 2018 18:51:36 +0000 (19:51 +0100)] 
cgroups.7: wfix

Reported-by: Roman Gushchin <guro@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix: remove FIXME
Michael Kerrisk [Mon, 8 Jan 2018 23:20:08 +0000 (00:20 +0100)] 
cgroups.7: srcfix: remove FIXME

Tejun noted that his statement wasn't correct.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document cgroup v2 delegation via the 'nsdelegate' mount option
Michael Kerrisk [Mon, 8 Jan 2018 23:19:02 +0000 (00:19 +0100)] 
cgroups.7: Document cgroup v2 delegation via the 'nsdelegate' mount option

Reviewed-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Modify cgroup v2 delegation subheading
Michael Kerrisk [Mon, 8 Jan 2018 21:50:57 +0000 (22:50 +0100)] 
cgroups.7: Modify cgroup v2 delegation subheading

We are about to add description of a different kind
of delegation (nsdelegate) with its own subheading.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add a subheading for delegation containment rules
Michael Kerrisk [Mon, 8 Jan 2018 21:49:43 +0000 (22:49 +0100)] 
cgroups.7: Add a subheading for delegation containment rules

This is useful in preparation for adding discussion of the
'nsdelegate' mount option.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document /sys/kernel/cgroup/features
Michael Kerrisk [Mon, 8 Jan 2018 20:53:30 +0000 (21:53 +0100)] 
cgroups.7: Document /sys/kernel/cgroup/features

Reviewed-by: Roman Gushchin <guro@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document /sys/kernel/cgroup/delegate
Michael Kerrisk [Mon, 8 Jan 2018 20:43:56 +0000 (21:43 +0100)] 
cgroups.7: Document /sys/kernel/cgroup/delegate

Reviewed-by: Roman Gushchin <guro@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agosysfs.5: Refer to cgroups(7) for information about files in /sys/kernel/cgroup
Michael Kerrisk [Mon, 8 Jan 2018 20:19:14 +0000 (21:19 +0100)] 
sysfs.5: Refer to cgroups(7) for information about files in /sys/kernel/cgroup

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Note Linux 4.11 changes to cgroup v2 delegation containment rules
Michael Kerrisk [Mon, 8 Jan 2018 19:43:44 +0000 (20:43 +0100)] 
cgroups.7: Note Linux 4.11 changes to cgroup v2 delegation containment rules

See kernel commit 576dd464505fc53d501bb94569db76f220104d28

Reported-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix: Remove FIXME
Michael Kerrisk [Mon, 8 Jan 2018 18:33:45 +0000 (19:33 +0100)] 
cgroups.7: srcfix: Remove FIXME

Tejun Heo confirmed that the existing text is correct.

Reported-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Tweak the description of delegation of cgroup.subtree_control
Michael Kerrisk [Mon, 8 Jan 2018 18:27:11 +0000 (19:27 +0100)] 
cgroups.7: Tweak the description of delegation of cgroup.subtree_control

Reported-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Remove bogus "constraint" relating to thread mode
Michael Kerrisk [Fri, 5 Jan 2018 06:19:52 +0000 (07:19 +0100)] 
cgroups.7: Remove bogus "constraint" relating to thread mode

Existing cgroups under threaded root *must*, by definition,
be either domain or part of threaded subtrees, so this is not
a constraint on the creation of threaded subtrees.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Minor tweaks to text on cgroup.stat
Michael Kerrisk [Wed, 3 Jan 2018 00:37:53 +0000 (01:37 +0100)] 
cgroups.7: Minor tweaks to text on cgroup.stat

Reported-by: Roman Gushchin <guro@fb.com>
Reviewed-by: Roman Gushchin <guro@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix: FIXME (nsdelegate)
Michael Kerrisk [Tue, 2 Jan 2018 19:13:03 +0000 (20:13 +0100)] 
cgroups.7: srcfix: FIXME (nsdelegate)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: wfix
Michael Kerrisk [Tue, 2 Jan 2018 19:08:44 +0000 (20:08 +0100)] 
cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix FIXME
Michael Kerrisk [Tue, 2 Jan 2018 17:56:29 +0000 (18:56 +0100)] 
cgroups.7: srcfix FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix: FIXME
Michael Kerrisk [Tue, 2 Jan 2018 17:19:18 +0000 (18:19 +0100)] 
cgroups.7: srcfix: FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: srcfix FIXME
Michael Kerrisk [Tue, 2 Jan 2018 17:10:37 +0000 (18:10 +0100)] 
cgroups.7: srcfix FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Minor tweak to text on v2 delegation
Michael Kerrisk [Tue, 2 Jan 2018 17:02:20 +0000 (18:02 +0100)] 
cgroups.7: Minor tweak to text on v2 delegation

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Minor fix
Michael Kerrisk [Thu, 28 Dec 2017 20:33:49 +0000 (21:33 +0100)] 
cgroups.7: Minor fix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Add some section (SH) headings
Michael Kerrisk [Wed, 27 Dec 2017 21:29:32 +0000 (22:29 +0100)] 
cgroups.7: Add some section (SH) headings

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document cgroups v2 "thread mode"
Michael Kerrisk [Mon, 25 Dec 2017 20:47:34 +0000 (21:47 +0100)] 
cgroups.7: Document cgroups v2 "thread mode"

Reviewed-by: Tejun Heo <tj@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Mention the existence of "thread mode" in Linux 4.14
Michael Kerrisk [Mon, 25 Dec 2017 16:20:48 +0000 (17:20 +0100)] 
cgroups.7: Mention the existence of "thread mode" in Linux 4.14

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document the cgroup.max.depth and cgroup.max.descendants files
Michael Kerrisk [Wed, 27 Dec 2017 19:28:39 +0000 (20:28 +0100)] 
cgroups.7: Document the cgroup.max.depth and cgroup.max.descendants files

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: Document cgroups v2 cgroup.stat file
Michael Kerrisk [Wed, 27 Dec 2017 18:20:55 +0000 (19:20 +0100)] 
cgroups.7: Document cgroups v2 cgroup.stat file

Based on the text in Documentation/cgroup-v2.txt.

Reviewed-by: Roman Gushchin <guro@fb.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocgroups.7: wfix
Michael Kerrisk [Wed, 27 Dec 2017 06:33:52 +0000 (07:33 +0100)] 
cgroups.7: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agounshare.2: Minor fix in example (remove redundant text)
Michael Kerrisk [Tue, 9 Jan 2018 23:22:23 +0000 (00:22 +0100)] 
unshare.2: Minor fix in example (remove redundant text)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoperf_event_open.2: SEE ALSO: add perf(1)
Michael Kerrisk [Tue, 9 Jan 2018 21:30:04 +0000 (22:30 +0100)] 
perf_event_open.2: SEE ALSO: add perf(1)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agosched.7: Correctly describe effect of priority changes for RT threads
Michael Kerrisk [Tue, 19 Dec 2017 09:25:00 +0000 (10:25 +0100)] 
sched.7: Correctly describe effect of priority changes for RT threads

The placement of a thread in the run queue for its new
priority depends on the direction of movement in priority.
(This appears to contradict POSIX, except in the case of
pthread_setschedprio().)

As reported by Andrea, and followed up by me:

> I point out that the semantics of sched_setscheduler(2) for RT threads
> indicated in sched(7) and, in particular, in
>
>    "A call to sched_setscheduler(2), sched_setparam(2), or
>     sched_setattr(2) will put the SCHED_FIFO (or SCHED_RR) thread
>     identified by pid at the start of the list if it was runnable."
>
> does not "reflect" the current implementation of this syscall(s) that, in
> turn; based on the source, I think a more appropriate description of this
> semantics would be:
>
>    "... the effect on its position in the thread list depends on the
>     direction  of the modification, as follows:
>
>       a. if the priority is raised, the thread becomes the tail of the
>          thread list.
>       b. if the priority is unchanged, the thread does not change position
>          in the thread list.
>       c. if the priority is lowered, the thread becomes the head of the
>          thread list."
>
> (copied from
> http://pubs.opengroup.org/onlinepubs/9699919799/functions/V2_chap02.html#tag_15_08_04_01
> ).

So, I did some testing, and can confirm that the above is the behavior
on Linux for changes to scheduling priorities for RT processes.
(My tests consisted of creating a multithreaded process where all
threads are confined to the same CPU with taskset(), and each thread
is in a CPU-bound loop. I then maipulated their priorities with
chrt(1) and watched the CPU time being consumed with ps(1).)

Back in SUSv2 there was this text:

[[
6. If a thread whose policy or priority has been modified is a running
thread or is runnable, it then becomes the tail of the thread list for
its new priority.
]]

And certainly Linux used to behave this way. I remember testing it,
and when one looks at the Linux 2.2 source code for example, one can
see that there is a call to move_first_runqueue() in this case. At some
point, things changed, and I have not investigated exactly where that
change occurred (but I imagine it was quite a long time ago).

Looking at SUSv4, let's expand the range of your quote, since
point 7 is interesting. Here's text from Section 2.8.4
"Process Scheduling" in POSIX.1-2008/SUSv4 TC2:

[[
7. If a thread whose policy or priority has been modified other
   than by pthread_setschedprio() is a running thread or is runnable,
   it then becomes the tail of the thread list for its new priority.
8. If a thread whose priority has been modified by pthread_setschedprio()
   is a running thread or is runnable, the effect on its position in the
   thread list depends on the direction of the modification, as follows:
   a. If the priority is raised, the thread becomes the tail of the
      thread list.
   b. If the priority is unchanged, the thread does not change position
      in the thread list.
   c. If the priority is lowered, the thread becomes the head of the
      thread list.
]]

(Note that the preceding points mention variously sched_setscheduler(),
sched_setsparam(), and pthread_setschedprio(), so that the mention of
just pthread_setschedprio() in points 7 and 8 is significant.)

Now, since chrt(1) uses sched_setscheduler(), rather than
pthread_setschedprio(), then arguably the Linux behavior is a
violation of POSIX. (Indeed, buried in the man-pages source, I find
that I many years ago wrote the comment:

    In 2.2.x and 2.4.x, the thread is placed at the front of the queue
    In 2.0.x, the Right Thing happened: the thread went to the back -- MTK

But the Linux behavior seems reasonable to me and I'm inclined
to just document it (see the patch below).

Reported-by: Andrea Parri <parri.andrea@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agosendmmsg.2: Minot tweaks
Michael Kerrisk [Tue, 9 Jan 2018 18:44:26 +0000 (19:44 +0100)] 
sendmmsg.2: Minot tweaks

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agorecvmmsg.2, sendmmsg.2: Point out that error handling is unreliable
Nikola Forró [Tue, 9 Jan 2018 13:54:09 +0000 (14:54 +0100)] 
recvmmsg.2, sendmmsg.2: Point out that error handling is unreliable

If an error occurs after at least one message has been received,
recvmmsg() call succeeds, and returns the number of messages
received.  The error code is expected to be returned on a
subsequent call.  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.

If an error occurs after at least one message has been sent,
sendmmsg() call succeeds, and returns the number of messages sent.
The error code is lost. The caller can retry the transmission,
starting at 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.

Reference:
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux-stable.git/tree/net/socket.c

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocopy_file_range: glibc provides a user-space emulation where the system call is absent
Shawn Landden [Mon, 1 Jan 2018 04:12:59 +0000 (20:12 -0800)] 
copy_file_range: glibc provides a user-space emulation where the system call is absent

Signed-off-by: Shawn Landden <slandden@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocopy_file_range.2: ERRORS: add EISDIR
Michael Kerrisk [Mon, 8 Jan 2018 23:55:07 +0000 (00:55 +0100)] 
copy_file_range.2: ERRORS: add EISDIR

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocopy_file_range.2: Order ERRORS alphabetically
Michael Kerrisk [Mon, 8 Jan 2018 23:53:13 +0000 (00:53 +0100)] 
copy_file_range.2: Order ERRORS alphabetically

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agocopy_file_range.2: EFBIG errors are possible, similar to write(2)
Florian Weimer [Wed, 3 Jan 2018 13:00:35 +0000 (14:00 +0100)] 
copy_file_range.2: EFBIG errors are possible, similar to write(2)

Signed-off-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agotime.1: wfix
Michael Kerrisk [Sun, 7 Jan 2018 17:00:24 +0000 (18:00 +0100)] 
time.1: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agopthread_mutexattr_setrobust.3: wfix
Michael Kerrisk [Sat, 6 Jan 2018 22:20:46 +0000 (23:20 +0100)] 
pthread_mutexattr_setrobust.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agodl_iterate_phdr.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:16:04 +0000 (23:16 +0100)] 
dl_iterate_phdr.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agobasename.3: wfix
Michael Kerrisk [Sat, 6 Jan 2018 22:13:42 +0000 (23:13 +0100)] 
basename.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agolistxattr.2: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:09:42 +0000 (23:09 +0100)] 
listxattr.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agogetrlimit.2: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:07:18 +0000 (23:07 +0100)] 
getrlimit.2: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agolocaledef.1: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:05:19 +0000 (23:05 +0100)] 
localedef.1: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agogetnameinfo.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:03:46 +0000 (23:03 +0100)] 
getnameinfo.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoldconfig.8: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:02:42 +0000 (23:02 +0100)] 
ldconfig.8: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agold.so.8: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:02:17 +0000 (23:02 +0100)] 
ld.so.8: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoudplite.7: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:01:21 +0000 (23:01 +0100)] 
udplite.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agopty.7: ffix
Michael Kerrisk [Sat, 6 Jan 2018 22:00:52 +0000 (23:00 +0100)] 
pty.7: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoutmp.5: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:59:46 +0000 (22:59 +0100)] 
utmp.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agonologin.5: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:58:57 +0000 (22:58 +0100)] 
nologin.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agomotd.5: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:58:42 +0000 (22:58 +0100)] 
motd.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoissue.5: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:58:25 +0000 (22:58 +0100)] 
issue.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agogroup.5: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:58:04 +0000 (22:58 +0100)] 
group.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agovcs.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:57:38 +0000 (22:57 +0100)] 
vcs.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agottyS.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:57:18 +0000 (22:57 +0100)] 
ttyS.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agotty.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:56:56 +0000 (22:56 +0100)] 
tty.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agost.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:56:40 +0000 (22:56 +0100)] 
st.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agosd.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:55:44 +0000 (22:55 +0100)] 
sd.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agortc.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:55:22 +0000 (22:55 +0100)] 
rtc.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agorandom.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:54:02 +0000 (22:54 +0100)] 
random.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoram.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:53:39 +0000 (22:53 +0100)] 
ram.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agolp.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:53:12 +0000 (22:53 +0100)] 
lp.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoloop.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:52:57 +0000 (22:52 +0100)] 
loop.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agohd.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:52:15 +0000 (22:52 +0100)] 
hd.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agofull.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:52:00 +0000 (22:52 +0100)] 
full.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agofd.4: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:51:41 +0000 (22:51 +0100)] 
fd.4: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoresolver.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:51:26 +0000 (22:51 +0100)] 
resolver.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agoinitgroups.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:50:06 +0000 (22:50 +0100)] 
initgroups.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agogetutent.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:49:28 +0000 (22:49 +0100)] 
getutent.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agogetmntent.3: ffix
Michael Kerrisk [Sat, 6 Jan 2018 21:48:20 +0000 (22:48 +0100)] 
getmntent.3: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
6 years agofgetpwent.3: Add missing ATTRIBUTES preamble
Michael Kerrisk [Sat, 6 Jan 2018 21:46:28 +0000 (22:46 +0100)] 
fgetpwent.3: Add missing ATTRIBUTES preamble

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