]> git.ipfire.org Git - thirdparty/man-pages.git/blob - Changes
Changes: Ready for 4.05
[thirdparty/man-pages.git] / Changes
1 ==================== Changes in man-pages-4.05 ====================
2
3 Released: ????-??-??, Munich
4
5
6 Contributors
7 ------------
8
9 The following people contributed patches/fixes or (noted in brackets
10 in the changelog below) reports, notes, and ideas that have been
11 incorporated in changes in this release:
12
13 Adhemerval Zanella <adhemerval.zanella@linaro.org>
14 Akihiro Suda <suda.kyoto@gmail.com>
15 Alan Aversa <alan.aversa@cox.net>
16 Alan Cox <etchedpixels@gmail.com>
17 Alec Leamas <leamas.alec@gmail.com>
18 Alex Henrie <alexhenrie24@gmail.com>
19 Alexander Miller <alex.miller@gmx.de>
20 Andreas Gruenbacher <agruenba@redhat.com>
21 Andreas Schwab <schwab@suse.de>
22 Anna Schumaker <Anna.Schumaker@Netapp.com>
23 Askar Safin <safinaskar@mail.ru>
24 Bill O. Gallmeister <bgallmeister@gmail.com>
25 Carlos O'Donell <carlos@redhat.com>
26 Chris Pick <kernel@chrispick.com>
27 Christoph Hellwig <hch@infradead.org>
28 Craig Gallek <kraig@google.com>
29 Darrick J. Wong <darrick.wong@oracle.com>
30 Davidlohr Bueso <dave@stgolabs.net>
31 Dmitry V. Levin <ldv@altlinux.org>
32 Dr. Tobias Quathamer <toddy@debian.org>
33 Eric Blake <eblake@redhat.com>
34 Eric Dumazet <edumazet@google.com>
35 Florian Weimer <fweimer@redhat.com>
36 Gabriel Corona <gabriel.corona@enst-bretagne.fr>
37 Heinrich Schuchardt <xypron.glpk@gmx.de>
38 Ivan Shapovalov <intelfx@intelfx.name>
39 Jakub Wilk <jwilk@jwilk.net>
40 Jason Baron <jbaron@akamai.com>
41 Jason Vas Dias <jason.vas.dias@gmail.com>
42 Jérémie Galarneau <jeremie.galarneau@efficios.com>
43 Jeremy Harris <jeharris@redhat.com>
44 Joachim Wuttke <j.wuttke@fz-juelich.de>
45 Joe Stein <joeaarons@gmail.com>
46 John Stultz <john.stultz@linaro.org>
47 Josh Triplett <josh@joshtriplett.org>
48 Kondo, Naoya <kondo-naoya@jp.fujitsu.com>
49 Krzysztof Adamski <k@japko.eu>
50 Manfred Spraul <manfred@colorfullife.com>
51 Marianne CHEVROT <blackmoor@openmailbox.org>
52 Marko Myllynen <myllynen@redhat.com>
53 Mark Post <mpost@suse.com>
54 Martin Gebert <Murphy.Gebert@gmx.de>
55 Mats Wichmann <mats@linuxfoundation.org>
56 Matt Zimmerman <mdz@debian.org>
57 Michael Kerrisk <mtk.manpages@gmail.com>`
58 Mike Frysinger <vapier@gentoo.org>
59 Minchan Kim <minchan@kernel.org>
60 Naoya Kondo <kondo-naoya@jp.fujitsu.com>
61 Naresh Kamboju <naresh.kernel@gmail.com>
62 Nikola Forró <nforro@redhat.com>
63 Nikos Mavrogiannopoulos <nmav@gnutls.org>
64 Orion Poplawski <orion@cora.nwra.com>
65 Pakin Yury <zxwarior@yandex.ru>
66 Patrick Donnelly <batrick@batbytes.com>
67 Paul Eggert <eggert@cs.ucla.edu>
68 Paul Pluzhnikov <ppluzhnikov@google.com>
69 Peter Hurley <peter@hurleysoftware.com>
70 Peter Wu <peter@lekensteyn.nl>
71 Petr Gajdos <pgajdos@suse.cz>
72 Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
73 Rasmus Villemoes <Rasmus.Villemoes@decode.is>
74 Rich Felker <dalias@aerifal.cx>
75 Simon Que <sque@chromium.org>
76 Stephan Bergmann <sbergman@redhat.com>
77 Stéphane Aulery <lkppo@free.fr>
78 Stephen Hurd <shurd@sasktel.net>
79 Vincent Bernat <bernat@luffy.cx>
80 William Preston <wpreston@suse.de>
81 Yuri Kozlov <yuray@komyakino.ru>
82 Zefram <zefram@fysh.org>
83
84 Apologies if I missed anyone!
85
86
87 New and rewritten pages
88 -----------------------
89
90 copy_file_range.2
91 Anna Schumaker [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
92 New page documenting copy_file_range()
93 copy_file_range() is a new system call for copying ranges of data
94 completely in the kernel. This gives filesystems an opportunity to
95 implement some kind of "copy acceleration", such as reflinks or
96 server-side-copy (in the case of NFS).
97
98 personality.2
99 Michael Kerrisk
100 This page has been greatly expanded, to add descriptions of
101 personality domains.
102
103 fmemopen.3
104 Michael Kerrisk [Adhemerval Zanella]
105 Significant reworking of this page:
106 * Rework discussion of the (obsolete) binary mode
107 * Split open_memstream(3) description into a separate page.
108 * Note various fmemopen() bugs that were fixed in glibc 2.22
109 * Greatly expand description of 'mode' argument
110 * Rework description of 'buf' and 'len' arguments
111 * Expand discussion of "current position" for fmemopen() stream
112
113 ntp_gettime.3
114 Michael Kerrisk
115 New page describing ntp_gettime(3) and ntp_gettimex(3)
116
117 open_memstream.3
118 Michael Kerrisk
119 New page created by split of fmemopen(3).
120 At the same time, add and rework a few details in the text.
121
122 posix_spawn.3
123 Bill O. Gallmeister, Michael Kerrisk
124 New man page documenting posix_spawn(3) and posix_spawnp(3)
125
126 readdir.3
127 Michael Kerrisk [Florian Weimer]
128 Split readdir_r() content into separate page
129 As suggested by Florian Weimer:
130
131 It may make sense to move this documentation to a separate
132 manual page, specific to readdir_r. This will keep the
133 readdir() documentation nice and crisp. Most programmers
134 will never have to consult all these details.
135 Michael Kerrisk
136 Near complete restructuring of the page and add some further details
137 Michael Kerrisk [Florian Weimer, Rich Felker, Paul Eggert]
138 Add a lot more detail on portable use of the 'd_name' field
139
140 readdir_r.3
141 Michael Kerrisk [Florian Weimer]
142 New page created after split of readdir(3).
143 Michael Kerrisk [Florian Weimer]
144 Explain why readdir_r() is deprecated and readdir() is preferred
145 Michael Kerrisk [Florian Weimer]
146 Remove misleading code example using pathconf()
147
148 lirc.4
149 Alec Leamas
150 New page documenting lirc device driver
151
152
153 Newly documented interfaces in existing pages
154 ---------------------------------------------
155
156 adjtimex.2
157 Michael Kerrisk
158 Document ntp_adjtime(3)
159
160 epoll_ctl.2
161 Michael Kerrisk [Jason Baron]
162 Document EPOLLEXCLUSIVE
163
164 madvise.2
165 Minchan Kim [Michael Kerrisk]
166 Document MADV_FREE
167 Document the MADV_FREE flag added to madvise() in Linux 4.5.
168
169 proc.5
170 Michael Kerrisk
171 Document CmaTotal and CmaFree fields of /proc/meminfo
172 Michael Kerrisk
173 Document additional /proc/meminfo fields
174 Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
175 Michael Kerrisk
176 Document MemAvailable /proc/meminfo field
177 Michael Kerrisk
178 Document inotify /proc/PID/fdinfo entries
179 Michael Kerrisk
180 Document fanotify /proc/PID/fdinfo entries
181 Michael Kerrisk
182 Add some kernel version numbers for /proc/PID/fdinfo entries
183 Michael Kerrisk [Patrick Donnelly]
184 /proc/PID/fdinfo displays the setting of the close-on-exec flag
185 Note also the pre-3.1 bug in the display of this info.
186
187 socket.7
188 Craig Gallek [Michael Kerrisk, Vincent Bernat]
189 Document some BPF-related socket options
190 Document the behavior and the first kernel version for each of the
191 following socket options:
192
193 SO_ATTACH_FILTER
194 SO_ATTACH_BPF
195 SO_ATTACH_REUSEPORT_CBPF
196 SO_ATTACH_REUSEPORT_EBPF
197 SO_DETACH_FILTER
198 SO_DETACH_BPF
199 SO_LOCK_FILTER
200
201
202 New and changed links
203 ---------------------
204
205 isalpha_l.3
206 Michael Kerrisk
207 New link to isalpha.3
208
209 longjmp.3
210 Michael Kerrisk
211 Replace page with link to setjmp(3), which now incorporates longjmp()
212
213 ntp_adjtime.3
214 Michael Kerrisk
215 New link to adjtimex(2)
216
217 ntp_gettimex.3
218 Michael Kerrisk
219 New link to ntp_gettime.3
220
221 open_wmemstream.3
222 Michael Kerrisk
223 Update link to point to new open_memstream(2) page
224
225 posix_spawnp.3
226 Michael Kerrisk
227 New link to new posix_spawn.3 page
228
229 siglongjmp.3
230 Michael Kerrisk
231 Rewire link to point to setjmp(3)
232
233 strerror_l.3
234 Michael Kerrisk
235 New link to strerror.3
236 Fix missing link
237
238
239 Global changes
240 --------------
241
242 Various pages
243 Michael Kerrisk
244 Update FTM requirements (_DEFAULT_SOURCE)
245 Michael Kerrisk
246 Update feature test macro requirements
247 Update to use _DEFAULT_SOURCE, and also changes brought by
248 glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
249
250 Various pages
251 Michael Kerrisk
252 Simplify FTM requirements
253 Looking at <features.h> (or feature_test_macros(7)), one can
254 see that when _XOPEN_SOURCE is defined with the value 700
255 (or greater), then _POSIX_C_SOURCE is defined with the value
256 200809L (or greater). Therefore, terms in the man pages such as
257
258 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
259
260 can be simplified to:
261
262 _POSIX_C_SOURCE\ >=\ 200809L
263
264 Various pages
265 Michael Kerrisk
266 Simplify FTM requirements
267 Looking at <features.h> (or feature_test_macros(7)), one can
268 see that when _XOPEN_SOURCE is defined with the value 600
269 (or greater), then _POSIX_C_SOURCE is defined with the value
270 200112L (or greater). Therefore, terms in the man pages such as
271
272 _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
273
274 can be simplified to:
275
276 _POSIX_C_SOURCE\ >=\ 200112L
277
278 Various pages
279 Michael Kerrisk
280 Simplify FTM requirements
281 _XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
282 requirements in various pages.
283
284 Various pages
285 Michael Kerrisk
286 Remove "or 'cc -std=c99'" from SYNOPSIS
287 Under the FTM requirements all of these pages document the
288 requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
289 documents that "cc -std=c99" produces the same effect as defining
290 _ISOC99_SOURCE. So, all of these pages don't additionally need
291 to specify "or 'cc -std=c99'" under the FTM requirements
292 in the SYNOPSIS. Removing that redundant text also simplifies
293 the SYNOPSIS a little.
294
295 Various pages
296 Michael Kerrisk
297 Simplify FTM requirements
298 Looking at <features.h> (or feature_test_macros(7)), one can
299 see that when _XOPEN_SOURCE is defined with the value 600
300 (or greater), then _POSIX_C_SOURCE is defined with the value
301 200112L (or greater). Therefore, terms in the man pages such as
302
303 _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
304
305 can be simplified to:
306
307 _POSIX_C_SOURCE\ >=\ 200112L
308
309 Various pages
310 Michael Kerrisk
311 Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
312 _XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
313 subsequent standards). _XOPEN_SOURCE >= 500 produces the same
314 effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
315 the SYNOPSIS of various ages that contain:
316
317 _XOPEN_SOURCE\ >=\ 500 ||
318 _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
319
320 to just:
321
322 _XOPEN_SOURCE\ >=\ 500
323
324 This has the following benefits:
325
326 a) Simplifying the SYNOPSIS by removing ancient
327 historical information.
328
329 b) Preventing users from being misled into using
330 _XOPEN_SOURCE_EXTENDED in new source code.
331
332 Various pages
333 Michael Kerrisk
334 Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
335 _POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
336 obsolete bu _POSIX_C_SOURCE. Retaining mention of it
337 in the feature test macro requirements section of the
338 SYNOPSIS doesn't contain important information, and may
339 mislead readers into actually trying to use this macro.
340 A few mentions of it are maintained in a some pages where
341 defining _POSIX_SOURCE inhibits some behavior.
342
343 Various sockets-related pages
344 Michael Kerrisk [Carlos O'Donell]
345 Use consistent argument/variable names for socket addresses and lengths
346 As noted by Carlos, there's quite a bit of inconsistency across
347 pages. Use 'addr' and 'addrlen' consistently in variables and
348 function arguments.
349
350 Various pages
351 Michael Kerrisk
352 Wording fix: "current file offset" ==> "file offset"
353 "File offset" is the preferred POSIX terminology.
354
355 Various pages
356 Michael Kerrisk
357 Word "descriptor" more precisely
358 Use either "file descriptor" or message queue descriptor".
359
360 Various pages
361 Michael Kerrisk
362 ERRORS: add reference to signal(7) in description of EINTR
363
364
365 Changes to individual pages
366 ---------------------------
367
368 locale.1
369 Marko Myllynen
370 Add "locale -c charmap" as an example
371 Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.
372
373 localedef.1
374 Marko Myllynen
375 Add hint on purpose of --no-archive
376 Indicate why using --no-archive might be a good idea. The issue
377 is that if you create a custom locale with localedef(1) and put
378 it to the locale archive then during the next glibc upgrade the
379 locale archive is updated as well and your custom locale is gone.)
380
381 accept.2
382 Michael Kerrisk
383 ERRORS: improve description for EBADF
384
385 adjtimex.2
386 Michael Kerrisk [John Stultz]
387 Various improvements after feedback from John Stultz
388 Michael Kerrisk
389 Remove FTM requirements
390 It seems that adjtimex() never needed _BSD_SOURCE (and my
391 earlier commit 5918743bc8b02b was simply a blunder).
392 Michael Kerrisk
393 Split EINVAL error cases
394 Michael Kerrisk
395 Note treatment of out-of-range buf.offset
396 Michael Kerrisk
397 Don't refer reader to adjtime(3)
398 Probably, it's not wise to suggest adjtime(3) as the more
399 portable API. Rather, ntp_adjtime(3) should be used.
400 Michael Kerrisk [Naresh Kamboju]
401 Update details of buf.offset EINVAL error
402 Michael Kerrisk
403 SEE ALSO: add ntp_gettime(3)
404 Michael Kerrisk
405 Improve description of some PPS timex fields
406 Michael Kerrisk
407 Add ATTRIBUTES section
408 William Preston [Petr Gajdos]
409 Update a detail in adjtimex return value description
410 Michael Kerrisk
411 Note range constraints and clamping for ADJ_FREQUENCY
412
413 bdflush.2
414 Michael Kerrisk
415 Note that glibc support for this system call went away in version 2.23
416
417 bind.2
418 Michael Kerrisk
419 Improve description of ENOENT error
420
421 bpf.2
422 Michael Kerrisk
423 Document close-on-exec semantics
424 The close-on-exec file descriptor flag is automatically enabled
425 for FDs returned by bpf().
426
427 chmod.2
428 Michael Kerrisk
429 Clarify terminology (file mode versus file permission bits)
430
431 chown.2
432 Michael Kerrisk
433 ERRORS: improve EBADF description
434
435 clone.2
436 unshare.2
437 Michael Kerrisk
438 Remove mention of _BSD_SOURCE and _SVID_SOURCE
439 The right way to expose declarations for these Linux-specific
440 system calls was always _GNU_SOURCE. Mentioning the historical
441 use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.
442
443 connect.2
444 Michael Kerrisk
445 ERRORS: improve EBADF description
446
447 create_module.2
448 Michael Kerrisk
449 Glibc 2.23 removed last vestiges of support for this system call
450
451 delete_module.2
452 Michael Kerrisk
453 Glibc 2.23 removed last vestiges of support for this system call
454
455 epoll_ctl.2
456 Michael Kerrisk
457 Document ELOOP error for circular monitoring loops
458
459 eventfd.2
460 Michael Kerrisk
461 Note that eventfd info is available in /proc/PID/fdinfo
462
463 execve.2
464 Michael Kerrisk [Krzysztof Adamski]
465 Add EPERM error for capabilities check of capability-dumb binaries
466 Michael Kerrisk
467 Add reference to ld-linux.so(8)
468 Michael Kerrisk
469 SEE ALSO: add system(3)
470
471 fanotify_init.2
472 Michael Kerrisk
473 Note kernel version that allowed O_CLOEXEC for event_f_flags
474
475 fcntl.2
476 flock.2
477 Michael Kerrisk
478 SEE ALSO: add lslocks(8)
479
480 fcntl.2
481 Michael Kerrisk [Jason Vas Dias]
482 Rework description of F_SETOWN
483 As suggested by Jason, make it clearer that I/O signalling
484 requires the use of both F_SETOWN and O_ASYNC. While we're at,
485 make a few other cleanups to the text.
486 Michael Kerrisk
487 Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN
488 This usage went away in glibc 2.20, and the simplest remedy
489 is just to omit mention of it.
490
491 futex.2
492 Michael Kerrisk
493 FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
494
495 get_kernel_syms.2
496 Michael Kerrisk
497 Note that glibc des not support this system call
498
499 init_module.2
500 Michael Kerrisk
501 Glibc 2.23 removed last vestiges of support for this system call
502
503 ioctl_list.2
504 Heinrich Schuchardt
505 Include uapi/linux/wireless.h
506 Add the list of wireless IOCTLs.
507 Heinrich Schuchardt
508 Path to sockios.h
509 sockios.h is now in include/uapi
510 Heinrich Schuchardt
511 Add reference to netdevice.7
512 netdevice.7 describes most of the IOCTLs of sockios.h
513 Heinrich Schuchardt
514 Transfer structure (wireless.h IOCTLs)
515 The sole parameter to be passed to the wireless.h IOCTLs is
516 of type struct iwreq *.
517
518 ioperm.2
519 Michael Kerrisk [Alex Henrie]
520 ioperm.2: Permissions are inherited across fork(2)
521 See https://bugzilla.kernel.org/show_bug.cgi?id=99911
522
523 iopl.2
524 Michael Kerrisk [Alex Henrie]
525 Permissions are not inherited across fork(2) or preserved on execve(2)
526 See https://bugzilla.kernel.org/show_bug.cgi?id=99901
527
528 lseek.2
529 Michael Kerrisk
530 FUSE now supports SEEK_HOLE and SEEK_DATA
531 Michael Kerrisk
532 NFS supports SEEK_HOLE and SEEK_DATA
533
534 Michael Kerrisk
535 SEE ALSO: add open(2)
536
537 madvise.2
538 Michael Kerrisk
539 Clarify MADV_HWPOISON wording to say that it applies to a page range
540
541 mknod.2
542 Michael Kerrisk
543 SEE ALSO: add mknod(1)
544
545 mount.2
546 Michael Kerrisk
547 SEE ALSO: add findmnt(8)
548
549 open.2
550 Michael Kerrisk
551 NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
552 Mark Post [Petr Gajdos]
553 O_TMPFILE support is now provided bt Btrfs
554
555 pipe.2
556 Michael Kerrisk [Eric Blake]
557 Note treatment of 'pipefd' on error
558
559 poll.2
560 Michael Kerrisk [Josh Triplett]
561 Document spurious EAGAIN error that can occur on other systems
562 Light reworking of text proposed by Josh Triplett.
563
564 readlink.2
565 Michael Kerrisk
566 Clarify EINVAL error description
567
568 recv.2
569 Heinrich Schuchardt
570 Equivalence to read()
571 Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
572 equivalences for zero-valued arguments.
573 Michael Kerrisk
574 MSG_WAITALL has no effect for datagram sockets
575
576 recv.2
577 cmsg.3
578 Nikola Forró
579 Fix type of cmsg_len member of cmsghdr structure
580 The type shown for cmsg_len member of cmsghdr structure is socklen_t,
581 but the actual type used by glibc and the kernel is size_t.
582 The information was obtained from glibc source code:
583 http://bit.ly/21m1RMp
584 Michael Kerrisk
585 Note that cmsg_len is typed as socklen_t in POSIX.1
586
587
588 sched_setaffinity.2
589 Michael Kerrisk [Florian Weimer, Florian Weimer]
590 Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
591 Michael Kerrisk [Florian Weimer]
592 Add reference to CPU_ALLOC(3)
593
594 sched_setattr.2
595 Michael Kerrisk [Akihiro Suda]
596 EPERM depends on affinity mask of target thread, not calling thread
597
598 select.2
599 Michael Kerrisk [Josh Triplett]
600 Document spurious EAGAIN error that can occur on other systems
601 Light reworking of text proposed by Josh Triplett.
602 Nikos Mavrogiannopoulos
603 Mention the 'fd_set' size limitation early and refer to poll(2)
604 Change this because of the serious limitation of select()
605 imposing a limit on the range of file descriptors that can
606 be monitored. This is currently mentioned too late in the
607 documentation (in the NOTES section). The man page should
608 warn early and refer to poll(2) as soon as possible.
609 Michael Kerrisk
610 Add details on the glibc fixed-size fd_set limitation
611 No modern application should use select() on Linux.
612
613 select_tut.2
614 Michael Kerrisk
615 Some readability fixes to example program
616 Michael Kerrisk
617 Better variable names in example program
618 Michael Kerrisk
619 Simplify 'if' logic in in example program
620 Michael Kerrisk
621 Use correct type (socklen_t) for addrlen
622
623 semctl.2
624 Michael Kerrisk [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk]
625 NOTES: note when 'sempid' is set on various implementations
626 See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
627 http://thread.gmane.org/gmane.linux.kernel/2162754/
628 Subject: [PATCH] Don't set sempid in semctl syscall.
629 Date: 2016-02-26 12:21:38 GMT
630
631 semop.2
632 Michael Kerrisk
633 Tweak comment describing 'sempid'
634
635 sendfile.2
636 Askar Safin
637 Fix incorrect description in text referring to splice(2)
638 Michael Kerrisk
639 SEE ALSO: add copy_file_range(2)
640
641 setpgid.2
642 Michael Kerrisk
643 Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
644
645 signalfd.2
646 Michael Kerrisk
647 Note that signalfd info is available in /proc/PID/fdinfo
648
649 sigprocmask.2
650 Michael Kerrisk [Mike Frysinger]
651 Explicitly refer the reader to sigsetops(3)
652 This man page did not make it obvious which functions
653 should be used for manipulating signals sets, nor where
654 those functions were documented.
655
656 socketpair.2
657 Michael Kerrisk [Eric Blake]
658 Note treatment of 'sv' on error
659
660 splice.2
661 Askar Safin
662 Improve description of 0 return value.
663 See https://bugzilla.kernel.org/show_bug.cgi?id=90911
664
665 statfs.2
666 Michael Kerrisk [Jakub Wilk]
667 Use consistent case for hex constants
668
669 sync.2
670 Christoph Hellwig
671 Clarify description and document the Linux data integrity guarantees
672
673 syscall.2
674 Mike Frysinger
675 Add more architectures and improve error documentation
676 Move the error register documentation into the main table rather
677 than listing them in sentences after the fact.
678
679 Add sparc error return details.
680
681 Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
682 tile/xtensa.
683
684 syscalls.2
685 Michael Kerrisk
686 Add copy_file_range(2)
687
688 times.2
689 Kondo, Naoya
690 Fix an incorrect description in NOTES
691 The text has an incorrect description in NOTES, it says
692 that (2^32/HZ) - 300 is about 429 million. It is correct
693 only if HZ=10 which does not look common today. So just
694 removing "(i.e., about 429 million)" is good enough.
695
696 truncate.2
697 Michael Kerrisk
698 SEE ALSO: add truncate(1)
699
700 uselib.2
701 Michael Kerrisk
702 Mention CONFIG_USELIB
703 Michael Kerrisk
704 Note that glibc does not support this (obsolete) system call
705
706 wait.2
707 wait4.2
708 Michael Kerrisk
709 Rename the "status" argument to "wstatus"
710 The fact that exit(3)/_exit(2) has an argument called
711 "status" and the same name is used in the arguments to the
712 wait*() calls can a little too easily lead the user into
713 thinking that the two arguments hold the same information,
714 when of course they don't. So, use a different name
715 for the argument of the wait*() functions, to reduce
716 the chances of such confusion.
717
718 backtrace.3
719 Michael Kerrisk [Martin Gebert]
720 Small fixes to example program
721
722 clearenv.3
723 Michael Kerrisk [Matt Zimmerman]
724 Clarify the use and effect of clearenv()
725 See http://bugs.debian.org/679323
726 Michael Kerrisk
727 Variables can be added to the environment after calling clearenv()
728
729 clog10.3
730 Michael Kerrisk
731 Show an alternative equivalence for clog10()
732 Michael Kerrisk
733 Update CONFORMING TO
734 Fix grammar error and add C11.
735
736 dl_iterate_phdr.3
737 Michael Kerrisk [Paul Pluzhnikov]
738 Describe 'struct dl_phdr_info' fields added in glibc 2.4
739 See https://bugzilla.kernel.org/show_bug.cgi?id=103011
740 Michael Kerrisk [Simon Que]
741 Note that first object visited by 'callback' is the main program
742 See https://bugzilla.kernel.org/show_bug.cgi?id=94141
743
744 errno.3
745 Michael Kerrisk
746 Add some explanation of ENOENT error
747
748 exec.3
749 Michael Kerrisk
750 SEE ALSO: add system(3)
751
752 exp.3
753 Michael Kerrisk [Joachim Wuttke]
754 SEE ALSO: add expm1(3)
755
756 fopen.3
757 Michael Kerrisk
758 SEE ALSO: add open_memstream(3)
759
760 fts.3
761 Michael Kerrisk
762 BUGS: glibc-2.23 now has LFS support for the fts functions
763
764 gamma.3
765 Michael Kerrisk [Alan Cox]
766 gamma() was documented in SVID 2
767
768 getaddrinfo.3
769 Michael Kerrisk [Andreas Schwab, Orion Poplawski]
770 Update FTM requirements for glibc 2.22
771 Since glibc 2.22 getaddrinfo() etc. are only declared for
772 POSIX.1-2001 or later.
773
774 getcwd.3
775 Michael Kerrisk
776 SEE ALSO: add pwd(1)
777
778 opendir.3
779 Michael Kerrisk
780 Help the reader by explicitly mentioning the use of readdir(3)
781
782 perror.3
783 Michael Kerrisk
784 Suggest use of strerror(3) in place of deprecated 'sys_errlist'
785
786 posix_fallocate.3
787 Jérémie Galarneau
788 ERRORS: add EINTR
789 The glibc implementation of posix_fallocate(), which calls
790 fallocate(), may be interrupted. The fallocate() emulation
791 also makes use of pread()/pwrite(), which may also be
792 interrupted.
793
794 posix_memalign.3
795 Michael Kerrisk [Eric Blake]
796 Note posix_memalign()'s treatment of 'memptr' on error
797
798 pthread_setaffinity_np.3
799 Michael Kerrisk
800 SEE ALSO: add CPU_SET(3)
801
802 queue.3
803 Dr. Tobias Quathamer
804 Remove double CONFORMING TO section
805
806 rcmd.3
807 Nikola Forró
808 Add missing condition concerning .rhosts file
809 The list of conditions determining if iruserok() and ruserok()
810 functions automatically fail is incomplete. According to glibc
811 source code, the functions also fail if the .rhosts file
812 is hard linked anywhere.
813
814 setbuf.3
815 Michael Kerrisk
816 SEE ALSO: add stdbuf(1)
817
818 setjmp.3
819 Michael Kerrisk
820 Rewrite and merge longjmp()/siglongjmp() discussion into this page
821 The discussion of nonlocal gotos is much easier to read if
822 setjmp() and longjmp() are discussed in the same page. While
823 we're at it, rework almost the entire text and add several
824 more details.
825 Michael Kerrisk
826 Note the interactions of longjmp() and non-async-signal-safe functions
827 POSIX.1-2008 TC2 adds explicit text on this point.
828 See http://austingroupbugs.net/view.php?id=516#c1195
829 Michael Kerrisk
830 Explain why nonlocal gotos make code harder to maintain
831 Michael Kerrisk
832 Reword warning on longjmp() to function that has already returned
833 Michael Kerrisk
834 Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
835
836 sleep.3
837 Michael Kerrisk
838 SEE ALSO: add sleep(1)
839
840 strftime.3
841 Michael Kerrisk [Jeremy Harris]
842 Note which 'tm' fields are used to calculate each output string
843 See https://bugzilla.redhat.com/show_bug.cgi?id=1162218
844
845 strlen.3
846 Michael Kerrisk [Alan Aversa]
847 CONFORMING TO: add C11
848
849 system.3
850 Michael Kerrisk
851 SEE ALSO: add execve(2)
852
853 termios.3
854 Dr. Tobias Quathamer
855 Document line length in canonical mode
856 See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
857 See https://bugs.debian.org/797479
858 Michael Kerrisk
859 SEE ALSO: add tty(1)
860 Michael Kerrisk [Peter Hurley]
861 Further improvements to recent tweaks of canonical mode 4096 char limit
862
863 timegm.3
864 Michael Kerrisk [Stephen Hurd, Mats Wichmann]
865 Remove sample implementation of timegm()
866 Stephen and Mats both question the wisdom of showing a portable
867 *non-thread-safe* implementation of timegm(), and I find it
868 hard to disagree. So, remove this code.
869
870 See https://bugzilla.kernel.org/show_bug.cgi?id=103701
871 Michael Kerrisk
872 Expand DESCRIPTION a little
873
874 st4.4
875 Dr. Tobias Quathamer
876 Remove spurious copyright section
877
878 tty_ioctl.4
879 Michael Kerrisk
880 SEE ALSO: add ldattach(1)
881
882 elf.5
883 Michael Kerrisk [Gabriel Corona, Mike Frysinger]
884 Fix description of STV_PROTECTED
885 Michael Kerrisk
886 Improve description of STV_DEFAULT
887 Michael Kerrisk
888 Improve description of STV_HIDDEN
889 Chris Pick
890 Remove erroneous, duplicate SHN_* section
891 Michael Kerrisk [Chris Pick]
892 Reword discussion of range values a little
893
894 gai.conf.5
895 Michael Kerrisk
896 Add VERSIONS section
897
898 group.5
899 Michael Kerrisk
900 SEE ALSO: add groups(2)
901 SEE ALSO: add gpasswd(1)
902 SEE ALSO: add sg(1)
903 SE ALSO: add gshadow(5)
904 SEE ALSO: add chgrp(1)
905
906 locale.5
907 Marko Myllynen [Mike Frysinger]
908 tel + fax are deprecated
909
910 nsswitch.conf.5
911 Nikola Forró
912 Update NSS compatibility mode description
913
914 utmp.5
915 Michael Kerrisk
916 SEE ALSO: add lslogins(1)
917
918 aio.7
919 Andreas Gruenbacher
920 Improve example
921 When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
922 handlers called for asynchronous I/O operations will have
923 si->si_code set to SI_ASYNCIO. Check to make sure that
924 si->si_value.sival_ptr is defined.
925
926 capabilities.7
927 Michael Kerrisk
928 Explain safety check for capability-dumb binaries
929 Michael Kerrisk
930 SEE ALSO: add sg(1), su(1)
931 SEE ALSO: add id(1), group(5), passwd(5)
932
933 credentials.7
934 Michael Kerrisk
935 SEE ALSO: add groups(2)
936
937 environ.7
938 Michael Kerrisk
939 Describe the Bourne "NAME=value command" syntax
940 Michael Kerrisk
941 Add some details describing hos shell's environment is initialized
942 Michael Kerrisk
943 Note that child of fork(2) inherits copy of parent's environment
944 Michael Kerrisk
945 SEE ALSO: add pam_env(3)
946
947 epoll.7
948 Michael Kerrisk
949 Mention that epoll info is available via /proc/PID/fdinfo
950
951 fanotify.7
952 Michael Kerrisk
953 Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
954
955
956 feature_test_macros.7
957 Michael Kerrisk
958 Add a summary of some FTM key points
959 Michael Kerrisk
960 Give an early hint about some macros being defined by default
961 Michael Kerrisk
962 Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
963 Emphasize that defining _XOPEN_SOURCE >=500 produces same
964 effects as defining _XOPEN_SOURCE_EXTENDED.
965 Michael Kerrisk
966 Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
967 As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
968 has generally been removed from the man pages.
969 Michael Kerrisk
970 Note effects of "cc -std=c99" and "cc -std=c11"
971 Michael Kerrisk
972 Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
973 Michael Kerrisk
974 Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
975 Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
976 in the standard.
977
978 inotify.7
979 Michael Kerrisk
980 Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
981
982 ip.7
983 Eric Dumazet
984 Document IP_BIND_ADDRESS_NO_PORT socket option
985
986 mq_overview.7
987 Michael Kerrisk
988 Note that the close-on-exec flag is automatically set on MQ descriptors
989
990 namespaces.7
991 Michael Kerrisk
992 SEE ALSO: add lsns(1)
993 lsns(1) was recently added in util-linux, probably to appear
994 in next release (2.28?).
995
996 pipe.7
997 Michael Kerrisk [Jason Vas Dias]
998 Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
999 Michael Kerrisk
1000 SEE ALSO: add mkfifo(1)
1001
1002 signal.7
1003 Michael Kerrisk
1004 Note the interactions of longjmp() and non-async-signal-safe functions
1005 See http://austingroupbugs.net/view.php?id=516#c1195.
1006
1007 socket.7
1008 Michael Kerrisk
1009 SEE ALSO: add pcap(3)
1010 SEE ALSO: add wireshark(1) and tcpdump(8)
1011
1012 standards.7
1013 Michael Kerrisk
1014 Add POSIX.1-2008 TC2 (POSIX.1-2016)
1015
1016 svipc.7
1017 Michael Kerrisk
1018 Tweak description of 'sempid'
1019 Michael Kerrisk
1020 SEE ALSO: add lsipc(1)
1021
1022 symlink.7
1023 Michael Kerrisk [Zefram]
1024 Some "magic" symlinks have permissions other than 0777
1025 See https://bugs.debian.org/743525
1026
1027 time.7
1028 Michael Kerrisk
1029 SEE ALSO: add timeout(1)
1030 SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)
1031
1032 unicode.7
1033 Dr. Tobias Quathamer
1034 Document private use areas
1035 See https://bugs.debian.org/285444
1036
1037 unix.7
1038 Heinrich Schuchardt
1039 Add example
1040 A complete example demonstrating the usage of sockets for local
1041 interprocess communication is added.
1042 Michael Kerrisk
1043 Introduce term "sequenced-packet" for SOCK_SEQPACKET
1044 Michael Kerrisk
1045 Some wording improvements