0a26e2d352
epoll.7: wfix: break a sentence up, for clarity
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23 09:58:22 +01:00
733192cba6
poll.2: srcfix: Amend copyright
...
By now, I've written or rewritten pretty much the entire page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23 09:58:22 +01:00
342819c832
poll.2: Improve description of EFAULT error
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23 09:58:22 +01:00
8bcfd68889
poll.2: Fix description of ENOMEM error
...
No file descriptors are being allocated...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23 09:58:22 +01:00
836efc18d7
poll.2: Add an example program
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-23 09:58:22 +01:00
83bb822c4f
poll.2: Mention epoll(7) in the introductory paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
6c485bbb3a
poll.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
4628e3eca7
select.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
602b388d07
select.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
95a85f1438
select.2: Note that FD_SET() and FD_CLR() do not return errors
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
a84ed70098
select.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
0a4d109d22
select.2: Consolidate historical glibc pselect() details under one subhead
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
d221e421a5
select.2: Place the discussion of the self-pipe technique in a headed subsection
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
73e8f3b4c1
select_tut.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-19 09:38:22 +01:00
4551a1b1d1
select_tut.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
a1f163d6c0
select_tut.2: wfix: break up a long paragraph
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
97a5a8d838
select_tut.2: Adjust header file includes in example
...
Employ <sys/select.h>, rather than the historical header files.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
21677b1bb5
select_tut.2: SEE ALSO: shorten this list
...
select(2) already lists most of these.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
82cf8e8850
select_tut.2: RETURN VALUE: defer to select(2)
...
Defer to select(2), rather than repeating the information
in this page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
c9a275a703
select_tut.2: DESCRIPTION: defer to select(2)
...
Avoid duplicating the same information in two pages.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
b3b45b2b16
select_tut.2: SYNOPSIS: defer to select(2), rather than repeating the same info
...
Remove the prototypes, which are detailed in select(2).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
095d8388cf
select.2: Rewrite DESCRIPTION
...
Improve structure and readability, at the same time incorporating
text and details that were formerly in select_tut(2). Also
move a few details in other parts of the page into DESCRIPTION.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 22:59:35 +01:00
f7cd286592
select.2: Minor wording fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 11:55:51 +01:00
e5704b1a7a
select.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 11:55:51 +01:00
b397824f99
select.2: srcfix: add myself to copyright
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 11:55:51 +01:00
bd89babbed
select.2, select_tut.2: Consolidate info on usleep() emulation in one place
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 11:55:51 +01:00
a63fef4359
select.2: Remove details of historical #include requirements
...
The POSIX situation has been the norm for a long time now,
and including ancient details overcomplicates the page.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 11:55:51 +01:00
f0e902c3a1
select.2: Remove some ancient information about pre-POSIX types for 'timeout'
...
The discussion about pre-POSIX types for 'timeval' and 'timespec'
is rather old, and these days serves mainly to complicate the
page. Remove it.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 10:14:13 +01:00
b8f8864d29
select.2: Minor fix: add forward reference to 'timeval' description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 10:14:13 +01:00
01901530b2
select.2: Consolidate the discussion of pselect into a headed subsection
...
The current text layout is a little hard to parse, with details of
pselect() spread in the main description. Move some of that text
to a headed subsection, and add a one-sentence introduction
describing the purpose of pselect().
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 10:14:13 +01:00
1eda1a3a5b
select.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-18 08:40:54 +01:00
2054c92aa1
syscalls.2: Add new Linux 5.6 system calls
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-15 23:18:58 +01:00
3b31da1a4d
Start of man-pages-5.06: updating Changes and Changes.old
2020-02-09 17:49:10 +01:00
dbf7b7abb6
Start of man-pages-5.06: updating .Announce and .lsm files
2020-02-09 17:49:10 +01:00
647ac92b7f
Start of man-pages-5.06: renaming .Announce and .lsm files
2020-02-09 17:49:10 +01:00
512669dce1
Ready for 5.05
2020-02-09 12:24:58 +01:00
6b621d05b3
_exit.2, capget.2, fcntl.2, futex.2, listen.2, memfd_create.2, modify_ldt.2, move_pages.2, open.2, perf_event_open.2, ptrace.2, set_thread_area.2, stime.2, syscall.2, sysctl.2, userfaultfd.2, cmsg.3, exit.3, ftime.3, getpt.3, malloc.3, console_codes.4, loop.4, inotify.7, netlink.7, packet.7, rtnetlink.7, tcp.7, unix.7, vsock.7, ldconfig.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-09 11:53:28 +01:00
c8f25a0524
Changes: Ready for 5.05
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-09 10:25:48 +01:00
93902a96eb
stime.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-09 10:25:48 +01:00
9ec6412745
malloc.3: Minor tweaks to Vegard Nossum's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 23:37:21 +01:00
813d606b00
malloc.3: realloc() return value
...
One might be tempted to think that realloc() always requests a new
allocation before moving the contents over (at least in the case
where the new size is bigger than the original). This is not the
case; for example, on my system the following program:
#include <stdlib.h>
#include <stdio.h>
#include <unistd.h>
int main(int argc, char *argv[])
{
void *x = malloc(15);
void *y = malloc(32);
printf("x = %p\n", x);
printf("y = %p\n", y);
printf("usable_size(x) = %lu\n", malloc_usable_size(x));
void *z = realloc(x, 24);
printf("z = %p\n", z);
return 0;
}
prints:
x = 0x1b3a010
y = 0x1b3a030
usable_size(x) = 24
z = 0x1b3a010
Signed-off-by: Vegard Nossum <vegard.nossum@oracle.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 23:37:10 +01:00
f3aa51b217
fcntl.2: Further tweaks to F_SEAL_FUTURE_WRITE text
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 14:10:31 +01:00
e15b10ba32
memfd_create.2: Minor tweaks's to Joel Fernandes's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 13:04:07 +01:00
fc6a14f557
memfd_create.2: srcfix: semantic line breaks
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 13:04:07 +01:00
98eff9f7e5
memfd_create.2: Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
...
More details of the seal can be found in the LKML patch:
https://lore.kernel.org/lkml/20181120052137.74317-1-joel@joelfernandes.org/T/#t
Signed-off-by: Joel Fernandes (Google) <joel@joelfernandes.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 13:04:07 +01:00
e1cd30eb5e
fcntl.2: Note kernel version for F_SEAL_FUTURE_WRITE
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 13:04:07 +01:00
e9a2c239b3
fcntl.2: Minor tweaks to Joel Fernandes's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 12:37:39 +01:00
9341a793d0
fcntl.2: srcfix: rewrap source lines
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 12:31:11 +01:00
e38bb9196d
fcntl.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 12:09:56 +01:00
7b7d3b200a
fcntl.2: Update manpage with new memfd F_SEAL_FUTURE_WRITE seal
...
More details of the seal can be found in the LKML patch:
https://lore.kernel.org/lkml/20181120052137.74317-1-joel@joelfernandes.org/T/#t
Signed-off-by: Joel Fernandes (Google) <joel@joelfernandes.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2020-02-08 12:09:07 +01:00
Michael Kerrisk