]> git.ipfire.org Git - thirdparty/man-pages.git/blob - Changes.old
namespaces.7: ffix
[thirdparty/man-pages.git] / Changes.old
1 ==================== Changes in man-pages-2.00 ====================
2
3 Released: 2004-12-16
4
5 Contributors
6 ------------
7
8 The following people contributed notes, ideas, or patches that have
9 been incorporated in changes in this release:
10
11 Alberto Bertogli <albertogli@telpin.com.ar>
12 Anand Kumria <wildfire@progsoc.org>
13 Andrey Kiselev <dron@ak4719.spb.edu>
14 Andries Brouwer <Andries.Brouwer@cwi.nl>
15 Chris Green <cmg@dok.org>
16 Branden Robinson <branden@debian.org>
17 Emmanuel Colbus <emmanuel.colbus@ensimag.imag.fr>
18 Enrico Zini <enrico@debian.org>
19 Eric Estievenart <eric.estievenart@free.fr>
20 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
21 Florian Weimer <fw@deneb.enyo.de>
22 Jan Kuznik <kuznik@gepro.cz>
23 Joey (Martin) Schulze <joey@infodrom.org>
24 Johannes Berg <johannes@sipsolutions.de>
25 John V. Belmonte <jbelmonte@debian.org>
26 Karel Kulhavy <clock@twibright.com>
27 Luis Javier Merino Morán <ljmerino@pandasoftware.es>
28 Martin Pool <mbp@sourcefrog.net>
29 Richard Kreckel <Richard.Kreckel@ginac.de>
30 Vasya Pupkin <ptushnik@gmail.com>
31
32 Apologies if I missed anyone!
33
34 Global changes
35 --------------
36
37 Various pages
38 Fabian Kreutz
39 Many math pages had their synopses compressed, as per suggestion
40 from Fabian Kreutz.
41
42 Various pages
43 Fabian Kreutz / aeb
44 Many minor content and formatting bug fixes were made to the math
45 pages, following suggestions from Fabian Kreutz (who recently
46 translated many of the 1.70 math pages into German) and
47 Andries Brouwer.
48
49 Various pages
50 mtk
51 For consistency, all instances of "super-user" were changed
52 to the more common "superuser".
53
54 Various pages
55 Vasya Pupkin / mtk
56 After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
57 of several Section 2 pages using the _syscallN() macros.
58
59 In addition:
60 -- erroneous semicolons at the end of _syscallN() were removed
61 on various pages.
62
63 -- types such as "uint" in syscallN() declarations were changed
64 to "unsigned int", etc.
65
66 -- various other minor breakages in the synopses were fixed.
67
68 The affected pages are:
69
70 getdents.2
71 gettid.2
72 llseek.2
73 mmap2.2
74 modify_ldt.2
75 pivot_root.2
76 quotactl.2
77 readdir.2
78 sysctl.2
79 syslog.2
80 tkill.2
81
82 Typographical or grammatical errors have been corrected in several
83 other places.
84
85 Changes to individual pages
86 ---------------------------
87
88 bind.2
89 Florian Weimer
90 Added 'const' to declaration of 'my_addr' in prototype.
91 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762.
92
93 fcntl.2
94 Martin Pool
95 Added O_NOATIME to list of flags that can be changed via F_SETFL.
96 mtk/aeb
97 Noted F_GETOWN bug after suggestion from aeb.
98 See also:
99 http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2
100
101 getrlimit.2
102 mtk
103 Material on getrusage.2 has been separated out into its own page.
104 Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
105 2.6.9 changes.
106 Added note on RLIMIT_CPU error in older kernels.
107 Added RLIMIT_SIGPENDING.
108 Also made a few other minor changes.
109
110 getrusage.2
111 mtk
112 This page is new(ish) -- it was created by splitting
113 getrlimit.2.
114
115 Repaired note on SIGCHLD behavior to note that the
116 POSIX non-conformance has been fixed in 2.6.9.
117
118 kill.2
119 Modified after suggestion from Emmanuel Colbus
120 Changed wording of sentence under NOTES describing
121 when signals can be sent to init(1).
122
123 mlock.2
124 munlock.2
125 mlockall.2
126 munlockall.2
127 These have been consolidated into a single mlock.2 page.
128 In the process, much duplication was eliminated
129 and new information was added about RLIMIT_MEMLOCK
130 and the changes in memory locking in kernel 2.6.9,
131
132 mmap.2
133 mtk
134 Added cross-ref to setrlimit(2) concerning memory locking limits.
135 Eric Estievenart
136 Note that MAP_FIXED replaces existing mappings
137
138 msgctl.2
139 mtk
140 Substantial language and formatting clean-ups.
141 Added msqid_ds and ipc_perm structure definitions.
142
143 msgget.2
144 mtk
145 Substantial language and formatting clean-ups.
146 Added notes on /proc files.
147
148 msgop.2
149 mtk
150 Substantial language and formatting clean-ups.
151 Added notes on /proc files.
152
153 open.2
154 Martin Pool
155 Added O_NOATIME (new in Linux 2.6.8)
156 mtk
157 Reordered list of 'flags' description alphabetically
158
159 personality.2
160 2004-11-03 applied patch from Martin Schulze
161
162 semctl.2
163 mtk
164 Substantial language and formatting clean-ups.
165 Rewrote semun text.
166 Added semid_ds and ipc_perm structure definitions.
167
168 semget.2
169 mtk
170 Substantial language and formatting clean-ups.
171 Added notes on /proc files.
172 Rewrote BUGS note about semget()'s failure to initialize
173 semaphore values.
174
175 semop.2
176 mtk
177 Substantial language and formatting clean-ups.
178 Added notes on /proc files.
179
180 shmctl.2
181 mtk
182 Substantial language and formatting clean-ups.
183 Updated shmid_ds structure definitions.
184 Added information on SHM_DEST and SHM_LOCKED flags.
185 Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
186 since kernel 2.6.9.
187 Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
188 Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
189
190 shmget.2
191 mtk
192 Substantial language and formatting clean-ups.
193 Added notes on /proc files.
194
195 shmop.2
196 mtk
197 Substantial language and formatting clean-ups.
198 Changed wording and placement of sentence regarding attachment
199 of segments marked for destruction.
200
201 sigaction.2
202 mtk
203 Added mention of SIGCONT under SA_NOCLDSTOP.
204 Added SA_NOCLDWAIT.
205 Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
206 Noted that CLD_CONTINUED is supported since Linux 2.6.9.
207 Added SI_TKILL (new in Linux 2.4.19).
208 Other minor changes.
209
210 signal.2
211 mtk
212 Removed text on ignoring SIGCHLD; replaced with pointer
213 to sigaction.2.
214
215 sigwaitinfo.2
216 After bug report from Andrey Kiselev
217 Fixed prototype: "timeout" --> "*timeout"
218 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145
219
220 stat.2
221 Enrico Zini
222 Added text to clarify that S_IS*() macros should be applied to
223 st_mode field.
224 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
225
226 swapon.2
227 After Debian bug report from Anand Kumria
228 Added "no swap space signature" to EINVAL error.
229 mtk
230 Added EINVAL error for swapoff() ("not currently a swap area").
231 Added EBUSY error for swapon().
232 A few formatting fixes.
233
234 times.2
235 mtk
236 In Linux 2.6, the return value of times changed; it is no
237 longer time since boot, but rather:
238
239 boot_time + 2^32 / HZ - 300
240
241 Repaired note on SIGCHLD behavior to note that the
242 POSIX non-conformance has been fixed in 2.6.9.
243 Some formatting fixes.
244
245 undocumented.2
246 After bug report from Johannes Berg
247 Changed
248 .TH UNIMPLEMENTED
249 to:
250 .TH UNDOCUMENTED
251 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
252
253 wait.2
254 mtk
255 Added waitid(2).
256 Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
257 Added text on SA_NOCLDSTOP.
258 Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior.
259 Much other text rewritten.
260
261 wait4.2
262 mtk
263 Rewrote this page, removing much duplicated information,
264 and replacing with pointers to wait.2.
265 Luis Javier Merino Morán / mtk
266 CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD"
267
268 waitid.2
269 mtk
270 New link to wait.2
271
272 assert.3
273 After bug report from Branden Robinson
274 The assert() failure message goes to stderr not stdout.
275 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
276
277 ctime.3
278 mtk
279 Noted that 0 in tm_mday is interpreted to mean the last day
280 of the preceding month.
281
282 getnameinfo.3
283 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
284 getnameinfo() does not set errno, it returns a non-zero
285 value indicating the error.
286 mtk
287 added EAI_OVERFLOW error
288
289 killpg.3
290 mtk
291 Minor changes to SEE ALSO and CONFORMING TO.
292
293 lseek64.3
294 aeb
295 New page by Andries Brouwer
296
297 tzset.3
298 Richard Kreckel
299 Change "NULL" to "empty" when talking about the value of TZ.
300 http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
301
302 printf.3
303 After bug report from Jan Kuznik
304 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
305 Fixed bad realloc() use in snprintf() example
306
307 realpath.3
308 mtk
309 Added discussion of resolved_path == NULL.
310
311 random.4
312 After bug report from John V. Belmonte
313 Updated init and quit scripts to reflect kernel 2.4/2.6 reality
314 (Scripts taken from drivers/char/random.c)
315 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
316
317 proc.5
318 mtk
319 Updated description of /proc/loadavg to include
320 nr_running(), nr_threads, last_pid.
321
322 rtsig-max and rtsig-nr went away in 2.6.8
323
324 updated statm, and fixed error in order of list
325
326 boot.7
327 applied patch from Martin Schulze
328
329 capabilities.7
330 mtk
331 Added O_NOATIME for CAP_FOWNER
332
333 netdevice.7
334 Karel Kulhavy and AEB
335 Formatting fix after note from Karel Kulhavy and AEB, plus a
336 few wording fixes.
337
338 signal.7
339 mtk
340 /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
341 in kernel 2.6.8.
342
343 tcp.7
344 mtk/aeb
345 Updated details of interaction of TCP_CORK and TCP_NODELAY.
346
347 ==================== Changes in man-pages-2.01 ====================
348
349 Released: 2004-12-20
350
351 Contributors
352 ------------
353
354 The following people contributed notes, ideas, or patches that have
355 been incorporated in changes in this release:
356
357 Carsten Hey <c.hey@web.de>
358 Johannes Berg <johannes@sipsolutions.de>
359 Joshua Kwan <joshk@triplehelix.org>
360 Marek Habersack <grendel@debian.org>
361 Martin Schulze <joey@infodrom.org>
362 Matthew Dempsky <jivera@flame.org>
363 Matthew Gregan <kinetik@orcon.net.nz>
364 Pedro Zorzenon Neto <pzn@terra.com.br>
365 Tony Crawford <tony@klosterdorf.de>
366
367 Apologies if I missed anyone!
368
369 Global changes
370 --------------
371
372 accept.2
373 close.2
374 send.2
375 setsid.2
376 socket.2
377 closedir.3
378 initgroups.3
379 mkstemp.3
380 opendir.3
381 readdir.3
382 telldir.3
383 Matthew Dempsky, mtk
384 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
385 The wording describing how errno is set was fixed up in these pages.
386
387 Typographical or grammatical errors have been corrected in several
388 other places.
389
390 Changes to individual pages
391 ---------------------------
392
393 sendfile.2
394 mtk
395 Adjusted descriptions of argument file types to be closer to
396 2.6 reality.
397 Wording and formatting changes.
398
399 ctan.3
400 ctanh.3
401 Tony Crawford
402 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
403 Formulae on the pages should be T = S / C not T = C / S.
404
405 errno.3
406 Martin Schulze, mtk
407 Removed errno declaration from prototype, added notes
408 on historical need for this declaration.
409 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
410
411 aio_return.3
412 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
413 Changed erroneous "aio_return(2)" to "aio_return(3)".
414
415 posix_openpt.3
416 mtk
417 New by mtk
418
419 ptsname.3
420 mtk
421 Added description of ptsname_r().
422 Added ERRORS.
423
424 ptsname_r.3
425 mtk
426 New link to ptsname.3.
427
428 shm_open.3
429 Matthew Gregan
430 add <fcntl.h> to synopsis
431 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
432
433 strcasecmp.3
434 Marek Habersack
435 .SH "CONFORMING TO"
436 -BSD 4.4
437 +BSD 4.4, SUSv3
438 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
439
440 strfry.3
441 Joshua Kwan
442 Added _GNU_SOURCE to prototype
443 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
444
445 strftime.3
446 Cartsen Hey
447 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
448
449 Changed range for "%S" from 0..61 to 0..60.
450
451 SUSv3 says 0..60. I think the manual page probably says
452 0..61, because that's what SUSv2 said.
453 (Some other implementations' man pages also say 0..61 --
454 e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
455
456 The glibc manual currently says 0..60.
457
458 Given that SUSv3 says 0..60, I've changed the
459 manual page to also say this:
460
461 -The second as a decimal number (range 00 to 61).
462 +The second as a decimal number (range 00 to 60).
463 +(The range is up to 60 to allow for occasional leap seconds.)
464
465 sysconf.3
466 Johannes Berg
467 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
468 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
469 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
470
471 system.3
472 Pedro Zorzenon
473 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
474 Noted use of _XOPEN_SOURCE to get macros from <stdlib.h>
475 for wait(2).
476
477 mtk
478 Changed name of argument from 'string' to 'command' (like POSIX).
479
480 Noted that glibc does nowadays explicitly check for the existence
481 of the shell if 'command' is NULL, rather than the older behavior
482 of assuming the shell exists and always returning 1 if
483 'command' is NULL.
484
485 Other wording and formatting clean-ups.
486
487 undocumented.3
488 Remove some functions names that *are* documented.
489
490
491 ==================== Changes in man-pages-2.02 ====================
492
493 Released: 2005-04-14
494
495 Contributors
496 ------------
497
498 The following people contributed notes, ideas, or patches that have
499 been incorporated in changes in this release:
500
501 Andries Brouwer <Andries.Brouwer@cwi.nl>
502 Branden Robinson <branden@debian.org>
503 Colin Watson <cjwatson@debian.org>
504 David Lloyd <dmlloyd@tds.net>
505 Gordon Jin <gordon.jin@intel.com>
506 Heikki Orsila <shd@modeemi.cs.tut.fi>
507 Jamie Lokier <jamie@shareable.org>
508 Johan Walles
509 Kai Makisara <Kai.Makisara@kolumbus.fi>
510 Marko Kohtala <marko.kohtala@gmail.com>
511 Martin Pool <mbp@sourcefrog.net>
512 Martin (Joey) Schulze <joey@infodrom.org>
513 Matthias Lang <matthias@corelatus.se>
514 Michael Haardt <michael@moria.de>
515 Michael Mühlebach <michael@anduin.ch>
516 Mike Frysinger <vapier@gentoo.org>
517 Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
518 Serguei Leontiev <leo@sai.msu.ru>
519
520 Apologies if I missed anyone!
521
522 Global changes
523 --------------
524
525 ctime.3
526 tzselect.8
527 zdump.8
528 zic.8
529 Martin (Joey) Schulze
530 Removed SEE ALSO reference to nonexistent newctime(3).
531 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
532
533 Typographical or grammatical errors have been corrected in several
534 other places.
535
536 Changes to individual pages
537 ---------------------------
538
539 clone.2
540 mtk
541 Noted the PID caching behavior of NPTL's getpid()
542 wrapper under BUGS.
543
544 Added futex(2), set_thread_area(2), set_tid_address(2),
545 tkill(2) under SEE ALSO.
546
547 epoll_ctl.2
548 epoll_create.2
549 Marko Kohtala / mtk
550 Improved various error descriptions.
551
552 epoll_wait.2
553 David Lloyd / Mike Frysinger, Marko Kohtala
554 Added EINTR to errors.
555
556 fcntl.2
557 Jamie Lokier / mtk
558 Improved discussion of F_SETOWN and F_SETSIG with respect to
559 multi-threaded programs.
560 Generally cleaned up the discussion of F_SETOWN.
561
562 Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
563 now in POSIX.
564
565 link.2
566 mtk
567 Noted discrepancy between Linux and POSIX.1 when oldpath
568 is a symbolic link.
569 See: http://bugs.linuxbase.org/show_bug.cgi?id=367
570 and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
571
572 Michael Haardt / mtk
573 Clarified EXDEV error description: it isn't possible to link
574 across mount points, even if the mount points refer to the same
575 file system.
576
577 mincore.2
578 mtk, after note from Gordon Jin
579 Updated ERRORS.
580
581 pipe.2
582 As per message from Serguei Leontiev
583 Removed SVr2, AT&T, and BSD from CONFORMING TO, since
584 a pipe on those systems is actually bidirectional.
585 (Pipes are implemented as STREAMS on the former, and
586 sockets on the latter.)
587
588 posix_fadvise.2
589 mtk
590 Noted kernel version where posix_fadvise() appeared and
591 noted bug in handling of 'len' in kernels < 2.6.6.
592
593 rename.2
594 Michael Haardt
595 Clarified EXDEV error description: it isn't possible to rename
596 a file across mount points, even if the mount points refer to
597 the same file system.
598
599 semop.2
600 mtk
601 Noted kernel version numbers for semtimedop().
602
603 setitimer.2
604 Matthias Lang, mtk
605 Noted MAX_SEC_IN_JIFFIES ceiling.
606 Added note about treatment of out-of-range tv_usec values.
607
608 sigqueue.2
609 Johan Walles, Martin (Joey) Schulze
610 Added sigqueue.2 to SEE ALSO.
611
612 times.2
613 mtk
614 Added notes on non-standard behavior: Linux allows 'buf' to
615 be NULL, but POSIX.1 doesn't specify this and it's non-portable.
616
617 uselib.2
618 Andries Brouwer
619 Improved DESCRIPTION; clarified distinction between
620 EACCES and ENOEXEC.
621
622 bcopy.3
623 Heikki Orsila
624 bcopy() handles overlapping case, but memcpy() does not,
625 so for consistency memmove() should be also mentioned.
626
627 getmntent_r.3
628 Martin (Joey) Schulze
629 New link to man3/getmntent.3.
630
631 memcpy.3
632 Small wording change after suggestion from Sasa Stevanovic.
633
634 strcasestr.3
635 mtk
636 Created as link to strstr.3.
637
638 strftime.3
639 mtk
640 Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
641
642 strstr.3
643 mtk
644 Added description of strcasestr().
645
646 random.4
647 aeb
648 Improved description of read from /dev/urandom.
649
650 st.4
651 Kai Makisara
652 Substantial updates.
653
654 man.7
655 Martin Schulze
656 Branden Robinson
657 Colin Watson
658 Mention the .URL macro more verbosely.
659
660
661 ==================== Changes in man-pages-2.03 ====================
662
663 Released: 2005-06-02
664
665 Contributors
666 ------------
667
668 The following people contributed notes, ideas, or patches that have
669 been incorporated in changes in this release:
670
671 Andries Brouwer <Andries.Brouwer@cwi.nl>
672 Joey (Martin) Schulze <joey@infodrom.org>
673 Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
674 Justin Pryzby <justinpryzby@users.sourceforge.net>
675 Klaus Ethgen <Klaus@Ethgen.de>
676 Pavel Heimlich <tropikhajma@seznam.cz>
677 Ross Boylan <RossBoylan@stanfordalumni.org>
678 Vincent Fourmond <vincent.fourmond@9online.fr>
679
680 Apologies if I missed anyone!
681
682 Global changes
683 --------------
684
685 console.4
686 console_ioctl.4
687 mouse.4
688 tty.4
689 vcs.4
690 Pavel Heimlich
691 Change `ttys(4)' to `ttyS(4)'.
692
693 Typographical or grammatical errors have been corrected in several
694 places.
695
696 Changes to individual pages
697 ---------------------------
698
699 clone.2
700 mtk
701 Substantially enhanced discussion of CLONE_THREAD.
702
703 Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.
704
705 Other minor fixes.
706
707 execve.2
708 aeb
709 Noted effect of ptracing when execing a set-UID program.
710
711 fcntl.2
712 Johannes Nicolai / mtk
713 Noted F_SETOWN bug for socket file descriptor in Linux 2.4
714 and earlier.
715
716 Added text on permissions required to send signal to owner.
717
718 flock.2
719 mtk
720 Noted that lock conversions are not atomic.
721
722 getrusage.2
723 mtk
724 ru_nswap has never contained useful information.
725 Kernel 2.6.6 clarified that with a patch
726 ("[PATCH] eliminate nswap and cnswap"). See also:
727 http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
728
729 kill.2
730 mtk
731 Clarified wording of the 'pid == -1' case.
732
733 mount.2
734 mtk
735 Added MNT_EXPIRE, plus a few other tidy-ups.
736
737 sched_setaffinity.2
738 mtk
739 Added text to note that sched_setaffinity() will migrate the
740 affected process to one of the specified CPUs if necessary.
741
742 Added a NOTE to point out that the affinity mask is actually a
743 per-thread attribute that can be adjusted independently for
744 each thread in a thread group.
745
746 shmctl.2
747 mtk
748 Noted aberrant Linux behavior with respect to new attaches to a
749 segment that has already been marked for deletion.
750
751 Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
752
753 wait.2
754 mtk
755 Noted that the __W* flags can't be used with waitid().
756
757 confstr.3
758 mtk
759 Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
760
761 hosts.5
762 Ross Boylan / Martin Schulze
763 various changes as per
764 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
765
766 proc.5
767 mtk
768 Minor changes to discussion of /proc/PID/stat signal fields.
769 Added 'rt_priority' and 'policy' to /proc/PID/stat.
770
771 capabilities.7
772 mtk
773 1,$s/inherited/inheritable/g
774
775 regex.7
776 Vincent Fourmond / Joey (Martin) Schulze
777 Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
778 not seem to be in the glibc implementation.
779 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666
780
781 tzselect.8
782 Joey (Martin) Schulze / Klaus Ethgen
783 The default zoneinfo directory is now /usr/share/zoneinfo.
784 (was: /usr/local/etc/zoneinfo)
785 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
786
787
788 ==================== Changes in man-pages-2.04 ====================
789
790 Released: 2005-06-21
791
792 Contributors
793 ------------
794
795 The following people contributed notes, ideas, or patches that have
796 been incorporated in changes in this release:
797
798 Andries Brouwer <Andries.Brouwer@cwi.nl>
799 Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
800 Dave Love <d.love@dl.ac.uk>
801 Dieter Brueggemann <dieter.brueggemann@entitec.de>
802 Geoff Clare <gclare@gclare.org.uk>
803 Guido Trotter <ultrotter@debian.org>
804 kabloom <kabloom@ucdavis.edu>
805 Kevin Ryde <user42@zip.com.au>
806 Justin Pryzby <justinpryzby@users.sourceforge.net>
807 Mike Furr <mfurr@debian.org>
808 Olivier Croquette <ocroquette@free.fr>
809 Olivier Guilyardi <ylf@xung.org>
810 Peter Cordes <peter@llama.nslug.ns.ca>
811 Philipp Spitzer <philipp@toastfreeware.priv.at>
812 Tanaka Akira <akr@m17n.org>
813 Thierry Excoffier <exco@bat710.univ-lyon1.fr>
814 Thomas Hood <jdthood@yahoo.co.uk>
815 Vincent Lefevre <vincent@vinc17.org>
816 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
817
818 Apologies if I missed anyone!
819
820 Global changes
821 --------------
822
823 Various pages
824 mtk
825 For consistency across pages:
826
827 1,$s/nonzero/non-zero/g
828
829 Typographical or grammatical errors have been corrected in several
830 places.
831
832
833 New pages
834 ---------
835
836 pthreads.7
837 mtk
838 An overview of the Linux implementations of POSIX threads.
839
840
841 Changes to individual pages
842 ---------------------------
843
844 _exit.2
845 mtk
846 Various minor changes.
847
848 epoll_ctl.2
849 Mike Furr
850 BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
851 'event', even though this argument is ignored.
852 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517
853
854 flock.2
855 mtk / Kevin Ryde
856 Clarified semantics of relationship between flock() locks
857 and open file entries and file descriptors.
858 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
859
860 getitimer.2
861 Olivier Croquette, Thierry Excoffier
862 Noted the existence of the short sleep bug (up to 1 jiffy).
863
864 getrlimit.2
865 mtk
866 RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
867
868 getrusage.2
869 Geoff Clare
870 Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
871
872 nice.2
873 mtk / Guido Trotter
874 Rewrote description of return value.
875 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183
876
877 open.2
878 Walter Harms
879 O_DIRECT needs _GNU_SOURCE.
880 mtk
881 O_ASYNC works for pipes and FIFOs in Linux 2.6.
882 Various minor fixes.
883
884 atexit.3
885 mtk
886 Various minor changes.
887
888 exit.3
889 mtk
890 Various minor changes.
891
892 getopt.3
893 mtk / Philipp Spitzer
894 Fix description of return value.
895 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
896
897 hsearch.3
898 mtk
899 Changed (char *) to (void *) in example.
900 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
901
902 log1p.3
903 Justin Pryzby
904 Make log(3) SEE ALSO log1p(3),
905 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
906
907 makecontext.3
908 Tanaka Akira
909 Fix description of RETURN VALUE for makecontext(),
910 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
911
912 on_exit.3
913 mtk
914 Various minor changes.
915
916 rand.3
917 kabloom
918 Small fix to a code example,
919 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842
920
921 realpath.3
922 mtk / Thomas Hood
923 When specifying resolved_path as NULL, realpath()
924 will (still) only allocate up to PATH_MAX bytes.
925 Plus other minor changes.
926 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
927
928 rcmd.3
929 Dave Love
930 The required header file for these functions on Linux is <netdb.h>,
931 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680
932
933 scanf.3
934 Olivier Guilyardi
935 Arg for %p is a pointer to _a pointer to_ void,
936 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
937
938 stdin.3
939 Vincent Lefevre
940 freopen() can change the descriptors associated with
941 stdin/stdout/stderr, as per
942 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859
943
944 strerror.3
945 Baurjan Ismagulov
946 strerror_r(3) requires #define _XOPEN_SOURCE 600,
947 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
948
949 sysconf.3
950 Peter Cordes / mtk
951 Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV".
952
953 proc.5
954 mtk
955 Added pointers under /proc/sys/net to tcp.7 and ip.7.
956
957 ip.7
958 mtk
959 Various wording and formatting fixes.
960 Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
961
962 tcp.7
963 Dieter Brueggemann / mtk
964 Fixes to the discussion of SIOCATMARK and tcp_stdurg.
965 mtk
966 Various wording and formatting fixes.
967 Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
968 from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
969
970
971 ==================== Changes in man-pages-2.05 ====================
972
973 Released: 2005-06-27
974
975 Contributors
976 ------------
977
978 The following people contributed notes, ideas, or patches that have
979 been incorporated in changes in this release:
980
981 A Costa <agcosta@gis.net>
982 Andries Brouwer <Andries.Brouwer@cwi.nl>
983 Bas Zoetekouw <bas@debian.org>
984 Dan Jacobson <jidanni@jidanni.org>
985 Delian Krustev <krustev@krustev.net>
986 Dora Anna Volgyesi <volgyesi@elte.hu>
987 Martin (Joey) Schulze <joey@infodrom.org>
988 Ove Kaaven <ovek@arcticnet.no>
989
990 Apologies if I missed anyone!
991
992 Global changes
993 --------------
994
995 Typographical or grammatical errors have been corrected in several
996 places. (Special thanks to A Costa.)
997
998
999 Changes to individual pages
1000 ---------------------------
1001
1002 _exit.2
1003 mtk / aeb
1004 Reversed 2.04 introduction of the term "process termination
1005 function".
1006
1007 close.2
1008 mtk
1009 Clarified what type of lock close() affects.
1010 Minor formatting changes.
1011
1012 dup.2
1013 mtk
1014 Consistent use of terms "open file description",
1015 "file status flags", and "file descriptor flags".
1016 Removed mention of lock sharing -- it was not accurate.
1017 Minor formatting fixes.
1018
1019 fcntl.2
1020 mtk
1021 Consistent use of terms "open file description",
1022 "file status flags", and "file descriptor flags".
1023 Some rewriting of discussion of file descriptor flags
1024 Under F_DUPFD, replaced some text duplicated in dup.2
1025 with a cross ref to dup.2
1026 Minor wording and formatting fixes.
1027
1028 fpclassify.3
1029 mtk / Martin (Joey) Schulze / Bas Zoetekouw
1030 The return value of isinf() changed in glibc 2.02
1031 to differentiate positive and negative infinity.
1032 See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1033
1034 getgid.2
1035 getuid.2
1036 Delian Krustev
1037 Remove confusing text describing real and effective IDs.
1038 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852
1039
1040 getitimer.2
1041 mtk
1042 The short sleep bug (up to 1 jiffy) that was newly noted in
1043 man-pages-2.04 has just been fixed in 2.6.12.
1044
1045 getpriority.2
1046 mtk
1047 Changed range documented in main text from -20..20 to -20..19.
1048 Noted that the range is -20..20 on some systems.
1049
1050 open.2
1051 mtk / aeb
1052 Clarification of term "open file description" along with
1053 explanation of what information it maintains.
1054 Other wording improvements.
1055 Various minor wording changes.
1056
1057 atexit.3
1058 mtk / aeb
1059 Reversed 2.04 introduction of the term "process termination
1060 function".
1061 mtk
1062 Noted use of atexit() for establishing function to be invoked on
1063 shared library unload.
1064 Noted that atexit()-registered functions are not invoked on
1065 abnormal termination.
1066 Formatting fixes.
1067
1068 exit.3
1069 mtk / aeb
1070 Reversed 2.04 introduction of the term "process termination
1071 function".
1072 mtk
1073 Minor rewording and formatting changes.
1074
1075 getloadavg.3
1076 mtk
1077 Added #define _BSD_SOURCE to prototype.
1078
1079 log2.3
1080 Martin (Joey) Schulze
1081 Add ERANGE error.
1082
1083 readdir.3
1084 mtk
1085 Added definition of Linux dirent structure.
1086 Some formatting cleanups.
1087
1088 strtod.3
1089 Dora Anna Volgyesi / mtk
1090 strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
1091 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
1092
1093 tdestroy.3
1094 mtk
1095 New link to tsearch.3.
1096
1097 tsearch.3
1098 mtk
1099 Added tdestroy to .TH line.
1100
1101 mem.4
1102 mtk
1103 Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem".
1104
1105 null.4
1106 mtk
1107 Change "chown root:mem /dev/null /dev/zero" to
1108 "chown root:root /dev/null /dev/zero".
1109
1110 vcs.4
1111 Dan Jacobson / Martin (Joey) Schulze
1112 Replaced "selection(1)" by "gpm(8)" under SEE ALSO
1113 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515
1114
1115 signal.7
1116 Ove Kaaven
1117 SA_SIGACTION should be SA_SIGINFO
1118 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369
1119
1120 urn.7
1121 mtk
1122 New link to uri.7
1123
1124
1125 ==================== Changes in man-pages-2.06 ====================
1126
1127 Released: 2005-07-15
1128
1129 Contributors
1130 ------------
1131
1132 The following people contributed notes, ideas, or patches that have
1133 been incorporated in changes in this release:
1134
1135 Alain Portal <aportal@univ-montp2.fr>
1136 Andries Brouwer <Andries.Brouwer@cwi.nl>
1137 Bhavesh P Davda <bhavesh@avaya.com>
1138 Clau Weber <claus@jambit.com>
1139 Dov Murik <dov@dv-networks.com>
1140 David Lloyd <dlloyd@microbits.com.au>
1141 Frederik Deweerdt <frederik.deweerdt@gmail.com>
1142 Justin Pryzby <justinpryzby@users.sourceforge.net>
1143 Lars Wirzenius <liw@iki.fi>
1144 Martin Pool <mbp@sourcefrog.net>
1145 Mike Frysinger <vapier@gentoo.org>
1146 Petter Reinholdtsen <pere@hungry.com>
1147 Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1148 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1149
1150 Apologies if I missed anyone!
1151
1152 Global changes
1153 --------------
1154
1155 Typographical or grammatical errors have been corrected in several
1156 places.
1157
1158 Many uses of hyphens and dashes were corrected.
1159
1160
1161 New pages
1162 ---------
1163
1164 canonicalize_file_name.3
1165 Walter Harms / mtk
1166
1167 Removed Pages
1168 -------------
1169
1170 sstk.2
1171 mtk
1172 AFAIK, this system call has never actually done anything (other
1173 than be a stub) on any Unix.
1174
1175 Changes to individual pages
1176 ---------------------------
1177
1178 accept.2
1179 mtk
1180 Various wording and formatting fixes.
1181
1182 bind.2
1183 mtk
1184 Minor formatting changes
1185
1186 clone.2
1187 mtk
1188 Various minor wording improvements; some formatting fixes
1189
1190 connect.2
1191 mtk
1192 Various wording and formatting fixes.
1193
1194 epoll_create.2
1195 Bhavesh P Davda
1196 s/positive/non-negative/ [for file descriptor]
1197
1198 getrlimit.2
1199 mtk
1200 Documented RLIMIT_MSGQUEUE limit.
1201 RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
1202 (It already didn't have any effect in 2.2.x and 2.6.x.)
1203 s/MADVISE_WILLNEED/MADV_WILLNEED/
1204
1205 listen.2
1206 mtk
1207 Removed historic comment on BSD backlog ceiling.
1208 Minor wording and formatting changes.
1209
1210 semop.2
1211 mtk
1212 Added BUG: in some circumstances, a process that is
1213 waiting for a semaphore to become zero is not woken
1214 up when the value does actually reach zero.
1215 http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
1216 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
1217
1218 socket.2
1219 mtk
1220 Various minor wording improvements
1221
1222 umask.2
1223 mtk
1224 Added mkdir(2) to discussion, made term "file mode creation
1225 mask" clearer.
1226 Various, mostly small, wording changes
1227
1228 errno.3
1229 Martin Pool
1230 Change description for ESTALE
1231 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1232
1233 fgetgrent.3
1234 getgrent.3
1235 getgrent_r.3
1236 David Lloyd
1237 Added SEE ALSO putgrent(3)
1238 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1239
1240 getgrent.3
1241 getgrnam.3
1242 getpwent.3
1243 getpwnam.3
1244 Lars Wirzenius / mtk
1245 Replace mention of /etc/{passwd,group} by references to
1246 "passwd/group database", and LDAP and NIS.
1247 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1248 mtk
1249 Miscellaneous wording improvements
1250 Consistent DESCRIPTION and ERRORS wording across these pages.
1251
1252 getnameinfo.3
1253 mtk
1254 Relocate misplaced text describing gai_strerror().
1255
1256 getnetent.3
1257 Petter Reinholdtsen
1258 s/endservent/endnetent/
1259 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316517
1260
1261 getspnam.3
1262 Lars Wirzenius / mtk
1263 Replace mention of /etc/shadow by references to
1264 "shadow password database", and LDAP and NIS.
1265 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1266 mtk, Claus Weber
1267 Miscellaneous wording improvements
1268 Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
1269
1270 hsearch.3
1271 Frederik Deweerdt
1272 Fix hsearch_r() prototype
1273
1274 scanf.3
1275 Justin Pryzby / mtk
1276 Fix description of RETURN VALUE
1277 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=317037
1278 mtk
1279 various parts substantially rewritten; added description of
1280 %n$ form; various text incorporated from the GNU C library
1281 documentation ((C) The Free Software Foundation).
1282
1283 shm_open.3
1284 mtk
1285 Modified details of how user and group ownership of a new
1286 object are set.
1287 Various minor wording and formatting cleanups.
1288
1289 elf.5
1290 Mike Frysinger
1291 tweaked the short description to include definition of 'ELF'
1292 add ELFOSABI_NONE to the ELFOSABI_ list
1293 tweak/add more machines to EM_ list for ehdr->e_machine
1294 fix indenting to be consistent
1295 tweak the display of the ELF_ST_* macros
1296 document the Elf_Dyn structure
1297
1298 proc.5
1299 mtk
1300 Updated discussion of /proc/stat.
1301 Added text on the /proc/sys/fs/mqueue/* files.
1302
1303 ip.7
1304 Steven Murdoch
1305 Change protocol in UDP prototype.
1306 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1307
1308 tcp.7
1309 Dov Murik
1310 The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
1311 makes no grammatical sense (and possibly also no technical sense).
1312 It has been removed.
1313
1314
1315 ==================== Changes in man-pages-2.07 ====================
1316
1317 Released: 2005-07-19
1318
1319 Contributors
1320 ------------
1321
1322 The following people contributed notes, ideas, or patches that have
1323 been incorporated in changes in this release:
1324
1325 Andries Brouwer <Andries.Brouwer@cwi.nl>
1326 Mike Frysinger <vapier@gentoo.org>
1327
1328 Apologies if I missed anyone!
1329
1330 Global changes
1331 --------------
1332
1333 Various pages
1334 mtk
1335 The terms "set-user-ID" and "set-group-ID" are now used
1336 consistently (no abbreviations) across all manual pages.
1337
1338 Various pages
1339 mtk
1340 Consistent use of "saved set-user-ID" and "saved set-group-ID"
1341 (no more "saved user ID", "saved effective UID",
1342 saved group ID", etc.)
1343
1344 Various pages
1345 mtk
1346 Global fixes in textual descriptions:
1347
1348 uid --> UID
1349 gid --> GID
1350 pid --> PID
1351 id --> ID
1352
1353 Various pages
1354 mtk
1355 Consistent use of st_atime, st_ctime, st_mtime, with
1356 explanatory text, instead of atime/ctime/mtime.
1357
1358 Various pages
1359 mtk
1360 Classical BSD versions are now always named x.yBSD (formerly
1361 there was a mix of x.yBSD and BSD x.y).
1362
1363 Typographical or grammatical errors have been corrected in several
1364 places.
1365
1366
1367 Changes to individual pages
1368 ---------------------------
1369
1370 setresuid.2
1371 mtk
1372 Some rewording.
1373
1374 stat.2
1375 Mike Frysinger
1376 Improve description of st_dev and st_rdev.
1377 mtk
1378 Various wording and formatting improvements.
1379
1380 truncate.2
1381 mtk
1382 Some formatting fixes
1383
1384
1385 ==================== Changes in man-pages-2.08 ====================
1386
1387 Released: 2005-09-21
1388
1389 Contributors
1390 ------------
1391
1392 The following people contributed notes, ideas, or patches that have
1393 been incorporated in changes in this release:
1394
1395 Adrian Bunk <bunk@stusta.de>
1396 Alain PORTAL <aportal@univ-montp2.fr>
1397 Andrew Pimlott <andrew@pimlott.net>
1398 Andries Brouwer <Andries.Brouwer@cwi.nl>
1399 Baurzhan Ismagulov <ibr@radix50.net>
1400 Bernhard R. Link <brlink@debian.org>
1401 Bodo Stroesser <bstroesser@fujitsu-siemens.com>
1402 David N. Welton <davidw@eidetix.com>
1403 Dov Murik <dov@dv-networks.com>
1404 Heikki Orsila <shd@modeemi.cs.tut.fi>
1405 Hasso Tepper <hasso@estpak.ee>
1406 Hrvoje Niksic <hniksic@xemacs.org>
1407 Justin Pryzby <justinpryzby@users.sourceforge.net>
1408 Ludovic Courtes <ludovic.courtes@laas.fr>
1409 Mike Frysinger <vapier@gentoo.org>
1410 Nicolas François <nicolas.francois@centraliens.net>
1411 Norbert Buchmuller <norbi.spam@nix.hu>
1412 Paul Brook <paul@nowt.org>
1413 Ramiro Aceves <ea1abz@gmail.com>
1414 Tommy Pettersson <ptp@lysator.liu.se>
1415 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1416
1417 Apologies if I missed anyone!
1418
1419 Global changes
1420 --------------
1421
1422 Various pages
1423 mtk
1424 RFC references are now always written as "RFC\ nnn"
1425 (not "RFC nnn" or "RFCnnn").
1426
1427 Typographical or grammatical errors have been corrected in several
1428 places.
1429
1430
1431 Changes to individual pages
1432 ---------------------------
1433
1434 du.1
1435 Mike Frysinger
1436 To get an effect like "-h", BLOCKSIZE must start with "human",
1437 not "HUMAN".
1438
1439 time.1
1440 Mike Frysinger
1441 s/standard output/standard error/
1442
1443 clone.2
1444 Paul Brook / mtk
1445 Fix small error in description of CLONE_PARENT_SETTID
1446
1447 connect.2
1448 Heikki Orsila
1449 Add EINTR error
1450 See http://lkml.org/lkml/2005/7/12/254
1451
1452 getpriority.2
1453 mtk
1454 Expanded discussion of relationship between user and kernel
1455 representations of the nice value.
1456
1457 Added discussion of RLIMIT_NICE and a cross reference to
1458 getrlimit.2 under the description of the EACCES error.
1459
1460 Noted 2.6.12 change in credentials checking for setpriority().
1461
1462 getrlimit.2
1463 mtk
1464 Added description of RLIMIT_RTPRIO
1465
1466 Added description of RLIMIT_NICE
1467
1468 mmap.2
1469 mtk
1470 Noted bug in MAP_POPULATE for kernels before 2.6.7.
1471
1472 mremap.2
1473 mtk
1474 Added _GNU_SOURCE to prototype.
1475 Rewrote description of MREMAP_MAYMOVE.
1476 Rewrote description of EAGAIN error.
1477 Added discussion of resizing of memory locks.
1478 Added entries to SEE ALSO.
1479 Some formatting fixes.
1480
1481 msgctl.2
1482 mtk
1483 Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1484
1485 nanosleep.2
1486 Baurzhan Ismagulov
1487 Add to prototype: define _POSIX_C_SOURCE 199309
1488 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=314435
1489
1490 nice.2
1491 mtk
1492 Added sentence noting that range of the nice value is described
1493 in getpriority.2.
1494 Added cross-reference to setrlimit(2) for discussion on
1495 RLIMIT_NICE.
1496
1497 outb.2
1498 David N. Welton / Justin Pryzby / mtk
1499 Clarified the order of value and port arguments;
1500 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263756
1501
1502 pause.2
1503 mtk
1504 Added SEE ALSO for sigsuspend.2
1505 Some formatting fixes.
1506
1507 poll.2
1508 Tommy Pettersson
1509 nfds should be prototyped as nfds_t
1510 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=322934
1511
1512 mtk
1513 Some wording and formatting improvements.
1514
1515 prctl.2
1516 mtk
1517 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1518
1519 rand.3
1520 Hrvoje Niksic / mtk
1521 Remove misleading text describing FreeBSD's sranddev() function.
1522 As per debian bug 328629
1523
1524 readv.2
1525 mtk / Walter harms
1526 Added LINUX NOTES on trickery performed by glibc when
1527 vector size exceeds IOV_MAX.
1528
1529 Formatting clean-ups.
1530
1531 remap_file_pages.2
1532 mtk
1533 Added text to note that start and size are both rounded downward.
1534
1535 sched_setparam.2
1536 mtk
1537 Modified discussion of privileges; added pointer to
1538 sched_setscheduler.2 for a discussion of privileges and
1539 resource limits.
1540
1541 sched_setscheduler.2
1542 mtk
1543 Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
1544
1545 semctl.2
1546 mtk
1547 Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1548
1549 shmctl.2
1550 mtk
1551 Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1552
1553 sigaction.2
1554 mtk
1555 Split sigpending(), sigprocmask(), and sigsuspend() out
1556 into separate new pages.
1557
1558 Other minor changes
1559
1560 mtk
1561 NOTES: described SA_NODEFER / sa_mask bug which was present in
1562 all kernels up to and including 2.6.13.
1563 See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
1564 and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
1565 List: linux-kernel
1566 Subject: Signal handling possibly wrong
1567 From: Bodo Stroesser
1568 Date: 2005-08-09 17:44:06
1569
1570 signal.2
1571 mtk
1572 Updated SEE ALSO to reflect splitting of sigaction.2 into
1573 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1574
1575 sigpending.2
1576 mtk
1577 New page created by splitting out from sigaction.2
1578 Changed CONFORMING TO.
1579
1580 sigprocmask.2
1581 mtk
1582 New page created by splitting out from sigaction.2
1583 Added text on effect of NULL for 'set' argument.
1584 Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
1585 and SIGSEGV.
1586 Noted that sigprocmask() can't be used in multithreaded process.
1587 Fixed EINVAL error diagnostic.
1588 Changed CONFORMING TO.
1589
1590 sigsuspend.2
1591 mtk
1592 New page created by splitting out from sigaction.2
1593 Added NOTES on usage.
1594 Added new text to DESCRIPTION.
1595 Changed CONFORMING TO.
1596
1597 stat.2
1598 Mike Frysinger
1599 Improve st_blocks description.
1600
1601 carg.3
1602 Ramiro Aceves / aeb
1603 Change:
1604 One has carg(z) = atan(creal(z) / cimag(z))
1605 to:
1606 One has tan(carg(z)) = cimag(z) / creal(z)
1607
1608 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=326720
1609
1610 cmsg.3
1611 mtk
1612 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1613
1614 dlopen.3
1615 Alain Portal
1616 s/-nostartupfiles/-nostartfiles/
1617
1618 getaddrinfo.3
1619 mtk
1620 Nowadays (since 2.3.4) glibc only sets the first ai_canonname
1621 field if AI_CANONNAME was specified (the current behavior
1622 is all that SUSv3 requires).
1623
1624 1,$s/PF_/AF_/g
1625
1626 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
1627 and AI_NUMERICSERV.
1628
1629 Some wording and formatting fixes.
1630
1631 getpwnam.3
1632 Bernhard R. Link / mtk
1633 Add NOTES text describing relationship of pw_dir and HOME and
1634 pointing out that applications should preferentially inspect HOME.
1635
1636 inet.3
1637 Mike Frysinger
1638 Mention "little endian" and "big endian".
1639 Added note about octal and hex interpretation of
1640 numbers-and-dots notation.
1641
1642 rpc.3
1643 mtk / Ludovic Courtes
1644 Commented out references to rpc_secure(3) -- we don't currently
1645 have such a page in the man-pages set.
1646 In response to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325115
1647
1648 setenv.3
1649 mtk
1650 glibc 2.3.4 fixed the "name contains '='" bug.
1651
1652 strnlen.3
1653 Mike Frysinger
1654 Added "#define _GNU_SOURCE" to prototype.
1655
1656 initrd.4
1657 Norbert Buchmuller / mtk
1658 Added text noting that the use or real-root-dev for changing
1659 the root device is obsolete, in favor of pivot root.
1660 (However, the page still needs to be rewritten to actually
1661 describe the pivot_root method...)
1662 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=323621
1663
1664 proc.5
1665 mtk
1666 Improve text describing /proc/sys/fs/mqueue/* files.
1667
1668 Describe /proc/sys/fs/suid_dumpable (new in 2.6.13).
1669
1670 Added placeholder mention of /proc/zoneinfo (new in 2.6.13).
1671 More needs to be said about this file.
1672
1673 Repaired earlier cut and paste mistake which resulted
1674 in part of the text of this page being duplicated.
1675
1676 utmp.5
1677 Mike Frysinger
1678 Added text on biarch details for ut_session and ut_tv.
1679
1680 capabilities.7
1681 mtk
1682 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1683
1684 ip.7
1685 mtk / Andrew Pimlott
1686 Add a couple of words to make it clear that port is a 16-bit number.
1687 Reformat long source lines (no text changed).
1688
1689 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1690
1691 Hasso Tepper
1692 Fix discussion of IPC_RECVTTL / IP_TTL.
1693
1694 signal.7
1695 mtk
1696 Updated SEE ALSO to reflect splitting of sigaction.2 into
1697 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2.
1698
1699 socket.7
1700 mtk
1701 Clarified details of use of SO_PEERCRED.
1702
1703 tcp.7
1704 mtk
1705 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1706 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1707
1708 udp.7
1709 mtk
1710 Added description of UDP_CORK socket option.
1711
1712 s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name)
1713 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1714
1715
1716 ==================== Changes in man-pages-2.09 ====================
1717
1718 Released: 2005-10-13
1719
1720 Contributors
1721 ------------
1722
1723 The following people contributed notes, ideas, or patches that have
1724 been incorporated in changes in this release:
1725
1726 Justin Pryzby <pryzbyj@justinpryzby.com>
1727 Peter Chubb <peterc@gelato.unsw.edu.au>
1728 Samuel Thibault <samuel.thibault@ens-lyon.org>
1729 Tomas Pospisek <tpo_deb@sourcepole.ch>
1730 Trond Myklebust <trond.myklebust@fys.uio.no>
1731
1732 Apologies if I missed anyone!
1733
1734 Global changes
1735 --------------
1736
1737 ptsname.3
1738 getpt.3
1739 unlockpt.3
1740 openpty.3
1741 posix_openpt.3
1742 grantpt.3
1743 pts.4
1744 tty_ioctl.4
1745 mtk
1746 Added SEE ALSO for new pty.7 page.
1747
1748 Typographical or grammatical errors have been corrected in several
1749 places.
1750
1751
1752 New pages
1753 ---------
1754
1755 pty.7
1756 mtk
1757 Overview of Unix 98 and BSD pseudo-terminals.
1758
1759
1760 Changes to individual pages
1761 ---------------------------
1762
1763 ldd.1
1764 mtk
1765 Remove "-V" option (fix from Fedora man-pages-2.07-7).
1766
1767 fcntl.2
1768 Peter Chubb / Trond Myklebust / mtk
1769 Since kernel 2.6.10, a read lease can only be placed on a
1770 file descriptor that is opened read-only.
1771 See the following LKML thread of Aug 2005
1772 ("fcntl(F GETLEASE) semantics??"):
1773 http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
1774 http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
1775 http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
1776 http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
1777
1778 mprotect.2
1779 mtk
1780 Add new text to ENOMEM error.
1781
1782 mremap.2
1783 mtk
1784 Added description of MREMAP_FIXED and 'new_address' argument
1785 under NOTES.
1786 Revised text of EINVAL error.
1787
1788 read.2
1789 Samuel Thibault / mtk
1790 read() can fail with EINVAL when using O_DIRECT
1791 mtk
1792 Added open(2) to SEE ALSO.
1793
1794 shmget.2
1795 mtk
1796 s/int/size_t/ for type of 'size' argument (fix from
1797 Fedora man-pages-2.07-7).
1798
1799 write.2
1800 Samuel Thibault / mtk
1801 write() can fail with EINVAL when using O_DIRECT
1802
1803 atanh.3
1804 mtk
1805 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7).
1806
1807 fopen.3
1808 mtk
1809 Improved "a+" description (fix from Fedora man-pages-2.07-7).
1810
1811 getrpcent.3
1812 mtk
1813 s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
1814
1815 stdio.3
1816 mtk / Justin Pryzby
1817 Removed references to fropen() and fwopen(), which are
1818 BSDisms that don't appear in glibc.
1819 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
1820
1821 strftime.3
1822 mtk
1823 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
1824 Fedora man-pages-2.07-7).
1825
1826 nsswitch.conf.5
1827 mtk
1828 s/network/networks/ (fix from Fedora man-pages-2.07-7).
1829
1830 proc.5
1831 mtk
1832 Added description of /proc/sys/vm/legacy_va_layout.
1833
1834 socket.7
1835 mtk
1836 Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1837 (fix derived from Fedora man-pages-2.07-7).
1838
1839
1840 ==================== Changes in man-pages-2.10 ====================
1841
1842 Released: 2005-10-19
1843
1844 Global changes
1845 --------------
1846
1847 The changes in this release consist *solely* of formatting fixes, with
1848 the aim bringing greater consistency to the manual pages according to
1849 the following rules:
1850
1851 -- Function name references should *always* be followed by
1852 parentheses, "()" (possibly containing a manual page section
1853 number).
1854
1855 -- The parentheses following a function name should *not* be
1856 formatted. Thus, for example, instead of:
1857
1858 .B name()
1859
1860 one should write:
1861
1862 .BR name ()
1863
1864 Much of the change was automated using two scripts:
1865 add_parens_for_own_funcs.sh and unformat_parens.sh.
1866 For the (possible) benefit of downstream manual page maintainers and
1867 translators, I have placed these scripts in a new subdirectory 'scripts'.
1868
1869 NOTE THE FOLLOWING POINTS WELL:
1870
1871 -- These scripts provide a computer-assisted solution to the above
1872 two goals. However, they are not perfect, and their output should
1873 be scanned by a human. (To see what changes the two scripts
1874 *would* make, without making them, use the "-n" command line option.)
1875
1876 -- The scripts do not fix all instances that violate the above rules:
1877 some manual fixes are required. Two further scripts are provided
1878 to help find remaining instances of function names without
1879 following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1880
1881 The following changes were made:
1882
1883 -- add_parens_for_own_funcs.sh was applied to the pages in Sections
1884 2 and 3.
1885
1886 -- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
1887 (the only sections where such changes were required).
1888
1889 -- further changes (not so very many) were performed by hand.
1890 (found places to fix with the assistance of find_dots_no_parens.sh
1891 and find_slashes_no_parens.sh).
1892
1893
1894 ==================== Changes in man-pages-2.11 ====================
1895
1896 Released: 2005-10-24
1897
1898 Contributors
1899 ------------
1900
1901 The following people contributed notes, ideas, or patches that have
1902 been incorporated in changes in this release:
1903
1904 Alain PORTAL <aportal@univ-montp2.fr>
1905
1906 Apologies if I missed anyone!
1907
1908 Global changes
1909 --------------
1910
1911 Various pages
1912 mtk
1913 Most instances of the constant "NULL" are not formatted (bolded) in
1914 man pages, but a few are. For consistency, formatting on "NULL" has
1915 been removed where it occurred.
1916
1917 Many minor formatting fixes were made.
1918
1919 Typographical or grammatical errors have been corrected in several
1920 places.
1921
1922
1923 Changes to individual pages
1924 ---------------------------
1925
1926 getrlimit.2
1927 mtk
1928 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1929
1930 path_resolution.2
1931 mtk
1932 Repaired discussion of capabilities and file system UID, which
1933 mistakenly had involved exec() in the discussion.
1934
1935 prctl.2
1936 mtk
1937 Removed text saying there is no library interface. There
1938 is nowadays.
1939
1940 mkfifo.3
1941 mtk
1942 Minor change to RETURN VALUE text.
1943
1944 sk98lin.4
1945 Alain Portal
1946 Formatting fixes.
1947
1948 capabilities.7
1949 mtk
1950 Minor changes.
1951
1952
1953 ==================== Changes in man-pages-2.12 ====================
1954
1955 Released: 2005-10-31
1956
1957 Contributors
1958 ------------
1959
1960 The following people contributed notes, ideas, or patches that have
1961 been incorporated in changes in this release:
1962
1963 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1964 Andries Brouwer <Andries.Brouwer@cwi.nl>
1965 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
1966 herbert <herbert@gondor.apana.org.au>
1967 Martin Landers <martin.landers@treibgut.net>
1968 Michael Benedict <benedict@starbak.net>
1969
1970 Apologies if I missed anyone!
1971
1972 Global changes
1973 --------------
1974
1975 Typographical or grammatical errors have been corrected in several
1976 places.
1977
1978
1979 Changes to individual pages
1980 ---------------------------
1981
1982 mlock.2
1983 mtk
1984 Reworded text around PAGESIZE, noting also that
1985 sysconf(_SC_PAGESIZE) can be used.
1986
1987 path_resolution.2
1988 mtk / aeb
1989 Removed words "as well" (added in 2.11) from the phrase
1990 "and it gets these last five capabilities if its fsuid is 0 as well"
1991 since there are (unusual) situations in which fsuid can be 0 while
1992 the effective UID is not.
1993
1994 Reworked (cut down) discussion of capabilities, moving part of
1995 it into capabilities.7
1996
1997 setresuid.2
1998 mtk
1999 Add text to note that setresuid() always modifies the file
2000 system UID, and setresgid() likewise always modifies the file
2001 system GID.
2002
2003 shmget.2
2004 mtk
2005 Added (brief) description of SHM_HUGETLB.
2006
2007 sigaltstack.2
2008 mtk / Martin Landers
2009 Noted that ss_sp is automatically aligned by the kernel.
2010
2011 byteorder.3
2012 Brian M. Carlson / herbert
2013 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
2014 explaining that some systems need the former header.
2015 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=265244
2016
2017 capabilities.7
2018 mtk
2019 Reworked part of the discussion of exec() and capabilities.
2020 Added sub-section "Effect of User ID Changes on Capabilities".
2021 Reworked discussion of CAP_SYS_ADMIN and file-max.
2022
2023
2024 ==================== Changes in man-pages-2.13 ====================
2025
2026 Released: 2005-11-03
2027
2028 This release consists entirely of formatting and typographical fixes.
2029
2030 Global changes
2031 --------------
2032
2033 Typographical or grammatical errors have been corrected in several
2034 places.
2035
2036 Various pages
2037 mtk
2038 Function and page cross references that were italicized were
2039 made bold (which is how the majority of function and page
2040 cross references were already done).
2041
2042 Various pages
2043 mtk
2044 Instances of things like "NULL-terminated string" were changed to
2045 "null-terminated string".
2046
2047 Various pages
2048 mtk
2049 Pathnames, structures, arguments, and <header-files> that were
2050 bold were changed to italics.
2051
2052 Various pages
2053 mtk
2054 Instances of the constant "NULL" that were bold-faced were made
2055 unformatted (which is how most instances of "NULL" were already
2056 formatted.)
2057
2058
2059 ==================== Changes in man-pages-2.14 ====================
2060
2061 Released: 2005-11-17
2062
2063 Contributors
2064 ------------
2065
2066 The following people contributed notes, ideas, or patches that have
2067 been incorporated in changes in this release:
2068
2069 Angelo <ang3l0@katamail.com>
2070 Avery Pennarun <apenwarr@nit.ca>
2071 Justin Pryzby <justinpryzby@users.sourceforge.net>
2072 Martin (Joey) Schulze <joey@infodrom.org>
2073 Stefan Brüns <stefan.bruens@rwth-aachen.de>
2074 Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2075
2076 Apologies if I missed anyone!
2077
2078 Global changes
2079 --------------
2080
2081 Typographical or grammatical errors have been corrected in several
2082 places.
2083
2084 New pages
2085 ---------
2086
2087 rexec.3
2088 mtk / Justin Pryzby
2089 This page is taken as is from the FreeBSD 5.4 distribution.
2090 (Not checked against Linux reality, but likely things are
2091 the same.)
2092 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=336875
2093
2094 Changes to individual pages
2095 ---------------------------
2096
2097 arch_prctl.2
2098 mtk
2099 Updated discussion about lack of prototype in glibc.
2100
2101 execve.2
2102 mtk
2103 Improved description of E2BIG error: it relates to the sum
2104 of the bytes in both environment and argument list.
2105
2106 fcntl.2
2107 mtk
2108 Clarified parts of the discussion of file leases,
2109 noting effect of open(O_NONBLOCK), interruption
2110 by signal handler, or termination by signal in
2111 lease breaker. In response to
2112 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2113
2114 stat.2
2115 mtk / Stefan Brüns
2116 Added LINUX NOTES describing nanosecond timestamps.
2117
2118 frexp.3
2119 Volker Reichelt / mtk
2120 Fixed to point out that frexp() returns a number whose
2121 *absolute* value is >= 0.5 and < 1. Amended the example
2122 program to demonstrate this.
2123
2124 open.2
2125 mtk / Avery Pennarun
2126 Add EWOULDBLOCK error for file leases.
2127 In response to
2128 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
2129
2130 putenv.3
2131 mtk
2132 Although the glibc implementation returns -1 on error (and some
2133 other man pages (e.g., the BSDs) also document that value for
2134 error returns), SUSv3 merely says "non-zero" (and this is
2135 what manual pages on many implementations also say).
2136
2137 posix_memalign.3
2138 mtk
2139 Formerly, the page said that all systems declare memalign() in
2140 <malloc.h>. In fact, many declare it in <stdlib.h>.
2141
2142 strtok.3
2143 mtk
2144 Almost a complete rewrite after Angelo pointed out
2145 that the existing page was deficient.
2146
2147 sd.4
2148 Martin Schulze
2149 Remove SEE ALSO for nonexistent scsi.4.
2150
2151 proc.5
2152 mtk
2153 Updated discussion of /proc/sys/kernel/pid_max.
2154
2155 signal.7
2156 mtk
2157 Added pthreads.7 to SEE ALSO.
2158
2159 ld.so.8
2160 mtk
2161 Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2162
2163
2164 ==================== Changes in man-pages-2.15 ====================
2165
2166 Released: 2005-11-30
2167
2168 Contributors
2169 ------------
2170
2171 The following people contributed notes, ideas, or patches that have
2172 been incorporated in changes in this release:
2173
2174 Andries Brouwer <Andries.Brouwer@cwi.nl>
2175 James Vega <jamessan@debian.org>
2176 Malcolm Scott <mas90@io.malc.org.uk>
2177 Senthil Kumar <senthilkumar_sen@hotpop.com>
2178
2179 Apologies if I missed anyone!
2180
2181 Global changes
2182 --------------
2183
2184 Typographical or grammatical errors have been corrected in several
2185 places.
2186
2187 New pages
2188 ---------
2189
2190 sigvec.3 -- for details, see below.
2191
2192 sigset.3 -- for details, see below.
2193
2194 Changes to individual pages
2195 ---------------------------
2196
2197 kill.2
2198 mtk
2199 Added text describing the 2.6.[0-7] EPERM bug that occurred
2200 when sending signals to a process group.
2201
2202 sigaction.2
2203 mtk
2204 Noted that si_signo is unused on Linux.
2205
2206 sigpending.2
2207 mtk
2208 Added BUGS noting wrapper function problem that existed
2209 in glibc versions <= 2.2.1.
2210
2211 sigpause.2
2212 mtk
2213 Moved to section 3; see also sigpause.3 below.
2214
2215 sigsetops.3
2216 mtk
2217 Added a GLIBC NOTES section describing sigisemptyset(),
2218 sigandset(), and sigorset().
2219
2220 sigvec.2
2221 sigblock.2
2222 mtk
2223 These pages have been deleted, and replaced by a new sigvec.3
2224 man page that more fully describes the BSD signal API.
2225
2226 siggetmask.2
2227 sigmask.2
2228 sigsetmask.2
2229 mtk
2230 These links to the now-deleted sigblock.2 have been also been
2231 deleted. They are replaced by corresponding links in Section 3:
2232 sigmask.3, sigsetmask.3, siggetmask.3.
2233
2234 sigvec.3
2235 mtk
2236 This new page is provides a fuller description of the
2237 BSD signal API than was provided in the now-deleted sigvec.2
2238 and sigblock.2.
2239
2240 sigblock.3
2241 siggetmask.3
2242 sigmask.3
2243 sigsetmask.3
2244 mtk
2245 Created as links to sigvec.3.
2246
2247 sigpause.3
2248 mtk
2249 Moved here from Section 2.
2250
2251 Some minor wording fixes; clarified System V origins of
2252 X/Open flavor of this function.
2253
2254 sigset.3
2255 mtk
2256 New page describing the System V signal API: sigset(), sighold(),
2257 sigrelse(), sigignore().
2258
2259 strftime.3
2260 James Vega
2261 Add further text clarifying that %+ specifier is not supported in
2262 glibc2.
2263 mtk
2264 Added GLIBC NOTES section describing optional 'flag' and 'width'
2265 components of conversion specifiers.
2266 Some wording changes to bring terminology closer to SUSv3.
2267 Added an example program.
2268
2269 vm86old.2
2270 mtk / aeb
2271 Add as new link to vm86.2.
2272
2273 intro.7
2274 mtk
2275 Added a few words to reflect the fact that several of the section
2276 7 pages provide overviews of various topics.
2277
2278 signal.7
2279 mtk
2280 Added some SEE ALSO entries.
2281
2282 socket.7
2283 Senthil Kumar / mtk
2284 Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2285
2286 udp.7
2287 Malcolm Scott
2288 s/tcp_socket/udp_socket/ in example
2289 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=340927
2290
2291
2292 ==================== Changes in man-pages-2.16 ====================
2293
2294 Released: 2005-12-02
2295
2296 Contributors
2297 ------------
2298
2299 The following people contributed notes, ideas, or patches that have
2300 been incorporated in changes in this release:
2301
2302 Alan Stern <stern@rowland.harvard.edu>
2303 Andries Brouwer <Andries.Brouwer@cwi.nl>
2304 Urs Thuermann <urs@isnogud.escape.de>
2305
2306 Apologies if I missed anyone!
2307
2308 Global changes
2309 --------------
2310
2311 Typographical or grammatical errors have been corrected in several
2312 places.
2313
2314
2315 Changes to individual pages
2316 ---------------------------
2317
2318 HOWTOHELP
2319 Urs Thuermann
2320 Added instructions for finding maintainer in Debian package.
2321
2322 poll.2
2323 mtk
2324 Added NOTES about INFTIM constant provided on some other
2325 implementations.
2326
2327 shmop.2
2328 Alan Stern
2329 The -1 error return of shmat() should be cast "(void *)".
2330
2331 strftime.3
2332 aeb
2333 Remove junk text (actually intended as source code comment
2334 in page).
2335
2336 ip.7
2337 Urs Thuermann
2338 Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2339
2340 packet.7
2341 Urs Thuermann
2342 Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2343
2344
2345 ==================== Changes in man-pages-2.17 ====================
2346
2347 Released: 2005-12-13
2348
2349 Contributors
2350 ------------
2351
2352 The following people contributed notes, ideas, or patches that have
2353 been incorporated in changes in this release:
2354
2355 Justin Pryzby <justinpryzby@users.sourceforge.net>
2356 Michael Haardt <michael@moria.de>
2357 Urs Thuermann <urs@isnogud.escape.de>
2358 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2359
2360 Apologies if I missed anyone!
2361
2362
2363 Global changes
2364 --------------
2365
2366 Typographical or grammatical errors have been corrected in several
2367 places.
2368
2369
2370 New pages
2371 ---------
2372
2373 fmemopen.3
2374 Walter Harms / mtk
2375 New documentation for the glibc-specific fmemopen() and
2376 open_memstream(). Based on glibc info page.
2377
2378 pipe.7
2379 mtk (with prompting and suggestions for improvements by
2380 Michael Haardt)
2381 New page providing overview of pipes and FIFOs.
2382
2383
2384 Changes to individual pages
2385 ---------------------------
2386
2387 HOWTOHELP
2388 mtk
2389 Added notes on how to write example programs for manual pages.
2390
2391 fork.2
2392 mtk
2393 Added pointers to examples of fork() in wait.2 and pipe.2.
2394
2395 pipe.2
2396 mtk
2397 Added an example program.
2398 Added SEE ALSO for new pipe.7 page.
2399
2400 wait.2
2401 mtk
2402 Added example program demonstrating use of fork() and waitpid().
2403
2404 carg.3
2405 Justin Pryzby
2406 Delete line that should have been deleted when applying
2407 2.08 fix for this page.
2408
2409 getaddrinfo.3
2410 mtk
2411 Rearranged EAI_* list alphabetically.
2412
2413 inet.3
2414 mtk
2415 Added GLIBC NOTES describing feature test macros required
2416 to expose declaration of inet_aton().
2417
2418 open_memstream.3
2419 mtk
2420 New link to new fmemopen.3.
2421
2422 fifo.4
2423 mtk
2424 Added SEE ALSO for new pipe.7 page.
2425
2426 environ.5
2427 mtk
2428 Removed BROWSER, since it seems not in fact to be common.
2429
2430 socket.7
2431 Urs Thuermann
2432 Added documentation of SO_TIMESTAMP.
2433
2434 tcp.7
2435 mtk
2436 Noted 200 millisecond ceiling imposed on TCP_CORK.
2437
2438 udp.7
2439 mtk
2440 Rearranged options into something approximating alphabetical order.
2441
2442
2443 ==================== Changes in man-pages-2.18 ====================
2444
2445 Released: 2005-12-15
2446
2447 Contributors
2448 ------------
2449
2450 The following people contributed notes, ideas, or patches that have
2451 been incorporated in changes in this release:
2452
2453 Justin Pryzby <justinpryzby@users.sf.net>
2454 Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2455 Martin (Joey) Schulze <joey@infodrom.org>
2456 Mike Frysinger <vapier@gentoo.org>
2457 Stefan Puiu <stefanpuiuro@yahoo.com>
2458
2459 Apologies if I missed anyone!
2460
2461
2462 Global changes
2463 --------------
2464
2465 Typographical or grammatical errors have been corrected in several
2466 places.
2467
2468
2469 Changes to individual pages
2470 ---------------------------
2471
2472 bind.2
2473 mtk
2474 Added mention of AF_INET6 address family.
2475 Added discussion of sockaddr structure and an example in the
2476 Unix domain.
2477
2478 recv.2
2479 mtk
2480 Put 'flags' list in alphabetical order.
2481
2482 send.2
2483 mtk
2484 Added cross-reference from discussion of MSG_MORE to UDP_CORK
2485 in udp(7).
2486
2487 Put 'flags' list in alphabetical order.
2488
2489 err.3
2490 mtk
2491 Added CONFORMING TO section noting that these are
2492 non-standard BSDisms.
2493
2494 errno.3
2495 Justin Pryzby
2496 Added SEE ALSO for err.3.
2497 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2498
2499 gethostbyname.3
2500 Martin (Joey) Schulze / mtk
2501 Added references to nsswitch.conf(5); remove cross references
2502 to resolv+(8).
2503 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308397
2504
2505 perror.3
2506 Justin Pryzby
2507 Added SEE ALSO for err.3 .
2508 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2509
2510 resolver.3
2511 mtk / Martin (Joey) Schulze
2512 Remove cross references to resolv+(8); add cross references to
2513 resolv.conf(5).
2514 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=214892
2515
2516 Added SEE ALSO entry for resolver(5);
2517 see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=251122
2518
2519 strerror.3
2520 mtk / Stefan Puiu
2521 Rewrote and extended the discussion of the two flavors of
2522 strerror_r(), and added some additional information on
2523 strerror().
2524 Justin Pryzby
2525 Added SEE ALSO for err.3, as per
2526 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
2527
2528
2529 elf.5
2530 Mike Frysinger
2531 Fix three typos in identifier names.
2532
2533 operator.7
2534 Karsten Sperling
2535 The + operator should be in the list of unary operators.
2536
2537 raw.7
2538 mtk
2539 Small wording changes around discussion of SO_BSDCOMPAT.
2540 Fixed a couple of wording errors elsewhere.
2541 Reformatted some long lines.
2542
2543 socket.7
2544 mtk, after a note by Stefan Puiu
2545 Updated discussion of SO_BSDCOMPAT.
2546
2547 Reformatted some long lines.
2548
2549 Noted the Linux-specific feature whereby setsockopt() doubles
2550 the value given for SO_SNDBUF and SO_RCVBUF.
2551
2552 Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
2553
2554 udp.7
2555 mtk, after a note by Stefan Puiu
2556 Updated discussion of SO_BSDCOMPAT.
2557
2558 unix.7
2559 mtk
2560 Added new (UN)SUPPORTED FEATURES section in which it is noted
2561 that Unix domain sockets do not support MSG_OOB or MSG_MORE.
2562
2563 Noted details of SO_SNBUF and SO_RCVBUF support for
2564 Unix domain sockets.
2565
2566
2567 ==================== Changes in man-pages-2.19 ====================
2568
2569 Released: 2005-12-23
2570
2571 Contributors
2572 ------------
2573
2574 The following people contributed notes, ideas, or patches that have
2575 been incorporated in changes in this release:
2576
2577 Andries Brouwer <Andries.Brouwer@cwi.nl>
2578 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2579 Stefan Puiu <stefanpuiuro@yahoo.com>
2580
2581 Apologies if I missed anyone!
2582
2583
2584 Global changes
2585 --------------
2586
2587 Typographical or grammatical errors have been corrected in several
2588 places.
2589
2590
2591 Changes to individual pages
2592 ---------------------------
2593
2594 HOWTOHELP
2595 mtk
2596 Minor changes.
2597
2598 bind.2
2599 Stefan Puiu / mtk
2600 Remove text under EINVAL error: "This may change in the future:
2601 see linux/unix/sock.c for details." This behavior has been
2602 unchanged for a long time, and seems unlikely to change.
2603
2604 Add EADDRINUSE to errors.
2605
2606 send.2
2607 aeb
2608 Add cmsg(3) to SEE ALSO.
2609
2610 fopen.3
2611 Walter Harms / mtk
2612 Added description of 'x' mode character (exclusive open).
2613
2614 pipe.7
2615 mtk / aeb
2616 Some wording changes to description of pipes.
2617
2618
2619 ==================== Changes in man-pages-2.20 ====================
2620
2621 Released: 2006-01-03
2622
2623 Global changes
2624 --------------
2625
2626 Typographical or grammatical errors have been corrected in several
2627 places.
2628
2629
2630 Changes to individual pages
2631 ---------------------------
2632
2633 sigaltstack.2
2634 mtk
2635 Added some text to explain the usual scenario in which
2636 sigaltstack() is employed.
2637
2638 getloadavg.3
2639 mtk
2640 Noted that this function is available since glibc 2.2.
2641
2642 strcpy.3
2643 mtk
2644 s/nulls/null bytes/
2645
2646 capabilities.7
2647 mtk
2648 Noted that capability bounding set appeared with kernel 2.2.11.
2649
2650 arp.7
2651 icmp.7
2652 ip.7
2653 ipv6.7
2654 netdevice.7
2655 packet.7
2656 raw.7
2657 rtnetlink.7
2658 socket.7
2659 tcp.7
2660 unix.7
2661 udp.7
2662 mtk
2663 The only changes to these pages have been for formatting:
2664 -- Structure definitions were changed to K&R style
2665 -- Some long source lines were broken to fit into ~70
2666 character lines.
2667 No changes were made to the content of these pages (yet...).
2668
2669
2670 ==================== Changes in man-pages-2.21 ====================
2671
2672 Released: 2006-01-16
2673
2674 Contributors
2675 ------------
2676
2677 The following people contributed notes, ideas, or patches that have
2678 been incorporated in changes in this release:
2679
2680 Andries Brouwer <Andries.Brouwer@cwi.nl>
2681 Falk Hueffner <falk@debian.org>
2682 Mike Frysinger <vapier@gentoo.org>
2683 Senthil Kumar <senthilkumar_sen@hotpop.com>
2684 Stefan Puiu <stefanpuiuro@yahoo.com>
2685
2686 Apologies if I missed anyone!
2687
2688
2689 Global changes
2690 --------------
2691
2692 dd.1 cp.1
2693 truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2694 sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2695 argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
2696 gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2697 perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
2698 strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2699 dsp56k.4 tty_ioctl.4
2700 elf.5 proc.5 termcap.5
2701 charsets.7 unix.7
2702 mtk
2703 Various pages use inconsistent terms for 'null byte' (which
2704 is the C99/SUSv3 term for the '\0' character).
2705
2706 To rectify this the following changes were made in the above
2707 pages:
2708
2709 Replace 'zero byte' with 'null byte'.
2710 Replace 'null character' with 'null byte'.
2711 Replace 'nulls' with 'null bytes'.
2712 Replace 'NUL-terminated' by 'null-terminated'.
2713 Replace 'NUL' by 'null byte'.
2714 Replace 'terminating NUL' by 'terminating null byte'.
2715 Replace 'final NUL' by 'terminating null byte'.
2716 Replace 'NUL character' by 'null byte'.
2717
2718 Various pages
2719 mtk
2720 Replace "SysV"/"SYSV" by "System V".
2721
2722 Typographical or grammatical errors have been corrected in several
2723 places.
2724
2725
2726 Changes to individual pages
2727 ---------------------------
2728
2729 capget.2
2730 mtk
2731 Noted bug that could wrongly cause EPERM in unprivileged
2732 capset() with 'pid' field == getpid().
2733
2734 epoll_ctl.2
2735 mtk
2736 Noted that EPOLLONESHOT was added in 2.6.2.
2737
2738 gethostname.2
2739 mtk
2740 Added GLIBC NOTES describing operation of glibc's
2741 gethostname() wrapper function.
2742
2743 mmap.2
2744 mtk / Mike Frysinger
2745 Clarify relationship between mmap2(2) and mmap64(3).
2746 mtk
2747 A few other small rewordings.
2748
2749 mmap64.3
2750 Mike Frysinger
2751 New link to mmap.2.
2752
2753 open.2
2754 mtk
2755 Added BUG noting that O_ASYNC can't be enabled via
2756 open(): fcntl() must be used for this purpose.
2757
2758 recv.2
2759 Stefan Puiu
2760 Relocate misplaced discussion of MSG_DONTWAIT.
2761
2762 dlopen.3
2763 mtk
2764 Rewrote discussion of dlopen() 'flag' argument;
2765 added descriptions of RTLD_NOLOAD, RTLD_DELETE,
2766 and RTLD_DEEPBIND.
2767
2768 Noted use of atexit() to register a function that is
2769 automatically called when a library is unloaded.
2770
2771 fmemopen.3
2772 mtk
2773 Rewrote substantial parts of the page, and relicensed under GPL.
2774
2775 fseeko.3
2776 Mike Frysinger
2777 Add RETURN VALUE section.
2778
2779 getopt.3
2780 mtk
2781 Noted historical use of <stdio.h> to declare getopt().
2782
2783 qsort.3
2784 mtk / Falk Hueffner
2785 Clarify how strcmp() should be used as the 'compar'
2786 function by providing an example.
2787 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348072
2788
2789 proc.5
2790 mtk
2791 Noted that /proc/mounts is pollable since kernel 2.6.15.
2792
2793 Documented /proc/PID/task.
2794
2795 Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
2796 are not available if the main thread has terminated.
2797
2798 Senthil Kumar
2799 Add pointer to random(4) for description of files under
2800 /proc/sys/kernel/random.
2801
2802 udp.7
2803 Stefan Puiu / mtk
2804 Small rewording of discussion of SO_BSDCOMPAT
2805 (add cross-ref to socket(7)).
2806
2807
2808 ==================== Changes in man-pages-2.22 ====================
2809
2810 Released: 2006-02-02
2811
2812 Contributors
2813 ------------
2814
2815 The following people contributed notes, ideas, or patches that have
2816 been incorporated in changes in this release:
2817
2818 Alain Portal <aportal@univ-montp2.fr>
2819 Andre Noll <maan@systemlinux.org>
2820 Andries Brouwer <Andries.Brouwer@cwi.nl>
2821 Colin Tuckley <colin@tuckley.org>
2822 Stefan Puiu <stefanpuiuro@yahoo.com>
2823 Thomas Hood <jdthood@yahoo.co.uk>
2824 Thorsten Kukuk <kukuk@suse.de>
2825 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2826
2827
2828 Global changes
2829 --------------
2830
2831 Typographical or grammatical errors have been corrected in several
2832 places.
2833
2834 Changes to individual pages
2835 ---------------------------
2836
2837 mmap.2
2838 aeb / mtk
2839 Noted that portable applications should specify fd as -1
2840 when using MAP_ANONYMOUS.
2841 Some rewriting of description of MAP_ANONYMOUS.
2842
2843 rt_sigreturn.2
2844 Thorsten Kukuk
2845 New link to sigreturn.2.
2846
2847 rt_sigsuspend.2
2848 mtk
2849 New link to sigsuspend.2.
2850
2851 waitid.2
2852 mtk
2853 Noted that waitid() does not set infop->si_uid field on
2854 most other implementations.
2855
2856 getopt.3
2857 Walter harms / mtk
2858 Make clear that when calling getopt_long() and there are no
2859 short options, then 'optstring' should be "", not NULL.
2860
2861 openpty.3
2862 Thomas Hood / mtk
2863 In glibc 2.0.92, openpty() was modified to preferably open
2864 Unix 98 ptys instead of BSD ptys.
2865
2866 qsort.3
2867 mtk
2868 Small rewording under EXAMPLES.
2869
2870 strtol.3
2871 strtoul.3
2872 Stefan Puiu
2873 s/string must begin/string may begin/
2874
2875 proc.5
2876 mtk
2877 Documented inotify files under /proc/sys/fs/inotify:
2878 max_queued_events, max_user_instances, and max_user_watches.
2879
2880
2881 ==================== Changes in man-pages-2.23 ====================
2882
2883 Released: 2006-02-10
2884
2885 Contributors
2886 ------------
2887
2888 The following people contributed notes, ideas, or patches that have
2889 been incorporated in changes in this release:
2890
2891 Andi Kleen <ak@muc.de>
2892 Britton Leo Kerin <bkerin_rb@letterboxes.org>
2893 Dan Jacobson <jidanni@jidanni.org>
2894 Justin Pryzby <justinpryzby@users.sourceforge.net>
2895 Luc Van Oostenryck <lkml@looxix.net>
2896 Kurt Wall <kwall@kurtwerks.com>
2897 Martin (Joey) Schulze <joey@infodrom.org>
2898 Matthias Andree <matthias.andree@gmx.de>
2899 Robert Love <rlove@rlove.org>
2900 Samuel Thibault <samuel.thibault@ens-lyon.org>
2901 Urs Thuermann <urs@isnogud.escape.de>
2902
2903 Apologies if I missed anyone!
2904
2905 Global changes
2906 --------------
2907
2908 Typographical or grammatical errors have been corrected in several
2909 places.
2910
2911
2912 New pages
2913 ---------
2914
2915 inotify_init.2
2916 inotify_add_watch.2
2917 inotify_rm_watch.2
2918 Robert Love, with some additions by mtk.
2919 New pages describing the inotify API.
2920
2921 mbind.2
2922 get_mempolicy.2
2923 set_mempolicy.2
2924 Andi Kleen, with additional work by mtk
2925 New pages describing the NUMA memory allocation policy API.
2926 Drawn from the set at ftp://ftp.suse.com/pub/people/ak/numa.
2927
2928 rtc.4
2929 Urs Thuermann, with additional work by mtk
2930 New page describing the real-time clock driver.
2931
2932 inotify.7
2933 mtk
2934 Overview of the inotify API.
2935
2936 Changes to individual pages
2937 ---------------------------
2938
2939 clone.2
2940 Andi Kleen
2941 On x86, clone() should not be called through vsyscall,
2942 but directly through "int $0x80".
2943
2944 fcntl.2
2945 mtk
2946 Small wording changes.
2947
2948 Added cross-ref to inotify.7 under the description of dnotify.
2949
2950 kill.2
2951 mtk / Britton Leo Kerin
2952 Small wording change under NOTES to clarify
2953 what happens when a process sends a signal to itself.
2954 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350236
2955
2956 mlock.2
2957 mtk / Matthias Andree
2958 Added BUGS txt on interaction between MCL_FUTURE and
2959 RLIMIT_MEMLOCK.
2960 See the following LKML thread:
2961 http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
2962 "Rationale for RLIMIT_MEMLOCK"
2963
2964 msgop.2
2965 mtk / Samuel Thibault
2966 Rewrote declaration of 'msgp' to be "void *" in response
2967 to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350884
2968 Various other wording fixes.
2969
2970 open.2
2971 mtk
2972 Clarify distinction between "file creation flags" and
2973 "file status flags".
2974
2975 read.2
2976 Justin Pryzby
2977 Add SEE ALSO for pread(2).
2978 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351873
2979
2980 sched_setaffinity.2
2981 mtk
2982 Major rewrite.
2983
2984 select.2
2985 mtk
2986 Added return types to prototypes for FD_SET(), FD_CLR(),
2987 FD_ZERO, and FD_ISSET().
2988 Other minor wording changes.
2989
2990 read.2
2991 mtk
2992 Add SEE ALSO for pwrite(2).
2993 (Analogous with read.2 change above.)
2994
2995 errno.3
2996 Kurt Wall / mtk
2997 Add Linux specific errors to this page.
2998
2999 localeconv.3
3000 mtk
3001 Added cross-ref to locale.7 for 'struct lconv' defn.
3002 Other minor wording changes.
3003 Martin (Joey) Schulze
3004 Added SEE ALSO refs for nl_langinfo.3
3005 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3006
3007 scanf.3
3008 mtk / Justin Pryzby
3009 Minor formatting & wording fixes.
3010
3011 setlocale.3
3012 Martin (Joey) Schulze
3013 Added SEE ALSO refs for nl_langinfo.3
3014 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
3015
3016 proc.5
3017 mtk
3018 Migrated description of inotify files to the new inotify.7 page.
3019
3020 ascii.7
3021 Dan Jacobson / mtk
3022 Add text describing characters 001 to 037.
3023 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=342173
3024
3025 locale.7
3026 mtk
3027 Minor wording and formatting changes.
3028
3029
3030 ==================== Changes in man-pages-2.24 ====================
3031
3032 Released: 2006-02-17
3033
3034 Contributors
3035 ------------
3036
3037 The following people contributed notes, ideas, or patches that have
3038 been incorporated in changes in this release:
3039
3040 Joerg Habenicht <habenich@planetserver.com>
3041 Luc Van Oostenryck <lkml@looxix.net>
3042 Mike Frysinger <vapier@gentoo.org>
3043 Samuel Thibault <samuel.thibault@ens-lyon.org>
3044
3045 Apologies if I missed anyone!
3046
3047
3048 New pages
3049 ---------
3050
3051 get_kernel_syms.2
3052 create_module.2
3053 delete_module.2
3054 init_module.2
3055 query_module.2
3056 FSF / mtk (with assistance of Luc Van Oostenryck)
3057 man-pages finally gets pages for these system calls, several
3058 of which are obsolete in Linux 2.6.
3059 Took the old GPLed pages dated 1996 and made a number of
3060 clean-ups and minor additions.
3061
3062
3063 Global changes
3064 --------------
3065
3066 various pages
3067 mtk
3068 Change "file name" to "filename"
3069 Change "path name" to "pathname"
3070
3071 stpncpy.3
3072 strstr.3
3073 strcmp.3
3074 toupper.3
3075 strlen.3
3076 stpcpy.3
3077 puts.3
3078 strdup.3
3079 strtok.3
3080 isalpha.3
3081 strspn.3
3082 gets.3
3083 strpbrk.3
3084 mtk after a suggestion from Samuel Thibault
3085 Added SEE ALSO pointers to wide character equivalent functions
3086 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351996
3087
3088 Typographical or grammatical errors have been corrected in several
3089 places.
3090
3091
3092 Changes to individual pages
3093 ---------------------------
3094
3095 clone.2
3096 mtk
3097 Remove duplicate CLONE_STOPPED text.
3098 Commented out crufty text describing EINVAL error
3099 for the now obsolete CLONE_DETACHED flag.
3100 Under CLONE_SIGHAND, noted that 'flags' must also include
3101 CLONE_VM if CLONE_SIGHAND is specified.
3102
3103 fcntl.2
3104 mtk
3105 Under ERRORS: Separate out EAGAIN error for locking mmaped files.
3106
3107 inotify_add_watch.2
3108 mtk
3109 Minor wording fix.
3110
3111 msgop.2
3112 mtk
3113 Documented the EAGAIN error for msgrcv().
3114
3115 fnmatch.3
3116 Mike Frysinger / mtk
3117 Expand explanation of FNM_PATHNAME.
3118
3119 lockf.3
3120 Joerg Habenicht / mtk
3121 Fix up discussion of EAGAIN/EACCESS errors.
3122
3123
3124 ==================== Changes in man-pages-2.25 ====================
3125
3126 Released: 2006-03-02
3127
3128 Contributors
3129 ------------
3130
3131 The following people contributed notes, ideas, or patches that have
3132 been incorporated in changes in this release:
3133
3134 James Peach <jpeach@samba.org>
3135 Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3136 Marten von Gagern <Martin.vGagern@gmx.net>
3137 Michael Haardt <michael@moria.de>
3138 Michael Wronksi <michal.wronski@gmail.com>
3139
3140 Apologies if I missed anyone!
3141
3142
3143 New pages
3144 ---------
3145
3146 mq_close.3
3147 mq_getattr.3
3148 mq_notify.3
3149 mq_open.3
3150 mq_receive.3
3151 mq_send.3
3152 mq_unlink.3
3153 mtk
3154 New pages describing POSIX message queue API.
3155
3156 posix_fallocate.3
3157 mtk, after a suggestion by James Peach
3158 New page describing posix_fallocate().
3159
3160 mq_overview.7
3161 mtk
3162 New page giving overview of the POSIX message queue API.
3163
3164
3165 Changes to individual pages
3166 ---------------------------
3167
3168 lseek.2
3169 Michael Haardt
3170 Add a case to the EINVAL error text.
3171 mtk
3172 Various minor wording fixes
3173 Added SEE ALSO referring to new posix_fallocate.3.
3174
3175 posix_fadvise.2
3176 mtk
3177 Added "#define _XOPEN_SOURCE 600" to prototype.
3178 Added SEE ALSO referring to new posix_fallocate.3.
3179
3180 proc.5
3181 mtk
3182 Migrated information on POSIX message queues to new mqueue.7 page.
3183
3184 inotify.7
3185 Marten von Gagern
3186 Fix thinko: s/assuming a non-blocking/assuming a blocking/
3187
3188
3189 ==================== Changes in man-pages-2.26 ====================
3190
3191 Released: 2006-03-21
3192
3193 Contributors
3194 ------------
3195
3196 The following people contributed notes, ideas, or patches that have
3197 been incorporated in changes in this release:
3198
3199 Alain Portal <aportal@univ-montp2.fr>
3200 Andi Kleen <ak@muc.de>
3201 Andries Brouwer <Andries.Brouwer@cwi.nl>
3202 Christoph Lameter <clameter@engr.sgi.com>
3203 Hasso Tepper <hasso@estpak.ee>
3204 Justin Pryzby <justinpryzby@users.sourceforge.net>
3205 Martin (Joey) Schulze <joey@infodrom.org>
3206 Nicolas François <nicolas.francois@centraliens.net>
3207 Paul Brook <paul@nowt.org>
3208 Siward de Groot <siward@wanadoo.nl>
3209 Steve Beattie <sbeattie@suse.de>
3210 Walter Harms <walter.harms@informatik.uni-oldenburg.de>
3211
3212 Apologies if I missed anyone!
3213
3214 Global changes
3215 --------------
3216
3217 clone.2
3218 getdents.2
3219 gettid.2
3220 llseek.2
3221 mmap2.2
3222 modify_ldt.2
3223 pivot_root.2
3224 quotactl.2
3225 readdir.2
3226 sysctl.2
3227 syslog.2
3228 tkill.2
3229 mtk, aeb, Steve Beattie
3230 Added comment in SYNOPSIS to note that syscall(2) may be
3231 preferable over _syscallN (see intro(2)).
3232
3233 Various minor formatting changes were done on a range of
3234 pages in Section 7. (No content was changed.)
3235
3236 New pages
3237 ---------
3238
3239 openat.2
3240 mtk
3241 New page describing openat(2), added in kernel 2.6.16,
3242 and some notes on rationale for the at*(2) system calls.
3243
3244 mbind.2
3245 Andi Kleen, Christoph Lameter, mtk
3246 Added MPOL_MF_MOVE and MPOL_MF_MOVE_ALL descriptions,
3247 from numactl-0.9.2 man page.
3248 Plus a few other smaller fixes.
3249
3250 fexecve.3
3251 mtk
3252 New page describing fexecve(3).
3253
3254 futimes.3
3255 mtk
3256 New page describing futimes(3).
3257
3258 Changes to individual pages
3259 ---------------------------
3260
3261 execve.2
3262 mtk
3263 Added SEE ALSO pointing to new fexecve.3.
3264
3265 intro.2
3266 mtk, aeb, Steve Beattie
3267 Added some notes on syscall(2) versus _syscall.
3268
3269 msgctl.2
3270 msgget.2
3271 msgop.2
3272 mtk
3273 Added SEE ALSO pointing to mq_overview.7.
3274
3275 open.2
3276 mtk
3277 Added SEE ALSO pointing to new openat.2.
3278
3279 Split out part of the RETURN VALUE text into separate
3280 NOTES section.
3281
3282 Modified wording referring to raw(8) to
3283 indicate that this interface is deprecated.
3284
3285 poll.2
3286 mtk
3287 Added discussion of ppoll(2), which is new in 2.6.16.
3288
3289 ppoll.2
3290 mtk
3291 New link to poll.2.
3292
3293 recvmsg.2
3294 sendmsg.2
3295 mtk / Paul Brook
3296 Added text to note that although POSIX says msg_controllen
3297 should be socklen_t, glibc actually uses size_t.
3298 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356502
3299 and the associated glibc bug report.
3300 http://sourceware.org/bugzilla/show_bug.cgi?id=2448
3301 mtk
3302 Various formatting fixes.
3303
3304 select.2
3305 mtk
3306 Updated to reflect the fact that pselect() has been implemented
3307 in the kernel in 2.6.16; various other minor wording changes.
3308
3309 pselect() prototype needs "#define _XOPEN_SOURCE 600".
3310
3311 tempnam.3
3312 Justin Pryzby
3313 Clean up description of EEXIST error.
3314 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=357893
3315
3316 unlink.2
3317 mtk
3318 Added a little extra text to clarify EISDIR vs EPERM.
3319
3320 utime.2
3321 mtk
3322 Added new SEE ALSO entry pointing to new futimes.3 page.
3323
3324 exec.3
3325 mtk
3326 Added SEE ALSO pointing to new fexecve.3.
3327
3328 shm_unlink.3
3329 mtk
3330 New link to shm_open.3 (should have been made when page
3331 was originally written).
3332
3333 swab.3
3334 Walter Harms
3335 Add needed "#define _XOPEN_SOURCE".
3336
3337 undocumented.3
3338 mtk
3339 Updated to remove a few function names that are now documented.
3340
3341 capabilities.7
3342 mtk
3343 Various changes to bring this page closer to
3344 current kernel versions.
3345
3346 inotify.7
3347 mtk
3348 Noted that glibc 2.4 is required to get glibc support
3349 for inotify.
3350
3351 mq_overview.7
3352 mtk
3353 Some rewording and added a few words about System V
3354 message queues.
3355
3356 netlink.7
3357 Hasso Tepper
3358 Substantial updates to various parts of this page.
3359 mtk, Alain Portal
3360 Minor fixes
3361
3362 pthreads.7
3363 mtk
3364 Updated to reflect that the NPTL limitation that only the main
3365 thread could call setsid() and setpgid() was removed in 2.6.16.
3366
3367 raw.7
3368 Hasso Tepper
3369 Removed text implying that only in kernel 2.2 does IP_HDRINCL
3370 prevent datagrams from being fragmented.
3371
3372 socket.7
3373 mtk
3374 Documented SO_SNDBUFFORCE and SO_RCVBUFFORCE socket options,
3375 new in 2.6.14.
3376
3377 Placed socket options in alphabetical order.
3378
3379
3380 ==================== Changes in man-pages-2.27 ====================
3381
3382 Released: 2006-03-24
3383
3384 Contributors
3385 ------------
3386
3387 The following people contributed notes, ideas, or patches that have
3388 been incorporated in changes in this release:
3389
3390 Andries Brouwer <Andries.Brouwer@cwi.nl>
3391 Charles P. Wright <cwright@cs.sunysb.edu>
3392 Christoph Lameter <clameter@sgi.com>
3393 Chuck Ebbert <76306.1226@compuserve.com>
3394 Daniel Jacobowitz <dan@debian.org>
3395 Ingo Molnar <mingo@elet.hu>
3396 Heiko Carstens <heiko.carstens@de.ibm.com>
3397 Janak Desai <janak@us.ibm.com>
3398 Paolo (Blaisorblade) Giarrusso <blaisorblade@yahoo.it>
3399 Stefan Puiu <stefanpuiuro@yahoo.com>
3400
3401 Apologies if I missed anyone!
3402
3403
3404 Global changes
3405 --------------
3406
3407 man7/*
3408 mtk
3409 Various minor formatting changes were done on a range of
3410 pages in Section 7. (No content was changed.)
3411
3412
3413 New pages
3414 ---------
3415
3416 unshare.2
3417 mtk, with reference to documentation by Janak Desai
3418 New page describing unshare(2), added in kernel 2.6.16.
3419
3420
3421 Changes to individual pages
3422 ---------------------------
3423
3424 clone.2
3425 fork.2
3426 vfork.2
3427 mtk
3428 Added SEE ALSO pointing to new unshare.2.
3429
3430 mbind.2
3431 Christoph Lameter
3432 MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE.
3433
3434 mremap.2
3435 mtk
3436 Clarified the description of MREMAP_FIXED and restructured
3437 the text to reflect the fact that this flag is exposed
3438 by glibc since version 2.4.
3439
3440 ptrace.2
3441 Chuck Ebbert, with assistance from Daniel Jacobowitz,
3442 Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
3443 after a suggestion from Heiko Carstens.
3444 Document the following ptrace requests:
3445 PTRACE_SETOPTIONS (2.4.6)
3446 plus associated flags:
3447 PTRACE_O_TRACESYSGOOD (2.4.6)
3448 PTRACE_O_TRACEFORK (2.5.46)
3449 PTRACE_O_TRACEVFORK (2.5.46)
3450 PTRACE_O_TRACECLONE (2.5.46)
3451 PTRACE_O_TRACEEXEC (2.5.46)
3452 PTRACE_O_TRACEVFORKDONE (2.5.60)
3453 PTRACE_O_TRACEEXIT (2.5.60)
3454 PTRACE_SETSIGINFO (2.3.99-pre6)
3455 PTRACE_GETSIGINFO (2.3.99-pre6)
3456 PTRACE_GETEVENTMSG (2.5.46)
3457 PTRACE_SYSEMU (since Linux 2.6.14)
3458 PTRACE_SYSEMU_SINGLESTEP (since Linux 2.6.14)
3459
3460 sched_get_priority_max.2
3461 sched_setscheduler.2
3462 sched_setparam.2
3463 mtk, Ingo Molnar
3464 Modified to document SCHED_BATCH policy, new in kernel 2.6.16.
3465
3466 Text describing SCHED_BATCH was added to sched_setscheduler.2,
3467 and was drawn in part from Ingo Molnar's description in the
3468 mail message containing the patch that implemented this policy.
3469
3470 Various other minor rewordings and formatting fixes.
3471
3472 proc.5
3473 mtk, using text from Documentation/filesystems/proc.txt
3474 Document /proc/sys/vm/drop_caches, new in kernel 2.6.16.
3475 mtk, using information from ChangeLog-2.6.14.
3476 Document /proc/PID/smaps, new in kernel 2.6.14.
3477
3478 capabilities.7
3479 mtk
3480 Noted affect of CAP_SYS_NICE for mbind(MPOL_MF_MOVE_ALL).
3481
3482 pthreads.7
3483 mtk
3484 Kernel 2.6.16 eliminated buggy behavior with respect to
3485 the alternate signal stack.
3486
3487
3488 ==================== Changes in man-pages-2.28 ====================
3489
3490 Released: 2006-03-31
3491
3492 Contributors
3493 ------------
3494
3495 The following people contributed notes, ideas, or patches that have
3496 been incorporated in changes in this release:
3497
3498 Aleksandr Blokhin <sass@altlinux.ru>
3499 Greg Johnson <gjohnson@lanl.gov>
3500
3501 Apologies if I missed anyone!
3502
3503
3504 New pages
3505 ---------
3506
3507 sem_post.3
3508 sem_getvalue.3
3509 sem_close.3
3510 sem_open.3
3511 sem_destroy.3
3512 sem_wait.3
3513 sem_unlink.3
3514 sem_init.3
3515 sem_overview.7
3516 mtk
3517 New pages describing the POSIX semaphores API.
3518
3519 These pages supersede and provide a superset of the information
3520 in the glibc (3thr) "semaphores(3)" manual page.
3521
3522
3523 Changes to individual pages
3524 ---------------------------
3525
3526 ppoll.2
3527 Aleksandr Blokhin
3528 Fix broken link.
3529
3530 ptrace.2
3531 mtk
3532 Wrapped long lines (no content changes).
3533
3534 semctl.2
3535 semget.2
3536 semop.2
3537 mtk
3538 Add SEE ALSO pointing to the new sem_overview.7 page.
3539
3540 elf.5
3541 Greg Johnson
3542 Removed SEE ALSO reference to nonexistent core(5).
3543
3544
3545 ==================== Changes in man-pages-2.29 ====================
3546
3547 Released: 2006-04-06
3548
3549 Contributors
3550 ------------
3551
3552 The following people contributed notes, ideas, or patches that have
3553 been incorporated in changes in this release:
3554
3555 Michael Haardt <michael@moria.de>
3556 Roberto Jimenoca <robertojimenoca@terra.es>
3557 Stefan Puiu <stefanpuiuro@yahoo.com>
3558
3559 Apologies if I missed anyone!
3560
3561
3562 Global changes
3563 --------------
3564
3565 getrlimit.2
3566 prctl.2
3567 sigaction.2
3568 elf.5
3569 signal.7
3570 mtk
3571 Added SEE ALSO entry referring to new core.5 page.
3572
3573
3574 New pages
3575 ---------
3576
3577 mkdirat.2
3578 mtk
3579 New page describing mkdirat(2), new in 2.6.16.
3580
3581 mknodat.2
3582 mtk
3583 New page describing mknodat(2), new in 2.6.16.
3584
3585 core.5
3586 mtk
3587 New page describing core dump files.
3588
3589 mkfifoat.3
3590 mtk
3591 New page describing mkfifoat(3).
3592
3593
3594 Changes to individual pages
3595 ---------------------------
3596
3597 accept.2
3598 getpeername.2
3599 getsockname.2
3600 Michael Haardt / mtk
3601 Document EINVAL error for 'len' argument < 0.
3602
3603 fcntl.2
3604 mtk
3605 Expanded discussion of mandatory locking.
3606
3607 getrlimit.2
3608 mtk
3609 Added BUGS text on 2.6.x handling of RLIMIT_CPU limit
3610 of zero seconds. See
3611 http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
3612
3613 mkdir.2
3614 mtk
3615 Added SEE ALSO entry referring to new mkdirat.2.
3616
3617 mknod.2
3618 mtk
3619 Added SEE ALSO entry referring to new mknodat.2.
3620
3621 open.2
3622 mtk / Roberto Jimenoca
3623 Clarified discussion of file types affected by O_NONBLOCK.
3624 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=360243
3625
3626 openat.2
3627 mtk
3628 Rewrote NOTES describing rationale for openat().
3629 Various other minor changes.
3630
3631 recv.2
3632 Stefan Puiu
3633 Removed a misleading cross-ref to socket.2.
3634
3635 shmop.2
3636 mtk
3637 Since 2.6.17-rc1, shmdt() gives the error EINVAL in a further
3638 circumstance: if shmaddr is not aligned on a page boundary.
3639
3640 unshare.2
3641 mtk
3642 Remove text saying that specifying invalid flags "is likely
3643 to cause compatibility problems" since the kernel now
3644 (2.6.17-rc1) contains an explicit check for invalid bits
3645 with a consequent EINVAL error.
3646
3647 mkfifo.3
3648 mtk
3649 Added SEE ALSO entry referring to new mkfifoat.3.
3650
3651 proc.5
3652 mtk
3653 Information on core_pattern and core_uses_pid has
3654 been migrated to the new core.5 page.
3655
3656 ip.7
3657 Stefan Puiu
3658 Removed paragraph referring to obsolete ipchains / ipfw(4).
3659
3660 sem_overview.7
3661 mtk
3662 Add SEE ALSO entry referring to pthreads.7.
3663
3664
3665 ==================== Changes in man-pages-2.30 ====================
3666
3667 Released: 2006-04-17
3668
3669 Contributors
3670 ------------
3671
3672 The following people contributed notes, ideas, or patches that have
3673 been incorporated in changes in this release:
3674
3675 Andre Lehovich <andrel@yahoo.com>
3676 Andries Brouwer <Andries.Brouwer@cwi.nl>
3677 Karel Kulhavy <clock@twibright.com>
3678 Stefan Puiu <stefanpuiuro@yahoo.com>
3679
3680 Apologies if I missed anyone!
3681
3682
3683 New pages
3684 ---------
3685
3686 linkat.2
3687 mtk
3688 New page describing linkat(), new in kernel 2.6.16
3689
3690 renameat.2
3691 mtk
3692 New page describing renameat(), new in kernel 2.6.16
3693
3694 symlinkat.2
3695 mtk
3696 New page describing symlinkat(), new in kernel 2.6.16
3697
3698 unlinkat.2
3699 mtk
3700 New page describing unlinkat(), new in kernel 2.6.16
3701
3702
3703 Changes to individual pages
3704 ---------------------------
3705
3706 link.2
3707 mtk
3708 Added SEE ALSO entry pointing to new linkat.2 page.
3709
3710 openat.2
3711 mtk
3712 Added SEE ALSO entries pointing to new *at.2 pages.
3713
3714 rename.2
3715 mtk
3716 Added SEE ALSO entry pointing to new renameat.2 page.
3717
3718 rmdir.2
3719 mtk
3720 Added SEE ALSO entry pointing to new unlinkat.2 page.
3721
3722 symlink.2
3723 mtk
3724 Added SEE ALSO entry pointing to new symlinkat.2 page.
3725
3726 unlink.2
3727 mtk
3728 Added SEE ALSO entry pointing to new unlinkat.2 page.
3729
3730 termios.3
3731 mtk / Karel Kulhavy
3732 Document the feature test macros required to expose various flags.
3733 Karel Kulhavy
3734 Clarify 'speed' argument for cfsetispeed() text.
3735 Karel Kulhavy / mtk
3736 Note that LOBLK is not implemented on Linux.
3737 mtk
3738 Clarify arguments for cfsetspeed().
3739 Various formatting changes.
3740
3741 full.4
3742 Andre Lehovich
3743 Add a sentence describing the purpose of full(4).
3744
3745 core.5
3746 aeb / mtk
3747 Rework text describing circumstances in which
3748 core dump files are not produced.
3749 mtk / Stefan Puiu
3750 A core dump of a multithreaded process always includes the
3751 PID in the core filename.
3752 mtk / Stefan Puiu
3753 Eliminate some accidentally duplicated text.
3754
3755
3756 ==================== Changes in man-pages-2.31 ====================
3757
3758 Released: 2006-05-02
3759
3760 Contributors
3761 ------------
3762
3763 The following people contributed notes, ideas, or patches that have
3764 been incorporated in changes in this release:
3765
3766 Joshua Kwan <joshk@triplehelix.org>
3767 Justin Pryzby <justinpryzby@users.sourceforge.net>
3768 Karel Kulhavy <clock@twibright.com>
3769 Mark Glines <mark@glines.org>
3770 Martin (Joey) Schulze <joey@infodrom.org>
3771 Nishanth Aravamudan <nacc@us.ibm.com>
3772 Reuben Thomas <rrt@sc3d.org>
3773 Ryan S. Arnold <rsa@us.ibm.com>
3774 Ulrich Drepper <drepper@redhat.com>
3775
3776 Apologies if I missed anyone!
3777
3778
3779 Page renamings
3780 --------------
3781
3782 The following pages have been relocated into section 7, since
3783 that is their more natural home. SEE ALSO references in various
3784 other pages have been adjusted.
3785
3786 epoll.4
3787 fifo.4
3788 futex.4
3789 complex.5
3790 environ.5
3791 (many pages outside man-pages actually *expect*
3792 'environ' to be in Section 7.)
3793
3794 ipc.5
3795 renamed to svipc.7
3796
3797 ".so" link files have been created to link the old file locations to the
3798 new file locations. These links are added just to ensure that cross
3799 references from any other (non-man-pages) pages will remain valid;
3800 eventually these links will be removed.
3801
3802
3803 New pages
3804 ---------
3805
3806 fstatat.2
3807 mtk
3808 New page for fstatat(2), new in 2.6.16.
3809
3810 adjtime.3
3811 mtk
3812 New page for adjtime(3).
3813
3814 error.3
3815 Justin Pryzby / mtk
3816 New page describing error() and error_at_line()
3817 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=186307
3818
3819 program_invocation_name.3
3820 mtk
3821 New page describing program_invocation_name and
3822 program_invocation_short_name variables.
3823
3824 sockatmark.3
3825 mtk
3826 New page for sockatmark(3).
3827
3828 ftm.7
3829 mtk
3830 New page describing feature test macros.
3831
3832 time.7
3833 mtk
3834 New page giving an overview of "time" on Linux systems.
3835
3836
3837 Global changes
3838 --------------
3839
3840 getgroups.2
3841 wait4.2
3842 chown.2
3843 chdir.2
3844 gettimeofday.2
3845 initgroups.3
3846 dirfd.3
3847 mtk
3848 Simplified wording around requirement for _BSD_SOURCE
3849 feature test macro.
3850
3851 times.2
3852 time.2
3853 gettimeofday.2
3854 getitimer.2
3855 nanosleep.2
3856 ctime.3
3857 rtc.4
3858 mtk
3859 Added SEE ALSO referring to new time.7.
3860
3861 err.3
3862 errno.3
3863 perror.3
3864 strerror.3
3865 Justin Pryzby / mtk
3866 Add SEE ALSO referring to new error.3.
3867
3868 getdate.3
3869 printf.3
3870 scanf.3
3871 mtk
3872 Added SEE ALSO entry referring to setlocale.3.
3873
3874
3875 Changes to individual pages
3876 ---------------------------
3877
3878 accept.2
3879 Mark Glines
3880 Remove mention of SOCK_RDM from this page, since this socket
3881 type does not support accept()ing connections.
3882
3883 adjtimex.2
3884 mtk
3885 Modified text referring to adjtime(); added SEE ALSO for new
3886 adjtime.3 page.
3887
3888 fsync.2
3889 mtk, after a note by Karel Kulhavy
3890 Rewrote most of the DESCRIPTION, as well as some other parts
3891 the page, to clarify use and operation of, and rationale for,
3892 fsync(2) and fdatasync(2).
3893
3894 getitimer.2
3895 mtk
3896 Updated discussion of maximum timer value to reflect the fact
3897 that the default jiffy is now 4 milliseconds.
3898
3899 Added text to note that current incorrect behavior of
3900 normalizing tv_usec >= 1000000 will be repaired in a future
3901 kernel; applications should be fixed now.
3902
3903 gettimeofday.2
3904 Karel Kulhavy
3905 Point out more explicitly that 'tz' argument should
3906 normally be NULL.
3907 mtk
3908 Various other minor edits and formatting fixes.
3909
3910 mount.2
3911 mtk
3912 Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable
3913 on a per-mount basis.
3914 Detail exactly which mount flags can be changed on MS_REMOUNT.
3915
3916 nanosleep.2
3917 mtk / Karel Kulhavy
3918 Clarify RETURN VALUE discussion.
3919
3920 openat.2
3921 mtk
3922 Add SEE ALSO reference pointing to new fstatat.2.
3923
3924 program_invocation_short_name.3
3925 mtk
3926 New link to new program_invocation_name.3.
3927
3928 recv.2
3929 mtk
3930 Added SEE ALSO for new sockatmark.3.
3931
3932 rmdir.2
3933 Joshua Kwan / Martin (Joey) Schulze / mtk
3934 Correct wording of EBUSY case.
3935 mtk
3936 Add ".." case to ENOTEMPTY error
3937
3938 select.2
3939 Karel Kulhavy
3940 Note more clearly that fd_set arguments can be NULL.
3941 mtk / Karel Kulhavy
3942 Improve opening paragraph describing purpose of select().
3943 mtk
3944 Various other minor edits and formatting fixes.
3945
3946 semget.2
3947 mtk / Nishanth Aravamudan
3948 Add text to noting that the initial values of semaphores
3949 in a new set are indeterminate.
3950
3951 shmget.2
3952 mtk
3953 Add text noting that contents of newly created segment are zero
3954 values.
3955
3956 sigwaitinfo.2
3957 mtk
3958 Noted that all threads should block signal being waited for.
3959
3960 stat.2
3961 Nishanth Aravamudan / mtk
3962 Added NOTE that st_size is always returned as zero for most
3963 /proc files.
3964 mtk
3965 Add SEE ALSO reference pointing to new fstatat.2.
3966
3967 syscall.2
3968 Justin Pryzby / mtk
3969 Remove bogus BUGS text.
3970
3971 utime.2
3972 mtk
3973 Various minor changes.
3974
3975 confstr.3
3976 mtk
3977 Rewrote RETURN VALUE discussion.
3978 Updated CONFORMING TO.
3979 Removed BUGS.
3980
3981 ctanh.3
3982 Martin (Joey) Schulze / mtk
3983 Fix errors in DESCRIPTION.
3984
3985 ctime.3
3986 mtk
3987 The range of tm_sec is 0..60 (not 0..61).
3988
3989 error_at_line.3
3990 error_message_count.3
3991 error_on_per_line.3
3992 error_print_progname.3
3993 mtk
3994 New links to new error.3.
3995
3996 fmemopen.3
3997 mtk / Ryan S. Arnold
3998 Add text noting that explicitly controlling output buffering
3999 may be useful to catch errors on output operations on an
4000 fmemopen() stream.
4001
4002 getline.3
4003 Justin Pryzby
4004 Add SEE ALSO pointing to getline.3.
4005 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=364772
4006
4007 strtod.3
4008 strtoul.3
4009 mtk
4010 Describe correct handling of errno in order to
4011 distinguish error from success after the call.
4012
4013 Added EXAMPLE section which points to strtol.3 which provides
4014 an example of the use of the analogous strtol(3).
4015
4016 strtol.3
4017 mtk / Justin Pryzby
4018 Add an example program.
4019 mtk
4020 Describe correct handling or errno in order to
4021 distinguish error from success after the call.
4022
4023 tmpfile.3
4024 Reuben Thomas
4025 DESCRIPTION does not need to say "temporary file name"
4026 just "temporary file", since the name is in any case
4027 unavailable to the user.
4028 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=363518
4029 mtk
4030 In DESCRIPTION:
4031 Change /automatically deleted when the program terminates normally/
4032 to /automatically deleted when the program terminates/
4033 since deletion occurs on both normal and abnormal termination.
4034
4035 ip.7
4036 Karel Kulhavy / mtk
4037 Various wording improvements and clarifications.
4038
4039 signal.7
4040 mtk / Ulrich Drepper
4041 Add text noting that a signal's disposition is process-wide,
4042 shared by all threads.
4043 mtk
4044 Add text on changing signal dispositions.
4045 Add text on "signal mask and pending signals".
4046 Other minor edits.
4047
4048 time.7
4049 mtk
4050 Added SEE ALSO for new adjtime.3.
4051
4052 ld.so.8
4053 Justin Pryzby
4054 Remove bogus duplicate line.
4055
4056
4057 ==================== Changes in man-pages-2.32 ====================
4058
4059 Released: 2006-05-13
4060
4061 Contributors
4062 ------------
4063
4064 The following people contributed notes, ideas, or patches that have
4065 been incorporated in changes in this release:
4066
4067 Andries Brouwer <Andries.Brouwer@cwi.nl>
4068 Johannes Weiner <root@hnaz.ath.cx>
4069 Justin Pryzby <justinpryzby@users.sourceforge.net>
4070 Karel Kulhavy <clock@twibright.com>
4071 Paul Brook <paul@nowt.org>
4072 Pavel Heimlich <tropikhajma@seznam.cz>
4073
4074 Apologies if I missed anyone!
4075
4076
4077 New pages
4078 ---------
4079
4080 faccessat.2
4081 mtk
4082 New page for faccessat(2), new in 2.6.16.
4083
4084 fchmodat.2
4085 mtk
4086 New page for fchmodat(2), new in 2.6.16.
4087
4088 fchownat.2
4089 mtk
4090 New page for fchownat(2), new in 2.6.16.
4091
4092 futimesat.2
4093 mtk
4094 New page for futimesat(2), new in 2.6.16.
4095
4096
4097 Changes to individual pages
4098 ---------------------------
4099
4100 access.2
4101 mtk
4102 Add SEE ALSO reference pointing to new faccessat.2 page.
4103
4104 capget.2
4105 mtk
4106 Reworded to reflect that capabilities are per-thread.
4107
4108 chmod.2
4109 mtk
4110 Add SEE ALSO reference pointing to new fchmodat.2 page.
4111
4112 chown.2
4113 mtk
4114 Add SEE ALSO reference pointing to new fchownat.2 page.
4115
4116 mmap.2
4117 mtk
4118 Updated discussion of MAP_NORESERVE since it is no longer
4119 restricted to MAP_PRIVATE mappings.
4120 Add reference to discussion of /proc/sys/vm/overcommit_memory
4121 in proc.5.
4122
4123 openat.2
4124 mtk
4125 Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
4126 fchownat.2, futimesat.2 pages.
4127
4128 shmget.2
4129 mtk
4130 Document SHM_NORESERVE flag, new in 2.6.15.
4131
4132 truncate.2
4133 Paul Brook / mtk
4134 Expand text noting that ftruncate()/truncate() may fail if
4135 asked to extend a file beyond its current length.
4136 Add EPERM error.
4137
4138 utime.2
4139 mtk
4140 Add SEE ALSO reference pointing to new futimesat.2 page.
4141
4142 fopen.3
4143 Justin Pryzby / mtk
4144 Document 'm' (mmap) flag.
4145 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=365754
4146 mtk
4147 Document 'c' (notcancel) flag.
4148
4149 futimes.3
4150 mtk
4151 Add SEE ALSO reference pointing to new futimesat.2 page.
4152
4153 qsort.3
4154 Johannes Weiner
4155 Add missing "const" qualifies to cast in EXAMPLE.
4156 mtk
4157 Slight rewording of comments in EXAMPLE.
4158
4159 termios.3
4160 Karel Kulhavy
4161 Clarify meaning of IXANY.
4162 Clarify relationship of MIN with VMIN and TIME with VTIME.
4163 mtk
4164 Noted that CIBAUD, OFDEL, and DELECHO are not implemented
4165 on Linux.
4166 Added explanatory paragraph for phrases "not in POSIX" and
4167 "XSI".
4168
4169 capabilities.7
4170 mtk
4171 Reworded to reflect that capabilities are per-thread.
4172 Add ioprio_set() to list of operations permitted by
4173 CAP_SYS_NICE.
4174 Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
4175 scheduling classes to list of operations permitted by
4176 CAP_SYS_ADMIN.
4177 Note effects of CAP_SYS_NICE for migrate_pages().
4178
4179
4180 ==================== Changes in man-pages-2.33 ====================
4181
4182 Released: 2006-05-23
4183
4184 Contributors
4185 ------------
4186
4187 The following people contributed notes, ideas, or patches that have
4188 been incorporated in changes in this release:
4189
4190 Andries Brouwer <Andries.Brouwer@cwi.nl>
4191 Justin Pryzby <justinpryzby@users.sourceforge.net>
4192 Martin Osvald" <martin.osvald@gmail.com>
4193 Stefan Puiu <stefanpuiuro@yahoo.com>
4194
4195 Apologies if I missed anyone!
4196
4197
4198 Page renamings
4199 --------------
4200
4201 ftm.7
4202 mtk / Stefan Puiu
4203 renamed to the more suggestive feature_test_macros.7
4204
4205
4206 New pages
4207 ---------
4208
4209 mq_getsetattr.2
4210 mtk
4211 New page briefly describing mq_getsetattr(2), the system
4212 call that underlies mq_setattr(3) and mq_getattr(3).
4213
4214 rpmatch.3
4215 Justin Pryzby / mtk
4216 New page for rpmatch(3).
4217
4218
4219 Changes to individual pages
4220 ---------------------------
4221
4222 chmod.2
4223 mtk
4224 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4225 POSIX does now document ELOOP.
4226
4227 open.2
4228 mtk
4229 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4230
4231 mmap.2
4232 Justin Pryzby
4233 Add mincore(2) to SEE ALSO.
4234 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367401
4235
4236 msync.2
4237 Justin Pryzby
4238 Note that EINVAL can also be caused by
4239 flags == MS_SYNC | MS_ASYNC.
4240
4241 sched_setaffinity.2
4242 mtk
4243 Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
4244
4245 select.2
4246 mtk
4247 Various minor changes.
4248
4249 select_tut.2
4250 mtk
4251 Removed much material that is redundant with select.2.
4252 Various other changes.
4253
4254 umask.2
4255 mtk
4256 Substantial rewrite of description of 'mask'.
4257
4258 CPU_ISSET.3
4259 CPU_CLR.3
4260 CPU_SET.3
4261 CPU_ZERO.3
4262 mtk
4263 New links to sched_setaffinity.2
4264
4265 FD_CLR.3
4266 FD_ISSET.3
4267 FD_SET.3
4268 FD_ZERO.3
4269 mtk
4270 New links to select.2.
4271
4272 fts.3
4273 Justin Pryzby
4274 Add SEE also referring to ftw.3.
4275
4276 ftw.3
4277 Justin Pryzby
4278 Add SEE also referring to fts.3.
4279
4280 getline.3
4281 Justin Pryzby
4282 Various minor clarifications.
4283
4284 mkstemp.3
4285 mtk
4286 Clarify that O_EXCL is an open(2) flag.
4287
4288 mq_open.3
4289 Martin Osvald
4290 Fix prototype declaration for 'attr'.
4291
4292 mq_notify.3
4293 Martin Osvald
4294 s/sigev_signal/sigev_signo/
4295
4296 mq_setattr.3
4297 mtk
4298 New link to mq_getattr.3.
4299
4300 mq_timedreceive.3
4301 mtk
4302 New link to mq_receive.3.
4303
4304 mq_timedsend.3
4305 mtk
4306 New link to mq_send.3.
4307
4308 setlocale.3
4309 Justin Pryzby
4310 Added SEE ALSO referring to rpmatch.3.
4311
4312 sigandset.3
4313 sigisemptyset.3
4314 sigorset.3
4315 mtk
4316 New links to sigsetops.3.
4317
4318 stdio.3
4319 Justin Pryzby
4320 Added SEE ALSO referring to unlocked_stdio.3
4321 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4322
4323 strchr.3
4324 Justin Pryzby
4325 Add description of strchrnul().
4326
4327 strchrnul.3
4328 mtk
4329 New link to strchr.3.
4330
4331 undocumented.3
4332 Justin Pryzby / mtk
4333 Updated to remove some functions that don't exist, and
4334 therefore don't need to be documented.
4335 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367671
4336
4337 unlocked_stdio.3
4338 Justin Pryzby
4339 Added SEE ALSO referring to stdio.3
4340 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
4341
4342 mq_overview.7
4343 mtk
4344 Added section describing relationship between library
4345 interfaces and system calls.
4346 Added SEE ALSO referring to new mq_getsetattr.2.
4347
4348 feature_test_macros.7
4349 Stefan Puiu
4350 Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
4351
4352
4353 ==================== Changes in man-pages-2.34 ====================
4354
4355 Released: 2006-06-20
4356
4357 Contributors
4358 ------------
4359
4360 The following people contributed notes, ideas, or patches that have
4361 been incorporated in changes in this release:
4362
4363 Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
4364 bert hubert <bert.hubert@netherlabs.nl>
4365 Chris Curtis <chris.curtis@riptidesoftware.com>
4366 Eduardo Madeira Fleury <efleury@br.ibm.com>
4367 Joerg Scheurich <rusmufti@helpdesk.bera.rus.uni-stuttgart.de>
4368 Justin Pryzby <justinpryzby@users.sf.net>
4369 Kenichi Okuyama <okuyama.kenichi@oss.ntt.co.jp>
4370 Marc Lehmann <debian-reportbug@plan9.de>
4371 Martin (Joey) Schulze <joey@infodrom.org>
4372 Mats Wichmann <mats.d.wichmann@intel.com>
4373 Mike Frysinger <vapier@gentoo.org>
4374 Peter Eiserloh <eiserlohpp@yahoo.com>
4375 Stefan Puiu <stefanpuiuro@yahoo.com>
4376 Thomas Dickey <dickey@radix.net>
4377 Walter Harms <wharms@bfs.de>
4378
4379 Apologies if I missed anyone!
4380
4381
4382 Global changes
4383 --------------
4384
4385 tzselect.8
4386 zdump.8
4387 zic.8
4388 mtk, Joey
4389 Added header comment noting that these pages are in the public
4390 domain.
4391
4392 bindresvport.3
4393 getrpcent.3
4394 getrpcport.3
4395 rpc.3
4396 xdr.3
4397 rpc.5
4398 mtk, aeb, Joey
4399 Added following to top of these pages to clarify origin and
4400 license:
4401 .\" This page was taken from the 4.4BSD-Lite CDROM (BSD license)
4402
4403 New pages
4404 ---------
4405
4406 ioprio_set.2
4407 Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe
4408 New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13.
4409
4410 offsetof.3
4411 Justin Pryzby / mtk
4412 New page describing offsetof() macro.
4413
4414
4415 Changes to individual pages
4416 ---------------------------
4417
4418 _exit.2
4419 mtk
4420 Add SEE ALSO referring to exit_group.2.
4421
4422 acct.2
4423 mtk
4424 Add SEE ALSO referring to acct.5.
4425
4426 fcntl.2
4427 mtk
4428 Explicitly mention term "dnotify" in discussion of F_NOTIFY.
4429
4430 inotify_add_watch.2
4431 Aristeu Sergio Rozanski Filho / mtk
4432 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4433 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4434 mtk
4435 Renamed argument from 'path' to 'pathname'.
4436 Reword introductory paragraph to clarify that
4437 inotify_add_watch() may also modify an existing watch item.
4438 mtk
4439 The EINVAL error can also occur if 'fd' is not an inotify
4440 file descriptor.
4441 mtk
4442 Moved BUGS section from this page to inotify.7.
4443
4444 inotify_init.2
4445 Aristeu Sergio Rozanski Filho / mtk
4446 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4447 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4448
4449 inotify_rm_watch.2
4450 Aristeu Sergio Rozanski Filho / mtk
4451 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
4452 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
4453 mtk
4454 The EINVAL error can also occur if 'fd' is not an inotify
4455 file descriptor.
4456
4457 ioprio_get.2
4458 mtk
4459 New link to new ioprio_set.2.
4460
4461 mmap.2
4462 mtk
4463 Add SEE ALSO referring to remap_file_pages.2.
4464
4465 mount.2
4466 Kenichi Okuyama
4467 s/MNT_FORCE/MNT_EXPIRE/ under EINVAL error.
4468
4469 mremap.2
4470 Mike Frysinger
4471 s/unsigned long flags/int flags/ in SYNOPSIS.
4472
4473 pipe.2
4474 mtk
4475 Add SEE ALSO referring to popen.3.
4476
4477 posix_fadvise.2
4478 mtk
4479 Add SEE ALSO referring to readahead.2.
4480
4481 read.2
4482 mtk
4483 SEE ALSO for readv should refer to Section 2, not 3.
4484
4485 readahead.2
4486 mtk
4487 Add SEE ALSO referring to posix_fadvise.2.
4488
4489 send.2
4490 Peter Eiserloh
4491 Fix missing arguments in statement about equivalent send()
4492 and sendto() calls.
4493
4494 setsid.2
4495 mtk
4496 Add SEE ALSO referring to tcgetsid.3.
4497
4498 shmctl.2
4499 mtk
4500 Minor wording change at start of DESCRIPTION.
4501
4502 stat.2
4503 mtk
4504 Add SEE ALSO referring to access.2.
4505
4506 statfs.2
4507 mtk
4508 Relocated "Note" about f_fsid.
4509
4510 write.2
4511 mtk
4512 SEE ALSO for writev should refer to Section 2, not 3.
4513
4514 __setfpucw.3
4515 mtk, Joey
4516 Added license statement (GPL) after consultation with
4517 Joerg Scheurich.
4518
4519 assert_perror.3
4520 Justin Pryzby
4521 Add #define _GNU_SOURCE to prototype
4522
4523 difftime.3
4524 Joey
4525 Added note about time_t representation on other systems.
4526 Added CONFORMING TO.
4527
4528 ftw.3
4529 Justin Pryzby / mtk
4530 A fairly major revision...
4531 Document FTW_ACTIONRETVAL; include .SH "RETURN VALUE";
4532 Reorganized and rewrote much of the page
4533 Added an example program.
4534
4535 inet.3
4536 Marc Lehmann
4537 Fixed typo in NOTES.
4538 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=370277
4539
4540 isalpha.3
4541 Joey
4542 Updated CONFORMING TO.
4543
4544 mktemp.3
4545 mtk
4546 Updated CONFORMING TO.
4547
4548 printf.3
4549 Walter Harms
4550 Add documentation of %m.
4551
4552 readdir.3
4553 mtk
4554 Added SEE ALSO referring to ftw.3.
4555
4556 re_comp.3
4557 mtk
4558 Note that these functions are obsolete in favor of regcomp(3).
4559 Justin Pryzby
4560 Add SEE ALSO referring to regcomp.3
4561
4562 scandir.3
4563 Mats Wichmann
4564 Reworded CONFORMING TO statement on scandir() and alphasort().
4565
4566 strchr.3
4567 Stefan Puiu
4568 Fix prototype for strchrnul().
4569
4570 strtoul.3
4571 Stefan Puiu
4572 Add text clarifying treatment of strings starting with
4573 minus sign.
4574
4575 tmpnam.3
4576 mtk, after comments by Justin Pryzby
4577 Add text noting the need to use open(O_EXCL).
4578 mtk
4579 Clarify discussion of use of free(3).
4580 Various other minor changes to text and formatting.
4581
4582 tmpfile.3
4583 mtk
4584 Updated CONFORMING TO.
4585
4586 tmpnam.3
4587 mtk, after comments by Justin Pryzby
4588 Add text noting the need to use open(O_EXCL).
4589 Updated CONFORMING TO.
4590
4591 undocumented.3
4592 mtk
4593 Remove offsetof(), which is now documented.
4594
4595 null.4
4596 mtk
4597 Added SEE ALSO referring to full.4.
4598
4599 console_codes.4
4600 Thomas Dickey
4601 Various improvements and corrections.
4602
4603 epoll.7
4604 mtk
4605 Added CONFORMING TO section mentioning FreeBSD kqueue and
4606 Solaris /dev/poll.
4607
4608 feature_test_macros.7
4609 mtk
4610 Added pointer to location of LFS specification.
4611
4612 futex.7
4613 mtk, after suggestion by Joey.
4614 Added license statement to page, after discussion with
4615 original author, bert hubert.
4616 mtk
4617 Reformat long lines; no content changes.
4618
4619 inotify.7
4620 mtk
4621 'path' argument renamed to 'pathname'.
4622 A few minor rewordings.
4623 Added BUGS section describing a couple of bugs.
4624
4625 ip.7
4626 mtk
4627 Add SEE ALSO referring to byteorder.3.
4628
4629 man.7
4630 Justin Pryzby
4631 Add SEE ALSO referring to groff_man(7).
4632 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369253
4633
4634
4635 ==================== Changes in man-pages-2.35 ====================
4636
4637 Released: 2006-07-06
4638
4639 Contributors
4640 ------------
4641
4642 The following people contributed notes, ideas, or patches that have
4643 been incorporated in changes in this release:
4644
4645 Alain Portal <aportal@univ-montp2.fr>
4646 Andi Kleen <ak@suse.de>
4647 Andrew Morton <akpm@osdl.org>
4648 Bauke Jan Douma <bjdouma@xs4all.nl>
4649 Davide Libenzi <davidel@xmailserver.org>
4650 Denis Barbier <barbier@linuxfr.org>
4651 Horacio Rodriguez Montero <Horacio.Rodriguez.Montero@galinter.com.ar>
4652 Johan Lithander <johan.lithander@teligent.se>
4653 Justin Pryzby <justinpryzby@users.sourceforge.net>
4654 Mike Frysinger <vapier@gentoo.org>
4655 Stefan Puiu <stefanpuiuro@yahoo.com>
4656 Thorsten Kukuk <kukuk@suse.de>
4657
4658 Apologies if I missed anyone!
4659
4660
4661 Global changes
4662 --------------
4663
4664 Typographical or grammatical errors have been corrected in several
4665 places.
4666
4667 New pages
4668 ---------
4669
4670 sync_file_range.2
4671 Andrew Morton / mtk
4672 New page for sync_file_range(2), new in kernel 2.6.17.
4673
4674 Changes to individual pages
4675 ---------------------------
4676
4677 adjtime.3
4678 mtk
4679 Noted BUG that occurs if 'delta' is specified as NULL.
4680 See http://bugzilla.kernel.org/show_bug.cgi?id=6761
4681
4682 bind.2
4683 Stefan Puiu
4684 Add EADDRNOTAVAIL error.
4685 Stefan Puiu / mtk
4686 Make example code more complete.
4687
4688 epoll_ctl.2
4689 mtk / Davide Libenzi
4690 Added EPOLLRDHUP description.
4691 mtk
4692 Added SEE ALSO referring to poll.2.
4693
4694 poll.2
4695 mtk / Davide Libenzi
4696 Added POLLRDHUP description.
4697 mtk
4698 The correct header file is <poll.h>, not <sys/poll.h>.
4699 Rewrote and reformatted various other parts.
4700
4701 readlink.2
4702 mtk
4703 Nowadays, readlink() returns 'ssize_t', as required in
4704 POSIX.1-2001.
4705
4706 wavelan.4
4707 mtk
4708 Added license statement.
4709
4710 nscd.conf.5
4711 Thorsten Kukuk
4712 Add documentation for various new fields.
4713
4714 passwd.5
4715 Horacio Rodriguez Montero
4716 Add explanation of 'x' character in 'password' field.
4717 mtk
4718 The proper name of "*" is "asterisk" not "star".
4719
4720 tcp.7
4721 Johan Lithander
4722 Update RFC reference for ECN.
4723 Andi Kleen
4724 Add sentence on "low memory" limit for tcp_mem on 32-bit systems.
4725
4726
4727 ==================== Changes in man-pages-2.36 ====================
4728
4729 Released: 2006-07-11
4730
4731 Contributors
4732 ------------
4733
4734 The following people contributed notes, ideas, or patches that have
4735 been incorporated in changes in this release:
4736
4737 Alain Portal <aportal@univ-montp2.fr>
4738 Jens Axboe <jans@suse.de>
4739 Justin Pryzby <justinpryzby@users.sourceforge.net>
4740 Kyle McMartin <kyle@mcmartin.ca>
4741
4742 Apologies if I missed anyone!
4743
4744 Global changes
4745 --------------
4746
4747 Typographical or grammatical errors have been corrected in several
4748 places.
4749
4750 New pages
4751 ---------
4752
4753 MAINTAINING
4754 mtk
4755 How to maintain man-pages.
4756
4757 TODO
4758 mtk
4759 Things that it would be nice to get done for man-pages one day.
4760
4761 scripts/FIXME_list.sh
4762 mtk
4763 This script, intended for use by manual page maintainers,
4764 displays the FIXMEs in the manual page source files.
4765
4766 Changes to individual pages
4767 ---------------------------
4768
4769 fdatasync.2
4770 fsync.2
4771 mtk
4772 Added SEE ALSO referring to sync_file_range.2.
4773
4774 sendfile.2
4775 mtk / Jens Axboe
4776 Fix description of 'offset' argument to explain the case
4777 where 'offset' is NULL.
4778
4779 ferror.3
4780 Justin Pryzby
4781 Add SEE ALSO referring to fdopen.3.
4782
4783 intro.3
4784 mtk
4785 Removed information about Section 3 subsections -- it doesn't
4786 reflect current reality, and probably never has.
4787
4788 Added SEE ALSO referring to intro.2.
4789
4790 tcp.7
4791 Kyle McMartin
4792 Correction: tcp_window_scaling is ENabled by default.
4793
4794
4795 ==================== Changes in man-pages-2.37 ====================
4796
4797 Released: 2006-08-02
4798
4799 Contributors
4800 ------------
4801
4802 The following people contributed notes, ideas, or patches that have
4803 been incorporated in changes in this release:
4804
4805 Alain Portal <aportal@univ-montp2.fr>
4806 Dean Gaudet <dean@arctic.org>
4807 Frank van Viegen <F.C.vanViegen@UTwente.nl>
4808 Helmut Grohne <helmut@subdivi.de>
4809 Ivana Varekova <varekova@redhat.com>
4810 Thomas Huriaux <thomas.huriaux@gmail.com>
4811 Ville Skyttä <ville.skytta@iki.fi>
4812
4813 Apologies if I missed anyone!
4814
4815 Global changes
4816 --------------
4817
4818 Thomas Huriaux / mtk
4819
4820 Various formatting problems found as a result of reviewing the
4821 following command were fixed.
4822
4823 for a in $(wc -l man?/*.?| awk '$1 > 2 {print $2}' | grep -v total); do
4824 echo $a; groff -Tascii -wmac -mman $a > /dev/null;
4825 done 2>&1 | less
4826
4827 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378544
4828
4829 Typographical or grammatical errors have been corrected in several
4830 places.
4831
4832 New pages
4833 ---------
4834
4835 readlinkat.2
4836 mtk (after prompting from Ivana Varekova)
4837 New page for readlinkat(2), new in kernel 2.6.16.
4838
4839 Changes to individual pages
4840 ---------------------------
4841
4842 ldd.1
4843 Ville Skyttä
4844 Document "-u" option.
4845
4846 chdir.2
4847 mtk
4848 Noted effect of fork() and execve() on current working directory.
4849
4850 chroot.2
4851 mtk
4852 Noted effect of fork() and execve() on root directory.
4853
4854 epoll_ctl.2
4855 Frank van Viegen / mtk
4856 Fix description of EBADF error.
4857
4858 exevce.2
4859 mtk
4860 Add text noting that effective IDs are copied to
4861 saved set-IDs during execve().
4862 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379297
4863
4864 getitimer.2
4865 mtk
4866 Noted effect of fork() and execve() on interval timers.
4867
4868 getrlimit.2
4869 mtk
4870 Noted effect of fork() and execve() on resource limits.
4871
4872 getpriority.2
4873 mtk
4874 Noted effect of fork() and execve().
4875
4876 inotify_add_watch.2
4877 mtk
4878 Some rewording; included text describing required file
4879 permissions.
4880
4881 intro.2
4882 mtk
4883 Revised description of standards under CONFORMING TO.
4884
4885 makecontext.3
4886 Helmut Grohne / mtk
4887 Point out that args following 'argc' are int.
4888 mtk
4889 Added an example program.
4890 Various minor wording fixes.
4891
4892 mmap.2
4893 mtk
4894 Expand description of MAP_POPULATE.
4895 mtk, after prompting by Dean Gaudet
4896 Expand description MAP_NONBLOCK.
4897 mtk
4898 Various minor formatting fixes.
4899
4900 openat.2
4901 mtk
4902 Added SEE ALSO linking to readlinkat.2.
4903
4904 nanosleep.2
4905 mtk
4906 Noted buggy behavior in Linux 2.4 and earlier when
4907 nanosleep() is restarted after receiving stop+SIGCONT signals.
4908
4909 nice.2
4910 mtk
4911 Very minor rewording.
4912
4913 readlink.2
4914 mtk
4915 Added SEE ALSO linking to readlinkat.2.
4916
4917 sched_setscheduler.2
4918 mtk
4919 Noted preservation of scheduling parameters across execve().
4920
4921 setpgid.2
4922 mtk
4923 Noted effect of fork() and execve() on process group ID.
4924
4925 setsid.2
4926 mtk
4927 Noted effect of fork() and execve() on session ID.
4928
4929 umask.2
4930 mtk
4931 Noted effect of fork() and execve() on umask.
4932
4933 atexit.3
4934 mtk
4935 Noted inheritance of registrations across fork().
4936
4937 capabilities.7
4938 mtk
4939 Added material on privileges required for move_pages().
4940 CLONE_NEWNS needs CAP_SYS_ADMIN.
4941 keyctl(KEYCTL_CHOWN) and keyctl(KEYCTL_SETPERM) require
4942 CAP_SYS_ADMIN.
4943
4944
4945 ==================== Changes in man-pages-2.38 ====================
4946
4947 Released: 2006-08-03
4948
4949 Contributors
4950 ------------
4951
4952 The following people contributed notes, ideas, or patches that have
4953 been incorporated in changes in this release:
4954
4955 Alain Portal <aportal@univ-montp2.fr>
4956
4957 Apologies if I missed anyone!
4958
4959 Global changes
4960 --------------
4961
4962 Most pages
4963 mtk
4964 There was a major reworking of the CONFORMING TO sections
4965 in most manual pages.
4966
4967 * generally try to rationalize the names used for standards.
4968 The preferred names are now documented as the head words
4969 of the list in standards(7). For the future: there is
4970 probably no need to talk about anything more than
4971 C89, C99, POSIX.1-2001 (or later), xBSD, and SVr4.
4972 (In particular, I've eliminated most references to XPG
4973 and SVID, replacing them with references to SUS or SVr4.)
4974
4975 * eliminate discussion of errors that can occur on other
4976 systems. This information exists only patchily in the
4977 manual pages, is probably of limited use, is hard to maintain,
4978 and was in some cases simply wrong (and probably always was).
4979
4980 * Tried to ensure that those interfaces specified in C99 or
4981 POSIX.1-2001 are marked as such in their manual pages.
4982
4983 intro.1
4984 intro.2
4985 intro.3
4986 intro.4
4987 intro.5
4988 intro.7
4989 feature_test_macros.7
4990 mtk
4991 Added SEE ALSO referring to new standards.7.
4992
4993 Various pages
4994 mtk
4995 Changed instances of "HP UX" to "HP-UX".
4996
4997 Various pages
4998 mtk
4999 Changed instances of "DG-UX to "DG/UX"
5000
5001 Typographical or grammatical errors have been corrected in several
5002 places.
5003
5004 New pages
5005 ---------
5006
5007 standards.7
5008 mtk
5009 Based on material taken from intro.2, but expanded to
5010 include discussion of many additional standards.
5011
5012 Changes to individual pages
5013 ---------------------------
5014
5015 bind.2
5016 mtk
5017 Minor wording change for ENOTSOCK error.
5018
5019 intro.2
5020 mtk
5021 Removed information on standards to new standards.7.
5022
5023
5024 ==================== Changes in man-pages-2.39 ====================
5025
5026 Released: 2006-08-05
5027
5028 Contributors
5029 ------------
5030
5031 The following people contributed notes, ideas, or patches that have
5032 been incorporated in changes in this release:
5033
5034 Alain Portal <aportal@univ-montp2.fr>
5035
5036 Apologies if I missed anyone!
5037
5038 Global changes
5039 --------------
5040
5041 Various pages
5042 mtk
5043 Updated CONFORMING TO and/or standards references
5044 in various pages that were missed for 2.38.
5045
5046 Typographical or grammatical errors have been corrected in several
5047 places.
5048
5049 Changes to individual pages
5050 ---------------------------
5051
5052
5053 chdir.2
5054 mtk
5055 _XOPEN_SOURCE=500 also gets fchdir() prototype.
5056
5057 standards.7
5058 mtk
5059 Added a few more standards, and expand some explanations.
5060
5061
5062 ==================== Changes in man-pages-2.40 ====================
5063
5064 Released: 2006-09-04
5065
5066 Contributors
5067 ------------
5068
5069 The following people contributed notes, ideas, or patches that have
5070 been incorporated in changes in this release:
5071
5072 Alain Portal <aportal@univ-montp2.fr>
5073 Andi Kleen <ak@suse.de>
5074 Andries Brouwer <Andries.Brouwer@cwi.nl>
5075 Christoph Hellwig <hch@lst.de>
5076 Chuck Ebbert <76306.1226@compuserve.com>
5077 Samuel Thibault <samuel.thibault@ens-lyon.org>
5078 Toralf Förster <toralf.foerster@gmx.de>
5079
5080 Apologies if I missed anyone!
5081
5082 Global changes
5083 --------------
5084
5085 faccessat.2
5086 fchmodat.2
5087 fchownat.2
5088 fstatat.2
5089 futimesat.2
5090 linkat.2
5091 mkdirat.2
5092 mknodat.2
5093 openat.2
5094 readlinkat.2
5095 renameat.2
5096 symlinkat.2
5097 mtk (after a note by Alain Portal)
5098 Make naming of 'pathname' argument consistent; various
5099 minor rewordings.
5100
5101 Typographical or grammatical errors have been corrected in several
5102 places.
5103
5104 Changes to individual pages
5105 ---------------------------
5106
5107 clone.2
5108 mtk
5109 Reinstate text on CLONE_DETACHED, and add a few words.
5110
5111 execve.2
5112 mtk
5113 Added list of process attributes that are not preserved on exec().
5114
5115 fork.2
5116 mtk, after a suggestion by Christoph Hellwig
5117 Greatly expanded, to describe all attributes that differ
5118 in parent and child.
5119
5120 linkat.2
5121 mtk
5122 Document AT_SYMLINK_FOLLOW (new in 2.6.18).
5123
5124 set_mempolicy.2
5125 mtk / Andi Kleen
5126 Memory policy is preserved across execve().
5127
5128 write.2
5129 mtk / Alain Portal
5130 SEE ALSO for writev should refer to Section 2, not 3.
5131 (i.e., really make the change that was logged in 2.34)
5132
5133 getcwd.3
5134 Samuel Thibault / mtk
5135 Fix SYNOPSIS and CONFORMING TO text for getwd() and
5136 get_current_dir().
5137 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=381692
5138
5139 proc.5
5140 Chuck Ebbert
5141 Document /proc/PID/auxv.
5142
5143 capabilities.7
5144 Alain Portal
5145 Restore text accidentally deleted in 2.39.
5146
5147 regex.7
5148 mtk / Alain Portal
5149 Change references to "1003.2" to "POSIX.2".
5150
5151
5152 ==================== Changes in man-pages-2.41 ====================
5153
5154 Released: 2006-10-12
5155
5156 Contributors
5157 ------------
5158
5159 The following people contributed notes, ideas, or patches that have
5160 been incorporated in changes in this release:
5161
5162 Andi Kleen <ak@suse.de>
5163 Andries Brouwer <Andries.Brouwer@cwi.nl>
5164 Andrew Morton <akpm@osdl.org>
5165 Britton Leo Kerin <bkerin_rb@letterboxes.org>
5166 Dan Jacobson <jidanni@jidanni.org>
5167 Guillem Jover <guillem@hadrons.org>
5168 Hrvoje Niksic <hniksic@xemacs.org>
5169 Jens Axboe <axboe@suse.de>
5170 Justin Pryzby <justinpryzby@users.sourceforge.net>
5171 Kevin Ryde <user42@zip.com.au>
5172 Marcel Holtmann <marcel@holtmann.org>
5173 Senthil Kumar <senthilkumar_sen@hotpop.com>
5174 Stefan Puiu <stefanpuiuro@yahoo.com>
5175 Stuart MacDonald <stuartm@connecttech.com>
5176 Trond Myklebust <trond.myklebust@fys.uio.no>
5177
5178 Apologies if I missed anyone!
5179
5180
5181 Global changes
5182 --------------
5183
5184 Typographical or grammatical errors have been corrected in several
5185 places.
5186
5187
5188 New pages
5189 ---------
5190
5191 splice.2
5192 tee.2
5193 vmsplice.2
5194 Jens Axboe / Michael Kerrisk
5195 See also:
5196 http://lwn.net/Articles/118760/
5197 http://lwn.net/Articles/178199/
5198 http://lwn.net/Articles/179492/
5199 http://kerneltrap.org/node/6505
5200 http://lwn.net/Articles/179434/
5201
5202 Changes to individual pages
5203 ---------------------------
5204
5205 ldd.1
5206 Stefan Puiu
5207 Note glibc version where "ldd -u" appeared.
5208
5209 execve.2
5210 mtk
5211 The PR_SET_NAME setting is not preserved across an execve().
5212
5213 fork.2
5214 mtk
5215 Mappings marked with madvise(MADV_DONTFORK) are not inherited
5216 by child.
5217
5218 getdtablesize.2
5219 mtk
5220 Noted that sysconf(_SC_OPEN_MAX) is preferred in portable
5221 applications.
5222
5223 getpagesize.2
5224 mtk
5225 Noted that sysconf(_SC_PAGE_SIZE) is preferred in portable
5226 applications.
5227 _SC_PAGE_SIZE is available on most systems.
5228
5229 madvise.2
5230 mtk
5231 Document MADV_REMOVE, new in 2.6.16.
5232 Document MADV_DONTFORK / MADV_DOFORK, new in 2.6.16.
5233
5234 mount.2
5235 mtk / Trond Myklebust
5236 MNT_FORCE can cause data loss.
5237
5238 mmap.2
5239 mtk
5240 Added note on Linux's old (pre-2.6.12) buggy treatment of
5241 length==0.
5242 Justin Pryzby / mtk
5243 Added some EINVAL errors.
5244
5245 mremap.2
5246 mtk
5247 Remove superfluous "#include <unistd.h>" from SYNOPSIS.
5248
5249 msync.2
5250 mtk
5251 Added EBUSY error for case where MS_INVALIDATE is applied to
5252 a locked region.
5253
5254 posix_fadvise.2
5255 Andrew Morton
5256 Since 2.6.18, POSIX_FADV_NOREUSE is a no-op.
5257
5258 prctl.2
5259 Marcel Holtmann / mtk
5260 Since kernel 2.6.18, setting 2 for PR_SET_DUMPABLE is no longer
5261 possible.
5262 Guillem Jover
5263 Updated Linux versions where the options where introduced.
5264 Added PR_SET_TIMING, PR_GET_TIMING, PR_SET_NAME, PR_GET_NAME,
5265 PR_SET_UNALIGN, PR_GET_UNALIGN, PR_SET_FPEMU, PR_GET_FPEMU,
5266 PR_SET_FPEXC, PR_GET_FPEXC.
5267 Michael Kerrisk
5268 Document PR_GET_ENDIAN and PR_SET_ENDIAN.
5269
5270 remap_file_pages.2
5271 mtk
5272 Add "#define _GNU_SOURCE" to SYNOPSIS.
5273
5274 sync_file_range.2
5275 mtk
5276 Noted that sync_file_range() appeared in kernel 2.6.17.
5277
5278 vfork.2
5279 mtk
5280 Noted interactions with fork handlers in multithreaded programs.
5281
5282 wait4.2
5283 mtk
5284 Added feature test macros to SYNOPSIS.
5285
5286 clog2.3
5287 mtk / aeb / Kevin Ryde
5288 Fix broken text in description.
5289 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5290
5291 clog10.3
5292 Kevin Ryde
5293 Fix broken text in description.
5294 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
5295
5296 mq_receive.3
5297 Britton Leo Kerin
5298 Fix return type in SYNOPSIS; should be "ssize_t" not "mqd_t".
5299 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=387551
5300
5301 qsort.2
5302 Hrvoje Niksic
5303 Fix wording referring to the use of strcmp() in 'compar'
5304 function.
5305 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=391402
5306
5307 sendfile.2
5308 mtk
5309 Added SEE ALSO referring to new splice.2 page.
5310
5311 termios.3
5312 mtk
5313 Documented IUTF8 (which was new in kernel 2.6.4).
5314
5315 tzset.3
5316 mtk
5317 Added some TZ examples.
5318 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386087
5319
5320 proc.5
5321 mtk
5322 Added delayacct_blkio_ticks (new in 2.6.18) to /proc/PID/statm.
5323
5324 ip.7
5325 Stuart MacDonald / Andi Kleen
5326 Fix discussion for TCP error queue /IP_RECVERR on TCP.
5327
5328 pthreads.7
5329 mtk
5330 Noted effect of RLIMIT_STACK resource limit for NPTL.
5331
5332 socket.7
5333 Senthil Kumar
5334 Place socket options in alphabetical order.
5335
5336
5337 ==================== Changes in man-pages-2.42 ====================
5338
5339 Released: 2006-11-24
5340
5341 Contributors
5342 ------------
5343
5344 The following people contributed notes, ideas, or patches that have
5345 been incorporated in changes in this release:
5346
5347 Andrew Morton <akpm@osdl.org>
5348 Chuck Ebbert <76306.1226@compuserve.com>
5349 Doug Goldstein <cardoe@gentoo.org>
5350 Eduard Bloch <blade@debian.org>
5351 Evan Teran <eteran@alum.rit.edu>
5352 Pavel Heimlich <tropikhajma@seznam.cz>
5353 Petr Baudis <pasky@ucw.cz>
5354 Randy Dunlap <rdunlap@xenotime.net>
5355 Ulrich Drepper <drepper@redhat.com>
5356
5357 Apologies if I missed anyone!
5358
5359
5360 Global changes
5361 --------------
5362
5363 Typographical or grammatical errors have been corrected in several
5364 places.
5365
5366
5367 Changes to individual pages
5368 ---------------------------
5369
5370 brk.2
5371 Evan Teran / mtk
5372 Add text describing behavior of the Linux brk() system call
5373 and point out that the glibc brk() wrapper provides different
5374 behavior.
5375 mtk
5376 Note that sbrk() is implemented as a library function in glibc
5377 that calls the brk() system call.
5378
5379 futex.2
5380 mtk
5381 FUTEX_FD is scheduled for removal in June 2007.
5382
5383 getaddrinfo.3
5384 getnameinfo.3
5385 Ulrich Drepper, with edits by mtk
5386 Add text describing Internationalized Domain Name
5387 extensions.
5388
5389 open.2
5390 mtk / Eduard Bloch
5391 Fix description of O_LARGEFILE to mention required feature test
5392 macros.
5393
5394 ptrace.2
5395 Chuck Ebbert
5396 Since Linux 2.6.18, the PID of the new process is also available
5397 for PTRACE_EVENT_VFORKDONE.
5398
5399 syslog.3
5400 Doug Goldstein
5401 Fix header file required for vsyslog() in SYNOPSIS.
5402
5403 wcwidth.3
5404 Petr Baudis
5405 Fix CONFORMING TO.
5406
5407 core.5
5408 mtk
5409 Linux 2.4.21 added core_pattern (which was already in 2.6).
5410 Noted a few more reasons why a core dump file might not
5411 be produced.
5412
5413
5414 ==================== Changes in man-pages-2.43 ====================
5415
5416 Released: 2006-11-29
5417
5418 Contributors
5419 ------------
5420
5421 The following people contributed notes, ideas, or patches that have
5422 been incorporated in changes in this release:
5423
5424 Andi Kleen <ak@suse.de>
5425 David Brownell <david-b@pacbell.net>
5426 Eduard Bloch <blade@debian.org>
5427 Egmont Koblinger <egmont@uhulinux.hu>
5428 Reuben Thomas <rrt@sc3d.org>
5429
5430 Apologies if I missed anyone!
5431
5432
5433 Global changes
5434 --------------
5435
5436 Typographical or grammatical errors have been corrected in several
5437 places.
5438
5439
5440 Changes to individual pages
5441 ---------------------------
5442
5443 ioperm.2
5444 mtk
5445 Clarify discussion of privilege requirements.
5446 Added ENOMEM to ERRORS.
5447
5448 open.2
5449 mtk / Eduard Bloch
5450 Clarify description of O_LARGEFILE.
5451
5452 crypt.3
5453 Egmont Koblinger
5454 Make description of MD5 output string less ambiguous.
5455
5456 strerror.3
5457 Reuben Thomas
5458 Add C99 to CONFORMING TO; see
5459 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400634
5460
5461 rtc.4
5462 David Brownell
5463
5464 Update the RTC man page to reflect the new RTC class framework:
5465
5466 - Generalize ... it's not just for PC/AT style RTCs, and there
5467 may be more than one RTC per system.
5468
5469 - Not all RTCs expose the same feature set as PC/AT ones; most
5470 of these ioctls will be rejected by some RTCs.
5471
5472 - Be explicit about when {A,P}IE_{ON,OFF} calls are needed.
5473
5474 - Describe the parameter to the get/set epoch request; correct
5475 the description of the get/set frequency parameter.
5476
5477 - Document RTC_WKALM_{RD,SET}, which don't need AIE_{ON,OFF} and
5478 which support longer alarm periods.
5479
5480 - Hey, not all system clock implementations count timer irqs any
5481 more now that the new RT-derived clock support is merging.
5482
5483 proc.5
5484 mtk
5485 s/fseek(3)/lseek(2)/ under /proc/PID/mem entry.
5486
5487 feature_test_macros.7
5488 mtk / Eduard Bloch
5489 The LFS spec is now at http://opengroup.org/platform/lfs.html
5490
5491 raw.7
5492 udp.7
5493 Andi Kleen
5494 Describe the correct default for UDP/RAW path MTU discovery.
5495
5496
5497 ==================== Changes in man-pages-2.44 ====================
5498
5499 Released: 2007-04-04
5500
5501 Contributors
5502 ------------
5503
5504 The following people contributed notes, ideas, or patches that have
5505 been incorporated in changes in this release:
5506
5507 Andre Majorel <aym-naideb@teaser.fr>
5508 Benjamin Gilbert <bgilbert@cs.cmu.edu>
5509 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
5510 Chuck Ebbert <76306.1226@compuserve.com>
5511 Ivana Varekova <varekova@redhat.com>
5512 Jakub Jelinek <jakub@redhat.com>
5513 John Ward <jward@idealcorp.com>
5514 Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
5515 Julien Blache <jblache@debian.org>
5516 Julien Cristau <jcristau@debian.org>
5517 Justin Pryzby <justinpryzby@users.sourceforge.net>
5518 Martín Ferrari <martin.ferrari@gmail.com>
5519 Mike Frysinger <vapier@gentoo.org>
5520 Nick Piggin <npiggin@suse.de>
5521 Nick Pollitt <npollitt@mvista.com>
5522 Nicolas François <nicolas.francois@centraliens.net>
5523 Pádraig Brady <P@draigBrady.com>
5524 Premysl Hruby <dfenze@gmail.com>
5525 Reuben Thomas <rrt@sc3d.org>
5526 Samuel Thibault <samuel.thibault@ens-lyon.org>
5527 Serge E. Hallyn <serge@hallyn.com>
5528 Thomas Huriaux <thomas.huriaux@gmail.com>
5529 Timo Sirainen <tss@iki.fi>
5530 Val Henson <val_henson@linux.intel.com>
5531
5532 Apologies if I missed anyone!
5533
5534
5535 New pages
5536 ---------
5537
5538 termio.7
5539 mtk, after a bit of prodding by Reuben Thomas
5540 A brief discussion of the old System V termio interface,
5541 with pointers to pages that will contain the information
5542 that the reader probably wants.
5543
5544 scripts/find_repeated_words.sh
5545 mtk
5546 Find consecutive duplicate words in a man page, some of
5547 which may be grammar errors.
5548
5549 Global changes
5550 --------------
5551
5552 Various pages
5553 Justin Pryzby / mtk
5554 Add "#define _ATFILE_SOURCE" to SYNOPSIS in following pages:
5555 faccessat.2
5556 fchmodat.2
5557 fchownat.2
5558 fstatat.2
5559 futimesat.2
5560 linkat.2
5561 mkdirat.2
5562 mknodat.2
5563 openat.2
5564 readlinkat.2
5565 renameat.2
5566 symlinkat.2
5567 unlinkat.2
5568 mkfifoat.3
5569
5570 Various pages
5571 mtk
5572 Various references to "getty" were changed to "mingetty", since
5573 that is the manual page more likely to be found on current systems.
5574
5575 Various pages
5576 mtk, after a suggestion by Reuben Thomas <rrt@sc3d.org>
5577 Updated various header pages to accurately reflect which functions
5578 are and are not part of C89. Also fixed/improved a few other
5579 CONFORMING TO entries.
5580
5581 Various pages
5582 mtk
5583 s/Unices/Unix systems/ on the 5 pages where it appears.
5584
5585 Various pages
5586 mtk
5587 Wrapped long source lines in the following files
5588 getsockopt.2
5589 mknodat.2
5590 io_setup.2
5591 select_tut.2
5592 select.2
5593 readlinkat.2
5594 io_cancel.2
5595 syslog.2
5596 wcsncat.3
5597 getipnodebyname.3
5598 cmsg.3
5599 wcpncpy.3
5600 wcsrtombs.3
5601 wcstok.3
5602 fgetwc.3
5603 wmemcmp.3
5604 wcsspn.3
5605 div.3
5606 modf.3
5607 stdio_ext.3
5608 ctermid.3
5609 des_crypt.3
5610 wcsncmp.3
5611 wmemchr.3
5612 wcsstr.3
5613 wmemcpy.3
5614 wprintf.3
5615 wcsnrtombs.3
5616 termios.3
5617 erf.3
5618 ceil.3
5619 lround.3
5620 nextafter.3
5621 wcsncpy.3
5622 wmemset.3
5623 getw.3
5624 console_ioctl.4
5625 sk98lin.4
5626 environ.7
5627 unix.7
5628 time.7
5629
5630 Various pages
5631 mtk
5632 Added a SEE ALSO reference for feature_test_macros(7) to all
5633 pages where a feature test macro appears in the SYNOPSIS.
5634
5635 Various pages
5636 mtk
5637 Added SEE ALSO entry pointing to time.7
5638 alarm.2
5639 nanosleep.2
5640 ualarm.3
5641 usleep.3
5642
5643 Various pages
5644 Justin Pryzby / mtk
5645 Fixed consecutive duplicate word typos on a number of pages.
5646
5647 Typographical or grammatical errors have been corrected in several
5648 places. (Special thanks to Nicolas François!)
5649
5650
5651 Changes to individual pages
5652 ---------------------------
5653
5654 access.2
5655 mtk
5656 Since 2.6.20, access() honors the MS_NOEXEC mount flag.
5657 Jorge Peixoto de Morais Neto / mtk
5658 Improve ENOENT description.
5659
5660 clone.2
5661 mtk
5662 Added some detail to the prototype.
5663 Added some notes on IA-64's clone2().
5664
5665 epoll_ctl.2
5666 mtk
5667 Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
5668
5669 faccessat.2
5670 Justin Pryzby
5671 Various fixes as per
5672 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411177
5673 * s/effective/real/ in description text.
5674 * added <fcntl.h> to synopsis.
5675 * various other changes.
5676
5677 getrlimit.2
5678 mtk / Fedora downstream patches; thanks to Ivana Varekova
5679 Added a few words to note that RLIMIT_NPROC is really a limit on
5680 threads.
5681
5682 io_cancel.2
5683 io_destroy.2
5684 io_getevents.2
5685 io_setup.2
5686 io_submit.2
5687 Fedora downstream patches; thanks to Ivana Varekova
5688 s%linux/aio.h%libaio.h% in SYNOPSIS.
5689 Changed return type from "long" to "int".
5690
5691 mbind.2
5692 Samuel Thibault / mtk
5693 Fix EINVAL description.
5694 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411777
5695
5696 mincore.2
5697 Nick Piggin
5698 Kernel 2.6.21 fixes several earlier bugs in mincore().
5699 Nick Pollitt
5700 Remove words "of a file" -- mincore() is describing
5701 memory residence information, not properties of a file.
5702 mtk
5703 Rewrote various parts to make the page clearer.
5704
5705 mmap.2
5706 mtk
5707 Rewrote and reorganized various parts to be clearer.
5708 Taken from Fedora downstream patches; thanks to Ivana Varekova
5709 Removed text stating that mmap() never returns 0; that's
5710 not true.
5711
5712 mount.2
5713 mtk / Val Henson
5714 Document MS_RELATIME, new in Linux 2.6.20.
5715
5716 open.2
5717 Andre Majorel / mtk
5718 On Linux, the error returned when opening a large file on a
5719 32-bit system is actually EFBIG, not EOVERFLOW.
5720
5721 posix_fadvise.2
5722 Pádraig Brady
5723 Fix RETURN VALUE description: returns error number of failure.
5724
5725 rename.2
5726 mtk / Timo Sirainen
5727 Various improvements to DESCRIPTION.
5728 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416012
5729
5730 semop.2
5731 mtk
5732 If sops contains multiple operations, then these are performed
5733 in array order. All Unix systems that I know of do this,
5734 and some Linux applications depend on this behavior. SUSv3
5735 made no explicit statement here, but SUSv4 will explicitly
5736 require this behavior.
5737 Small rewording of explanation of "atomically".
5738
5739 signal.2
5740 Nicolas François
5741 Fix incorrect argument name in DESCRIPTION.
5742 mtk
5743 Small wording improvement.
5744
5745 socket.2
5746 Nicolas François
5747 Add reference to ipv6.7 page.
5748
5749 socketcall.2
5750 Nicolas François
5751 Fix .TH line.
5752
5753 splice.2
5754 Benjamin Gilbert
5755 Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
5756
5757 statvfs.2
5758 mtk
5759 Small wording clarification.
5760
5761 symlink.2
5762 mtk / Nicolas François
5763 Removed cryptic text under CONFORMING to referring to
5764 "open(2) and NFS". There is no relevant text in open.2 as
5765 far as I (mtk) can see.
5766
5767 time.2
5768 mtk / Reuben Thomas
5769 Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
5770 This information is old, and probably no longer relevant.
5771 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=403888
5772
5773 write.2
5774 mtk, after an idea from a downstream Fedora patch.
5775 Clarified discussion of /count == 0/ case.
5776
5777 ptrace.2
5778 Chuck Ebbert
5779 When the parent receives an event with PTRACE_EVENT_* set,
5780 the child is not in the normal signal delivery path. This
5781 means the parent cannot do ptrace(PTRACE_CONT) with a signal
5782 or ptrace(PTRACE_KILL). kill() with a SIGKILL signal can be
5783 used instead to kill the child process after receiving one
5784 of these messages.
5785
5786 sched_setaffinity.2
5787 mtk
5788 Fix glibc version number in description of 'cpusetsize' argument.
5789
5790 vfork.2
5791 mtk
5792 Stripped some excess/outdated text from the BUGS section.
5793
5794 basename.3
5795 mtk / Jorge Peixoto de Morais Neto
5796 Add text to clarify that the pointer returned by these
5797 functions may be into some part of 'path'.
5798
5799 dlopen.3
5800 Taken from Fedora downstream patches; thanks to Ivana Varekova
5801 + Carlo Marcelo Arenas Belon
5802 Add "#include <stdlib.h>" to example program.
5803
5804 fclose.3
5805 mtk
5806 Complete rewrite. The existing page was hard to read,
5807 and the RETURN VALUE description seems to be wrong.
5808
5809 getopt.3
5810 mtk
5811 Added getopt() example program.
5812 mtk
5813 Add a few words to clarify the operation of the GNU-specific
5814 double-colon feature, which allows options to have optional
5815 arguments.
5816 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
5817
5818 glob.3
5819 Nicolas François
5820 Fix PROTOTYPE.
5821
5822 inet_network.3
5823 mtk, after an idea from a downstream Fedora patch.
5824 Clarified description of inet_network().
5825
5826 log.3
5827 Nicolas François
5828 Fix .TH line.
5829
5830 log10.3
5831 Nicolas François
5832 Fix .TH line.
5833
5834 malloc.3
5835 Nicolas François
5836 Small rewording to mention calloc().
5837
5838 posix_openpt.3
5839 Martín Ferrari
5840 Fix return type in SYNOPSIS; as per
5841 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
5842 Needs _XOPEN_SOURCE == 600; as per
5843 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400975
5844 Julien BLACHE
5845 s/ptsname/posix_openpt/ in RETURN VALUE
5846
5847 re_comp.3
5848 Taken from Fedora downstream patches; thanks to Ivana Varekova
5849 Add "#define _REGEX_RE_COMP" to SYNOPSIS.
5850
5851 regex.3
5852 Nicolas François
5853 Fix .TH line.
5854
5855 termios.3
5856 mtk
5857 Added .SS headers to give some structure to this page; and a small
5858 amount of reordering.
5859 mtk
5860 Added a section on canonical and non-canonical mode.
5861 mtk
5862 Enhanced the discussion of "raw" mode for cfmakeraw().
5863 mtk
5864 Document CMSPAR.
5865 mtk
5866 Make description of PARODD a little clearer.
5867 Reuben Thomas
5868 Add SEE ALSO link to tty_ioctl.4
5869 mtk
5870 Add SEE ALSO link to console_ioctl.4
5871
5872 ualarm.3
5873 mtk
5874 Removed BSD prototype from synopsis.
5875 Various rewordings.
5876
5877 usleep.3
5878 mtk
5879 Removed BSD prototype from synopsis.
5880 Various rewordings.
5881
5882 termcap.5
5883 Taken from Fedora downstream patches; thanks to Ivana Varekova
5884 s/curses/ncurses/ under SEE ALSO
5885
5886 bootparam.7
5887 Taken from Fedora downstream patches; thanks to Ivana Varekova
5888 Documented "mem=nopentium".
5889
5890 feature_test_macros.7
5891 mtk
5892 The default treatment of _POSIX_C_SOURCE changed in glibc 2.4.
5893 mtk, after a suggestion by Justin Pryzby
5894 Added some text warning that the "__" macros that
5895 <features.h> defines internally should never be
5896 directly defined by programs.
5897 mtk, based on notes by Jakub Jelinek
5898 Document _FORTIFY_SOURCE
5899 (See http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html )
5900 mtk
5901 Document _REENTRANT and _THREAD_SAFE.
5902
5903 mdoc.7
5904 mtk / Nicolas François
5905 Remove CONFIGURATION section, since this does not seem to be
5906 true for Linux.
5907
5908 svipc.7
5909 Nicolas François
5910 Fix data types in associated data structures;
5911 remove nonexistent semzcnt and semncnt fields.
5912
5913 time.7
5914 mtk
5915 Since kernel 2.6.20, the software clock can also be 300 HZ.
5916
5917
5918 ==================== Changes in man-pages-2.45 ====================
5919
5920 Released: 2007-04-05
5921
5922 Global changes
5923 --------------
5924
5925 This release consists mainly of formatting fixes (to a large
5926 number of pages) to achieve greater consistency across pages.
5927 With the exception of the few individual changes noted below,
5928 no changes were made to content.
5929
5930 Changes to individual pages
5931 ---------------------------
5932
5933 io_destroy.2
5934 io_getevents.2
5935 io_setup.2
5936 io_cancel.2
5937 io_submit.2
5938 mtk
5939 Clarified RETURN VALUE text
5940
5941 bindresvport.3
5942 mtk
5943 Rewrote prototype using modern C syntax.
5944
5945
5946 ==================== Changes in man-pages-2.46 ====================
5947
5948 Released: 2007-04-06
5949
5950 Global changes
5951 --------------
5952
5953 This release consists mainly of formatting fixes (to a large
5954 number of pages) to achieve greater consistency across pages:
5955
5956 * Most instances of two or more consecutive blank lines in man
5957 page output were shrunk to a single line.
5958 * A number of example programs were reformatted
5959 to more closely match K&R style.
5960 * In various places (mainly code examples), the use of tabs was
5961 replaced by spaces
5962
5963 With the exception of the few individual changes noted below,
5964 no changes were made to content.
5965
5966
5967 Changes to individual pages
5968 ---------------------------
5969
5970 bdflush.2
5971 mtk
5972 Add <sys/kdaemon.h> header file to SYNOPSIS.
5973
5974 sched_rr_get_interval.2
5975 mtk
5976 Moved timespec definition from SYNOPSIS into description.
5977
5978 select_tut.2
5979 mtk
5980 Make SYNOPSIS match select.2.
5981
5982
5983 ==================== Changes in man-pages-2.47 ====================
5984
5985 Released: 2007-05-04
5986
5987 Contributors
5988 ------------
5989
5990 The following people contributed notes, ideas, or patches that have
5991 been incorporated in changes in this release:
5992
5993 Andi Kleen <andi@firstfloor.org>
5994 John Heffner <jheffner@psc.edu>
5995
5996 Apologies if I missed anyone!
5997
5998
5999 Global changes
6000 --------------
6001
6002 This release consists mainly of changes to source file layout
6003 (wrapped long lines; stripped trailing white space; started new
6004 sentences on new lines).
6005
6006 There is very little change to output formatting or content (see the
6007 notes below).
6008
6009
6010 Changes to individual pages
6011 ---------------------------
6012
6013 sched_rr_get_interval.2
6014 mtk
6015 Remove crufty statement that this system call is not implemented.
6016 The nice interval can be used to control the size of
6017 the round-robin quantum.
6018 Corrected .TH line.
6019
6020 ip.7
6021 John Heffner / mtk
6022 Document IP_PMTUDISC_PROBE, which will be in 2.6.22.
6023
6024
6025 ==================== Changes in man-pages-2.48 ====================
6026
6027 Released: 2007-05-04
6028
6029 Contributors
6030 ------------
6031
6032 The following people contributed notes, ideas, or patches that have
6033 been incorporated in changes in this release:
6034
6035 Colin Watson <cjwatson@debian.org>
6036 Justin Pryzby <justinpryzby@users.sourceforge.net>
6037
6038 Apologies if I missed anyone!
6039
6040
6041 Global changes
6042 --------------
6043
6044 This release consists mainly of changes to source file layout
6045 (wrapped long lines; stripped trailing white space; started new
6046 sentences on new lines).
6047
6048 There is very little change to output formatting or content (see the
6049 notes below).
6050
6051 Various pages
6052 mtk
6053 In various places where it occurred,
6054 s/nonnegative/non-negative/
6055
6056 Various pages
6057 mtk
6058 s/wide character/wide-character/ when used attributively.
6059
6060
6061 Changes to individual pages
6062 ---------------------------
6063
6064 man.7
6065 Justin Pryzby / Colin Watson / mtk
6066 .SH doesn't require quotes.
6067 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411303
6068
6069
6070 ==================== Changes in man-pages-2.49 ====================
6071
6072 Released: 2007-05-20
6073
6074 Contributors
6075 ------------
6076
6077 The following people contributed notes, ideas, or patches that have
6078 been incorporated in changes in this release:
6079
6080 Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
6081 Bruno Haible <bruno@clisp.org>
6082 Justin Pryzby <justinpryzby@users.sourceforge.net>
6083
6084 Apologies if I missed anyone!
6085
6086
6087 New pages
6088 ---------
6089
6090 bsd_signal.3
6091 mtk
6092 Documentation of bsd_signal().
6093
6094 euidaccess.3
6095 mtk
6096 Manual page for euidaccess() and eaccess().
6097
6098 getsubopt.3
6099 mtk / Justin Pryzby
6100 Documentation of getsubopt().
6101
6102 sysv_signal.3
6103 mtk
6104 Documentation of sysv_signal().
6105
6106
6107 New links
6108 ---------
6109
6110 epoll_pwait.2
6111 mtk
6112 New link to epoll_wait.2.
6113
6114 eaccess.3
6115 mtk
6116 New link to new euidaccess.3,
6117
6118 sem_timedwait.3
6119 mtk
6120 New link to sem_wait.3.
6121
6122 sem_trywait.3
6123 mtk
6124 New link to sem_wait.3.
6125
6126
6127 Global changes
6128 --------------
6129
6130 Typographical or grammatical errors have been corrected in several
6131 places.
6132
6133
6134 Changes to individual pages
6135 ---------------------------
6136
6137 access.3
6138 mtk
6139 Added SEE ALSO ref to new euidaccess.3 page.
6140
6141 epoll_wait.2
6142 mtk
6143 Added description of epoll_pwait(), new in kernel 2.6.19.
6144
6145 execve.2
6146 mtk
6147 Add text noting that Linux allows 'argv' and 'envp' to be
6148 NULL, but warning that this is non-standard and non-portable,
6149 and should be avoided in portable programs.
6150 Bug filed (http://bugzilla.kernel.org/show_bug.cgi?id=8408)
6151 to get this changed, but maybe that won't be done because it
6152 is an ABI change.
6153 mtk
6154 Added an example program.
6155 mtk
6156 Expanded the discussion of interpreter scripts and the
6157 'optional-arg' argument of an interpreter script.
6158 For further info, see
6159 http://homepages.cwi.nl/~aeb/std/hashexclam-1.html
6160 http://www.in-ulm.de/~mascheck/various/shebang/
6161 mtk
6162 Added text noting that FD_CLOEXEC causes record locks to be
6163 released.
6164 mtk
6165 Mention effect of MS_NOSUID mount(2) flag for set-user-ID
6166 programs.
6167 mtk
6168 Expanded description of handling of file descriptors during
6169 execve(), adding text to note that descriptors 0, 1, and 2
6170 may be treated specially.
6171
6172 faccessat.3
6173 mtk
6174 Added SEE ALSO ref to new euidaccess.3 page.
6175
6176 mmap.2
6177 mtk
6178 Place MAP_* flags list in alphabetical order.
6179
6180 readv.2
6181 mtk
6182 A fairly substantial rewrite, which among other things
6183 fixes the problem reported by Kyle Sluder in
6184 http://bugzilla.kernel.org/show_bug.cgi?id=8399
6185 And added some example code.
6186
6187 sigaction.2
6188 mtk
6189 Added text referring to the discussion of async-signal-safe
6190 functions in signal(7).
6191 A few other minor formatting and wording changes.
6192
6193 signal.2
6194 mtk
6195 Moved the discussion of async-signal-safe functions to signal(7).
6196 Added text referring to the discussion of async-signal-safe
6197 functions in signal(7).
6198 Added SEE ALSO entries referring to new bsd_signal.3 and
6199 sysv_signal.3 pages.
6200
6201 copysign.3
6202 Bruno Haible
6203 Clarify discussion of negative zero.
6204
6205 getopt.3
6206 mtk
6207 Add SEE ALSO ref to new getsubopt.3.
6208
6209 iconv_open.3
6210 Bruno Haible
6211 Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions
6212 for 'tocode'.
6213
6214 iswblank.3
6215 Bruno Haible
6216 Update CONFORMING TO; iswblank() is in POSIX.1-2001.
6217
6218 inotify.7
6219 mtk
6220 Definitions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR
6221 were added to glibc in version 2.5.
6222
6223 signal.7
6224 mtk
6225 Incorporated (and slightly modified) the text on
6226 async-signal-safe functions that was formerly in signal(2).
6227 Added SEE ALSO entries referring to new bsd_signal.3 and
6228 sysv_signal.3 pages.
6229
6230
6231 ==================== Changes in man-pages-2.50 ====================
6232
6233 Released: 2007-05-21
6234
6235 Contributors
6236 ------------
6237
6238 The following people contributed notes, ideas, or patches that have
6239 been incorporated in changes in this release:
6240
6241 Andreas Halter <halter@google.com>
6242 Laird Shaw <netocrat@dodo.com.au>
6243 Mike Frysinger <vapier@gentoo.org>
6244
6245 Apologies if I missed anyone!
6246
6247 Removed pages (!)
6248 -----------------
6249
6250 Most Section 1 man pages are removed
6251 mtk (with help from Mike Frysinger, Laird Shaw, Andreas Halter)
6252 Once upon time Andries added a number of Section 1 manual pages
6253 to man-pages. However, since that time, those pages have not
6254 seen much maintenance, and are not in fact distributed in most
6255 distributions. Instead most distributions supply the
6256 coreutils versions of these pages, which are currently
6257 maintained. In addition, man-pages provides the 1p pages,
6258 which document the portable subset of functionality of these
6259 commands. Since the man1 pages are mostly unneeded, and
6260 out of date, I'm removing them. The following pages disappear:
6261
6262 chgrp.1
6263 chmod.1
6264 chown.1
6265 cp.1
6266 dd.1
6267 df.1
6268 diff.1
6269 dir.1
6270 dircolors.1
6271 du.1
6272 install.1
6273 ln.1
6274 ls.1
6275 mkdir.1
6276 mkfifo.1
6277 mknod.1
6278 mv.1
6279 rm.1
6280 rmdir.1
6281 touch.1
6282 vdir.1
6283
6284 The following Section 1 pages will be kept:
6285
6286 intro.1
6287 ldd.1
6288 time.1
6289
6290
6291 ==================== Changes in man-pages-2.51 ====================
6292
6293 Released: 2007-05-28
6294
6295 Global changes
6296 --------------
6297
6298 Various pages
6299 mtk
6300 (Hopefully) all cross references outside a page now include a
6301 section number. This should permit better resulting output
6302 from a man2html-type conversion.
6303
6304 Various pages
6305 mtk
6306 Convert function formatting of the form "\fBname\fP()" to
6307 ".BR name ()".
6308
6309
6310 Changes to individual pages
6311 ---------------------------
6312
6313 futimesat.2
6314 mtk
6315 s/futimes/futimesat/ in .SH NAME line.
6316
6317 msgop.2
6318 mtk
6319 Put "msgrcv" and "msgsnd" in .SH NAME line.
6320
6321 mount.2
6322 mtk
6323 Add "umount2" to .SH NAME line.
6324
6325 wait.2
6326 mtk
6327 Add "waitid" to .SH NAME line.
6328
6329 getopt.3
6330 mtk
6331 Add "getopt_long" and "getopt_long_only" in .SH NAME line.
6332
6333 sem_wait.3
6334 mtk
6335 Add "sem_timedwait" and "sem_trywait" to .SH NAME line.
6336
6337 stdarg.3
6338 mtk
6339 Add "va_start", "va_arg", "va_end", "va_copy" to .SH NAME line.
6340
6341
6342 ==================== Changes in man-pages-2.52 ====================
6343
6344 Released: 2007-05-29
6345
6346 "A foolish consistency is the hobgoblin of little minds, adored by
6347 little statesmen and philosophers and divines"
6348
6349 Ralph Waldo Emerson (1803-1882)
6350
6351 "But damn it, these man pages are a mess!"
6352
6353
6354 Global changes
6355 --------------
6356
6357 Most of the changes below are about bringing greater consistency
6358 to manual pages, including reducing the wide range of .SH
6359 Section headings.
6360
6361 Typographical or grammatical errors have been corrected in several
6362 places.
6363
6364 Various pages
6365 mtk
6366 Make 'manual' component of .TH line into the string
6367 "Linux Programmer's Manual".
6368 Reason: consistency.
6369
6370 Various pages
6371 mtk
6372 Changed date in .TH line into form YYYY-DD-MM.
6373 Reason: consistency.
6374
6375 Various pages
6376 mtk
6377 Some .SH header lines were made into .SS lines. (One of the aims
6378 here is to reduce the number of non-standard .SH lines.)
6379
6380 Various pages
6381 mtk
6382 Change title .SH sections named "NOTE" to "NOTES", in some cases
6383 also changing the location of the section within the page.
6384 Reason: consistency.
6385
6386 Various pages
6387 mtk
6388 Commented out .SH AUTHOR sections; the right place for
6389 documentation authorship sections is usually comments at the
6390 top of the page source.
6391
6392 Various pages
6393 mtk
6394 Changed .SH HISTORY to .SH VERSIONS.
6395 Reason: in many cases, HISTORY was being used to describe
6396 Linux/glibc version information, as was already done for
6397 VERSIONS sections in other pages.
6398
6399 Various pages
6400 mtk
6401 Removed HISTORY section, or moved it as a subsection or paragraphs
6402 under another section e.g., NOTES.
6403 Reason: there are too many arbitrary section (.SH) names, and
6404 a HISTORY section never was consistently used across Linux
6405 manual pages.
6406
6407 Various pages
6408 mtk
6409 Moved SEE ALSO section to be last section on the page
6410 Reason: consistency -- and this is where SEE ALSO should be!
6411
6412 Various pages
6413 mtk
6414 Relocated GLIBC NOTES as subsection under NOTES
6415 Reason: reduce number of arbitrary section (.SH) names.
6416
6417 Various pages
6418 mtk
6419 Relocated LINUX NOTES as subsection under NOTES
6420 Reason: reduce number of arbitrary section (.SH) names.
6421
6422 Various pages
6423 mtk
6424 Renamed some "AVAILABILITY" sections to "VERSIONS".
6425 Reason: consistency.
6426
6427 Various pages
6428 mtk
6429 Renamed some "DIAGNOSTICS" sections to "RETURN VALUE".
6430 Reason: consistency.
6431
6432 getopt.3
6433 tzselect.8
6434 mtk
6435 s/\.SH ENVIRONMENT VARIABLES/.SH ENVIRONMENT/
6436 Reason: consistency.
6437
6438 intro.2
6439 select.2
6440 sysctl.2
6441 bsearch.3
6442 dlopen.3
6443 envz_add.3
6444 fmtmsg.3
6445 getgrent_r.3
6446 getgrouplist.3
6447 getpwent_r.3
6448 getutent.3
6449 hsearch.3
6450 rtime.3
6451 strptime.3
6452 tsearch.3
6453 vcs.4
6454 wordexp.3
6455 mtk
6456 s/return 0/exit(EXIT_FAILURE)/ in main() of function example
6457 program.
6458 Reason: consistency.
6459
6460 mprotect.2
6461 select_tut.2
6462 dlopen.3
6463 getgrent_r.3
6464 getopt.3
6465 getpwent_r.3
6466 hsearch.3
6467 select_tut.2
6468 tsearch.3
6469 mtk
6470 Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
6471 to exit().
6472 Reason: consistency.
6473
6474 access.2
6475 chown.2
6476 lseek.2
6477 open.2
6478 read.2
6479 utmp.5
6480 mtk
6481 Renamed RESTRICTIONS section to NOTES, or moved text in a
6482 RESTRICTIONS section under existing NOTES section.
6483 Reason: consistency, and reduce number of arbitrary section (.SH)
6484 names.
6485
6486
6487 Changes to individual pages
6488 ---------------------------
6489
6490 capget.2
6491 mtk
6492 s/\.SH FURTHER INFORMATION/.SH NOTES/
6493
6494 dup.2
6495 mtk
6496 s/\.SH WARNING/.SH NOTES/
6497
6498 kill.2
6499 mtk
6500 Renamed LINUX HISTORY section to LINUX NOTES, and relocated
6501 within page.
6502
6503 select_tut.2
6504 mtk
6505 Relocated example program and made its .SH title "EXAMPLE".
6506
6507 sigaltstack.2
6508 mtk
6509 Move code example into its own EXAMPLE section.
6510
6511 sigreturn.2
6512 mtk
6513 s/\.SH WARNING/.SH NOTES/
6514
6515 setuid.2
6516 mtk
6517 s/\.SH "LINUX-SPECIFIC REMARKS"/.SH LINUX NOTES/
6518
6519 shmget.2
6520 mtk
6521 Remove section about effect of fork()/exec()/exit(); shmop.2
6522 contains the same text, and it only needs to be said once.
6523
6524 shmop.2
6525 mtk
6526 Minor rewording under DESCRIPTION.
6527
6528 daemon.3
6529 mtk
6530 Minor wording and formatting changes.
6531
6532 encrypt.3
6533 mtk
6534 Removed statement that glibc unconditionally exposes declarations
6535 of encrypt() and setkey(), since portable applications must
6536 use <unistd.h> and define _XOPEN_SOURCE to obtain the declarations
6537 of setkey() and encrypt(). Adjusted example program accordingly.
6538
6539 mkstemp.3
6540 mtk
6541 Slight rewording.
6542
6543 LDP.7
6544 mtk
6545 Minor wording and formatting changes.
6546
6547 man.7
6548 mtk
6549 Substantial rewrite, revising and extending the discussion
6550 about desired conventions for writing pages.
6551 There will be further updates to this page in the next few
6552 man-pages releases.
6553
6554
6555 ==================== Changes in man-pages-2.53 ====================
6556
6557 Released: 2007-05-30
6558
6559 "A foolish consistency is the hobgoblin of little minds, adored by
6560 little statesmen and philosophers and divines"
6561
6562 Ralph Waldo Emerson (1803-1882)
6563
6564 "But damn it, these man pages are a mess!"
6565
6566
6567 Global changes
6568 --------------
6569
6570 Many many pages
6571 mtk
6572 Reordered sections to be more consistent, in some cases renaming
6573 sections or shifting paragraphs between sections.
6574
6575 man7/*
6576 mtk
6577 In various pages in this section, .SH headings were
6578 converted to .SS.
6579
6580
6581 ==================== Changes in man-pages-2.54 ====================
6582
6583 Released: 2007-06-07
6584
6585 Contributors
6586 ------------
6587
6588 The following people contributed notes, ideas, or patches that have
6589 been incorporated in changes in this release:
6590
6591 Emmanuel Mogenet <emogenet@google.com>
6592 Michael Berg <michaeljberg@gmail.com>
6593
6594 Apologies if I missed anyone!
6595
6596
6597 Global changes
6598 --------------
6599
6600 Various pages
6601 mtk
6602 Where there is an instruction in the SYNOPSIS about linking
6603 or compiling with a certain option, the option is now
6604 marked up in italics (e.g., "\fI-lm\fP").
6605
6606 Various pages
6607 mtk
6608 Added page numbers to page cross references.
6609
6610 A few pages
6611 mtk
6612 s/manpage/man page/, for consistency.
6613
6614 Typographical or grammatical errors have been corrected in several
6615 places.
6616
6617
6618 New pages
6619 ---------
6620
6621 man-pages.7
6622 mtk
6623 A description of the conventions that should be followed
6624 when writing pages for the man-pages package.
6625
6626 Removed pages
6627 -------------
6628
6629 man1/README
6630 mtk
6631 Already deleted most of the man1 pages previously, so
6632 this doesn't need to stay.
6633
6634 LDP.7
6635 mtk
6636 Removed this page since it is out of date, and the proper place
6637 to go for up-to-date information is http://www.tldp.org/
6638
6639 ksoftirq.9
6640 mtk
6641 Reason: this was the only Section 9 page, and it is old
6642 (Linux 2.4). The man9 section never took off as an idea, and
6643 I see little point in keeping a Section 9 with just a single
6644 old page.
6645
6646
6647 Changes to individual pages
6648 ---------------------------
6649
6650 HOWTOHELP
6651 mtk
6652 Moved some material out of here into new man-pages.7.
6653
6654 alloc_hugepages.2
6655 mtk
6656 Minor rewrites, eliminating some duplication, and removing
6657 some outdated text.
6658
6659 epoll_pwait.2
6660 Michael Berg
6661 Fix broken link path;
6662 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=425570
6663
6664 fcntl.2
6665 mtk
6666 Remove misleading text about setting O_ASYNC when calling
6667 open(); one must use fcntl() F_SETFL for this task.
6668
6669 fdatasync.2
6670 mtk
6671 Converted outdated BUGS note about fdatasync() being
6672 equivalent to fsync() on Linux 2.2 into a NOTES note
6673 about this historical behavior.
6674
6675 futex.2
6676 mtk
6677 Small rewording to fix "fails with the error EWOULDBLOCK"
6678 rather than "returns EWOULDBLOCK".
6679 See Red Hat bug 172828.
6680
6681 mprotect.2
6682 mtk, after an observation by Emmanuel Mogenet
6683 A much improved example program.
6684 mtk
6685 Significant rewrites and additions to description.
6686
6687 mremap.2
6688 mtk
6689 Remove text about the nonexistent BSD mremap() -- too
6690 much information, in my opinion.
6691
6692 sched_yield.2
6693 mtk
6694 Added ERRORS section.
6695
6696 set_mempolicy.2
6697 mtk
6698 Moved text for "Versions and Library Support".
6699
6700 set_tid_address.2
6701 mtk
6702 Small rewording in RETURN VALUE section.
6703
6704 sigaction.2
6705 mtk
6706 Add EXAMPLE section with a pointer to example in mprotect.2.
6707
6708 sync_file_range.2
6709 mtk
6710 Fix return type in SYNOPSIS. Add RETURN VALUE section.
6711
6712 atexit.3
6713 mtk
6714 Small rearrangement of text under NOTES.
6715
6716 bindresvport.3
6717 mtk
6718 Rewrite and substantial additional text.
6719
6720 exec.3
6721 mtk
6722 Minor clarifications for text on execlp() and execvp(). Removed
6723 FILES section, since it provides no useful additional info.
6724
6725 fenv.3
6726 mtk
6727 Moved link instructions from NOTES to SYNOPSIS.
6728 Added feenableexcept, fedisableexcept, fegetexcept
6729 to .SH NAME list.
6730
6731 fputwc.3
6732 mtk
6733 Added 'putwc' to .SH NAME list.
6734
6735 gethostbyname.3
6736 mtk
6737 s/int/socklen_t/ for type of gethostbyaddr() 'len' argument,
6738 and add a few more words in NOTES about the type used here.
6739
6740 login.3
6741 mtk
6742 Removed remark from NOTES about linking with -lutil; add
6743 text on that point to SYNOPSIS.
6744
6745 openpty.3
6746 mtk
6747 Removed redundant remark from NOTES about linking with -lutil
6748 since there is text on that point under SYNOPSIS.
6749
6750 sysconf.3
6751 mtk
6752 Added SEE ALSO referring to getconf(1).
6753
6754 unlocked_stdio.3
6755 mtk
6756 Revised .SH NAME section.
6757
6758 ascii.7
6759 mtk
6760 Minor rearrangement of order of text.
6761
6762 capabilities.7
6763 mtk
6764 s/exec()/execve(2)/ in various places.
6765
6766 complex.7
6767 mtk
6768 Changed "atan(1)" to "atan(1.0)" to prevent some versions of
6769 man2html(1) from mistaking that string as a page cross reference.
6770
6771 rtnetlink.7
6772 mtk
6773 Small restructuring to avoid 'cannot adjust line' from man(1).
6774
6775 ldconfig.8
6776 mtk
6777 Removed now very out-of-date sentence about need to link shared
6778 libraries with -lc.
6779
6780 man.7
6781 mtk
6782 Various text was moved out of this page into the new man-pages.7.
6783
6784 mdoc.7
6785 mtk
6786 Added SEE ALSO referring to new man-pages.7.
6787
6788 mdoc.samples.7
6789 mtk
6790 A few changes, hopefully done right, to eliminate some
6791 errors to stderr when rendering with man(1).
6792
6793 rtnetlink.7
6794 mtk
6795 Shorten a line in table so it fits in 80 columns.
6796 Minor rewording under BUGS.
6797
6798 tzselect.8
6799 mtk
6800 Moved EXIT STATUS section.
6801
6802
6803 ==================== Changes in man-pages-2.55 ====================
6804
6805 Released: 2007-06-10
6806
6807 Contributors
6808 ------------
6809
6810 The following people contributed notes, ideas, or patches that have
6811 been incorporated in changes in this release:
6812
6813 Alexander Taboriskiy <alextab@math-solution.com>
6814 Joey Hess <joeyh@debian.org>
6815 John Reiser <jreiser@bitwagon.com>
6816 Julien Cristau <jcristau@debian.org>
6817 Justin Pryzby <justinpryzby@users.sourceforge.net>
6818 Martin (Joey) Schulze <joey@infodrom.org>
6819 Mike Frysinger <vapier@gentoo.org>
6820 Serge van den Boom <svdb@stack.nl>
6821 Ulrich Drepper <drepper@redhat.com>
6822 Xose Vazquez Perez <xose.vazquez@gmail.com>
6823
6824 Apologies if I missed anyone!
6825
6826
6827 Global changes
6828 --------------
6829
6830 clone.2
6831 getdents.2
6832 gettid.2
6833 ioprio_set.2
6834 llseek.2
6835 mmap2.2
6836 modify_ldt.2
6837 mq_getsetattr.2
6838 pivot_root.2
6839 quotactl.2
6840 readdir.2
6841 sysctl.2
6842 syslog.2
6843 tkill.2
6844 mtk, after a note by Mike Frysinger
6845 Updated to reflect the fact that the _syscallN() macros
6846 have gone away,
6847
6848 Several pages
6849 mtk
6850 Change reference to path_resolution.2 to path_resolution.7.
6851
6852 Typographical or grammatical errors have been corrected in several
6853 places.
6854
6855
6856 Moved pages
6857 -----------
6858
6859 path_resolution.2 has been moved to section 7, thus path_resolution.7
6860 mtk
6861 Reason: this is an overview page, not one describing as
6862 a specific system call.
6863
6864
6865 Changes to individual pages
6866 ---------------------------
6867
6868 MAINTAINING
6869 mtk, after a note from Xose Vazquez Perez
6870 Added pointer to Red Hat man-pages bugzilla.
6871 mtk
6872 Added a release philosophy note on separating out big
6873 formatting changes into their own release that contains minimal
6874 content changes.
6875
6876 accept.2
6877 mtk
6878 Add new EXAMPLE section with pointer to example in bind.2.
6879
6880 arch_prctl.2
6881 mtk
6882 Added RETURN VALUE section.
6883
6884 bind.2
6885 mtk
6886 Expand example program, and move it to new EXAMPLE section.
6887 Added text pointing to example in getaddrinfo.3.
6888
6889 cacheflush.2
6890 mtk
6891 Convert NOTES section to CONFORMING TO and note that
6892 this call is Linux-specific.
6893 Other minor rewordings.
6894
6895 connect.2
6896 mtk
6897 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6898
6899 create_module.2
6900 mtk
6901 Add ENOSYS error.
6902
6903 fcntl.2
6904 flock.2
6905 mtk
6906 Small rewrite of SEE ALSO text pointing to Documentation/* in
6907 kernel source.
6908
6909 get_kernel_syms.2
6910 mtk
6911 Added ERRORS heading
6912 Add ENOSYS error.
6913
6914 getdtablesize.2
6915 mtk
6916 Added an ERRORS section.
6917
6918 getsid.2
6919 mtk
6920 Added a RETURN VALUE section.
6921
6922 getpid.2
6923 mtk
6924 Added an ERRORS section (stating that the calls are
6925 always successful).
6926
6927 ioctl_list.2
6928 mtk
6929 Add SEE ALSO reference to ioctl.2.
6930
6931 listen.2
6932 mtk
6933 Add new EXAMPLE section with pointer to example in bind.2.
6934
6935 query_module.2
6936 Martin (Joey) Schulze
6937 Add ENOSYS error.
6938
6939 recv.2
6940 mtk
6941 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6942
6943 sched_get_priority_max.2
6944 sched_rr_get_interval.2
6945 sched_setscheduler.2
6946 sched_yield.2
6947 mtk
6948 Modified .TH line
6949
6950 send.2
6951 mtk
6952 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6953
6954 set_tid_address.2
6955 mtk
6956 Added an ERRORS section (stating that the call is
6957 always successful).
6958
6959 signal.2
6960 mtk, after a note from Alexander Taboriskiy
6961 Strengthen warning against the use of signal().
6962 Added siginterrupt(3) to SEE ALSO list.
6963 mtk
6964 Rewrote various parts; added an ERRORS section.
6965
6966 socket.2
6967 mtk
6968 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6969
6970 stat.2
6971 mtk
6972 Added EXAMPLE program.
6973
6974 syscall.2
6975 mtk
6976 Converted to -man format; some rewrites; added an EXAMPLE.
6977
6978 sysctl.2
6979 mtk
6980 Improved the example program.
6981
6982 getnameinfo.3
6983 mtk
6984 Add text pointing to example in getaddrinfo.3.
6985
6986 getaddrinfo.3
6987 mtk
6988 Add example programs.
6989 Add getnameinfo() to SEE ALSO list.
6990
6991 memmove.3
6992 mtk / Serge van den Boom
6993 Clarify discussion of what happens if 'src' and 'dest' overlap.
6994
6995 regex.3
6996 Justin Pryzby
6997 Add grep(1) to SEE ALSO list.
6998
6999 sigpause.3
7000 mtk after a note from Ulrich Drepper
7001 Clarify discussion of feature test macros that are needed to
7002 expose System V and BSD versions of this function in glibc.
7003
7004 undocumented.3
7005 mtk
7006 Removed some functions that have been documented.
7007
7008 wprintf.2
7009 Martin (Joey) Schulze
7010 Remove wscanf.3 from SEE ALSO list, since that page does not exist.
7011
7012 utmp.5
7013 Joey Hess
7014 Removed outdated note on xdm.
7015 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418009
7016 Martin (Joey) Schulze
7017 Removed outdated note about Debian and libc5.
7018
7019 bootparam.7
7020 Martin (Joey) Schulze
7021 Fix order of commands listed under 'init='.
7022
7023 hier.7
7024 Joey Hess
7025 Add /media, remove /dos.
7026 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418234
7027
7028 inotify.7
7029 mtk
7030 Added text describing what happens when the buffer given to
7031 read(2) is too small to return information about the next event,
7032 and noting the behavior change in 2.6.21.
7033
7034 man-pages.7
7035 mtk
7036 Added text to note that ERRORS list should be in alphabetical order.
7037
7038 mdoc.7
7039 mdoc.samples.7
7040 mtk
7041 Added SEE ALSO reference to groff_mdoc(7).
7042
7043 unix.7
7044 mtk
7045 Added EXAMPLE section with pointer to bind.2 EXAMPLE.
7046
7047 ld.so.8
7048 mtk
7049 Simplify text describing --inhibit-rpath.
7050 mtk, after a note by John Reiser
7051 Describe use of $ORIGIN in rpath.
7052
7053
7054 ==================== Changes in man-pages-2.56 ====================
7055
7056 Released: 2007-06-11
7057
7058 Global changes
7059 --------------
7060
7061 Many pages
7062 mtk
7063 Removed version numbers in .TH lines.
7064 Reason: these were only arbitrarily updated, and so impart no
7065 useful information. Version information goes into a
7066 VERSIONS section nowadays, and the date in the .TH line should
7067 be updated to reflect the date of the last (significant)
7068 change to the page.
7069
7070 Typographical or grammatical errors have been corrected in several
7071 places.
7072
7073
7074 ==================== Changes in man-pages-2.57 ====================
7075
7076 Released: 2007-06-17
7077
7078 Contributors
7079 ------------
7080
7081 The following people contributed notes, ideas, or patches that have
7082 been incorporated in changes in this release:
7083
7084 Samuel Thibault <samuel.thibault@ens-lyon.org>
7085
7086 Apologies if I missed anyone!
7087
7088
7089 Global changes
7090 --------------
7091
7092 Many pages
7093 mtk
7094 Fix section numbers in page cross references.
7095
7096
7097 Changes to individual pages
7098 ---------------------------
7099
7100 access.2
7101 mtk
7102 Minor wording fixes.
7103 Small clarification of description of 'mode'.
7104
7105 bind.2
7106 mtk
7107 Small reworking of EXAMPLE program.
7108
7109 exit_group.2
7110 mtk
7111 Minor wording fixes.
7112
7113 exit.3
7114 mtk
7115 Added more detail on exit handlers.
7116 Minor wording fixes.
7117
7118 ioctl.2
7119 mtk
7120 Remove SEE ALSO reference to nonexistent mt.4.
7121
7122 modify_ldt.2
7123 Samuel Thibault / mtk
7124 In Linux 2.6, the 'modify_ldt_ldt_s' structure was renamed
7125 'user_desc'.
7126 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378668
7127 mtk
7128 Include definition of 'user_desc' structure.
7129 Minor rewordings.
7130
7131 mprotect.2
7132 mtk
7133 Small reworking of EXAMPLE program.
7134
7135 sigaction.2
7136 mtk
7137 Removed reference to nonexistent sigsend(2).
7138
7139 a64l.3
7140 mtk
7141 Remove SEE ALSO reference to nonexistent itoa.3.
7142
7143 dysize.3
7144 mtk
7145 Removed SEE ALSO reference to nonexistent time.3.
7146
7147 encrypt.3
7148 mtk
7149 Removed SEE ALSO reference to nonexistent fcrypt.3.
7150
7151 fmemopen.3
7152 mtk
7153 Small reworking of EXAMPLE program.
7154
7155 fpurge.3
7156 mtk
7157 Remove SEE ALSO reference to nonexistent fclean.3.
7158
7159 getutent.3
7160 mtk
7161 s/ttyname(0)/ttyname(STDIN_FILENO)/ in program example.
7162
7163 vcs.4
7164 mtk
7165 s/exit(1)/exit(EXIT_FAILURE)/
7166
7167 environ.7
7168 mtk
7169 Correct some section numbers in page cross references.
7170
7171 man-pages.7
7172 mtk
7173 Modify requirements for example programs a little.
7174
7175 uri.7
7176 mtk
7177 Wrapped long source lines.
7178
7179
7180 ==================== Changes in man-pages-2.58 ====================
7181
7182 Released: 2007-06-24
7183
7184 Contributors
7185 ------------
7186
7187 The following people contributed notes, ideas, or patches that have
7188 been incorporated in changes in this release:
7189
7190 Marc Boyer <marc.boyer@enseeiht.fr>
7191 Mike Frysinger <vapier@gentoo.org>
7192
7193 Apologies if I missed anyone!
7194
7195
7196 Global changes
7197 --------------
7198
7199 Various pages, as detailed below
7200 mtk
7201 Added or updated VERSIONS sections.
7202
7203 killpg.2
7204 setuid.2
7205 faccessat.2
7206 fork.2
7207 setfsuid.2
7208 kill.2
7209 getsid.2
7210 wait.2
7211 execve.2
7212 getpid.2
7213 setgid.2
7214 seteuid.2
7215 setresuid.2
7216 setfsgid.2
7217 access.2
7218 initgroups.3
7219 euidaccess.3
7220 tcgetpgrp.3
7221 path_resolution.7
7222 capabilities.7
7223 unix.7
7224 mtk
7225 Add SEE ALSO link to new credentials.7.
7226
7227
7228 New pages
7229 ---------
7230
7231 credentials.7
7232 mtk
7233 An overview of Linux process identifiers (PIDs, PPIDs,
7234 PGIDS, SIDs, UIDs, GIDs).
7235
7236
7237 Changes to individual pages
7238 ---------------------------
7239
7240 bind.2
7241 mtk
7242 Added some comments to example program.
7243
7244 getxattr.2
7245 mtk
7246 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7247
7248 listen.2
7249 mtk
7250 Updated discussion of somaxconn limit.
7251
7252 listxattr.2
7253 mtk
7254 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7255
7256 posix_fadvise.2
7257 mtk
7258 VERSIONS: Glibc support has been provided since version 2.2.
7259
7260 readahead.2
7261 mtk
7262 Added VERSIONS section.
7263
7264 remap_file_pages.2
7265 mtk
7266 Updated VERSIONS section with text on glibc support.
7267
7268 removexattr.2
7269 mtk
7270 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7271
7272 semop.2
7273 mtk
7274 Added VERSIONS section with info on semtimedop().
7275
7276 setxattr.2
7277 mtk
7278 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7279
7280 dl_iterate_phdr.3
7281 mtk
7282 VERSIONS: Supported since glibc 2.2.4.
7283
7284 getloadavg.3
7285 mtk
7286 Added VERSIONS section.
7287
7288 posix_openpt.3
7289 mtk
7290 VERSIONS: Supported since glibc 2.2.1.
7291
7292 printf.3
7293 mtk after a suggestion by Mike Frysinger
7294 Add text to the introductory part of DESCRIPTION, about the
7295 'size' argument of snprintf() and vsnprintf().
7296
7297 shm_open.3
7298 mtk
7299 Added VERSIONS section; rewrote info about linking with -lrt.
7300
7301 strcat.3
7302 Marc Boyer
7303 Improve the discussion of strncat().
7304
7305 strcpy.3
7306 Marc Boyer
7307 Improve the discussion of strncpy().
7308
7309 proc.5
7310 mtk
7311 Added discussion of /proc/sys/net/core/somaxconn.
7312
7313
7314 ==================== Changes in man-pages-2.59 ====================
7315
7316 Released: 2007-06-25
7317
7318 Global changes
7319 --------------
7320
7321 Manual pages are now standardized on American spelling. See
7322 http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
7323 for more information on the differences. Formerly, different pages (and
7324 sometimes even a single page!) employed American and British spelling
7325 conventions; best to standardize on one spelling, and American English
7326 is the standard in Computer Science.
7327
7328 Changes to individual pages
7329 ---------------------------
7330
7331 man-pages.7
7332 mtk
7333 Note that man-pages has now standardized on American spelling
7334 conventions.
7335
7336 execve.2
7337 getxattr.2
7338 listxattr.2
7339 removexattr.2
7340 setxattr.2
7341 signal.2
7342 syscall.2
7343 aio_cancel.3
7344 bindresvport.3
7345 stdarg.3
7346 charmap.5
7347 bootparam.7
7348 ipv6.7
7349 man.7
7350 path_resolution.7
7351 uri.7
7352 nscd.8
7353 mtk
7354 Corrected minor spelling/wording mistakes (i.e., changes
7355 independent of fixes for American spelling).
7356
7357
7358 ==================== Changes in man-pages-2.60 ====================
7359
7360 Released: 2007-06-25
7361
7362
7363 Global changes
7364 --------------
7365
7366 Various pages
7367 mtk
7368 Wrapped lines in some files.
7369
7370 Various pages
7371 mtk
7372 Change "e.g. " to "e.g., ", or in some cases, "for example, ".
7373
7374 Various pages
7375 mtk
7376 Change "i.e. " to i.e., ", or in some cases, "that is, ".
7377
7378 Various pages
7379 mtk
7380 Removed AUTHORS section.
7381
7382 Typographical or grammatical errors have been corrected in several
7383 places.
7384
7385
7386 Changes to individual pages
7387 ---------------------------
7388
7389 vfork.2
7390 mtk
7391 s/w.r.t/with respect to/
7392
7393 man-pages.7
7394 mtk
7395 Strengthened warning against use of AUTHORS section.
7396
7397
7398 ==================== Changes in man-pages-2.61 ====================
7399
7400 Released: 2007-07-01
7401
7402
7403 Contributors
7404 ------------
7405
7406 The following people contributed notes, ideas, or patches that have
7407 been incorporated in changes in this release:
7408
7409 Alain Portal <aportal@univ-montp2.fr>
7410 Benno Schulenberg <bensberg@justemail.net>
7411 Florian Ernst <florian_ernst@gmx.net>
7412 Ivana Varekova <varekova@redhat.com>
7413 Jeff Schroeder <jeffschroeder@computer.org>
7414 Joey (Martin) Schulze <joey@infodrom.org>
7415 Justin Pryzby <justinpryzby@users.sourceforge.net>
7416 Loïc Minier <lool@dooz.org>
7417 Michael Gehring <mg@ebfe.org>
7418 Serge van den Boom <svdb@stack.nl>
7419 Stefan Puiu <stefanpuiuro@yahoo.com>
7420 Stepan Kasal <kasal@ucw.cz>
7421
7422 Apologies if I missed anyone!
7423
7424
7425 Global changes
7426 --------------
7427
7428 Various pages
7429 mtk
7430 substitute `\\0' by '\\0'.
7431
7432 Various pages
7433 mtk
7434 s/`/'/ when the thing being quoted is a character.
7435
7436 accept.2
7437 bind.2
7438 connect.2
7439 getsockopt.2
7440 listen.2
7441 socket.2
7442 socketpair.2
7443 mtk after a note by Martin (Joey) Schulze
7444 Add NOTES paragraph noting that <sys/types.h> isn't required by
7445 POSIX.1-2001 or Linux, but was required on some implementations.
7446
7447 accept.2
7448 getsockname.2
7449 recv.2
7450 vm86.2
7451 send.2
7452 getgrouplist.3
7453 memmem.3
7454 nsswitch.conf.5
7455 putenv.3
7456 wprintf.3
7457 mtk
7458 Replace form `...' with \fI...\fP where the enclosed string
7459 is a pathname, type name, or argument name.
7460
7461 A few files
7462 mtk
7463 s/process' /process's/
7464
7465 gets.3
7466 qsort.3
7467 getaddrinfo.3
7468 rpc.3
7469 ungetwc.3
7470 wcsnrtombs.3
7471 capabilities.7
7472 mtk
7473 Add section number to page cross references.
7474
7475 time.1
7476 bind.2
7477 pivot_root.2
7478 sysctl.2
7479 mtk
7480 Reordered .SH sections.
7481
7482 full.4
7483 mouse.4
7484 random.4
7485 sd.4
7486 mtk
7487 Made CONFIG/CONFIGURING heading ==> CONFIGURATION
7488
7489 time.1
7490 console_codes.4
7491 random.4
7492 sk98lin.4
7493 charmap.5
7494 ftpusers.5
7495 bootparam.7
7496 charsets.7
7497 glob.7
7498 mq_overview.7
7499 unicode.7
7500 uri.7
7501 utf-8.7
7502 mtk
7503 Reformatted headings
7504
7505
7506 New pages
7507 ---------
7508
7509 backtrace.3
7510 mtk, with input from Justin Pryzby and Stefan Puiu
7511 Documents backtrace(), backtrace_symbols(), and
7512 backtrace_symbols_fd().
7513
7514
7515 New links
7516 ---------
7517
7518 backtrace_symbols.3
7519 backtrace_symbols_fd.3
7520 mtk
7521 Links to backtrace.3.
7522
7523 __clone.2
7524 Stepan Kasal
7525 Link to clone.2.
7526
7527
7528 Changes to individual pages
7529 ---------------------------
7530
7531 Makefile
7532 Serge van den Boom
7533 Fix setting of 'prefix' macro.
7534
7535 eval.1p
7536 Benno Schulenberg
7537 Fix bad text (concatenated line).
7538
7539 chdir.2
7540 mtk
7541 Fixed description of EACCES error.
7542 Added sentence defining "current working directory".
7543 Other minor wording changes.
7544
7545 cfree.3
7546 mtk
7547 Added SEE ALSO section.
7548
7549 clone.2
7550 mtk
7551 s/clone2/__clone2/.
7552
7553 fdatasync.2
7554 mtk
7555 Minor wording changes.
7556
7557 fork.2
7558 Alain Portal
7559 Fix small wording error.
7560
7561 gethostid.2
7562 Stefan Puiu / mtk
7563 Add NOTES on what happens if gethostid() can't open /etc/hostid.
7564
7565 idle.2
7566 mtk
7567 Made NOTES text into a VERSIONS section, since that's what it
7568 really describes.
7569
7570 ioperm.2
7571 mtk
7572 Minor wording changes.
7573
7574 intro.2
7575 mtk
7576 Rewrite to reflect the fact that the _syscallN
7577 macros are no longer available.
7578
7579 io_cancel.2
7580 mtk
7581 Add "Link with -laio" to SYNOPSIS.
7582
7583 io_destroy.2
7584 mtk
7585 Add "Link with -laio" to SYNOPSIS.
7586
7587 io_getevents.2
7588 mtk
7589 Add "Link with -laio" to SYNOPSIS.
7590
7591 io_setup.2
7592 mtk
7593 Add "Link with -laio" to SYNOPSIS.
7594
7595 io_submit.2
7596 Ivana Varekova
7597 Fix include in SYNOPSIS.
7598 mtk
7599 Add "Link with -laio" to SYNOPSIS.
7600
7601 ipc.2
7602 mtk
7603 Add semtimedop() to SEE ALSO.
7604 Note that some architectures don't have ipc(2); instead
7605 real system calls are provided for shmctl(), semctl(), etc.
7606
7607 killpg.2
7608 mtk
7609 Minor wording changes.
7610
7611 listen.2
7612 mtk
7613 Added <sys/types.h> to SYNOPSIS.
7614
7615 sched_setscheduler.2
7616 mtk
7617 Add NOTES para about permissions required to call
7618 sched_setscheduler() on other systems.
7619
7620 select.2
7621 mtk
7622 Noted that 'timeout' can also be changed if select() is
7623 interrupted by a signal.
7624
7625 setup.2
7626 mtk
7627 Remove reference to _syscall0() macro.
7628
7629 shmop.2
7630 mtk
7631 Changed text for EINVAL error.
7632
7633 socketcall.2
7634 mtk
7635 Add recvmsg() and sendmsg() to SEE ALSO.
7636 Note that some architectures don't have socketcall(2); instead
7637 real system calls are provided for socket(), bind(), etc.
7638
7639 swapon.2
7640 Ivana Varekova / mtk
7641 Update text for EPERM error describing the maximum number of
7642 swap files. (From downstream Fedora patch.)
7643
7644 write.2
7645 mtk
7646 Added details about seekable files and file offset.
7647 Noted that write() may write less than 'count' bytes, and
7648 gave some examples of why this might occur.
7649 Noted what happens if write() is interrupted by a signal.
7650 Minor wording changes.
7651
7652 __setfpucw.3
7653 mtk
7654 Added a CONFORMING TO section; other minor edits.
7655
7656 confstr.3
7657 mtk
7658 Minor rewrites in code example.
7659
7660 ctime.3
7661 Justin Pryzby
7662 Make SEE ALSO refer to timegm.3
7663
7664 daemon.3
7665 mtk
7666 Small wording change.
7667
7668 dl_iterate_phdr.3
7669 Michael Gehring
7670 Comment was missing closing "*/".
7671
7672 dlopen.3
7673 mtk
7674 Formatting changes, and minor rewordings.
7675 mtk, after a note by Serge van den Boom
7676 Add a comment explaining the need for the rather
7677 strange cast of the return value of dlsym().
7678
7679 fpclassify.3
7680 mtk
7681 Add "isinf" to NAME section.
7682
7683 getgrouplist.3
7684 mtk
7685 Minor rewording.
7686
7687 getline.3
7688 mtk
7689 Minor rewording, and note that '*n* is ignored
7690 if '*lineptr' is NULL.
7691
7692 malloc.3
7693 Ivana Varekova / mtk
7694 Update description of MALLOC_CHECK_ to include description
7695 for value 3. (From downstream Fedora patch.)
7696
7697 netlink.3
7698 mtk
7699 Added a CONFORMING TO section; other minor edits.
7700
7701 openpty.3
7702 mtk
7703 Minor changes to SYNOPSIS.
7704
7705 program_invocation_name.3
7706 mtk
7707 Shortened page title to INVOCATION_NAME.
7708
7709 rtnetlink.3
7710 mtk
7711 Added a CONFORMING TO section; other minor edits.
7712
7713 scanf.3
7714 Florian Ernst
7715 Fix duplicated word "the".
7716 (Really fix http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=412467 !)
7717
7718 select_tut.3
7719 mtk
7720 Small wording change.
7721
7722 setnetgrent.3
7723 mtk
7724 Added a CONFORMING TO section.
7725
7726 sigpause.3
7727 mtk
7728 Added a CONFORMING TO section.
7729
7730 strftime.3
7731 Just Pryzby
7732 Small wording fix.
7733 mtk
7734 Note use of "gcc -Wno-format-y2k" to avoid the "`%c' yields only
7735 last 2 digits of year in some locales" warning.
7736
7737 strstr.3
7738 mtk
7739 Add "strcasestr" to NAME section.
7740
7741 syslog.3
7742 mtk
7743 Small wording change.
7744
7745
7746 termios.3
7747 mtk
7748 Reformat SYNOPSIS.
7749 Added a CONFORMING TO section.
7750
7751 timegm.3
7752 mtk
7753 Small wording changes.
7754
7755 ulimit.3
7756 mtk
7757 Remove erroneous text saying that glibc does not provide
7758 <ulimit.h>; it does.
7759
7760 initrd.4
7761 mtk
7762 Various reformattings.
7763
7764 core.5
7765 mtk
7766 Added a sentence noting why core dumps named "core.PID" were useful
7767 with LinuxThreads.
7768
7769 bootparam.7
7770 mtk
7771 Fix capitalization in .SS headings.
7772
7773 epoll.7
7774 mtk
7775 Language clean ups.
7776
7777 feature_test_macros.7
7778 mtk
7779 Added SEE ALSO section.
7780
7781 mq_overview.7
7782 mtk
7783 Reformatted headings; minor rewrites.
7784
7785 sem_overview.7
7786 mtk
7787 Reformatted headings; minor rewrites.
7788
7789 socket.7
7790 Loïc Minier <lool@dooz.org>
7791 Document argument type for SO_REUSEADDR.
7792 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
7793
7794 uri.7
7795 mtk
7796 Wrap long line in SYNOPSIS.
7797
7798 ldconfig.8
7799 mtk
7800 Added SEE ALSO section.
7801
7802
7803 ==================== Changes in man-pages-2.62 ====================
7804
7805 Released: 2007-07-09
7806
7807 This release consists solely of formatting fixes. There are no changes
7808 to content.
7809
7810 Contributors
7811 ------------
7812
7813 The following people contributed notes, ideas, or patches that have
7814 been incorporated in changes in this release:
7815
7816 Stepan Kasal <kasal@ucw.cz>
7817
7818 Apologies if I missed anyone!
7819
7820
7821 Global changes
7822 --------------
7823
7824 Many many pages
7825 mtk
7826 Many many formatting fixes.
7827
7828 man[013]p/*
7829 Stepan Kasal
7830 Add section number to .TH line for POSIX pages in man[013]p.
7831
7832
7833 ==================== Changes in man-pages-2.63 ====================
7834
7835 Released: 2007-07-16
7836
7837
7838 Contributors
7839 ------------
7840
7841 The following people contributed notes, ideas, or patches that have
7842 been incorporated in changes in this release:
7843
7844 Arnd Bergmann <arndb@de.ibm.com>
7845 Eduardo M. Fleury <efleury@br.ibm.com>
7846 Ivana Varekova <varekova@redhat.com>
7847 Justin Pryzby <justinpryzby@users.sourceforge.net>
7848 Marc Boyer <marc.boyer@enseeiht.fr>
7849 Martin (Joey) Schulze <joey@infodrom.org>
7850 Martin Röhricht <martin@roehricht.info>
7851 Patrick Mansfield <patmans@us.ibm.com>
7852 Pierre Habouzit <madcoder@debian.org>
7853 Stepan Kasal <kasal@ucw.cz>
7854
7855 Apologies if I missed anyone!
7856
7857
7858 Global changes
7859 --------------
7860
7861 gettimeofday.2
7862 madvise.2
7863 msgctl.2
7864 select.2
7865 semctl.2
7866 shmctl.2
7867 syslog.2
7868 stat.2
7869 a64l.3
7870 printf.3
7871 termios.3
7872 xdr.3
7873 sd.4
7874 mtk
7875 Minor wording changes.
7876
7877 obsolete.2
7878 syscall.2
7879 unimplemented.2
7880 mtk
7881 Added SEE ALSO reference to syscalls.2.
7882
7883
7884 New pages
7885 ---------
7886
7887 sgetmask.2
7888 mtk
7889 A real man page for sgetmask(2) and ssetmask(2).
7890 (This page replaces a previous link of the same name, which
7891 linked to signal.2.)
7892
7893 spu_create.2
7894 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7895 Document the PowerPC SPU spu_create() system call.
7896 (Originally taken from the kernel source file
7897 Documentation/filesystems/spufs.txt.)
7898
7899 spu_run.2
7900 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7901 Document the PowerPC SPU spu_run() system call.
7902 (Originally taken from the kernel source file
7903 Documentation/filesystems/spufs.txt.)
7904
7905 spufs.7
7906 Arnd Bergmann with additional work by Eduardo M. Fleury and mtk
7907 Document the PowerPC SPU file system.
7908 (Originally taken from the kernel source file
7909 Documentation/filesystems/spufs.txt.)
7910
7911
7912 Removed Pages
7913 -------------
7914
7915 __clone.2
7916 mtk
7917 This file was created by accident in 2.61, as a copy of clone.2.
7918 (it should have been a link to clone.2.)
7919
7920 obsolete.2
7921 mtk
7922 Details on this page are covered in syscalls.2 and in
7923 respective syscall man pages (stat.2, uname.2).
7924
7925 undocumented.2
7926 mtk
7927 This page is very out of date, and in any case difficult
7928 to maintain. Information about undocumented system calls
7929 is maintained in the HOWTOHELP file, and probably in other
7930 places soon.
7931
7932 killpg.3
7933 mtk
7934 This rather incomplete page seems unnecessary since there
7935 is a killpg.2.
7936
7937
7938 New links
7939 ---------
7940
7941 chown32.2
7942 fchown32.2
7943 getegid32.2
7944 geteuid32.2
7945 getgid32.2
7946 getgroups32.2
7947 getresgid32.2
7948 getresuid32.2
7949 getuid32.2
7950 lchown32.2
7951 setfsgid32.2
7952 setfsuid32.2
7953 setgid32.2
7954 setgroups32.2
7955 setregid32.2
7956 setresgid32.2
7957 setresuid32.2
7958 setreuid32.2
7959 setuid32.2
7960 mtk
7961 Added as link to corresponding page without "32".
7962
7963 fcntl64.2
7964 fstat64.2
7965 fstatat64.2
7966 fstatfs64.2
7967 ftruncate64.2
7968 getdents64.2
7969 lstat64.2
7970 pread64.2
7971 pwrite64.2
7972 sendfile64.2
7973 stat64.2
7974 statfs64.2
7975 truncate64.2
7976 mtk
7977 Added as link to corresponding page without "64".
7978
7979 __clone2.2
7980 clone2.2
7981 mtk
7982 Links to clone.2.
7983
7984 ugetrlimit.2
7985 mtk
7986 Link to getrlimit.2.
7987
7988 mq_notify.2
7989 mq_open.2
7990 mq_timedreceive.2
7991 mq_timedsend.2
7992 mq_unlink.2
7993 mtk
7994 Added as links to corresponding section 3 pages.
7995
7996 fadvise64.2
7997 fadvise64_64.2
7998 mtk
7999 Links to posix_fadvise.2.
8000
8001 rt_sigaction.2
8002 rt_sigpending.2
8003 rt_sigprocmask.2
8004 rt_sigtimedwait.2
8005 mtk
8006 Added as link to corresponding page without "rt_" prefix.
8007
8008 rt_sigqueueinfo.2
8009 mtk
8010 Link to sigqueue.2.
8011
8012 madvise1.2
8013 tuxcall.2
8014 vserver.2
8015 mtk / Ivana Varekova
8016 Link to unimplemented.2.
8017
8018
8019 Changes to individual pages
8020 ---------------------------
8021
8022 access.2
8023 mtk
8024 Fairly substantial rewrites of various parts,
8025 and a few additions.
8026
8027 chmod.2
8028 mtk
8029 Update SYNOPSIS to reflect the fact that fchmod(2) needs
8030 either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8031
8032 chown.2
8033 mtk
8034 Update SYNOPSIS to reflect the fact that fchmod(2) and lchown(2)
8035 need either "#define _XOPEN_SOURCE 500" or "#define _BSD_SOURCE".
8036 Added an example program.
8037
8038 killpg.2
8039 mtk
8040 Note that killpg() is actually a library function on Linux.
8041
8042 mmap.2
8043 mtk
8044 Added note that glibc mmap() wrapper nowadays invokes mmap2().
8045
8046 mmap2.2
8047 Ivana Varekova / mtk
8048 On most platforms the unit for 'offset' is 4096 bytes, not
8049 the system page size.
8050 mtk
8051 Rewrote NOTES to note that glibc mmap() wrapper nowadays
8052 invokes this system call.
8053 mtk
8054 Added an EXAMPLE program.
8055
8056 oldfstat.2
8057 oldlstat.2
8058 oldstat.2
8059 mtk
8060 Changed link to point to stat.2 (instead of obsolete.2).
8061
8062 olduname.2
8063 oldolduname.2
8064 mtk
8065 Changed link to point to uname.2 (instead of obsolete.2).
8066
8067 sched_setaffinity.2
8068 Martin Röhricht
8069 Added _GNU_SOURCE to SYNOPSIS.
8070
8071 semctl.2
8072 mtk
8073 Remove reference discussion of ipc(2), since none of the
8074 other System V IPC pages mention ipc(2).
8075
8076 semop.2
8077 mtk
8078 Add an example code segment.
8079
8080 shmctl.2
8081 mtk
8082 Add svipc(7) to SEE ALSO list.
8083
8084 sigaction.2
8085 mtk
8086 Reformatted tables as lists; other minor reformattings and
8087 wording changes.
8088
8089 sigqueue.2
8090 mtk
8091 Added info on rt_sigqueueinfo(2).
8092
8093 sigwaitinfo.2
8094 mtk
8095 Noted that sigwaitinfo() is a library function implemented on
8096 top of sigtimedwait().
8097
8098 ssetmask.2
8099 mtk
8100 Make this link point to new sgetmask.2 instead of signal.2.
8101
8102 stat.2
8103 mtk
8104 Add notes on the different system call interfaces that
8105 have appeared over time.
8106
8107 syscalls.2
8108 mtk
8109 A fairly substantial rewrite of this page,
8110 bringing it up to date with the current
8111 kernel version, and listing all system calls
8112 in tabular form.
8113
8114 uname.2
8115 mtk
8116 Add notes on the different system call interfaces that
8117 have appeared over time.
8118
8119 unimplemented.2
8120 mtk
8121 Add vserver, madvise1 to NAME line.
8122 Removed SEE ALSO reference to obsolete.2.
8123 Ivana Varekova
8124 Add tuxcall to NAME line.
8125
8126 mktemp.3
8127 Patrick Mansfield
8128 Fix description of return value.
8129
8130 strcat.3
8131 Marc Boyer
8132 Minor fix to example program.
8133
8134 undocumented.3
8135 mtk
8136 Add section numbers to function names; remove some functions
8137 since they are documented.
8138
8139 proc.5
8140 mtk
8141 Update/correct text on /proc/malloc.
8142 mtk, after a note by Pierre Habouzit, and a few comments by Justin Pryzby
8143 Update description of /proc/PID/stat to match 2.6.21.
8144 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417933
8145
8146 inotify.7
8147 mtk
8148 IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.
8149
8150 signal.7
8151 Stepan Kasal / mtk
8152 Note SIGRTMIN value depends on glibc.
8153 mtk
8154 Various rewrites and additions to the text in real-time signals.
8155 Add SEE ALSO reference to sgetmask.2.
8156
8157 svipc.7
8158 mtk
8159 Add ipc(2) to SEE ALSO.
8160
8161
8162 ==================== Changes in man-pages-2.64 ====================
8163
8164 Released: 2007-07-27
8165
8166
8167 Contributors
8168 ------------
8169
8170 The following people contributed notes, ideas, or patches that have
8171 been incorporated in changes in this release:
8172
8173 Aleksandr Koltsoff <czr@iki.fi>
8174 Andries Brouwer <Andries.Brouwer@cwi.nl>
8175 Justin Pryzby <justinpryzby@users.sourceforge.net>
8176
8177 Apologies if I missed anyone!
8178
8179
8180 Global changes
8181 --------------
8182
8183 INFINITY.3
8184 _exit.2
8185 a64l.3
8186 abs.3
8187 acct.2
8188 acosh.3
8189 addseverity.3
8190 adjtime.3
8191 asinh.3
8192 atanh.3
8193 atoi.3
8194 brk.2
8195 cbrt.3
8196 cfree.3
8197 chdir.2
8198 chmod.2
8199 chown.2
8200 clearenv.3
8201 clock_getres.3
8202 clone.2
8203 confstr.3
8204 copysign.3
8205 ctermid.3
8206 ctime.3
8207 daemon.3
8208 dirfd.3
8209 div.3
8210 drand48.3
8211 drand48_r.3
8212 dysize.3
8213 ecvt.3
8214 ecvt_r.3
8215 erf.3
8216 euidaccess.3
8217 exp2.3
8218 expm1.3
8219 fdatasync.2
8220 ferror.3
8221 fexecve.3
8222 fgetgrent.3
8223 fgetpwent.3
8224 finite.3
8225 flockfile.3
8226 fopen.3
8227 fpclassify.3
8228 fsync.2
8229 futimes.3
8230 fwide.3
8231 gamma.3
8232 gcvt.3
8233 getcwd.3
8234 getdate.3
8235 getdirentries.3
8236 getdomainname.2
8237 getdtablesize.2
8238 getgrent.3
8239 getgrent_r.3
8240 getgrouplist.3
8241 getgroups.2
8242 gethostbyname.3
8243 gethostid.2
8244 gethostname.2
8245 getlogin.3
8246 getmntent.3
8247 getpagesize.2
8248 getpw.3
8249 getpwent.3
8250 getpwent_r.3
8251 getpwnam.3
8252 getsid.2
8253 getspnam.3
8254 gettimeofday.2
8255 getumask.3
8256 getusershell.3
8257 gsignal.3
8258 hypot.3
8259 inet.3
8260 initgroups.3
8261 insque.3
8262 isalpha.3
8263 iswblank.3
8264 j0.3
8265 kill.2
8266 killpg.2
8267 lgamma.3
8268 lockf.3
8269 log1p.3
8270 log2.3
8271 logb.3
8272 longjmp.3
8273 lrint.3
8274 lround.3
8275 madvise.2
8276 mbsnrtowcs.3
8277 memfrob.3
8278 mincore.2
8279 mkdtemp.3
8280 mknod.2
8281 mkstemp.3
8282 mktemp.3
8283 nan.3
8284 nanosleep.2
8285 nextafter.3
8286 nice.2
8287 on_exit.3
8288 perror.3
8289 posix_memalign.3
8290 posix_openpt.3
8291 printf.3
8292 profil.3
8293 psignal.3
8294 putenv.3
8295 putpwent.3
8296 qecvt.3
8297 rand.3
8298 random.3
8299 rcmd.3
8300 readahead.2
8301 readlink.2
8302 realpath.3
8303 remainder.3
8304 remquo.3
8305 rexec.3
8306 rint.3
8307 round.3
8308 rpmatch.3
8309 scalb.3
8310 scandir.3
8311 scanf.3
8312 seekdir.3
8313 select.2
8314 sem_wait.3
8315 semop.2
8316 setbuf.3
8317 setenv.3
8318 seteuid.2
8319 setjmp.3
8320 setnetgrent.3
8321 setpgid.2
8322 setresuid.2
8323 setreuid.2
8324 sigaltstack.2
8325 siginterrupt.3
8326 significand.3
8327 sigqueue.2
8328 sigvec.3
8329 sigwaitinfo.2
8330 sockatmark.3
8331 stat.2
8332 stime.2
8333 strdup.3
8334 strerror.3
8335 strsep.3
8336 strtod.3
8337 strtok.3
8338 strtol.3
8339 strtoul.3
8340 symlink.2
8341 sync.2
8342 syscall.2
8343 syslog.3
8344 tcgetsid.3
8345 telldir.3
8346 tempnam.3
8347 termios.3
8348 tgamma.3
8349 timegm.3
8350 toascii.3
8351 trunc.3
8352 truncate.2
8353 ttyslot.3
8354 tzset.3
8355 ualarm.3
8356 unlocked_stdio.3
8357 unshare.2
8358 usleep.3
8359 vfork.2
8360 vhangup.2
8361 wait.2
8362 wait4.2
8363 wcscasecmp.3
8364 wcsncasecmp.3
8365 wcsnlen.3
8366 wcsnrtombs.3
8367 wcswidth.3
8368 wordexp.3
8369 wprintf.3
8370 mtk
8371 Added/updated feature test macro requirements for
8372 glibc; see feature_test_macros.7 for details.
8373
8374 Changes to individual pages
8375 ---------------------------
8376
8377 mq_notify.2
8378 mq_open.2
8379 mq_timedreceive.2
8380 mq_timedsend.2
8381 mq_unlink.2
8382 mtk
8383 Fix broken link
8384
8385 setpgid.2
8386 mtk
8387 Fairly substantial changes and corrections, including adding
8388 coverage of all of the interfaces that get/set PGIDs.
8389
8390 syscalls.2
8391 mtk / aeb
8392 Various rewordings; clear up some imprecisions.
8393
8394 lgamma.3
8395 mtk
8396 Added 'signgam' to SYNOPSIS and NAME line.
8397
8398 strerror.3
8399 mtk
8400 Note that the XPG version is provided since glibc 2.3.4.
8401 The page formerly said that the GNU-specific version
8402 is provided by default. That certainly isn't true
8403 nowadays, since _POSIX_C_SOURCE is set to 200112L by
8404 default, so that the XSI-compliant version is supplied
8405 by default.
8406
8407 man-pages.7
8408 mtk
8409 Added note pointing to feature_test_macros.7 for a description
8410 of how feature test macro requirements should be specified in
8411 manual pages. Various other minor fixes and changes.
8412
8413 feature_test_macros.7
8414 mtk
8415 Added note about how feature test macros are specified
8416 in manual pages.
8417 Many other corrections, improvements, additions, and
8418 details about differences across glibc versions.
8419
8420
8421 ==================== Changes in man-pages-2.65 ====================
8422
8423 Released: 2007-09-17
8424
8425
8426 Contributors
8427 ------------
8428
8429 The following people contributed notes, ideas, or patches that have
8430 been incorporated in changes in this release:
8431
8432 Aleksandr Koltsoff <czr@iki.fi>
8433 Andi Kleen <ak@suse.de>
8434 Anton Blanchard <anton@samba.org>
8435 Ari Entlich <lmage11@twcny.rr.com>
8436 Carsten Emde <Carsten.Emde@osadl.org>
8437 François Diakhate <diakhate@enseirb.fr>
8438 Geoff Clare <gclare@gclare.org.uk>
8439 Jon Burgess <jburgess777@googlemail.com>
8440 Julien Cristau <jcristau@debian.org>
8441 Lee Schermerhorn <Lee.Schermerhorn@hp.com>
8442 Mats Wichmann <mats.d.wichmann@intel.com>
8443 Maxime Bizon <mbizon@freebox.fr>
8444 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8445 Michael Prokop <mika@grml.org>
8446 Mike Frysinger <vapier@gentoo.org>
8447 Nicolas François <nicolas.francois@centraliens.net>
8448 Nicolas George <nicolas.george@ens.fr>
8449 Paul Brook <paul@nowt.org>
8450 Reuben Thomas <rrt@sc3d.org>
8451 Sam Varshavchik <mrsam@courier-mta.com>
8452 Samuel Thibault <samuel.thibault@ens-lyon.org>
8453 Thomas Huriaux <thomas.huriaux@gmail.com>
8454 Tolga Dalman <tdalman@project-psi.org>
8455 Ulrich Drepper <drepper@redhat.com>
8456 Vincent Lefevre <vincent@vinc17.org>
8457
8458 Apologies if I missed anyone!
8459
8460
8461 Global changes
8462 --------------
8463
8464 Typographical or grammatical errors have been corrected in several
8465 places.
8466
8467 Various pages
8468 mtk
8469 Use 'glibc' consistently to refer to GNU C library.
8470
8471 Various pages
8472 mtk
8473 Order errors under ERRORS alphabetically.
8474
8475 Various pages
8476 Nicolas François
8477 Spelling and formatting fixes, as per
8478 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
8479
8480 intro.2
8481 select.2
8482 fmtmsg.3
8483 getgrent_r.3
8484 envz_add.3
8485 rtime.3
8486 strptime.3
8487 wordexp.3
8488 Maxime Vaudequin
8489 Add "#include <stdlib.h>" (to declare exit(3)) to example program.
8490
8491
8492 New pages
8493 ---------
8494
8495 timeradd.3
8496 mtk
8497 Description of timeradd(), timersub(), timerclear(),
8498 timerisset(), timercmp() macros for operating on
8499 struct timeval.
8500
8501
8502 Removed pages
8503 -------------
8504
8505 fdatasync.2
8506 mtk
8507 Somehow, over time, material on fdatasync(2) crept into
8508 fsync.2, and fdatasync also got added to the NAME section
8509 of fsync.2. All of the material in fdatasync.2 that was
8510 not already in fsync.2 has now been moved there, and
8511 the former page has been removed.
8512 In place of the content there, is now a link to fsync.2.
8513
8514
8515 New links
8516 ---------
8517
8518 clock_getres.2
8519 clock_gettime.2
8520 clock_settime.2
8521 mtk
8522 Link to man3/clock_getres.3.
8523
8524 fdatasync.2
8525 mtk
8526 Link to fsync.2.
8527
8528 fdopendir.3
8529 mtk
8530 Link to opendir.3.
8531
8532 gethostbyaddr_r.3
8533 Mats Wichmann
8534 Link to gethostbyaddr.3.
8535
8536 timerclear.3
8537 timercmp.3
8538 timerisset.3
8539 timersub.3
8540 mtk
8541 Links to new timeradd.3.
8542
8543
8544 Changes to individual pages
8545 ---------------------------
8546
8547 Makefile
8548 Mike Frysinger
8549 Make the install target of man-pages respect the standard
8550 "DESTDIR" variable as well as check the exit status of the
8551 install command so errors aren't ignored.
8552
8553 get_mempolicy.2
8554 Lee Schermerhorn
8555 changed the "policy" parameter to "mode" through out the
8556 descriptions in an attempt to promote the concept that the memory
8557 policy is a tuple consisting of a mode and optional set of nodes.
8558
8559 added requirement to link '-lnuma' to synopsis
8560
8561 rewrite portions of description for clarification.
8562
8563 added all errors currently returned by sys call.
8564
8565 removed cautionary note that use of MPOL_F_NODE|MPOL_F_ADDR
8566 is not supported. This is no longer true.
8567
8568 added mmap(2) to SEE ALSO list.
8569
8570 getitimer.2
8571 mtk
8572 Since kernel 2.6.22, Linux setitimer() now conforms to POSIX.1,
8573 giving an EINVAL error for a non-canonical tv_usec value.
8574
8575 gettimeofday.2
8576 mtk
8577 Replace discussion of timer* macros with a pointer
8578 to new page timeradd.3.
8579
8580 ioctl_list.2
8581 Nicolas George
8582 Fixed argument type for BLKGETSIZE.
8583
8584 mbind.2
8585 Lee Schermerhorn
8586
8587 changed the "policy" parameter to "mode" throughout the
8588 descriptions in an attempt to promote the concept that the memory
8589 policy is a tuple consisting of a mode and optional set of nodes.
8590
8591 rewrite portions of description for clarification.
8592
8593 clarify interaction of policy with mmap()'d files and shared
8594 memory regions, including SHM_HUGE regions.
8595
8596 defined how "empty set of nodes" specified and what this
8597 means for MPOL_PREFERRED.
8598
8599 mention what happens if local/target node contains no
8600 free memory.
8601
8602 clarify semantics of multiple nodes to BIND policy.
8603 Note: subject to change. We'll fix the man pages when/if
8604 this happens.
8605
8606 added all errors currently returned by sys call.
8607
8608 added mmap(2), shmget(2), shmat(2) to SEE ALSO list.
8609
8610 mmap.2
8611 mprotect.2
8612 François Diakhate
8613 Add text noting that PROT_WRITE may (and on x86 does)
8614 imply PROT_READ.
8615 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
8616
8617 nfsservctl.2
8618 Aleksandr Koltsoff
8619 Fix prototype.
8620
8621 oldfstat.2
8622 oldlstat.2
8623 oldstat.2
8624 mtk
8625 Fix broken link
8626
8627 prctl.2
8628 mtk
8629 Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
8630
8631 readahead.2
8632 mtk
8633 Removed SEE ALSO reference to nonexistent fadvise.2.
8634
8635 reboot.2
8636 mtk
8637 Place SYNOPSIS comments inside C comments (/* ... */).
8638
8639 sched_setaffinity.2
8640 Samuel Thibault
8641 Note what thread is affected if 'pid' is specified
8642 as 0, or as the value returned by getpid().
8643
8644 sched_setscheduler.2
8645 Carsten Emde
8646 Add text on real-time features of mainline Linux kernel.
8647
8648 select_tut.2
8649 mtk
8650 sync SYNOPSIS with select.2
8651
8652 set_mempolicy.2
8653 Lee Schermerhorn
8654
8655 changed the "policy" parameter to "mode" throughout the
8656 descriptions in an attempt to promote the concept that the memory
8657 policy is a tuple consisting of a mode and optional set of nodes.
8658
8659 added requirement to link '-lnuma' to synopsis
8660
8661 rewrite portions of description for clarification.
8662
8663 clarify interaction of policy with mmap()'d files.
8664
8665 defined how "empty set of nodes" specified and what this
8666 means for MPOL_PREFERRED.
8667
8668 mention what happens if local/target node contains no
8669 free memory.
8670
8671 clarify semantics of multiple nodes to BIND policy.
8672 Note: subject to change. We'll fix the man pages when/if
8673 this happens.
8674
8675 added all errors currently returned by sys call.
8676
8677 added mmap(2) to SEE ALSO list.
8678
8679 sigaction.2
8680 mtk
8681 s/si_sign/si_errno/ in statement about which field is unused.
8682 Ari Entlich
8683 s/SIGILL/SIGCHLD/ for paragraph describing SIGCHLD.
8684
8685 stat.2
8686 mtk
8687 Improve text describing underlying system calls.
8688
8689 swapon.2
8690 Michael Prokop
8691 EINVAL also occurs if target path is on tmpfs or similar.
8692 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435885
8693
8694 sync.2
8695 mtk
8696 Incorporated material from now deleted fdatasync.2.
8697
8698 syscall.2
8699 mtk
8700 Small fix in example program.
8701
8702 uname.2
8703 mtk
8704 Improve text describing underlying system calls.
8705
8706 utime.2
8707 Vincent Lefevre / mtk
8708 Clarify utimes() behaviour when 'times' is NULL.
8709 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=431480
8710 mtk
8711 Other minor clarifications of description of utimes().
8712
8713 copysign.3
8714 Vincent Lefevre
8715 s/sign/sign bit/ to remove ambiguity in description.
8716 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435415
8717
8718 euidaccess.3
8719 mtk
8720 Changed NOTES to VERSIONS.
8721
8722 ffsl.3
8723 mtk
8724 Add ffsl and ffsll to NAME line.
8725
8726 fts.3
8727 mtk
8728 Removed statement that fts functions are expected to appear
8729 soon in POSIX; it's years old and has not yet come to pass.
8730
8731 ftw.3
8732 mtk / Geoff Clare
8733 Fixes/improvements for example program.
8734
8735 getdate.3
8736 mtk
8737 Add getdate_r to NAME section.
8738
8739 getaddrinfo.3
8740 mtk / Geoff Clare
8741 Fixes/improvements for example program.
8742
8743 gethostbyaddr.3
8744 Mats Wichmann
8745 Add documentation for gethostbyaddr_r().
8746 Plus a few other small fixes.
8747
8748 gethostbyname.3
8749 mtk
8750 Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
8751 gethostent_r to NAME line.
8752
8753 getmntent.3
8754 mtk
8755 Fix misnamed function references.
8756
8757 getopt.3
8758 Jon Burgess
8759 Fix small error in example program.
8760
8761 getrpcent.3
8762 mtk
8763 Add setrpcent and endrpcent to NAME line.
8764
8765 gsignal.3
8766 Aleksandr Koltsoff
8767 Fix gsignal() prototype.
8768
8769 hsearch.3
8770 mtk
8771 Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
8772
8773 inet.3
8774 Maxime Bizon
8775 Correct definition of "struct in_addr".
8776
8777 isatty.3
8778 mtk
8779 Minor wording fix.
8780
8781 isgreater.3
8782 mtk
8783 Add islessequal to NAME line.
8784
8785 lgamma.3
8786 Vincent Lefevre
8787 Fix CONFORMING TO section.
8788 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417592
8789
8790 log1p.3
8791 mtk
8792 Add log1pf and log1pl to NAME line.
8793
8794 longjmp.3
8795 Paul Brook / mtk
8796 After a call to longjmp(), the values of modified, non-volatile
8797 variables in the function that called setjmp() are unspecified.
8798
8799 makecontext.3
8800 Aleksandr Koltsoff
8801 Fix makecontext() prototype.
8802
8803 malloc.3
8804 mtk / Tolga Dalman
8805 Explain what happens for malloc(0), or calloc() where one of the
8806 arguments is 0.
8807 mtk
8808 Added notes on malloc()'s use of sbrk() and mmap().
8809 mtk
8810 Add mmap(2), alloca(3) to SEE ALSO.
8811
8812 mq_close.3
8813 mq_getattr.3
8814 mq_notify.3
8815 mq_open.3
8816 mq_receive.3
8817 mq_send.3
8818 mq_unlink.3
8819 mtk
8820 Add "Link with -lrt." to SYNOPSIS.
8821
8822 opendir.3
8823 Ulrich Drepper; some edits and additional text by mtk
8824 Document fdopendir().
8825
8826 readdir.3
8827 mtk, after a note by Andi Kleen
8828 Document DT_* constants for d_type.
8829 Ulrich Drepper / mtk
8830 Rework discussion of non-standard structure fields.
8831
8832 sem_wait.3
8833 mtk
8834 Minor improvements to example program.
8835
8836 syslog.3
8837 mtk
8838 Add vsyslog to NAME section.
8839
8840 termios.3
8841 Nicolas François
8842 Fix XCASE feature test macro description.
8843
8844 wcsspn.3
8845 Aleksandr Koltsoff
8846 Add return type to prototype.
8847
8848 proc.5
8849 mtk
8850 Improve description of num_threads field under /proc/PID/stat.
8851 Maxime Vaudequin
8852 Fix path error (s%proc/sys%proc/sys/kernel%) in mentions of
8853 /proc/sys/ostype, /proc/sys/osrelease and proc/sys/version.
8854 Maxime Vaudequin
8855 I noticed things to correct and to clarify in subsection
8856 "/proc/filesystems" of proc.5:
8857 - clarify filesystems listing: not only FS compiled
8858 into the kernel, also FS kernel modules currently loaded
8859 - add a reference to fs(5)
8860 - add an explanation for FS marked with "nodev"
8861 - s/mount(1)/mount(8)/, also corrected in section "SEE ALSO"
8862 - clarify usage by mount: the current wording may lead to
8863 think /proc/filesystems is always used by mount when no FS
8864 is specified. So, usage of "may" which IMHO is more
8865 appropriate + additional explanations
8866 In mount(8) we can see:
8867
8868 If no -t option is given, or if the auto type is
8869 specified, mount will try to guess the desired type.
8870 If mount was compiled with the blkid library, the
8871 guessing is done by this library. Otherwise, mount
8872 guesses itself by probing the superblock; if that
8873 does not turn up anything that looks familiar,
8874 mount will try to read the file /etc/filesystems,
8875 or, if that does not exist, /proc/filesystems.
8876 All of the filesystem types listed there will be
8877 tried, except for those that are labeled "nodev"
8878 (e.g., devpts, proc and nfs). If /etc/filesystems
8879 ends in a line with a single * only, mount will
8880 read /proc/filesystems afterwards.
8881 Samuel Thibault
8882 Since linux 2.6.11, /proc/stat has an eighth value for cpu
8883 lines: stolen time, which is the time spent in other operating
8884 systems when running in a virtualized environment.
8885
8886 arp.7
8887 Updated BUGS text referring to jiffies; refer to time.7 instead.
8888
8889 credentials.7
8890 mtk
8891 Add words to note that file system ID is Linux specific.
8892
8893 hier.7
8894 Maxime Vaudequin
8895 This is some corrections for hier.7:
8896 - missing period for /media and /mnt
8897 - /mnt description is not totally correct, it is true for some
8898 distributions but in others /mnt is used as a temporary FS
8899 mount point, as it is specified by FHS:
8900 http://www.pathname.com/fhs/pub/fhs-2.3.html#MNTMOUNTPOINTFORATEMPORARILYMOUNT
8901 - s/X-Windows/X-Window/ (3 occurrences)
8902 - section "SEE ALSO": s/mount(1)/mount(8)/
8903
8904 man-pages.7
8905 man.7
8906 mdoc.7
8907 mdoc.samples.7
8908 mtk / Nicolas François
8909 Nowadays tmac.XXX are called XXX.tmac.
8910
8911 pthreads.7
8912 mtk
8913 Update text about modern threading implementations
8914 (NPTL vs LinuxThreads).
8915
8916 socket.7
8917 mtk, after a note by Andi Kleen
8918 Clarify that SO_SNDTIMEO and SO_RCVTIMEO only have effect for
8919 socket I/O calls; not for multiplexing system calls like
8920 select() and poll().
8921
8922 time.7
8923 mtk
8924 Add SEE ALSO reference to new timeradd.3.
8925
8926
8927 ==================== Changes in man-pages-2.66 ====================
8928
8929 Released: 2007-10-01
8930
8931
8932 Contributors
8933 ------------
8934
8935 The following people contributed notes, ideas, or patches that have
8936 been incorporated in changes in this release:
8937
8938 Amit K. Arora <aarora@linux.vnet.ibm.com>
8939 David Chinner <dgc@sgi.com>
8940 Fredrik Noring <noring@nocrew.org>
8941 Mats Wichmann <mats.d.wichmann@intel.com>
8942 Maxime Vaudequin <maxime.vaudequin@gmail.com>
8943 Ollie Wild <aaw@google.com>
8944 Ulrich Drepper <drepper@redhat.com>
8945
8946 Apologies if I missed anyone!
8947
8948
8949 Global changes
8950 --------------
8951
8952 Typographical or grammatical errors have been corrected in several
8953 places.
8954
8955
8956 New pages
8957 ---------
8958
8959 fallocate.2
8960 David Chinner, with some input from Amit Amora and mtk
8961 Describes the fallocate() system call, new in 2.6.23.
8962
8963
8964 Changes to individual pages
8965 ---------------------------
8966
8967 close.2
8968 Fredrik Noring
8969 Add text cautioning about use of close() in
8970 multithreaded programs.
8971
8972 execve.2
8973 Ollie Wild / mtk
8974 Add text describing limit on total size of argv + envp,
8975 and changes that occurred with 2.6.23.
8976 mtk
8977 Add getopt(3) to SEE ALSO list.
8978
8979 open.2
8980 mtk, Acked by Ulrich Drepper
8981 Added description of O_CLOEXEC (new in 2.6.23) + other
8982 minor fixes for O_DIRECT.
8983
8984 recv.2
8985 mtk
8986 Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
8987
8988 sysctl.2
8989 mtk
8990 Strengthened the warning against using this system call
8991 and note that it may disappear in a future kernel version.
8992
8993 rpc.3
8994 Mats Wichmann
8995 Fix type definition for 'protocol' in prototypes of pmap_set()
8996 and pmap_getport().
8997
8998
8999 ==================== Changes in man-pages-2.67 ====================
9000
9001 Released: 2007-10-08
9002
9003
9004 Contributors
9005 ------------
9006
9007 The following people contributed notes, ideas, or patches that have
9008 been incorporated in changes in this release:
9009
9010 Andi Kleen <andi@firstfloor.org>
9011 Andrew Josey <a.josey@opengroup.org>
9012 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9013
9014 Apologies if I missed anyone!
9015
9016
9017 Global changes
9018 --------------
9019
9020 *.1p
9021 *.3p
9022 mtk, after a note by Andi Kleen and consultation with Andrew Josey.
9023 Add a PROLOG section:
9024 This manual page is part of the POSIX Programmer's Manual.
9025 The Linux implementation of this interface may differ
9026 (consult the corresponding Linux manual page for details
9027 of Linux behavior), or the interface may not be implemented
9028 on Linux.
9029
9030 *.0p
9031 *.1p
9032 *.3p
9033 mtk
9034 Some formatting fixes, mostly to get rid of unwanted
9035 spaces before "," in formatted output.
9036
9037 *
9038 */*
9039 mtk
9040 Change all occurrences of my email address in man-pages source
9041 to my new gmail address.
9042
9043 Many many pages
9044 Maxime Vaudequin
9045 I noticed useless use of macros with alternating formatting
9046 (".IR" instead ".I" which suffices, ".BR" instead ".B", etc.)
9047 because there is only one element. For example in ldconfig.8:
9048
9049 -.BR /sbin/ldconfig
9050 +.B /sbin/ldconfig
9051
9052 This is not very important, it only makes the sources more tidy.
9053 To find these I used:
9054
9055 egrep '^\.(B[RI]|R[IB]|I[RB]) ([^ ]+|\"[^\"]\+\")$'
9056
9057 And if you want to make these changes, you can use:
9058
9059 sed 's/^\(\.[BRI]\)[BRI]\( \([^ ]\+\|\"[^\"]\+\"\)\)$/\1\2/g'
9060
9061
9062 ==================== Changes in man-pages-2.68 ====================
9063
9064 Released: 2007-11-19
9065
9066
9067 Contributors
9068 ------------
9069
9070 The following people contributed notes, ideas, or patches that have
9071 been incorporated in changes in this release:
9072
9073 A. Costa <agcosta@gis.net>
9074 Andrew McDonald <andrew@mcdonald.org.uk>
9075 Geoff Clare <gclare@gclare.org.uk>
9076 Heikki Orsila <shd@modeemi.cs.tut.fi>
9077 Hyokyong Kim <hyokyong@ppj.kr>
9078 Ivana Varekova <varekova@redhat.com>
9079 Justin Pryzby <jpryzby+d@quoininc.com>
9080 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9081 Mike Frysinger <vapier@gentoo.org>
9082 Nicolas François <nicolas.francois@centraliens.net>
9083 Pádraig Brady <P@draigBrady.com>
9084 Sam Varshavchik <mrsam@courier-mta.com>
9085 Timo Juhani Lindfors <timo.lindfors@iki.fi>
9086 Ulrich Drepper <drepper@redhat.com>
9087
9088 Apologies if I missed anyone!
9089
9090
9091 Global changes
9092 --------------
9093
9094 faccessat.2
9095 fchmodat.2
9096 fchownat.2
9097 fstatat.2
9098 futimesat.2
9099 linkat.2
9100 mkdirat.2
9101 mknodat.2
9102 readlinkat.2
9103 renameat.2
9104 symlinkat.2
9105 mkfifoat.3
9106 mtk, after http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445436
9107 by Timo Juhani Lindfors
9108 Added <fcntl.h> to SYNOPSIS.
9109
9110 Typographical or grammatical errors have been corrected in several places.
9111
9112
9113 New pages
9114 ---------
9115
9116 _syscall.2
9117 mtk
9118 Created as a new page, by taking the content specific to
9119 the _syscall() macros from intro(2).
9120
9121
9122 Changes to individual pages
9123 ---------------------------
9124
9125 README
9126 mtk
9127 Brought up to date.
9128
9129 man-pages-*-Announce
9130 mtk
9131 Brought the info in here up to date.
9132
9133 intro.1
9134 mtk
9135 Added intro paragraph about section, plus a paragraph
9136 about exit status values.
9137 Move "user intro" text to NOTES.
9138
9139 get_mempolicy.2
9140 mtk
9141 Reorder ERRORS sections alphabetically
9142
9143 intro.2
9144 mtk
9145 Pretty much a complete rewrite, covering some additional topics.
9146 Moved _syscallN() material to new _syscall(2) page.
9147
9148 mbind.2
9149 mtk
9150 Reorder ERRORS sections alphabetically
9151
9152 mmap.2
9153 Maxime Vaudequin
9154 Fix syntax error in example program.
9155
9156 prctl.2
9157 mtk
9158 Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
9159
9160 ptrace.2
9161 Nicolas François / mtk
9162 s/PTRACE_POKEUSR/PTRACE_POKEUSER/
9163 s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
9164
9165 read.2
9166 mtk / Geoff Clare
9167 Add text describing timerfd EINVAL error for read(2).
9168
9169 set_mempolicy.2
9170 mtk
9171 Reorder ERRORS sections alphabetically
9172
9173 syscall.2
9174 mtk
9175 Added _syscall(2) and intro(2) to SEE ALSO section.
9176
9177 syscalls.2
9178 mtk
9179 Added fallocate(2); removed timerfd(2).
9180
9181 sysinfo.2
9182 mtk
9183 Removed reference to example in intro(2).
9184
9185 dlopen.3
9186 mtk
9187 Added "Link with -ldl." to SYNOPSIS.
9188
9189 getaddrinfo.3
9190 Ulrich Drepper / mtk
9191 Remove references to getipnodebyname.3 and getipnodebyaddr.3.
9192
9193 gethostbyname.3
9194 mtk / Ulrich Drepper
9195 Remove SEE ALSO references to getipnodebyname.3 and
9196 getipnodebyaddr.3.
9197
9198 Pádraig Brady / mtk / Ulrich Drepper
9199 Point out that the functions described on this page
9200 are made obsolete by getaddrinfo(3) and getnameinfo(3).
9201
9202 getipnodebyname.3
9203 mtk
9204 Clarify that glibc does not implement these functions.
9205
9206 glob.3
9207 Ulrich Drepper / mtk
9208 Fix description of GLOB_ONLYDIR.
9209 mtk
9210 Added description of GLOB_TILDE_NOMATCH.
9211 Expanded the description of various flags.
9212 Various wording fixes..
9213
9214 intro.3
9215 mtk
9216 Pretty much a complete rewrite, covering some additional topics.
9217
9218 posix_fallocate.3
9219 mtk
9220 Add SEE ALSO referring to fallocate.2.
9221
9222 rpc.3
9223 Sam Varshavchik
9224 Add some arg declarations to prototypes; fix typos.
9225
9226 setbuf.3
9227 Mike Frysinger
9228 Fix text in BUGS section.
9229
9230 sigset.3
9231 mtk
9232 The sigset() bugs were fixed in glibc 2.5.
9233 See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
9234
9235 intro.4
9236 mtk
9237 Minor rewrites.
9238
9239 st.4
9240 Maxime Vaudequin
9241 Various small corrections, formattings and modifications.
9242
9243 elf.5
9244 Mike Frysinger
9245 Document:
9246 - new p_flag: PT_GNU_STACK
9247 - new sections: .gnu.version .gnu.version_d .gnu.version_r
9248 .note.GNU-stack
9249 - new structures: ElfN_Verdef ElfN_Verdaux ElfN_Verneed
9250 ElfN_Vernaux
9251
9252 intro.5
9253 mtk
9254 Minor rewrites.
9255
9256 proc.5
9257 Ivana Varekova / mtk
9258 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9259 only available if CONFIG_SLAB is enabled.
9260 Maxime Vaudequin
9261 Update description of /proc/pci.
9262 Maxime Vaudequin
9263 Give italic formatting to file names in proc.5.
9264 mtk
9265 The display type of the /proc/PID/stat fields changed
9266 %lu to %u in Linux 2.6.22:
9267 flags
9268 rt_priority
9269 policy
9270
9271 slabinfo.5
9272 Ivana Varekova / mtk
9273 Add text noting that since kernel 2.6.16, /proc/slabinfo is
9274 only available if CONFIG_SLAB is enabled.
9275
9276 intro.6
9277 mtk
9278 Minor rewrites.
9279
9280 bootparam.7
9281 Maxime Vaudequin
9282 Update references to files in kernel "Documentation" directory.
9283
9284 intro.7
9285 mtk
9286 Minor rewrites.
9287
9288 ipv6.7
9289 Andrew McDonald
9290 Fix description of IPV6_ROUTER_ALERT option.
9291
9292 standards.7
9293 mtk
9294 Note online location of C99 standard.
9295
9296 intro.8
9297 mtk
9298 Some rewrites, plus new paragraph on exit status values.
9299
9300
9301 ==================== Changes in man-pages-2.69 ====================
9302
9303 Released: 2007-12-03
9304
9305
9306 Contributors
9307 ------------
9308
9309 The following people contributed notes, ideas, or patches that have
9310 been incorporated in changes in this release:
9311
9312 Adam Borowski <kilobyte@angband.pl>
9313 Alain Portal <aportal@univ-montp2.fr>
9314 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
9315 J. Bruce Fields <bfields@citi.umich.edu>
9316 David Härdeman <david@hardeman.nu>
9317 Jeremy Kerr <jk@ozlabs.org>
9318 Luke Browning <lukebr@linux.vnet.ibm.com>
9319 Mats Wichmann <mats.d.wichmann@intel.com>
9320 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9321 Mike Frysinger <vapier@gentoo.org>
9322 Reuben Thomas <rrt@sc3d.org>
9323 Sam Varshavchik <mrsam@courier-mta.com>
9324
9325 Apologies if I missed anyone!
9326
9327
9328 Global changes
9329 --------------
9330
9331 *.[013]p
9332 mtk
9333 Many whitespace clean-ups in formatted output.
9334
9335 mprotect.2
9336 bind.2
9337 mq_notify.3
9338 makecontext.3
9339 fmemopen.3
9340 David Härdeman / mtk
9341 Rename error handling function in example program
9342 (s/die/handle_error/).
9343
9344 Typographical or grammatical errors have been corrected in several places.
9345
9346
9347 Removed pages
9348 -------------
9349
9350 HOWTOHELP
9351 MAINTAINING
9352 mtk
9353 The content of these files is now available in HTML format.
9354
9355 New links
9356 ---------
9357
9358 cfsetspeed.3
9359 mtk
9360 Link to termios.3.
9361
9362
9363 Changes to individual pages
9364 ---------------------------
9365
9366 time.1
9367 Alain Portal
9368 Added "Linux User's Manual" to .TH line.
9369
9370 _syscall.2
9371 aeb / mtk
9372 Remove outdated text about pointer blocks for syscalls that have
9373 more than 5 arguments.
9374
9375 fcntl.2
9376 J. Bruce Fields
9377 Add warning that mandatory locking is unreliable.
9378 J. Bruce Fields
9379 Clarify details in description of file leases.
9380 J. Bruce Fields / mtk
9381 Minor wording edits.
9382 J. Bruce Fields
9383 Add F_GETLEASE under RETURN VALUE.
9384
9385 mmap.2
9386 mtk
9387 Handle errors using a custom handle_error() macro.
9388
9389 sched_setscheduler.2
9390 Mats Wichmann
9391 Add BUGS text noting that the return value from Linux
9392 sched_setschuler() does not conform to POSIX.
9393
9394 spu_create.2
9395 Jeremy Kerr
9396 Various updates and improvements.
9397 Luke Browning
9398 Refinement of text describing a "gang".
9399 mtk
9400 Minor edits.
9401
9402 spu_run.2
9403 Jeremy Kerr
9404 Various updates and improvements.
9405 mtk
9406 Minor edits.
9407
9408 err.3
9409 mtk
9410 Remove HISTORY section.
9411
9412 fopen.3
9413 Mike Frysinger
9414 Document 'e' (close-on-exec) option, new in glibc 2.7.
9415
9416 getloadavg.3
9417 Alain Portal / mtk
9418 Remove HISTORY section.
9419
9420 printf.3
9421 Andries E. Brouwer / mtk
9422 Fix the discussion of stdarg macros in the description of
9423 vprintf() description.
9424
9425 sem_wait.3
9426 mtk
9427 Handle errors using a custom handle_error() macro.
9428
9429 sigsetops.3
9430 Mats Wichmann
9431 Note that sigset_t objects must be initialized
9432 with sigemptyset() or sigfillset() before the other
9433 macros are employed.
9434
9435 termios.3
9436 mtk, after a note by Alain Portal
9437 Added cfsetspeed() to SYNOPSIS. Added text under CONFORMING TO
9438 noting that cfsetspeed() is BSD specific.
9439
9440 ttyslot.3
9441 Alain Portal
9442 Various references to "getty" were changed to "mingetty", since
9443 that is the manual page more likely to be found on current
9444 systems. (Completes changes that were made in man-pages-2.44.)
9445
9446 initrd.4
9447 mtk, after a note by Alain Portal
9448 Move "Configuration" section to top of page (like other
9449 section 4 pages) and make it a .SH section.
9450
9451 full.4
9452 mtk
9453 Re-ordered CONFIGURATION section to go before DESCRIPTION.
9454
9455 sk98lin.4
9456 Maxime Vaudequin
9457 Fix reference to kernel Documentation file.
9458
9459 elf.5
9460 mtk
9461 Renamed HISTORY section to NOTES, and removed BSD specific info.
9462
9463 proc.5
9464 Maxime Vaudequin
9465 Mention grub(8) in same sentence as lilo(8).
9466 Maxime Vaudequin
9467 Improve description of /proc/sys/abi and
9468 /proc/sys/kernel/modprobe.
9469
9470 utmp.5
9471 Alain Portal
9472 Various references to "getty" were changed to "mingetty", since
9473 that is the manual page more likely to be found on current
9474 systems. (Completes changes that were made in man-pages-2.44.)
9475
9476 iso_8859-2.7
9477 Adam Borowski
9478 Reverse the 2.68 change applied by mtk in response to
9479 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445085
9480 that replaced "Sorbian" with "Serbian".
9481 (Sorbian is a language of 50000 people in Brandenburg.)
9482
9483 man-pages.7
9484 mtk
9485 Added CONFIGURATION to list of "standard" section names.
9486
9487 spufs.7
9488 Jeremy Kerr
9489 Various updates and improvements.
9490 mtk
9491 Minor edits.
9492
9493 tcp.7
9494 Maxime Vaudequin
9495 Fix reference to kernel Documentation file.
9496
9497
9498 ==================== Changes in man-pages-2.70 ====================
9499
9500 Released: 2007-12-06
9501
9502
9503 Global changes
9504 --------------
9505
9506 Many pages
9507 mtk
9508 Remove section numbers for page references where the
9509 reference refers to the page itself. (This stops man2html
9510 producing links from a page back to itself.)
9511
9512 Typographical or grammatical errors have been corrected in several places.
9513
9514
9515 Changes to individual pages
9516 ---------------------------
9517
9518 get_mempolicy.2
9519 mtk
9520 Add CONFORMING TO section.
9521
9522 io_getevents.2
9523 mtk
9524 Remove redundant SEE ALSO entry.
9525
9526 mbind.2
9527 mtk
9528 Add CONFORMING TO section.
9529
9530 msgop.2
9531 mtk
9532 Remove redundant SEE ALSO entries.
9533
9534 sigprocmask.2
9535 mtk
9536 Remove redundant SEE ALSO entry.
9537
9538 splice.2
9539 mtk
9540 Remove redundant SEE ALSO entry.
9541 Add SEE ALSO referring to vmsplice(2).
9542
9543 csin.3
9544 mtk
9545 Remove redundant SEE ALSO entry.
9546 Add SEE ALSO referring to ccos(3).
9547
9548 gethostbyname.3
9549 mtk
9550 Add gethostbyaddr_r to NAME section.
9551
9552 rint.3
9553 mtk
9554 Remove redundant SEE ALSO entry.
9555
9556 sigsetops.3
9557 mtk
9558 Minor rewording.
9559
9560 epoll.7
9561 mtk
9562 Minor rewording.
9563
9564
9565 ==================== Changes in man-pages-2.71 ====================
9566
9567 Released: 2007-12-14
9568
9569
9570 Contributors
9571 ------------
9572
9573 The following people contributed notes, ideas, or patches that have
9574 been incorporated in changes in this release:
9575
9576 Alain Portal <aportal@univ-montp2.fr>
9577 John Sigler <linux.kernel@free.fr>
9578 Josh Triplett <josh@freedesktop.org>
9579 Mats Wichmann <mats.d.wichmann@intel.com>
9580 Pascal MALAISE <malaise@magic.fr>
9581 Sam Varshavchik <mrsam@courier-mta.com>
9582
9583 Apologies if I missed anyone!
9584
9585
9586 Global changes
9587 --------------
9588
9589 err.3
9590 fts.3
9591 getloadavg.3
9592 queue.3
9593 rcmd.3
9594 rexec.3
9595 stdin.3
9596 elf.5
9597 operator.7
9598 mtk
9599 Replaced the use of mdoc macros on these pages with man
9600 macros. The only pages in man-pages that still use
9601 mdoc macros are mdoc.7 and mdoc.samples.7.
9602
9603 Typographical or grammatical errors have been corrected in several places.
9604
9605
9606 Deleted pages
9607 -------------
9608
9609 TODO
9610 mtk
9611 This information is now on the website.
9612
9613
9614 Changes to individual pages
9615 ---------------------------
9616
9617 Changes.old
9618 mtk
9619 Reformat various change log entries to use a consistent format.
9620 Expand Debian bug report numbers to be URLs.
9621 Other minor tidy-ups.
9622
9623 fcntl.2
9624 mtk
9625 Document the F_DUPFD_CLOEXEC operation, which is
9626 new in kernel 2.6.24.
9627
9628 listen.2
9629 Josh Triplett
9630 Fix incorrect path for somaxconn.
9631
9632 getpw.3
9633 Alain PORTAL
9634 Add ENOENT error to ERRORS.
9635
9636 sysconf.3
9637 Mats Wichmann
9638 Add documentation of _SC_NPROCESSORS_CONF and _SC_NPROCESSORS_ONLN.
9639
9640 tty.4
9641 John Sigler
9642 Add tty_ioctl(4) to SEE ALSO list.
9643
9644 regex.7
9645 Pascal MALAISE <malaise@magic.fr>
9646 Separate text on back references from that describing basic regexps,
9647 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379829.
9648 mtk
9649 Remove crufty text about word boundaries.
9650
9651
9652 ==================== Changes in man-pages-2.72 ====================
9653
9654 Released: 2007-12-14
9655
9656
9657 Contributors
9658 ------------
9659
9660 The following people contributed notes, ideas, or patches that have
9661 been incorporated in changes in this release:
9662
9663 Alain Portal <aportal@univ-montp2.fr>
9664 Alex Tuninga <atuninga@google.com>
9665 Bert Wesarg <bert.wesarg@googlemail.com>
9666 Maxime Vaudequin <maxime.vaudequin@gmail.com>
9667 Rob Weryk <rjweryk@uwo.ca>
9668 Sam Varshavchik <mrsam@courier-mta.com>
9669
9670 Apologies if I missed anyone!
9671
9672
9673 Global changes
9674 --------------
9675
9676 Various pages
9677 Alain PORTAL / mtk
9678 Format include files consistently (".I <.*\.h>").
9679
9680 Various pages
9681 Alain PORTAL / mtk
9682 Format pathname in italics (.I).
9683
9684 dbopen.3
9685 mpool.3
9686 recno.3
9687 Alain PORTAL
9688 Remove brackets ([]) around error names.
9689
9690 console.4
9691 tty.4
9692 ttyS.4
9693 issue.5
9694 ttytype.5
9695 utmp.5
9696 mtk / Maxime Vaudequin
9697 Some systems have mingetty(8), others have agetty(8), so both
9698 should be mentioned when we are talking about getty-style programs.
9699
9700
9701 Typographical or grammatical errors have been corrected in several places.
9702
9703
9704 Renamed pages
9705 -------------
9706
9707 filesystems.5
9708 mtk / Alain PORTAL
9709 Was previously fs.5
9710
9711
9712 New links
9713 ---------
9714
9715 argz.3
9716 Bert Wesarg / mtk
9717 Link to argz_add.3.
9718
9719 envz.3
9720 Bert Wesarg / mtk
9721 Link to envz_add.3.
9722
9723 fs.5
9724 mtk / Alain PORTAL
9725 Link to filesystems.5.
9726
9727
9728 Changes to individual pages
9729 ---------------------------
9730
9731 readahead.2
9732 Rob Weryk
9733 Fix declaration of 'offset' in SYNOPSIS.
9734
9735 seteuid.2
9736 mtk
9737 s/SETGUID/SETEUID/ in .TH line.
9738
9739 __setfpucw.3
9740 mtk
9741 Fixed include files references / formatting.
9742
9743 abort.3
9744 mtk, after a note by Alex Tuninga
9745 A fairly significant rewrite to clarify operation of abort().
9746
9747 argz_add.3
9748 Bert Wesarg / mtk
9749 s/envz/envz_add/ in SEE ALSO.
9750
9751 basename.3
9752 mtk
9753 s/DIRNAME/BASENAME/ in .TH line, and swap function names
9754 in NAME section.
9755
9756 envz_add.3
9757 Bert Wesarg / mtk
9758 s/argz/argz_add/ in SEE ALSO.
9759
9760 flockfile.3
9761 mtk
9762 s/LOCKFILE/FLOCKFILE/ in .TH line.
9763
9764 getgrent_r.3
9765 mtk
9766 s/GETGRENT/GETGRENT_R/ in .TH line.
9767
9768 stdio.3
9769 Sam Varshavchik
9770 Reformat function list at end of page as a proper table.
9771
9772 ttyslot.3
9773 Maxime Vaudequin
9774 Revert earlier s/getty/mingetty/. This page talks about
9775 historical behavior, and that means "getty(8)".
9776
9777 undocumented.3
9778 mtk
9779 Remove reference to "obstack stuff"; it's not clear what
9780 that is about.
9781
9782 console_ioctl.4
9783 mtk
9784 s/CONSOLE_IOCTLS/CONSOLE_IOCTL/ in .TH line.
9785
9786 proc.5
9787 mtk
9788 s/fs (5)/filesystems (5)/
9789
9790 man-pages.7
9791 mtk / Alain PORTAL
9792 Improve discussion of formatting of file names.
9793
9794
9795 ==================== Changes in man-pages-2.73 ====================
9796
9797 Released: 2007-12-14
9798
9799
9800 Contributors
9801 ------------
9802
9803 The following people contributed notes, ideas, or patches that have
9804 been incorporated in changes in this release:
9805
9806 Alain Portal <aportal@univ-montp2.fr>
9807 Pádraig Brady <P@draigBrady.com>
9808 Reuben Thomas <rrt@sc3d.org>
9809
9810 Apologies if I missed anyone!
9811
9812
9813 Global changes
9814 --------------
9815
9816 Various pages
9817 Alain PORTAL
9818 Formatting fixes.
9819
9820 Typographical or grammatical errors have been corrected in several places.
9821
9822
9823 Changes to individual pages
9824 ---------------------------
9825
9826 mknod.2
9827 mtk, after a report by Reuben Thomas
9828 Clarify use of mkfifo() versus mknod().
9829 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=455825
9830
9831 fgetgrent.3
9832 mtk
9833 Small rewording.
9834
9835 fgetpwent.3
9836 mtk
9837 Small rewording.
9838
9839 rcmd.3
9840 mtk
9841 Noted feature test macro requirements.
9842 BUGS: noted that iruserok() is not declared in glibc headers.
9843
9844 filesystems.5
9845 mtk
9846 Added Reiserfs, XFS, JFS to list of file systems.
9847
9848
9849 ==================== Changes in man-pages-2.74 ====================
9850
9851 Released: 2007-12-20
9852
9853
9854 Contributors
9855 ------------
9856
9857 The following people contributed notes, ideas, or patches that have
9858 been incorporated in changes in this release:
9859
9860 Alain Portal <aportal@univ-montp2.fr>
9861 Andrew Morton <akpm@linux-foundation.org>
9862 David Brown <lkml@davidb.org>
9863 Jeremy Kerr <jk@ozlabs.org>
9864 Mats Wichmann <mats.d.wichmann@intel.com>
9865 Sam Morris <sam@robots.org.uk>
9866 Sam Varshavchik <mrsam@courier-mta.com>
9867 Samuel Thibault <samuel.thibault@ens-lyon.org>
9868
9869 Apologies if I missed anyone!
9870
9871
9872 Global changes
9873 --------------
9874
9875 Various pages
9876 Alain PORTAL
9877 Formatting fixes.
9878
9879 Various pages
9880 mtk / Alain Portal
9881 s/``...''/"..."/
9882
9883 Various pages
9884 mtk
9885 s/epoch/Epoch/
9886
9887 Various pages
9888 mtk
9889 Make the standard indent for code samples, shell session
9890 logs, etc. to be ".in +4n".
9891
9892 Typographical or grammatical errors have been corrected in several places.
9893
9894
9895 Changes to individual pages
9896 ---------------------------
9897
9898 _syscall.2
9899 mtk
9900 Nowadays there is _syscall6() also.
9901
9902 chroot.2
9903 mtk
9904 Various minor formatting changes.
9905
9906 epoll_wait.2
9907 mtk
9908 Fix types in structs.
9909 Formatting fixes.
9910
9911 mount.2
9912 mtk, after a note by Sam Morris
9913 Clarify that MS_NODIRATIME provides a subset of the
9914 functionality provided by MS_NOATIME.
9915
9916 sched_setaffinity.2
9917 mtk
9918 Minor rearrangement of text.
9919
9920 select_tut.2
9921 mtk
9922 Fix (my) typos in argument names.
9923 Formatting fixes.
9924
9925 spu_create.2
9926 Jeremy Kerr
9927 We can use context FDs for the dirfd argument to the *at() syscalls.
9928
9929 times.2
9930 mtk, after a note from David Brown and Andrew Morton
9931 http://marc.info/?l=linux-kernel&m=119447727031225&w=2
9932 Rework the text describing the return value to be closer
9933 to the requirements of POSIX.1; move Linux details
9934 to NOTES and add a warning not to rely on those details.
9935 Add a warning about the -1 to -4095 bug which results
9936 in a 41 second window where the glibc wrapper will wrongly
9937 return -1 indicating an error.
9938 mtk
9939 Remove cruft HZ text.
9940 Clarify text describing return value of clock(3).
9941
9942 getw.3
9943 Mats Wichmann
9944 CONFORMING TO: getw() and putw() were in SUSv2, but are not
9945 in POSIX.1-2001.
9946
9947 hash.3
9948 mtk / Alain Portal
9949 Minor rewordings + formatting fixes.
9950
9951 st.4
9952 Alain Portal / mtk
9953 Many formatting fixes.
9954 mtk
9955 Place ERRORS in alphabetical order.
9956
9957 vcs.4
9958 Samuel Thibault
9959 Document VT_GETHIFONTMASK (new in 2.6.18) and add to example program;
9960 attribute/text characters are in the host byte order.
9961 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=456437
9962 mtk
9963 Minor edits.
9964
9965 bootparam.7
9966 Alain PORTAL
9967 Formatting fixes.
9968
9969 inotify.7
9970 mtk
9971 Minor heading changes and reformattings.
9972
9973 man-pages.7
9974 mtk
9975 Note that code segments, structure definitions, shell session
9976 logs, should be indented by 4 spaces.
9977
9978 spufs.7
9979 Jeremy Kerr
9980 Add a little information about the differences to mbox.
9981
9982
9983 ==================== Changes in man-pages-2.75 ====================
9984
9985 Released: 2008-01-08
9986
9987
9988 Contributors
9989 ------------
9990
9991 The following people contributed notes, ideas, or patches that have
9992 been incorporated in changes in this release:
9993
9994 Alain Portal <aportal@univ-montp2.fr>
9995 Andi Kleen <ak@suse.de>
9996 Andreas Henriksson <andreas@fatal.se>
9997 Jeremy Kerr <jk@ozlabs.org>
9998 Justin Pryzby <jpryzby+d@quoinic.com>
9999 Phil Endecott <spam_from_debian_bugs_4@chezphil.org>
10000 Sam Varshavchik <mrsam@courier-mta.com>
10001 Thomas Huriaux <thomas.huriaux@gmail.com>
10002 Timo Sirainen <tss@iki.fi>
10003 Trond Myklebust <trond.myklebust@fys.uio.no>
10004
10005 Apologies if I missed anyone!
10006
10007
10008 Global changes
10009 --------------
10010
10011 Various pages
10012 mtk
10013 (Grammatical) hyphenation was fixed in many places.
10014
10015 epoll_wait.2
10016 mbind.2
10017 spu_run.2
10018 ecvt.3
10019 fmtmsg.3
10020 getnameinfo.3
10021 rtc.4
10022 proc.5
10023 charsets.7
10024 ip.7
10025 ipv6.7
10026 raw.7
10027 uri.7
10028 Justin Pryzby / mtk
10029 Fix incorrect usage of "a" and "an" before following vowel /
10030 consonant, by reviewing the output of the following scripts:
10031
10032 for a in $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10033 echo $a
10034 MANWIDTH=4000 man -l $a 2>/dev/null |
10035 egrep '(^| )an [^aeiou][a-z]'
10036 done | less
10037
10038 for a in $(wc */*.? | awk '$1 > 10 {print $4}' | gv total); do
10039 echo $a
10040 MANWIDTH=4000 man -l $a 2>/dev/null |
10041 egrep '(^| )a [aeiou][a-z]'
10042 done| less
10043
10044 err.3
10045 fts.3
10046 queue.3
10047 rcmd.3
10048 rexec.3
10049 stdin.3
10050 elf.5
10051 mtk, after a note by Alain Portal
10052 Improve macros used in 2.71 to convert from "mdoc" to "man".
10053
10054 _exit.2
10055 chroot.2
10056 getgid.2
10057 getpid.2
10058 getrusage.2
10059 getsid.2
10060 gettid.2
10061 getuid.2
10062 iopl.2
10063 kill.2
10064 personality.2
10065 pivot_root.2
10066 ptrace.2
10067 sched_setparam.2
10068 sched_setscheduler.2
10069 sched_yield.2
10070 seteuid.2
10071 setgid.2
10072 setpgid.2
10073 setresuid.2
10074 setreuid.2
10075 setuid.2
10076 unlink.2
10077 wait.2
10078 openpty.3
10079 raise.3
10080 setlogmask.3
10081 sleep.3
10082 ttyslot.3
10083 ulimit.3
10084 tty.4
10085 tty_ioctl.4
10086 path_resolution.7
10087 mtk
10088 s/current process/calling process/
10089
10090 cacheflush.2
10091 clone.2
10092 fcntl.2
10093 getitimer.2
10094 getrlimit.2
10095 mmap.2
10096 mprotect.2
10097 times.2
10098 adjtime.3
10099 byteorder.3
10100 inet.3
10101 offsetof.3
10102 rtc.4
10103 icmp.7
10104 pipe.7
10105 time.7
10106 mtk
10107 s/x86/i386/ since that is the name used in 'arch' directories
10108 in the kernel source, and previously both i386 and x86 were both
10109 used in man pages; also nowadays 'x86' is somewhat ambiguous,
10110 since it is the name of the 'arch' directory for i386 and x86-64.
10111
10112 conj.3
10113 cacos.3
10114 cacosh.3
10115 cabs.3
10116 carg.3
10117 casin.3
10118 casinh.3
10119 catan.3
10120 catanh.3
10121 ccos.3
10122 ccosh.3
10123 cexp.3
10124 cimag.3
10125 clog.3
10126 cosh.3
10127 creal.3
10128 csin.3
10129 csinh.3
10130 ctan.3
10131 ctanh.3
10132 sinh.3
10133 tanh.3
10134 mtk
10135 Various reformattings.
10136
10137 Various pages
10138 Alain Portal
10139 Formatting fixes.
10140
10141 mlock.2
10142 mprotect.2
10143 mpool.3
10144 offsetof.3
10145 Alain Portal
10146 Format SYNOPSIS in a manner consistent with other pages.
10147
10148 Various pages
10149 mtk / Alain Portal
10150 Format casts so that there is a non-breaking space after the
10151 type, and remove unnecessary parentheses around the casted value.
10152 Thus, for example, the following:
10153
10154 .IR "(size_t) (\-1)" .
10155
10156 becomes:
10157
10158 .IR "(size_t)\ \-1" .
10159
10160 Various pages
10161 mtk / Alain Portal
10162 Replace "-" by "\-" where a real dash is required.
10163
10164 Various pages
10165 mtk
10166 Make the formatting of instances of '*varname' consistent, changing
10167 instances such as:
10168
10169 .RI * varname
10170
10171 to:
10172
10173 .I *varname
10174
10175 pciconfig_read.2
10176 nfsservctl.2
10177 bstring.3
10178 cpow.3
10179 getipnodebyname.3
10180 getpwnam.3
10181 getrpcent.3
10182 lsearch.3
10183 malloc_hook.3
10184 mpool.3
10185 stdin.3
10186 strtol.3
10187 strtoul.3
10188 unlocked_stdio.3
10189 regex.3
10190 sd.4
10191 resolv.conf.5
10192 utmp.5
10193 futex.7
10194 mtk
10195 Format SYNOPSIS consistently.
10196
10197 drand48.3
10198 drand48_r.3
10199 flockfile.3
10200 erf.3
10201 sigvec.3
10202 timeradd.3
10203 wprintf.3
10204 mtk, after a note by Alain Portal
10205 Standardize sentence used under "Feature Test Macro Requirements"
10206 when referring to all functions shown in the SYNOPSIS.
10207
10208 get_kernel_syms.2
10209 getdents.2
10210 getitimer.2
10211 nanosleep.2
10212 query_module.2
10213 statvfs.2
10214 clock_getres.3
10215 getaddrinfo.3
10216 getgrent.3
10217 getipnodebyname.3
10218 console_ioctl.4
10219 tty_ioctl.4
10220 rtnetlink.7
10221 mtk
10222 Indent structure definitions by +4n.
10223
10224 recv.2
10225 btree.3
10226 dbopen.3
10227 ether_aton.3
10228 fts.3
10229 hash.3
10230 mpool.3
10231 profil.3
10232 rcmd.3
10233 recno.3
10234 rpc.3
10235 xdr.3
10236 console_ioctl.4
10237 ddp.7
10238 ip.7
10239 ipv6.7
10240 svipc.7
10241 mtk
10242 Use C99 standard types in declarations.
10243 s/u_long/unsigned long/
10244 s/ulong/unsigned long/
10245 s/u_char/unsigned char/
10246 s/u_short/unsigned short/
10247 s/ushort/unsigned short/
10248 s/u_int8_t/uint8_t/
10249 s/u_int16_t/uint16_t/
10250 s/u_int32_t/uint32_t/
10251 s/u_int/unsigned int/
10252
10253 exit_group.2
10254 fallocate.2
10255 getdents.2
10256 ioctl_list.2
10257 nfsservctl.2
10258 sched_setaffinity.2
10259 set_tid_address.2
10260 ustat.2
10261 argz_add.3
10262 confstr.3
10263 envz_add.3
10264 getline.3
10265 getpwnam.3
10266 gets.3
10267 getw.3
10268 inet_ntop.3
10269 inet_pton.3
10270 offsetof.3
10271 console_ioctl.4
10272 termcap.5
10273 ascii.7
10274 feature_test_macros.7
10275 netlink.7
10276 operator.7
10277 svipc.7
10278 mtk
10279 Fix unbalanced .nf/.fi pairs.
10280
10281 chmod.2
10282 getxattr.2
10283 listxattr.2
10284 lseek.2
10285 removexattr.2
10286 setxattr.2
10287 stat.2
10288 feature_test_macros.7
10289 fpathconf.3
10290 fopen.3
10291
10292 mtk
10293 Rename argument: s/file*des/fd/ , since that is the name most
10294 commonly used on man pages for a file descriptor argument.
10295
10296 bindresvport.3
10297 des_crypt.3
10298 getopt.3
10299 getrpcent.3
10300 realpath.3
10301 rpc.3
10302 xdr.3
10303 mtk
10304 Removed .SM macros.
10305
10306 madvise.2
10307 getdirentries.3
10308 printf.3
10309 sigvec.3
10310 mtk
10311 Remove extraneous .br macro before/after .SH/.SS.
10312
10313 _syscall.2
10314 lookup_dcookie.2
10315 aio_cancel.3
10316 aio_error.3
10317 aio_fsync.3
10318 aio_read.3
10319 aio_return.3
10320 aio_write.3
10321 canonicalize_file_name.3
10322 envz_add.3
10323 getgrouplist.3
10324 getttyent.3
10325 key_setsecret.3
10326 mtrace.3
10327 tcgetpgrp.3
10328 tcgetsid.3
10329 ttyslot.3
10330 tty_ioctl.4
10331 mtk
10332 Remove extraneous .sp macros.
10333
10334 fcntl.2
10335 outb.2
10336 send.2
10337 syscalls.2
10338 getopt.3
10339 proc.5
10340 man-pages.7
10341 standards.7
10342 tcp.7
10343 mtk
10344 Remove/replace extraneous .sp macros.
10345
10346 Typographical or grammatical errors have been corrected in several places.
10347
10348
10349 Changes to individual pages
10350 ---------------------------
10351
10352 _syscall.2
10353 mtk
10354 Nowadays there are seven macros (see 2.74 change log also).
10355
10356 arch_prctl.2
10357 mtk, Acked by Andi Kleen
10358 Clarify interpretation of 'addr'; plus a few other minor edits
10359 and updates.
10360
10361 bind.2
10362 mtk
10363 Minor rewrites.
10364
10365 close.2
10366 mtk
10367 Clarify relationship between file descriptor and open file
10368 description.
10369
10370 connect.2
10371 mtk, Acked by Andi Kleen
10372 Since kernel 2.2, AF_UNSPEC for unconnecting a connected
10373 socket *is* supported.
10374
10375 execve.2
10376 Alain Portal
10377 Minor rewordings.
10378
10379 futimesat.2
10380 Alain Portal
10381 Remove duplicate "#include <fcntl.h>" from SYNOPSIS.
10382
10383 getgid.2
10384 mtk
10385 Add getresgid(2) and credentials(7) to SEE ALSO.
10386
10387 getpagesize.2
10388 mtk
10389 Small rewording.
10390
10391 getresuid.2
10392 mtk
10393 Rewrote various parts.
10394
10395 getuid.2
10396 mtk
10397 Add getresuid(2) and credentials(7) to SEE ALSO.
10398
10399 ioctl_list.2
10400 Alain Portal
10401 Use proper tables for layout, and various formatting fixes.
10402 mtk
10403 Various formatting fixes.
10404
10405 listen.2
10406 mtk
10407 Rewrote various parts.
10408
10409 mbind.2
10410 Andi Kleen / mtk / Alain Portal
10411 Modify explanation of EINVAL 'maxnode' error.
10412
10413 mmap.2
10414 mtk
10415 Add comma to clarify meaning of a sentence.
10416
10417 open.2
10418 mtk
10419 Clarify initial description of O_EXCL.
10420 Clarify description of behaviors of O_CREAT | O_EXCL
10421 for symbolic links.
10422 Clarify text describing use of lockfiles without O_EXCL.
10423 mtk, with input from Timo Sirainen and Trond Myklebust
10424 O_EXCL is supported on NFSv3 and later, with Linux 2.6 and later.
10425
10426 pipe.2
10427 mtk
10428 Rename 'filedes' argument 'pipefd'.
10429
10430 pivot_root.2
10431 mtk
10432 s/cwd/current working directory/
10433
10434 seteuid.2
10435 mtk
10436 Minor changes.
10437
10438 setpgid.2
10439 mtk
10440 Add credentials(7) to SEE ALSO, and updated copyright credits,
10441 to reflect my rewrite of a few months ago.
10442
10443 setsid.2
10444 mtk
10445 Add getsid(2) and credentials(7) to SEE ALSO.
10446
10447 spu_create.2
10448 Alain Portal / mtk; acked by Jeremy Kerr
10449 Minor formatting/wording changes.
10450 mtk
10451 Put EPERM in right alphabetical position in ERRORS list.
10452
10453 argz_add.3
10454 mtk
10455 Formatting fixes.
10456
10457 atexit.3
10458 mtk
10459 Minor changes to example program.
10460
10461 cerf.3
10462 mtk
10463 These functions are still not present as at glibc 2.7.
10464
10465 dbopen.3
10466 Alain Portal / mtk
10467 Various minor spelling and formatting fixes.
10468
10469 envz_add.3
10470 mtk
10471 Formatting fixes.
10472
10473 fexecve.3
10474 mtk
10475 Fix placement of feature test macro in SYNOPSIS.
10476
10477 fmax.3
10478 fmin.3
10479 mtk
10480 Small rewording.
10481
10482 getline.3
10483 mtk
10484 Minor changes to example program.
10485
10486 getrpcent.3
10487 getrpcport.3
10488 mtk
10489 Use modern C prototypes in SYNOPSIS.
10490
10491 getutent.3
10492 Alain Portal / mtk
10493 Formatting fixes.
10494
10495 mbsnrtowcs.3
10496 mbsrtowcs.3
10497 mbstowcs.3
10498 mtk
10499 Use .IP tags to create properly formatted lists.
10500
10501 rpc.3
10502 mtk
10503 Convert function declarations to use modern C prototypes.
10504 Add text and start of page describing header files
10505 and types required by functions.
10506 Reformat discussion of request under clnt_control().
10507
10508 xdr.3
10509 mtk
10510 Convert function declarations to use modern C prototypes.
10511 Remove crufty "int empty" from xdrrec_eof() description.
10512
10513 console_codes.4
10514 Phil Endecott
10515 Relocate misplaced line:
10516 "and if LF/NL (new line mode) is set also a carriage return;"
10517 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458338.
10518
10519 console_ioctl.4
10520 mtk
10521 Formatting fixes.
10522
10523 bootparam.7
10524 mtk, after a note by Alan Portal
10525 Fix reference to kernel documentation source file in the
10526 "The Sound Driver" subsection.
10527
10528 man-pages.7
10529 Alain Portal
10530 Move CONFIGURATION description after SYNOPSIS description.
10531 mtk / Alain Portal
10532 Note that header files should be surrounded by angle brackets (<>).
10533
10534 posixoptions.7
10535 mtk
10536 Minor formatting and wording fixes.
10537
10538 rtnetlink.7
10539 Andreas Henriksson
10540 Fix description of RTM_F_EQUALIZE.
10541 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=458325.
10542
10543 signal.7
10544 mtk
10545 Minor formatting and wording fixes.
10546
10547 socket.7
10548 mtk
10549 Small rewording of discussion of O_ASYNC.
10550
10551 spufs.7
10552 mtk / Jeremy Kerr / Alain Portal
10553 s/SPE/SPU/
10554
10555
10556 ==================== Changes in man-pages-2.76 ====================
10557
10558 Released: 2008-01-14
10559
10560
10561 Contributors
10562 ------------
10563
10564 The following people contributed notes, ideas, or patches that have
10565 been incorporated in changes in this release:
10566
10567 Alain Portal <aportal@univ-montp2.fr>
10568 Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
10569 Jeremy Kerr <jk@ozlabs.org>
10570 Sam Varshavchik <mrsam@courier-mta.com>
10571 Trond Myklebust <trond.myklebust@fys.uio.no>
10572
10573 Apologies if I missed anyone!
10574
10575
10576 Global changes
10577 --------------
10578
10579 longjmp.3
10580 printf.3
10581 scanf.3
10582 setbuf.3
10583 setjmp.3
10584 sk98lin.4
10585 environ.7
10586 mtk
10587 Rework/remove use of ".ad" macros.
10588
10589 ioctl_list.2
10590 mlock.2
10591 mprotect.2
10592 mremap.2
10593 syslog.2
10594 cfree.3
10595 mpool.3
10596 offsetof.3
10597 rpc.3
10598 stdin.3
10599 mtk
10600 Fix unbalanced quotes in formatting macros.
10601
10602 ftok.3
10603 mtk
10604 s/i-node/inode/, for consistency with other pages and POSIX.1-2001.
10605
10606 Typographical or grammatical errors have been corrected in several places.
10607
10608
10609 Changes to individual pages
10610 ---------------------------
10611
10612 chown.2
10613 mtk
10614 Minor wording change.
10615
10616 dup.2
10617 mtk
10618 Reordered text in DESCRIPTION and added some details for dup2().
10619
10620 open.2
10621 Trond Myklebust / mtk
10622 Minor fix to O_EXCL changes in previous release.
10623
10624 gettid.2
10625 mtk
10626 Rewrote DESCRIPTION; noted that thread ID is not the same
10627 thing as a POSIX thread ID.
10628
10629 pipe.2
10630 mtk
10631 Rewrote DESCRIPTION; minor additions to EXAMPLE text.
10632
10633 umask.2
10634 mtk
10635 A few rewrites and additions.
10636
10637 strptime.3
10638 Carlo Marcelo Arenas Belon / mtk
10639 Add "#define _XOPEN_SOURCE" to example program.
10640
10641 initrd.4
10642 mtk
10643 Use quotes more consistently in formatting macros.
10644
10645 random.4
10646 mtk, after a report by Daniel Kahn Gilmor
10647 Add 2.6 details for /proc/sys/kernel/random/poolsize.
10648 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=459232.
10649
10650 pthreads.7
10651 mtk
10652 Minor changes.
10653
10654 spufs.7
10655 mtk / Jeremy Kerr
10656 Define abbreviation "MSS".
10657
10658
10659 ==================== Changes in man-pages-2.77 ====================
10660
10661 Released: 2008-01-31
10662
10663
10664 Contributors
10665 ------------
10666
10667 The following people contributed notes, ideas, or patches that have
10668 been incorporated in changes in this release:
10669
10670 Pavel Heimlich <tropikhajma@seznam.cz>
10671 Phil Endecott <phil_vonar_endecott@chezphil.org>
10672 Thomas Huriaux <thomas.huriaux@gmail.com>
10673 Vincent Lefevre <vincent@vinc17.org>
10674 WANG Cong <xiyou.wangcong@gmail.com>
10675
10676 Apologies if I missed anyone!
10677
10678
10679 Global changes
10680 --------------
10681
10682 stdarg.3
10683 bootparam.7
10684 Thomas Huriaux
10685 Fix broken use of single quotes at start of line,
10686 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462636
10687
10688 Typographical or grammatical errors have been corrected in several places.
10689
10690 New pages
10691 ---------
10692
10693 remove_COLOPHON.sh
10694 mtk
10695 Script to remove the COLOPHON section from the man pages provided
10696 as command-line arguments. This is useful to remove the COLOPHON
10697 sections from all of the man pages in two different release trees
10698 in order to do a "diff -ruN" to see the "real" differences
10699 between the trees.
10700
10701
10702 Changes to individual pages
10703 ---------------------------
10704
10705 fcntl.2
10706 mtk
10707 Replace tables with .TP macros.
10708
10709 fork.2
10710 mtk
10711 Added discussion of directory streams.
10712 Removed "#include <sys/types>" from SYNOPSIS.
10713 Changed authorship notice.
10714
10715 futex.2
10716 mtk
10717 Add ENOSYS error to errors.
10718 Phil Endecott
10719 Explicitly describe return value in the event of an error.
10720
10721 inotify_add_watch.2
10722 mtk
10723 Minor wording changes.
10724
10725 splice.2
10726 WANG Cong
10727 Fix types for 2 and 4 arguments in splice prototype.
10728
10729 wait.2
10730 Phil Endecott
10731 Clarify description of return value for WNOHANG.
10732
10733 tkill.2
10734 mtk
10735 Rewrote DESCRIPTION; emphasized that tkill() is obsoleted by
10736 tgkill().
10737
10738 alloca.3
10739 mtk
10740 Change description in NAME section.
10741 Various rewrites and additions (including notes on longjmp() and
10742 SIGSEGV).
10743 mtk / Vincent Lefevre
10744 Weaken warning against use of alloca(), and
10745 point out some cases where it can be useful;
10746 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=461100.
10747
10748 bootparam.7
10749 Pavel Heimlich
10750 Remove junk line.
10751
10752 inotify.7
10753 mtk
10754 Replace tables with .TP macros.
10755 s/MultiSource Synchronization/MultiSource Synchronization (MSS)/
10756
10757
10758 ==================== Changes in man-pages-2.78 ====================
10759
10760 Released: 2008-02-15
10761
10762
10763 Contributors
10764 ------------
10765
10766 The following people contributed notes, ideas, or patches that have
10767 been incorporated in changes in this release:
10768
10769 Davide Libenzi <davidel@xmailserver.org>
10770 Greg Banks <gnb@melbourne.sgi.com>
10771 Michael Tokarev <mjt@tls.msk.ru>
10772 Phil Endecott <phil_vonar_endecott@chezphil.org>
10773
10774 Apologies if I missed anyone!
10775
10776
10777 Global changes
10778 --------------
10779
10780 sigaction.2
10781 signal.2
10782 sigwaitinfo.2
10783 signal.7
10784 mtk
10785 Add SEE ALSO entry referring to new signalfd.2 page.
10786
10787 Typographical or grammatical errors have been corrected in several places.
10788
10789
10790 New pages
10791 ---------
10792
10793 eventfd.2
10794 mtk, with input and review from Davide Libenzi
10795 Documents the eventfd() system call, new in 2.6.22.
10796
10797 signalfd.2
10798 mtk, with input and review from Davide Libenzi
10799 Documents the signalfd() system call, new in 2.6.22.
10800
10801 Changes to individual pages
10802 ---------------------------
10803
10804 futex.2
10805 mtk / Phil Endecott
10806 Improve wording describing error returns.
10807
10808 open.2
10809 Greg Banks
10810 Greatly expand the detail on O_DIRECT.
10811
10812 reboot.2
10813 mtk / Michael Tokarev
10814 Fix RETURN VALUE description: in some cases reboot() does not
10815 return.
10816 mtk
10817 Rename the 'flag' argument to 'cmd', since that is more meaningful,
10818 and also what is used in the kernel source.
10819 Other minor wording changes.
10820
10821
10822 ==================== Changes in man-pages-2.79 ====================
10823
10824 Released: 2008-03-07
10825
10826
10827 Contributors
10828 ------------
10829
10830 The following people contributed notes, ideas, or patches that have
10831 been incorporated in changes in this release:
10832
10833 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
10834 Chris Heath <chris@heathens.co.nz>
10835 Davide Libenzi <davidel@xmailserver.org>
10836 Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
10837 Heikki Orsila <shdl@zakalwe.fi>
10838 Jeremy Kerr <jk@ozlabs.org>
10839 Justin Pryzby <justinpryzby@users.sourceforge.net>
10840 Lasse Kärkkäinen <tronic@trn.iki.fi>
10841 Michael Haardt <michael@moria.de>
10842 Mike Frysinger <vapier@gentoo.org>
10843 Ron Burk <ronburk@gmail.com>
10844 Sam Varshavchik <mrsam@courier-mta.com>
10845 Samuel Thibault <samuel.thibault@ens-lyon.org>
10846 Walter Harms <WHarms@bfs.de>
10847
10848 Apologies if I missed anyone!
10849
10850
10851 Global changes
10852 --------------
10853
10854 Typographical or grammatical errors have been corrected in several places.
10855
10856
10857 New pages
10858 ---------
10859
10860 timerfd_create.2
10861 mtk, with input and review from Davide Libenzi
10862 Documents the timerfd_create(), timerfd_settime(), and
10863 timerfd_gettime() system calls, which are new in 2.6.25.
10864
10865
10866 New links
10867 ---------
10868
10869 timerfd_gettime.2
10870 timerfd_settime.2
10871 mtk
10872 Links to new timerfd_create.2 page.
10873
10874 eventfd_read.3
10875 eventfd_write.3
10876 mtk
10877 Links to eventfd.2.
10878
10879
10880 Changes to individual pages
10881 ---------------------------
10882
10883 Makefile
10884 aeb
10885 Remove code relating to man1/README, which no longer exists.
10886
10887 execve.2
10888 mtk
10889 Clarify detail of RLIMIT_STACK/4 limit for argv+environ.
10890
10891 getitimer.2
10892 mtk
10893 Added SEE ALSO entry referring to timerfd_create.2.
10894
10895 getrusage.2
10896 mtk
10897 Minor rewordings.
10898
10899 open.2
10900 Michael Haardt
10901 Move discussion of 'mode' argument under description of O_CREAT.
10902
10903 signalfd.2
10904 mtk
10905 Fix type for 'ssi_ptr' field.
10906 See http://sources.redhat.com/ml/libc-hacker/2008-01/msg00002.html.
10907
10908 syscalls.2
10909 mtk
10910 Add timerfd_create(), timerfd_settime(), and timerfd_gettime()
10911 to list.
10912
10913 syslog.2
10914 Jeremy Kerr
10915 Add info on command type 10.
10916 Add details on types 6, 7, 8, and 9.
10917 Minor grammar fix.
10918 mtk
10919 Update LOG_BUF_LEN details.
10920 Update RETURN VALUE section.
10921 Notes capability requirements under EPERM error.
10922 Minor fix to description of type==3 and type==4.
10923 Other minor edits.
10924
10925 ctime.3
10926 Walter Harms
10927 Note that POSIX requires localtime() to act as though tzset()
10928 was called, but localtime_r() does not have the same requirement.
10929 See also http://thread.gmane.org/gmane.comp.time.tz/2034/
10930
10931 getaddrinfo.3
10932 mtk
10933 Clarify discussion of NULL 'hints' argument; other minor rewrites.
10934 mtk / Sam Varshavchik
10935 Remove some duplicated text.
10936
10937 malloc.3
10938 Lasse Kärkkäinen / Mike Frysinger / mtk
10939 Clarify description of realloc() behavior for
10940 ((size == 0) && (ptr != NULL)).
10941
10942 posix_fallocate.3
10943 Samuel Thibault
10944 s/stdlib.h/fcntl.h/ in SYNOPSIS.
10945
10946 proc.5
10947 Fernando Luis Vázquez Cao
10948 Update /proc/[number]/cmdline description.
10949 It used to be true that the command line arguments were
10950 not accessible when the process had been swapped out.
10951 In ancient kernels (circa 2.0.*) the problem was that the
10952 kernel relied on get_phys_addr to access the user space buffer,
10953 which stopped working as soon as the process was swapped out.
10954 Recent kernels use get_user_pages for the same purpose and thus
10955 they should not have that limitation.
10956
10957 epoll.7
10958 Davide Libenzi / mtk
10959 Clarify the somewhat unintuitive behavior that occurs if a file
10960 descriptor in an epoll set is closed while other file descriptors
10961 referring to the same underlying open file description remain
10962 open.
10963 See also http://thread.gmane.org/gmane.linux.kernel/596462/.
10964 mtk
10965 Clarify error that occurs if we add an epoll fd to its own set.
10966 mtk
10967 A few minor rewordings.
10968 mtk, after a note by Chris Heath
10969 Rework Q1/A1, describing what happens when adding the same
10970 file descriptor twice to an epoll set, and when adding duplicate
10971 file descriptors to the same epoll set.
10972 Heikki Orsila / mtk / Davide Libenzi
10973 Clarify Q9/A9 to discuss packet/token-oriented files.
10974 mtk, after comments by Davide Libenzi and Chris Heath
10975 Added Q0/A0, making explicit that the key for items in an epoll
10976 set is [file descriptor, open file description].
10977 mtk, after a note by Ron Burk
10978 Change A3, to note that when events are available,
10979 the epoll file descriptor will indicate as being readable.
10980 mtk
10981 Add some further explanation to Q5/A5 about why an epoll file
10982 descriptor cannot be passed across a Unix domain socket.
10983
10984 posixoptions.7
10985 mtk
10986 Add SEE ALSO entry for standards(7).
10987
10988 regex.7
10989 mtk
10990 Add grep(1) to SEE ALSO.
10991 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348552.
10992
10993 standards.7
10994 mtk
10995 Add SEE ALSO entry for posixoptions(7).
10996
10997 time.7
10998 mtk
10999 Added SEE ALSO entry referring to timerfd_create.2.
11000
11001
11002 ==================== Changes in man-pages-2.80 ====================
11003
11004 Released: 2008-06-05
11005
11006
11007 Contributors
11008 ------------
11009
11010 The following people contributed notes, ideas, or patches that have
11011 been incorporated in changes in this release:
11012
11013 Adrian Bunk <bunk@kernel.org>
11014 Alain Portal <aportal@univ-montp2.fr>
11015 Andreas Herrmann <andreas.herrmann3@amd.com>
11016 Andrew Morton <akpm@linux-foundation.org>
11017 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
11018 Anoop <acv@linux.vnet.ibm.com>
11019 Aurelien Gerome <ag@roxor.cx>
11020 Daniel Burr <dburr@topcon.com>
11021 Davide Libenzi <davidel@xmailserver.org>
11022 Felix Kater <fkater@googlemail.com>
11023 Folkert van Heusden <folkert@vanheusden.com>
11024 Hamaji Shinichiro <shinichiro.hamaji@gmail.com>
11025 Heikki Orsila <shd@modeemi.fi>
11026 Ingo Molnar <mingo@elte.hu>
11027 Justin Pryzby <justinpryzby@users.sourceforge.net>
11028 Karsten Weiss <K.Weiss@science-computing.de>
11029 Martin Pitt <mpitt@debian.org>
11030 Marty Leisner <leisner@rochester.rr.com>
11031 Nicolas François <nicolas.francois@trialog.com>
11032 Nick Piggin <npiggin@suse.de>
11033 Petter Reinholdtsen <pere@hungry.com>
11034 Reuben Thomas <rrt@sc3d.org>
11035 Sam Varshavchik <mrsam@courier-mta.com>
11036 Stuart Brady <sdbrady@ntlworld.com>
11037 Theodoros V. Kalamatianos <thkala@softlab.ece.ntua.gr>
11038 Thomas Huriaux <thomas.huriaux@gmail.com>
11039 Tim Stoakes <tim@stoakes.net>
11040 Timothy Baldwin <T.E.Baldwin99@members.leeds.ac.uk>
11041 Tolga Dalman <tdalman@project-psi.org>
11042
11043 Apologies if I missed anyone!
11044
11045
11046 Global changes
11047 --------------
11048
11049 bdflush.2
11050 inotify_add_watch.2
11051 mprotect.2
11052 sigprocmask.2
11053 ctime.3
11054 getusershell.3
11055 setbuf.3
11056 st.4
11057 ip.7
11058 packet.7
11059 mtk
11060 Replace "(il)legal" by "(not) permitted" or "(in)valid".
11061
11062 read.2
11063 utime.2
11064 filesystems.5
11065 packet.7
11066 mtk
11067 s/time stamp/timestamp/, for consistency with majority use
11068 in other pages, and in POSIX.1.
11069
11070 madvise.2
11071 mbind.2
11072 mincore.2
11073 mmap.2
11074 mmap2.2
11075 msync.2
11076 remap_file_pages.2
11077 mtk
11078 Change name of 'start' argument to 'addr' for consistency
11079 with:
11080 * other memory-related interfaces
11081 * POSIX specification (for those interfaces in POSIX)
11082 * Linux and glibc source code (in at least some cases)
11083
11084 Various pages
11085 mtk
11086 s/filesystem/file system/, for consistency with majority use
11087 in other pages, and in POSIX.1.
11088
11089 Various pages
11090 mtk
11091 s/zeroes/zeros/, for consistency with majority use
11092 in other pages, and in POSIX.1.
11093
11094 abs.3
11095 proc.5
11096 mtk
11097 s/builtin/built-in/, for consistency with majority use
11098 in other pages, and in POSIX.1.
11099
11100 mknod.2
11101 ftw.3
11102 mtk
11103 s/normal file/regular file/
11104
11105 Various pages
11106 mtk
11107 s/nonempty/non-empty/
11108
11109 Various pages
11110 mtk
11111 s/nonzero/non-zero/
11112
11113 Various pages
11114 mtk
11115 s/realtime/real-time/, for consistency with majority usage.
11116
11117 Various pages
11118 mtk
11119 s/command line/command-line/ when used attributively.
11120
11121 Various pages
11122 mtk
11123 Use "run time" when non-attributive, "run-time" when attributive.
11124
11125 Various pages
11126 mtk
11127 Various pages that I wrote carried a slightly modified version
11128 of the "verbatim" license. In the interests of minimizing
11129 license proliferation, I've reverted the modified form
11130 so that the license is exactly the same as on other pages
11131 carrying the verbatim license.
11132
11133 epoll_ctl.2
11134 getitimer.2
11135 getrlimit.2
11136 unix.7
11137 mtk
11138 s/since kernel x.y.z/since Linux x.y.z/
11139
11140 wait.2
11141 inotify.7
11142 mtk
11143 Reformat kernel version information for flags.
11144
11145 Typographical or grammatical errors have been corrected in several places.
11146 (Special thanks to Nicolas François.)
11147
11148
11149 New pages
11150 ---------
11151
11152 random_r.3
11153 mtk, after a suggestion by aeb
11154 Documents random_r(3), srandom_r(3), initstate_r(3), and
11155 setstate_r(3), which are the reentrant equivalents of
11156 random(3), srandom(3), initstate(3), and setstate(3).
11157
11158
11159 New links
11160 ---------
11161
11162 lutimes.3
11163 mtk
11164 Link to futimes.3.
11165
11166 initstate_r.3
11167 setstate_r.3
11168 srandom_r.3
11169 mtk
11170 Links to random_r.3.
11171
11172 daylight.3
11173 timezone.3
11174 tzname.3
11175 mtk
11176 Links to tzset.3.
11177
11178 isnanf.3
11179 isnanl.3
11180 mtk
11181 Links to finite.3.
11182
11183 encrypt_r.3
11184 setkey_r.3
11185 mtk
11186 Links to encrypt.3.
11187
11188
11189 Changes to individual pages
11190 ---------------------------
11191
11192 clone.2
11193 mtk
11194 Added note that CLONE_STOPPED (which no-one uses anyway) is
11195 now deprecated.
11196
11197 epoll_create.2
11198 mtk
11199 Add NOTES section pointing out that 'size' argument is unused
11200 since kernel 2.6.8.
11201
11202 epoll_ctl.2
11203 mtk
11204 Added portability note to BUGS text for EPOLL_CTL_DEL.
11205
11206 epoll_wait.2
11207 mtk
11208 If the 'sigmask' is NULL, then epoll_pwait() is equivalent
11209 to epoll_wait().
11210
11211 fork.2
11212 mtk
11213 NOTES: since glibc 2.3.3, the glibc NPTL fork() wrapper
11214 bypasses the fork() system call to invoke clone() with
11215 flags providing equivalent functionality.
11216
11217 futex.2
11218 mtk, after a note from Adrian Bunk
11219 FUTEX_FD has been removed, as of kernel 2.6.26.
11220
11221 futimesat.2
11222 mtk
11223 Note that this system call is made obsolete by utimensat(2).
11224
11225 getgroups.2
11226 Petter Reinholdtsen
11227 SEE ALSO: Add getgrouplist(3).
11228 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11229 mtk
11230 NGROUPS_MAX increased in kernel 2.6.4.
11231 SEE ALSO: Add credentials(7).
11232 mtk
11233 Reformat DESCRIPTION and RETURN VALUE sections to be more
11234 consistent with man-pages style.
11235 Add some more detail to descriptions of system calls.
11236 Clarified what happens if caller of getgroups() is a member of
11237 more than 'size' supplementary groups.
11238 ERRORS: Add ENOMEM.
11239
11240 getpriority.2
11241 mtk, after a note from Ingo Molnar
11242 Add text in NOTES about the punchier effect of nice values in
11243 kernel 2.6.23 and later.
11244 Add Documentation/scheduler/sched-nice-design.txt to SEE ALSO list.
11245
11246 gettid.2
11247 mtk
11248 Added VERSIONS section noting that this system call first
11249 appeared in 2.4.11.
11250
11251 kill.2
11252 Marty Leisner / mtk
11253 Add text explicitly noting that sig==0 can be used to check for
11254 the existence of a PID or PGID.
11255 mtk
11256 A few minor rewordings.
11257
11258 mbind.2
11259 mtk
11260 The location of the numactl package has changed.
11261
11262 mmap.2
11263 mtk
11264 Added some .SS headings to make structure of page a little
11265 more obvious.
11266 mtk, with input from Nick Piggin
11267 MAP_POPULATE supports both file and anonymous mappings.
11268 Since 2.6.23, MAP_POPULATE supports private mappings.
11269 Since 2.6.23, MAP_NONBLOCK causes MAP_POPULATE to be a no-op.
11270 mtk
11271 NOTES: Added details on mapping address that is selected by
11272 kernel when MAP_FIXED is / isn't specified.
11273
11274 mount.2
11275 mtk
11276 The MS_REMOUNT changes in 2.4 were at 2.4.10 (not 2.4).
11277 mtk
11278 Minor wording change.
11279
11280 msgctl.2
11281 mtk
11282 Clarify that "unused" fields in msginfo structure are
11283 "unused within the kernel".
11284 msginfo.msgpool is measured in kilobytes, not bytes.
11285 Minor rewordings in comments for msginfo structure.
11286
11287 msgop.2
11288 mtk
11289 Various minor rewordings and restructurings for clarity.
11290 mtk, after a note from Reuben Thomas
11291 Remove "msgop" from NAME section.
11292
11293 mkdir.2
11294 mtk
11295 Clarify meaning of "BSD group semantics".
11296 SEE ALSO: add chown(2).
11297
11298 mknod.2
11299 mtk
11300 SEE ALSO: add chown(2) and chmod(2).
11301
11302 mmap.2
11303 mtk
11304 SEE ALSO: add mprotect(2) and shmat(2).
11305
11306 mprotect.2
11307 Hamaji Shinichiro
11308 SYNOPSIS: s/size_t \*len/size_t len/
11309
11310 open.2
11311 mtk
11312 Note that O_CLOEXEC should be in the next POSIX.1 revision.
11313 mtk
11314 More than just ext2 supports "mount -o bsdgroups" nowadays,
11315 so make the discussion about group ownership of new files a bit
11316 more generic.
11317 mtk
11318 SEE ALSO: add chown(2) and chmod(2).
11319
11320 poll.2
11321 mtk
11322 If the 'sigmask' is NULL, then ppoll() is equivalent to poll()
11323 with respect to signal mask manipulations.
11324
11325 posix_fadvise.2
11326 mtk
11327 s/posix_madvise (2)/posix_madvise (3)/;
11328 (The referred-to page still doesn't exist yet, but hopefully
11329 will do sometime soon.)
11330
11331 ptrace.2
11332 Anoop, Acked by Roland McGrath.
11333 Re PTRACE_PEEKUSER: the offsets and data returned might not
11334 match with the definition of struct user.
11335 See also http://lkml.org/lkml/2008/5/8/375
11336
11337 recv.2
11338 Felix Kater / mtk
11339 Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
11340
11341 rmdir.2
11342 Martin Pitt
11343 POSIX.1 also allows EEXIST for the ENOTEMPTY error condition.
11344 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=467552.
11345
11346 sched_setscheduler.2
11347 mtk, with input from Ingo Molnar
11348 Add description of SCHED_IDLE policy (new in 2.6.23).
11349 Tweak description of SCHED_BATCH.
11350 Minor rewordings.
11351
11352 select_tut.2
11353 Justin Pryzby
11354 Various wording clean-ups.
11355
11356 semctl.2
11357 mtk
11358 Clarify that "unused" fields in seminfo structure are
11359 "unused within the kernel".
11360 Minor rewordings in comments for seminfo structure.
11361
11362 semop.2
11363 Aurelien Gerome
11364 Small fix in example code.
11365
11366 setpgid.2
11367 mtk / Karsten Weiss
11368 Clarify description of setpgid() a little.
11369
11370 shmctl.2
11371 mtk
11372 Clarify that "unused" fields in shminfo structure are
11373 "unused within the kernel".
11374 Minor rewordings in comments for shminfo structure.
11375
11376 shmop.2
11377 mtk, after a note from Reuben Thomas
11378 Remove "shmop" from NAME section.
11379
11380 signalfd.2
11381 mtk
11382 Added BUGS text noting that before kernel 2.6.25, the ssi_int
11383 and ssi_ptr fields are not set.
11384 Added comments describing fields in signalfd_siginfo structure.
11385 Update field names in example program (s/signo/ssi_signo/).
11386 Various small fixes, and remove duplicated sentence.
11387 Minor edits to structure definition.
11388
11389 sigqueue.2
11390 mtk
11391 Added some comments to code in NOTES.
11392
11393 stat.2
11394 mtk
11395 Minor wording change.
11396
11397 symlink.2
11398 mtk
11399 SEE ALSO: add lchown(2).
11400
11401 sync_file_range.2
11402 mtk / Andrew Morton
11403 Remove statement that (SYNC_FILE_RANGE_WAIT_BEFORE |
11404 SYNC_FILE_RANGE_WRITE | SYNC_FILE_RANGE_WAIT_AFTER) is
11405 a traditional fdatasync(2) operation.
11406 See https://bugzilla.mozilla.org/show_bug.cgi?id=421482
11407 comments 129 to 131.
11408
11409 syscalls.2
11410 mtk
11411 This page is now up to date as at kernel 2.6.25.
11412
11413 syslog.2
11414 mtk
11415 Small tidy up of language relating to permissions/capabilities.
11416
11417 timerfd_create.2
11418 mtk
11419 Minor change to example program.
11420 Minor wording change.
11421
11422 utime.2
11423 Reuben Thomas
11424 Remove unnecessary subheading for utimes().
11425 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=477402.
11426 mtk
11427 Change description in NAME line ("or" is not correct: these calls
11428 always change *both* timestamps).
11429 CONFORMING TO: utimes() is in POSIX.1-2001.
11430 mtk
11431 Rename 'buf' argument of utime() to 'times' (like utimes()).
11432 Clarify explanation of EACCES and EPERM errors.
11433 Remove BUGS section, since it doesn't seem to add useful
11434 information.
11435 Clarified discussion of capabilities, and noted that
11436 CAP_DAC_OVERRIDE also has a role.
11437 Other minor rewordings.
11438
11439 wait.2
11440 mtk, after a note by Justin Pryzby
11441 Add a sentence clarifying that even though the default disposition
11442 of SIGCHLD is "ignore", explicitly setting the disposition to
11443 SIG_IGN results in different treatment of zombies.
11444
11445 aio_cancel.3
11446 aio_error.3
11447 aio_fsync.3
11448 aio_read.3
11449 aio_return.3
11450 aio_suspend.3
11451 aio_write.3
11452 Kevin O'Gorman <kogorman@csc.calpoly.edu>
11453 Add "Link with -lrt" to SYNOPSIS.
11454
11455 backtrace.3
11456 Nicolas François
11457 s/backtrace_symbols/backtrace_symbols_fd/ in one sentence.
11458 mtk
11459 Fix bogus reference to variable 'strings': should be:
11460 "the array of pointers".
11461
11462 ctime.3
11463 mtk
11464 Add warning under NOTES that asctime(), ctime(), gmtime(), and
11465 localtime() may each overwrite the static object returned by any
11466 of the other calls.
11467 Other minor edits.
11468
11469 dlopen.3
11470 mtk
11471 Add more detail to the description of the fields in the
11472 structure returned by dladdr().
11473
11474 fexecve.3
11475 mtk
11476 Clean up SYNOPSIS after work by cut-and-paste-Pete:
11477 the necessary header file is <unistd.h> not <sys/time.h>!
11478
11479 futimes.3
11480 mtk
11481 Add documentation of lutimes(), which appeared in glibc 2.6.
11482 mtk
11483 Change description in NAME line ("or" is not correct: these calls
11484 always change *both* timestamps).
11485 CONFORMING TO: futimes() did not come from 4.2BSD. (It came from
11486 FreeBSD; see the FreeBSD man page.)
11487
11488 getenv.3
11489 mtk
11490 Noted that caller must not modify returned value string.
11491 Noted that getenv() is not reentrant: the buffer may be statically
11492 allocated and overwritten by later calls to getenv(), putenv(),
11493 setenv(), or unsetenv().
11494 Other minor rewrites.
11495
11496 getgrent.3
11497 Petter Reinholdtsen
11498 SEE ALSO: Add getgrouplist(3).
11499 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11500
11501 gethostbyname.3
11502 mtk
11503 Add 'h_errno' to NAME list.
11504
11505 getopt.3
11506 mtk
11507 Add 'optarg', 'optind', 'opterr', and 'optopt' to NAME section.
11508 Add subheading for getopt_long() and getopt_long_only()
11509 description.
11510
11511 getpt.3
11512 mtk
11513 Point out that this function should be avoided in favor of
11514 posix_openpt().
11515 Add ERRORS section referring to open(2).
11516
11517 getsubopt.3
11518 Daniel Burr
11519 SYNOPSIS: Fix declaration of valuep.
11520 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476672.
11521
11522 malloc.3
11523 mtk
11524 RETURN VALUE: Note circumstances in which successful malloc() and
11525 calloc() can return NULL.
11526
11527 mq_open.3
11528 mtk, after a note by Marty Leisner
11529 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h>
11530 is needed for 'mode' constants.
11531
11532 opendir.3
11533 mtk
11534 Describe treatment of close-on-exec flag by opendir() and
11535 fdopendir().
11536
11537 openpty.3
11538 mtk
11539 SEE ALSO: add ttyname(3).
11540
11541 raise.3
11542 mtk / Timothy Baldwin
11543 Clarify semantics of raise() when called from a multithreaded
11544 program.
11545 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476484.
11546 mtk
11547 Rewrites and additions to various parts of the page.
11548
11549 rand.3
11550 Tolga Dalman / aeb / mtk
11551 Remove outdated warning in NOTES; encourage the use of
11552 random(3) instead.
11553 Folkert van Heusden
11554 Clarify wording describing range of values returned by rand().
11555
11556 random.3
11557 aeb / mtk / Tolga Dalman
11558 Recommend use or random_r(3) for multithreaded applications
11559 that need independent, reproducible sequences of random numbers.
11560
11561 Move references to "The Art of Computer Programming" and
11562 "Numerical Recipes", formerly in rand(3), to this page.
11563
11564 Add drand48(93) to SEE ALSO list.
11565
11566 regex.3
11567 Heikki Orsila
11568 Clarify description of 'rm_eo' field.
11569
11570 sem_open.3
11571 mtk, after a note by Marty Leisner
11572 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11573 needed for 'mode' constants.
11574
11575 sem_post.3
11576 mtk
11577 Added pointer to example in sem_wait(3).
11578
11579 sem_close.3
11580 sem_destroy.3
11581 sem_getvalue.3
11582 sem_init.3
11583 sem_open.3
11584 sem_post.3
11585 sem_unlink.3
11586 sem_wait.3
11587 mtk, after a note from Marty Leisner
11588 Add text to SYNOPSIS noting the need to link with "-lrt" or
11589 "-pthread".
11590
11591 setenv.3
11592 mtk
11593 setenv() copies 'name' and 'value' (contrast with putenv()).
11594 unsetenv() of a nonexistent variable does nothing and is
11595 considered successful.
11596 Noted that setenv() and unsetenv() need not be reentrant.
11597
11598 shm_open.3
11599 mtk, after a note by Marty Leisner
11600 Note that <fcntl.h> is needed for O_* constants and <sys/stat.h> is
11601 needed for 'mode' constants.
11602
11603 undocumented.3
11604 mtk
11605 initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
11606
11607 utmp.5
11608 Nicolas François
11609 Small rewording.
11610
11611 resolv.conf.5
11612 Nicolas François
11613 gethostname() is in Section 2, not section 3.
11614
11615 ascii.7
11616 Stuart Brady
11617 Fix rendering of ' (backtick) and apostrophe (') in tables
11618
11619 charsets.7
11620 Nicolas François
11621 s/unicode.com/unicode.org/
11622
11623 credentials.7
11624 mtk
11625 NOTES: Pthreads requires that all threads share the same UIDs and
11626 GIDs. But the Linux kernel maintains separate UIDs and GIDs for
11627 every thread. NPTL does some work to ensure that credential
11628 changes by any thread are carried through to all POSIX threads in
11629 a process.
11630 mtk
11631 sysconf(_SC_NGROUPS_MAX) can be used to determine the number of
11632 supplementary groups that a process may belong to.
11633 Clarify that supplementary group IDs are specified in POSIX.1-2001.
11634
11635 epoll.7
11636 mtk, after a note from Sam Varshavchik
11637 For answer A2, change "not recommended" to "careful programming
11638 may be required".
11639
11640 inotify.7
11641 mtk
11642 Document SIGIO feature (new in 2.6.25) for inotify file descriptors.
11643 mtk
11644 Note that select()/poll()/epoll_wait() indicate a ready inotify
11645 file descriptor as readable.
11646 mtk
11647 Document IN_ATTRIB in a little more detail.
11648
11649 pthreads.7
11650 Justin Pryzby
11651 Grammar fix, plus fix typo in script.
11652 mtk
11653 Add list of thread-safe functions.
11654
11655 standards.7
11656 mtk
11657 Add a section on the upcoming POSIX revision.
11658
11659 ld.so.8
11660 Justin Pryzby / mtk
11661 Various wording improvements.
11662
11663
11664 ==================== Changes in man-pages-3.00 ====================
11665
11666 Released: 2008-06-12, Konolfingen
11667
11668
11669 Contributors
11670 ------------
11671
11672 The following people contributed notes, ideas, or patches that have
11673 been incorporated in changes in this release:
11674
11675 Andries Brouwer <Andries.Brouwer@cwi.nl>
11676 Stuart Brady <sdbrady@ntlworld.com>
11677
11678 Apologies if I missed anyone!
11679
11680
11681 Global changes
11682 --------------
11683
11684 The POSIX.1 man pages (sections 0p, 1p, 3p) have been moved out
11685 of this package into the separate man-pages-posix package.
11686 This made sense because those pages are seldom changed (only formatting
11687 fixes, etc.) so that it was unnecessary to redistribute them with each
11688 man-pages release.
11689
11690
11691 console_codes.4
11692 random.4
11693 dir_colors.5
11694 proc.5
11695 glob.7
11696 Stuart Brady
11697 s/`/\`/ for backquotes used in command substitution, for
11698 proper rendering in UTF-8.
11699
11700 Various pages
11701 mtk, after a note from Stuart Brady
11702 Using /'x'/ to denote a character (string) renders poorly in
11703 UTF-8, where the two ' characters render as closing single
11704 quotes. On the other hand, using /`x'/ renders nicely on UTF-8,
11705 where proper opening and closing single quotes are produced by
11706 groff(1), but looks ugly when rendered in ASCII. Using the
11707 sequence /\\aqx\\aq/ produces a reasonable rendering ('\\aq'
11708 is a vertical "apostrophe quote") in both UTF-8 and ASCII.
11709 So that change is made in a number of pages.
11710 See also http://www.cl.cal.ac.uk/~mgk25/ucs/quotes.html.
11711
11712 Various pages
11713 mtk
11714 Replace form /`string'/ by /"string"/, since the former renders
11715 poorly in ASCII.
11716
11717 termios.3
11718 console_codes.4
11719 tty_ioctl.4
11720 termcap.5
11721 charsets.7
11722 mtk
11723 Control character names (^X) are written boldface, without
11724 quotes.
11725
11726 printf.3
11727 scanf.3
11728 proc.5
11729 glob.7
11730 regex.7
11731 mtk
11732 Various edits to try and bring some consistency to the use of
11733 quotes.
11734
11735
11736 Changes to individual pages
11737 ---------------------------
11738
11739 tty_ioctl.4
11740 mtk
11741 Small rewordings in description of packet mode.
11742
11743 locale.7
11744 mtk
11745 Minor formatting fixes.
11746
11747
11748 ==================== Changes in man-pages-3.01 ====================
11749
11750 Released: 2008-06-25, Munich
11751
11752
11753 Contributors
11754 ------------
11755
11756 The following people contributed notes, ideas, or patches that have
11757 been incorporated in changes in this release:
11758
11759 Alain Portal <aportal@univ-montp2.fr>
11760 Andreas Herrmann <andreas.herrmann3@amd.comm>
11761 Andrew P <ap@zip.com.au>
11762 Andrew Clayton <andrew@digital-domain.net>
11763 Bart Van Assche <bart.vanassche@gmail.com>
11764 Christian Borntraeger <borntraeger@de.ib.com>
11765 Christoph Hellwig <hch@infradead.org>
11766 Daniele Giacomini <appunti2@gmail.com>
11767 Dorin Lazar <dorin.lazar@gmail.com>
11768 George Spelvin <linux@horizon.com>
11769 Jason Englander <jason@englanders.cc>
11770 Jeff Moyer <jmoyer@redhat.com>
11771 Laurent Vivier <laurent.vivier@bull.net>
11772 Masatake YAMOTO <yamoto@redhat.com>
11773 Matt Mackall <mpm@selenic.com>
11774 Neil Horman <nhorman@tuxdriver.com>
11775 Pavel Machek <pavel@suse.cz>
11776 Peter Zijlstra <a.p.zijlstra@chello.nl>
11777 Petr Baudis <pasky@suse.cz>
11778 Petr Gajdos <pgajdos@suse.cz>
11779 Roman Zippel <zippel@linux-m68k.org>
11780 Sam Varshavchik <mrsam@courier-mta.com>
11781 Samuel Thibault <samuel.thibault@ens-lyon.org>
11782 Stephane Chazelas <stephane_chazelas@yahoo.fr>
11783 Stuart Cunningham <stuartc@rd.bbc.co.uk>
11784 Thomas Gleixner <tglx@linutronix.de>
11785 Tolga Dalman <tdalman@project-psi.org>
11786 Yao Zhao <dragonlinux@gmail.com>
11787 WANG Cong <wcong@critical-links.com>
11788
11789 Apologies if I missed anyone!
11790
11791
11792 New and rewritten pages
11793 -----------------------
11794
11795 acct.5
11796 mtk
11797 A complete rewrite of this page, now with much more detail.
11798
11799 hostname.7
11800 mtk
11801 A description of hostname resolution. Taken from FreeBSD 6.2,
11802 and lightly edited for man-pages style.
11803
11804 symlink.7
11805 mtk
11806 A description of symbolic links. Taken from FreeBSD 6.2, but
11807 heavily edited for Linux details, improved readability, and
11808 man-pages style.
11809
11810
11811 Newly documented interfaces in existing pages
11812 ---------------------------------------------
11813
11814 getrlimit.2
11815 mtk / Peter Zijlstra
11816 Add description of RLIMIT_RTTIME limit, new in 2.6.25.
11817
11818 mkstemp.3
11819 mtk
11820 Add description of mkostemp(), new in glibc 2.7.
11821
11822 core.5
11823 mtk, after a note by Petr Gajdos; review by Neil Horman
11824 Document core_pattern pipe syntax, which appeared in
11825 kernel 2.6.19.
11826 Add an example program demonstrating use of core_pattern
11827 pipe syntax.
11828 mtk
11829 Document /proc/PID/coredump_filter, new in kernel 2.6.23.
11830 Documentation was based on the text in
11831 Documentation/filesystems/proc.txt, plus testing, and
11832 checking the kernel source.
11833
11834 proc.5
11835 mtk
11836 Document /proc/PID/oom_score, which was new in kernel 2.6.11.
11837 This file displays the "badness" score of the process, which
11838 provides the basis for OOM-killer decisions.
11839 mtk
11840 Document /proc/PID/oom_adj, which was new in kernel 2.6.11.
11841 This file influences the oom_score of a process.
11842 mtk
11843 Document /proc/PID/limits, which was new in 2.6.24.
11844 This file displays a process's resource limits.
11845 mtk
11846 Document /proc/PID/fdinfo/*, which was new in 2.6.22.
11847 These files display info about each descriptor opened by the
11848 process: the current file offset, and the file access mode +
11849 file status flags as set in open() or fcntl(F_SETFL).
11850 mtk
11851 Document /proc/PID/mountinfo, which was new in 2.6.26.
11852 This file displays information about mount points.
11853 Closely based on text from Documentation/filesystems/proc.txt.
11854 mtk
11855 Document /proc/PID/mountstats, which was new in 2.6.17.
11856 This file displays statistics about mount points.
11857 mtk
11858 Document /proc/PID/status.
11859 Samuel Thibault / mtk, review by Laurent Vivier,
11860 Christian Borntraeger, and Andrew P
11861 Document guest (virtual CPU) time field in /proc/stat.
11862 Document guest (virtual CPU) time fields in /proc/PID/stat.
11863
11864
11865 New links
11866 ---------
11867
11868 mkostemp.3
11869 mtk
11870 Link to mkstemp.3.
11871
11872 getcwd.2
11873 mtk
11874 Link to getcwd.3, which describes several interfaces, among
11875 them getcwd(), which is in fact a system call.
11876
11877
11878 Global changes
11879 --------------
11880
11881 sched_setaffinity.2
11882 sched_setscheduler.2
11883 set_mempolicy.2
11884 mbind.2
11885 mtk
11886 SEE ALSO: Add cpuset(7).
11887
11888 chown.2
11889 faccessat.2
11890 fchmodat.2
11891 fchownat.2
11892 fstatat.2
11893 getxattr.2
11894 link.2
11895 linkat.2
11896 listxattr.2
11897 open.2
11898 readlink.2
11899 removexattr.2
11900 rename.2
11901 setxattr.2
11902 stat.2
11903 symlink.2
11904 symlinkat.2
11905 unlink.2
11906 futimes.3
11907 remove.3
11908 path_resolution.7
11909 mtk
11910 SEE ALSO: Add symlink(7).
11911
11912 intro.1
11913 time.1
11914 fcntl.2
11915 gethostbyname.3
11916 ioctl_list.2
11917 mtk
11918 Wrap source lines so that new sentence starts on new line.
11919
11920 addseverity.3
11921 backtrace.3
11922 dlopen.3
11923 fmtmsg.3
11924 getnameinfo.3
11925 getpt.3
11926 grantpt.3
11927 makecontext.3
11928 ptsname.3
11929 tcgetsid.3
11930 unlockpt.3
11931 wordexp.3
11932 mtk
11933 Added VERSIONS section.
11934
11935 msgctl.2
11936 msgget.2
11937 semget.2
11938 semop.2
11939 pciconfig_read.2
11940 basename.3
11941 cmsg.3
11942 ftok.3
11943 console_ioctl.4
11944 tzfile.5
11945 mq_overview.7
11946 pty.7
11947 mtk
11948 For consistency, "fix" cases where argument of .B or .I was
11949 on the following source line.
11950
11951 adjtimex.2
11952 getrusage.2
11953 io_getevents.2
11954 poll.2
11955 select.2
11956 semop.2
11957 sigwaitinfo.2
11958 aio_suspend.3
11959 clock_getres.3
11960 mq_receive.3
11961 mq_send.3
11962 sem_wait.3
11963 proc.5
11964 mtk
11965 SEE ALSO: add time(7)
11966
11967 Typographical or grammatical errors have been corrected in several places.
11968 (Special thanks to Nicolas François and Alain Portal.)
11969
11970
11971 Changes to individual pages
11972 ---------------------------
11973
11974 acct.2
11975 mtk
11976 Add a few more words to DESCRIPTION.
11977 NOTES: Add pointer to acct(5).
11978
11979 alarm.2
11980 Alain Portal
11981 s/process/calling process/ so as to say that the alarm signal is
11982 delivered to the calling process.
11983
11984 brk.2
11985 Yao Zhao / mtk
11986 Clarify discussion of return value of sbrk().
11987 mtk
11988 DESCRIPTION: Add some sentences giving an overview of these
11989 interfaces.
11990 Add note recommending use of malloc(3).
11991 Change name of brk() argument to the simpler 'addr'.
11992 Add "(void *)" cast to "-1" for error return of sbrk().
11993 Removed some incorrect text about "brk(0)".
11994 Note that SUSv2 specified the return value of sbrk().
11995 Added a detail on the glibc brk() wrapper.
11996 Remove discussions of old standards (C89 and POSIX.1-1990);
11997 CONFORMING TO already discusses the situation with respect
11998 to more recent standards.
11999
12000 chmod.2
12001 mtk
12002 Clarify description of chmod() and fchmod().
12003 Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions.
12004 Reformat list of permissions bits.
12005
12006 chown.2
12007 mtk
12008 Describe rules governing ownership of new files (bsdgroups
12009 versus sysvgroups, and the effect of the parent directory's
12010 set-group-ID permission bit).
12011
12012 chroot.2
12013 Alain Portal
12014 Clarify description a little.
12015 s/changes the root directory/
12016 changes the root directory of the calling process/
12017
12018 execve.2
12019 mtk
12020 Fix text that warns against use of NULL argv and envp.
12021 Using a NULL envp does in fact seem to be portable (works
12022 on Solaris and FreeBSD), but the Linux semantics for a NULL
12023 argv certainly aren't consistent with other implementations.
12024 See http://bugzilla.kernel.org/show_bug.cgi?id=8408.
12025
12026 getdents.2
12027 mtk, after a note from George Spelvin
12028 Document d_type field, present since kernel 2.6.4.
12029 Other minor edits.
12030
12031 getitimer.2
12032 mtk
12033 Noted that POSIX.1 leaves interactions with alarm(), sleep(),
12034 and usleep() unspecified.
12035 Linux 2.6.16 removed the MAX_SEC_IN_JIFFIES ceiling on timer
12036 values.
12037 Other minor changes.
12038
12039 io_cancel.2
12040 io_destroy.2
12041 io_getevents.2
12042 io_setup.2
12043 io_submit.2
12044 mtk, after a note by Masatake YAMOTO and input from Jeff Moyer
12045 Describe the unconventional error return provided by the
12046 wrapper function in libaio (and contrast with behavior if
12047 the system call is invoked via syscall(2)).
12048 See http://thread.gmane.org/gmane.linux.ltp/4445/
12049 Alain Portal / mtk
12050 Re-order ERRORS and SEE ALSO entries to be alphabetical.
12051
12052 io_getevents.2
12053 Alain Portal
12054 Small wording fix.
12055
12056 io_submit.2
12057 Jeff Moyer
12058 s/AIO request blocks/AIO control blocks/
12059
12060 mknod.2
12061 mtk
12062 Note that EEXIST applies, even if the pathname is a
12063 (possibly dangling) symbolic link.
12064
12065 nanosleep.2
12066 mtk, after a report from Stephane Chazelas
12067 Remove crufty discussion of HZ, and replace with a pointer
12068 to time(7).
12069 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=485636
12070 mtk, after some discussions with Bart Van Assche and Roman Zippel
12071 NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP
12072 See also http://thread.gmane.org/gmane.linux.kernel/696854/
12073 "nanosleep() uses CLOCK_MONOTONIC, should be CLOCK_REALTIME?"
12074 mtk
12075 Replace mentions of "process' by "thread".
12076 NOTES: describe case where clock_nanosleep() can be preferable.
12077 Some minor rewrites.
12078
12079 open.2
12080 mtk, after a note from Christoph Hellwig
12081 NOTES: Note that access mode flags are not single bits,
12082 and document the Linuxism "access mode 3".
12083 See also http://thread.gmane.org/gmane.linux.kernel/653123.
12084
12085 readdir.2
12086 mtk
12087 Minor wording fixes.
12088
12089 recv.2
12090 Alain Portal
12091 Add comment to 'ee_pad' field in structure definition.
12092
12093 sched_setscheduler.2
12094 mtk
12095 Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2.
12096 mtk, after a note by Andrew Clayton
12097 Rewrote and restructured various parts of the page for greater
12098 clarity.
12099 mtk
12100 Add more detail to the rules that are applied when an
12101 unprivileged process with a non-zero RLIMIT_RTPRIO limit
12102 changes policy and priority.
12103 SEE ALSO: Add Documentation/scheduler/sched-rt-group.txt
12104
12105 sync_file_range.2
12106 Pavel Machek
12107 SYNC_FILE_RANGE_WRITE can block on writes greater than request
12108 queue size. For some background, see
12109 http://thread.gmane.org/gmane.linux.kernel/687713/focus=688340
12110
12111 syscalls.2
12112 mtk
12113 Added system call history back to version 1.2.
12114 Fix typo on kernel version for pivot_root().
12115
12116 syslog.2
12117 WANG Cong
12118 Document ENOSYS error, which can occur if kernel was built without
12119 CONFIG_PRINTK.
12120
12121 utime.2
12122 Nicolas François
12123 Clarify description of 'times' array for utimes().
12124
12125 adjtime.3
12126 mtk
12127 The longstanding bug that if delta was NULL, olddelta
12128 didn't return the outstanding clock adjustment, is now fixed
12129 (since glibc 2.8 + kernel 2.6.26).
12130 http://sourceware.org/bugzilla/show_bug?id=2449
12131 http://bugzilla.kernel.org/show_bug.cgi?id=6761
12132
12133 dprintf.3
12134 mtk
12135 Note that these functions are included in the next POSIX revision.
12136 Remove editorial discussion about what the functions should have
12137 been named.
12138
12139 ftime.3
12140 mtk
12141 Rewrote various pieces, and added some details.
12142
12143 getaddrinfo.3
12144 mtk
12145 Improve description or 'hints' and 'res' arguments.
12146 Add details on numeric strings that can be specified for 'node'.
12147 Other fairly major restructurings and rewrites to improve
12148 logical structure and clarity of the page.
12149 SEE ALSO: Add hostname(7).
12150
12151 gethostbyname.3
12152 mtk
12153 DESCRIPTION: Add reference to inet_addr(3) for dotted notation.
12154 SEE ALSO: add inet(3).
12155 mtk
12156 Added BUGS section noting that gethostbyname() does not
12157 recognize hexadecimal components in dotted address strings;
12158 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973
12159
12160 getmntent.3
12161 mtk, after Stuart Cunningham pointed out the typo
12162 Remove statement that LSB deprecates the functions
12163 "endmntent(), setmntent() [sic] and setmntent()".
12164 This doesn't seem to be true (I can't find mention of it
12165 being deprecated in any of the LSB specs). Rather, LSB simply
12166 doesn't specify these functions. (LSB 1.3 had a spec of
12167 setmntent(), but not getmntent() or endmntent(), and noted
12168 that having a spec of setmntent() was of little use without
12169 also having a spec of getmntent().)
12170 See also https://lists.linux-foundation.org/pipermail/lsb-discuss/2006-October/003078.html
12171
12172 getnameinfo.3
12173 Tolga Dalman
12174 Remove mention of sa_len field from example code.
12175 That field is a BSDism not present on Linux.
12176 mtk
12177 Various minor changes.
12178
12179 inet.3
12180 mtk / Stephane Chazelas
12181 inet_aton() is *not* in POSIX.1.
12182 Rewrote discussion of why inet_addr() is disfavored.
12183 SEE ALSO: Add getaddrinfo(3).
12184 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979.
12185 mtk, after a note by Stephane Chazelas
12186 Describe the various address forms supported by inet_aton().
12187 mtk
12188 Rewrite description of inet_network().
12189 Clarify discussion of inet_lnaof(), inet_netof(), and inet_makeaddr().
12190 Add discussion of Classful Addressing, noting that it is obsolete.
12191 Added an EXAMPLE program.
12192 mtk
12193 Relocate discussion of i386 byte order to NOTES.
12194 Note that inet_aton() returns an address in network byte order.
12195 SEE ALSO: Add byteorder(3) and getnameinfo(3).
12196
12197 inet_ntop.3
12198 mtk
12199 Remove unneeded header files from SYNOPSIS.
12200 SEE ALSO: Add inet(3) and getnameinfo(3).
12201 Make NAME line more precise.
12202 Move errors to an ERRORS section.
12203 Add EXAMPLE section pointing to inet_pton(3).
12204
12205 inet_pton.3
12206 mtk / Stephane Chazelas
12207 Remove statement that inet_pton() extends inet_ntoa();
12208 that's not really true, since inet_pton() doesn't support
12209 all of the string forms that are supported by inet_ntoa().
12210 SEE ALSO: Add getaddrinfo(3).
12211 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987.
12212 mtk
12213 Describe IPv6 address formats.
12214 Describe dotted decimal format in more detail.
12215 Add an example program.
12216 mtk
12217 Remove unneeded header files from SYNOPSIS.
12218 Make NAME line more precise.
12219 Make description of return value more precise.
12220 SEE ALSO: Add inet(3).
12221
12222 mkfifo.3
12223 mtk
12224 Note that EEXIST applies, even if the pathname is a
12225 (possibly dangling) symbolic link.
12226
12227 mkstemp.3
12228 mtk
12229 Fix discussion of O_EXCL flag.
12230 These functions may also fail for any of the errors described
12231 in open(2).
12232 Various other rewordings.
12233
12234 readdir.3
12235 mtk
12236 Document DT_LNK (symbolic link) for d_type field.
12237 Reorder DT_ entries alphabetically.
12238
12239 remainder.3
12240 mtk
12241 Recommend against drem(), in favor of remainder().
12242
12243 scanf.3
12244 mtk, after a note from Stephane Chazelas
12245 Add an ERRORS section documenting at least some of the errors
12246 that may occur for scanf().
12247 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12248 mtk, after a note from Stephane Chazelas; review by Stephane Chazelas
12249 Document the GNU 'a' modifier for dynamically allocating strings.
12250 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=487254.
12251 Document the GNU 'm' modifier for dynamically allocating strings.
12252
12253 strcat.3
12254 Andreas Herrmann
12255 s/strcat/strncat/ (a typo that changed the semantics in
12256 DESCRIPTION).
12257
12258 strerror.3
12259 mtk, after a note from Daniele Giacomini
12260 Modify SYNOPSIS to show prototypes of both versions of strerror_r(),
12261 and make other small clarifications of the description regarding
12262 the two versions.
12263
12264 random.4
12265 George Spelvin (taking time out from his busy Broadway schedule),
12266 with some tweaks by Matt Mackall and mtk
12267 Add a Usage subsection that recommends most users to use
12268 /dev/urandom, and emphasizes parsimonious usage of
12269 /dev/random.
12270
12271 locale.5
12272 Petr Baudis <pasky@suse.cz>
12273 LC_TIME: Describe first_weekday and first_workday.
12274
12275 proc.5
12276 mtk
12277 The various CPU time fields in /proc/stat and /proc/PID/stat
12278 return time in clock ticks (USER_HZ, cputime_to_clock_t(),
12279 sysconf(_SC_CLK_TCK)).
12280 Updated, clarified and expanded the description several
12281 fields in /proc/[number]/stat.
12282 mtk
12283 Clarified and expanded the description of /proc/[number]/fd.
12284 mtk
12285 Updated and clarified the description of /proc/[number]/statm.
12286 mtk
12287 Updated and clarified the description of /proc/sys/fs/dentry-state.
12288 mtk
12289 Many formatting, wording, and grammar fixes.
12290
12291 man-pages.7
12292 mtk
12293 Enhanced description of VERSIONS section.
12294
12295 mq_overview.7
12296 mtk
12297 Note that Linux does not currently support ACLs for POSIX
12298 message queues.
12299
12300 sem_overview.7
12301 mtk
12302 Note that Linux supports ACLs on POSIX named semaphores
12303 since 2.6.19.
12304
12305 time.7
12306 mtk, with some suggestions from Bart Van Assche and Thomas Gleixner
12307 Added some details about where jiffies come into play.
12308 Added section on high-resolution timers.
12309 Mentioned a few other time-related interfaces at various
12310 points in the page.
12311 See http://thread.gmane.org/gmane.linux.kernel/697378.
12312
12313 unix.7
12314 mtk, after a note by Samuel Thibault
12315 Provide a clear description of the three types of address that
12316 can appear in the sockaddr_un structure: pathname, unnamed,
12317 and abstract.
12318
12319
12320 ==================== Changes in man-pages-3.02 ====================
12321
12322 Released: 2008-07-02, Konolfingen
12323
12324
12325 Contributors
12326 ------------
12327
12328 The following people contributed notes, ideas, or patches that have
12329 been incorporated in changes in this release:
12330
12331 Alain Portal <aportal@univ-montp2.fr>
12332 Andries Brouwer <Andries.Brouwer@cwi.nl>
12333 Reuben Thomas <rrt@sc3d.org>
12334 Sam Varshavchik <mrsam@courier-mta.com>
12335 Stephane Chazelas <stephane_chazelas@yahoo.fr>
12336 WANG Cong <xiyou.wangcong@gmail.com>
12337
12338 Apologies if I missed anyone!
12339
12340
12341 New and rewritten pages
12342 -----------------------
12343
12344 clock_nanosleep.2
12345 mtk
12346 A description of the clock_nanosleep() system call,
12347 which was added in kernel 2.6.
12348
12349 getgrouplist.3
12350 mtk
12351 A near complete rewrite, including additional information and
12352 a new example program.
12353
12354 getutmp.3
12355 mtk
12356 Documents getutmp(3) and getutmpx(3).
12357
12358 gnu_get_libc_version.3
12359 mtk
12360 Documents gnu_get_libc_version(3) and gnu_get_libc_release(3).
12361
12362 sigwait.3
12363 mtk
12364 Documents sigwait(3).
12365
12366 shm_overview.7
12367 mtk
12368 An overview of the POSIX shared memory API.
12369
12370
12371 Newly documented interfaces in existing pages
12372 ---------------------------------------------
12373
12374 updwtmp.3
12375 mtk
12376 Document updwtmpx(3).
12377
12378
12379 New links
12380 ---------
12381
12382 getutmpx.3
12383 mtk
12384 Link to getutmp.3.
12385
12386 gnu_get_libc_release.3
12387 mtk
12388 Link to gnu_get_libc_version.3
12389
12390 updwtmpx.3
12391 mtk
12392 Link to updwtmp.3
12393
12394 utmpxname.3
12395 mtk
12396 Link to getutent.3.
12397
12398 utmpx.5
12399 mtk
12400 Link to utmp.5.
12401
12402
12403 Global changes
12404 --------------
12405
12406 Various pages
12407 mtk
12408 s/user name/username/
12409
12410 Various pages
12411 mtk
12412 s/host name/hostname/
12413
12414
12415 Changes to individual pages
12416 ---------------------------
12417
12418 fchmodat.2
12419 Alain Portal
12420 SEE ALSO: add symlink.7. (3.01 changelog wrongly said this
12421 had been done.)
12422
12423 io_setup.2
12424 Alain Portal
12425 Remove superfluous text from RETURN VALUE.
12426
12427 mmap.2
12428 mtk
12429 SEE ALSO: Add mmap(2), shm_overview(7).
12430
12431 shmget.2
12432 shmop.2
12433 mtk
12434 SEE ALSO: add shm_overview(7).
12435
12436 sigreturn.2
12437 mtk
12438 Added a bit more detail on what sigreturn() actually does.
12439
12440 signalfd.2
12441 sigsuspend.2
12442 mtk
12443 SEE ALSO: Add sigwait(3).
12444
12445 sigwaitinfo.2
12446 mtk
12447 Describe behavior when multiple threads are blocked in
12448 sigwaitinfo()/sigtimedwait().
12449 SEE ALSO: Add sigwait(3).
12450
12451 dirfd.3
12452 mtk
12453 RETURN VALUE: describe return value on success.
12454 Add an ERRORS section documenting POSIX.1-specified errors.
12455
12456 getaddrinfo.3
12457 mtk, after a note by Stephane Chazelas
12458 getaddrinfo() supports specifying IPv6 scope-IDs.
12459
12460 getlogin.3
12461 mtk
12462 ERRORS: add ENOTTY.
12463 SEE ALSO: add utmp(5).
12464
12465 getutent.3
12466 WANG Cong
12467 utmpname() does return a value.
12468 mtk
12469 Add paragraph to start of DESCRIPTION recommending
12470 use of POSIX.1 "utmpx" functions.
12471 CONFORMING TO: mention utmpxname().
12472 Add an ERRORS section.
12473 There are no utmpx equivalents of the _r reentrant functions.
12474 Clarify discussion of return values.
12475 Add pointer to definition of utmp structure in utmp(5).
12476 Clarify discussion of utmpx file on other systems (versus
12477 Linux situation).
12478
12479 getutent.3
12480 mtk
12481 SEE ALSO: add getutmp(3)
12482
12483 inet_pton.3
12484 Stephane Chazelas
12485 Fix error in description of IPv6 presentation format:
12486 s/x.x.x.x.x.x.x.x/x:x:x:x:x:x:x:x/.
12487
12488 setbuf.3
12489 Reuben Thomas / mtk
12490 Fix confused wording for return value of setvbuf().
12491 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=488104.
12492 mtk
12493 Other minor rewordings.
12494
12495 shm_open.3
12496 mtk
12497 SEE ALSO: add shm_overview(7).
12498
12499 random.4
12500 mtk, after a note by Alain Portal
12501 Slight rewording to make life easier for non-native English
12502 speakers.
12503
12504 utmp.5
12505 mtk
12506 Add discussion of POSIX.1 utmpx specification.
12507 Provide a little more detail on fields of utmp structure.
12508 Added comments to macros for ut_type field.
12509 Correct the description of the ut_id field.
12510 mtk
12511 Consolidate duplicated information about ut_tv and ut_session
12512 on biarch platforms.
12513 mtk
12514 Move some text from CONFORMING TO to NOTES.
12515 Removed some crufty text.
12516 SEE ALSO: add login(3), logout(3), logwtmp(3).
12517 UT_LINESIZE is 32 (not 12).
12518 mtk
12519 SEE ALSO: add getutmp(3)
12520
12521 man-pages.7
12522 mtk
12523 Enhanced the discussion of font conventions.
12524
12525 signal.7
12526 mtk
12527 Note that the delivery order of multiple pending standard
12528 signals is unspecified.
12529 SEE ALSO: Add sigwait(3).
12530
12531
12532 ==================== Changes in man-pages-3.03 ====================
12533
12534 Released: 2008-07-08, Konolfingen
12535
12536
12537 Contributors
12538 ------------
12539
12540 The following people contributed notes, ideas, or patches that have
12541 been incorporated in changes in this release:
12542
12543 Alain Portal <aportal@univ-montp2.fr>
12544 Andi Kleen <ak@muc.de>
12545 Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
12546 Li Zefan <lizf@cn.fujitsu.com>
12547 Paul Jackson <pj@sgi.com>
12548 Sam Varshavchik <mrsam@courier-mta.com>
12549
12550 Apologies if I missed anyone!
12551
12552
12553 New and rewritten pages
12554 -----------------------
12555
12556 getcpu.2
12557 Andi Kleen, with some text and edits by mtk
12558 Documents the getcpu(2) system call, introduced in Linux 2.6.19.
12559
12560 sched_getcpu.3
12561 mtk
12562 Documents sched_getcpu(3), a wrapper for getcpu(2), provided
12563 since glibc 2.6.
12564
12565 cpuset.7
12566 Paul Jackson, with review and editing by mtk, and comments by
12567 Hidetoshi Seto and Li Zefan
12568 A description of the cpuset file system, the mechanism introduced
12569 kernel 2.6.12 for confining processes to designated processors
12570 and nodes. (Becomes the fourth largest page in man-pages!)
12571
12572
12573 Newly documented interfaces in existing pages
12574 ---------------------------------------------
12575
12576 readdir.3
12577 mtk
12578 Add documentation of readdir_r().
12579
12580
12581 New links
12582 ---------
12583
12584 updwtmpx.3
12585 Alain Portal
12586 Link to updwtmp.3 (3.02 changelog wrongly said this had been done).
12587
12588 readdir_r.3
12589 mtk
12590 Link to readdir.3.
12591
12592
12593 Global changes
12594 --------------
12595
12596 get_mempolicy.2
12597 mbind.2
12598 sched_setaffinity.2
12599 set_mempolicy.2
12600 mtk
12601 SEE ALSO: Add getcpu(2).
12602
12603 accept.2
12604 close.2
12605 connect.2
12606 dup.2
12607 epoll_wait.2
12608 fcntl.2
12609 flock.2
12610 futex.2
12611 msgop.2
12612 poll.2
12613 read.2
12614 recv.2
12615 select.2
12616 semop.2
12617 send.2
12618 sigwaitinfo.2
12619 spu_run.2
12620 wait.2
12621 write.2
12622 aio_suspend.3
12623 mq_receive.3
12624 mq_send.3
12625 scanf.3
12626 sem_wait.3
12627 usleep.3
12628 inotify.7
12629 mtk
12630 ERRORS: Added reference to signal(7) in discussion of EINTR.
12631
12632 Various pages
12633 mtk
12634 Wrapped very long source lines.
12635
12636
12637 Changes to individual pages
12638 ---------------------------
12639
12640 accept.2
12641 mtk
12642 Small wording change.
12643
12644 io_getevents.2
12645 mtk
12646 ERRORS: Add EINTR error.
12647
12648 open.2
12649 mtk
12650 ERRORS: Add EINTR error.
12651
12652 sigaction.2
12653 mtk
12654 Note circumstances in which each SA_* flag is meaningful.
12655 mtk
12656 Describe POSIX specification, and Linux semantics for
12657 SA_NOCLDWAIT when establishing a handler for SIGCHLD.
12658 mtk
12659 Add pointer under SA_RESTART to new text in signal(7)
12660 describing system call restarting.
12661 mtk
12662 Other minor edits.
12663
12664 truncate.2
12665 mtk
12666 ERRORS: Added EINTR error.
12667 A few minor rewordings.
12668
12669 wait.2
12670 mtk
12671 Remove statement that WUNTRACED and WCONTINUED only have effect
12672 if SA_NOCLDSTOP has not been set for SIGCHLD. That's not true.
12673
12674 errno.3
12675 mtk
12676 Add a pointer to signal(7) for further explanation of EINTR.
12677
12678 getgrouplist.3
12679 mtk
12680 SEE ALSO: Add passwd(5).
12681
12682 readdir.3
12683 mtk
12684 Remove <sys/types.h> from SYNOPSIS; POSIX.1-2001 does not
12685 require it.
12686 Some minor rewordings.
12687
12688 sleep.3
12689 mtk
12690 RETURN VALUE: explicitly mention interruption by signal handler.
12691 SEE ALSO: add signal(7).
12692
12693 usleep.3
12694 mtk
12695 POSIX.1-2001 also only documents EINVAL.
12696
12697 group.5
12698 mtk
12699 SEE ALSO: Add getgrent(3), getgrnam(3).
12700
12701 passwd.5
12702 mtk
12703 SEE ALSO: Add getpwent(3), getpwnam(3).
12704
12705 proc.5
12706 mtk
12707 Add pointer to description of /proc/PID/cpuset in cpuset(7).
12708
12709 signal.7
12710 mtk
12711 Add a section describing system call restarting, and noting
12712 which system calls are affected by SA_RESTART, and which
12713 system calls are never restarted.
12714 mtk
12715 Describe the aberrant Linux behavior whereby a stop signal
12716 plus SIGCONT can interrupt some system calls, even if no
12717 signal handler has been established, and note the system
12718 calls that behave this way.
12719 mtk
12720 Note a few more architectures on which signal numbers are valid.
12721 SEE ALSO: added a number of pages.
12722 mtk
12723 Update async-signal-safe function list for POSIX.1-2004 (which
12724 adds sockatmark()).
12725
12726
12727 ==================== Changes in man-pages-3.04 ====================
12728
12729 Released: 2008-07-15, Konolfingen
12730
12731
12732 Contributors
12733 ------------
12734
12735 The following people contributed notes, ideas, or patches that have
12736 been incorporated in changes in this release:
12737
12738 Alain Portal <aportal@univ-montp2.fr>
12739 Andrea Arcangeli <andrea@cpushare.com>
12740 Andreas Mohr <andi@lisas.de>
12741 Andrew Morgan <morgan@kernel.org>
12742 Erik Bosman <ejbosman@cs.vu.nl>
12743 John Brooks <aspecialj@gmail.com>
12744 Nikanth Karthikesan <knikanth@suse.de>
12745 Pavel Heimlich <tropikhajma@seznam.cz>
12746 Petr Gajdos <pgajdos@suse.cz>
12747 Sam Varshavchik <mrsam@courier-mta.com>
12748 Serge Hallyn <serue@us.ibm.com>
12749 Sripathi Kodi <sripathik@in.ibm.com>
12750 Vincent Lefevre <vincent@vinc17.org>
12751
12752 Apologies if I missed anyone!
12753
12754
12755 Web site
12756 --------
12757
12758 licenses.html
12759 mtk
12760 A page describing the preferred licenses for new pages that
12761 are contributed to man-pages.
12762
12763
12764 New and rewritten pages
12765 -----------------------
12766
12767 utimensat.2
12768 mtk
12769 New page documenting the utimensat() system call, new in 2.6.22,
12770 and futimens() library function.
12771
12772 end.3
12773 mtk
12774 Documents etext, edata, and end symbols.
12775
12776
12777 Newly documented interfaces in existing pages
12778 ---------------------------------------------
12779
12780 memchr.3
12781 mtk
12782 Add description of rawmemchr().
12783
12784 proc.5
12785 mtk
12786 Document /proc/config.gz (new in kernel 2.6).
12787 mtk, based on text from Documentation/vm/sysctl.txt
12788 Document /proc/sys/vm/oom_kill_allocating_task
12789 (new in Linux 2.6.24).
12790 Document /proc/sys/vm/oom_dump_tasks
12791 (new in Linux 2.6.25).
12792 Document /proc/sys/vm/panic_on_oom
12793 (new in Linux 2.6.18).
12794
12795
12796 New links
12797 ---------
12798
12799 edata.3
12800 etext.3
12801 mtk
12802 Links to end.3.
12803
12804 futimens.3
12805 mtk
12806 Link to new utimensat.2.
12807
12808 getdate_err.3
12809 mtk
12810 Link to getdate.3.
12811
12812 h_errno.3
12813 mtk
12814 Link to gethostbyname.3.
12815
12816 optarg.3
12817 opterr.3
12818 optind.3
12819 optopt.3
12820 mtk
12821 Links to getopt.3.
12822
12823 rawmemchr.3
12824 mtk
12825 Link to memchr.3.
12826
12827 sys_errlist.3
12828 sys_nerr.3
12829 mtk
12830 Links to perror.3.
12831
12832
12833 Global changes
12834 --------------
12835
12836 Various pages
12837 mtk
12838 s/parameter/argument/ when talking about the things given
12839 to a function call, for consistency with majority usage.
12840
12841 Various pages
12842 mtk
12843 s/UNIX/Unix/, when not used as part of a trademark,
12844 for consistency with majority usage in pages.
12845
12846 Various pages
12847 mtk, after a note from Alain Portal
12848 Put SEE ALSO entries into alphabetical order.
12849
12850 Various pages
12851 mtk
12852 Remove period at end of SEE ALSO list.
12853
12854 Various pages
12855 mtk, after a note by Alain Portal
12856 Even when the CONFORMING TO section is just a list of standards,
12857 they should be terminated by a period.
12858
12859 getpriority.2
12860 MB_LEN_MAX.3
12861 MB_CUR_MAX.3
12862 fwide.3
12863 mblen.3
12864 rtime.3
12865 st.4
12866 proc.5
12867 bootparam.7
12868 man-pages.7
12869 utf-8.7
12870 tcp.5
12871 mtk / Alain Portal
12872 Small wording fixes -- express <=, <, >=, > in words when in
12873 running text.
12874
12875 sched_setparam.2
12876 sched_setscheduler.2
12877 getgrent_r.3
12878 hash.3
12879 mtk
12880 Minor rewording w.r.t. use of the term "parameter".
12881
12882 Typographical or grammatical errors have been corrected in several
12883 other places. (Many, many thanks to Alain Portal!)
12884
12885
12886 Changes to individual pages
12887 ---------------------------
12888
12889 capget.2
12890 Andrew Morgan
12891 Update in line with addition of file capabilities and
12892 64-bit capability sets in kernel 2.6.2[45].
12893
12894 clock_nanosleep.2
12895 mtk
12896 Add "Link with -lrt" to SYNOPSIS.
12897
12898 getrusage.2
12899 Sripathi Kodi
12900 Document RUSAGE_THREAD, new in 2.6.26.
12901 mtk
12902 Improve description of RUSAGE_CHILDREN.
12903 Add pointer to /proc/PID/stat in proc(5).
12904 Other minor clean-ups.
12905
12906 ioprio_set.2
12907 Nikanth Karthikesan
12908 Since Linux 2.6.25, CAP_SYS_ADMIN is longer required to set
12909 a low priority (IOPRIO_CLASS_IDLE).
12910
12911 mount.2
12912 mtk
12913 Since Linux 2.6.26, MS_RDONLY honors bind mounts.
12914
12915 openat.2
12916 mtk
12917 SEE ALSO: add utimensat(3).
12918
12919 prctl.2
12920 Serge Hallyn, with some edits/input from mtk
12921 Document PR_CAPBSET_READ and PR_CAPBSET_DROP.
12922 Erik Bosman
12923 Document PR_GET_TSC and PR_SET_TSC.
12924 mtk, reviewed by Andrea Arcangeli
12925 Document PR_SET_SECCOMP and PR_GET_SECCOMP.
12926 mtk
12927 PR_SET_KEEPCAPS and PR_GET_KEEPCAPS operate on a per-thread
12928 setting, not a per-process setting.
12929 mtk
12930 Clarify fork(2) details for PR_SET_PDEATHSIG.
12931 mtk
12932 Add description of PR_SET_SECUREBITS and PR_GET_SECUREBITS,
12933 as well as pointer to further info in capabilities(7).
12934 mtk
12935 PR_GET_ENDIAN returns endianness info in location pointed to by
12936 arg2 (not as function result, as was implied by previous text).
12937 mtk
12938 Expand description of PR_SET_NAME and PR_GET_NAME.
12939 mtk
12940 RETURN VALUE: bring up to date for various options.
12941 mtk
12942 Various improvements in ERRORS.
12943 mtk
12944 Note that PR_SET_TIMING setting of PR_TIMING_TIMESTAMP is not
12945 currently implemented.
12946 mtk
12947 Minor changes:
12948 * Clarify wording for PR_GET_UNALIGN, PR_GET_FPEMU, and
12949 PR_GET_FPEXC.
12950 * Some reformatting of kernel version information.
12951 * Reorder PR_GET_ENDIAN and PR_SET_ENDIAN entries.
12952
12953 readlinkat.2
12954 John Brooks / mtk
12955 Fix and reword erroneous RETURN VALUE text.
12956
12957 recv.2
12958 mtk
12959 Noted which flags appeared in Linux 2.2.
12960
12961 sched_setaffinity.2
12962 mtk, after a Fedora downstream patch
12963 Update type used for cpusetsize argument in SYNOPSIS.
12964
12965 select.2
12966 Andreas Mohr / mtk
12967 Clarify "zero timeout" case.
12968 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
12969
12970 send.2
12971 mtk
12972 Noted which flags appeared in Linux 2.2.
12973
12974 sigaction.2
12975 mtk
12976 Document si_overrun and si_tid fields of siginfo structure.
12977 Add some text for si_trapno field.
12978 The si_errno field is *generally* unused.
12979 mtk
12980 Put descriptions of SA_* constants in alphabetical order.
12981
12982 signal.2
12983 mtk
12984 Rewrote and expanded portability discussion.
12985 NOTES: Show the raw prototype of signal() (without use of
12986 sighandler_t).
12987
12988 signalfd.2
12989 mtk
12990 Modify description of ssi_trapno field.
12991
12992 swapon.2
12993 mtk
12994 Fix two version number typos for MAX_SWAPFILES discussion:
12995 s/2.6.10/2.4.10/
12996
12997 utime.2
12998 mtk
12999 SEE ALSO: add utimensat(2), futimens(3).
13000
13001 dl_iterate_phdr.3
13002 Alain Portal
13003 SEE ALSO: Add elf(5).
13004
13005 crypt.3
13006 mtk, after a Fedora downstream patch
13007 Describe additional encryption algorithms.
13008 See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
13009
13010 errno.3
13011 mtk
13012 Small rewrites in DESCRIPTION.
13013
13014 exec.3
13015 mtk, after a note from Alain Portal
13016 Small rewording.
13017
13018 exp10.3
13019 Alain Portal
13020 SEE ALSO: Add log10(3).
13021
13022 exp2.3
13023 Alain Portal
13024 Add C99 to CONFORMING TO.
13025
13026 fgetgrent.3
13027 Alain Portal
13028 Add references to group(5).
13029 mtk
13030 Minor rewordings.
13031 SEE ALSO: add fopen(3).
13032
13033 fgetpwent.3
13034 Alain Portal
13035 Add reference to passwd(5).
13036 mtk
13037 Minor rewordings.
13038 SEE ALSO: add fopen(3).
13039
13040 frexp.3
13041 Alain Portal
13042 Add C99 to CONFORMING TO.
13043
13044 futimes.3
13045 mtk
13046 SEE ALSO: remove futimesat(2); add utimensat(2).
13047
13048 getopt.3
13049 mtk
13050 Add details on initial value of optind, and note that it can
13051 be reset (to 1) to restart scanning of an argument vector.
13052 Add a NOTES section describing the glibc-specific behavior
13053 when optind is reset to 0 (rather than 1).
13054 See http://groups.google.com/group/comp.unix.programmer/browse_thread/thread/be0d0b7a07a165fb
13055 mtk
13056 Note glibc extensions under CONFORMING TO.
13057
13058 getspnam.3
13059 mtk
13060 Improve comments on struct spwd.
13061
13062 getpw.3
13063 Alain Portal
13064 RETURN VALUE: note that errno is set on error.
13065 mtk
13066 Add EINVAL error.
13067
13068 insque.3
13069 mtk / Alain Portal
13070 Minor rewordings.
13071
13072 log.3
13073 Alain Portal
13074 Remove unnecessary sentence in ERRORS.
13075
13076 log10.3
13077 mtk
13078 SEE ALSO: Add exp10(3).
13079
13080 offsetof.3
13081 Alain Portal
13082 Small wording improvement.
13083
13084 pow.3
13085 Alain Portal
13086 Remove unnecessary sentence in ERRORS.
13087
13088 printf.3
13089 mtk / Alain Portal
13090 Many small formatting fixes.
13091
13092 proc.5
13093 mtk
13094 Remove redundant summary list of files in description of
13095 /proc/sys/kernel.
13096 Make kernel version for /proc/sys/kernel/panic_on_oops more precise.
13097 Make kernel version for /proc/sys/kernel/pid_max more precise.
13098 Add Documentation/sysctl/vm.txt to SEE ALSO.
13099 Other minor edits.
13100
13101 profil.3
13102 mtk / Alain Portal
13103 Small wording improvement.
13104
13105 rtime.3
13106 mtk, after a note by Alain Portal
13107 Clarify meaning of midnight on 1 Jan 1900/1970.
13108 mtk
13109 Remove netdate(1) and rdate(1) from SEE ALSO, since these pages
13110 don't seem to exist on Linux systems.
13111
13112 scanf.3
13113 Vincent Lefevre / mtk
13114 Clarify treatment of initial white space by %% conversion
13115 specification.
13116 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435648.
13117 mtk
13118 Many small formatting fixes.
13119
13120 stdin.3
13121 Alain Portal
13122 Rename CONSIDERATIONS section to NOTES, and relocate
13123 to appropriate place on page.
13124
13125 tmpfile.3
13126 mtk, after a note by Alain Portal
13127 Prepend "POSIX.1-2001 specifies that: " to the sentence stating
13128 that tmpfile() may write to stdout. (AFAICS, glibc's tmpfile()
13129 does not do this.)
13130
13131 ttyname.3
13132 Alain Portal
13133 Remove unnecessary sentence in ERRORS.
13134
13135 wcsdup.3
13136 Alain Portal
13137 Make wording more precise: the memory allocated by wcsdup(3)
13138 *should* be freed with free(3).
13139
13140 wordexp.3
13141 Alain Portal / mtk
13142 Move example into proper EXAMPLE section.
13143
13144 tty_ioctl.4
13145 mtk / Petr Gajdos
13146 The features in the "Get and Set Window Size" subsection
13147 require the inclusion of <sys/ioctl.h>.
13148
13149 capabilities.7
13150 Serge Hallyn, plus a bit of work by mtk
13151 Document file capabilities, per-process capability bounding set,
13152 changed semantics for CAP_SETPCAP, and other changes in 2.6.2[45].
13153 Add CAP_MAC_ADMIN, CAP_MAC_OVERRIDE, CAP_SETFCAP.
13154 Various smaller fixes.
13155 mtk, plus review by Serge Hallyn and Andrew Morgan
13156 Add text detailing how CAP_SETPCAP (theoretically) permits -- on
13157 pre-2.6.25 kernels, and 2.6.25 and later kernels with file
13158 capabilities disabled -- a thread to change the capability sets
13159 of another thread.
13160 Add section describing rules for programmatically adjusting
13161 thread capability sets.
13162 Add some words describing purpose of inheritable set.
13163 Note existence of CONFIG_SECURITY_CAPABILITIES config option.
13164 Describe rationale for capability bounding set.
13165 Document securebits flags (new in 2.6.26).
13166 Remove obsolete BUGS section.
13167 SEE ALSO: Add getcap(8), setcap(8), and various libcap pages.
13168 mtk
13169 Add text noting that if we set the effective flag for one
13170 file capability, then we must also set the effective flag for all
13171 other capabilities where the permitted or inheritable bit is set.
13172 mtk
13173 Since Linux 2.6.25, CAP_SYS_ADMIN is no longer required for
13174 ioprio_set() to set IOPRIO_CLASS_IDLE class.
13175 mtk
13176 Reword discussion of CAP_LINUX_IMMUTABLE to be file-system neutral.
13177
13178 man-pages.7
13179 mtk
13180 A list of standards in the CONFORMING TO list should be
13181 terminated by a period.
13182 The list of pages in a SEE ALSO list should not be
13183 terminated by a period.
13184
13185 tcp.7
13186 mtk
13187 Correct a detail for sysctl_tcp_adv_win_scale.
13188 Formatting fixes.
13189
13190
13191 ==================== Changes in man-pages-3.05 ====================
13192
13193 Released: 2008-07-23, Konolfingen
13194
13195
13196 Contributors
13197 ------------
13198
13199 The following people contributed notes, ideas, or patches that have
13200 been incorporated in changes in this release:
13201
13202 Alain Portal <aportal@univ-montp2.fr>
13203 Andries Brouwer <Andries.Brouwer@cwi.nl>
13204 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
13205 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13206 Franck Jousseaume <franck.jousseaume@gmail.com>
13207 Sam Varshavchik <mrsam@courier-mta.com>
13208 Uli Schlacter <psychon@znc.in>
13209
13210 Apologies if I missed anyone!
13211
13212
13213 New and rewritten pages
13214 -----------------------
13215
13216 matherr.3
13217 mtk, with review by Andries Brouwer
13218 A description of the SVID-specified mechanism for reporting
13219 math exceptions.
13220 See http://thread.gmane.org/gmane.linux.man/266.
13221
13222 math_error.7
13223 mtk, with review and suggested input from Andries Brouwer
13224 A description of how math functions report errors.
13225 See http://thread.gmane.org/gmane.linux.man/249.
13226
13227
13228 Global changes
13229 --------------
13230
13231 Various pages
13232 mtk
13233 s/floating point/floating-point/ when used attributively.
13234
13235 Various pages
13236 mtk
13237 For consistency with majority usage:
13238 s/plus infinity/positive infinity/
13239 s/minus infinity/negative infinity/
13240
13241 Typographical or grammatical errors have been corrected in several
13242 other places.
13243
13244
13245 Changes to individual pages
13246 ---------------------------
13247
13248 brk.2
13249 mtk
13250 SEE ALSO: add end(3).
13251
13252 open.2
13253 Brian M. Carlson / mtk
13254 Remove ambiguity in description of support for O_EXCL on NFS.
13255 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=491791.
13256
13257 prctl.2
13258 mtk
13259 Place options in some semblance of alphabetical order.
13260 (No content or formatting changes were made.)
13261
13262 cerf.3
13263 mtk
13264 Bump version number: these functions are still missing in
13265 glibc 2.8.
13266
13267 fenv.3
13268 mtk
13269 SEE ALSO: Add math_error(7).
13270
13271 INFINITY.3
13272 mtk
13273 SEE ALSO: Add math_error(7).
13274
13275 nan.3
13276 mtk
13277 Remove unneeded "Compile with" piece in SYNOPSIS.
13278 SEE ALSO: Add math_error(7).
13279
13280 rpc.3
13281 mtk / Franck Jousseaume
13282 Fix errors introduced into a few prototypes when converting
13283 function declarations to use modern C prototypes in man-pages-2.75.
13284
13285 ipv6.7
13286 mtk, after a report from Uli Schlacter
13287 Document the IPV6_V6ONLY flag.
13288
13289
13290 ==================== Changes in man-pages-3.06 ====================
13291
13292 Released: 2008-08-05, Konolfingen
13293
13294
13295 Contributors
13296 ------------
13297
13298 The following people contributed notes, ideas, or patches that have
13299 been incorporated in changes in this release:
13300
13301 Andreas Jaeger <aj@novell.com>
13302 Andries Brouwer <Andries.Brouwer@cwi.nl>
13303 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13304 Gernot Tenchio <g.tenchio@telco-tech.de>
13305 Sam Varshavchik <mrsam@courier-mta.com>
13306 Tolga Dalman <tdalman@project-psi.org>
13307
13308 Apologies if I missed anyone!
13309
13310
13311 New and rewritten pages
13312 -----------------------
13313
13314 erfc.3
13315 mtk
13316 Created after removing the erfc() material from erf.3.
13317 Documents the complementary error function.
13318
13319 y0.3
13320 mtk
13321 Created after removing the y*() material from j0.3.
13322 Documents the Bessel functions of the second kind.
13323 Included ERRORS section; noted that an exception is not
13324 raised on underflow, see also
13325 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806;
13326 and errno is not set on overflow, see also
13327 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808;
13328 Included BUGS section noting that errno is incorrectly
13329 set for pole error; see also
13330 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6807.
13331
13332 scalbln.3
13333 mtk
13334 Created after removing the scalbln*() and scalbn*() material
13335 from scalb.3. Documents scalbln() and scalbn() functions.
13336 Included ERRORS section; noted that errno is not set; see
13337 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803.
13338
13339
13340 New and changed links
13341 ---------------------
13342
13343 erfcf.3
13344 erfcl.3
13345 mtk
13346 Changed these links to point to new erfc.3 page.
13347
13348 scalblnf.3
13349 scalblnl.3
13350 scalbn.3
13351 scalbnf.3
13352 scalbnl.3
13353 mtk
13354 Changed these links to point to new scalbln.3 page.
13355
13356 y0f.3
13357 y0l.3
13358 y1.3
13359 y1f.3
13360 y1l.3
13361 yn.3
13362 ynf.3
13363 ynl.3
13364 mtk
13365 Changed these links to point to new y0.3 page.
13366
13367
13368 Global changes
13369 --------------
13370
13371 Various pages
13372 mtk
13373 s/floating point/floating-point/ when used attributively.
13374
13375 Typographical or grammatical errors have been corrected in several
13376 other places.
13377
13378
13379 Changes to individual pages
13380 ---------------------------
13381
13382 crypt.3
13383 mtk
13384 Tweak discuss text describing support for Blowfish.
13385
13386 ctime.3
13387 mtk / Gernot Tenchio
13388 Added some words to make clear that the string returned by
13389 ctime() and asctime() is null-terminated.
13390
13391 math_error.7
13392 Sam Varshavchik
13393 Reverse order of SYNOPSIS and NAME sections.
13394 mtk
13395 NOTES: Summarize the state of glibc support for exceptions
13396 and errno for error reporting.
13397
13398
13399 Changes to individual pages (math functions)
13400 --------------------------------------------
13401
13402 Almost all of the changes in this release relate to math man pages.
13403 Very many changes were made to the math pages, including:
13404
13405 * Fixed feature test macros (FTMs). Often, the FTM requirements
13406 for the "float" and "long double" versions of a math function are
13407 different from the requirements for the "double" version. Each math
13408 page now shows the correct FTM requirements for all three versions
13409 of the function(s) it describes. This may have required either
13410 a change to the existing FTM text (if the requirements for the
13411 "double" function were already described), or the addition of an FTM
13412 description to a SYNOPSIS where one was not previously present
13413 (typically because the "double" version of the function does not
13414 require any FTMs to be defined).
13415 * CONFORMING TO: in many cases, POSIX.1-2001 was not mentioned.
13416 Where a function is specified in POSIX.1-2001, this is now noted.
13417 Also, statements about what other standards a function conforms to
13418 were generally clarified. (The wording about which functions conformed
13419 to C99 was previously often done as an add on sentence; now it is made
13420 part of the first sentence of the CONFORMING TO section, along with
13421 POSIX.1-2001.)
13422 * RETURN VALUE: in many cases, pages lacked descriptions of the return
13423 value when the function arguments are special values such as +0, -0,
13424 NaN (not-a-number), +infinity, -infinity, etc. This has been fixed.
13425 I carried out tests on glibc 2.8 to ensure that all of these
13426 functions match the RETURN VALUE descriptions (and the POSIX.1-2001
13427 requirements).
13428 * ERRORS: many pages lacked a clear (or indeed any) description of
13429 how errno is set on error and what exception is raised for each error.
13430 This has been fixed. The ERRORS sections are now generally headed up
13431 as per the POSIX.1 way of doing things, describing Pole / Range /
13432 Domain errors, as applicable.
13433 I carried out tests on glibc 2.8 to ensure that all of these
13434 functions match the ERRORS descriptions. Deviations from POSIX.1-2001
13435 requirements have been filed as glibc bug reports, and noted in the
13436 man pages. (The pages now describe the situation for ERRORS as at glibc
13437 2.8; I may eventually try and extend the text with descriptions of
13438 changes in older versions of glibc.)
13439 NOTE: one point that has not been covered in any page is the
13440 circumstances that generate inexact (FE_INEXACT) exceptions.
13441 (The details for these exceptions are not specified in POSIX.1-2001,
13442 and I haven't gone looking for the standards that describe the details.)
13443
13444 acos.3
13445 mtk
13446 SYNOPSIS: Added feature test macro requirements.
13447 RETURN VALUE: Added details for special argument cases.
13448 Rewrote ERRORS section.
13449 Updated CONFORMING TO.
13450
13451 acosh.3
13452 mtk
13453 SYNOPSIS: Fixed feature test macro requirements.
13454 Added RETURN VALUE section.
13455 Rewrote ERRORS section.
13456 Updated CONFORMING TO.
13457
13458 asin.3
13459 mtk
13460 SYNOPSIS: Added feature test macro requirements.
13461 RETURN VALUE: Added details for special argument cases.
13462 Rewrote ERRORS section.
13463 Updated CONFORMING TO.
13464
13465 asinh.3
13466 mtk
13467 SYNOPSIS: Added feature test macro requirements.
13468 DESCRIPTION: Some rewording.
13469 RETURN VALUE: Added details for special argument cases.
13470 Added (null) ERRORS section.
13471 Updated CONFORMING TO.
13472
13473 atan.3
13474 mtk
13475 SYNOPSIS: Added feature test macro requirements.
13476 DESCRIPTION: Some rewording.
13477 RETURN VALUE: Added details for special argument cases.
13478 Added (null) ERRORS section.
13479 Updated CONFORMING TO.
13480
13481 atan2.3
13482 mtk
13483 SYNOPSIS: Added feature test macro requirements.
13484 DESCRIPTION: Some rewording.
13485 RETURN VALUE: Added details for special argument cases.
13486 Added (null) ERRORS section.
13487 Updated CONFORMING TO.
13488
13489 atanh.3
13490 mtk
13491 SYNOPSIS: Fixed feature test macro requirements.
13492 Added RETURN VALUE section.
13493 Rewrote ERRORS section.
13494 Updated CONFORMING TO.
13495 Added BUGS section noting that pole error sets errno to EDOM,
13496 when it should be ERANGE instead; see also
13497 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759.
13498
13499 cbrt.3
13500 mtk
13501 SYNOPSIS: Fixed feature test macro requirements.
13502 Added RETURN VALUE section.
13503 Added (null) ERRORS section.
13504 Updated CONFORMING TO.
13505
13506 ceil.3
13507 mtk
13508 SYNOPSIS: Added feature test macro requirements.
13509 DESCRIPTION: Enhanced.
13510 RETURN VALUE: Added details for special argument cases.
13511 Rewrote ERRORS section.
13512 Updated CONFORMING TO.
13513 NOTES: Added some details.
13514
13515 copysign.3
13516 mtk
13517 Added RETURN VALUE section.
13518 Updated CONFORMING TO.
13519
13520 cos.3
13521 mtk
13522 SYNOPSIS: Added feature test macro requirements.
13523 Rewrote RETURN VALUE section.
13524 Added ERRORS section; noted errno is not set:
13525 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780.
13526 Updated CONFORMING TO.
13527
13528 cosh.3
13529 mtk
13530 SYNOPSIS: Added feature test macro requirements.
13531 Added RETURN VALUE section.
13532 Added ERRORS section.
13533 Updated CONFORMING TO.
13534
13535 erf.3
13536 mtk
13537 Removed the erfc() material (there is now a new erfc page).
13538 Reason: the functions are logically separate; also their
13539 return values differ, and it would have been confusing
13540 to document them on the same page.
13541 SYNOPSIS: Fixed feature test macro requirements.
13542 Added RETURN VALUE section.
13543 Added ERRORS section; noted that errno is not set; see
13544 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785.
13545 Updated CONFORMING TO.
13546
13547 exp.3
13548 mtk
13549 SYNOPSIS: Added feature test macro requirements.
13550 Added RETURN VALUE section.
13551 Added ERRORS section; noted that errno is not set; see
13552 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6786.
13553 Updated CONFORMING TO.
13554
13555 exp10.3
13556 mtk
13557 SYNOPSIS: Added feature test macro requirements.
13558 Added RETURN VALUE section.
13559 Added ERRORS section; noted that errno is not set for underflow;
13560 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787.
13561
13562 exp2.3
13563 mtk
13564 Added RETURN VALUE and ERRORS sections.
13565 Updated CONFORMING TO.
13566
13567 expm1.3
13568 mtk
13569 SYNOPSIS: Fixed feature test macro requirements.
13570 Added RETURN VALUE section.
13571 Added ERRORS section; noted that errno is not set for overflow;
13572 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788.
13573 Updated CONFORMING TO.
13574 Added BUGS section, describing bogus underflow exception for -large,
13575 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778;
13576 and describing bogus invalid exception for certain +large,
13577 see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814.
13578
13579 fabs.3
13580 mtk
13581 SYNOPSIS: Added feature test macro requirements.
13582 Added RETURN VALUE section.
13583 Updated CONFORMING TO.
13584
13585 fdim.3
13586 mtk
13587 SYNOPSIS: Added feature test macro requirements.
13588 DESCRIPTION: Some rewording.
13589 Added RETURN VALUE section.
13590 Added ERRORS section; noted that errno is not set; see
13591 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796.
13592 Updated CONFORMING TO.
13593
13594 fenv.3
13595 mtk
13596 Make style of writing exception names consistent with other
13597 pages and POSIX.1-2001.
13598 Updated CONFORMING TO.
13599
13600 finite.3
13601 mtk
13602 SYNOPSIS: Fixed feature test macro requirements.
13603
13604 floor.3
13605 mtk
13606 SYNOPSIS: Added feature test macro requirements.
13607 DESCRIPTION: Enhanced.
13608 RETURN VALUE: Added details for special argument cases.
13609 Rewrote ERRORS section.
13610 Updated CONFORMING TO.
13611
13612 fma.3
13613 mtk
13614 SYNOPSIS: Added feature test macro requirements.
13615 DESCRIPTION: Some rewording.
13616 Added RETURN VALUE section.
13617 Added ERRORS section; noted that errno is not set; see
13618 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13619 Updated CONFORMING TO.
13620
13621 fmax.3
13622 fmin.3
13623 mtk
13624 NAME: Make description clearer
13625 SYNOPSIS: Added feature test macro requirements.
13626 SYNOPSIS: Remove unneeded "Compile with" piece.
13627 CONFORMING TO: Added POSIX.1-2001.
13628 Added RETURN VALUE and ERRORS sections.
13629
13630 fmod.3
13631 mtk
13632 SYNOPSIS: Added feature test macro requirements.
13633 RETURN VALUE: Added details for special argument cases.
13634 Rewrote ERRORS section; noted that errno is not always set; see
13635 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13636 Updated CONFORMING TO.
13637
13638 fpclassify.3
13639 mtk
13640 Minor wording changes.
13641 CONFORMING TO: Added POSIX.1-2001.
13642 SEE ALSO: Add signbit(3).
13643
13644 frexp.3
13645 mtk
13646 SYNOPSIS: Added feature test macro requirements.
13647 Added details to RETURN VALUE section.
13648 Added (null) ERRORS section.
13649 CONFORMING TO: Added POSIX.1-2001.
13650
13651 gamma.3
13652 mtk
13653 SYNOPSIS: Fixed feature test macro requirements.
13654 Added (null) RETURN VALUE section referring to tgamma(3).
13655 Added (null) ERRORS section referring to tgamma(3).
13656 CONFORMING TO: Rewrote.
13657
13658 hypot.3
13659 mtk
13660 SYNOPSIS: Fixed feature test macro requirements.
13661 DESCRIPTION: note that calculation is done without causing
13662 undue overflow or underflow.
13663 Added RETURN VALUE section.
13664 Added ERRORS section; noted that errno is not always set; see
13665 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795.
13666 Updated CONFORMING TO.
13667
13668 ilogb.3
13669 mtk
13670 SYNOPSIS: Added feature test macro requirements.
13671 Rewrote RETURN VALUE section.
13672 Rewrote ERRORS section; noted that errno is not set, and in some
13673 cases an exception is not raised; see also
13674 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794.
13675 CONFORMING TO: Added POSIX.1-2001.
13676
13677 isgreater.3
13678 mtk
13679 NAME: Make description clearer
13680 Improve the description of isunordered().
13681 Added RETURN VALUE and ERRORS sections.
13682 Formatting fixes.
13683 A few wording improvements.
13684
13685 j0.3
13686 mtk
13687 Removed material for the y*() functions to a separate y0.3 page.
13688 Reason: the return values and errors/exceptions differ, and it
13689 would have been confusing to document them on the same page.
13690 Added RETURN VALUE section.
13691 Added ERRORS section; noted that errno is not set; see
13692 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805.
13693
13694 ldexp.3
13695 mtk
13696 SYNOPSIS: Added feature test macro requirements.
13697 Added RETURN VALUE and ERRORS sections.
13698 Updated CONFORMING TO.
13699
13700 lgamma.3
13701 mtk
13702 Note that these functions are deprecated.
13703 SYNOPSIS: Fixed feature test macro requirements.
13704 Added RETURN VALUE and ERRORS sections referring to lgamma(3).
13705 Added BUGS section noting that pole error sets errno to EDOM,
13706 when it should be ERANGE instead; see also
13707 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777.
13708
13709 log.3
13710 mtk
13711 SYNOPSIS: Added feature test macro requirements.
13712 Added RETURN VALUE section.
13713 Rewrote ERRORS section.
13714 Updated CONFORMING TO.
13715
13716 log10.3
13717 mtk
13718 SYNOPSIS: Added feature test macro requirements.
13719 Added RETURN VALUE section.
13720 Rewrote ERRORS section.
13721 Updated CONFORMING TO.
13722
13723 log1p.3
13724 mtk
13725 SYNOPSIS: Fixed feature test macro requirements.
13726 Added RETURN VALUE section.
13727 Added ERRORS section; noted that errno is not set; see
13728 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6792.
13729 Updated CONFORMING TO.
13730
13731 log2.3
13732 mtk
13733 Added RETURN VALUE section.
13734 Rewrote ERRORS section.
13735 Updated CONFORMING TO.
13736
13737 logb.3
13738 mtk
13739 SYNOPSIS: Fixed feature test macro requirements.
13740 DESCRIPTION: added a little detail; some rewordings.
13741 RETURN VALUE: Added details for special argument cases.
13742 Rewrote ERRORS section; noted that errno is not set; see
13743 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6793.
13744 CONFORMING TO: Added POSIX.1-2001.
13745
13746 lrint.3
13747 mtk
13748 DESCRIPTION: some rewording.
13749 RETURN VALUE: Added details for special argument cases.
13750 Added ERRORS section; noted that errno is not set; see
13751 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798.
13752 CONFORMING TO: Added POSIX.1-2001.
13753
13754 lround.3
13755 mtk
13756 RETURN VALUE: Added details for special argument cases.
13757 Rewrote ERRORS section; noted that errno is not set; see
13758 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797.
13759 CONFORMING TO: Added POSIX.1-2001.
13760
13761 modf.3
13762 mtk
13763 SYNOPSIS: Added feature test macro requirements.
13764 RETURN VALUE: Added details for special argument cases.
13765 Added (null) ERRORS section.
13766 CONFORMING TO: Added POSIX.1-2001.
13767
13768 nan.3
13769 mtk
13770 Small wording changes.
13771 CONFORMING TO: Added POSIX.1-2001.
13772
13773 nextafter.3
13774 mtk
13775 SYNOPSIS: Fixed feature test macro requirements.
13776 RETURN VALUE: Added details for special argument cases.
13777 Added ERRORS section; noted that errno is not set; see
13778 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799.
13779 CONFORMING TO: Added POSIX.1-2001.
13780
13781 pow.3
13782 mtk
13783 SYNOPSIS: Added feature test macro requirements.
13784 Added RETURN VALUE section.
13785 Rewrote ERRORS section.
13786 Updated CONFORMING TO.
13787 Added BUGS section noting that pole error sets errno to EDOM,
13788 when it should be ERANGE instead; see also
13789 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776.
13790
13791 remainder.3
13792 mtk
13793 SYNOPSIS: Fixed feature test macro requirements.
13794 DESCRIPTION: added some details.
13795 RETURN VALUE: Added details for special argument cases.
13796 Rewrote ERRORS section; noted that errno is not always set; see
13797 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13798 Updated CONFORMING TO.
13799 Added BUGS section noting that remainder(nan(""), 0)
13800 wrongly causes a domain error; see
13801 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
13802
13803 remquo.3
13804 mtk
13805 Added RETURN VALUE section.
13806 Added ERRORS section; noted that errno is not set; see
13807 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
13808 Updated CONFORMING TO.
13809
13810 fmax.3
13811 fmin.3
13812 mtk
13813 NAME: Make description clearer
13814 SYNOPSIS: Added feature test macro requirements.
13815 SYNOPSIS: Remove unneeded "Compile with" piece.
13816 CONFORMING TO: Added POSIX.1-2001.
13817 Added RETURN VALUE and ERRORS sections.
13818
13819 fmod.3
13820 mtk
13821 SYNOPSIS: Added feature test macro requirements.
13822 RETURN VALUE: Added details for special argument cases.
13823 Rewrote ERRORS section; noted that errno is not always set; see
13824 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
13825 Updated CONFORMING TO.
13826
13827 fpclassify.3
13828 CONFORMING TO: Added POSIX.1-2001.
13829
13830 rint.3
13831 mtk
13832 SYNOPSIS: Fixed feature test macro requirements.
13833 DESCRIPTION: added some details.
13834 RETURN VALUE: Added details for special argument cases.
13835 ERRORS: no errors can occur (previous text was misleading).
13836 CONFORMING TO: Added POSIX.1-2001.
13837 NOTES: point out that lrint() may be preferred in some cases.
13838
13839 round.3
13840 mtk
13841 DESCRIPTION: added some details.
13842 RETURN VALUE: Added details for special argument cases.
13843 ERRORS: no errors can occur (previous text was misleading).
13844 CONFORMING TO: Added POSIX.1-2001.
13845 NOTES: point out that lround() may be preferred in some cases.
13846
13847 scalb.3
13848 mtk
13849 Removed the scalbn() and scalbln() material to a separate
13850 scalbln.3 page. Reason: scalb() is obsolete; also the
13851 exception/error conditions differ somewhat, so that it
13852 would have been confusing to document them on the same page.
13853 SYNOPSIS: Fixed feature test macro requirements.
13854 DESCRIPTION: some rewrites and added details.
13855 Added RETURN VALUE section.
13856 Added ERRORS section; noted that errno is not set; see
13857 also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
13858 and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804.
13859 CONFORMING TO: Rewrote.
13860
13861 signbit.3
13862 mtk
13863 SYNOPSIS: Added feature test macro requirements.
13864 SYNOPSIS: Remove unneeded "Compile with" piece.
13865 Added RETURN VALUE section.
13866 Added (null) ERRORS section.
13867 CONFORMING TO: Added POSIX.1-2001.
13868
13869 sin.3
13870 mtk
13871 SYNOPSIS: Added feature test macro requirements.
13872 Added RETURN VALUE section.
13873 Added ERRORS section; noted errno is not set:
13874 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781.
13875 Updated CONFORMING TO.
13876
13877 sincos.3
13878 mtk
13879 DESCRIPTION: Added details for special argument cases.
13880 Added (null) RETURN VALUE section.
13881 Added ERRORS section.
13882
13883 sinh.3
13884 mtk
13885 SYNOPSIS: Added feature test macro requirements.
13886 Added RETURN VALUE section.
13887 Added ERRORS section.
13888 Updated CONFORMING TO.
13889
13890 sqrt.3
13891 mtk
13892 SYNOPSIS: Added feature test macro requirements.
13893 Added RETURN VALUE section.
13894 Rewrote ERRORS section.
13895 Updated CONFORMING TO.
13896
13897 tan.3
13898 mtk
13899 SYNOPSIS: Added feature test macro requirements.
13900 Added RETURN VALUE section.
13901 Added ERRORS section.
13902 Added ERRORS section; noted errno is not set:
13903 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782.
13904 Updated CONFORMING TO.
13905
13906 tanh.3
13907 mtk
13908 SYNOPSIS: Added feature test macro requirements.
13909 Added RETURN VALUE section.
13910 Added (null) ERRORS section.
13911 Updated CONFORMING TO.
13912
13913 tgamma.3
13914 mtk
13915 Added RETURN VALUE section.
13916 Rewrote ERRORS section; noted that errno is not set /
13917 incorrectly set in some cases; see also
13918 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
13919 and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810.
13920 CONFORMING TO: Added POSIX.1-2001.
13921 Added NOTES section to hold text explaining origin of tgamma().
13922
13923 trunc.3
13924 mtk
13925 RETURN VALUE: small rewording.
13926 CONFORMING TO: Added POSIX.1-2001.
13927 Added NOTES section explaining that result may be too large
13928 to store in an integer type.
13929
13930
13931 ==================== Changes in man-pages-3.07 ====================
13932
13933 Released: 2008-08-12, Konolfingen
13934
13935
13936 Contributors
13937 ------------
13938
13939 The following people contributed notes, ideas, or patches that have
13940 been incorporated in changes in this release:
13941
13942 Alain Portal <aportal@univ-montp2.fr>
13943 Andries Brouwer <Andries.Brouwer@cwi.nl>
13944 Christoph Lameter <cl@linux-foundation.org>
13945 Cliff Wickman <cpw@sgi.com>
13946 Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13947 Filippo Santovito <filippo.santovito@email.it>
13948 Gerrit Renker <gerrit@erg.abdn.ac.uk>
13949 Heikki Orsila <shd@modeemi.cs.tut.fi>
13950 Khalil GHORBAL <khalil.ghorbal@cea.fr>
13951 Lee Schermerhorn <lee.schermerhorn@hp.com>
13952 Maxin John <maxin.john@gmail.com>
13953 Reuben Thomas <rrt@sc3d.org>
13954 Samuel Thibault <samuel.thibault@ens-lyon.org>
13955 Sam Varshavchik <mrsam@courier-mta.com>
13956 Soh Kam Yung <sohkamyung@gmail.com>
13957 Stephane Chazelas <stephane_chazelas@yahoo.fr>
13958 Pavel Heimlich <tropikhajma@seznam.cz>
13959 Reuben Thomas <rrt@sc3d.org>
13960
13961 Apologies if I missed anyone!
13962
13963
13964 New and rewritten pages
13965 -----------------------
13966
13967 move_pages.2
13968 Christoph Lameter, various edits and improvements by mtk
13969 Documentation of the move_pages() system call.
13970 This page was formerly part of the numactl package, but really
13971 belongs in man-pages (since it describes a kernel interface).
13972
13973 clock_getcpuclockid.3
13974 mtk
13975 New page documenting the clock_getcpuclockid() library function,
13976 available since glibc 2.2.
13977
13978 udplite.7
13979 Gerrit Renker
13980 Document the Linux implementation of the UDP-Lite protocol,
13981 new in Linux 2.6.20.
13982
13983
13984 Newly documented interfaces in existing pages
13985 ---------------------------------------------
13986
13987 proc.5
13988 Christoph Lameter, minor edits and improvements by mtk
13989 Documentation of the /proc/PID/numa_maps file.
13990 This material was formerly the numa_maps.5 page in the numactl
13991 package, but really belongs in man-pages (since it describes
13992 a kernel interface).
13993
13994
13995 Global changes
13996 --------------
13997
13998 nanosleep.2
13999 inet_ntop.3
14000 inet_pton.3
14001 scanf.3
14002 initrd.4
14003 mtk
14004 Fix mis-ordered (.SH) sections.
14005
14006 connect.2
14007 socket.2
14008 rtnetlink.3
14009 arp.7
14010 ddp.7
14011 ip.7
14012 ipv6.7
14013 netlink.7
14014 packet.7
14015 raw.7
14016 rtnetlink.7
14017 socket.7
14018 tcp.7
14019 udp.7
14020 unix.7
14021 x25.7
14022 mtk
14023 s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
14024 PF_ constants have always had the same values; there never has
14025 been a protocol family that had more than one address family,
14026 and POSIX.1-2001 only specifies the AF_* constants.
14027
14028 Typographical or grammatical errors have been corrected in several
14029 other places.
14030
14031
14032 Changes to individual pages
14033 ---------------------------
14034
14035 execve.2
14036 mtk
14037 The floating-point environment is reset to the default
14038 during an execve().
14039
14040 get_mempolicy.2
14041 Lee Schermerhorn
14042 Misc cleanup of get_mempolicy(2):
14043 + mention that any mode flags will be saved with mode.
14044 I don't bother to document mode flags here because we
14045 already have a pointer to set_mempolicy(2) for more info
14046 on memory policy. mode flags are discussed there.
14047 + remove some old, obsolete [IMO] NOTES and 'roff comments.
14048 Lee Schermerhorn
14049 Update the get_mempolicy(2) man page to add in the description of
14050 the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
14051 mtk
14052 Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
14053 is specified with either MPOL_F_ADDR or MPOL_F_NODE.
14054
14055 getitimer.2
14056 mtk
14057 CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
14058 obsolete.
14059
14060 mbind.2
14061 Lee Schermerhorn
14062 Fix error conditions, now that the kernel silently ignores
14063 nodes outside the task's cpuset, as long as one valid node
14064 remains.
14065
14066 Now that cpuset man page exists, we can refer to it. Remove
14067 stale comment regarding lack thereof.
14068 Lee Schermerhorn
14069 Add brief discussion of mode flags.
14070 Lee Schermerhorn
14071 Attempt to clarify discussion of MPOL_DEFAULT.
14072 mtk
14073 Fix URI reference for libnuma.
14074
14075 mprotect.2
14076 mtk / Maxin John
14077 Remove EFAULT from errors. Under ENOMEM error, note that
14078 EFAULT was the error produced in some cases for kernels before
14079 2.4.19.
14080
14081 msgctl.2
14082 mtk, after a note from Filippo Santovito
14083 In the ipc_perm structure definition, some fields were
14084 incorrectly named: s/key/__key/ and s/seq/__seq/.
14085
14086 set_mempolicy.2
14087 Lee Schermerhorn
14088 Fix up the error return for nodemask containing nodes disallowed by
14089 the process' current cpuset. Disallowed nodes are now silently ignored,
14090 as long as the nodemask contains at least one node that is on-line,
14091 allowed by the process' cpuset and has memory.
14092
14093 Now that we have a cpuset man page, we can refer to cpusets directly
14094 in the man page text.
14095
14096 Lee Schermerhorn
14097 Another attempt to rationalize description of MPOL_DEFAULT.
14098
14099 Since ~2.6.25, the system default memory policy is "local allocation".
14100 MPOL_DEFAULT itself is a request to remove any non-default policy and
14101 "fall back" to the surrounding context. Try to say that without delving
14102 into implementation details.
14103
14104 Lee Schermerhorn
14105 Add discussion of mempolicy mode flags to set_mempolicy(2).
14106 This adds another reason for EINVAL.
14107
14108 setpgid.2
14109 mtk
14110 CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
14111
14112 semctl.2
14113 mtk, after a note from Filippo Santovito
14114 In the ipc_perm structure definition, some fields were
14115 incorrectly named: s/key/__key/ and s/seq/__seq/.
14116
14117 shmctl.2
14118 Filippo Santovito / mtk
14119 In the ipc_perm structure definition, some fields were
14120 incorrectly named: s/key/__key/ and s/seq/__seq/.
14121
14122 utime.2
14123 mtk
14124 CONFORMING TO: POSIX.1-2008 marks utime() obsolete.
14125 CONFORMING TO: POSIX.1-2008 removes the POSIX.1-2001 LEGACY
14126 marking of utimes(), so mention of this point has been
14127 removed from the page.
14128
14129 vfork.2
14130 mtk
14131 CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
14132
14133 atan2.3
14134 Fabian Kreutz
14135 SEE ALSO Add carg(3).
14136
14137 bcmp.3
14138 mtk
14139 CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
14140
14141 bsd_signal.3
14142 mtk
14143 CONFORMING TO: POSIX.1-2008 removes the specification ofcw
14144 bsd_signal().
14145
14146 bzero.3
14147 mtk
14148 CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
14149
14150 cexp2.3
14151 mtk
14152 AVAILABILITY: These functions are still not in glibc
14153 as at version 2.8.
14154
14155 clock_getres.3
14156 mtk
14157 SEE ALSO: Add clock_getcpuclockid(3).
14158
14159 clog2.3
14160 mtk
14161 AVAILABILITY: These functions are still not in glibc
14162 as at version 2.8.
14163
14164 ctime.3
14165 mtk
14166 POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
14167 as obsolete.
14168
14169 dprintf.3
14170 mtk
14171 CONFORMING TO: These functions are nowadays in POSIX.1-2008.
14172
14173 ecvt.3
14174 mtk
14175 CONFORMING TO: POSIX.1-2008 removes the specifications of
14176 ecvt() and fcvt().
14177
14178 ftime.3
14179 mtk
14180 CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
14181
14182 ftw.3
14183 mtk
14184 CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
14185
14186 gcvt.3
14187 mtk
14188 CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
14189
14190 getcwd.3
14191 Reuben Thomas / mtk
14192 Clarify description of getcwd() for buf==NULL case;
14193 CONFORMING TO: According to POSIX.1, the behavior of getcwd()
14194 is unspecified for the buf==NULL case.
14195 mtk
14196 Add an introductory paragraph giving an overview of what these
14197 functions do.
14198 Fix error in description of getwd(): it does not truncate the
14199 pathname; rather, it gives an error if the pathname exceeds
14200 PATH_MAX bytes.
14201 Rewrote RETURN VALUE section.
14202 Add EINVAL ENAMETOOLONG errors for getwd().
14203 Various other clarifications and wording fixes.
14204 CONFORMING TO: POSIX.1-2001 does not define any errors for
14205 getwd().
14206 CONFORMING TO: POSIX.1-2008 removes the specification of getwd().
14207
14208 gethostbyname.3
14209 mtk
14210 CONFORMING TO: POSIX.1-2008 removes the specifications of
14211 gethostbyname(), gethostbyaddr(), and h_errno.
14212
14213 gets.3
14214 mtk
14215 CONFORMING TO: POSIX.1-2008 removes the specification of gets().
14216
14217 iconv.3
14218 iconv_close.3
14219 iconv_open.3
14220 mtk
14221 VERSIONS: These functions are available in glibc since version 2.1.
14222
14223 index.3
14224 mtk
14225 CONFORMING TO: POSIX.1-2008 removes the specifications of
14226 index() and rindex().
14227
14228 isalpha.3
14229 mtk
14230 CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
14231
14232 makecontext.3
14233 mtk
14234 CONFORMING TO: POSIX.1-2008 removes the specifications of
14235 makecontext() and swapcontext().
14236
14237 memchr.3
14238 mtk
14239 VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
14240
14241 mempcpy.3
14242 mtk
14243 VERSIONS: mempcpy() since glibc 2.1.
14244
14245 mktemp.3
14246 mtk
14247 CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
14248
14249 opendir.3
14250 mtk
14251 CONFORMING TO: POSIX.1-2008 specifies fdopendir().
14252
14253 rand.3
14254 mtk
14255 CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
14256
14257 siginterrupt.3
14258 mtk
14259 CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
14260
14261 sigset.3
14262 mtk
14263 CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
14264 sigpause(), sigrelse(), and sigset() as obsolete.
14265
14266 strchr.3
14267 mtk
14268 VERSIONS: strchrnul() since glibc 2.1.1.
14269
14270 tempnam.3
14271 mtk
14272 CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
14273
14274 tmpnam.3
14275 mtk
14276 CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
14277
14278 toascii.3
14279 mtk
14280 CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
14281
14282 ualarm.3
14283 mtk
14284 CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
14285
14286 ulimit.3
14287 mtk
14288 CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
14289
14290 usleep.3
14291 mtk
14292 CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
14293
14294 standards.7
14295 mtk
14296 Updated details for POSIX.1-2008, and noted that if
14297 POSIX.1-2001 is listed in the CONFORMING TO section of a man
14298 page, then the reader can assume that the interface is also
14299 specified in POSIX.1-2008, unless otherwise noted.
14300
14301 time.7
14302 mtk
14303 SEE ALSO: Add clock_getcpuclockid(3).
14304
14305 udp.7
14306 mtk
14307 SEE ALSO: add udplite(7).
14308
14309
14310 Changes to individual pages (math functions)
14311 --------------------------------------------
14312
14313 Various changes here following on from the big update to the
14314 math pages in the previous release. Test results going back
14315 glibc 2.3.2 (so far) allowed updates to various pages to note
14316 changes in historical behavior for error reporting by math
14317 functions. Thanks to the following people for providing me
14318 with test results on various distributions and glibc versions:
14319 Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
14320 Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
14321 Soh Kam Yung, and Stephane Chazelas
14322
14323 cabs.3
14324 cacos.3
14325 cacosh.3
14326 carg.3
14327 casin.3
14328 casinh.3
14329 catan.3
14330 catanh.3
14331 ccos.3
14332 ccosh.3
14333 cexp.3
14334 cimag.3
14335 clog.3
14336 clog10.3
14337 conj.3
14338 cpow.3
14339 cproj.3
14340 creal.3
14341 csin.3
14342 csinh.3
14343 csqrt.3
14344 ctan.3
14345 ctanh.3
14346 exp10.3
14347 exp2.3
14348 fdim.3
14349 fenv.3
14350 fma.3
14351 fmax.3
14352 fmin.3
14353 log2.3
14354 lrint.3
14355 lround.3
14356 nan.3
14357 pow10.3
14358 remquo.3
14359 round.3
14360 scalbln.3
14361 sincos.3
14362 tgamma.3
14363 trunc.3
14364 mtk
14365 Added VERSIONS section noting that these functions first
14366 appeared in glibc in version 2.1.
14367
14368 cosh.3
14369 mtk
14370 BUGS: In glibc 2.3.4 and earlier, an FE_OVERFLOW exception is not
14371 raised when an overflow occurs.
14372
14373 fenv.3
14374 mtk / Fabian Kreuz
14375 Provide more detail in the description of rounding modes.
14376 Add text describing FLT_ROUNDS (formerly in fma.3).
14377 Add BUGS section pointing out the FLT_ROUNDS does not reflect
14378 changes by fesetround().
14379
14380 fma.3
14381 mtk
14382 Remove text about FLT_ROUNDS, replacing with a cross-reference
14383 to fenv(3).
14384
14385 fpclassify.3
14386 mtk
14387 CONFORMING TO: Note that the standards provide a weaker guarantee
14388 for the return value of isinf().
14389
14390 log.3
14391 mtk
14392 BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
14393 FE_INVALID exception.
14394
14395 lround.3
14396 mtk
14397 Add reference to fenv(3) for discussion of current rounding mode.
14398
14399 nextafter.3
14400 mtk
14401 BUGS: In glibc 2.5 and earlier these functions do not raise an
14402 FE_UNDERFLOW exception on underflow.
14403
14404 pow.3
14405 mtk
14406 BUGS: described buggy NaN return when x is negative and y is large.
14407 See also: http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866.
14408 BUGS: Note the bogus FE_INVALID exception that occurred in glibc
14409 2.3.2 and earlier on overflow and underflow.
14410
14411 remainder.3
14412 mtk
14413 Add reference to fenv(3) for discussion of current rounding mode.
14414
14415 round.3
14416 mtk
14417 Add reference to fenv(3) for discussion of current rounding mode.
14418
14419 scalb.3
14420 mtk
14421 CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
14422
14423 tgamma.3
14424 mtk
14425 BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
14426 instead of a pole error.
14427
14428 y0.3
14429 mtk
14430 In glibc 2.3.2 and earlier, these functions do not raise an
14431 FE_INVALID exception for a domain error.
14432
14433 math_error.7
14434 mtk
14435 Rewrite introductory paragraph.
14436 Point out that a NaN is commonly returned by functions that report
14437 a domain error.
14438
14439
14440 ==================== Changes in man-pages-3.08 ====================
14441
14442 Released: 2008-08-27, Zurich
14443
14444
14445 Contributors
14446 ------------
14447
14448 The following people contributed notes, ideas, or patches that have
14449 been incorporated in changes in this release:
14450
14451 Gerrit Renker <gerrit@erg.abdn.ac.uk>
14452 Li Zefan <lizf@cn.fujitsu.com>
14453 Mike Bianchi <MBianchi@foveal.com>
14454 Sam Varshavchik <mrsam@courier-mta.com>
14455 Venkatesh Srinivas <me@acm.jhu.edu>
14456 Vijay Kumar <vijaykumar@bravegnu.org>
14457
14458 Apologies if I missed anyone!
14459
14460
14461 New and rewritten pages
14462 -----------------------
14463
14464 getnetent_r.3
14465 mtk
14466 Documents getnetent_r(), getnetbyname_r(),
14467 and getnetbyaddr_r(), the reentrant equivalents of
14468 getnetent(), getnetbyname(), and getnetbyaddr().
14469
14470 getprotoent_r.3
14471 mtk
14472 Documents getprotoent_r(), getprotobyname_r(), and
14473 getprotobynumber_r(), the reentrant equivalents of
14474 getprotoent(), getprotobyname(), and getprotobynumber().
14475
14476 getrpcent_r.3
14477 mtk
14478 Documents getrpcent_r(), getrpcbyname_r(), and
14479 getrpcbynumber_r(), the reentrant equivalents of
14480 getrpcent(), getrpcbyname(), and getrpcbynumber().
14481
14482 getservent_r.3
14483 mtk
14484 Documents getservent_r(), getservbyname_r(), and
14485 getservbyport_r(), the reentrant equivalents of
14486 getservent(), getservbyname(), and getservbyport().
14487
14488 numa.7
14489 mtk
14490 A new page giving overview details for the Linux NUMA interfaces.
14491 Incorporates some material from mbind.2, and the description
14492 of /proc/PID/numa_maps from proc.5.
14493
14494
14495 Newly documented interfaces in existing pages
14496 ---------------------------------------------
14497
14498 crypt.3
14499 mtk
14500 Add description of crypt_r().
14501
14502
14503 New and changed links
14504 ---------------------
14505
14506 crypt.3
14507 mtk
14508 New link to crypt.3.
14509
14510 getnetbyname_r.3
14511 getnetbyaddr_r.3
14512 mtk
14513 New links to new getnetent_r.3.
14514
14515 getprotobyname_r.3
14516 getprotobynumber_r.3
14517 mtk
14518 New links to new getprotoent_r.3.
14519
14520 getrpcbyname_r.3
14521 getrpcbynumber_r.3
14522 mtk
14523 New links to new getrpcent_r.3.
14524
14525 getservbyname_r.3
14526 getservbyport_r.3
14527 mtk
14528 New links to new getservent_r.3.
14529
14530 numa_maps.5
14531 mtk
14532 Link to new numa(7) page, which incorporates the
14533 /proc/PID/numa_maps description.
14534 As part of the numactl() package, the /proc/PID/numa_maps
14535 documentation was in a numa_maps.5 page; this link
14536 ensures that "man 5 numa_maps" still works.
14537 (Eventually, we may want to remove this link.)
14538
14539
14540 Global changes
14541 --------------
14542
14543 get_mempolicy.2
14544 mbind.2
14545 move_pages.2
14546 set_mempolicy.2
14547 mtk
14548 Add reference to numa(7) for information on library support.
14549 Added a VERSIONS section.
14550 SEE ALSO: Add numa(7).
14551
14552 faccessat.2
14553 fchmodat.2
14554 fchownat.2
14555 fstatat.2
14556 mkdirat.2
14557 mknodat.2
14558 linkat.2
14559 openat.2
14560 readlinkat.2
14561 renameat.2
14562 symlinkat.2
14563 unlinkat.2
14564 mkfifoat.3
14565 psignal.3
14566 strsignal.3
14567 mtk
14568 These interfaces are specified in POSIX.1-2008.
14569
14570
14571 Changes to individual pages
14572 ---------------------------
14573
14574 eventfd.2
14575 Vijay Kumar
14576 When an eventfd overflows, select() indicates the file as both
14577 readable and writable (not as having an exceptional condition).
14578
14579 fcntl.2
14580 mtk
14581 F_DUPFD_CLOEXEC is specified in POSIX.1-2008.
14582
14583 getrlimit.2
14584 mtk
14585 NOTES: Add text mentioning the shell 'ulimit' (or 'limit')
14586 built-in command for setting resource limits.
14587
14588 gettimeofday.2
14589 mtk
14590 CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete.
14591
14592 link.2
14593 mtk
14594 Note kernel version where Linux stopped following symbolic
14595 links in 'oldpath'; see also http://lwn.net/Articles/294667.
14596 POSIX.1-2008 makes it implementation-dependent whether or not
14597 'oldpath' is dereferenced if it is a symbolic link.
14598 Add a reference to linkat(2) for an interface that allows
14599 precise control of the treatment of symbolic links.
14600
14601 mbind.2
14602 mtk
14603 Remove material on library support and numactl; that material
14604 is now in numactl.7.
14605
14606 mmap.2
14607 mtk
14608 Add kernel version numbers for MAP_32BIT.
14609 Add some details on MAP_32BIT (see http://lwn.net/Articles/294642).
14610
14611 move_pages.2
14612 mtk
14613 Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections.
14614
14615 open.2
14616 mtk
14617 O_CLOEXEC is specified in POSIX.1-2008.
14618
14619 socket.2
14620 mtk
14621 s/d/domain/ for name of argument.
14622 Add reference to socket(2) for further information on
14623 domain, type, and protocol arguments.
14624
14625 utimensat.2
14626 mtk
14627 CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens().
14628
14629 dirfd.3
14630 mtk
14631 CONFORMING TO: Add POSIX.1-2008; other minor changes.
14632
14633 exec.3
14634 mtk
14635 Small rewording: "s/returned/failed with/ [an error]".
14636
14637 fmemopen.3
14638 mtk
14639 Since glibc 2.7, it is possible to seek past the end of
14640 a stream created by open_memstream(). Add a BUGS section
14641 describing the bug in earlier glibc versions.
14642
14643 gethostbyname.3
14644 mtk
14645 Clarify exactly which functions are obsoleted by getnameinfo()
14646 and getaddrinfo().
14647
14648 getnetent.3
14649 mtk
14650 Rephrase description in terms of a database, rather than a file.
14651 Note that each of the get*() functions opens a connection to
14652 the database if necessary.
14653 The database connection is held open between get*() calls if
14654 'stayopen' is non-zero (not necessarily 1).
14655 s/zero terminated list/NULL-terminated list/
14656 mtk
14657 In glibc 2.2, the type of the 'net' argument for getnetbyaddr()
14658 changed from 'long' to 'uint32_t'.
14659 mtk
14660 Note that the gethostbyaddr() 'net' argument is in host byte order.
14661 mtk
14662 RETURN VALUE: emphasize that returned pointer points to a
14663 statically allocated structure.
14664 SEE ALSO: add getnetent_r.3.
14665
14666 getprotoent.3
14667 mtk
14668 Rephrase description in terms of a database, rather than a file.
14669 Note that each of the get*() functions opens a connection to
14670 the database if necessary.
14671 The database connection is held open between get*() calls if
14672 'stayopen' is non-zero (not necessarily 1).
14673 s/zero terminated list/NULL-terminated list/
14674 mtk
14675 RETURN VALUE: emphasize that returned pointer points to a
14676 statically allocated structure.
14677 SEE ALSO: add getprotoent_r.3.
14678
14679 getrpcent.3
14680 mtk
14681 s/rpc/RPC/.
14682 Rephrase description in terms of a database, rather than a file.
14683 Note that each of the get*() functions opens a connection to
14684 the database if necessary.
14685 s/zero terminated list/NULL-terminated list/
14686 mtk
14687 RETURN VALUE: emphasize that returned pointer points to a
14688 statically allocated structure.
14689 SEE ALSO: add getrpcent_r.3.
14690
14691 getservent.3
14692 mtk
14693 Rephrase description in terms of a database, rather than a file.
14694 Note that each of the get*() functions opens a connection to
14695 the database if necessary.
14696 The database connection is held open between get*() calls if
14697 'stayopen' is non-zero (not necessarily 1).
14698 s/zero terminated list/NULL-terminated list/
14699 mtk
14700 RETURN VALUE: emphasize that returned pointer points to a
14701 statically allocated structure.
14702 SEE ALSO: add getservent_r.3.
14703
14704 mkdtemp.3
14705 mtk
14706 CONFORMING TO: this function is specified in POSIX.1-2008.
14707
14708 mq_notify.3
14709 Venkatesh Srinivas
14710 s/sigev_notify_function/sigev_thread_function/
14711 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=494956.
14712
14713 realpath.3
14714 mtk
14715 Relocate text for resolved_path==NULL case to DESCRIPTION.
14716 POSIX.1-2001 leaves the resolved_path==NULL case as
14717 implementation-defined; POSIX.1-2008 specifies the behavior
14718 described in this man page.
14719
14720 sem_init.3
14721 mtk
14722 POSIX.1-2008 rectifies the POSIX.1-2001 omission, specifying
14723 that zero is returned by a successful sem_init() call.
14724
14725 core.5
14726 Mike Bianchi / mtk
14727 Make the page more helpful to non-programmers by referencing
14728 the documentation of the shell's 'ulimit' command in the
14729 discussion of RLIMIT_CORE and RLIMIT_FSIZE.
14730 SEE ALSO: Add bash(1).
14731 mtk
14732 Note that a core dump file can be used in a debugger.
14733
14734 proc.5
14735 mtk
14736 Remove /proc/PID/numa_maps material (it is now in numa(7)).
14737
14738 cpuset.7
14739 mtk
14740 SEE ALSO: Add numa(7).
14741
14742 inotify.7
14743 mtk / Li Zefan
14744 Explain bug that occurred in coalescing identical events in
14745 kernels before 2.6.25.
14746 (See commit 1c17d18e3775485bf1e0ce79575eb637a94494a2
14747 "A potential bug in inotify_user.c" in the 2.6.25 Changelog.)
14748
14749 pthreads.7
14750 mtk
14751 Update thread-safe functions list with changes in POSIX.1-2008.
14752 SEE ALSO: add proc(5).
14753
14754 signal.7
14755 mtk
14756 Update list of async-signal-safe functions for POSIX.1-2008.
14757
14758
14759 ==================== Changes in man-pages-3.09 ====================
14760
14761 Released: 2008-09-10, Munich
14762
14763
14764 Contributors
14765 ------------
14766
14767 The following people contributed notes, ideas, or patches that have
14768 been incorporated in changes in this release:
14769
14770 Bernd Eckenfels <be-mail2006@lina.inka.de>
14771 Bruno Haible <bruno@clisp.org>
14772 Carsten Emde <Carsten.Emde@osadl.org>
14773 Christopher Head <chead@telus.net>
14774 H. Peter Anvin <hpa@zytor.com>
14775 Jan Engelhardt <jengelh@medozas.de>
14776 Joe Korty <joe.korty@ccur.com>
14777 Marko Kreen <markokr@gmail.com>
14778 Martin (Joey) Schulze <joey@infodrom.org>
14779 Mats Wichmann <mats.d.wichmann@intel.com>
14780 Michael Schurter <michael@susens-schurter.com>
14781 Mike Bianchi <MBianchi@foveal.com>
14782 Mike Frysinger <vapier@gentoo.org>
14783 Sam Varshavchik <mrsam@courier-mta.com>
14784 Suka <sukadev@us.ibm.com>
14785 Timothy S. Nelson <wayland@wayland.id.au>
14786 Tolga Dalman <tdalman@project-psi.org>
14787 Török Edwin <edwintorok@gmail.com>
14788
14789 Apologies if I missed anyone!
14790
14791
14792 New and rewritten pages
14793 -----------------------
14794
14795 fopencookie.3
14796 mtk
14797 Document fopencookie(3), a library function that allows
14798 custom implementation of a stdio stream.
14799
14800 networks.5
14801 Martin (Joey) Schulze, with a few light edits by mtk
14802 Documents the /etc/networks file.
14803
14804
14805 Global changes
14806 --------------
14807
14808 Various pages
14809 mtk
14810 s/time zone/timezone/ for consistency across pages and
14811 with POSIX.1.
14812
14813 kill.2
14814 sigaction.2
14815 sigpending.2
14816 sigprocmask.2
14817 sigsuspend.2
14818 confstr.3
14819 ctermid.3
14820 ctime.3
14821 ferror.3
14822 flockfile.3
14823 fopen.3
14824 getaddrinfo.3
14825 getgrnam.3
14826 getnameinfo.3
14827 getopt.3
14828 getpwnam.3
14829 longjmp.3
14830 popen.3
14831 rand.3
14832 readdir.3
14833 setjmp.3
14834 sigsetops.3
14835 sigwait.3
14836 strtok.3
14837 tzset.3
14838 unlocked_stdio.3
14839 mtk
14840 Add/fix feature test macro requirements.
14841
14842
14843 Changes to individual pages
14844 ---------------------------
14845
14846 fcntl.2
14847 mtk, after a note by Mike Bianchi
14848 More clearly and consistently describe whether
14849 or not the third argument to fcntl() is required,
14850 and what its type should be.
14851 mtk
14852 Move description of negative l_len from NOTES, integrating
14853 it into the discussion of file locking.
14854 Minor rewrites of the text on file locking.
14855
14856 getrusage.2
14857 Bernd Eckenfels
14858 SEE ALSO: Add clock(3), clock_gettime(3).
14859 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=353475
14860
14861 ioctl_list.2
14862 mtk
14863 Remove old sentence about where to send updates for this page.
14864 Add more detail on mount options that prevent updates to atime.
14865
14866 sched_setscheduler.2
14867 Carsten Emde
14868 Update kernel version numbers relating to real-time support.
14869
14870 stat.2
14871 H. Peter Anvin
14872 Note that lstat() will generally not trigger automounter
14873 action, whereas stat() will.
14874
14875 clock.3
14876 Bernd Eckenfels
14877 SEE ALSO: Add clock_gettime(3).
14878 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=353475
14879
14880 clock_getres.3
14881 Tolga Dalman / mtk
14882 Add "Link with -lrt" to SYNOPSIS; remove now redundant
14883 sentence mentioning librt from NOTES.
14884
14885 getdate.3
14886 mtk
14887 Rewrite description of getdate_r() and integrate into main text
14888 (rather than describing in NOTES).
14889 Other parts rewritten for greater clarity.
14890 Make it clearer in the main text that glibc does not implement %Z;
14891 remove discussion of that point from NOTES.
14892 Added an example program.
14893
14894 hsearch.3
14895 mtk
14896 Noted that table size as specified by 'nel' is immutable.
14897 Described differences between hsearch() and hsearch_r().
14898 Added missing pieces to RETURN VALUE.
14899 Added a number of new entries under ERRORS.
14900 NOTES: added some basic advice on sizing the hash table;
14901 noted that when a table is destroyed, the caller is responsible
14902 for freeing the buffers pointed to by 'key' and 'data' fields.
14903 One of the BUGS was fixed in glibc 2.3.
14904 Rewrote and clarified various other pieces.
14905 Rename arguments for reentrant functions, using same name as
14906 glibc headers: s/ret/retval/; s/tab/htab/.
14907 mtk, after a suggestion by Timothy S. Nelson
14908 Integrate discussion of reentrant functions into main discussion
14909 (rather than as a short paragraph at the end).
14910
14911 iconv.3
14912 Bruno Haible
14913 Describe "shift sequence" input.
14914
14915 ptsname.3
14916 sukadev
14917 Fix return type of ptsname_r() in SYNOPSIS.
14918
14919 readdir.3
14920 H. Peter Anvin
14921 s/stat(2)/lstat(2)/ when discussing d_type (since we
14922 are talking about a case where we might be interested to
14923 whether the file itself is a symbolic link).
14924
14925 sigsetops.3
14926 Chris Head, signed-off-by: Mike Frysinger
14927 Fix typo: s/sigdelset/sigorset/
14928
14929 proc.5
14930 Mats Wichmann / mtk
14931 s/\[number]/[pid]/ in file names for /proc/PID files.
14932 And similar changes for task/[tid] sub-directories.
14933 mtk / Mats Wichmann
14934 In the description if /proc/[pid]/environ, remove reference to
14935 lilo(8)/grub(8) since there seems to be nothing in those pages
14936 that related to this /proc file.
14937 Michael Schurter / mtk
14938 Remove sentence wrongly saying that /proc/meminfo reports
14939 info in bytes;
14940 see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=462969
14941 mtk
14942 Note that /proc/meminfo reports system-wide memory usage
14943 statistics.
14944 Joe Korty
14945 Document new fields in /proc/interrupts that were added in
14946 Linux 2.6.24.
14947
14948 unix.7
14949 Marko Kreen
14950 Since glibc 2.8, _GNU_SOURCE must be defined in order to get
14951 the definition of the ucred structure from <sys/socket.h>.
14952
14953
14954 ==================== Changes in man-pages-3.10 ====================
14955
14956 Released: 2008-09-23, Munich
14957
14958
14959 Contributors
14960 ------------
14961
14962 The following people contributed notes, ideas, or patches that have
14963 been incorporated in changes in this release:
14964
14965 André Goddard Rosa <andre.goddard@gmail.com>
14966 George Spelvin <linux@horizon.com>
14967 Pavel Heimlich <tropikhajma@seznam.cz>
14968 Sam Varshavchik <mrsam@courier-mta.com>
14969 John Reiser <jreiser@bitwagon.com>
14970
14971 Apologies if I missed anyone!
14972
14973
14974 Global changes
14975 --------------
14976
14977 closedir.3
14978 dirfd.3
14979 readdir.3
14980 rewinddir.3
14981 scandir.3
14982 seekdir.3
14983 telldir.3
14984 mtk
14985 Fix 'dir' argument name: should be 'dirp'.
14986 POSIX.1-2008 and glibc call this argument 'dirp' (consistent
14987 with the fact that it is a *pointer* to a DIR structure).
14988
14989
14990 Changes to individual pages
14991 ---------------------------
14992
14993 clone.2
14994 mtk, after a comment by John Reiser
14995 Clarify text describing getpid() caching bug for clone() wrapper.
14996 See also:
14997 http://sourceware.org/bugzilla/show_bug.cgi?id=6910
14998 https://bugzilla.redhat.com/show_bug.cgi?id=417521
14999
15000 getpid.2
15001 mtk, after a comment by John Reiser
15002 Describe getpid()'s PID caching and its consequences.
15003
15004 timerfd_create.2
15005 Sam Varshavchik
15006 s/it_interval/it_value/ when talking about TIMERFD_ABSTIME.
15007
15008 closedir.3
15009 George Spelvin
15010 Clarify closedir()'s treatment of underlying file descriptor.
15011
15012 tsearch.3
15013 André Goddard Rosa
15014 Fix memory leak in example program.
15015 Add use of tdestroy to example program.
15016 mtk
15017 Add "#define _GNU_SOURCE" to example program.
15018
15019 protocols.5
15020 mtk, after a note from Pavel Heimlich
15021 Remove SEE ALSO references to nonexistent Guides to Yellow Pages
15022
15023 services.5
15024 mtk
15025 Remove some out-of-date bugs.
15026 mtk, after a note from Pavel Heimlich
15027 Remove SEE ALSO references to nonexistent Guides to Yellow Pages
15028 and Bind/Hesiod docs.
15029 mtk
15030 Remove crufty text about use of comma instead of slash to separate
15031 port and protocol.
15032
15033
15034 ==================== Changes in man-pages-3.11 ====================
15035
15036 Released: 2008-10-07, Munich
15037
15038
15039 Contributors
15040 ------------
15041
15042 The following people contributed notes, ideas, or patches that have
15043 been incorporated in changes in this release:
15044
15045 André Goddard Rosa <andre.goddard@gmail.com>
15046 Eugene V. Lyubimkin <jackyf.devel@gmail.com>
15047 Gergely Soos <sogerc1@gmail.com>
15048 Kirill A. Shutemov <kirill@shutemov.name>
15049 Marko Kreen <markokr@gmail.com>
15050 Maxin B. John <maxin.john@ap.sony.com>
15051 Maxin John <maxin.john@gmail.com>
15052 Michael Kerrisk <mtk.manpages@gmail.com>
15053 Nicolas François <nicolas.francois@centraliens.net>
15054 Pavel Heimlich <tropikhajma@seznam.cz>
15055 Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
15056 Sam Varshavchik <mrsam@courier-mta.com>
15057
15058 Apologies if I missed anyone!
15059
15060
15061 New and rewritten pages
15062 -----------------------
15063
15064 umount.2
15065 Michael Kerrisk
15066 Create a new page for umount() and umount2() by extracting
15067 existing material from mount.2 page.
15068
15069
15070 New and changed links
15071 ---------------------
15072
15073 umount2.2
15074 Michael Kerrisk
15075 Change link to point to new umount.2
15076 The umount2() material migrated from mount.2 to umount.2
15077
15078
15079 Changes to individual pages
15080 ---------------------------
15081
15082 execve.2
15083 Michael Kerrisk
15084 _SC_ARG_MAX is no longer necessarily constant
15085 POSIX.1-2001 says that the values returned by sysconf()
15086 are constant for the life of the process.
15087 But the fact that, since Linux 2.6.23, ARG_MAX is settable
15088 via RLIMIT_STACK means _SC_ARG_MAX is no longer constant,
15089 since it can change at each execve().
15090 Michael Kerrisk
15091 Linux now imposes a floor on the ARG_MAX limit
15092 Starting with Linux 2.6.23, the ARG_MAX limit became
15093 settable via (1/4 of) RLIMIT_STACK. This broke ABI
15094 compatibility if RLIMIT_STACK was set such that ARG_MAX
15095 was < 32 pages. Document the fact that since 2.6.25
15096 Linux imposes a floor on ARG_MAX, so that the old limit
15097 of 32 pages is guaranteed.
15098
15099 For some background on the changes to ARG_MAX in
15100 kernels 2.6.23 and 2.6.25, see:
15101 http://sourceware.org/bugzilla/show_bug.cgi?id=5786
15102 http://bugzilla.kernel.org/show_bug.cgi?id=10095
15103 http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
15104 checked into 2.6.25 as
15105 commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.
15106
15107 Also some reordering/rewording of the discussion of ARG_MAX.
15108
15109 fallocate.2
15110 Michael Kerrisk
15111 Note lack of glibc wrapper; caller must use syscall(2)
15112 Glibc doesn't (and quite probably won't) include a
15113 wrapper for this system call. Therefore, point out that
15114 potential callers will need to use syscall(2), and rewrite
15115 the RETURN VALUE text to show things as they would be if
15116 syscall() is used.
15117
15118 Michael Kerrisk
15119 Refer reader to posix_fallocate(3) for portable interface
15120 Add a para to start of page that points out that this is the
15121 low-level, Linux-specific API, and point the reader to
15122 posix_fallocate(3) for the portable API.
15123
15124 getdents.2
15125 readdir.3
15126 Michael Kerrisk
15127 d_type is currently only supported on ext[234]
15128 As at kernel 2.6.27, only ext[234] support d_type.
15129 On other file systems, d_type is always set to DT_UNKNOWN (0).
15130
15131 getdents.2
15132 Michael Kerrisk
15133 Add an example program
15134 Michael Kerrisk
15135 comment out linux_dirent fields with varying location
15136 The location of the fields after d_name varies according to
15137 the size of d_name. We can't properly declare them in C;
15138 therefore, put those fields inside a comment.
15139 Michael Kerrisk
15140 The DT_* constants are defined in <dirent.h>
15141 Michael Kerrisk
15142 Remove header files from SYNOPSIS
15143 None of the header files provides what is needed.
15144 Calls are made via syscall(2).
15145 Michael Kerrisk
15146 The programmer must define the linux_dirent structure
15147 Point out that this structure is not defined in glibc headers.
15148 Michael Kerrisk
15149 s/dirent/linux_dirent/
15150 The structure isn't currently defined in glibc headers,
15151 and the kernel name of the structure is 'linux_dirent' (as
15152 was already used in some, but not all, places in this page).
15153
15154 getrlimit.2
15155 Michael Kerrisk
15156 Reword/relocate discussion of BSD's historical RLIMIT_OFILE
15157 The old sentence sat on its own in an odd place, and anyway the
15158 modern BSDs use the name RLIMIT_NOFILE.
15159 Michael Kerrisk
15160 Refer to execve(2) for RLIMIT_STACK's effect on ARG_MAX
15161 Refer the reader to new text in execve(2) that describes how
15162 (since Linux 2.6.23) RLIMIT_STACK determines the value of ARG_MAX.
15163
15164 getrusage.2
15165 Michael Kerrisk
15166 Rusage measures are preserved across execve(2)
15167
15168 mlock.2
15169 Maxin John
15170 Add EAGAIN error.
15171
15172 move_pages.2
15173 Nicolas François
15174 Make a detail of EPERM error more precise
15175
15176 mount.2
15177 Michael Kerrisk
15178 Add description of per-process namespaces
15179 Describe per-process namespaces, including discussion
15180 of clone() and unshare CLONE_NEWNS, and /proc/PID/mounts.
15181 Michael Kerrisk
15182 List a few other file systems that we may see in /proc/filesystems
15183 Add some modern file systems to that list (xfs, jfs, ext3,
15184 reiserfs).
15185 Michael Kerrisk
15186 Document MS_SILENT (and MS_VERBOSE)
15187
15188 mount.2
15189 umount.2
15190 Michael Kerrisk
15191 Split umount*() out into a separate page
15192 The length of this page means that it's becoming difficult
15193 to parse which info is specific to mount() versus
15194 umount()/umount2(), so split the umount material out into
15195 its own page.
15196
15197 pause.2
15198 Michael Kerrisk
15199 Remove mention of words "library function"
15200 This really is a system call.
15201
15202 readdir.2
15203 Michael Kerrisk
15204 The programmer must declare the old_linux_dirent structure
15205 Glibc does not provide a definition of this structure.
15206 Michael Kerrisk
15207 s/dirent/old_linux_dirent/
15208 Nowadays, this is the name of the structure in the
15209 kernel sources.
15210 Michael Kerrisk
15211 Remove words "which may change"
15212 These words are slightly bogus: although the interface
15213 is obsolete, for ABI-compatibility reasons, the kernel folk
15214 should never be changing this interface.
15215 Michael Kerrisk
15216 Remove header files from SYNOPSIS
15217 glibc doesn't provide any support for readdir(2),
15218 so remove these header files (which otherwise suggest
15219 that glibc does provide the required pieces).
15220
15221 recv.2
15222 Nicolas François
15223 Move kernel version number to first mention to MSG_ERRQUEUE.
15224
15225 semop.2
15226 Kirill A. Shutemov
15227 Fix typo in example
15228 (The '&' before sop in the semop() call is unneeded.)
15229
15230 send.2
15231 Michael Kerrisk
15232 Make kernel version for MSG_CONFIRM more precise
15233 s/2.3+ only/Since Linux 2.3.15/
15234
15235 sigaction.2
15236 Michael Kerrisk
15237 Refer reader to signal(7) for an overview of signals
15238 Explain semantics of signal disposition during fork() and execve()
15239 Refer to signal(7) for more details on signal mask.
15240
15241 sigaltstack.2
15242 Michael Kerrisk
15243 Explain inheritance of alternate signal stack across fork(2)
15244
15245 sigwaitinfo.2
15246 Michael Kerrisk
15247 Distinguish per-thread and process-wide signals
15248 A sentence clarifying that pending signal set is union of
15249 per-thread and process-wide pending signal sets.
15250
15251 Michael Kerrisk
15252 These interfaces have per-thread semantics
15253 The page was previously fuzzy about whether the these interfaces
15254 have process-wide or per-thread semantics. (E.g., now the
15255 page states that the calling *thread* (not process) is suspended
15256 until the signal is delivered.)
15257
15258 sigpending.2
15259 Michael Kerrisk
15260 Explain effect of fork() and execve() for pending signal set
15261 Michael Kerrisk
15262 Explain how thread's pending signal set is defined
15263 The pending set is the union of per-thread pending signals
15264 and process-wide pending signals.
15265
15266 sigprocmask.2
15267 Michael Kerrisk
15268 Explain effects of fork() and execve() for signal mask
15269
15270 splice.2
15271 Michael Kerrisk
15272 Note that SPLICE_F_MOVE is a no-op since kernel 2.6.21
15273
15274 syscall.2
15275 Michael Kerrisk
15276 Add more detail about wrapper functions
15277 Add a few more details about work generally done by wrapper
15278 functions. Note that syscall(2) performs the same steps.
15279
15280 tkill.2
15281 Michael Kerrisk
15282 EINVAL error can also occur for invalid TGID
15283 The EINVAL error on an invalid TGID for tgkill() was
15284 not documented; this change documents it.
15285
15286 utimensat.2
15287 Michael Kerrisk
15288 POSIX.1-2008 revision will likely affect FTMs for futimens()
15289 Make it clear that the POSIX.1 revision that is likely
15290 to affect the feature test macro requirements for futimens()
15291 is POSIX.1-2008.
15292 Nicolas François
15293 Make various wordings a little more precise.
15294 The times argument point to *an array of* structures, and the
15295 man-page should say that consistently.
15296
15297 wait4.2
15298 Michael Kerrisk
15299 wait3() is a library function layered on wait4().
15300 On Linux wait3() is a library function implemented on top
15301 of wait4(). (Knowing this is useful when using strace(2),
15302 for example.)
15303
15304 atan2.3
15305 Nicolas François
15306 Fix error in description of range or return value
15307 In recent changes to the man page, mtk accidentally changed
15308 the description of the return value range to -pi/2..pi/2;
15309 the correct range is -pi..pi.
15310
15311 cmsg.3
15312 Nicolas François
15313 Add parentheses after macro names.
15314
15315 ctime.3
15316 Michael Kerrisk
15317 Clarify mktime()'s use of tm_isdst
15318 Describe use of tm_isdst for input to mktime();
15319 explain how mktime() modifies this field.
15320 (This field is left unchanged in case of error.)
15321
15322 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=500178
15323 Michael Kerrisk
15324 Clarify wording for ctime_r() and asctime_r() to indicate that
15325 the buffer must be at least 26 *bytes*.
15326 Michael Kerrisk
15327 Minor rewording of mktime() description.
15328
15329 floor.3
15330 Nicolas François
15331 floor.3: Fix error in description: s/smallest/largest/
15332
15333 hsearch.3
15334 André Goddard Rosa
15335 Call hdestroy() after using hash table created by hcreate(),
15336 for the sake of completeness
15337
15338 mq_getattr.3
15339 Michael Kerrisk
15340 mq_getattr() and mq_setattr() are layered on mq_getsetattr(2)
15341 mq_getattr() and mq_setattr() are library functions layered on
15342 top of the mq_getsetattr(2) system call.
15343 (This is useful info for users of strace(1).)
15344
15345 mq_receive.3
15346 Michael Kerrisk
15347 mq_send() is a library function layered on mq_timedreceive() syscall
15348 This info is useful for users of strace(1).
15349
15350 mq_send.3
15351 Michael Kerrisk
15352 mq_send() is a library function layered on mq_timedsend() syscall
15353 This info is useful for users of strace(1).
15354
15355 nextafter.3
15356 Nicolas François
15357 Make description more precise: s/next/largest/
15358
15359 readdir.3
15360 Michael Kerrisk
15361 SEE ALSO: add getdents(2)
15362 Because readdir() is implemented on top of getdents(2).
15363
15364 realpath.3
15365 Michael Kerrisk
15366 Clarify that returned pathname is NULL terminated
15367 Also clarify that null-byte is included in PATH_MAX limit.
15368
15369 proc.5
15370 Michael Kerrisk
15371 Rewrite and simplify description of /proc/mounts
15372 Most of the relevant discussion is now under /proc/PID/mounts;
15373 all that needs to be here is a mention of the pre-2.4.19
15374 system-wide namespace situation, and a reference to the
15375 discussion under /proc/PID/mounts.
15376 Michael Kerrisk
15377 Add description of /proc/PID/mounts
15378 Largely cribbed from existing /proc/mounts discussion, which is
15379 about to be rewritten.
15380
15381 mq_overview.7
15382 Michael Kerrisk
15383 Add mq_notify() to list of lib. functions and syscalls in MQ API
15384
15385 signal.7
15386 Michael Kerrisk
15387 Improve description in NAME section
15388 Add mention of sigaltstack(2).
15389 Describe syscalls that synchronously wait for a signal,
15390 Give overview of syscalls that block until a signal is caught
15391 Add overview of interfaces for sending signals.
15392
15393 Michael Kerrisk
15394 Describe semantics w.r.t. fork() and execve()
15395 Include text describing semantics of fork() and execve() for
15396 signal dispositions, signal mask, and pending signal set.
15397
15398
15399 ==================== Changes in man-pages-3.12 ====================
15400
15401 Released: 2008-10-29, Bucaramanga
15402
15403
15404 Contributors
15405 ------------
15406
15407 The following people contributed notes, ideas, or patches that have
15408 been incorporated in changes in this release:
15409
15410 Bert Wesarg <bert.wesarg@googlemail.com>
15411 Christian Grigis <glove@earthling.net>
15412 Christoph Hellwig <hch@infradead.org>
15413 Didier <did447@gmail.com>
15414 Halesh S <halesh.s@india.com>
15415 J.H.M. Dassen (Ray) <fsmla@xinara.org>
15416 Jason Spiro <jasonspiro4@gmail.com>
15417 Lefteris Dimitroulakis <edimitro@tee.gr>
15418 Michael B. Trausch <mike@trausch.us>
15419 Pierre Cazenave <pwc101@noc.soton.ac.uk>
15420 Stefan Puiu <stefan.puiu@gmail.com>
15421
15422 Apologies if I missed anyone!
15423
15424
15425 New and rewritten pages
15426 -----------------------
15427
15428 pthread_attr_init.3
15429 Michael Kerrisk
15430 New page for pthread_attr_init(3) and pthread_attr_destroy(3)
15431
15432 pthread_attr_setdetachstate.3
15433 Michael Kerrisk
15434 New page for pthread_attr_setdetachstate(3) and
15435 pthread_attr_getdetachstate(3)
15436
15437 pthread_attr_setguardsize.3
15438 Michael Kerrisk
15439 New page for pthread_attr_setguardsize(3) and
15440 pthread_attr_getguardsize(3)
15441
15442 pthread_attr_setscope.3
15443 Michael Kerrisk
15444 New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
15445
15446 pthread_attr_setstack.3
15447 Michael Kerrisk
15448 New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
15449
15450 pthread_attr_setstackaddr.3
15451 Michael Kerrisk
15452 New page for pthread_attr_setstackaddr(3) and
15453 pthread_attr_getstackaddr(3)
15454
15455 pthread_attr_setstacksize.3
15456 Michael Kerrisk
15457 New page for pthread_attr_setstacksize(3) and
15458 pthread_attr_getstacksize(3)
15459
15460 pthread_create.3
15461 Michael Kerrisk
15462 New page describing pthread_create(3)
15463
15464 pthread_detach.3
15465 Michael Kerrisk
15466 New page for pthread_detach(3)
15467
15468 pthread_equal.3
15469 Michael Kerrisk
15470 New page for pthread_equal(3)
15471
15472 pthread_exit.3
15473 Michael Kerrisk
15474 New page describing pthread_exit(3)
15475
15476 pthread_getattr_np.3
15477 Michael Kerrisk
15478 New page for pthread_getattr_np(3)
15479
15480 pthread_join.3
15481 Michael Kerrisk
15482 New page for pthread_join(3)
15483
15484 pthread_self.3
15485 Michael Kerrisk
15486 New page for pthread_self(3)
15487
15488 pthread_tryjoin_np.3
15489 Michael Kerrisk
15490 New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
15491
15492
15493 Newly documented interfaces in existing pages
15494 ---------------------------------------------
15495
15496 dup.2
15497 Michael Kerrisk
15498 Add description of dup3()
15499 dup3() was added in kernel 2.6.27.
15500
15501 epoll_create.2
15502 Michael Kerrisk
15503 Add description of new epoll_create1()
15504 The new epoll_create1() system call appeared in Linux 2.6.27.
15505
15506 eventfd.2
15507 Michael Kerrisk
15508 Describe eventfd2() and EFD_NONBLOCK and EFD_CLOEXEC
15509 Linux 2.6.27 added eventfd(), which supports a flags argument
15510 that eventfd() did not provide. The flags so far implemented
15511 are EFD_NONBLOCK and EFD_CLOEXEC,
15512
15513 inotify_init.2
15514 Michael Kerrisk
15515 Add description of inotify_init1()
15516 The inotify_init1() system call was added in Linux 2.6.27.
15517
15518 pipe.2
15519 Michael Kerrisk
15520 Add description of new pipe2() syscall
15521 pipe2() was added in 2.6.27. Describe the O_NONBLOCK and
15522 O_CLOEXEC flags.
15523
15524 signalfd.2
15525 Michael Kerrisk
15526 Describe signalfd4() and SFD_NONBLOCK and SFD_CLOEXEC
15527 Linux 2.6.27 added signalfd4(), which supports a flags argument
15528 that signalfd() did not provide. The flags so far implemented
15529 are SFD_NONBLOCK and SFD_CLOEXEC.
15530
15531
15532 New and changed links
15533 ---------------------
15534
15535 dup3.2
15536 Michael Kerrisk
15537 New link to dup.2
15538 dup.2 now contains the description of the new dup3() syscall.
15539
15540 epoll_create1.2
15541 Michael Kerrisk
15542 New link to epoll_create.2
15543 epoll_create.2 now includes a description of the new
15544 epoll_create1() system call.
15545
15546 eventfd2.2
15547 Michael Kerrisk
15548 New link to eventfd.2
15549 The eventfd.2 page has some details on the eventfd2() system call,
15550 which was new in Linux 2.6.27.
15551
15552 inotify_init1.2
15553 Michael Kerrisk
15554 New link to inotify_init.2
15555 inotify_init.2 now includes a description of the new
15556 inotify_init1() system call.
15557
15558 pipe2.2
15559 Michael Kerrisk
15560 New link to pipe.2
15561 pipe(2) now contains a description of the new pipe2() syscall.
15562
15563 pthread_attr_destroy.3
15564 Michael Kerrisk
15565 New link to new pthread_attr_init.3
15566
15567 pthread_attr_getdetachstate.3
15568 Michael Kerrisk
15569 New link to new pthread_attr_setdetachstate.3
15570
15571 pthread_attr_getguardsize.3
15572 Michael Kerrisk
15573 New link to new pthread_attr_setguardsize.3
15574
15575 pthread_attr_getscope.3
15576 Michael Kerrisk
15577 New link to new pthread_attr_setscope.3
15578
15579 pthread_attr_getstack.3
15580 Michael Kerrisk
15581 New link to new pthread_attr_setstack.3
15582
15583 pthread_attr_getstackaddr.3
15584 Michael Kerrisk
15585 New link to new pthread_attr_setstackaddr.3
15586
15587 pthread_attr_getstacksize.3
15588 Michael Kerrisk
15589 New link to new pthread_attr_setstacksize.3
15590
15591 pthread_timedjoin_np.3
15592 Michael Kerrisk
15593 New link to new pthread_tryjoin_np.3
15594
15595 signalfd4.2
15596 Michael Kerrisk
15597 New link to signalfd.2
15598 signalfd.2 now includes text describing signalfd4() system call,
15599 new in Linux 2.6.27.
15600
15601
15602 Global changes
15603 --------------
15604
15605 eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2,
15606 wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3,
15607 fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3,
15608 getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3,
15609 makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3,
15610 pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5
15611 Michael Kerrisk
15612 Add ".SS Program source" to EXAMPLE
15613 Add ".SS Program source" to clearly distinguish shell session and
15614 descriptive text from actual program code.
15615
15616 eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2,
15617 signalfd.2, timerfd_create.2, wait.2, backtrace.3,
15618 clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3,
15619 getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3,
15620 gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3,
15621 malloc.3, matherr.3, offsetof.3, pthread_attr_init.3,
15622 pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3,
15623 strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7
15624 Michael Kerrisk
15625 Format user input in shell sessions in boldface
15626
15627 frexp.3, strftime.3, strtok.3
15628 Michael Kerrisk
15629 Relocate shell session above example program
15630 Move the shell session text that demonstrates the use of
15631 the example program so that it precedes the actual
15632 example program. This makes the page consistent with the
15633 majority of other pages.
15634
15635
15636 Changes to individual pages
15637 ---------------------------
15638
15639 epoll_create.2
15640 Michael Kerrisk
15641 Say more about unused epoll_create() 'size' arg
15642 Supply a little more explanation about why the 'size' argument
15643 of epoll_create() is nowadays ignored.
15644
15645 eventfd.2
15646 Michael Kerrisk
15647 Remove crufty text relating to flags argument
15648 Remove sentence saying that glibc adds a flags argument
15649 to the syscall; that was only relevant for the older
15650 eventfd() system call.
15651 getdents.2
15652 Christoph Hellwig
15653 Fix text relating to DT_UNKNOWN and 'd_type' support
15654 Some file systems provide partial support for 'dt_type',
15655 returning DT_UNKNOWN for cases they don't support.
15656 Update the discussion of 'd_type' and DT_UNKNOWN to
15657 support this.
15658
15659 getpeername.2, getsockname.2
15660 Michael Kerrisk
15661 SEE ALSO: add ip(7) and unix(7)
15662
15663 getsockopt.2
15664 Michael Kerrisk
15665 EINVAL can also occur if 'optval' is invalid
15666 In some cases, EINVAL can occur if 'optval' is invalid.
15667 Note this, and point reader to an example in ip(7).
15668 In response to:
15669 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
15670
15671 inotify_init.2
15672 pipe.2
15673 timerfd_create.2
15674 Michael Kerrisk
15675 Clarify *_NONBLOCK description
15676 Make it clear that the NONBLOCK flag sets an attribute in the new
15677 open file description.
15678
15679 sched_yield.2
15680 Michael Kerrisk
15681 Rewrite description in terms of threads
15682 The text formerly described the operation of sched_yield() in
15683 terms of processes. It should be in terms of threads.
15684 Michael Kerrisk
15685 Add NOTES text on appropriate use of sched_yield()
15686 Strategic calls to sched_yield() can be used to improve
15687 performance, but unnecessary use should be avoided.
15688
15689 sigaction.2
15690 Michael Kerrisk
15691 Clarify that sa_mask affects the *per-thread* signal mask
15692 The page didn't previously clearly explain the scope of the
15693 signal mask that is affected by sa_mask.
15694
15695 signalfd.2
15696 Michael Kerrisk
15697 Remove crufty text relating to flags argument
15698 Remove sentence saying that glibc adds a flags argument
15699 to the syscall; that was only relevant for the older
15700 signalfd() system call.
15701
15702 sigprocmask.2
15703 Michael Kerrisk
15704 Clarify that sigprocmask() operates on a per-thread mask
15705 The first sentence of the page was vague on the scope of the
15706 attribute changed by sigprocmask(). Reword to make this
15707 clearer and add a sentence in NOTES to explicitly state that
15708 the signal mask is a per-thread attribute.
15709
15710 socket.2
15711 Michael Kerrisk
15712 Document SOCK_NONBLOCK and SOCK_CLOEXEC flags
15713 These flags, specified in the 'type' argument, are supported
15714 since Linux 2.6.27.
15715
15716 socketpair.2
15717 Michael Kerrisk
15718 Refer to socket(2) for SOCK_CLOEXEC and SOCK_NONBLOCK
15719 Refer the reader to socket(2) for a description of the SOCK_CLOEXEC
15720 and SOCK_NONBLOCK flags, which are supported by socketpair() since
15721 Linux 2.6.27.
15722
15723 syscalls.2
15724 Michael Kerrisk
15725 Add new 2.6.27 system calls
15726 Add pipe2(), dup3(), epoll_create1(), inotify_init1(),
15727 eventfd2(), signalfd4().
15728
15729 timerfd_create.2
15730 Michael Kerrisk
15731 Document timerfd_create() TFD_CLOEXEC and TFD_NONBLOCK
15732 TFD_CLOEXEC and TFD_NONBLOCK are supported since LInux 2.6.27.
15733
15734 vfork.2
15735 Michael Kerrisk
15736 Clarify meaning of "child releases the parent's memory"
15737 The man page was not explicit about how the memory used by
15738 the child is released back to the parent.
15739
15740 ctime.3
15741 Michael Kerrisk
15742 ctime_r() and localtime_r() need not set 'timezone' and 'daylight'
15743 The man page already noted that these functions need not set
15744 'tzname', but things could be clearer: it tzset() is not called,
15745 then the other two variables also are not set.
15746
15747 Also, clarify that ctime() does set 'timezone' and 'daylight'.
15748
15749 dlopen.3
15750 Michael Kerrisk
15751 LD_LIBRARY_PATH is inspected once, at program start-up
15752 Make it clear that LD_LIBRARY_PATH is inspected *once*, at
15753 program start-up. (Verified from source and by experiment.)
15754
15755 fmemopen.3
15756 Michael Kerrisk
15757 Document binary mode (mode 'b')
15758 Glibc 2.9 adds support to fmemopen() for binary mode opens.
15759 Binary mode is specified by inclusion of the letter 'b' in
15760 the 'mode' argument.
15761
15762 getaddrinfo.3
15763 Michael Kerrisk
15764 Clarify error descriptions with some examples
15765 Clarify the description of some errors by giving examples
15766 that produce the errors. (Text added for EAI_SERVICE and
15767 EAI_SOCKTYPE.)
15768
15769 Also, add an error case for EAI_BADFLAGS.
15770
15771 gethostbyname.3
15772 Michael Kerrisk
15773 Rationalize text on POSIX.1-2001 obsolete interfaces
15774 POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno'
15775 as obsolete. The man page explained this, but with some
15776 duplication. Remove the duplication, and otherwise tidy up
15777 discussion of this point.
15778
15779 popen.3
15780 Michael Kerrisk
15781 Change one-line description in NAME
15782 s%process I/O%pipe stream to or from a process%
15783 Michael Kerrisk
15784 Document 'e' (close-on-exec) flag
15785 glibc 2.9 implements the 'e' flag in 'type', which sets the
15786 close-on-exec flag on the underlying file descriptor.
15787
15788 raise.3
15789 Michael Kerrisk
15790 SEE ALSO: add pthread_kill(3)
15791
15792 readdir.3
15793 Christoph Hellwig
15794 Fix text relating to DT_UNKNOWN and 'd_type' support
15795 (This mirrors the previous change to getdents.2)
15796 Some file systems provide partial support for 'dt_type',
15797 returning DT_UNKNOWN for cases they don't support.
15798 Update the discussion of 'd_type' and DT_UNKNOWN to
15799 support this.
15800
15801 strcpy.3
15802 Jason Spiro
15803 Strengthen warning about checking against buffer overruns
15804 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940
15805
15806 tty_ioctl.4
15807 Michael Kerrisk
15808 Explain capability requirements for TIOCCONS
15809 Explain capability requirements for TIOCCONS, and describe
15810 changes in 2.6.10 relating to capabilities.
15811 Michael Kerrisk
15812 Explain capability requirements for various ioctls
15813 For TIOCSLCKTRMIOS, TIOCSCTTY, TIOCEXCL, explain the exact
15814 capability that is required (the text formerly just said "root"
15815 in each case).
15816
15817 proc.5
15818 Michael Kerrisk
15819 Document /proc/sys/kernel/threads-max
15820 Defines the system-wide limit on the number of threads (tasks).
15821
15822 utmp.5
15823 Pierre Cazenave
15824 It is just "other" who should not have write perms on utmp
15825 The page was vague before, saying that utmp should not be
15826 writable by any user. This isn't true: it can be, and
15827 typically is, writable by user and group.
15828
15829 epoll.7
15830 Michael Kerrisk
15831 Mention epoll_create1() as part of epoll API
15832 epoll_create1() was added in Linux 2.6.27, and extends the
15833 functionality of epoll_create().
15834
15835 inotify.7
15836 Michael Kerrisk
15837 Mention inotify_init1() in overview of API
15838 Discuss the new inotify_init1() system call in the overview of
15839 the inotify API.
15840
15841 ip.7
15842 Michael Kerrisk
15843 Detail EINVAL error for IP_ADD_MEMBERSHIP socket option
15844 In response to:
15845 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092
15846
15847 iso_8859-7.7
15848 Lefteris Dimitroulakis
15849 Add Drachma, Euro, and Greek Ypogegrammeni
15850 Also, amend description of characters 0241 and 0242.
15851
15852 man-pages.7
15853 Michael Kerrisk
15854 Example shell sessions should have user input boldfaced
15855
15856 pthreads.7
15857 Michael Kerrisk
15858 Describe return value from pthreads functions
15859 Describe the usual success (0) and failure (non-zero) returns,
15860 and note that POSIX.1-2001 specifies that pthreads functions
15861 can never fail with the error EINTR.
15862
15863 signal.7
15864 Michael Kerrisk
15865 Timeouts make socket interfaces non-restartable
15866 If setsockopt() is used to set a timeout on a socket(),
15867 then the various socket interfaces are not automatically
15868 restarted, even if SA_RESTART is specified when
15869 establishing the signal handler. Analogous behavior occurs
15870 for the "stop signals" case.
15871
15872 socket.7
15873 Michael Kerrisk
15874 SEE ALSO: add unix(7)
15875
15876 ld.so.8
15877 Michael Kerrisk
15878 Document LD_USE_LOAD_BIAS
15879 Drawing heavily on Jakub Jelinek's description in
15880 http://sources.redhat.com/ml/libc-hacker/2003-11/msg00127.html
15881 (Subject: [PATCH] Support LD_USE_LOAD_BIAS)
15882 --inhibit-rpath is ignored for setuid/setgid ld.so
15883 The --inhibit-rpath option is ignored if ld.so is setuid/setgid
15884 (not if the executable is setuid/setgid).
15885 Michael Kerrisk
15886 Since glibc 2.4, setuid/setgid programs ignore LD_ORIGIN_PATH
15887 Michael Kerrisk
15888 Fix description of LD_PROFILE and LD_PROFILE_OUTPUT
15889 Clarify that LD_PROFILE is pathname or a soname,
15890 and identify name of profiling output file.
15891 Fix description of LD_PROFILE_OUTPUT, which wasn't even close to
15892 the truth. (But why did it remain unfixed for so many years?)
15893 Michael Kerrisk
15894 Since glibc 2.3.4, setuid/setgid programs ignore LD_DYNAMIC_WEAK
15895 Michael Kerrisk
15896 Since version 2.3.5, setuid/setgid programs ignore LD_SHOW_AUXV
15897 Michael Kerrisk
15898 Reorder lists of LD_* environment variables alphabetically
15899 Michael Kerrisk
15900 Since glibc 2.3.4, setuid/setgid programs ignore LD_DEBUG
15901
15902
15903 ==================== Changes in man-pages-3.13 ====================
15904
15905 Released: 2008-11-07, Bucaramanga
15906
15907
15908 Contributors
15909 ------------
15910
15911 The following people contributed notes, ideas, or patches that have
15912 been incorporated in changes in this release:
15913
15914 Bert Wesarg <bert.wesarg@googlemail.com>
15915 Karsten Weiss <knweiss@gmail.com>
15916 Lefteris Dimitroulakis <edimitro@tee.gr>
15917 Olaf van der Spek <olafvdspek@gmail.com>
15918 Sam Varshavchik <mrsam@courier-mta.com>
15919 Török Edwin <edwintorok@gmail.com>
15920 Ulrich Mueller <ulm@gentoo.org>
15921 Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
15922
15923 Apologies if I missed anyone!
15924
15925
15926 New and rewritten pages
15927 -----------------------
15928
15929 pthread_attr_setaffinity_np.3
15930 Michael Kerrisk
15931 New page for pthread_attr_setaffinity_np(3) and
15932 pthread_attr_getaffinity_np(3)
15933
15934 pthread_attr_setschedparam.3
15935 Michael Kerrisk
15936 New page for pthread_attr_setschedparam(3) and
15937 pthread_attr_getschedparam(3)
15938
15939 pthread_attr_setschedpolicy.3
15940 Michael Kerrisk
15941 New page for pthread_attr_setschedpolicy(3) and
15942 pthread_attr_getschedpolicy(3)
15943
15944 pthread_setaffinity_np.3
15945 Michael Kerrisk
15946 New page for pthread_setaffinity_np(3) and pthread_getaffinity_np(3)
15947
15948 pthread_setschedparam.3
15949 Michael Kerrisk
15950 New page for pthread_setschedparam(3) and pthread_getschedparam(3)
15951
15952 pthread_setschedprio.3
15953 Michael Kerrisk
15954 New page for pthread_setschedprio(3)
15955
15956
15957 New and changed links
15958 ---------------------
15959
15960 pthread_attr_getaffinity_np.3
15961 Michael Kerrisk
15962 New link to new pthread_attr_setaffinity_np.3
15963
15964 pthread_attr_getschedparam.3
15965 Michael Kerrisk
15966 New link to new pthread_attr_setschedparam.3
15967
15968 pthread_attr_getschedpolicy.3
15969 Michael Kerrisk
15970 New link to new pthread_attr_setschedpolicy.3
15971
15972 pthread_getaffinity_np.3
15973 Michael Kerrisk
15974 New link to new pthread_setaffinity_np.3
15975
15976 pthread_getschedparam.3
15977 Michael Kerrisk
15978 New link to new pthread_setschedparam.3
15979
15980
15981 Global changes
15982 --------------
15983
15984 pthread_attr_setaffinity_np.3
15985 pthread_getattr_np.3
15986 pthread_setaffinity_np.3
15987 pthread_tryjoin_np.3
15988 Michael Kerrisk
15989 Explain _np suffix
15990 Add text to CONFORMING TO explaining that the "_np"
15991 suffix is because these functions are non-portable.
15992
15993
15994 Changes to individual pages
15995 ---------------------------
15996
15997 sched_setaffinity.2
15998 Michael Kerrisk
15999 SEE ALSO: add sched_getcpu(3)
16000
16001 sched_setaffinity.2
16002 Michael Kerrisk
16003 SEE ALSO: Add pthread_setaffinity_np(3)
16004
16005 sched_setaffinity.2
16006 Michael Kerrisk
16007 Clarify EINVAL error for cpusetsize < kernel mask size
16008 For sched_setaffinity(), the EINVAL error that occurs
16009 if 'cpusetsize' is smaller than the kernel CPU set size only
16010 occurs with kernels before 2.6.9.
16011
16012 vfork.2
16013 Michael Kerrisk
16014 Child holds parent's memory until execve() or *termination*
16015 The page was phrased in a few places to describe the child as
16016 holding the parent's memory until the child does an execve(2)
16017 or an _exit(2). The latter case should really be the more
16018 general process termination (i.e., either _exit(2) or abnormal
16019 termination).
16020
16021 clock_getres.3
16022 Michael Kerrisk
16023 CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable
16024 According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and
16025 CLOCK_THREAD_CPUTIME_ID clocks should be settable, but
16026 currently they are not.
16027
16028 pthread_attr_setstacksize.3
16029 Michael Kerrisk, after a report by Karsten Weiss
16030 EINVAL occurs on some systems if stacksize != page-size
16031 On MacOS X at least, pthread_attr_setstacksize(3) can fail
16032 with EINVAL if 'stacksize' is not a multiple of the system
16033 page size. Best to mention this so as to aid people writing
16034 portable programs.
16035
16036 pthread_create.3
16037 Karsten Weiss
16038 Fix bug in EXAMPLE program
16039 The calloc() line should read like this instead:
16040
16041 tinfo = calloc(num_threads, sizeof(struct thread_info));
16042
16043 pthread_exit.3
16044 Michael Kerrisk
16045 BUGS: thread group with a dead leader and stop signals
16046 Document the bug that can occur when a stop signal
16047 is sent to a thread group whose leader has terminated.
16048 http://thread.gmane.org/gmane.linux.kernel/611611
16049 http://marc.info/?l=linux-kernel&m=122525468300823&w=2
16050
16051 resolver.3
16052 Michael Kerrisk
16053 Fix prototype of dn_expand()
16054 The 4th argument is "char *", not "unsigned char *".
16055 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708
16056
16057 epoll.7
16058 Michael Kerrisk
16059 Fix error handling after accept() in example code
16060 Simply continuing after an error is in most cases wrong,
16061 and can lead to infinite loops (e.g., for EMFILE).
16062 So handle an error by terminating.
16063 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504202
16064
16065 epoll.7
16066 Michael Kerrisk
16067 Add error handling for epoll_wait() call in example code
16068
16069 epoll.7
16070 Michael Kerrisk
16071 Improve example code
16072 Fill in some gaps in example code (variable declarations,
16073 adding listening socket to epoll set).
16074 Give variables more meaningful names.
16075 Other minor changes.
16076 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504202
16077
16078 iso_8859-7.7
16079 Lefteris Dimitroulakis
16080 Add characters for Drachma and Greek Ypogegrammeni
16081 Lines for these two characters were added in the previous patch,
16082 but the actual characters were not included in the 4th column
16083 of the table. This fixes that.
16084
16085 pthreads.7
16086 Michael Kerrisk
16087 Add a section describing thread IDs
16088 In particular, note that in each pthreads function that takes
16089 a thread ID argument, that ID by definition refers to a thread
16090 in the same process as the caller.
16091
16092
16093 ==================== Changes in man-pages-3.14 ====================
16094
16095 Released: 2008-11-25, Bucaramanga
16096
16097
16098 Contributors
16099 ------------
16100
16101 The following people contributed notes, ideas, or patches that have
16102 been incorporated in changes in this release:
16103
16104 Andreas Henriksson <andreas@fatal.se>
16105 Bert Wesarg <bert.wesarg@googlemail.com>
16106 Cedric Le Goater <clg@fr.ibm.com>
16107 Chris Heath <chris@heathens.co.nz>
16108 Eric Biederman <ebiederm@xmission.com>
16109 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
16110 Ivana Varekova <varekova@redhat.com>
16111 Jen Axboe <jens.axboe@oracle.com>
16112 Jens Axboe <jens.axboe@oracle.com>
16113 Loïc Domaigne <tech@domaigne.com>
16114 Masanari Iida <masanari.iida@hp.com>
16115 Paul Evans <leonerd@leonerd.org.uk>
16116 Pavel Emelyanov <xemul@openvz.org>
16117 Pierre-Paul Paquin <pierrepaulpaquin@gmail.com>
16118 Serge E. Hallyn <serge@hallyn.com>
16119 Stefano Teso <teso@disi.unitn.it>
16120 Stew Benedict <stewb@linux-foundation.org>
16121 Vegard Nossum <vegard.nossum@gmail.com>
16122
16123 Apologies if I missed anyone!
16124
16125
16126 New and rewritten pages
16127 -----------------------
16128
16129 CPU_SET.3
16130 Michael Kerrisk
16131 New page documenting CPU_* macros
16132 This page contains material moved out of sched_setscheduler(2).
16133 It overwrites a previously existing link file with the same name.
16134 Michael Kerrisk
16135 Add description of macros for dynamically allocated CPU sets
16136 Add descriptions of CPU_ALLOC(), CPU_ALLOC_SIZE(), CPU_FREE(),
16137 CPU_SET_S(), CPU_CLR_S(), CPU_ISSET_S(), CPU_ZERO_S(),
16138 CPU_COUNT_S(), CPU_AND_S(), CPU_OR_S(), CPU_XOR_S(), and
16139 CPU_EQUAL_S().
16140 Michael Kerrisk
16141 Add documentation of CPU_COUNT()
16142 Michael Kerrisk
16143 Add description of CPU_AND(), CPU_OR, CPU_XOR(), and CPU_EQUAL()
16144 Plus a few other small clean-ups of the text
16145 Michael Kerrisk
16146 Various improvements in DESCRIPTION
16147 After review comments by Bert Wesarg:
16148 * Explain that cpu_set_t is a bitset, but should be considered
16149 opaque.
16150 * A CPU set can be duplicated with memset().
16151 * Size of a CPU set is rounded up to size of long.
16152 * CPU_SETSIZE is in bits, but the setsize argument is in bytes.
16153 Michael Kerrisk
16154 Document CPU_ALLOC()/CPU_ALLOC_SIZE() bug
16155 These macros return twice what they should because of thinko
16156 in glibc 2.8 and earlier. The bug is fixed for glibc 2.9.
16157 http://sourceware.org/bugzilla/show_bug.cgi?id=7029
16158 Michael Kerrisk
16159 NOTES: Discuss use of types in "prototypes" for these macros
16160 The SYNOPSIS shows types for arguments and return values, but
16161 these are really just suggestions: since the interfaces are
16162 macros, the compiler won't catch all violations of
16163 the "type rules". Warn the reader of this.
16164
16165 pthread_attr_setinheritsched.3
16166 Michael Kerrisk
16167 New page for pthread_attr_setinheritsched(3) and
16168 pthread_attr_getinheritsched(3)
16169
16170 pthread_cancel.3
16171 Michael Kerrisk
16172 New page for pthread_cancel(3)
16173
16174 pthread_cleanup_push.3
16175 Michael Kerrisk
16176 New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3)
16177
16178 pthread_setcancelstate.3
16179 Michael Kerrisk
16180 New page for pthread_setcancelstate(3) and pthread_setcanceltype(3)
16181
16182 pthread_testcancel.3
16183 Michael Kerrisk
16184 New page for pthread_testcancel(3)
16185
16186
16187 Newly documented interfaces in existing pages
16188 ---------------------------------------------
16189
16190 clone.2
16191 Jens Axboe
16192 Document CLONE_IO (new in Linux 2.6.25)
16193 Some text also by mtk.
16194 Michael Kerrisk
16195 Document CLONE_NEWNET
16196 Michael Kerrisk
16197 Document CLONE_NEWUTS (new in Linux 2.6.19)
16198 Michael Kerrisk
16199 Document CLONE_NEWIPC flag (new in Linux 2.6.19)
16200 Michael Kerrisk
16201 Document CLONE_NEWPID flag (new in Linux 2.6.24)
16202
16203 mmap.2
16204 Michael Kerrisk
16205 Document MAP_STACK flag (new in Linux 2.6.27)
16206
16207 arp.7
16208 Michael Kerrisk
16209 Document /proc file retrans_time_ms (new in Linux 2.6.12)
16210 Michael Kerrisk
16211 Document /proc file base_reachable_time_ms (new in Linux 2.6.12)
16212
16213 icmp.7
16214 Michael Kerrisk
16215 Document icmp_ignore_bogus_error_responses (new in Linux 2.2)
16216 Text taken from Documentation/networking/ip-sysctl.txt
16217 Michael Kerrisk
16218 Document icmp_ratelimit and icmp_ratemask (new in Linux 2.4.10)
16219 Text taken from Documentation/networking/ip-sysctl.txt
16220 Michael Kerrisk
16221 Document icmp_echo_ignore_broadcasts (new in Linux 2.6.12)
16222 Text taken from Documentation/networking/ip-sysctl.txt
16223
16224 tcp.7
16225 Michael Kerrisk
16226 Document /proc file tcp_slow_start_after_idle (new in Linux 2.6.18)
16227 Text taken from Documentation/networking/ip-sysctl.txt
16228 Michael Kerrisk
16229 Document /proc file tcp_base_mss (new in Linux 2.6.17)
16230 Text taken from Documentation/networking/ip-sysctl.txt
16231 Michael Kerrisk
16232 Document /proc file tcp_frto_response (new in Linux 2.6.22)
16233 Text taken from Documentation/networking/ip-sysctl.txt
16234 Michael Kerrisk
16235 Document /proc file tcp_moderate_rcvbuf (new in Linux 2.4.17/2.6.7)
16236 Text taken from Documentation/networking/ip-sysctl.txt
16237 Michael Kerrisk
16238 Document /proc file tcp_congestion_control (new in Linux 2.4.13)
16239 Text taken from Documentation/networking/ip-sysctl.txt
16240 Michael Kerrisk
16241 Document /proc file tcp_no_metrics_save (new in Linux 2.6.6)
16242 Text taken from Documentation/networking/ip-sysctl.txt
16243 Michael Kerrisk
16244 Document /proc file tcp_mtu_probing (new in Linux 2.6.17)
16245 Text taken from Documentation/networking/ip-sysctl.txt
16246 Michael Kerrisk
16247 Document /proc file tcp_dma_copybreak (new in Linux 2.6.24)
16248 Text taken from Documentation/networking/ip-sysctl.txt
16249 Michael Kerrisk
16250 Document /proc file tcp_tso_win_divisor (new in Linux 2.6.9)
16251 Text taken from Documentation/networking/ip-sysctl.txt
16252 Michael Kerrisk
16253 Document /proc file tcp_allowed_congestion_control (new in Linux 2.4.20)
16254 Text taken from Documentation/networking/ip-sysctl.txt
16255 Michael Kerrisk
16256 Document /proc file tcp_workaround_signed_windows (new in Linux 2.6.26)
16257 Text taken from Documentation/networking/ip-sysctl.txt
16258 Michael Kerrisk
16259 Document /proc file tcp_available_congestion_control (new in Linux 2.4.20)
16260 Text taken from Documentation/networking/ip-sysctl.txt
16261 Michael Kerrisk
16262 Document /proc file tcp_abc (new in Linux 2.6.15)
16263 Text taken from Documentation/networking/ip-sysctl.txt
16264
16265 udp.7
16266 Michael Kerrisk
16267 Document /proc files udp_mem, udp_rmem_min, and udp_wmem_min
16268 All of these are new in Linux 2.6.25
16269
16270
16271 New and changed links
16272 ---------------------
16273
16274 CPU_ALLOC.3
16275 CPU_ALLOC_SIZE.3
16276 CPU_AND.3
16277 CPU_AND_S.3
16278 CPU_CLR_S.3
16279 CPU_COUNT.3
16280 CPU_COUNT_S.3
16281 CPU_EQUAL.3
16282 CPU_EQUAL_S.3
16283 CPU_FREE.3
16284 CPU_ISSET_S.3
16285 CPU_OR.3
16286 CPU_OR_S.3
16287 CPU_SET_S.3
16288 CPU_XOR.3
16289 CPU_XOR_S.3
16290 CPU_ZERO_S.3
16291 Michael Kerrisk
16292 New link to new CPU_SET.3
16293
16294 CPU_CLR.3
16295 CPU_ISSET.3
16296 CPU_ZERO.3
16297 Michael Kerrisk
16298 Update links to point to CPU_SET.3
16299 The documentation of the CPU_* macros migrated to a new
16300 location: CPU_SET.3.
16301
16302 pthread_attr_getinheritsched.3
16303 Michael Kerrisk
16304 New link to new pthread_attr_setinheritsched.3
16305
16306 pthread_cleanup_pop.3
16307 Michael Kerrisk
16308 New link to new pthread_cleanup_push.3
16309
16310 pthread_setcanceltype.3
16311 Michael Kerrisk
16312 New link to new pthread_setcancelstate.3
16313
16314
16315 Global changes
16316 --------------
16317
16318 clone.2
16319 mount.2
16320 unshare.2
16321 proc.5
16322 path_resolution.7
16323 Michael Kerrisk
16324 Global fix: s/namespace/mount-point namespace/, as appropriate
16325 In recent times, a number of other namespace flags have been
16326 added to clone(2). As such, it is no longer clear to use
16327 the generic term "namespace" to refer to the particular
16328 namespace controlled by CLONE_NEWNS; instead, use the
16329 term "mount-point namespace".
16330 Michael Kerrisk
16331 Global fix: s/mount-point namespace/mount namespace/
16332 This is more consistent with the term "mounts namespace"
16333 used in the 2008 ACM SIGOPS paper, "Virtual servers
16334 and checkpoint/restart in mainstream Linux".
16335 (I avoided the "s", because using the plural strikes me
16336 as klunky English, and anyway we don't talk about
16337 the "PIDs namespace" or the "networks namespace", etc..)
16338
16339 connect.2
16340 listen.2
16341 send.2
16342 uname.2
16343 cmsg.3
16344 proc.5
16345 arp.7
16346 ddp.7
16347 icmp.7
16348 ip.7
16349 raw.7
16350 socket.7
16351 tcp.7
16352 udp.7
16353 Michael Kerrisk
16354 Global fix: eliminate mention of the obsolete sysctl(2) interface
16355 Many pages still mention use of the obsolete sysctl(2) system
16356 call, or used the term "sysctls"; rewrite these mentions to
16357 instead be in terms of /proc interfaces.
16358
16359 fcntl.2
16360 signal.2
16361 mbsnrtowcs.3
16362 mbsrtowcs.3
16363 mbtowc.3
16364 wcrtomb.3
16365 wcsnrtombs.3
16366 wcsrtombs.3
16367 wctomb.3
16368 Michael Kerrisk
16369 Global fix: s/multi-thread/multithread/
16370
16371 getdents.2
16372 pthread_attr_init.3
16373 pthread_create.3
16374 pthread_getattr_np.3
16375 pthread_setaffinity_np.3
16376 pthread_setschedparam.3
16377 pthread_tryjoin_np.3
16378 Michael Kerrisk
16379 Use consistent error-handling function names
16380 Many older pages use a handle_error() macro to do simple
16381 error handling from system and library function calls.
16382 Switch these pages to do similar.
16383
16384
16385 Changes to individual pages
16386 ---------------------------
16387
16388 time.1
16389 Michael Kerrisk
16390 Note that some shells have a 'time' built-in command
16391 Therefore, to access the functionality described on this page,
16392 it may be necessary to specify the full pathname.
16393
16394 clone.2
16395 Michael Kerrisk
16396 Place list of CLONE_* flags in alphabetical order
16397 (No content changes.)
16398 fsync.2
16399 Michael Kerrisk
16400 Update feature test macro requirements for fsync()
16401 Since glibc 2.8, the fsync() declaration is also exposed if
16402 _POSIX_C_SOURCE >= 200112L
16403
16404 sched_setaffinity.2
16405 Michael Kerrisk
16406 Add note on system-imposed restrictions on CPUs actually used
16407 After Loïc Domaigne's suggestion for pthread_setaffinity_np(3), add
16408 similar text to this page noting that the system silently
16409 limits the set of CPUs on which the process actually runs to
16410 the set of CPUs physically present and the limits imposed by
16411 cpuset(7).
16412
16413 sched_setaffinity.2
16414 Michael Kerrisk
16415 Removed discussion of CPU_* macros()
16416 These macros are now moving to a separate page.
16417 Michael Kerrisk
16418 Refer reader to pthread_setaffinity_np(3)
16419 pthread_setaffinity_np() is preferable for setting
16420 thread CPU affinity if using the POSIX threads API.
16421
16422 sysctl.2
16423 Michael Kerrisk
16424 Add prominent warning against using this system call
16425 This was already stated under NOTES, but make it even more
16426 prominent by adding a sentence at the start of the DESCRIPTION.
16427
16428 uname.2
16429 Michael Kerrisk
16430 Add C comments describing fields in utsname structure
16431
16432 atan2.3
16433 Stefano Teso
16434 Fix description of range of function value return
16435 The range is not [-pi/2, pi/2], but [-pi, pi].
16436
16437 (mtk: This error was reported by Nicolas François, and
16438 should have been fixed in 3.11, but somewhere along the way,
16439 the fix got lost.)
16440
16441 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=506299
16442
16443 bindresvport.3
16444 Michael Kerrisk
16445 Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT
16446 Glibc switched to using a POSIX-specified error code for
16447 this error case.
16448
16449 http://bugs.linuxbase.org/show_bug.cgi?id=2375
16450
16451 clock_getres.3
16452 Michael Kerrisk
16453 CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable
16454 According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and
16455 CLOCK_THREAD_CPUTIME_ID clocks should be settable, but
16456 currently they are not.
16457
16458 getgrnam.3
16459 Michael Kerrisk
16460 Clarify and add more detail in RETURN VALUE description
16461 The page was a bit fuzzy in describing the return values for
16462 various cases. In particular, it needed to be more explicit
16463 in describing what happens for the "not found" case.
16464
16465 This is an analogous change to the change for
16466 getpwnam.3, made after Andreas Henriksson's report.
16467 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787
16468 Michael Kerrisk
16469 Rename arguments to getgrnam_r() and getgrgid_r()
16470 s/gbuf/grp/ and s/gbufp/result/, for consistency
16471 with POSIX.1 argument names.
16472 Michael Kerrisk
16473 Clarify RETURN VALUE description
16474 The page was a bit fuzzy in describing the return values for
16475 various cases. In particular, it needed to be more explicit
16476 in describing what happens for the "not found" case.
16477
16478 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708
16479
16480 getpwnam.3
16481 Michael Kerrisk
16482 Rename arguments to getpwnam_r() and getpwuid_r()
16483 s/pwbuf/pwd/ and s/pwbufp/result/, for consistency
16484 with POSIX.1 argument names.
16485 Michael Kerrisk
16486 Clarify and add more detail in RETURN VALUE description
16487 The page was a bit fuzzy in describing the return values for
16488 various cases. In particular, it needed to be more explicit
16489 in describing what happens for the "not found" case.
16490
16491 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787
16492 Michael Kerrisk
16493 Add an EXAMPLE program for getpwnam_r()
16494
16495 inet_ntop.3
16496 Michael Kerrisk
16497 Rename 'cnt' argument to 'size'
16498 This is consistent with POSIX.1, and also a more sensible name.
16499 Michael Kerrisk
16500 Rework text describing 'size' argument
16501 (After a suggestion by Vegard Nossum.)
16502 Also made a few other small rewordings to in the initial
16503 paragraph.
16504
16505 makecontext.3
16506 Michael Kerrisk
16507 Add text on use of pointer arguments to makecontext()
16508 Passing pointer arguments to makecontext() is possible,
16509 but only on some architectures, and with no guarantees
16510 of portability.
16511
16512 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504699
16513
16514 pthread_attr_setaffinity_np.3
16515 Michael Kerrisk
16516 Various fixes after review by Loïc Domaigne
16517 Reviewed-by: Loïc Domaigne
16518
16519 pthread_attr_setaffinity_np.3
16520 pthread_setaffinity_np.3
16521 Michael Kerrisk
16522 Update to reflect new location of CPU_*() documentation
16523 The CPU_*() macros are now documented in CPU_SET.3;
16524 update to reflect that fact.
16525 Michael Kerrisk
16526 Remove redundant text relating to CPU sets
16527 Information about CPU_SETSIZE can be found in CPU_SET.3, so
16528 remove discussion of it here.
16529
16530 pthread_attr_setschedparam.3
16531 pthread_setschedparam.3
16532 Michael Kerrisk
16533 Remove text saying that only sched_priority is required by POSIX.1
16534 Loïc Domaigne points out that if a system implements
16535 SCHED_SPORADIC (which Linux does not), then other
16536 fields are also specified in sched_param. The simple
16537 solution is just to remove that phrase from the man
16538 page.
16539
16540 pthread_cancel.3
16541 pthread_detach.3
16542 pthread_join.3
16543 pthread_setaffinity_np.3
16544 Michael Kerrisk
16545 Make text of ESRCH error consistent
16546
16547 pthread_setaffinity_np.3
16548 Michael Kerrisk
16549 Add text to EINVAL error mentioning cpuset(7)
16550 Michael Kerrisk
16551 Various improvements after review by Loïc Domaigne
16552 Various fix-ups after Loïc's review.
16553
16554 Reviewed-by: Loïc Domaigne
16555
16556 pthread_setschedparam.3
16557 Michael Kerrisk
16558 PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute
16559 In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for
16560 the inherit scheduler attribute.
16561
16562 syslog.3
16563 Masanari Iida
16564 LOG_KERN messages can't be generated from user processes
16565 Masanari notes that this is an FAQ for logger(1) and that
16566 Solaris and FreeBSD document this point in syslog(3).
16567 The glibc info page also hides this comment in its source:
16568
16569 Internally, there is also LOG_KERN, but LOG_KERN == 0,
16570 which means if you try to use it here, just selects default.
16571
16572 proc.5
16573 Ivana Varekova
16574 Fix reference to kernel source file
16575 Use relative reference to Documentation/mtrr.txt.
16576
16577 arp.7
16578 Michael Kerrisk
16579 Add kernel version numbers for /proc interfaces
16580
16581 cpuset.7
16582 Michael Kerrisk
16583 SEE ALSO: add CPU_SET(3)
16584
16585 epoll.7
16586 Michael Kerrisk
16587 Note glibc version that added epoll support
16588
16589 icmp.7
16590 Michael Kerrisk
16591 Add kernel version numbers to /proc file descriptions
16592
16593 inotify.7
16594 Vegard Nossum
16595 Fix description of max_user_watches
16596 It seems that inotify(7) is wrong here:
16597
16598 "/proc/sys/fs/inotify/max_user_watches
16599 This specifies a limit on the number of watches that can be
16600 associated with each inotify instance."
16601
16602 On my system, the default value for this variable is 8192. But I
16603 cannot create more than 8192 watches in total for the same UID
16604 even when they are on different inotify instances. So I suggest
16605 to rephrase this as: "This specifies an upper limit on the
16606 number of watches that can be created per real user ID."
16607
16608 ip.7
16609 Michael Kerrisk
16610 Reorder socket options alphabetically
16611 Michael Kerrisk
16612 Added kernel version numbers for IP_* socket options
16613 Michael Kerrisk
16614 Relocate kernel version information for IP_PMTUDISC_PROBE
16615 Michael Kerrisk
16616 Add kernel version numbers for /proc/sys/net/ipv4/ip_* files
16617 Michael Kerrisk
16618 Remove mention of kernel header from description of IP_RECVERR
16619 Looks like glibc has had this definition since about version 2.1.
16620 Michael Kerrisk
16621 Relocate kernel version information for ip_mreqn structure
16622 Michael Kerrisk
16623 Relocate info about Linux-specific sockopts to NOTES
16624 Also add some source comments about non-standard Linux-specific
16625 options that are not yet documented.
16626
16627 netlink.7
16628 Vegard Nossum
16629 Fix incorrect variable names in example code
16630 s/snl/sa/ * 2
16631
16632 pthreads.7
16633 Michael Kerrisk
16634 Add section on cancellation points
16635 This section includes a list of the functions that must and
16636 may be cancellation points.
16637 Michael Kerrisk
16638 Rework, and fix small error in, thread-safe function list
16639 Integrate the changes that occurred in POSIX.1-2008 into the
16640 main list (to be consistent with the list, elsewhere on this
16641 page, of functions that are cancellation points).
16642
16643 Also, fix an error that said that strerror() was added to
16644 the list in POSIX.1-2008. It was strsignal() that was
16645 added. (strerror() was already in the list in POSIX.1-2001.)
16646 Michael Kerrisk
16647 Tweak text on sigpause() cancellation point
16648 In POSIX.1-2009, this function moves from the "must be"
16649 to the "may be" list.
16650 Michael Kerrisk
16651 Add ref to signal(7) for further info on use of real-time signals
16652 signal(7) provides some further details on the use of real-time
16653 signals by the two Linux threading implementations.
16654 Michael Kerrisk
16655 SEE ALSO: add pthread_attr_init() and pthread_cancel()
16656
16657 tcp.7
16658 Michael Kerrisk
16659 Update description of tcp_rmem defaults for Linux 2.6
16660 Michael Kerrisk
16661 Add kernel version numbers for TCP_* socket options
16662 Note kernel version were each socket option first appeared.
16663 Michael Kerrisk
16664 The tcp_bic* proc files disappeared in Linux 2.6.13
16665 Michael Kerrisk
16666 tcp_vegas_cong_avoid disappeared in Linux 2.6.13
16667 Michael Kerrisk
16668 Add mention of RFC 4138 for 'tcp_frto' /proc file
16669 Michael Kerrisk
16670 Remove mention of /proc in VERSIONS
16671 This information is not indicated for each /proc interface
16672 Michael Kerrisk
16673 Clarify that tcp_mem measures in units of the system page size
16674 Michael Kerrisk
16675 Update tcp_frto description for 2.6.22 changes
16676 Linux 2.6.22 added a mode value 2 ("Enable SACK-enhanced
16677 F-RTO if flow uses SACK").
16678 Michael Kerrisk
16679 Fix alphabetical order in /proc file list
16680 A few entries were slightly out of order.
16681 Michael Kerrisk
16682 Remove obsolete statement about /proc from VERSIONS
16683 Much of the text has been updated to 2.6.27 or so,
16684 so this statement no longer applies.
16685 Michael Kerrisk
16686 Add kernel version numbers for each /proc interface
16687 Note kernel version where each /proc interface first appeared
16688 Michael Kerrisk
16689 tcp_westwood /proc file disappeared in Linux 2.6.13
16690 Michael Kerrisk
16691 Update description of tcp_wmem defaults for Linux 2.6
16692
16693
16694 ==================== Changes in man-pages-3.15 ====================
16695
16696 Released: 2008-12-05, Bucaramanga
16697
16698
16699 Contributors
16700 ------------
16701
16702 The following people contributed notes, ideas, or patches that have
16703 been incorporated in changes in this release:
16704
16705 Andre Majorel <aym-xunil@teaser.fr>
16706 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
16707 Chris Heath <chris@heathens.co.nz>
16708 Drake Wilson <drake@begriffli.ch>
16709 Mats Wichmann <mats.d.wichmann@intel.com>
16710 Mel Gorman <mel@csn.ul.ie>
16711 Michael Kerrisk <mtk.manpages@gmail.com>
16712 Mike Fedyk <mfedyk@mikefedyk.com>
16713 Pavel Machek <pavel@suse.cz>
16714 Petr Baudis <pasky@suse.cz>
16715 Phil Endecott <phil_vonar_endecott@chezphil.org>
16716 Rob Landley <rob@landley.net>
16717 Sam Varshavchik <mrsam@courier-mta.com>
16718
16719 Apologies if I missed anyone!
16720
16721
16722 New and rewritten pages
16723 -----------------------
16724
16725 makedev.3
16726 Michael Kerrisk
16727 New page for makedev(), major(), and minor() macros
16728
16729 pthread_cleanup_push_defer_np.3
16730 Michael Kerrisk
16731 New page for pthread_cleanup_push_defer_np(3) and
16732 pthread_cleanup_pop_restore_np(3)
16733
16734
16735 Newly documented interfaces in existing pages
16736 ---------------------------------------------
16737
16738 accept.2
16739 Michael Kerrisk
16740 Document accept4() system call, new in Linux 2.6.28
16741
16742 fmemopen.3
16743 Petr Baudis
16744 Add description of open_wmemstream(3)
16745
16746 tcp.7
16747 Michael Kerrisk
16748 Document MSG_TRUNC flag for TCP sockets
16749
16750 New and changed links
16751 ---------------------
16752
16753 accept4.2
16754 Michael Kerrisk
16755 New link to accept.2
16756 accept.2 now documents the new accept4() system call.
16757
16758 open_wmemstream.3
16759 Petr Baudis
16760 New link to fmemopen.3
16761 fmemopen.3 now documents open_wmemstream().
16762 pthread_cleanup_pop_restore_np.3
16763 Michael Kerrisk
16764 New link to new pthread_cleanup_push_defer_np.3
16765
16766
16767 Global changes
16768 --------------
16769
16770 accept.2
16771 listen.2
16772 recv.2
16773 getpeername.2
16774 getsockname.2
16775 shutdown.2
16776 socketpair.2
16777 Michael Kerrisk
16778 Global fix: SEE ALSO: add socket(7)
16779
16780 bind.2
16781 rcmd.3
16782 capabilities.7
16783 ip.7
16784 Michael Kerrisk
16785 Global fix: s/reserved port/privileged port/
16786 Some pages used one term, some pages the other term;
16787 make some consistency.
16788
16789 connect.2
16790 getpeername.2
16791 getsockname.2
16792 Michael Kerrisk
16793 Use consistent argument names
16794 Most other sockets pages are using the names 'addr'
16795 and 'addrlen'; make these pages do the same.
16796
16797 getpeername.2
16798 getsockname.2
16799 getsockopt.2
16800 recv.2
16801 send.2
16802 shutdown.2
16803 sockatmark.3
16804 socket.7
16805 udplite.7
16806 Michael Kerrisk
16807 SYNOPSIS: Rename socket file descriptor argument to 'sockfd'
16808 Many sockets man pages use the name 'sockfd' already.
16809 For consistency, changes the others to do so as well.
16810
16811 gnu_dev_major.3
16812 gnu_dev_makedev.3
16813 gnu_dev_minor.3
16814 major.3
16815 minor.3
16816 Michael Kerrisk
16817 New links to new makedev(3) page
16818
16819
16820 Changes to individual pages
16821 ---------------------------
16822
16823 _exit.2
16824 Michael Kerrisk
16825 Since glibc 2.3, the exit() wrapper function invokes exit_group(2)
16826 This information is useful to users of strace(1).
16827
16828 accept.2
16829 Michael Kerrisk
16830 Clarify details when returned address is truncated
16831 If the returned address is truncated, the 'addrlen' argument
16832 indicates the actual size of the address, rather than a count
16833 of the number of bytes in the truncated buffer.
16834
16835 Also clarify that if 'addr' argument is NULL, then 'addrlen'
16836 should is unused, and should also be NULL.
16837 Michael Kerrisk
16838 Reorder ERRORS list
16839 Some errors were listed under a separate "may" heading.
16840 There's probably no real need to do this; integrate
16841 those errors into the main list.
16842
16843 exit_group.2
16844 Michael Kerrisk
16845 Note that since glibc 2.3, exit(2) invokes exit_group()
16846
16847 futex.2
16848 Michael Kerrisk
16849 Mention that glibc provides no wrapper function for futex()
16850
16851 get_thread_area.2
16852 Michael Kerrisk
16853 Note that glibc provides no wrapper for this system call
16854
16855 getdomainname.2
16856 Michael Kerrisk
16857 Substantial rewrite
16858 Expand description of setdomainname() and getdomainname().
16859 Note that getdomainname() is implemented as a library function
16860 in glibc.
16861 Note limits on size of domain name.
16862 Reorganize ERRORS list.
16863
16864 gethostname.2
16865 Michael Kerrisk
16866 Various parts rewritten
16867 Write a paragraph describing sethostname().
16868
16869 Clarify differences between glibc's gethostbyname() and
16870 the kernel gethostbyname() system calls.
16871
16872 gethostname.2
16873 Michael Kerrisk
16874 Note that HOST_NAME_MAX is 64 on Linux
16875 Also note that in pre-1.0 days, the limit on hostnames
16876 was 8 bytes.
16877
16878 getpeername.2
16879 Michael Kerrisk
16880 Note that returned address may be truncated if buffer is too small
16881
16882 getsid.2
16883 Michael Kerrisk
16884 Simplified version information and moved to a new VERSIONS section
16885
16886 getsockname.2
16887 Michael Kerrisk
16888 Note that returned address is truncated if buffer is too small
16889
16890 mknod.2
16891 Michael Kerrisk
16892 Refer reader to makedev(3) to build a device ID
16893
16894 mmap.2
16895 Michael Kerrisk
16896 Loosen language around how 'addr' hint is interpreted
16897 Mel Gorman reported that in Linux 2.6.27, 'addr' is rounded
16898 down to a page boundary.
16899
16900 Before kernel 2.6.26, if 'addr' was taken as a hint, it was
16901 rounded up to the next page boundary. Since Linux 2.6.24,
16902 it is rounded down. Therefore, loosen the description of
16903 this point to say that the address is rounded to "a nearby
16904 page boundary".
16905
16906 open.2
16907 Michael Kerrisk
16908 EFBIG error is now EOVERFLOW (since Linux 2.6.24)
16909 When a 32-bit app opens a file whose size is too big to be
16910 represented in 31-bits, POSIX.1 specifies the error EOVERFLOW.
16911 Linux used to give EFBIG for this case, but 2.6.24 fixed this.
16912
16913 Also, add some text to describe the error scenario in
16914 more detail.
16915
16916 pread.2
16917 Michael Kerrisk
16918 Note that glibc emulation for these calls uses lseek(2)
16919 (This makes it clearer that the emulated calls are not atomic.)
16920
16921 recv.2
16922 send.2
16923 Michael Kerrisk
16924 Make names of "address" and "address length" args more consistent
16925 Make the names of these arguments more consistent with other
16926 sockets man pages.
16927
16928 recv.2
16929 Michael Kerrisk
16930 Clarify details when returned address is truncated
16931 If the recvfrom() returned address is truncated, the 'fromlen'
16932 argument indicates the actual size of the address, rather than
16933 a count of the number of bytes in the truncated buffer.
16934
16935 Also clarify that the 'from' argument can be NULL, in which
16936 case 'fromlen' should is unused, and should also be NULL.
16937 Michael Kerrisk
16938 Internet datagram and netlink sockets support MSG_TRUNC for recv(2)
16939 Internet datagram (since Linux 2.4.27/2.6.8),
16940 and netlink (since Linux 2.6.22) sockets support
16941 the MSG_TRUNC flag for recv(2).
16942
16943 select.2
16944 Michael Kerrisk
16945 Rewrote text describing feature test macros requirement for pselect()
16946
16947 select_tut.2
16948 Michael Kerrisk
16949 Fix SHUT_FD* macros in example program
16950 Add "do {} while (0)"
16951
16952 set_thread_area.2
16953 Michael Kerrisk
16954 Note that glibc provides no wrapper for this system call
16955
16956 setfsgid.2
16957 setfsuid.2
16958 Michael Kerrisk
16959 Simplify version information and move to a VERSIONS section
16960
16961 setsid.2
16962 Michael Kerrisk
16963 Rework RETURN VALUE section; add an ERRORS section
16964
16965 setup.2
16966 Michael Kerrisk
16967 Relocate some CONFORMING TO text to VERSIONS and NOTES
16968
16969 stat.2
16970 Michael Kerrisk
16971 Document EOVERFLOW error
16972 Michael Kerrisk
16973 Refer reader to major() and minor() to decompose a device ID
16974
16975 syscalls.2
16976 Michael Kerrisk
16977 Fix version numbers for a few system calls
16978 Some 2.6 system calls were wrongly mentioned as also being
16979 backported into a 2.4.x kernel.
16980
16981 uname.2
16982 Michael Kerrisk
16983 DESCRIPTION: Point reader at NOTES for further info on field lengths
16984
16985 atan.3
16986 Andries E. Brouwer
16987 Fix return value description
16988 The correct range for the return value is [-pi/2,pi/2].
16989 (mtk's fix in the last change to the return value text was
16990 a botch-up of a (correct) suggestion by Nicolas François.)
16991
16992 atexit.3
16993 Michael Kerrisk
16994 atexit() and on_exit(3) register functions on the same list
16995 Michael Kerrisk
16996 Terminating registered function using longjmp() is undefined
16997 According to POSIX.1, using longjmp() to terminate execution of
16998 a function registered using atexit() produces undefined results.
16999 Michael Kerrisk
17000 Calling exit(3) more than once produces undefined results
17001 If an exit handler itself calls exit(3), the results are
17002 undefined (see the POSIX.1-2001 specification of exit(3)).
17003 Michael Kerrisk
17004 The same exit handler may be registered multiple times
17005 Michael Kerrisk
17006 Calling _exit(2) terminates processing of exit handlers
17007 Michael Kerrisk
17008 Terminating registered function using longjmp() is undefined
17009 According to POSIX.1, using longjmp() to terminate execution of
17010 a function registered using atexit() produces undefined results.
17011
17012 bindresvport.3
17013 Mats Wichmann
17014 SYNOPSIS: s/\*\*/*/ in prototype
17015 Michael Kerrisk
17016 Fix errors regarding port used, plus other rewrites
17017 Glibc's bindresvport() takes no notice of sin->sin_port:
17018 it always returns an arbitrary reserved port in the
17019 anonymous range (512-1023). (Reported by Mats Wichmann.)
17020
17021 Also:
17022 * Add EADDRINUSE and EACCES errors.
17023 * Mention use of getsockname(2).
17024 * Other minor rewrites and reorderings of the text.
17025 * Explicitly note that glib's bindresvport() ignores
17026 sin->sin_port.
17027 * Change license There's now virtually no text remaining from
17028 the 1.70 version of this page.
17029
17030 Reviewed-by: Mats Wichmann
17031 Reviewed-by: Petr Baudis
17032
17033 dlopen.3
17034 Petr Baudis
17035 Describe confusing dladdr() behavior
17036 dladdr() will act unexpectedly if called from non-pic code on a
17037 compile-time-generated function pointer.
17038
17039 fmemopen.3
17040 Michael Kerrisk
17041 Add VERSIONS section
17042 Petr Baudis
17043 SEE OPEN: Add fopencookie(3)
17044 fopencookie(3) is used to implement fmemopen().
17045
17046 fopen.3
17047 Petr Baudis
17048 SEE ALSO: Add fmemopen(3) and fopencookie(3)
17049
17050 fopencookie.3
17051 Petr Baudis
17052 fopencookie() needs _GNU_SOURCE feature test macro
17053
17054 getaddrinfo.3
17055 Petr Baudis
17056 Document results ordering and /etc/gai.conf
17057 This patch documents the order of the getaddrinfo(3) results
17058 (RFC 3484), how should the application deal with that,
17059 mentions the extremely common cause of having multiple
17060 results per query (both IPv4 and IPv6 addresses available)
17061 and mentions /etc/gai.conf.
17062
17063 (mtk: Minor tweaks, and note glibc version for /etc/gai.conf)
17064
17065 isatty.3
17066 Michael Kerrisk
17067 Complete rewrite of this page, with rather more detail
17068
17069 memmem.3
17070 Michael Kerrisk
17071 Remove sentence saying that libc 5.0.9 is still widely used
17072 That was a *long* time ago.
17073
17074 on_exit.3
17075 Michael Kerrisk
17076 Document handling of registrations on fork(2) and execve(2)
17077 Treatment in these cases is the same as for atexit(3).
17078 Michael Kerrisk
17079 Arg given to registered function is status from *last* call to exit()
17080 It's a subtle point, but if a registered function itself
17081 calls exit(3), then subsequent functions that were registered
17082 with on_exit(3) will see the exit status given to the more
17083 recent exit(3) call.
17084 Michael Kerrisk
17085 Note that same function may be registered multiple times
17086
17087 setlocale.3
17088 locale.7
17089 Michael Kerrisk
17090 Clean up the description of LANGUAGE environment variable
17091 Clean up the $LANGUAGE description, by removing bogus comments
17092 from setlocale(3) and expanding the mention in locale(7).
17093
17094 Maybe you will decide that a more detailed description
17095 should be left to the gettext(3) documentation, but I
17096 actually care about the invisible part of the patch more
17097 since the comments have put me off the track initially
17098 ($LANGUAGE has nothing to do with setlocale(3) and is
17099 completely isolated to gettext, as obvious from the
17100 glibc sources).
17101
17102 proc.5
17103 Michael Kerrisk
17104 /proc/stat: s/minor/disk_idx/ in description of /proc/stat
17105 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=225619
17106
17107 capabilities.7
17108 Drake Wilson
17109 Various minor fixes as per Debian bug 471029
17110 The relevant pieces of
17111 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=471029 are:
17112
17113 - Delete duplicate subentry for KEYCTL_CHOWN/KEYCTL_SETPERM
17114 operations in the CAP_SYS_ADMIN entry. (It feels like that
17115 capability entry should be converted to a list, but I've
17116 left it in semicolon-delimited form for now.)
17117
17118 - Remove text about ENFILE from the text about the
17119 /proc/sys/fs/file-max limit in the CAP_SYS_ADMIN entry, since
17120 this is already described in the man pages for the relevant
17121 ofile-creating system calls.
17122
17123 - Correct or clarify a few other bits of grammar and such;
17124 see the diff file itself for details.
17125
17126 socket.7
17127 Michael Kerrisk
17128 SEE ALSO: add tcp(7) and udp(7)
17129
17130 tcp.7
17131 Michael Kerrisk
17132 Relocate out-of-band data discussion
17133 Move to a new subsection entitled "Sockets API".
17134 Michael Kerrisk
17135 Note that MSG_PEEK can be used on out-of-band data
17136
17137 time.7
17138 Michael Kerrisk
17139 SEE ALSO: add clock_gettime(3)
17140
17141 unix.7
17142 Michael Kerrisk
17143 Unix domain sockets don't support the recv() MSG_TRUNC flag
17144 Michael Kerrisk
17145 Retitled subsection "(Un)supported features" to "Sockets API"
17146 This is consistent with the recent change in tcp(7).
17147
17148
17149
17150 ==================== Changes in man-pages-3.16 ====================
17151
17152 Released: 2009-01-13, Christchurch
17153
17154
17155 Contributors
17156 ------------
17157
17158 The following people contributed notes, ideas, or patches that have
17159 been incorporated in changes in this release:
17160
17161 Colin Watson <cjwatson@ubuntu.com>
17162 Florentin Duneau <fduneau@gmail.com>
17163 Petr Baudis <pasky@suse.cz>
17164
17165 Apologies if I missed anyone!
17166
17167
17168 New and rewritten pages
17169 -----------------------
17170
17171 pthread_getcpuclockid.3
17172 Michael Kerrisk
17173 New page documenting pthread_getcpuclockid(3)
17174
17175 libc.7
17176 Michael Kerrisk
17177 New page giving brief overview of C libraries on Linux
17178
17179 rtld-audit.7
17180 Michael Kerrisk
17181 New page documenting dynamic linker auditing API
17182
17183
17184 Newly documented interfaces in existing pages
17185 ---------------------------------------------
17186
17187 ld.so.8
17188 Petr Baudis
17189 Document LD_AUDIT
17190 Petr Baudis
17191 Document LD_POINTER_GUARD
17192
17193
17194 New and changed links
17195 ---------------------
17196
17197 gethostid.2
17198 Michael Kerrisk
17199 New link to new page location in Section 3
17200
17201 sethostid.2
17202 Michael Kerrisk
17203 Change link to point to new page location in Section 3
17204
17205 sethostid.3
17206 Michael Kerrisk
17207 New link to relocated page in Section 3
17208
17209 glibc.7
17210 Michael Kerrisk
17211 New link to new libc.7
17212
17213
17214 Global changes
17215 --------------
17216
17217 syscalls.2
17218 feature_test_macros.7
17219 standards.7
17220 Michael Kerrisk
17221 SEE ALSO: add libc(7)
17222
17223 dlopen.3
17224 ld.so.8
17225 Michael Kerrisk
17226 SEE ALSO: add rtld-audit(7)
17227
17228
17229 Changes to individual pages
17230 ---------------------------
17231
17232 gethostid.2
17233 Michael Kerrisk
17234 Move to Section 3
17235 The interfaces documented in this page are purely glibc.
17236
17237 syscalls.2
17238 Michael Kerrisk
17239 Kernel 2.6.28 adds accept4()
17240
17241 clock_getres.3
17242 Michael Kerrisk
17243 SEE ALSO: Add pthread_getcpuclockid(3)
17244
17245 fmemopen.3
17246 Michael Kerrisk
17247 Fix VERSIONS information
17248
17249 gethostid.3
17250 Michael Kerrisk
17251 Before version 2.2, glibc stored the host ID in /var/adm/hostid
17252 Also: rewrite some text describing the /etc/hostid file, so that
17253 this location is referred to just once on the page.
17254 Michael Kerrisk
17255 RETURN VALUE: describe return value of sethostid()
17256 Michael Kerrisk
17257 Added BUGS section noting that ID can't be guaranteed to be unique
17258 Michael Kerrisk
17259 Added ERRORS section describing errors for sethostid()
17260 Michael Kerrisk
17261 Update section number to reflect relocation into Section 3
17262
17263 printf.3
17264 Michael Kerrisk
17265 Source and destination buffers may not overlap for *s*printf()
17266 http://sourceware.org/bugzilla/show_bug.cgi?id=7075
17267
17268 Some existing code relies on techniques like the following to
17269 append text to a buffer:
17270
17271 $ cat s.c
17272 #include <stdio.h>
17273 char buf[80] = "not ";
17274 main()
17275 {
17276 sprintf(buf, "%sfail", buf);
17277 puts(buf);
17278 return 0;
17279 }
17280
17281 $ cc s.c
17282 $ ./a.out
17283 not fail
17284
17285 However, the standards say the results are undefined if source
17286 and destination buffers overlap, and with suitable compiler
17287 options, recent changes can cause unexpected results:
17288
17289 $ cc -v 2>&1 | grep gcc
17290 gcc version 4.3.1 20080507 (prerelease) [gcc-4_3-branch revision 135036] (SUSE Linux)
17291 $ cc -D_FORTIFY_SOURCE -O2 s.c
17292 $ ./a.out
17293 fail
17294
17295 readdir.3
17296 Michael Kerrisk
17297 Rewrite text describing 'dirent' fields standardized in POSIX.1
17298 Michael Kerrisk
17299 Clarify text for return value/errno setting for end-of-stream case
17300
17301 nscd.8
17302 Petr Baudis
17303 Correct NOTES section on reloading configuration files
17304 It behaved this way at least since
17305 "Sun Oct 18 15:02:11 1998 +0000",
17306 some four months after including the nscd implementation
17307 in glibc. But there does seem to be a short window between
17308 glibc-2.1 and glibc-2.1.3 when nscd -i was not available,
17309 I don't think it's worth muddling the point of the page
17310 with that, though.
17311
17312
17313 ==================== Changes in man-pages-3.17 ====================
17314
17315 Released: 2009-01-19, Hobart
17316
17317
17318 Contributors
17319 ------------
17320
17321 The following people contributed notes, ideas, or patches that have
17322 been incorporated in changes in this release:
17323
17324 Adeodato Simó <dato@net.com.org.es>
17325 Bastien ROUCARIES <roucaries.bastien@gmail.com>
17326 Davide Libenzi <davidel@xmailserver.org>
17327 Lefteris Dimitroulakis <edimitro@tee.gr>
17328 Mads Martin Joergensen <mmj@mmj.dk>
17329 Marc Lehmann <schmorp@schmorp.de>
17330 Martin (Joey) Schulze <joey@infodrom.org>
17331 Michael Kerrisk <mtk.manpages@gmail.com>
17332 Petr Baudis <pasky@suse.cz>
17333 Sam Varshavchik <mrsam@courier-mta.com>
17334 Vegard Nossum <vegard.nossum@gmail.com>
17335
17336 Apologies if I missed anyone!
17337
17338
17339 New and rewritten pages
17340 -----------------------
17341
17342 endian.3
17343 Michael Kerrisk
17344 New page documenting byte order conversion functions
17345 Document functions (new in glibc 2.9) for conversion between
17346 host byte order and big-/little- endian byte order:
17347 htobe16(), htole16(), be16toh(), le16toh(),
17348 htobe32(), htole32(), be32toh(), le32toh(),
17349 htobe64(), htole64(), be64toh(), le64toh()
17350
17351 getifaddrs.3
17352 Petr Baudis
17353 New page documenting getifaddrs(3) and freeifaddrs(3)
17354 Many edits and changes of Petr's initial draft by mtk
17355
17356 cp1251.7
17357 Lefteris Dimitroulakis
17358 New page documenting CP 1251 (Windows Cyrillic) character set
17359
17360 iso-8859-10.7
17361 Lefteris Dimitroulakis
17362 New page documenting ISO 8859-10 character set
17363
17364 iso_8859-13.7
17365 Lefteris Dimitroulakis
17366 New page documenting ISO 8859-13 character set
17367
17368 iso_8859-14.7
17369 Lefteris Dimitroulakis
17370 New page documenting ISO 8859-14 character set
17371
17372 iso_8859-3.7
17373 Lefteris Dimitroulakis
17374 New page documenting ISO 8859-3 character set
17375
17376 iso_8859-5.7
17377 Lefteris Dimitroulakis
17378 New page documenting ISO 8859-5 character set
17379
17380 iso_8859-8.7
17381 Lefteris Dimitroulakis
17382 New page documenting ISO 8859-8 character set
17383
17384 koi8-u.7
17385 Lefteris Dimitroulakis
17386 New page documenting KOI8-U character set
17387
17388
17389 Newly documented interfaces in existing pages
17390 ---------------------------------------------
17391
17392 epoll.7
17393 Michael Kerrisk
17394 Document /proc interfaces for limiting kernel memory usage
17395 Document the following /proc files that were added in
17396 Linux 2.6.28:
17397 /proc/sys/fs/epoll/max_user_instances
17398 /proc/sys/fs/epoll/max_user_watches
17399
17400 netdevice.7
17401 Michael Kerrisk
17402 Document recently added interface flags
17403 IFF_LOWER_UP (since Linux 2.6.17)
17404 IFF_DORMANT (since Linux 2.6.17)
17405 IFF_ECHO (since Linux 2.6.25)
17406
17407 Documentation taken from comments in <linux/if.h>
17408
17409
17410 New and changed links
17411 ---------------------
17412
17413 freeifaddrs.3
17414 Michael Kerrisk
17415 New link to new getifaddrs.3
17416
17417 htobe16.3
17418 htole16.3
17419 be16toh.3
17420 le16toh.3
17421 htobe32.3
17422 htole32.3
17423 be32toh.3
17424 le32toh.3
17425 htobe64.3
17426 htole64.3
17427 be64toh.3
17428 le64toh.3
17429 Michael Kerrisk
17430 New links to new endian.3
17431
17432 iso-8859-10.7
17433 iso_8859_10.7
17434 latin6.7
17435 Michael Kerrisk
17436 New links to new iso_8859-10.7
17437
17438 iso-8859-13.7
17439 iso_8859_13.7
17440 latin7.7
17441 Michael Kerrisk
17442 New links to new iso_8859-13.7
17443
17444 iso-8859-14.7
17445 iso_8859_14.7
17446 latin8.7
17447 Michael Kerrisk
17448 New links to new iso_8859-14.7
17449
17450 iso-8859-3.7
17451 iso_8859_3.7
17452 latin3.7
17453 Michael Kerrisk
17454 New links to new iso_8859-3.7
17455
17456 iso-8859-5.7
17457 iso_8859_5.7
17458 Michael Kerrisk
17459 New links to new iso_8859-5.7
17460
17461 iso-8859-8.7
17462 iso_8859_8.7
17463 Michael Kerrisk
17464 New links to new iso_8859-8.7
17465
17466
17467 Changes to individual pages
17468 ---------------------------
17469
17470 bind.2
17471 Michael Kerrisk
17472 SEE ALSO: Add getifaddrs(3)
17473
17474 epoll_create.2
17475 Michael Kerrisk
17476 Document EMFILE error
17477 This error is encountered when the limit imposed by
17478 /proc/sys/fs/epoll/max_user_instances is encountered.
17479 Michael Kerrisk
17480 Clarify distinction between epoll instance and epoll file descriptor
17481 Reword so that the notion of an epoll instance is made clear,
17482 and made distinct from the notion of an epoll file descriptor.
17483 Some other minor rewordings also.
17484
17485 epoll_ctl.2
17486 Michael Kerrisk
17487 Reordered parts of the text
17488 Michael Kerrisk
17489 Introduce notion of epoll instance
17490 Introduce notion of epoll instance as distinct from
17491 epoll file descriptor. Plus other wording clean-ups.
17492 Michael Kerrisk
17493 Document ENOSPC error (new in Linux 2.6.28)
17494 This error results when the limit imposed by
17495 /proc/sys/fs/epoll/max_user_watches is encountered.
17496
17497 epoll_wait.2
17498 Michael Kerrisk
17499 Introduce the notion of an epoll instance into text
17500
17501 getdents.2
17502 Michael Kerrisk
17503 Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN
17504
17505 gethostid.2
17506 Michael Kerrisk
17507 Rename file (was misnamed gethostd.2 in previous release)
17508
17509 getsockname.2
17510 Michael Kerrisk
17511 SEE ALSO: Add getifaddrs(3)
17512
17513 signalfd.2
17514 Michael Kerrisk
17515 Fix description of fork() semantics
17516 The page text described the semantics of the initial
17517 implementation of signalfd(). These were changed early on,
17518 but the man page wasn't updated.
17519
17520 byteorder.3
17521 Michael Kerrisk
17522 SEE ALSO: add endian(3)
17523
17524 longjmp.3
17525 Michael Kerrisk
17526 Clarify wording re saving/restoring signal mask
17527 Michael Kerrisk
17528 siglongjmp() restores signal mask iff 'savesigs' was non-zero
17529 Note that siglongjmp() restores signal mask if, and only
17530 if, 'savesigs' argument of sigsetjmp() was non-zero. (Previous
17531 text omitted the "and only if".)
17532
17533 memccpy.3
17534 Michael Kerrisk
17535 Fix CONFORMING TO: s/C99/POSIX.1-2001/
17536 Michael Kerrisk
17537 If the memory areas overlap, the results are undefined
17538
17539 sethostid.3
17540 Michael Kerrisk
17541 Rename file (was misnamed sethostd.3 in previous release)
17542
17543 setjmp.3
17544 Michael Kerrisk
17545 Clarify wording re saving/restoring signal mask
17546 Michael Kerrisk
17547 Clarify when setjmp() provides BSD vs System V signal mask semantics
17548
17549 strsep.3
17550 Michael Kerrisk
17551 BUGS: explicitly list problems afflicting strsep()
17552 Previously, the page said this function suffered the same
17553 problems as strtok(), but in fact strsep() doesn't suffer
17554 from all of the same problems as strtok(), so explicitly
17555 list just the problems of strsep() in the strsep.3 page.
17556
17557 proc.5
17558 Michael Kerrisk
17559 Add pointer to epoll(7) for description of epoll /proc files
17560
17561 epoll.7
17562 Michael Kerrisk
17563 Various wording changes to improve clarity and consistency
17564
17565
17566 ==================== Changes in man-pages-3.18 ====================
17567
17568 Released: 2009-02-10, Christchurch
17569
17570
17571 Contributors
17572 ------------
17573
17574 The following people contributed notes, ideas, or patches that have
17575 been incorporated in changes in this release:
17576
17577 Andi Kleen <andi@firstfloor.org>
17578 Bastien ROUCARIES <roucaries.bastien@gmail.com>
17579 Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
17580 Christopher Head <chead@telus.net>
17581 Florentin Duneau <fduneau@gmail.com>
17582 Guillem Jover <guillem@debian.org>
17583 Lefteris Dimitroulakis <edimitro@tee.gr>
17584 Lucio Maciel <luciofm@gmail.com>
17585 Michael Kerrisk <mtk.manpages@gmail.com>
17586 Mike Frysinger <vapier@gentoo.org>
17587 Peter Zijlstra <peterz@infradead.org>
17588 Petr Baudis <pasky@suse.cz>
17589 Sam Varshavchik <mrsam@courier-mta.com>
17590 Satyam Sharma <ssatyam@cse.iitk.ac.in>
17591 Sebastian Kienzl <seb@riot.org>
17592 Timo Sirainen <tss@iki.fi>
17593 Vegard Nossum <vegard.nossum@gmail.com>
17594
17595 Apologies if I missed anyone!
17596
17597
17598 New and rewritten pages
17599 -----------------------
17600
17601 armscii-8.7
17602 Lefteris Dimitroulakis
17603 New page documenting ArmSCII-8 character set
17604
17605 iso_8859-11.7
17606 Lefteris Dimitroulakis
17607 New page documenting ISO 8859-11 character set
17608
17609 iso_8859-4.7
17610 Lefteris Dimitroulakis
17611 New page documenting ISO 8859-4 character set
17612
17613 iso_8859-6.7
17614 Lefteris Dimitroulakis
17615 New page describing ISO 8859-6 character set
17616
17617 pthread_kill.3
17618 Michael Kerrisk
17619 New page documenting pthread_kill(3)
17620
17621 pthread_kill_other_threads_np.3
17622 Michael Kerrisk
17623 New page documenting pthread_kill_other_threads_np(3)
17624
17625 pthread_sigmask.3
17626 Michael Kerrisk
17627 New page documenting pthread_sigmask(3)
17628
17629
17630 Newly documented interfaces in existing pages
17631 ---------------------------------------------
17632
17633 clock_getres.3
17634 Michael Kerrisk
17635 Document CLOCK_MONOTONIC_RAW, new in 2.6.28
17636
17637
17638 New and changed links
17639 ---------------------
17640
17641 clock_gettime.2
17642 clock_settime.2
17643 clock_getres.3
17644 clock_gettime.3
17645 clock_settime.3
17646 Michael Kerrisk
17647 Update links to reflect the fact that clock_* pages are now in
17648 Section 2
17649
17650 iso-8859-11.7
17651 iso_8859_11.7
17652 Michael Kerrisk
17653 New links to new iso_8859-11.7
17654
17655 iso-8859-4.7
17656 iso_8859_4.7
17657 latin4.7
17658 Michael Kerrisk
17659 New links to new iso_8859-4.7
17660
17661 iso-8859-6.7
17662 iso_8859_6.7
17663 Michael Kerrisk
17664 New links to new iso_8859-6.7
17665
17666 tis-620.7
17667 Michael Kerrisk
17668 New link to new iso_8859-11.7
17669
17670
17671 Global changes
17672 --------------
17673
17674 clock_nanosleep.2
17675 getrusage.2
17676 timerfd_create.2
17677 clock.3
17678 clock_getcpuclockid.3
17679 ftime.3
17680 pthread_create.3
17681 pthread_getcpuclockid.3
17682 pthread_tryjoin_np.3
17683 sem_wait.3
17684 time.7
17685 Michael Kerrisk
17686 Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
17687
17688 clock_nanosleep.2
17689 execve.2
17690 fork.2
17691 nanosleep.2
17692 sigaction.2
17693 timerfd_create.2
17694 pthread_getcpuclockid.3
17695 ualarm.3
17696 usleep.3
17697 pthreads.7
17698 time.7
17699 Michael Kerrisk
17700 Global fix: s/(3)/(2)/ in section number xrefs for timer_*() API
17701 The POSIX timers API is implemented (mostly) within the kernel,
17702 so these interfaces are system calls. Although there are as yet
17703 no man pages, when they are added they should be in Section 2,
17704 not 3. Therefore fix those pages that currently refer to these
17705 interfaces as being in Section 3.
17706
17707
17708 Changes to individual pages
17709 ---------------------------
17710
17711 capget.2
17712 Andi Kleen
17713 Add some details and relocate a paragraph
17714 While writing a little program using capset
17715 I found the capset manpage quite light on crucial
17716 details and I had to resort to RTFS.
17717
17718 This patch improves the points I found unclear
17719 and also moves one misplaced paragraph around.
17720
17721 clock_getres.2
17722 Michael Kerrisk
17723 Move page from Section 3 to Section 2
17724
17725 eventfd.2
17726 Michael Kerrisk
17727 glibc eventfd() supports the use of eventfd2() since version 2.9
17728
17729 fork.2
17730 Michael Kerrisk
17731 SEE ALSO: add daemon(3)
17732
17733 getdents.2
17734 Michael Kerrisk
17735 Remove unneeded HAVE_D_TYPE from example program
17736 Since d_type will always just return DT_UNKNOWN before
17737 kernel 2.6.4, we don't need to use a conditional for
17738 determining whether we use this flag.
17739
17740 nanosleep.2
17741 Michael Kerrisk
17742 Relocated misplaced BUGS heading
17743
17744 select_tut.2
17745 Michael Kerrisk
17746 Clean up error checking in example program (no semantic changes)
17747 Michael Kerrisk
17748 Many parts tidied and rewritten
17749 Remove some redundant text, clarify various pieces,
17750 tidy example code, etc.
17751 Michael Kerrisk
17752 Bug fixes + rewrites in example program
17753 Sebastien pointed out that the first example program
17754 wrongly thinks it can count signals.
17755 Also, some further rewrites by mtk.
17756
17757 socket.2
17758 Michael Kerrisk
17759 BUGS: Remove discussion SOCK_UUCP
17760 As time goes on, this sentence becomes less a piece of humor,
17761 and more a puzzle.
17762
17763 stat.2
17764 Michael Kerrisk
17765 Note that open(O_NOATIME) also causes st_atime not to be updated
17766
17767 timerfd_create.2
17768 Michael Kerrisk
17769 Add BUGS noting that timerfd supports fewer clock types than
17770 timer_create()
17771
17772 btowc.3
17773 Michael Kerrisk
17774 SEE ALSO: add wctob(3)
17775
17776 clock_getcpuclockid.3
17777 Michael Kerrisk
17778 SEE ALSO: add pthread_getcpuclockid(3)
17779
17780 cos.3
17781 Michael Kerrisk
17782 SEE ALSO: add sincos(3)
17783
17784 fexecve.3
17785 Timo Sirainen
17786 Note that fexecve() depends on a mounted /proc
17787 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514043
17788 Michael Kerrisk
17789 CONFORMING TO: note addition of fexecve() in POSIX.1-2008
17790 Michael Kerrisk
17791 'fd' must be opened read-only and refer to a file that is executable
17792
17793 fmemopen.3
17794 Michael Kerrisk
17795 CONFORMING TO: note that these functions are in POSIX.1-2008
17796
17797 getifaddrs.3
17798 Lucio Maciel
17799 Fix memory leak in example program
17800 Petr Baudis
17801 Various small fixes
17802
17803 getpwnam.3
17804 Michael Kerrisk
17805 SEE ALSO: add getspnam(3)
17806
17807 getumask.3
17808 Michael Kerrisk
17809 Updated glibc version number in NOTES
17810
17811 ilogb.3
17812 Michael Kerrisk
17813 SEE ALSO: add significand(3)
17814
17815 intro.3
17816 Michael Kerrisk
17817 SEE ALSO: add libc(7)
17818
17819 isalpha.3
17820 Michael Kerrisk
17821 Fix statement that isalpa() is obsolete; should be isascii()
17822 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=512709
17823 Michael Kerrisk
17824 SEE ALSO: add toascii(3)
17825
17826 mq_notify.3
17827 Michael Kerrisk
17828 Add cross reference to pthread_attr_init(3)
17829
17830 pthread_attr_setaffinity_np.3
17831 Michael Kerrisk
17832 SYNOPSIS: Fix declaration of 'attr'
17833
17834 pthread_getcpuclockid.3
17835 Michael Kerrisk
17836 SYNOPSIS: fix type of 'thread'
17837
17838 qsort.3
17839 Michael Kerrisk
17840 EXAMPLE: remove unnecessary "#include <unistd.h>"
17841
17842 random.3
17843 Michael Kerrisk
17844 SEE ALSO: add random_r(3)
17845
17846 remainder.3
17847 Michael Kerrisk
17848 SEE ALSO: add div(3)
17849
17850 scandir.3
17851 Michael Kerrisk
17852 CONFORMING TO: alphasort() and scandir() are added to POSIX.1-2008
17853 Michael Kerrisk
17854 CONFORMING TO: note that versionsort() was added to glibc in
17855 version 2.1
17856
17857 sem_wait.3
17858 Michael Kerrisk
17859 SEE ALSO: add clock_gettime(2)
17860
17861 significand.3
17862 Michael Kerrisk
17863 Add CONFORMING TO noting that this function is unstandardized
17864
17865 sigwait.3
17866 Michael Kerrisk
17867 Add EXAMPLES section referring to pthread_sigmask(3)
17868
17869 sin.3
17870 Michael Kerrisk
17871 SEE ALSO: add sincos(3)
17872
17873 stpcpy.3
17874 Michael Kerrisk
17875 Add BUGS section noting the possibility of buffer overruns
17876 Michael Kerrisk
17877 Add missing pieces/fix various problems in example program
17878 Michael Kerrisk
17879 CONFORMING TO: stpcpy() is nowadays on the BSDs
17880 Michael Kerrisk
17881 SEE ALSO: add stpcpy.3
17882
17883 wcscasecmp.3
17884 Michael Kerrisk
17885 CONFORMING TO: note that this function is added in POSIX.1-2008
17886
17887 wcsdup.3
17888 Michael Kerrisk
17889 CONFORMING TO: note that this function was added in POSIX.1-2008
17890
17891 wcsncasecmp.3
17892 Michael Kerrisk
17893 CONFORMING TO: note that this function is added in POSIX.1-2008
17894
17895 wctob.3
17896 Michael Kerrisk
17897 SEE ALSO: add btowc(3)
17898
17899 proc.5
17900 Michael Kerrisk
17901 Remove mention of epoll/max_user_instances
17902 (Since this interface appeared in 2.6.28, and then
17903 disappeared in 2.6.29.)
17904
17905 ascii.7
17906 Michael Kerrisk
17907 Update SEE ALSO list to include pages added in 3.17
17908 Michael Kerrisk
17909 SEE ALSO: add recently added iso_8859-*(7) pages
17910
17911 epoll.7
17912 Michael Kerrisk
17913 remove documentation of /proc/sys/fs/epoll/max_user_instances
17914 This /proc interface appeared in 2.6.28. but will be
17915 removed in 2.6.29.
17916
17917 Also, document change in default value of
17918 /proc/sys/fs/epoll/max_user_watches (was 1/32 of lowmem,
17919 now 1/25 of lowmem).
17920
17921 koi8-r.7
17922 Michael Kerrisk
17923 SEE ALSO: add koi8-u(7); remove crufty text
17924
17925 standards.7
17926 Michael Kerrisk
17927 Update to note that latest POSIX/SUS was ratified in 2008
17928
17929 time.7
17930 Michael Kerrisk
17931 SEE ALSO: add pthread_getcpuclockid(3)
17932
17933
17934 ==================== Changes in man-pages-3.19 ====================
17935
17936 Released: 2009-02-20, Putaruru
17937
17938
17939 Contributors
17940 ------------
17941
17942 The following people contributed notes, ideas, or patches that have
17943 been incorporated in changes in this release:
17944
17945 Christian Siebert <christian.siebert@gmail.com>
17946 Jan Engelhardt <jengelh@medozas.de>
17947 Jens Thoms Toerring <jt@toerring.de>
17948 Kir Kolyshkin <kir@openvz.org>
17949 Mark Hills <mark@pogo.org.uk>
17950 Michael Kerrisk <mtk.manpages@gmail.com>
17951 Parag Warudkar <parag.lkml@gmail.com>
17952 Peter Zijlstra <a.p.zijlstra@chello.nl>
17953 Sami Liedes <sliedes@cc.hut.fi>
17954
17955 Apologies if I missed anyone!
17956
17957
17958 New and rewritten pages
17959 -----------------------
17960
17961 timer_create.2
17962 Michael Kerrisk
17963 New page documenting timer_create(2)
17964
17965 timer_delete.2
17966 Michael Kerrisk
17967 New page documenting timer_delete(2)
17968
17969 timer_getoverrun.2
17970 Michael Kerrisk
17971 New page documenting timer_getoverrun(2)
17972
17973 timer_settime.2
17974 Michael Kerrisk
17975 New page documenting timer_settime(2) and timer_gettime(2)
17976
17977
17978 New and changed links
17979 ---------------------
17980
17981 timer_gettime.2
17982 Michael Kerrisk
17983 New link to new timer_settime.2
17984
17985
17986 Global changes
17987 --------------
17988
17989 Various pages
17990 Kir Kolyshkin
17991 Trivial punctuation fixes in SEE ALSO
17992 In SEE ALSO, when a few man pages are referenced, those
17993 are divided by commas. Every reference is on a separate
17994 line, and all lines but the last one should end with
17995 comma. I spotted one place where there is no comma in
17996 between references, and mocked up an awk script to find
17997 similar places:
17998
17999 for f in man*/*; do
18000 awk '
18001 /^.SH ["]SEE ALSO["]/ {
18002 sa=1; print "== " FILENAME " =="; print; next
18003 }
18004 /^\.(PP|SH)/ {
18005 sa=0; no=0; next
18006 }
18007 /^\.BR/ {
18008 if (sa==1) {
18009 print;
18010 if (no == 1)
18011 print "Missing comma in " FILENAME " +" FNR-1; no=0
18012 }
18013 }
18014 /^\.BR .*)$/ {
18015 if (sa==1)
18016 no=1;
18017 next
18018 }
18019 /\.\\"/ {next}
18020 /.*/ {
18021 if (sa==1) {
18022 print; next
18023 }
18024 }
18025 ' $f;
18026 done | fgrep 'Missing comma'
18027
18028 This patch fixes all the places found by the above script.
18029
18030 Also, there is an extra dot at the end of uri.7 "SEE ALSO"
18031 section. Removed as per man-pages(7) recommendation.
18032
18033
18034 Changes to individual pages
18035 ---------------------------
18036
18037 getitimer.2
18038 clock_getcpuclockid.3
18039 time.7
18040 Michael Kerrisk
18041 SEE ALSO: add timer_create(2)
18042
18043 getitimer.2
18044 Michael Kerrisk
18045 Rename arguments for consistency with other timer pages
18046 Also some other minor wording improvements
18047
18048 splice.2
18049 Mark Hills
18050 ERRORS: Add EINVAL case for file opened O_APPEND
18051 Target file cannot be opened in append (O_APPEND) mode
18052
18053 In kernels prior to v2.6.27 splice() to a file in
18054 append mode is broken, and since that version it is
18055 disallowed. It is possible this behaviour may change
18056 in the future; see the kernel commit message
18057 (efc968d450e013049a662d22727cf132618dcb2f) for more
18058 information.
18059
18060 syscalls.2
18061 Michael Kerrisk
18062 Note that getpmsg(2) and putmsg(2) are unimplemented
18063 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771
18064
18065 timerfd_create.2
18066 Michael Kerrisk
18067 ERRORS: add EFAULT
18068
18069 timerfd_create.2
18070 Michael Kerrisk
18071 Rename timerfd_settime() 'curr_value' arg to 'old_value'
18072 For consistency with related pages.
18073
18074 vm86.2
18075 Parag Warudkar
18076 CONFORMING TO: Add 32-bit specific
18077 Note that this call is only on *32-bit* Intel
18078
18079 mq_open.3
18080 Michael Kerrisk
18081 ERRORS: add ENOENT error for name == "/"
18082
18083 mq_open.3
18084 Michael Kerrisk
18085 ERRORS: Add EACCES error for name containing > 1 slash
18086
18087 sem_open.3
18088 Michael Kerrisk
18089 ERRORS: add EINVAL error where name == "/"
18090
18091 sem_open.3
18092 Jens Thoms Toerring
18093 Add case of non-well-formed name to ENOENT
18094
18095 shm_open.3
18096 Michael Kerrisk
18097 Clarify rules for construction of shared memory object names
18098
18099 proc.5
18100 Michael Kerrisk
18101 Add description of /proc/sys/kernel/sysrq
18102 Reported by: Goerghe Cosorea <gheorghe.coserea@gmail.com>
18103
18104 proc.5
18105 Michael Kerrisk
18106 Put /proc/modules entry in correct alphabetical order
18107
18108 ascii.7
18109 Kir Kolyshkin
18110 Fix formatting of tables on second page to use monospaced font
18111
18112 mq_overview.7
18113 Michael Kerrisk
18114 Clarify construction rules for message queue object names
18115
18116 sem_overview.7
18117 Michael Kerrisk
18118 Clarify construction rules for semaphore object names
18119 See also http://groups.google.com/group/comp.os.linux.development.apps/browse_thread/thread/b4a67caa765cb65f
18120
18121
18122
18123 ==================== Changes in man-pages-3.20 ====================
18124
18125 Released: 2009-03-31, Christchurch
18126
18127
18128 Contributors
18129 ------------
18130
18131 The following people contributed notes, ideas, or patches that have
18132 been incorporated in changes in this release:
18133
18134 Alan Curry <pacman@kosh.dhis.org>
18135 Américo Wang <xiyou.wangcong@gmail.com>
18136 Andi Kleen <andi@firstfloor.org>
18137 Carlos O'Donell <carlos@systemhalted.org>
18138 Chunming Chang <cchang@aerohive.com>
18139 Colin Watson <cjwatson@debian.org>
18140 Eelco Dolstra <e.dolstra@tudelft.nl>
18141 Jan Engelhardt <jengelh@medozas.de>
18142 Jens Thoms Toerring <jt@toerring.de>
18143 Johannes Stezenbach <js@sig21.net>
18144 Leandro A. F. Pereira <leandro@tia.mat.br>
18145 Martin Gebert <martin.gebert@alpha-bit.de>
18146 Michael Kerrisk <mtk.manpages@gmail.com>
18147 Mike O'Connor <stew@vireo.org>
18148 Mike Frysinger <vapier@gentoo.org>
18149 Nikanth Karthikesan <knikanth@suse.de>
18150 Reuben Thomas <rrt@femur.dyndns.org>
18151 Reuben Thomas <rrt@sc3d.org>
18152 Roland McGrath <roland@redhat.com>
18153 Sam Varshavchik <mrsam@courier-mta.com>
18154 Simon Gomizelj <simongmzlg@gmail.com>
18155 Tanaka Akira <akr@fsij.org>
18156 Teddy Hogeborn <teddy@fukt.bsnet.se>
18157 Walter Jontofsohn <wjontofs@atriumberlin.de>
18158
18159 Apologies if I missed anyone!
18160
18161
18162 New and rewritten pages
18163 -----------------------
18164
18165 cpuid.4
18166 Andi Kleen
18167 New page for cpuid access device
18168
18169 msr.4
18170 Andi Kleen
18171 New page documenting x86 CPU MSR access device
18172
18173
18174 Newly documented interfaces in existing pages
18175 ---------------------------------------------
18176
18177 proc.5
18178 Américo Wang
18179 Document /proc/sys/vm/swappiness
18180 Michael Kerrisk
18181 Document /proc/sysrq-trigger
18182
18183
18184 Global changes
18185 --------------
18186
18187 timer_create.2
18188 timer_delete.2
18189 timer_getoverrun.2
18190 timer_settime.2
18191 numa.7
18192 Michael Kerrisk
18193 Make source layout of 'Link with' text consistent with other pages
18194 No actual change to formatted output, but this makes the
18195 page sources more consistent for the purpose of grepping, etc.
18196
18197 mempcpy.3
18198 signbit.3
18199 significand.3
18200 Michael Kerrisk
18201 Global fix: acknowledge FSF in copyright
18202 These pages are heavily based on original material in
18203 glibc info pages, but the comments in the source of the pages
18204 did not acknowledge the FSF copyright on the original material.
18205 Fix that.
18206
18207 accept.2
18208 read.2
18209 recv.2
18210 send.2
18211 write.2
18212 Michael Kerrisk
18213 Fix discussion of EAGAIN/EWOULDBLOCK errors
18214 For a non-blocking socket, POSIX.1-2001/2008 allow either
18215 EAGAIN or EWOULDBLOCK to be returned in cases where a call
18216 would have blocked. Although these constants are defined
18217 with the same value on most Linux architectures (PA-RISC
18218 is the exception), POSIX.1 does not require them to have
18219 the same value. Therefore, a portable application using
18220 the sockets API should test for both errors when checking
18221 this case.
18222
18223 (NB POSIX.1 only mentions EWOULDBLOCK in the context of
18224 the sockets interfaces.)
18225
18226 Change made after a note cross-posted on linux-arch@vger,
18227 http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
18228 and a suggestion for write(2) from Carlos O'Donell
18229
18230 basename.3
18231 getgrent.3
18232 getgrnam.3
18233 getpwent.3
18234 getpwnam.3
18235 readdir.3
18236 Michael Kerrisk
18237 Note that returned pointer should not be given to free()
18238
18239 armscii-8.7
18240 cp1251.7
18241 iso_8859-10.7
18242 iso_8859-11.7
18243 iso_8859-13.7
18244 iso_8859-14.7
18245 iso_8859-15.7
18246 iso_8859-16.7
18247 iso_8859-2.7
18248 iso_8859-3.7
18249 iso_8859-4.7
18250 iso_8859-5.7
18251 iso_8859-6.7
18252 iso_8859-7.7
18253 iso_8859-8.7
18254 iso_8859-9.7
18255 koi8-r.7
18256 koi8-u.7
18257 Michael Kerrisk
18258 Add explicit character set encoding to first line of source
18259 Nowadays mandb has provision to understand a character set
18260 encoding that is explicitly indicated in the first line
18261 of the source. As pointed out by Colin Watson, including
18262 such an explicit indication on pages encoded in anything
18263 other than ISO 8859-1 or UTF-8 is useful for man-pages
18264 that aren't shipped in UTF-8.
18265
18266 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519209
18267 and for some other background (responded to by Colin Watson
18268 in the above report):
18269 http://thread.gmane.org/gmane.comp.internationalization.linux/6040
18270 ("man page encoding", 5 Jul 2005)
18271
18272
18273 Changes to individual pages
18274 ---------------------------
18275
18276 fallocate.2
18277 Michael Kerrisk
18278 VERSIONS: glibc support is provided since version 2.10
18279
18280 fcntl.2
18281 Michael Kerrisk
18282 Remove mention of EWOULDBLOCK from discussion of mandatory locking
18283 In the kernel, the error on encountering a mandatory lock is
18284 EAGAIN. Although EAGAIN and EWOULDBLOCK are the same on
18285 most Linux architectures, on some they are not, so don't
18286 mention EWOULDBLOCK as it is misleading. (Mea culpa.)
18287
18288 getcontext.2
18289 Michael Kerrisk
18290 Note that POSIX.1-2008 removes the specification of getcontext()
18291
18292 getitimer.2
18293 Michael Kerrisk
18294 Note that POSIX.1-2008 recommends POSIX timers API instead of this API
18295
18296 gettimeofday.2
18297 Michael Kerrisk
18298 Note that POSIX.1-2008 recommends clock_gettime() instead of this API
18299
18300 ptrace.2
18301 Michael Kerrisk
18302 Note use of 'data' for PTRACE_SYS{CALL,EMU} and PTRACE_*_SINGLESTEP
18303 These operations use the 'data' argument as a signal number,
18304 like PTRACE_CONT.
18305
18306 ptrace.2
18307 Mike Frysinger
18308 only reference <sys/user.h>
18309 The kernel no longer installs linux/user.h, so update
18310 references to sys/user.h.
18311
18312 recv.2
18313 Michael Kerrisk
18314 Add 'iovec' defn to defn of 'msghdr' structure
18315 The 'msghdr' structure includes a field of type 'iovec',
18316 so show the definition of that structure in this page.
18317
18318 rename.2
18319 Michael Kerrisk
18320 Make ENOENT description consistent with POSIX.1-2008
18321
18322 timerfd_create.2
18323 Michael Kerrisk
18324 ERRORS: add EINVAL for invalid 'flags' for timer_settime()
18325
18326 truncate.2
18327 Michael Kerrisk
18328 SYNOPSIS: Fix description of feature test macro requirements
18329 After a report by Arvid Norlander.
18330
18331 bcopy.3
18332 Michael Kerrisk
18333 Note that POSIX.1-2008 removes specification of bcopy()
18334
18335 bsd_signal.3
18336 Michael Kerrisk
18337 Note that POSIX.1-2008 recommends sigaction(2) instead of this API
18338
18339 ctime.3
18340 Michael Kerrisk
18341 Note that POSIX.1-2008 recommends strftime(3) instead of these functions
18342
18343 ecvt.3
18344 Michael Kerrisk
18345 Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
18346
18347 gcvt.3
18348 Michael Kerrisk
18349 Note that POSIX.1-2008 recommends sprintf(3) instead of this function
18350
18351 getcwd.3
18352 Michael Kerrisk
18353 Note that getcwd() should be used instead of the obsolete getwd()
18354
18355 getgrent.3
18356 Michael Kerrisk
18357 Returned buffer may be statically allocated and overwritten by
18358 later calls
18359
18360 gethostbyname.3
18361 Michael Kerrisk
18362 POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
18363
18364 getnetent_r.3
18365 Michael Kerrisk
18366 Fix function name in text: s/getnetbynumber_r/getnetbyaddr_r/
18367 The SYNOPSIS showed the right function name (getnetbyaddr_r),
18368 but the text repeatedly used the wrong name (getnetbynumber_r).
18369 Probably, this was a cut-and-paste error.
18370
18371 getpwent.3
18372 Michael Kerrisk
18373 Returned buffer may be statically allocated and overwritten by
18374 later calls
18375
18376 index.3
18377 Michael Kerrisk
18378 Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
18379
18380 isalpha.3
18381 Michael Kerrisk
18382 Explain why POSIX.1-2008 marks isascii(3) obsolete
18383
18384 lockf.3
18385 Nikanth Karthikesan
18386 Update pointer to documentation in kernel source
18387
18388 makecontext.3
18389 Michael Kerrisk
18390 Note that POSIX.1-2008 recommends the use of POSIX threads instead
18391
18392 mq_notify.3
18393 Michael Kerrisk
18394 Document the POSIX.1-2008 optional EINVAL error
18395 POSIX.1-2008 allows an optional EINVAL error if
18396 notification==NULL and the caller is not currently
18397 registered to receive notifications.
18398
18399 posix_fallocate.3
18400 Michael Kerrisk
18401 Clarify that EINVAL also occurs of 'len' *equals* zero
18402 See http://bugzilla.kernel.org/show_bug.cgi?id=12919
18403
18404 posix_fallocate.3
18405 Michael Kerrisk
18406 Document POSIX.1-2001 and POSIX.1-2008 specifications for EINVAL error
18407 See http://bugzilla.kernel.org/show_bug.cgi?id=12919
18408
18409 posix_memalign.3
18410 Michael Kerrisk
18411 Document handling of size==0 case for posix_memalign()
18412
18413 pthread_exit.3
18414 Michael Kerrisk
18415 Fix error in DESCRIPTION: s/pthread_create/pthread_exit/
18416
18417 realpath.3
18418 Michael Kerrisk
18419 Rework resolved_path==NULL discussion w.r.t. POSIX.1-200[18]
18420 Although the page already mentioned the resolved_path==NULL
18421 feature, and that this feature was added in POSIX.1-2008, there
18422 was still some crufty text in BUGS that hadn't been updated to
18423 reflect the POSIX.1-2008 changes.
18424
18425 Also, some other minor wording and grammar fixes.
18426
18427 scalb.3
18428 Michael Kerrisk
18429 Note that POSIX.1-2008 recommends scalbln*(3) instead
18430
18431 seekdir.3
18432 Michael Kerrisk
18433 SYNOPSIS: Fix type of 'offset' argument: s/off_t/long/
18434 And add a NOTES section pointing out that 'off_t'
18435 was indeed used in glibc 2.1.1 and earlier.
18436 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
18437
18438 sem_post.3
18439 Michael Kerrisk
18440 Document EOVERFLOW error
18441
18442 shm_open.3
18443 Michael Kerrisk
18444 Recast discussion on name length to exclude terminating NULL byte
18445 Probably it's clearer to describe the length of the IPC object
18446 name as a count that excludes the null terminator.
18447
18448 siginterrupt.3
18449 Michael Kerrisk
18450 Note that POSIX.1-2008 recommends sigaction() instead
18451
18452 sigset.3
18453 Michael Kerrisk
18454 Note APIs that POSIX.1-2008 recommends instead of these obsolete APIs
18455
18456 strftime.3
18457 Michael Kerrisk
18458 Small fix to description of %G
18459 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
18460
18461 strftime.3
18462 Michael Kerrisk
18463 Add details on ISO 8601 week-based dates
18464 ISO 8602 week-based dates are relevant for %G, %g, and %V,
18465 and the existing details on these dates are a little thin.
18466
18467 strftime.3
18468 Michael Kerrisk
18469 Remove mention of year from ISO 8601 standard
18470 The text mentioned the 1988 8601 standard, but there have
18471 already been two revisions of the standard since then, so
18472 simply remove mention of the year.
18473
18474 telldir.3
18475 Michael Kerrisk
18476 SYNOPSIS: Fix return type: s/off_t/long/
18477 And add a NOTES section pointing out that 'off_t'
18478 was indeed used in glibc 2.1.1 and earlier.
18479 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=519230
18480
18481 timeradd.3
18482 Michael Kerrisk
18483 Note that on some systems, <=, >=, == don't work for timercmp()
18484
18485 timeradd.3
18486 Michael Kerrisk
18487 SYNOPSIS: Fix return types of timerisset() and timercmp()
18488
18489 toascii.3
18490 Michael Kerrisk
18491 Note why POSIX.1-2008 marks this function obsolete
18492
18493 console_ioctl.4
18494 Alan Curry
18495 Fix 'argp' type for KDGETLED description
18496 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517485
18497
18498 group.5
18499 Michael Kerrisk
18500 Various minor rewordings and improvements
18501
18502 resolv.conf.5
18503 Michael Kerrisk
18504 Document 'ip6-bytestring' option
18505
18506 resolv.conf.5
18507 Michael Kerrisk
18508 Document 'edns0' option
18509
18510 resolv.conf.5
18511 Michael Kerrisk
18512 Document 'ip6-dotint' / 'no-ip6-dotint' option
18513
18514 resolv.conf.5
18515 Michael Kerrisk
18516 Note that maximum value of 'ndots' option is capped to 15
18517
18518 resolv.conf.5
18519 Michael Kerrisk
18520 Note that maximum value of 'timeout' option is capped to 30
18521
18522 hier.7
18523 Michael Kerrisk
18524 Add description of /srv
18525 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=520904
18526
18527 ip.7
18528 Michael Kerrisk
18529 Fix type used to declare sin6_port
18530 The page should use the type specified by POSIX,
18531 rather than the (equivalent) type used in the kernel
18532
18533 ipv6.7
18534 Teddy Hogeborn
18535 Fix types used to declare sin6_family and sin6_port
18536 The page should use the types specified by POSIX,
18537 rather than the (equivalent) types used in the kernel.
18538
18539 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=517074
18540
18541 mq_overview.7
18542 Michael Kerrisk
18543 Recast discussion on name length to exclude terminating NULL byte
18544 Probably it's clearer to describe the length of the IPC object
18545 name as a count that excludes the null terminator.
18546
18547 rtld-audit.7
18548 Michael Kerrisk
18549 Note that multiple libraries in LD_AUDIT doesn't work
18550 This is reportedly fixed in glibc 2.10.
18551 See http://sourceware.org/bugzilla/show_bug.cgi?id=9733
18552
18553 sem_overview.7
18554 Michael Kerrisk
18555 Fix discussion of length of semaphore names
18556 Because of the "sem." prefix added by glibc to a semaphore
18557 name, the limit on the length of the name (excluding the
18558 terminating null byte) is 251 characters.
18559
18560
18561 ==================== Changes in man-pages-3.21 ====================
18562
18563 Released: 2009-04-15, Los Gatos
18564
18565
18566 Contributors
18567 ------------
18568
18569 The following people contributed notes, ideas, or patches that have
18570 been incorporated in changes in this release:
18571
18572 Frank Dana <ferdnyc@gmail.com>
18573 Michael Kerrisk <mtk.manpages@gmail.com>
18574 Roman Byshko <rbyshko@gmail.com>
18575
18576 Apologies if I missed anyone!
18577
18578
18579 New and rewritten pages
18580 -----------------------
18581
18582 pthread_setconcurrency.3
18583 Michael Kerrisk
18584 New page documenting pthread_setconcurrency(3) and
18585 pthread_getconcurrency(3)
18586
18587 pthread_yield.3
18588 Michael Kerrisk
18589 New page documenting pthread_yield(3)
18590
18591
18592 New and changed links
18593 ---------------------
18594
18595 pthread_getconcurrency.3
18596 Michael Kerrisk
18597 New link to new pthread_setconcurrency(3)
18598
18599 Changes to individual pages
18600 ---------------------------
18601
18602 initrd.4
18603 Michael Kerrisk
18604 Various minor wording improvements
18605
18606 initrd.4
18607 Frank Dana
18608 Add missing word in description
18609
18610 feature_test_macros.7
18611 Michael Kerrisk
18612 Update for glibc 2.10 changes to <features.h>
18613 From glibc 2.10, <features.h> understands the values 200809
18614 for _POSIX_C_SOURCE and 700 for _XOPEN_SOURCE, and makes
18615 corresponding changes to defaults for other feature test macros.
18616 Michael Kerrisk
18617 Add an example program
18618 This example program makes it possible to explore what
18619 feature test macros are set depending on the glibc version
18620 and the macros that are explicitly set.
18621
18622 ldconfig.8
18623 Michael Kerrisk
18624 /etc/ld.so.conf also include libraries found in /lib and /usr/lib
18625
18626
18627 ==================== Changes in man-pages-3.22 ====================
18628
18629 Released: 2009-07-25, Munich
18630
18631
18632 Contributors
18633 ------------
18634
18635 The following people contributed notes, ideas, or patches that have
18636 been incorporated in changes in this release:
18637
18638 Adrian Dewhurst <sailor@sailorfrag.net>
18639 Alexander Lamaison <awl03@doc.ic.ac.uk>
18640 Bryan Østergaard <kloeri@exherbo.org>
18641 Christopher Head <chead@telus.net>
18642 Doug Goldstein <cardoe@gentoo.org>
18643 Florentin Duneau <fduneau@gmail.com>
18644 Gokdeniz Karadag <gokdenizk@gmail.com>
18645 Jeff Moyer <jmoyer@redhat.com>
18646 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
18647 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
18648 Mark Hills <mark@pogo.org.uk>
18649 Michael Kerrisk <mtk.manpages@gmail.com>
18650 Mike Frysinger <vapier@gentoo.org>
18651 Petr Baudis <pasky@suse.cz>
18652 Reimar Döffinger <Reimar.Doeffinger@gmx.de>
18653 Ricardo Garcia <rg3.zeluan@gmail.com>
18654 Rui Rlex <rui.rlex@gmail.com>
18655 Shachar Shemesh <shachar@debian.org>
18656 Tolga Dalman <tdalman@project-psi.org>
18657 ku roi <kuroibox@yahoo.de>
18658 sobtwmxt <sobtwmxt@sdf.lonestar.org>
18659
18660 Apologies if I missed anyone!
18661
18662
18663 Changes to individual pages
18664 ---------------------------
18665
18666 clone.2
18667 Michael Kerrisk
18668 Rewrite crufty text about number of args in older version of clone()
18669 Some bit rot had crept in regarding the discussion of the
18670 number of arguments in older versions of this syscall.
18671 Simplify the text to just say that Linux 2.4 and earlier
18672 didn't have ptid, tls, and ctid arguments.
18673
18674 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868
18675 Michael Kerrisk
18676 Fix version number for CLONE_NEWIPC
18677 It's 2.6.19, not 2.4.19.
18678 Michael Kerrisk
18679 Fix errors in argument names in text (ptid, ctd)
18680
18681 execve.2
18682 Mike Frysinger
18683 Remove erroneous statement that pending signal set is cleared
18684 on execve(2).
18685
18686 fcntl.2
18687 Michael Kerrisk
18688 The kernel source file mandatory.txt is now mandatory-locking.txt
18689 Michael Kerrisk
18690 The Documentation/* files are now in Documentation/filesystems
18691
18692 flock.2
18693 Michael Kerrisk
18694 Remove unneeded reference to Documentation/mandatory.txt
18695 Mandatory locks are only implemented by fcntl() locking
18696 Michael Kerrisk
18697 The Documentation/* files are now in Documentation/filesystems
18698
18699 fork.2
18700 Jeff Moyer
18701 Document fork() behaviour for the Linux native AIO io_context
18702 It was noted on lkml that the fork behaviour is documented
18703 for the POSIX AIO calls, but not for the Linux native calls.
18704 Here is a patch which adds a small blurb that folks will
18705 hopefully find useful.
18706
18707 Upon fork(), the child process does not inherit the
18708 io_context_t data structures returned by io_setup,
18709 and thus cannot submit further asynchronous I/O or
18710 reap event completions for said contexts.
18711
18712 getdents.2
18713 Michael Kerrisk
18714 The d_type field is fully supported on Btrfs
18715
18716 mount.2
18717 Michael Kerrisk
18718 Document MS_STRICTATIME, update description of MS_RELATIME
18719 Starting with Linux 2.6.30, the MS_RELATIME behavior became
18720 the default, and MS_STRICTATIME is required to obtain the
18721 traditional semantics.
18722
18723 poll.2
18724 Michael Kerrisk
18725 Remove EBADF error from ERRORS
18726 As reported by Motohiro:
18727
18728 "man poll" describe this error code.
18729
18730 >ERRORS
18731 > EBADF An invalid file descriptor was given in one of the sets.
18732
18733 but current kernel implementation ignore invalid file descriptor,
18734 not return EBADF.
18735 ...
18736
18737 In the other hand, SUSv3 talk about
18738
18739 > POLLNVAL
18740 > The specified fd value is invalid. This flag is only valid in the
18741 > revents member; it shall ignored in the events member.
18742
18743 and
18744
18745 > If the value of fd is less than 0, events shall be ignored, and
18746 > ireevents shall be set to 0 in that entry on return from poll().
18747
18748 but, no desribe EBADF.
18749 (see http://www.opengroup.org/onlinepubs/009695399/functions/poll.html)
18750
18751 So, I think the implementation is correct.
18752
18753 Why don't we remove EBADF description?
18754
18755 sigaction.2
18756 Michael Kerrisk
18757 Expand description of si_utime and si_stime fields of siginfo_t
18758
18759 stat.2
18760 Michael Kerrisk
18761 Improve wording of ENOTDIR error
18762
18763 syscalls.2
18764 Michael Kerrisk
18765 Add preadv() and pwritev(), new in kernel 2.6.30
18766
18767 wait.2
18768 Gokdeniz Karadag
18769 Document CLD_DUMPED and CLD_TRAPPED si_code values
18770
18771 daemon.3
18772 Michael Kerrisk
18773 Clarify discussion of 'noclose' and 'nochdir' arguments
18774
18775 ffs.3
18776 Petr Baudis
18777 SEE ALSO: add memchr(3)
18778
18779 fmemopen.3
18780 Petr Baudis
18781 Relocate BUGS section to correct position
18782 Petr Baudis
18783 NOTES: there is no file descriptor associated with the returned stream
18784 Alexander Lamaison pointed out that this is not obvious
18785 from the documentation, citing an example with passing the
18786 FILE * handle to a function that tries to fstat() its
18787 fileno() in order to determine the buffer size.
18788 Michael Kerrisk
18789 CONFORMING TO: remove note that these functions are GNU extensions
18790 That sentence is now redundant, since these functions
18791 are added in POSIX.1-2008.
18792
18793 lockf.3
18794 Michael Kerrisk
18795 Clarify relationship between fcntl() and lockf() locking
18796
18797 memchr.3
18798 Petr Baudis
18799 SEE ALSO: add ffs(3)
18800
18801 readdir.3
18802 Michael Kerrisk
18803 The d_type field is fully supported on Btrfs
18804
18805 setjmp.3
18806 Mike Frysinger
18807 Fix typo and clarify RETURN description
18808 The word "signal" was duplicated in NOTES, and the RETURN
18809 section refers to setjmp() and sigsetjmp(), and mentions
18810 longjmp(), but not siglongjmp().
18811
18812 strcmp.3
18813 Petr Baudis
18814 SEE ALSO: add strverscmp(3)
18815
18816 strcpy.3
18817 Mark Hills
18818 SEE ALSO: Add strdup(3)
18819
18820 complex.7
18821 Michael Kerrisk
18822 Add missing header file for example program
18823 Reimar Döffinger
18824 Fix type used in example code
18825 man complex (from release 3.18) contains the following code:
18826 complex z = cexp(I * pi);
18827 Reading the C99 standard, "complex" is not a valid type,
18828 and several compilers (Intel ICC, ARM RVCT) will refuse to compile.
18829 It should be
18830 double complex z = cexp(I * pi); instead.
18831
18832 environ.7
18833 Michael Kerrisk
18834 Note that last element in environ array is NULL
18835 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528628
18836 Michael Kerrisk
18837 Wording fixes
18838
18839 mq_overview.7
18840 Michael Kerrisk
18841 Note that mkdir and mount commands here need superuser privilege
18842 Michael Kerrisk
18843 Fix example showing contents of /dev/mqueue file
18844
18845 standards.7
18846 Michael Kerrisk
18847 Remove references to dated books
18848 Gallmeister and Lewine are rather old books. Probably,
18849 there are better books to consult nowadays, and anyway,
18850 this man page isn't intended to be a bibliography.
18851
18852
18853 ==================== Changes in man-pages-3.23 ====================
18854
18855 Released: 2009-09-30, Munich
18856
18857
18858 Contributors
18859 ------------
18860
18861 The following people contributed notes, ideas, or patches that have
18862 been incorporated in changes in this release:
18863
18864 Aaron Gardner <aaron.j.gardner@gmail.com>
18865 Andrey Vihrov <vihrov@gmail.com>
18866 Christoph Hellwig <hch@lst.de>
18867 Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
18868 Leslie P. Polzer <sky@viridian-project.de>
18869 Marc Lehmann <debian-reportbug@plan9.de>
18870 Mark Hills <mark@pogo.org.uk>
18871 Michael Kerrisk <mtk.manpages@gmail.com>
18872 Mike Frysinger <vapier@gentoo.org>
18873 Nicolas François <nicolas.francois@centraliens.net>
18874 Serge Hallyn <serue@us.ibm.com>
18875 Siward de Groot <siward@ziggo.nl>
18876 rui rlex <rui.rlex@gmail.com>
18877
18878 Apologies if I missed anyone!
18879
18880
18881 Changes to individual pages
18882 ---------------------------
18883
18884 execve.2
18885 pipe.2
18886 tee.2
18887 fmemopen.3
18888 mq_notify.3
18889 qsort.3
18890 Michael Kerrisk
18891 Replace use of assert() by code that checks argc
18892 See http://bugzilla.kernel.org/show_bug.cgi?id=13569
18893
18894 As noted by Andrey:
18895 The purpose of the assert macro, defined in <assert.h>,
18896 is to provide a tool to check for programming mistakes
18897 or program logic errors. However, the assert macro must
18898 never be used to perform checks for run time errors,
18899 since, with the NDEBUG macro defined, expressions within
18900 the assert macro invocations are not evaluated/checked
18901 for, resulting in behavior that was not originally intended.
18902 ...
18903 The pages affected in the core package are
18904
18905 execve(2)
18906 pipe(2)
18907 tee(2)
18908 fmemopen(3)
18909 mq_notify(3)
18910 qsort(3)
18911
18912 getrusage.2
18913 Michael Kerrisk
18914 ru_inblock and ru_oublock are now implemented
18915 These fields of the rusage structure are filled in since
18916 Linux 2.6.22.
18917
18918 mmap.2
18919 Michael Kerrisk
18920 Add brief documentation of MAP_HUGETLB
18921 This flag is new in 2.6.32, and serves a similar
18922 purpose to the shmget() SHM_HUGETLB flag.
18923
18924 open.2
18925 Christoph Hellwig
18926 add some comments on O_SYNC and friends
18927
18928 poll.2
18929 Michael Kerrisk
18930 Clarify wording describing of 'nfds' argument.
18931 reported by: rui rlex <rui.rlex@gmail.com>
18932
18933 semctl.2
18934 Nicolas François
18935 Remove some redundant words
18936
18937 setpgid.2
18938 Michael Kerrisk
18939 Add an explanation of orphaned process groups
18940
18941 splice.2
18942 tee.2
18943 vmsplice.2
18944 Mark Hills
18945 Fix return type
18946 Since glibc 2.7, the return type for these functions
18947 is ssize_t (formerly it was long).
18948
18949 stat.2
18950 Nicolas François
18951 Fix small bug in example program
18952 Since it is a failure, EXIT_FAILURE looks more appropriate
18953 than EXIT_SUCCESS.
18954
18955 umount.2
18956 Michael Kerrisk
18957 glibc only exposes MNT_DETACH and MNT_EXPIRE since version 2.11
18958 See http://sourceware.org/bugzilla/show_bug.cgi?id=10092
18959
18960 exit.3
18961 Michael Kerrisk
18962 Add a pointer to explanation of orphaned process groups in setpgid(2)
18963
18964 fflush.3
18965 Michael Kerrisk
18966 fflush() discards buffered input
18967
18968 ffs.3
18969 Michael Kerrisk
18970 Clarify that ffsl() and ffsll() are GNU extensions
18971
18972 getaddrinfo.3
18973 Michael Kerrisk
18974 Note nonstandard assumed hints.ai_flags value when hints is NULL
18975 When hints is NULL, glibc assumes hints.ai_flags is
18976 AI_V4MAPPED|AI_ADDRCONFIG whereas POSIX says 0.
18977 According to Ulrich Drepper, glibc's behavior is better.
18978
18979 getmntent.3
18980 Mike Frysinger
18981 setmntent() argument is 'filename' not 'fp'
18982 The description of setmntent() formerly used the wrong
18983 argument name.
18984
18985 posix_fallocate.3
18986 Nicolas François
18987 Fix reference to POSIX.1-2008
18988 The sentence mentions twice POSIX.1-2001.
18989 I guess the second one should be POSIX.1-2008.
18990 This should be checked in the standard.
18991
18992 setenv.3
18993 Michael Kerrisk
18994 Improve ERRORS section
18995 Add ENOMEM error; improve EINVAL description. Also, make
18996 RETURN VALUE section a little more accurate in its mention
18997 of errno.
18998
18999 strftime.3
19000 Nicolas François
19001 Fix error in description: s/Monday/Thursday/
19002
19003 proc.5
19004 Nicolas François
19005 Fix page cross reference
19006 max_user_watches is better explained in epoll(7) than inotify(7).
19007
19008 proc.5
19009 Michael Kerrisk
19010 dmesg is in section 1, not section 8
19011
19012 capabilities.7
19013 Michael Kerrisk
19014 FS UID manipulations affect CAP_LINUX_IMMUTABLE and CAP_MKNOD
19015 Nowadays, file system UID manipulations also affect
19016 CAP_LINUX_IMMUTABLE (since 2.6.3) and CAP_MKNOD (since 2.6.29).
19017
19018 capabilities.7
19019 Michael Kerrisk
19020 Fix version number for CAP_MKNOD in FS UID manipulations
19021 A recent patch said "since 2.6.29". It should have
19022 been "since 2.6.30".
19023
19024 capabilities.7
19025 Nicolas François
19026 Reword a bad sentence in description of capability bounding set.
19027
19028 mq_overview.7
19029 Michael Kerrisk
19030 Change documented ranges for msg_max and msgsize_max
19031 Linux 2.6.28 changed the permissible ranges for
19032 these /proc files.
19033
19034 tcp.7
19035 udp.7
19036 Nicolas François
19037 Replace references to syctl interfaces with /proc
19038
19039
19040 ==================== Changes in man-pages-3.24 ====================
19041
19042 Released: 2010-02-25, Munich
19043
19044
19045 Contributors
19046 ------------
19047
19048 The following people contributed notes, ideas, or patches that have
19049 been incorporated in changes in this release:
19050
19051 Andi Kleen <andi@firstfloor.org>
19052 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
19053 Ansgar Burchardt <ansgar@2008.43-1.org>
19054 Bela Lubkin <filbo@armory.com>
19055 Bill O. Gallmeister <bog.kernel@gmail.com>
19056 Christoph Hellwig <hch@lst.de>
19057 Colin Watson <cjwatson@debian.org>
19058 Dan Jacobson <jidanni@jidanni.org>
19059 David Howells <dhowells@redhat.com>
19060 Denis Barbier <bouzim@gmail.com>
19061 Doug Manley <doug.manley@gmail.com>
19062 Edward Welbourne <eddy@opera.com>
19063 Fang Wenqi <anton.fang@gmail.com>
19064 Frédéric Brière <fbriere@fbriere.net>
19065 Garrett Cooper <yaneurabeya@yahoo.com>
19066 Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
19067 Jann Poppinga <jann.poppinga@gmx.de>
19068 Jason Goldfine-Middleton <jasonwoodfine@gmail.com>
19069 Jason Noakes <jjnoakes@gmail.com>
19070 Jonathan Nieder <jrnieder@gmail.com>
19071 Kevin <tsubasa.xw@gmail.com>
19072 Mark Hills <mark@pogo.org.uk>
19073 Markus Peuhkuri <puhuri@iki.fi>
19074 Michael Kerrisk <mtk.manpages@gmail.com>
19075 Michael Witten <mfwitten@gmail.com>
19076 Mike Frysinger <vapier@gentoo.org>
19077 Sam Liao <phyomh@gmail.com>
19078 Samy Al Bahra <sbahra@repnop.org>
19079 Stuart Kemp <skemp@alertlogic.com>
19080 sunjiangangok <sunjiangangok@gmail.com>
19081 Tobias Stoeckmann <tobias@bugol.de>
19082 Vlastimil Babka <caster@gentoo.org>
19083 Yuri Kozlov <yuray@komyakino.ru>
19084
19085 Apologies if I missed anyone!
19086
19087
19088 New and rewritten pages
19089 -----------------------
19090
19091 add_key.2
19092 David Howells
19093 New page documenting add_key(2)
19094 Taken from keyutils-1.1 package.
19095
19096 keyctl.2
19097 David Howells
19098 New page documenting keyctl(2)
19099 Taken from keyutils-1.1 package.
19100
19101 request_key.2
19102 David Howells
19103 New page documenting request_key(2)
19104 Taken from keyutils-1.1 package.
19105
19106
19107 Global changes
19108 --------------
19109
19110 Various pages
19111 Michael Kerrisk
19112 Global fix: s/non-root/unprivileged/
19113
19114 Various pages
19115 Michael Kerrisk
19116 Global fix: s/non-privileged/unprivileged/
19117
19118 Various pages
19119 Michael Kerrisk
19120 Global fix: /non-superuser/unprivileged user/
19121
19122 Various pages
19123 Michael Kerrisk
19124 s/non-/non/
19125 The tendency in English, as prescribed in style guides like
19126 Chicago MoS, is toward removing hyphens after prefixes
19127 like "non-" etc.
19128
19129 Various pages
19130 Michael Kerrisk
19131 Global fix: s/re-/re/
19132 The tendency in English, as prescribed in style guides like
19133 Chicago MoS, is toward removing hyphens after prefixes
19134 like "re-" etc.
19135
19136 Various pages
19137 Michael Kerrisk
19138 Global fix: s/multi-/multi/
19139 The tendency in English, as prescribed in style guides like
19140 Chicago MoS, is toward removing hyphens after prefixes
19141 like "multi-" etc.
19142
19143 Various pages
19144 Michael Kerrisk
19145 Global fix: s/pre-/pre/
19146 The tendency in English, as prescribed in style guides like
19147 Chicago MoS, is toward removing hyphens after prefixes
19148 like "pre-" etc.
19149
19150 Various pages
19151 Michael Kerrisk
19152 Global fix: s/sub-/sub/
19153 The tendency in English, as prescribed in style guides like
19154 Chicago MoS, is toward removing hyphens after prefixes
19155 like "sub-" etc.
19156
19157 stime.2
19158 time.2
19159 utimensat.2
19160 ctime.3
19161 difftime.3
19162 ftime.3
19163 getspnam.3
19164 mq_receive.3
19165 mq_send.3
19166 rtime.3
19167 sem_wait.3
19168 strftime.3
19169 strptime.3
19170 timeradd.3
19171 rtc.4
19172 core.5
19173 proc.5
19174 icmp.7
19175 time.7
19176 Michael Witten
19177 Global fix: Consistently define the Epoch
19178 All definitions of the Epoch have been refactored to the following:
19179
19180 1970-01-01 00:00:00 +0000 (UTC)
19181
19182 That form is more consistent, logical, precise, and internationally
19183 recognizable than the other variants.
19184
19185 Also, some wording has been altered as well.
19186
19187 spu_create.2
19188 getopt.3
19189 passwd.5
19190 Michael Kerrisk
19191 Global fix: s/non-existing/nonexistent/
19192
19193 faccessat.2
19194 fchmodat.2
19195 fchownat.2
19196 fstatat.2
19197 futimesat.2
19198 linkat.2
19199 mkdirat.2
19200 mknodat.2
19201 openat.2
19202 readlinkat.2
19203 renameat.2
19204 symlinkat.2
19205 unlinkat.2
19206 utimensat.2
19207 mkfifoat.3
19208 Michael Kerrisk
19209 Update feature test macro requirements
19210 Starting in glibc 2.10, defining _XOPEN_SOURCE >= 700,
19211 or _POSIX_C_SOURCE >= 200809 exposes the declarations of
19212 these functions.
19213
19214
19215 Changes to individual pages
19216 ---------------------------
19217
19218 clock_getres.2
19219 Michael Kerrisk
19220 Update text on nonsetabble CLOCK_*_CPUTIME_ID clocks
19221 SUSv3 permits, but does not require CLOCK_THREAD_CPUTIME_ID and
19222 CLOCK_PROCESS_CPUTIME_ID to be settable.
19223 See http://bugzilla.kernel.org/show_bug.cgi?id=11972.
19224
19225 execve.2
19226 Colin Watson
19227 Fix description of treatment of caught signals
19228 Caught signals reset to their default on an execve() (not
19229 to being ignored).
19230
19231 fcntl.2
19232 Michael Kerrisk
19233 s/F_OWNER_GID/F_OWNER_PGRP/
19234 Peter Zijlstra took the name change I suggested.
19235 Michael Kerrisk
19236 Document F_[SG]ETOWN_EX; update details on F_SETOWN
19237 Linux 2.6.32 adds F_SETOWN_EX and F_GETOWN_EX.
19238 Linux 2.6.12 changed (broke) the former behavior of
19239 F_SETOWN with respect to threads.
19240
19241 intro.2
19242 intro.3
19243 Michael Kerrisk
19244 Make subsection heading consistent with other intro.? pages
19245 These pages used "Copyright Terms"; the other intro.? pages
19246 used "Copyright Conditions". Make these pages like the others.
19247
19248 sendfile.2
19249 Michael Kerrisk
19250 Clarify behavior when 'offset' is NULL
19251
19252 seteuid.2
19253 Michael Kerrisk
19254 Note unstandardized behavior for effective ID
19255 POSIX.1 doesn't require that the effective ID can be changed
19256 to the same value it currently has (a no-op). The man page
19257 should note this, since some other implementations
19258 don't permit it.
19259
19260 setgid.2
19261 Michael Kerrisk
19262 Fix EPERM error description
19263 s/effective group ID/real group ID/
19264 This bug lived in man pages for 15 years before Jason
19265 spotted it! I checked back in Linux 1.0, and the behavior
19266 was as the fixed man page describes.
19267
19268 setreuid.2
19269 Michael Kerrisk
19270 Add more detail on POSIX.1 specification for these syscalls
19271
19272 setuid.2
19273 Michael Kerrisk
19274 Remove crufty statement that seteuid() is not in POSIX
19275 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=569812
19276
19277 stime.2
19278 strftime.3
19279 tzset.3
19280 zic.8
19281 Michael Witten
19282 GMT -> UTC (where appropriate)
19283
19284 sync_file_range.2
19285 Christoph Hellwig
19286 Add some big warnings re data integrity
19287 This system call is by design completely unsuitable for any data
19288 integrity operations. Make that very clear in the manpage.
19289
19290 CPU_SET.3
19291 Vlastimil Babka
19292 SYNOPSIS: Fix return types for CPU_COUNT_*()
19293 These functions return 'int' not void'.
19294
19295 confstr.3
19296 Michael Kerrisk
19297 Fix feature test macro requirements
19298
19299 daemon.3
19300 Michael Kerrisk
19301 Fix description of 'nochdir' argument.
19302 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
19303
19304 gethostbyname.3
19305 Michael Kerrisk
19306 Document feature test macro requirements for herror() and hstrerror()
19307 Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE,
19308 or _GNU_SOURCE is required.
19309
19310 getline.3
19311 Michael Kerrisk
19312 Update to reflect that these functions were standardized in POSIX.1-2008
19313
19314 getnameinfo.3
19315 Michael Kerrisk
19316 Document feature test macros requirements for NI_MAXHOST and NI_MAXSERV
19317 Since glibc 2.8, one of _BSD_SOURCE, _SVID_SOURCE, or _GNU_SOURCE
19318 must be defined to obtain these definitions.
19319
19320 getopt.3
19321 Jonathan Nieder
19322 Fix feature test macro requirements
19323
19324 memchr.3
19325 Michael Kerrisk
19326 Add feature text macro requirements for memrchr()
19327
19328 nextafter.3
19329 Michael Kerrisk
19330 Fix notable error in DESCRIPTION.
19331 "less than y" should be "less than x".
19332
19333 popen.3
19334 Michael Kerrisk
19335 Fix feature test macro requirements
19336
19337 pthread_attr_setdetachstate.3
19338 pthread_attr_setschedparam.3
19339 pthread_attr_setschedpolicy.3
19340 Denis Barbier
19341 Argument name is 'attr' not 'thread'
19342 The function argument was misnamed in the DESCRIPTION on these
19343 three pages.
19344
19345 rtnetlink.3
19346 Michael Kerrisk
19347 Various fixes in example code
19348 Edward reported a problem in the example code, where a variable
19349 seems to be misnamed. Upon inspection, there seem to be a few
19350 such instances, and this patch is my best guess at how things
19351 should look.
19352
19353 sched_getcpu.3
19354 Michael Kerrisk
19355 Place correct header file in SYNOPSIS
19356
19357 sleep.3
19358 Bill O. Gallmeister
19359 sleep() puts calling *thread* to sleep (not calling *process*)
19360
19361 sleep.3
19362 Bill O. Gallmeister
19363 Add nanosleep(2) to SEE ALSO
19364
19365 strftime.3
19366 Michael Kerrisk
19367 %z is defined in SUSv3
19368 So, substitute "GNU" tag in man page by "SU".
19369
19370 strftime.3
19371 Michael Witten
19372 Move 822-compliant date format example to EXAMPLES section
19373 The RFC 822-compliant date format given in the description
19374 of `%z' is now moved to the `EXAMPLES' section (note: `EXAMPLE'
19375 has been renamed `EXAMPLES').
19376
19377 Furthermore, that format example is now actually
19378 RFC 822-compliant (using `%y' instead of `%Y') and has been
19379 qualified as being correct only when in the context of at least
19380 an English locale. Also, `%T' is used in place of `%H:%M:%S'.
19381
19382 For completeness, an RFC 2822-compliant format example has been
19383 similarly added.
19384
19385 strftime.3
19386 Michael Witten
19387 Expand introductory text
19388
19389 strftime.3
19390 Michael Witten
19391 Clarification of %z specifier
19392
19393 string.3
19394 Mark Hills
19395 Add stpcpy() to this list of string functions
19396
19397 strptime.3
19398 Michael Kerrisk
19399 Initialize tm structure in example program
19400
19401 undocumented.3
19402 Michael Kerrisk
19403 Remove pages now documented
19404 By now, the following are documented:
19405
19406 fopencookie(3)
19407 freeifaddrs(3)
19408 rawmemchr(3)
19409 readdir_r(3)
19410 getutmp(3)
19411 getutmpx(3)
19412 utmpxname(3)
19413
19414 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
19415
19416 group.5
19417 Michael Kerrisk
19418 s/passwd/password/
19419 The page inconsistently used "passwd" and "password"
19420 to refer to the same field.
19421
19422 capabilities.7
19423 Michael Kerrisk
19424 Update securebits discussion to use SECBIT_* flags
19425
19426 feature_test_macros.7
19427 Michael Kerrisk
19428 _POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
19429 Since glibc 2.10, _POSIX_C_SOURCE >= 200808 defines _ATFILE_SOURCE
19430
19431 path_resolution.7
19432 Michael Kerrisk
19433 Add readlink(2) to SEE ALSO
19434 Michael Kerrisk
19435 Fix NAME line
19436 The poorly constructed part preceding "\-" causes apropos
19437 not to be able to find the subject.
19438
19439 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=558300
19440
19441 signal.7
19442 Michael Kerrisk
19443 Fix discussion of SIGUNUSED
19444 Clarify that this signal really is synonymous with SIGSYS.
19445 See http://bugzilla.kernel.org/show_bug.cgi?id=14449
19446
19447
19448 ==================== Changes in man-pages-3.25 ====================
19449
19450 Released: 2010-06-20, Munich
19451
19452
19453 Contributors
19454 ------------
19455
19456 The following people contributed notes, ideas, or patches that have
19457 been incorporated in changes in this release:
19458
19459 Alexander E. Patrakov <patrakov@gmail.com>
19460 Andi Kleen <andi@firstfloor.org>
19461 Andrew Klossner <andrew@cesa.opbu.xerox.com>
19462 André Goddard Rosa <andre.goddard@gmail.com>
19463 Bo Borgerson <gigabo@gmail.com>
19464 Christian Franke <nobody@nowhere.ws>
19465 Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
19466 David Sommerseth <davids@redhat.com>
19467 Denis Barbier <bouzim@gmail.com>
19468 Eric Blake <ebb9@byu.net>
19469 Fang Wenqi <anton.fang@gmail.com>
19470 Francesco Cosoleto <cosoleto@gmail.com>
19471 Gernot Tenchio <gernot@tenchio.de>
19472 Hugh Dickins <hughd@google.com>
19473 Ivana Hutarova Varekova <varekova@redhat.com>
19474 Jan Blunck <jblunck@novell.com>
19475 Jan Engelhardt <jengelh@medozas.de>
19476 Jan Kara <jack@suse.cz>
19477 Jeff Barry <JeffBatHome@myletters.us>
19478 Manfred Schwarb <manfred99@gmx.ch>
19479 Mark Hills <mark@pogo.org.uk>
19480 Martin (Joey) Schulze <joey@infodrom.org>
19481 Michael Kerrisk <mtk.manpages@gmail.com>
19482 Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
19483 Mike Frysinger <vapier@gentoo.org>
19484 Miklos Szeredi <miklos@szeredi.hu>
19485 Petr Baudis <pasky@suse.cz>
19486 Petr Gajdos <pgajdos@suse.cz>
19487 Petr Uzel <petr.uzel@suse.cz>
19488 Pierre Habouzit <madcoder@madism.org>
19489 Reuben Thomas <rrt@sc3d.org>
19490 Rob Landley <rob@landley.net>
19491 Robert Wohlrab <robert.wohlrab@gmx.de>
19492 Serge E. Hallyn <serge@hallyn.com>
19493 Tolga Dalman <tdalman@project-psi.org>
19494 Tom Swigg <swiggtc@lsbu.ac.uk>
19495 Walter Harms <wharms@bfs.de>
19496 Yuri Kozlov <yuray@komyakino.ru>
19497
19498 Apologies if I missed anyone!
19499
19500
19501 New and rewritten pages
19502 -----------------------
19503
19504 migrate_pages.2
19505 Andi Kleen
19506 New page documenting migrate_pages(2).
19507 Andi's text based on the move_pages.2 page;
19508 additional edits by mtk.
19509 migrate_pages(2) was new in Linux 2.6.16.
19510
19511 quotactl.2
19512 Jan Kara
19513 Major updates
19514 Update the page to consolidate information from the
19515 outdated man-pages quotactl.2 page and the quotactl.2
19516 page in the "quota-tools" package. The page in "quota-tools"
19517 has now been dropped by Jan Kara, so that there is just one
19518 canonical quotactl.2 page (in pan-pages).
19519 Michael Kerrisk
19520 Various other pieces added to the page by mtk.
19521
19522
19523 Newly documented interfaces in existing pages
19524 ---------------------------------------------
19525
19526 fcntl.2
19527 Michael Kerrisk
19528 Document F_SETPIPE_SZ and F_GETPIPE_SZ
19529 These commands, new in kernel 2.6.35, set and get the capacity
19530 of pipes.
19531
19532 madvise.2
19533 Andi Kleen
19534 Document MADV_HWPOISON
19535 Michael Kerrisk
19536 Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
19537 These flags (used for Kernel Samepage Merging, KSM)
19538 are new in 2.6.32.
19539 Andi Kleen
19540 Document MADV_SOFT_OFFLINE
19541 This operation was added in Linux 2.6.33.
19542
19543 mmap.2
19544 Michael Kerrisk
19545 Document MAP_UNINITIALIZED flag
19546 New in Linux 2.6.33.
19547
19548 prctl.2
19549 Andi Kleen
19550 Document the hwpoison prctls in 2.6.32
19551
19552 sched_setscheduler.2
19553 Michael Kerrisk
19554 Document SCHED_RESET_ON_FORK
19555 New in Linux 2.6.32
19556
19557 umount.2
19558 Michael Kerrisk
19559 Document UMOUNT_NOFOLLOW
19560 New in Linux 2.6.34.
19561
19562 mkstemp.3
19563 Michael Kerrisk
19564 Document mkstemps() and mkostemps()
19565 These functions are new in glibc 2.11. They allow the template
19566 string to include a suffix after the "XXXXXX" string.
19567
19568 proc.5
19569 Michael Kerrisk
19570 Document /proc/sys/vm/memory_failure_early_kill
19571 New in 2.6.32. Description based on the text in
19572 Documentation/sysctl/vm.txt.
19573 Michael Kerrisk
19574 Document /proc/sys/vm/memory_failure_recovery
19575 New in Linux 2.6.32. Description based on the text in
19576 Documentation/sysctl/vm.txt.
19577 Michael Kerrisk
19578 Document /proc/sys/fs/pipe-max-size
19579
19580 socket.7
19581 Jan Engelhardt
19582 Document SO_DOMAIN and SO_PROTOCOL
19583 These read-only socket options were new in Linux 2.6.32.
19584
19585
19586 New and changed links
19587 ---------------------
19588
19589 fstatvfs.2
19590 Michael Kerrisk
19591 Adjust link to point to Section 3
19592
19593 fstatvfs.3
19594 statvfs.2
19595 Michael Kerrisk
19596 New link to page relocated to Section 3
19597
19598 mkstemps.3
19599 mkostemps.3
19600 Michael Kerrisk
19601 New links to mkstemp.3
19602 mkstemp.3 now describes mkstemps(3) and mkostemps(3).
19603
19604 timer_create.2
19605 timer_delete.2
19606 timer_getoverrun.2
19607 timer_settime.2
19608 getline.3
19609 Michael Kerrisk
19610 Add 'L' to constants in feature test macro specifications
19611 Be consistent with POSIX, which uses constants such as 200809L.
19612
19613
19614 Global changes
19615 --------------
19616
19617 open.2
19618 sync_file_range.2
19619 umount.2
19620 Michael Kerrisk
19621 Global fix: s/filesystem/file system/
19622
19623
19624 Changes to individual pages
19625 ---------------------------
19626
19627 fcntl.2
19628 Michael Kerrisk
19629 Note that glibc 2.11 papers over the kernel F_GETOWN bug
19630 Since version 2.11, glibc works around the kernel limitation for
19631 process groups IDs < 4096 by implementing F_GETOWN via F_GETOWN_EX.
19632
19633 futex.2
19634 Michael Kerrisk
19635 Various fixes in SEE ALSO
19636
19637 getpriority.2
19638 nice.2
19639 Francesco Cosoleto
19640 Move renice from section 8 to section 1
19641
19642 getrusage.2
19643 Mark Hills
19644 Add ru_maxrss
19645 See kernel commit 1f10206.
19646 Mark Hills
19647 Description of maintained fields
19648 These descriptions are taken from NetBSD 5.0's getrusage(2).
19649 Michael Kerrisk
19650 Enhanced description of various fields
19651
19652 mlock.2
19653 Michael Kerrisk
19654 /proc/PID/status VmLck shows how much memory a process has locked
19655 After a note from Tom Swigg, it seems sensible mention VmLck here.
19656
19657 mount.2
19658 Petr Uzel
19659 Fix incorrect path
19660
19661 move_pages.2
19662 Andi Kleen
19663 Clarify includes/libraries
19664
19665 mremap.2
19666 Michael Kerrisk
19667 Clarify existence of fifth argument.
19668
19669 msgctl.2
19670 semctl.2
19671 shmctl.2
19672 Francesco Cosoleto
19673 Move ipcs from section 8 to section 1
19674
19675 open.2
19676 Michael Kerrisk
19677 Remove ambiguity in text on NFS and O_EXCL.
19678
19679 poll.2
19680 Michael Kerrisk
19681 Fix discussion of ppoll() timeout argument
19682 1. Rename ppoll)(_ argument to "timeout_ts" to distinguish it
19683 from the poll() argument in the text.
19684 2. More accurately describe the poll() call that is equivalent
19685 to ppoll().
19686
19687 posix_fadvise.2
19688 Michael Kerrisk
19689 Add sync_file_range(2) under SEE ALSO
19690
19691 prctl.2
19692 Michael Kerrisk
19693 Correct PR_SET_KEEPCAPS description
19694 The "keep capabilities" flag only affects the treatment of
19695 permitted capabilities, not effective capabilities.
19696 Also: other improvements to make the PR_SET_KEEPCAPS text clearer.
19697
19698 select_tut.2
19699 Michael Kerrisk
19700 Fix bug in example program
19701
19702 sigaction.2
19703 Michael Kerrisk
19704 Add TRAP_BRANCH and TRAP_HWBKPT to si_code values for SIGTRAP
19705 Michael Kerrisk
19706 Rearrange text describing fields set by sigqueue(2)
19707 Michael Kerrisk
19708 Add details for signals sent by POSIX message queue notifications
19709 Michael Kerrisk
19710 Improve description of various siginfo_t fields
19711 Michael Kerrisk
19712 Add some details for SIGTRAP and si_trapno
19713 Andi Kleen
19714 Document hwpoison signal extensions
19715
19716 statfs.2
19717 Michael Kerrisk
19718 Bring statfs struct type declarations closer to glibc reality
19719 Fang Wenqi
19720 Add definition EXT4_SUPER_MAGIC = 0xEF53
19721 Michael Kerrisk
19722 Document f_frsize field.
19723
19724 statvfs.2
19725 Michael Kerrisk
19726 Move this page to section 3 (since it's a library call)
19727
19728 swapon.2
19729 Ivana Hutarova Varekova
19730 Note effect of CONFIG_MEMORY_FAILURE on MAX_SWAPFILES
19731 From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
19732 built with CONFIG_MEMORY_FAILURE.
19733
19734 syscalls.2
19735 Michael Kerrisk
19736 Bring system call list up to date with Linux 2.6.33
19737 Michael Kerrisk
19738 Fix kernel version number for utimes()
19739
19740 cproj.3
19741 Michael Kerrisk
19742 Note fix for C99 conformance in glibc 2.12.
19743
19744 crypt.3
19745 Petr Baudis
19746 Correct note on key portion significance
19747 As Marcel Moreaux notes:
19748
19749 The Linux manpage for crypt()[1] contains the following
19750 statement as the last sentence of the NOTES section:
19751
19752 In the SHA implementation the entire key is significant
19753 (instead of only the first 8 bytes in MD5).
19754
19755 It should probably say "DES" where it says "MD5" (and maybe
19756 "MD5/SHA" where it says "SHA"), because in MD5 password hashing,
19757 the entire key is significant, not just the first 8 bytes.
19758
19759 This patch fixes the wording.
19760
19761 fmemopen.3
19762 Michael Kerrisk
19763 Bug fix in example program
19764
19765 ftw.3
19766 Michael Kerrisk
19767 Note that if 'fn' changes CWD, the results are undefined
19768 Michael Kerrisk
19769 Clarify description of fpath argument
19770 As reported by Pierre Habouzit, 'fpath' is not relative
19771 to 'dirpath'. It is either relative to the calling process's
19772 current working directory (if 'dirpath' was relative), or it
19773 is absolute (if 'dirpath' was absolute).
19774
19775 getaddrinfo.3
19776 Christian Franke
19777 Fix a field name mixup: s/ai_family/ai_flags/
19778
19779 getline.3
19780 Robert Wohlrab
19781 Remove unneeded check before free()
19782 The manpage of getline shows an example with an extra NULL pointer
19783 check before it calls free. This is unneeded according to free(3):
19784
19785 If ptr is NULL, no operation is performed.
19786
19787 This patch removes the "if" check.
19788
19789 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572508
19790
19791 log.3
19792 log10.3
19793 log2.3
19794 Jan Engelhardt
19795 Add cross-references to other-base logarithmic functions
19796
19797 opendir.3
19798 Petr Baudis
19799 Specify feature test macro requirements for fdopendir(3)
19800 Currently, there is no note on the fact that fdopendir() is
19801 POSIX.2008-only.
19802
19803 openpty.3
19804 Eric Blake
19805 Use const as appropriate
19806 Michael Kerrisk
19807 Note glibc version that added "const" to function arguments
19808 Michael Kerrisk
19809 Explicitly note that these functions are not in POSIX
19810
19811 resolver.3
19812 Michael Kerrisk
19813 Fix declaration of dn_comp() in SYNOPSIS
19814 Remove the second 'exp_dn' from the calling signature.
19815
19816 termios.3
19817 Michael Kerrisk
19818 Change NOFLSH text to speak of characters, not signals
19819
19820 core.5
19821 Michael Kerrisk
19822 Update description of coredump_filter
19823 Kernel 2.6.24 added MMF_DUMP_ELF_HEADERS.
19824 Kernel 2.6.28 added MMF_DUMP_HUGETLB_PRIVATE and
19825 MMF_DUMP_HUGETLB_SHARED.
19826
19827 elf.5
19828 Daisuke HATAYAMA
19829 Document PN_XNUM extension
19830 In linux-2.6.34-rc1, an ELF core extension was added; user-land
19831 tools manipulating ELF core dump such as gdb and binutils has
19832 already been modified before; so elf.5 needs to be modified
19833 accordingly.
19834
19835 You can follow information on the ELF extension via the LKML post:
19836 http://lkml.org/lkml/2010/1/3/103
19837 Date Mon, 04 Jan 2010 10:06:07 +0900 (JST)
19838 Subject ... elf coredump: Add extended numbering support
19839
19840 This Linux-specific extension was added in kernel 2.6.34.
19841
19842 Reviewed-by: Petr Baudis <pasky@suse.cz>
19843
19844 Michael Kerrisk
19845 Remove EI_BRAND
19846 As reported by Yuri Kozlov and confirmed by Mike Frysinger,
19847 EI_BRAND is not in GABI
19848 (http://www.sco.com/developers/gabi/latest/ch4.eheader.html)
19849 It looks to be a BSDism
19850 Michael Kerrisk
19851 Remove words under '.note': "described below"
19852 The existing text is broken, because there is
19853 no '"Note Section" format' describe below. Simplest
19854 solution is to remove the words "described below".
19855
19856 filesystems.5
19857 Jeff Barry
19858 Add discussion of ntfs and ext4
19859
19860 proc.5
19861 Michael Kerrisk
19862 Simplify description of /proc/sys and /proc/sys/fs
19863 In the description of these directories, there's no need
19864 to list all the files and subdirectories that they contain;
19865 that information is provided by the entries that follow.
19866
19867 services.5
19868 Yuri Kozlov
19869 Remove crufty reference to nonexistent BUGS section
19870
19871 capabilities.7
19872 Michael Kerrisk
19873 Document CAP_SYS_RESOURCE and F_SETPIPE_SZ
19874 With CAP_SYS_RESOURCE, a process can increase pipe capacity above
19875 /proc/sys/ps/pipe-max-size.
19876 Michael Kerrisk
19877 Add get_robust_list() info under CAP_SYS_PTRACE
19878 Michael Kerrisk
19879 Add MADV_HWPOISON under CAP_SYS_ADMIN
19880
19881 signal.7
19882 Michael Kerrisk
19883 Make a clearer statement about nonportable aspect of signal(2)
19884 Make a clearer statement that signal(2) is less portable for
19885 establishing a signal handler.
19886
19887 socket.7
19888 Michael Kerrisk
19889 Use consistent language to describe read-only socket options
19890
19891 udp.7
19892 Michael Kerrisk
19893 Add FIONREAD warning.
19894 Warn that FIONREAD can't distinguish case of a zero-length
19895 datagram from the case where no datagrams are available.
19896
19897
19898 ==================== Changes in man-pages-3.26 ====================
19899
19900 Released: 2010-09-04, Munich
19901
19902
19903 Contributors
19904 ------------
19905
19906 The following people contributed notes, ideas, or patches that have
19907 been incorporated in changes in this release:
19908
19909 Alexander Shishkin <virtuoso@slind.org>
19910 Brian Sutin <Brian.Sutin@hs.utc.com>
19911 Denis Barbier <bouzim@gmail.com>
19912 Guillem Jover <guillem@hadrons.org>
19913 Jianhua Li <jhlicc@gmail.com>
19914 Linus Nilsson <lajnold@gmail.com>
19915 Lenaic Huard <lenaic.huard@laposte.net>
19916 Mac <mac@mcrowe.com>
19917 Martin Schulze <joey@infodrom.org>
19918 Maxin John <maxin.john@gmail.com>
19919 Michael Kerrisk <mtk.manpages@gmail.com>
19920 Nicholas Hunt <nhunt@cs.washington.edu>
19921 Peng Haitao <penght@cn.fujitsu.com>
19922 Peter Stuge <peter@stuge.se>
19923 Przemyslaw Szczepaniak <Przemyslaw.Szczepaniak@imgtec.com>
19924 Scott Walls <sawalls@umich.edu>
19925 TAN Yee Fan <tanyeefa@comp.nus.edu.sg>
19926 Wu Fengguang <fengguang.wu@intel.com>
19927 Yitzchak Gale <gale@sefer.org>
19928 Yuri Kozlov <yuray@komyakino.ru>
19929
19930 Apologies if I missed anyone!
19931
19932 Newly documented interfaces in existing pages
19933 ---------------------------------------------
19934
19935 eventfd.2
19936 Michael Kerrisk
19937 Document EFD_SEMAPHORE
19938 Document the EFD_SEMAPHORE flag, added in kernel 2.6.30.
19939 Also restructured some parts of the text to fit with the
19940 addition of the EFD_SEMAPHORE text.
19941
19942
19943 Global changes
19944 --------------
19945
19946 getaddrinfo.3
19947 getipnodebyname.3
19948 st.4
19949 Michael Kerrisk
19950 s/logical OR/bitwise OR/
19951
19952
19953 Changes to individual pages
19954 ---------------------------
19955
19956 clock_nanosleep.2
19957 Michael Kerrisk
19958 Fix discussion of return value when interrupted by a signal
19959
19960 epoll_ctl.2
19961 Yuri Kozlov
19962 Small fix to types in data structures
19963
19964 eventfd.2
19965 Alexander Shishkin
19966 Clarified close-on-exec behavior
19967
19968 madvise.2
19969 Michael Kerrisk
19970 Improve discussion of MADV_SOFT_OFFLINE
19971
19972 mkdir.2
19973 Michael Kerrisk
19974 Add EMLINK error to ERRORS
19975
19976 mq_getsetattr.2
19977 mq_close.3
19978 mq_getattr.3
19979 mq_notify.3
19980 mq_send.3
19981 mq_unlink.3
19982 Lnac Huard
19983 Fix return type in SYNOPSIS (s/mqd_t/int/)
19984
19985 recv.2
19986 send.2
19987 Michael Kerrisk
19988 Remove obsolete reference to glibc version in NOTES
19989
19990 recv.2
19991 send.2
19992 Nicholas Hunt
19993 Adjust type shown for msg_controllen to glibc reality
19994 This patch fixes the type of msg_controllen in the struct msghdr
19995 definition given in send.2 and recv.2 to match the definition in
19996 glibc and the kernel.
19997
19998 select.2
19999 Michael Kerrisk
20000 Update NOTES on old glibc pselect()
20001 Make it clear that modern glibc uses the kernel pselect()
20002 on systems where it is available.
20003 See https://bugzilla.kernel.org/show_bug.cgi?id=14411
20004
20005 statfs.2
20006 Guillem Jover
20007 Fix copy & paste error for __SWORD_TYPE definition
20008
20009 sysfs.2
20010 Michael Kerrisk
20011 Clarify that this syscall is obsolete.
20012 And strengthen recommendation to use /proc/filesystems instead.
20013
20014 write.2
20015 Michael Kerrisk
20016 Add EDESTADDRREQ error
20017
20018 a64l.3
20019 Peng Haitao
20020 Fix error in NOTES, s/a64l/l64a/
20021
20022 error.3
20023 Linus Nilsson
20024 Change "perror" to "strerror" in DESCRIPTION of error()
20025
20026 mq_send.3
20027 Michael Kerrisk
20028 Fix EAGAIN description (s/empty/full)
20029
20030 initrd.4
20031 Yuri Kozlov
20032 Fix IP address in explanation of NFS example
20033
20034 tzfile.5
20035 Michael Kerrisk
20036 Add information on version 2 format timezone files
20037 Updated using information from the tzcode 2010l release at
20038 ftp://elsie.nci.nih.gov/pub.
20039 (It's an open question whether or not a version of tzfile.5
20040 should live independently in man-pages. It was added to the
20041 man-pages set many years ago. For now, I'll follow a
20042 conservative course that causes least pain to downstream,
20043 by continuing to maintain a separate copy in man-pages.)
20044
20045 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=594219
20046
20047
20048 ==================== Changes in man-pages-3.27 ====================
20049
20050 Released: 2010-09-22, Nuernberg
20051
20052
20053 Contributors
20054 ------------
20055
20056 The following people contributed notes, ideas, or patches that have
20057 been incorporated in changes in this release:
20058
20059 caishuxian <caishuxian@gmail.com>
20060 Denis Barbier <bouzim@gmail.com>
20061 Denis Silakov <silakov@ispras.ru>
20062 der Mouse <mouse@rodents-montreal.org>
20063 Jan Kratochvil <jan.kratochvil@redhat.com>
20064 Jim Belton <jim.belton@gmail.com>
20065 Jiri Olsa <jolsa@redhat.com>
20066 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
20067 Mark Hills <mark@pogo.org.uk>
20068 Matthew Flaschen <matthew.flaschen@gatech.edu>
20069 Michael Kerrisk <mtk.manpages@gmail.com>
20070 Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
20071 Petr Baudis <pasky@suse.cz>
20072 Remi Denis-Courmont <remi@remlab.net>
20073 Tanaka Akira <akr@fsij.org>
20074 Tim Stoakes <tim@stoakes.net>
20075 W. Trevor King <wking@drexel.edu>
20076 Yuri Kozlov <yuray@komyakino.ru>
20077
20078 Apologies if I missed anyone!
20079
20080
20081 New and rewritten pages
20082 -----------------------
20083
20084 sigevent.7
20085 Petr Baudis, Michael Kerrisk
20086 New page to centralize description of sigevent structure
20087 Several interfaces use this structure. Best to centralize the
20088 common details in one place. Content taken from the existing
20089 timerfd_create.2 and mq_open.3 pages, with additions by
20090 Petr Baudis and Michael Kerrisk.
20091
20092
20093 Newly documented interfaces in existing pages
20094 ---------------------------------------------
20095
20096 ip.7
20097 Jiri Olsa
20098 Document IP_NODEFRAG
20099 This option is new in Linux 2.6.36
20100
20101 unix.7
20102 Michael Kerrisk
20103 Document SIOCINQ ioctl() operation
20104
20105
20106 Global changes
20107 --------------
20108
20109 _exit.2
20110 brk.2
20111 chdir.2
20112 chmod.2
20113 chown.2
20114 chroot.2
20115 clock_nanosleep.2
20116 getdtablesize.2
20117 gethostname.2
20118 getpagesize.2
20119 getsid.2
20120 killpg.2
20121 mknod.2
20122 mknodat.2
20123 posix_fadvise.2
20124 pread.2
20125 readlink.2
20126 setpgid.2
20127 setreuid.2
20128 sigaltstack.2
20129 stat.2
20130 symlink.2
20131 sync.2
20132 truncate.2
20133 vfork.2
20134 wait.2
20135 wait4.2
20136 a64l.3
20137 abs.3
20138 acos.3
20139 acosh.3
20140 asin.3
20141 asinh.3
20142 atan.3
20143 atan2.3
20144 atanh.3
20145 atoi.3
20146 cbrt.3
20147 ceil.3
20148 clock_getcpuclockid.3
20149 copysign.3
20150 cos.3
20151 cosh.3
20152 dirfd.3
20153 div.3
20154 dprintf.3
20155 ecvt.3
20156 erf.3
20157 erfc.3
20158 exp.3
20159 exp2.3
20160 expm1.3
20161 fabs.3
20162 fdim.3
20163 fexecve.3
20164 ffs.3
20165 floor.3
20166 fma.3
20167 fmax.3
20168 fmemopen.3
20169 fmin.3
20170 fmod.3
20171 fpclassify.3
20172 frexp.3
20173 fwide.3
20174 gamma.3
20175 gcvt.3
20176 getcwd.3
20177 getdate.3
20178 getgrent.3
20179 gethostid.3
20180 getpass.3
20181 getpwent.3
20182 getsubopt.3
20183 getw.3
20184 hypot.3
20185 ilogb.3
20186 insque.3
20187 isalpha.3
20188 isgreater.3
20189 iswblank.3
20190 j0.3
20191 j0.3
20192 ldexp.3
20193 lockf.3
20194 log.3
20195 log10.3
20196 log1p.3
20197 log2.3
20198 logb.3
20199 lrint.3
20200 lround.3
20201 mbsnrtowcs.3
20202 mkdtemp.3
20203 mkstemp.3
20204 mktemp.3
20205 modf.3
20206 mq_receive.3
20207 mq_send.3
20208 nan.3
20209 nextafter.3
20210 posix_fallocate.3
20211 posix_memalign.3
20212 pow.3
20213 printf.3
20214 qecvt.3
20215 random.3
20216 realpath.3
20217 remainder.3
20218 remquo.3
20219 rint.3
20220 rint.3
20221 round.3
20222 scalb.3
20223 scalbln.3
20224 scanf.3
20225 siginterrupt.3
20226 signbit.3
20227 sigset.3
20228 sin.3
20229 sinh.3
20230 sqrt.3
20231 stpcpy.3
20232 stpncpy.3
20233 strdup.3
20234 strdup.3
20235 strnlen.3
20236 strsignal.3
20237 strtod.3
20238 strtol.3
20239 strtoul.3
20240 tan.3
20241 tanh.3
20242 tgamma.3
20243 trunc.3
20244 ttyslot.3
20245 ualarm.3
20246 usleep.3
20247 wcpcpy.3
20248 wcpncpy.3
20249 wcscasecmp.3
20250 wcsdup.3
20251 wcsncasecmp.3
20252 wcsnlen.3
20253 wcsnrtombs.3
20254 wprintf.3
20255 Michael Kerrisk
20256 Add/fix/update feature test macro requirements in SYNOPSIS
20257 Various changes to:
20258 * Update feature test requirements to note changes in
20259 recent glibc releases
20260 * Correct errors in feature test macro requirements
20261 * Add feature test macro requirements to pages where
20262 the requirements were not previously stated.
20263
20264 accept.2
20265 clone.2
20266 dup.2
20267 fallocate.2
20268 pipe.2
20269 readahead.2
20270 sched_setaffinity.2
20271 unshare.2
20272 CPU_SET.3
20273 endian.3
20274 euidaccess.3
20275 fexecve.3
20276 getpt.3
20277 getpw.3
20278 getumask.3
20279 getutmp.3
20280 gnu_get_libc_version.3
20281 makedev.3
20282 matherr.3
20283 mbsnrtowcs.3
20284 memfrob.3
20285 pthread_attr_setaffinity_np.3
20286 pthread_getattr_np.3
20287 pthread_setaffinity_np.3
20288 pthread_tryjoin_np.3
20289 tcgetsid.3
20290 wcscasecmp.3
20291 wcsncasecmp.3
20292 wcsnlen.3
20293 wcsnrtombs.3
20294 wcswidth.3
20295 rtld-audit.7
20296 Michael Kerrisk
20297 SYNOPSIS: Add reference to feature_test_macros(7)
20298 These pages specify feature test macros in the function
20299 prototypes. Add a reference to feature_test_macros(7),
20300 so that readers are pointed to the information that
20301 feature test macros must be defined before including
20302 *any* header file.
20303
20304 clock_nanosleep.2
20305 clock_getcpuclockid.3
20306 getnetent_r.3
20307 getprotoent_r.3
20308 getrpcent_r.3
20309 getservent_r.3
20310 sigwait.3
20311 Michael Kerrisk
20312 RETURN VALUE: Note that "positive error numbers" are listed in ERRORS
20313
20314 fcntl.2
20315 intro.2
20316 open.2
20317 poll.2
20318 ftw.3
20319 intro.3
20320 matherr.3
20321 system.3
20322 tmpnam.3
20323 unix.7
20324 Michael Kerrisk
20325 Note that feature test macros must be defined before *any* includes
20326 Programmers often make the mistake of including a feature test
20327 macro only after having already included some header files.
20328 This patch adds some text at opportune places to remind
20329 programmers to do things the right way.
20330
20331 index.3
20332 stpcpy.3
20333 strcasecmp.3
20334 strcat.3
20335 strchr.3
20336 strcmp.3
20337 strcoll.3
20338 strcpy.3
20339 strdup.3
20340 strfry.3
20341 strpbrk.3
20342 strsep.3
20343 strspn.3
20344 strstr.3
20345 strtok.3
20346 strxfrm.3
20347 Michael Kerrisk
20348 SEE ALSO: Add reference to string(3)
20349 The idea here is to provide a route to discover other
20350 string functions.
20351
20352 armscii-8.7
20353 cp1251.7
20354 iso_8859-3.7
20355 iso_8859-5.7
20356 iso_8859-6.7
20357 iso_8859-8.7
20358 iso_8859-10.7
20359 iso_8859-11.7
20360 iso_8859-13.7
20361 iso_8859-14.7
20362 koi8-u.7
20363 Denis Barbier
20364 Fix decimal values in encoding tables
20365 Octal and hexadecimal values are right, but there are some
20366 off-by one errors in decimal values. Correct values are
20367 printed by this command:
20368
20369 perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
20370 {printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7
20371
20372
20373 Changes to individual pages
20374 ---------------------------
20375
20376 capget.2
20377 Michael Kerrisk
20378 SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE"
20379
20380 fcntl.2
20381 Michael Kerrisk
20382 Add feature test macro requirements for F_GETOWN and F_SETOWN
20383
20384 fcntl.2
20385 Michael Kerrisk
20386 Note feature test macro requirements for F_DUPFD_CLOEXEC
20387
20388 getrlimit.2
20389 Michael Kerrisk
20390 Document units for RLIMIT_RTTIME limit
20391 This limit is in microseconds
20392
20393 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492
20394
20395 lseek.2
20396 Michael Kerrisk
20397 Removed note about return type on ancient systems
20398
20399 mount.2
20400 Michael Kerrisk
20401 Definitions of various MS_* constants only appeared in glibc 2.12
20402 See http://sourceware.org/bugzilla/show_bug.cgi?id=11235
20403
20404 stat.2
20405 Michael Kerrisk
20406 Update information on nanosecond timestamp fields
20407 Update feature test macro requirements for exposing these fields.
20408 Note that these fields are specified in POSIX.1-2008.
20409
20410 timer_create.2
20411 Michael Kerrisk
20412 Factor out generic material that was moved to new sigevent(7) page
20413
20414 aio_fsync.3
20415 Michael Kerrisk
20416 Add reference to new sigevent(7) page
20417
20418 atanh.3
20419 Michael Kerrisk
20420 glibc 2.10 fixed pole error bug
20421 http://sourceware.org/bugzilla/show_bug.cgi?id=6759
20422 was resolved.
20423
20424 cerf.3
20425 Michael Kerrisk
20426 Make it clearer that this function is unimplemented
20427
20428 cos.3
20429 Michael Kerrisk
20430 errno is now correctly set to EDOM on a domain error
20431 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780
20432 was (silently) resolved.
20433
20434 expm1.3
20435 Michael Kerrisk
20436 errno is now correctly set to ERANGE on a range error
20437 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
20438 was (silently) resolved.
20439
20440 fmod.3
20441 Michael Kerrisk
20442 errno is now correctly set to EDOM for the x==inf domain error
20443 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
20444 was (silently) resolved.
20445
20446 insque.3
20447 Michael Kerrisk
20448 Noted prev == NULL bug in glibc 2.4 and earlier
20449 As noted by Remi Denis-Courmont, glibc nowadays allows
20450 'prev' to be NULL, as required by POSIX for initializing
20451 a linear list. But in glibc 2.4 and earlier, 'prev' could
20452 not be NULL. Add a BUGS section noting this.
20453
20454 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201
20455 Michael Kerrisk
20456 Added info on circular lists, and initializing circular lists
20457 Michael Kerrisk
20458 Added example program
20459
20460 lgamma.3
20461 Michael Kerrisk
20462 glibc 2.10 fixed pole error bug
20463 http://sourceware.org/bugzilla/show_bug.cgi?id=6777
20464 was (silently) resolved.
20465
20466 log2.3
20467 Matthew Flaschen
20468 log2() function does not conform to C89
20469 log2(), log2f(), and log2l() do not conform to C89.
20470 They are defined in C99. See http://flash-gordon.me.uk/ansi.c.txt
20471 and http://www.schweikhardt.net/identifiers.html
20472
20473 mq_notify.3
20474 Michael Kerrisk
20475 Factor out generic material that was moved to new sigevent(7) page
20476
20477 pow.3
20478 Michael Kerrisk
20479 errno is now correctly set to ERANGE on a pole error
20480 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
20481 was (silently) resolved.
20482
20483 pthread_kill_other_threads_np.3
20484 Michael Kerrisk
20485 CONFORMING TO: Note meaning of "_np" suffix
20486
20487 rand.3
20488 Michael Kerrisk
20489 Clarify description of range of returned value
20490 Michael Kerrisk
20491 Add an example program
20492 Michael Kerrisk
20493 Expand description of rand_r()
20494
20495 random.3
20496 W. Trevor King
20497 Update initstate() return value description to match glibc
20498
20499 readdir.3
20500 Michael Kerrisk
20501 Clarify that "positive error numbers" are listed in ERRORS
20502
20503 rexec.3
20504 Michael Kerrisk
20505 SYNOPSIS: Add header file and feature test macro requirements
20506
20507 sigpause.3
20508 Michael Kerrisk
20509 Correct discussion of when BSD vs SysV version is used in glibc
20510
20511 sin.3
20512 Michael Kerrisk
20513 errno is now correctly set to EDOM on a domain error
20514 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
20515 was (silently) resolved.
20516
20517 tan.3
20518 Michael Kerrisk
20519 errno is now correctly set to EDOM on a domain error
20520 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782
20521 was (silently) resolved.
20522
20523 wcscasecmp.3
20524 wcsncasecmp.3
20525 wcsnlen.3
20526 Michael Kerrisk
20527 Added VERSIONS section
20528
20529 boot.7
20530 Yuri Kozlov
20531 Update list of major Linux distributions
20532
20533 feature_test_macros.7
20534 Michael Kerrisk
20535 Make text on required placement of macros more prominent
20536 Move the text that notes the requirement that feature test macros
20537 must be defined before including any header files to the top of
20538 the page, and highlight the text further, so that the reader will
20539 not miss this point.
20540
20541 pthreads.7
20542 signal.7
20543 Michael Kerrisk
20544 Add SEE ALSO reference to new sigevent(7) page
20545
20546 tcp.7
20547 Michael Kerrisk
20548 Clarify header file details for SIOCINQ and SIOCOUTQ
20549 Also note synonymous FIONREAD and TIOCOUTQ.
20550
20551
20552 ==================== Changes in man-pages-3.28 ====================
20553
20554 Released: 2010-10-04, Munich
20555
20556
20557 Contributors
20558 ------------
20559
20560 The following people contributed notes, ideas, or patches that have
20561 been incorporated in changes in this release:
20562
20563 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
20564 Denis Barbier <bouzim@gmail.com>
20565 Jan Kara <jack@suse.cz>
20566 Landijk <landijk-user@yahoo.com>
20567 Lennart Poettering <mzjro@0pointer.net>
20568 Michael Haardt <michael@moria.de>
20569 Michael Kerrisk <mtk.manpages@gmail.com>
20570 Petr Baudis <pasky@suse.cz>
20571 Sam Varshavchik <mrsam@courier-mta.com>
20572
20573 Apologies if I missed anyone!
20574
20575
20576 New and rewritten pages
20577 -----------------------
20578
20579 getaddrinfo_a.3
20580 Petr Baudis
20581 New page documenting getaddrinfo_a()
20582 The page also documents gai_suspend(), gai_cancel(),
20583 and gai_error().
20584
20585 aio.7
20586 Michael Kerrisk
20587 New page providing an overview of POSIX asynchronous I/O
20588
20589
20590 Newly documented interfaces in existing pages
20591 ---------------------------------------------
20592
20593 exec.3
20594 Michael Kerrisk
20595 Document execvpe()
20596 This function was added to glibc in version 2.11.
20597 Also various other small rewrites in the page.
20598
20599
20600 New and changed links
20601 ---------------------
20602
20603 gai_cancel.3
20604 gai_error.3
20605 gai_suspend.3
20606 Petr Baudis
20607 New links to new getaddrinfo_a.3 page
20608
20609 error_one_per_line.3
20610 Michael Kerrisk
20611 Fix misnamed link file (was error_on_per_line.3)
20612
20613 execvpe.3
20614 Michael Kerrisk
20615 New link to exec.3
20616
20617 sigstack.3
20618 Michael Kerrisk
20619 New link to sigaltstack.2
20620 No new programs should use sigstack(3). Point the user to the
20621 better sigaltstack(2), whose man page briefly mentions sigstack(3).
20622
20623 vlimit.3
20624 Michael Kerrisk
20625 New link to getrlimit.2
20626 No new programs should use vlimit(3). Point the user to the
20627 better setrlimit(2), whose man page briefly mentions vlimit(3).
20628
20629 vtimes.3
20630 Michael Kerrisk
20631 New link to getrusage.2
20632 No new programs should use vtimes(3). Point the user to the
20633 better getrusage(2), whose man page briefly mentions vtimes(3).
20634
20635
20636 Global changes
20637 --------------
20638
20639 Various pages
20640 Michael Kerrisk
20641 Switch to American usage: "-wards" ==> "-ward"
20642 American English uses "afterward" in preference to "afterwards",
20643 and so on
20644
20645 chdir.2
20646 chmod.2
20647 chown.2
20648 gethostname.2
20649 getsid.2
20650 pread.2
20651 setpgid.2
20652 sigaltstack.2
20653 stat.2
20654 truncate.2
20655 wait.2
20656 dirfd.3
20657 getsubopt.3
20658 mkdtemp.3
20659 mkstemp.3
20660 siginterrupt.3
20661 strdup.3
20662 Michael Kerrisk
20663 Simplify feature test macro requirements
20664
20665
20666 Changes to individual pages
20667 ---------------------------
20668
20669 getrlimit.2
20670 Michael Kerrisk
20671 Add mention of the ancient vlimit() function
20672
20673 getrusage.2
20674 Michael Kerrisk
20675 Add mention of the ancient vtimes() function
20676
20677 io_cancel.2
20678 io_destroy.2
20679 io_getevents.2
20680 io_setup.2
20681 io_submit.2
20682 Michael Kerrisk
20683 SEE ALSO: add aio(7)
20684
20685 sched_setscheduler.2
20686 Michael Kerrisk
20687 ERRORS: note that NULL 'param' yields EINVAL
20688
20689 stat.2
20690 Michael Kerrisk
20691 Note feature test macro requirements for blkcnt_t and blksize_t
20692
20693 timer_create.2
20694 Michael Kerrisk
20695 Standardize on name 'sevp' for sigevent argument
20696
20697 truncate.2
20698 Michael Kerrisk
20699 Correct and simplify ftruncate() feature test macro requirements
20700 The glibc 2.12 feature test macro requirements for ftruncate() are
20701 buggy; see http://sourceware.org/bugzilla/show_bug.cgi?id=12037.
20702 Corrected the requirements in the SYNOPSIS, and added a BUGS
20703 section describing the problem in glibc 2.12.
20704
20705 aio_cancel.3
20706 Michael Kerrisk
20707 Add pointer to aio(7) for example program
20708 Refer the reader to aio(7) for a description of the aiocb structure
20709 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20710
20711 aio_error.3
20712 Michael Kerrisk
20713 Wording improvements in RETURN VALUE
20714 Add pointer to aio(7) for example program
20715 Refer the reader to aio(7) for a description of the aiocb structure
20716 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20717
20718 aio_fsync.3
20719 Michael Kerrisk
20720 Refer the reader to aio(7) for a description of the aiocb structure
20721 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20722
20723 aio_read.3
20724 Michael Kerrisk
20725 Various minor rewordings and additions
20726 Add pointer to sigevent(7) for details of notification of I/O completion
20727 Add pointer to aio(7) for example program
20728 Refer the reader to aio(7) for a description of the aiocb structure
20729 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20730
20731 aio_return.3
20732 Michael Kerrisk
20733 Improve description in RETURN VALUE
20734 Add pointer to aio(7) for example program
20735 Refer the reader to aio(7) for a description of the aiocb structure
20736 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20737
20738 aio_suspend.3
20739 Michael Kerrisk
20740 Various additions and rewordings.
20741 Give some arguments more meaningful names.
20742 More explicitly describe the 'nitems' argument.
20743 Explicitly note that return is immediate if an I/O operation
20744 has already completed.
20745 Note that aio_error(3) should be used to scan the aiocb list
20746 after a successful return.
20747 Add references to other relevant pages.
20748 Various other pieces rewritten.
20749 Refer the reader to aio(7) for a description of the aiocb structure
20750 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20751
20752 aio_write.3
20753 Michael Kerrisk
20754 Add pointer to sigevent(7) for details of notification of I/O completion
20755 Various minor rewordings and additions
20756 Refer the reader to aio(7) for a description of the aiocb structure
20757 CONFORMING TO: Add POSIX.1-2008; add VERSIONS section
20758
20759 clearenv.3
20760 Michael Kerrisk
20761 Fix error in feature test macro requirements
20762
20763 dysize.3
20764 Michael Kerrisk
20765 Remove crufty statement about old SCO bug
20766
20767 exec.3
20768 Michael Kerrisk
20769 Add feature test macro requirements for execvpe()
20770 Rewrite description of PATH and mention _CS_PATH
20771 Note execvp() and execlp() behavior for filename containing a slash
20772
20773 getaddrinfo.3
20774 Michael Kerrisk
20775 Add SEE ALSO reference to new getaddrinfo_a.3 page
20776
20777 gethostbyname.3
20778 Michael Kerrisk
20779 Fix formatting of feature test macros
20780
20781 getw.3
20782 Michael Kerrisk
20783 Fix feature test macros
20784
20785 malloc.3
20786 Landijk
20787 Remove editorializing comments on memory overcommitting
20788 See https://bugzilla.kernel.org/show_bug.cgi?id=19332
20789 Michael Kerrisk
20790 Various minor reorganizations and wording fix-ups
20791
20792 mq_notify.3
20793 Michael Kerrisk
20794 Standardize on name 'sevp' for sigevent argument
20795
20796 nl_langinfo.3
20797 Michael Haardt
20798 Make it clear that nl_langinfo() interacts with setlocale()
20799 Add an example program
20800
20801 posix_openpt.3
20802 Michael Kerrisk
20803 Fix feature test macro requirements
20804
20805 rand.3
20806 Michael Kerrisk
20807 Remove duplicate #include in example program
20808
20809 strtok.3
20810 Petr Baudis
20811 Add reference to strtok() example in getaddrinfo(3)
20812
20813 inotify.7
20814 Michael Kerrisk
20815 Added section noting limitations and caveats of inotify
20816
20817 sigevent.7
20818 Michael Kerrisk
20819 Add SEE ALSO reference to new getaddrinfo_a.3 page
20820 Add SEE ALSO referring to new aio(7) page
20821
20822 suffixes.7
20823 Michael Kerrisk
20824 Change explanation of ".rpm" to "RPM software package"
20825
20826
20827 ==================== Changes in man-pages-3.29 ====================
20828
20829 Released: 2010-10-19, Detroit
20830
20831
20832 Contributors
20833 ------------
20834
20835 The following people contributed notes, ideas, or patches that have
20836 been incorporated in changes in this release:
20837
20838 Balazs Scheidler <bazsi@balabit.hu>
20839 David Prevot <davidp@altern.org>
20840 Denis Barbier <bouzim@gmail.com>
20841 Guillem Jover <guillem@hadrons.org>
20842 Ivana Varekova <varekova@redhat.com>
20843 Lennart Poettering <mzxreary@0pointer.de>
20844 Michael Kerrisk <mtk.manpages@gmail.com>
20845 Sam Varshavchik <mrsam@courier-mta.com>
20846 Simon Paillard <simon.paillard@resel.enst-bretagne.fr>
20847 Stephan Mueller <stephan.mueller@atsec.com>
20848 Thomas Jarosch <thomas.jarosch@intra2net.com>
20849 Yuri Kozlov <yuray@komyakino.ru>
20850
20851 Apologies if I missed anyone!
20852
20853
20854 New and rewritten pages
20855 -----------------------
20856
20857 subpage_prot.2
20858 Michael Kerrisk
20859 New page documenting the PowerPC-specific subpage_prot(2)
20860
20861 aio_init.3
20862 Michael Kerrisk
20863 New page documenting aio_init(3)
20864
20865
20866 Newly documented interfaces in existing pages
20867 ---------------------------------------------
20868
20869 posix_fadvise.2
20870 Michael Kerrisk
20871 Document the architecture-specific arm_fadvise64_64() system call
20872 This ARM-specific system call fixes the argument ordering
20873 for that architecture. Since Linux 2.6.14.
20874
20875 sync_file_range.2
20876 Michael Kerrisk
20877 Document the architecture-specific sync_file_range2() system call
20878 As described in commit edd5cd4a9424f22b0fa08bef5e299d41befd5622,
20879 the sync_file_range() argument order is broken for some
20880 architectures (PowerPC, ARM, tile). The remedy was a different
20881 system call using the right argument order on those architectures.
20882
20883 psignal.3
20884 Guillem Jover
20885 Document psiginfo()
20886 psiginfo() was added to glibc in version 2.10.
20887 Michael Kerrisk
20888 Add details, VERSIONS, and BUGS for psiginfo()
20889
20890 ip.7
20891 Balazs Scheidler
20892 Document IP_RECVORIGDSTADDR
20893 Document IP_TRANSPARENT
20894 Michael Kerrisk
20895 Document IP_FREEBIND
20896 Text based on input from Lennart Poettering and Balazs Scheidler.
20897 See https://bugzilla.kernel.org/show_bug.cgi?id=20082
20898
20899
20900 New and changed links
20901 ---------------------
20902
20903 arm_fadvise64_64.2
20904 Michael Kerrisk
20905 New link to posix_fadvise.2
20906
20907 arm_sync_file_range.2, sync_file_range2.2
20908 Michael Kerrisk
20909 New links to sync_file_range.2
20910
20911 arrm_fadvise.2
20912 Michael Kerrisk
20913 New link to posix_fadvise.2
20914
20915 psiginfo.3
20916 Guillem Jover
20917 New link to psignal.3
20918
20919
20920 Global changes
20921 --------------
20922
20923 Many pages
20924 Michael Kerrisk
20925 global fix: s/Unix/UNIX/
20926 The man pages were rather inconsistent in the use of "Unix"
20927 versus "UNIX". Let's go with the trademark usage.
20928
20929 Various pages
20930 Michael Kerrisk
20931 Global fix: s/pseudo-terminal/pseudoterminal/
20932
20933 grantpt.3, ptsname.3, unlockpt.3, pts.4
20934 Michael Kerrisk
20935 Global fix: s/pty/pseudoterminal/
20936
20937 recv.2, cmsg.3, unix.7
20938 Michael Kerrisk
20939 global fix: s/UNIX socket/UNIX domain socket/
20940
20941 fmtmsg.3, gethostbyname.3, termios.3
20942 Michael Kerrisk
20943 Global fix: s/Unixware/UnixWare/
20944
20945
20946 Changes to individual pages
20947 ---------------------------
20948
20949 inotify_rm_watch.2
20950 Michael Kerrisk
20951 SYNOPSIS: fix type of 'wd' argument
20952
20953 posix_fadvise.2
20954 Michael Kerrisk
20955 Rewrite VERSIONS, noting that the system call is fadvise64()
20956
20957 syscalls.2
20958 Michael Kerrisk
20959 Add the PowerPC-specific subpage_prot() system call
20960 Add sync_file_range2()
20961
20962 truncate.2
20963 Michael Kerrisk
20964 Fix feature test macros
20965
20966 aio_cancel.3
20967 aio_error.3
20968 aio_fsync.3
20969 aio_read.3
20970 aio_return.3
20971 aio_suspend.3
20972 aio_write.3
20973 Michael Kerrisk
20974 SEE ALSO: Add lio_listio(3)
20975
20976 gai_cancel.3
20977 gai_error.3
20978 gai_suspend.3
20979 Michael Kerrisk
20980 Make these into links
20981 In the previous release, these files were accidentally made copies
20982 of getaddrinfo_a.3, instead of being made as link files.
20983
20984 getifaddrs.3
20985 Thomas Jarosch
20986 Prevent possible NULL pointer access in example program
20987
20988 malloc.3
20989 Michael Kerrisk
20990 Emphasize that malloc() and realloc() do not initialize allocated memory
20991
20992 malloc_hook.3
20993 Ivana Varekova
20994 Warn that these functions are deprecated
20995
20996 strcpy.3
20997 Michael Kerrisk
20998 Formatting fixes in strncpy() example implementation code
20999
21000 ip.7
21001 Michael Kerrisk
21002 Reword NOTES on Linux-specific options
21003
21004 sigevent.7
21005 Michael Kerrisk
21006 SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3)
21007
21008 unix.7
21009 Michael Kerrisk
21010 Document the autobind feature
21011 Michael Kerrisk
21012 Fix description of abstract socket names
21013 As reported by Lennart Poettering:
21014 The part about "abstract" sockets is misleading as it suggests
21015 that the sockaddr returned by getsockname() would necessarily
21016 have the size of sizeof(struct sockaddr), which however is not
21017 the case: getsockname() returns exactly the sockaddr size that
21018 was passed in on bind(). In particular, two sockets that are
21019 bound to the same sockaddr but different sizes are completely
21020 independent.
21021 See https://bugzilla.kernel.org/show_bug.cgi?id=19812
21022 Michael Kerrisk
21023 Fix description of "pathname" sockets
21024 As reported by Lennart Poettering:
21025 The part about "pathname" sockets suggests usage of
21026 sizeof(sa_family_t) + strlen(sun_path) + 1
21027 for calculating the sockaddr size. Due to alignment/padding
21028 this is probably not a good idea. Instead, one should use
21029 offsetof(struct sockaddr_un, sun_path) + strlen() + 1
21030 or something like that.
21031 See https://bugzilla.kernel.org/show_bug.cgi?id=19812
21032
21033
21034 ==================== Changes in man-pages-3.30 ====================
21035
21036 Released: 2010-11-01, Munich
21037
21038
21039 Contributors
21040 ------------
21041
21042 The following people contributed notes, ideas, or patches that have
21043 been incorporated in changes in this release:
21044
21045 Andi Kleen <andi@firstfloor.org>
21046 Bernhard Walle <bernhard@bwalle.de>
21047 David Prevot <davidp@altern.org>
21048 Eric W. Biederman <ebiederm@xmission.com>
21049 Florian Lehmann <flo.lehmann@googlemail.com>
21050 Jan Engelhardt <jengelh@medozas.de>
21051 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
21052 Michael Kerrisk <mtk.manpages@gmail.com>
21053 Paul Mackerras <paulus@samba.org>
21054 Pádraig Brady <P@draigbrady.com>
21055 Reuben Thomas <rrt@sc3d.org>
21056 scarlettsp <scarlettsp@gmail.com>
21057 Yuri Kozlov <yuray@komyakino.ru>
21058
21059 Apologies if I missed anyone!
21060
21061
21062 New and rewritten pages
21063 -----------------------
21064
21065 kexec_load.2
21066 Andi Kleen
21067 New page documenting kexec_load(2)
21068 Michael Kerrisk
21069 Add license
21070 Michael Kerrisk
21071 Incorporate fixes from Eric W. Biederman
21072 Eric noted that a few instances of "virtual" should
21073 be "physical" and noted:
21074
21075 There is an expectation that at hand off from sys_kexec that
21076 virtual and physical addresses will be identity mapped. But
21077 this isn't the old Alpha booting convention where you have
21078 a virtual address and then you have to parse the page table
21079 to figure out where your kernel was actually loaded.
21080 Michael Kerrisk
21081 Additions and edits by mtk
21082 Various wording and layout improvements.
21083 Fixed the name of a constant: s/KEXEC_ARCH_I386/KEXEC_ARCH_386/.
21084 Added RETURN VALUE and ERRORS sections.
21085 Added VERSIONS section
21086 Note that CONFIG_KEXEC is needed
21087 Removed details of using syscall; the reader can find them in
21088 syscall(2).
21089 Added some details for KEXEC_PRESERVE_CONTEXT.
21090 Revised the text mentioning the kernel header, since it is
21091 not yet exported, and it's not certain that it will be.
21092
21093 lio_listio.3
21094 Michael Kerrisk
21095 New page documenting lio_listio(3)
21096
21097
21098 Newly documented interfaces in existing pages
21099 ---------------------------------------------
21100
21101 reboot.2
21102 Andi Kleen
21103 Document LINUX_REBOOT_KEXEC
21104 Some fix-ups by Michael Kerrisk
21105 Michael Kerrisk
21106 Place 'cmd' values in alphabetical order.
21107
21108 unshare.2
21109 Michael Kerrisk
21110 Document CLONE_NEWIPC
21111 Michael Kerrisk
21112 Document CLONE_NEWNET
21113 Lucian Adrian Grijincu
21114 Improve description of CLONE_NEWNET
21115 CLONE_NEWNET creates a new network namespace from scratch.
21116 You don't have anything from the old network namespace in
21117 the new one. Even the loopback device is new.
21118 Michael Kerrisk
21119 Document CLONE_SYSVSEM
21120 Michael Kerrisk
21121 Document CLONE_NEWUTS
21122 Michael Kerrisk
21123 Relocate discussion of CAP_SYS_ADMIN to CLONE_NEWNS section
21124 And rewrite the EPERM description to be more general in
21125 preparation for the new flags to be documented.
21126
21127
21128 Global changes
21129 --------------
21130
21131 Various pages
21132 Michael Kerrisk
21133 Add reference to feature_test_macros(7)
21134 Some pages simply list feature test macro requirements in
21135 the form:
21136
21137 #define #GNU_SOURCE
21138 #include <someheader.h>
21139
21140 For these pages, add a "See feature_test_macros(7)" comment
21141 on the "#define" line.
21142
21143 Various pages
21144 Michael Kerrisk
21145 SEE ALSO: Remove redundant reference to feature_test_macros(7)
21146
21147 Various pages
21148 David Prevot
21149 Use greater consistency in NAME line
21150 (Remove definite article at start of descriptive clause.)
21151
21152 Various pages
21153 Michael Kerrisk
21154 SEE ALSO: Place entries in correct order
21155
21156 Various pages
21157 Michael Kerrisk
21158 ERRORS: Place entries in correct order
21159
21160 Various pages
21161 Michael Kerrisk
21162 Add section number to references to functions documented in other pages
21163
21164 Various pages
21165 Michael Kerrisk
21166 Remove redundant section number in page references
21167 Remove section number in function references that are for
21168 functions documented on this page.
21169
21170 armscii-8.7
21171 iso_8859-3.7
21172 iso_8859-4.7
21173 iso_8859-5.7
21174 iso_8859-6.7
21175 iso_8859-10.7
21176 iso_8859-11.7
21177 iso_8859-13.7
21178 iso_8859-14.7
21179 koi8-u.7
21180 David Prevot
21181 Capitalize hexadecimal numbers
21182
21183
21184 Changes to individual pages
21185 ---------------------------
21186
21187 access.2
21188 Michael Kerrisk
21189 Note use of faccessat(2) for checking symbolic link permissions
21190 Michael Kerrisk
21191 Give an example of a safer alternative to using access()
21192
21193 clone.2
21194 Michael Kerrisk
21195 Clarify when CLONE_NEWNET implementation was completed
21196
21197 faccessat.2
21198 Michael Kerrisk
21199 Note that faccessat() is racy
21200
21201 fcntl.2
21202 Michael Kerrisk
21203 RETURN VALUE: Improve description of F_GETFD and F_GETFL
21204
21205 inotify_add_watch.2
21206 Michael Kerrisk
21207 Document ENOENT error
21208
21209 mlock.2
21210 Michael Kerrisk
21211 Improve wording describing /proc/PID/status /VmLck field
21212 Michael Kerrisk
21213 shmctl() SHM_LOCKed memory is not included in VmLck
21214
21215 reboot.2
21216 Michael Kerrisk
21217 Place 'cmd' values in alphabetical order
21218
21219 subpage_prot.2
21220 Michael Kerrisk
21221 Change 1-line page description
21222 Michael Kerrisk
21223 Improvements after review by Paul Mackerras
21224
21225 timer_settime.3
21226 Michael Kerrisk
21227 Remove redundant SEE ALSO reference
21228
21229 euidaccess.3
21230 Michael Kerrisk
21231 Note the use of faccessat(2) to operate on symbolic links
21232 Michael Kerrisk
21233 Note that the use of euidaccess() is racy
21234
21235 fenv.3
21236 Michael Kerrisk
21237 Clarify wording relating to glibc version
21238
21239 getgrent.3
21240 getgrent_r.3
21241 getgrnam.3
21242 Michael Kerrisk
21243 Refer reader for group(5) for more info on group structure
21244
21245 getopt.3
21246 Bernhard Walle
21247 Use constants in getopt_long() example
21248 The description of getopt_long() mentions the constants
21249 required_argument, no_argument and optional_argument.
21250 Use them in the example to make the code easier to understand.
21251
21252 getpw.3
21253 Michael Kerrisk
21254 Change comment describing pw_gecos
21255
21256 getpw.3
21257 getpwent.3
21258 getpwent_r.3
21259 Michael Kerrisk
21260 Refer reader to passwd(5) for more info on the passwd structure
21261
21262 getpwent.3
21263 getpwnam.3
21264 Michael Kerrisk
21265 Note that pw_gecos is not in POSIX
21266 And change the comment describing this field
21267
21268 getpwent_r.3
21269 Michael Kerrisk
21270 Change comment describing pw_gecos
21271
21272 getpwnam.3
21273 Michael Kerrisk
21274 Some rewording and restructuring
21275
21276 sched_getcpu.3
21277 Michael Kerrisk
21278 Fix feature test macro requirements
21279
21280 strnlen.3
21281 Michael Kerrisk
21282 Fix feature test macro requirements
21283
21284 group.5
21285 Michael Kerrisk
21286 Various minor rewordings
21287
21288 hosts.5
21289 protocols.5
21290 spufs.7
21291 termio.7
21292 David Prevot
21293 Remove definite article from NAME section
21294 Please find inline another tiny patch in order to shrink
21295 the definite article from some other pages (found with
21296 "rgrep -i ' \\\- the' man*").
21297
21298 passwd.5
21299 Michael Kerrisk
21300 Various minor rewordings
21301
21302 proc.5
21303 Michael Kerrisk
21304 Add reference to mlock(2) for further info on /proc/PID/status VmLck
21305
21306 armscii-8.7
21307 David Prevot
21308 Write the character set name as ArmSCII
21309
21310 cp1251.7
21311 David Prevot
21312 Capitalize hexadecimal numbers
21313
21314 ip.7
21315 David Prevot
21316 Fix name of socket option: s/IP_TTL/IP_TRANSPARENT/
21317 David Prevot
21318 Place socket options in alphabetical order
21319
21320 koi8-r.7
21321 David Prevot
21322 Fix special character names
21323 Comparing to koi8-u.7, I noticed some inconsistencies in special
21324 character names. After checking with the following Unicode related
21325 pages, please find inline (and gzipped attached, hopefully not
21326 messing with encoding), a patch in order to make it right, on an
21327 Unicode point of view.
21328
21329 http://www.unicode.org/charts/PDF/U2500.pdf
21330 http://www.unicode.org/charts/PDF/U25A0.pdf
21331 http://www.unicode.org/charts/PDF/U0080.pdf
21332 http://www.unicode.org/charts/PDF/U1D400.pdf
21333 David Prevot
21334 Fix SEE ALSO reference and letter names
21335 The koi8-r(7) (Russian Net Character Set) manual page refers
21336 to iso-8859-7(7) manual page, which is the Latin/Greek one.
21337 I guess it should refer instead to the iso-8859-5(7)
21338 (Latin/Cyrillic) one. This is addressed at the end of the patch.
21339
21340 It has also been spotted that letter names are different in
21341 this manual page and in the Unicode related page [0], the
21342 first part of the page address this.
21343
21344 0: http://www.unicode.org/charts/PDF/U0400.pdf
21345
21346 man-pages.7
21347 Michael Kerrisk
21348 Update example
21349 The old example used the chmod(2) man page, but the
21350 feature test macro requirements on that page had changed.
21351 Update to use an example from a different page (acct(2),
21352 whose feature test macro requirements are probably unlikely
21353 to change in the future).
21354
21355
21356 ==================== Changes in man-pages-3.31 ====================
21357
21358 Released: 2010-11-12, Munich
21359
21360
21361 Contributors
21362 ------------
21363
21364 The following people contributed notes, ideas, or patches that have
21365 been incorporated in changes in this release:
21366
21367 Andi Kleen <andi@firstfloor.org>
21368 David Prevot <davidp@altern.org>
21369 Denis Barbier <bouzim@gmail.com>
21370 Krzysztof Żelechowski <giecrilj@stegny.2a.pl>
21371 Michael Kerrisk <mtk.manpages@gmail.com>
21372 Yuri Kozlov <yuray@komyakino.ru>
21373
21374 Apologies if I missed anyone!
21375
21376
21377 Newly documented interfaces in existing pages
21378 ---------------------------------------------
21379
21380 getrlimit.2
21381 Michael Kerrisk
21382 Added documentation of prlimit()
21383 prlimit() is new in kernel 2.6.36.
21384
21385 inotify.7
21386 Michael Kerrisk
21387 Document IN_EXCL_UNLINK
21388 This flag was added in Linux 2.6.36.
21389 See kernel commit 8c1934c8d70b22ca8333b216aec6c7d09fdbd6a6.
21390
21391
21392 New and changed links
21393 ---------------------
21394
21395 prlimit.2
21396 Michael Kerrisk
21397 New link to getrlimit.2
21398
21399
21400 Changes to individual pages
21401 ---------------------------
21402
21403 getrlimit.2
21404 Michael Kerrisk
21405 Remove unneeded text in DESCRIPTION
21406
21407 intro.2
21408 Michael Kerrisk
21409 Added various pages to SEE ALSO
21410
21411 kexec_load.2
21412 Michael Kerrisk
21413 Add kernel version where KEXEC_PRESERVE_CONTEXT first appeared
21414 Added kernel version number where KEXEC_ON_CRASH first appeared
21415 Fix copyright
21416 Make copyright in the name of Intel corporation
21417 VERSIONS: Fix version number
21418 kexec_load() was first implemented in 2.6.13, though the entry
21419 in the system call table was reserved starting in 2.6.7.
21420
21421 migrate_pages.2
21422 Michael Kerrisk
21423 SEE ALSO: Add reference to Documentation/vm/page_migration
21424
21425 sched_setaffinity.2
21426 Michael Kerrisk
21427 Add missing word "real" to "user ID"
21428
21429 syscalls.2
21430 Michael Kerrisk
21431 Fix kernel version number for kexec_load
21432 kexec_load() was first implemented in 2.6.13, though the entry
21433 in the system call table was reserved starting in 2.6.7.
21434 Michael Kerrisk
21435 Add prlimit() to list
21436
21437 intro.3
21438 Michael Kerrisk
21439 Added various pages to SEE ALSO
21440
21441 printf.3
21442 Michael Kerrisk
21443 Formatting fixes in example code
21444
21445 hostname.7
21446 Michael Kerrisk
21447 Small improvement to description of domains
21448 See: https://bugzilla.novell.com/show_bug.cgi?id=651900
21449
21450
21451 ==================== Changes in man-pages-3.32 ====================
21452
21453 Released: 2010-12-03, Munich
21454
21455
21456 Contributors
21457 ------------
21458
21459 The following people contributed notes, ideas, or patches that have
21460 been incorporated in changes in this release:
21461
21462 A. Costa <agcosta@gis.net>
21463 Denis Barbier <bouzim@gmail.com>
21464 Emil Mikulic <emikulic@gmail.com>
21465 Eugene Kapun <abacabadabacaba@gmail.com>
21466 Hugh Dickins <hughd@google.com>
21467 Ivana Hutarova Varekova <varekova@redhat.com>
21468 Joern Heissler <kernelbugs@joern.heissler.de>
21469 Lars Wirzenius <liw@liw.fi>
21470 Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
21471 Michael Kerrisk <mtk.manpages@gmail.com>
21472 Petr Uzel <petr.uzel@suse.cz>
21473 Roger Pate <roger@qxxy.com>
21474 Török Edwin <edwintorok@gmail.com>
21475 Yuri Kozlov <yuray@komyakino.ru>
21476
21477 Apologies if I missed anyone!
21478
21479
21480 New and rewritten pages
21481 -----------------------
21482
21483 pthread_sigqueue.3
21484 Michael Kerrisk
21485 New page documenting pthread_sigqueue()
21486 pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
21487 rt_tgsigqueinfo(), added in Linux 2.6.31).
21488
21489
21490 Newly documented interfaces in existing pages
21491 ---------------------------------------------
21492
21493 readv.2
21494 Michael Kerrisk
21495 Add documentation of preadv() and pwritev()
21496 The preadv() and pwritev() system calls were added in
21497 Linux 2.6.30.
21498
21499
21500 New and changed links
21501 ---------------------
21502
21503 preadv.2
21504 Michael Kerrisk
21505 New link to readv.2
21506
21507 pwritev.2
21508 Michael Kerrisk
21509 New link to readv.2
21510
21511
21512 Changes to individual pages
21513 ---------------------------
21514
21515 chdir.2
21516 Michael Kerrisk
21517 Remove redundant and incorrect info on FTMs from NOTES
21518
21519 chown.2
21520 Michael Kerrisk
21521 Add NOTES explaining 32-bit system calls added in Linux 2.4
21522
21523 clock_nanosleep.2
21524 Michael Kerrisk
21525 Clarify that clock_nanosleep() suspends the calling *thread*
21526
21527 epoll_create.2
21528 Michael Kerrisk
21529 Note that 'size' argument must be greater than 0
21530 See https://bugzilla.kernel.org/show_bug.cgi?id=23872
21531 Michael Kerrisk
21532 Added VERSIONS section
21533
21534 epoll_ctl.2
21535 Michael Kerrisk
21536 Added VERSIONS section
21537
21538 epoll_wait.2
21539 Michael Kerrisk
21540 Updated VERSIONS section
21541
21542 fcntl.2
21543 Michael Kerrisk
21544 Add notes on fcntl64()
21545
21546 fstatat.2
21547 Michael Kerrisk
21548 Add NOTES on fstatat64(), the name of the underlying system call
21549
21550 getdents.2
21551 Michael Kerrisk
21552 Added notes on getdents64()
21553
21554 getgid.2
21555 Michael Kerrisk
21556 Add NOTES explaining 32-bit system calls added in Linux 2.4
21557
21558 getgroups.2
21559 Michael Kerrisk
21560 Add NOTES explaining 32-bit system calls added in Linux 2.4
21561
21562 getpagesize.2
21563 Michael Kerrisk
21564 Improve description of getpagesize()
21565 Improve description of getpagesize() and relocate discussion
21566 of sysconf(_SC_PAGESIZE).
21567
21568 In part inspired by
21569 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=537272
21570
21571 getresuid.2
21572 Michael Kerrisk
21573 Add NOTES explaining 32-bit system calls added in Linux 2.4
21574
21575 getrlimit.2
21576 Michael Kerrisk
21577 Add example program for prlimit()
21578
21579 getuid.2
21580 Michael Kerrisk
21581 Add NOTES explaining 32-bit system calls added in Linux 2.4
21582
21583 open.2
21584 Ivana Hutarova Varekova
21585 O_EXCL can be used without O_CREAT for block devices
21586 Since Linux 2.6 there is a possibility to use O_EXCL without
21587 O_CREAT. See patch: http://lkml.org/lkml/2003/8/10/221.
21588
21589 pread.2
21590 Michael Kerrisk
21591 Add notes on pread64() and pwrite64()
21592 See https://bugzilla.kernel.org/show_bug.cgi?id=23072
21593 Michael Kerrisk
21594 SEE ALSO: add readv(3)
21595
21596 readv.2
21597 Michael Kerrisk
21598 Wording fix: readv() and writev() are system calls, not functions
21599
21600 sendfile.2
21601 Michael Kerrisk
21602 Add notes on sendfile64()
21603
21604 setfsgid.2
21605 Michael Kerrisk
21606 Add NOTES explaining 32-bit system calls added in Linux 2.4
21607
21608 setfsuid.2
21609 Michael Kerrisk
21610 Add NOTES explaining 32-bit system calls added in Linux 2.4
21611
21612 setgid.2
21613 Michael Kerrisk
21614 Add NOTES explaining 32-bit system calls added in Linux 2.4
21615
21616 setresuid.2
21617 Michael Kerrisk
21618 Add NOTES explaining 32-bit system calls added in Linux 2.4
21619
21620 setreuid.2
21621 Michael Kerrisk
21622 Add NOTES explaining 32-bit system calls added in Linux 2.4
21623
21624 setuid.2
21625 Michael Kerrisk
21626 Add NOTES explaining 32-bit system calls added in Linux 2.4
21627
21628 sigqueue.2
21629 pthreads.7
21630 signal.7
21631 Michael Kerrisk
21632 SEE ALSO: Add pthread_sigqueue(3)
21633
21634 stat.2
21635 Michael Kerrisk
21636 Fix EOVERFLOW error description
21637 2<<31 should read 1<<31 (which equals 2^31).
21638
21639 statfs.2
21640 Michael Kerrisk
21641 Add notes on statfs64() and fstatfs64()
21642
21643 swapon.2
21644 Hugh Dickins
21645 Document SWAP_FLAG_DISCARD and discarding of swap pages
21646
21647 truncate.2
21648 Michael Kerrisk
21649 Add notes on truncate64() and ftruncate64()
21650
21651 memcpy.3
21652 Michael Kerrisk
21653 Change "should not overlap" to "must not overlap"
21654 glibc 2.12 changed things so that applications that use memcpy() on
21655 overlapping regions will encounter problems. (The standards have
21656 long said that the behaviors is undefined if the memory areas
21657 overlap.)
21658
21659 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=603144
21660 In reference of http://lwn.net/Articles/414467/
21661 and http://article.gmane.org/gmane.comp.lib.glibc.alpha/15278
21662
21663 usleep.3
21664 Petr Uzel
21665 usleep() suspends calling thread, not process
21666
21667 core.5
21668 Michael Kerrisk
21669 Change single quote to double quote in shell session example
21670 The example section has a sample shell session containing:
21671
21672 echo '|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s'
21673
21674 But $PWD won't be expanded in single quotes. It should be double
21675 quotes around the entire argument or some other form.
21676
21677 pthreads.7
21678 Michael Kerrisk
21679 Added description of async-cancel-safe functions
21680
21681 unix.7
21682 Michael Kerrisk
21683 Reworded the text of various errors
21684 Michael Kerrisk
21685 Added ENOENT error
21686
21687
21688 ==================== Changes in man-pages-3.33 ====================
21689
21690 Released: 2011-09-16, Munich
21691
21692
21693 Contributors
21694 ------------
21695
21696 The following people contributed patches/fixes or (noted in brackets
21697 in the changelog below) reports, notes and ideas that have been
21698 incorporated in changes in this release:
21699
21700 Akira Fujita <a-fujita@rs.jp.nec.com>
21701 Alexander Schuch <Alex.Schuch@gmx.de>
21702 Andries Brouwer <Andries.Brouwer@cwi.nl>
21703 Brian M. Carlson <sandals@crustytoothpaste.net>
21704 Dan Jacobson <jidanni@jidanni.org>
21705 Folkert van Heusden <folkert.mobiel@gmail.com>
21706 Graham Gower <graham.gower@gmail.com>
21707 Hendrik Jan Thomassen <hjt@atcomputing.nl>
21708 Jan Engelhardt <jengelh@medozas.de>
21709 Joey Adams <joeyadams3.14159@gmail.com>
21710 Johannes Laire <johannes@laire.fi>
21711 Jon Grant <jg@jguk.org>
21712 Josh Triplett <josh@joshtriplett.org>
21713 Konstantin Ritt <ritt.ks@gmail.com>
21714 Luis Javier Merino <ninjalj@gmail.com>
21715 Michael Kerrisk <mtk.manpages@gmail.com>
21716 Mike Frysinger <vapier@gentoo.org>
21717 Mikel Ward <mikel@mikelward.com>
21718 Nick Black <dankamongmen@gmail.com>
21719 Paul Evans <leonerd@leonerd.org.uk>
21720 Petr Pisar <ppisar@redhat.com>
21721 Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
21722 Regid Ichira <regid23@yahoo.com>
21723 Reuben Thomas <rrt@sc3d.org>
21724 Richard B. Kreckel <kreckel@ginac.de>
21725 Ryan Mullen <rmmullen@gmail.com>
21726 Sebastian Geiger <sbastig@gmx.net>
21727 Sebastian Unger <sebunger@gmx.net>
21728 Seonghun Lim <wariua@gmail.com>
21729 Serge E. Hallyn <serge.hallyn@canonical.com>
21730 Simon Cross <hodgestar@gmail.com>
21731 Simon Paillard <spaillard@debian.org>
21732 Stan Sieler <sieler@me.com>
21733 Timmy Lee <scuttimmy@gmail.com>
21734 Tolga Dalman <tolga.dalman@googlemail.com>
21735 Tomislav Jonjic <jonjic@cs.unibo.it>
21736 Yuri Kozlov <yuray@komyakino.ru>
21737 Wei Luosheng <weiluosheng001@gmail.com>
21738
21739 Apologies if I missed anyone!
21740
21741
21742 Newly documented interfaces in existing pages
21743 ---------------------------------------------
21744
21745 sync.2
21746 Michael Kerrisk
21747 Added new syncfs() system call
21748 syncfs() was added in Linux 2.6.39.
21749
21750
21751 New and changed links
21752 ---------------------
21753
21754 syncfs.2
21755 Michael Kerrisk
21756 New link for sync(2).
21757
21758
21759 Global changes
21760 --------------
21761
21762 Various pages
21763 Simon Paillard
21764 Global fix: properly escape minus sign
21765
21766
21767 Changes to individual pages
21768 ---------------------------
21769
21770 clone.2
21771 Michael Kerrisk
21772 Note that CLONE_STOPPED was removed in 2.6.38
21773
21774 execve.2
21775 Michael Kerrisk [Sebastian Geiger]
21776 Note that the first argv[] value should contain name of executable
21777
21778 fcntl.2
21779 Michael Kerrisk [Reuben Thomas]
21780 Note that F_GETFL also retrieves file access mode
21781
21782 getrlimit.2
21783 Michael Kerrisk [Ryan Mullen]
21784 Remove mention of kernel versions in discussion of RLIMIT_CPU
21785 Michael Kerrisk [Seonghun Lim]
21786 Fix example program and add _FILE_OFFSET_BITS requirement
21787
21788 mlock.2
21789 Michael Kerrisk [Brian M. Carlson]
21790 Clarify EINVAL error
21791 See http://bugs.debian.org/cgi-bin/bugreport.cgi?625747
21792 Michael Kerrisk [Seonghun Lim]
21793 Simplify and correct text for EPERM error
21794
21795 mprotect.2
21796 Seonghun Lim
21797 Fix off-by-one error in a memory range
21798 Seonghun Lim
21799 Fix small bug in example program
21800 The description of the example program says that it makes the
21801 third page "read-only". Thus use PROT_READ instead of PROT_NONE.
21802
21803 open.2
21804 Folkert van Heusden
21805 Remove text describing O_CLOEXEC as Linux-specific
21806 O_CLOEXEC is specified in POSIX.1-2008, as noted
21807 elsewhere in the page.
21808
21809 readlink.2
21810 Michael Kerrisk [Dan Jacobson]
21811 SEE ALSO: Add readlink(1)
21812
21813 sendfile.2
21814 Akira Fujita
21815 Since 2.6.33, 'out_fd' can refer to any file type
21816 Linux kernel commit cc56f7de7f00d188c7c4da1e9861581853b9e92f
21817 meant sendfile(2) can work with any output file.
21818 Michael Kerrisk
21819 Shift text on falling back to read()/write() to NOTES
21820 Michael Kerrisk [Tolga Dalman]
21821 Remove mention of kernel version for 'in_fd' argument
21822 Tolga Dalman
21823 Add an explicit reference to splice(2)
21824 Unlike sendfile(), splice() can transfer data
21825 between a pair of sockets.
21826
21827 sigaction.2
21828 Michael Kerrisk [Tolga Dalman]
21829 Add a little info about ucontext_t
21830
21831 stat.2
21832 Michael Kerrisk [Jon Grant]
21833 Small rewording of ENAMETOOLONG error
21834
21835 sync.2
21836 Michael Kerrisk
21837 Some rewrites to description of sync()
21838
21839 syscalls.2
21840 Michael Kerrisk
21841 Added fanotify_init() and fanotify_mark() to syscall list
21842 Michael Kerrisk
21843 Added new 2.6.39 system calls
21844 Michael Kerrisk
21845 Updated for Linux 3.0 system calls
21846 Michael Kerrisk
21847 Update kernel version at head of syscall list
21848 Michael Kerrisk
21849 Update to mention 3.x kernel series
21850
21851 syslog.2
21852 Michael Kerrisk [Serge E. Hallyn]
21853 Update for kernel 2.6.37 changes
21854 Document /proc/sys/kernel/dmesg_restrict.
21855 Document CAP_SYSLOG.
21856
21857 time.2
21858 Michael Kerrisk [Alexander Schuch]
21859 NOTES: Fix description of "Seconds since the Epoch"
21860
21861 timerfd_create.2
21862 Michael Kerrisk [Josh Triplett]
21863 Note behavior when timerfd_settime() old_value is NULL
21864 See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
21865 Tomislav Jonjic
21866 Fix small error in description of timerfd_settime()
21867
21868 truncate.2
21869 Seonghun Lim
21870 Remove redundant EINTR description
21871
21872 unlink.2
21873 Hendrik Jan Thomassen
21874 Improve EBUSY description
21875
21876 cacos.3
21877 cacosh.3
21878 catan.3
21879 catanh.3
21880 Michael Kerrisk [Richard B. Kreckel, Andries Brouwer]
21881 Fix formula describing function
21882 The man pages for cacos(), cacosh(), catan(), catanh()
21883 contain incorrect formulae describing the functions.
21884
21885 cacos.3
21886 Michael Kerrisk
21887 Add example program
21888
21889 cacosh.3
21890 Michael Kerrisk
21891 Add example program
21892
21893 cacosh.3
21894 casinh.3
21895 catan.3
21896 catanh.3
21897 Michael Kerrisk
21898 SEE ALSO: Add reference to inverse function
21899
21900 catan.3
21901 Michael Kerrisk
21902 Add example program
21903
21904 catanh.3
21905 Michael Kerrisk
21906 Add example program
21907
21908 ccos.3
21909 ccosh.3
21910 csin.3
21911 csinh.3
21912 ctan.3
21913 ctanh.3
21914 Michael Kerrisk
21915 SEE ALSO Add reference to "arc" inverse function
21916
21917 cexp.3
21918 Michael Kerrisk
21919 SEE ALSO: add cexp(3)
21920
21921 clog.3
21922 Michael Kerrisk
21923 SEE ALSO: Add reference to clog(2)
21924
21925 crypt.3
21926 Michael Kerrisk [Jan Engelhardt]
21927 Fix header file and feature test macro requirements for crypt_r()
21928
21929 err.3
21930 Seonghun Lim
21931 Clean up description of error message source
21932 In the second paragraph of DESCRIPTION section, one of the
21933 sources of error messages is incorrect: the four functions obtain
21934 error message only from errno, and "a code" is just relevant
21935 with errc() and warnc(), which are not present on Linux.
21936 see http://www.unix.com/man-page/freebsd/3/ERR/ .
21937
21938 Then, the third paragraph becomes a duplicate.
21939
21940 fflush.3
21941 Regid Ichira
21942 Fix wording error
21943 See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021
21944
21945 hsearch.3
21946 Seonghun Lim
21947 Update ERRORS section
21948 EINVAL can occur for hdestroy_r().
21949 EINVAL can't occur for hcreate().
21950 Other minor fixes.
21951
21952 lockf.3
21953 Michael Kerrisk [Mikel Ward]
21954 ERRORS: EBADF can also occur for nonwritable file descriptor
21955 As noted in the DESCRIPTION, the file descriptor must be writable
21956 in order to place a lock.
21957
21958 malloc.3
21959 Seonghun Lim
21960 Reorder prototypes in SYNOPSIS
21961 calloc() comes before realloc() in the other sections,
21962 so should do in SYNOPSIS, too.
21963
21964 mbstowcs.3
21965 Michael Kerrisk
21966 SEE ALSO: add reference to wcstombs(3)
21967
21968 memcmp.3
21969 Michael Kerrisk [Sebastian Unger]
21970 Clarify that comparison interprets bytes as "unsigned char"
21971
21972 realpath.3
21973 Michael Kerrisk [Seonghun Lim]
21974 Fix EINVAL error
21975 Since glibc 2.3, resolved_path can be non-NULL (with the
21976 semantics already documented in the page).
21977
21978 scandir(3)
21979 Mike Frysinger
21980 Add ENOENT/ENOTDIR errors
21981
21982 siginterrupt.3
21983 Michael Kerrisk [Luis Javier Merino]
21984 Remove misleading sentence about signal(2) and system call interruption
21985
21986 strlen.3
21987 Michael Kerrisk [Jon Grant]
21988 SEE ALSO: Add strnlen(3)
21989
21990 strnlen.3
21991 Michael Kerrisk [Jon Grant]
21992 CONFORMING TO: Note that strnlen() is in POSIX.1-2008
21993
21994 strtoul.3
21995 Michael Kerrisk [Tolga Dalman]
21996 Fix NOTES section constants
21997
21998 termios.3
21999 Michael Kerrisk
22000 Use "terminal special characters" consistently throughout page
22001 Michael Kerrisk [Paul Evans]
22002 Add documentation of _POSIX_VDISABLE
22003 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=627841
22004 Michael Kerrisk
22005 Add a description of STATUS character
22006 Michael Kerrisk
22007 Added description of SWTCH character
22008 Michael Kerrisk
22009 Add names of terminal special characters
22010 Michael Kerrisk
22011 List terminal special characters in alphabetical order
22012
22013 wcstombs.3
22014 Michael Kerrisk
22015 SEE ALSO: add mbstowcs(3)
22016
22017 console_codes.4
22018 Petr Pisar
22019 Add ESC [ 3 J
22020 Linux 3.0 (commit f8df13e0a901fe55631fed66562369b4dba40f8b)
22021 implements \E[3J to allow scrambling content of console
22022 including scroll-back buffer
22023 (http://thread.gmane.org/gmane.linux.kernel/1125792).
22024
22025 proc.5
22026 Michael Kerrisk [Stan Sieler]
22027 Add description of 'PPid' field of /proc/PID/status
22028 Michael Kerrisk [Stan Sieler]
22029 Add description of 'SigQ' field of /proc/PID/status
22030
22031 capabilities.7
22032 Michael Kerrisk [Serge E. Hallyn]
22033 Document CAP_SYSLOG and related changes in Linux 2.6.37
22034 Michael Kerrisk
22035 File capabilities are no longer optional
22036 Starting with Linux 2.6.33, the CONFIG_SECURITY_FILE_CAPABILITIES
22037 has been removed, and file capabilities are always part of the
22038 kernel.
22039
22040 complex.7
22041 Michael Kerrisk
22042 Updated SEE ALSO list to include all complex math functions
22043
22044 ipv6.7
22045 Michael Kerrisk [Simon Cross]
22046 Fix description of address notation: "8 4-digit hexadecimal numbers"
22047
22048 signal.7
22049 Seonghun Lim
22050 Remove crufty repeated info about LinuxThreads
22051
22052 unix.7
22053 Michael Kerrisk
22054 Add pointer to cmsg(3) for an example of the use of SCM_RIGHTS
22055
22056
22057 ==================== Changes in man-pages-3.34 ====================
22058
22059 Released: 2011-09-23, Munich
22060
22061
22062 Contributors
22063 ------------
22064
22065 The following people contributed patches/fixes or (noted in brackets
22066 in the changelog below) reports, notes and ideas that have been
22067 incorporated in changes in this release:
22068
22069 Alan Curry <pacman@kosh.dhis.org>
22070 Benjamin Poirier <benjamin.poirier@gmail.com>
22071 Brian M. Carlson <sandals@crustytoothpaste.net>
22072 David Howells <dhowells@redhat.com>
22073 David Prévot <taffit@debian.org>
22074 Denis Barbier <bouzim@gmail.com>
22075 Doug Goldstein <cardoe@cardoe.com>
22076 Eric Blake <eblake@redhat.com>
22077 Guillem Jover <guillem@hadrons.org>
22078 Jon Grant <jg@jguk.org>
22079 Michael Kerrisk <mtk.manpages@gmail.com>
22080 Neil Horman <nhorman@tuxdriver.com>
22081 Paul Pluzhnikov <ppluzhnikov@google.com>
22082 Reuben Thomas <rrt@sc3d.org>
22083 Stefan Puiu <stefan.puiu@gmail.com>
22084 Stephan Mueller <stephan.mueller@atsec.com>
22085 Stephen Cameron <scameron@beardog.cce.hp.com>
22086 Sunil Mushran <sunil.mushran@oracle.com>
22087
22088 Apologies if I missed anyone!
22089
22090
22091 New and rewritten pages
22092 -----------------------
22093
22094 rt_sigqueueinfo.2
22095 Michael Kerrisk [Stephan Mueller]
22096 New page for rt_sigqueueinfo(2) and rt_tgsigqueueinfo(2)
22097 This replaces the previous '.so' man page link file for
22098 rt_sigqueueinfo.2, which linked to this sigqueue() man page.
22099
22100 cciss.4
22101 Stephen M. Cameron
22102 New man page for cciss driver
22103 I obtained the information in this man page as a consequence
22104 of having worked on the cciss driver for the past several years,
22105 and having written considerable portions of it.
22106 Michael Kerrisk
22107 Copyedit by mtk
22108
22109 hpsa.4
22110 Stephen M. Cameron
22111 New man page for the hpsa driver
22112 I obtained the information in this man page as a consequence
22113 of being the main author of the hpsa driver.
22114 Michael Kerrisk
22115 Copyedits my mtk
22116
22117
22118 Newly documented interfaces in existing pages
22119 ---------------------------------------------
22120
22121 fstatat.2
22122 Michael Kerrisk [David Howells]
22123 Document AT_NO_AUTOMOUNT
22124 This flag was added in Linux 2.6.38.
22125
22126 lseek.2
22127 Michael Kerrisk [Eric Blake, Sunil Mushran]
22128 Document SEEK_HOLE and SEEK_DATA
22129 These flags, designed for discovering holes in a file,
22130 were added in Linux 3.1. Included comments from Eric
22131 Blake and Sunil Mushran.
22132
22133 madvise.2
22134 Doug Goldstein
22135 Add MADV_HUGEPAGE and MADV_NOHUGEPAGE
22136 Document the MADV_HUGEPAGE and MADV_NOHUGEPAGE flags added to
22137 madvise() in Linux 2.6.38.
22138
22139
22140 New and changed links
22141 ---------------------
22142
22143 rt_tgsigqueueinfo.2
22144 Michael Kerrisk
22145 New link to new rt_sigqueueinfo.2 page
22146
22147 sigqueue.2
22148 Michael Kerrisk
22149 Create link to page that was relocated to section 3
22150
22151
22152 Global changes
22153 --------------
22154
22155 Various pages
22156 Michael Kerrisk
22157 Change reference to "sigqueue(2)" to "sigqueue(3)"
22158
22159
22160 Changes to individual pages
22161 ---------------------------
22162
22163 fallocate.2
22164 Michael Kerrisk
22165 ERRORS: Add EPERM and ESPIPE errors
22166
22167 lseek.2
22168 Michael Kerrisk [Alan Curry, Reuben Thomas]
22169 Remove suspect note about 'whence' being incorrect English
22170
22171 prctl.2
22172 Paul Pluzhnikov
22173 PR_SET_DUMPABLE makes process non-ptrace-attachable
22174
22175 readlink.2
22176 Guillem Jover
22177 Document using st_size to allocate the buffer
22178 Michael Kerrisk
22179 Added copyright text + changelog note for Guillem Jover's patch
22180
22181 sched_setscheduler.2
22182 Michael Kerrisk
22183 Document 2.6.39 changes to rules governing changes from SCHED_IDLE policy
22184 Since Linux 2.6.39, unprivileged processes under the
22185 SCHED_IDLE policy can switch to another nonrealtime
22186 policy if their nice value falls within the range
22187 permitted by their RLIMIT_NICE limit.
22188
22189 tkill.2
22190 Michael Kerrisk
22191 SEE ALSO: Add rt_sigqueueinfo (2)
22192
22193 btowc.3, wctob.3
22194 Michael Kerrisk [Brian M. Carlson]
22195 Add pointers to better, thread-safe alternative functions
22196 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=606899
22197
22198 fwide.3
22199 Michael Kerrisk
22200 Add _ISOC95_SOURCE to feature test macro requirements
22201 Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22202 prototype of this function.
22203
22204 index.3
22205 Michael Kerrisk [Jon Grant]
22206 Fix text mentioning terminating null
22207
22208 pthread_sigqueue.3
22209 Michael Kerrisk
22210 Replace explicit mention of rt_tgsigqueueinfo() with SEE ALSO reference
22211
22212 sigqueue.3
22213 Michael Kerrisk
22214 Move this page to section 3
22215 Now that the underlying system call rt_sigqueueinfo(2) is
22216 properly documented, move sigqueue() to Section 3, since
22217 it is really a library function.
22218 Michael Kerrisk
22219 Update text in line with existence of new rt_sigqueueinfo.2 page
22220
22221 wcsnlen.3
22222 Jon Grant
22223 Improve description of 'maxlen' argument
22224 It's worth clarifying 'maxlen' is in wide-char units, not bytes.
22225
22226 wprintf.3
22227 Michael Kerrisk
22228 Add _ISOC95_SOURCE to feature test macro requirements
22229 Since glibc 2.12, _ISOC95_SOURCE can also be used to expose
22230 prototype of these functions.
22231
22232 feature_test_macros.7
22233 Michael Kerrisk
22234 Document _ISOC95_SOURCE
22235 _ISOC95_SOURCE was added in glibc 2.12 as a means
22236 to expose C90 Amendment 1 definitions.
22237
22238 ip.7
22239 Benjamin Poirier [Neil Horman]
22240 Improve description of IP_MTU_DISCOVER
22241
22242 signal.7
22243 Michael Kerrisk
22244 SEE ALSO: Add rt_sigqueueinfo(2)
22245
22246
22247 ==================== Changes in man-pages-3.35 ====================
22248
22249 Released: 2011-10-04, Munich
22250
22251
22252 Contributors
22253 ------------
22254
22255 The following people contributed patches/fixes or (noted in brackets
22256 in the changelog below) reports, notes and ideas that have been
22257 incorporated in changes in this release:
22258
22259 Andi Kleen <andi@firstfloor.org>
22260 David Prévot <taffit@debian.org>
22261 Denis Barbier <bouzim@gmail.com>
22262 Eric W. Biederman <ebiederm@xmission.com>
22263 Guillem Jover <guillem@hadrons.org>
22264 Jon Grant <jg@jguk.org>
22265 Kevin Lyda <kevin@ie.suberic.net>
22266 Michael Kerrisk <mtk.manpages@gmail.com>
22267 Mike Frysinger <vapier@gentoo.org>
22268 Reuben Thomas <rrt@sc3d.org>
22269
22270 Apologies if I missed anyone!
22271
22272
22273 New and rewritten pages
22274 -----------------------
22275
22276 recvmmsg.2
22277 Andi Kleen, Michael Kerrisk
22278 New man page for recvmmsg(2)
22279
22280 setns.2
22281 Eric W. Biederman
22282 New manual page for setns(2)
22283 Michael Kerrisk
22284 Various improvements
22285
22286
22287 Global changes
22288 --------------
22289
22290 Various pages
22291 Michael Kerrisk
22292 Global fix: remove spaces around em-dash
22293 Normal English typographical convention is not to have
22294 spaces around em dashes.
22295
22296 Various pages
22297 Michael Kerrisk
22298 Global fix: s/null pointer/NULL pointer/
22299
22300 Various pages
22301 Michael Kerrisk
22302 Global fix: use ORing
22303 Use "ORing", not "OR'ing", nor an italic ".IR OR ing".
22304
22305 Various pages
22306 Michael Kerrisk
22307 Global fix: consistent use of "null wide character"
22308 Bring more consistency to the discussion of
22309 "[terminating] null wide character"
22310 by writing (at least in the initial use in a page)
22311 "[terminating] null wide character (L'\0')".
22312
22313 Various pages
22314 Michael Kerrisk
22315 Global fix: consistent use of "null byte"
22316 Bring more consistency to the discussion of
22317 "[terminating] null byte"
22318 by writing (at least in the initial use in a page)
22319 "[terminating] null byte ('\0')".
22320
22321 mount.2, prctl.2
22322 Michael Kerrisk
22323 s/task/thread/ for consistency with other pages
22324
22325
22326 Changes to individual pages
22327 ---------------------------
22328
22329 lseek.2
22330 Guillem Jover
22331 CONFORMING TO: Note other systems that have SEEK_HOLE+SEEK_DATA
22332
22333 recv.2
22334 Michael Kerrisk
22335 Add mention of recvmmsg(2)
22336
22337 recvmmsg.2
22338 Michael Kerrisk
22339 SEE ALSO: add sendmmsg(2)
22340
22341 send.2
22342 Michael Kerrisk
22343 CONFORMING TO: POSIX.1-2008 adds MSG_NOSIGNAL
22344
22345 sigwaitinfo.2
22346 Michael Kerrisk
22347 Note that attempts to wait for SIGKILL and SIGSTOP are silently ignored
22348
22349 stat.2
22350 Michael Kerrisk
22351 Note POSIX.1-2001 and POSIX.1-2008 requirements for lstat()
22352 Michael Kerrisk
22353 Regarding automounter action, add a reference to fstatat(2)
22354 Michael Kerrisk
22355 Clean up text describing which POSIX describes S_IF* constants
22356
22357 aio_cancel.3
22358 Michael Kerrisk [Jon Grant]
22359 Clarify meaning of "return status" and "error status"
22360
22361 gets.3
22362 Michael Kerrisk
22363 POSIX.1-2008 marks gets() obsolescent
22364 The page formerly erroneously stated that POSIX.1-2008
22365 removed the specification of this function.
22366
22367 mbsnrtowcs.3
22368 Michael Kerrisk
22369 CONFORMING TO: Add POSIX.1-2008
22370 This function is specified in the POSIX.1-2008 revision.
22371
22372 regex.3
22373 Michael Kerrisk [Reuben Thomas]
22374 Change "terminating null" to "terminating null byte"
22375
22376 stpcpy.3
22377 stpncpy.3
22378 Mike Frysinger
22379 Note that these functions are in POSIX.1-2008
22380 Update the "CONFORMING TO" sections of these functions to
22381 note that they are now part of the POSIX.1-2008 standard.
22382
22383 stpncpy.3
22384 Michael Kerrisk
22385 Change "terminating null" to "terminating null byte"
22386
22387 strcpy.3
22388 Mike Frysinger
22389 SEE ALSO: Add stpncpy(3)
22390
22391 strdup.3
22392 Michael Kerrisk
22393 CONFORMING TO: strndup() is in POSIX.1-2008
22394
22395 wcpcpy.3
22396 wcpncpy.3
22397 wcsnlen.3
22398 wcsnrtombs.3
22399 Michael Kerrisk
22400 CONFORMING TO: Add POSIX.1-2008
22401 These functions are specified in the POSIX.1-2008 revision.
22402
22403 proc.5
22404 Eric W. Biederman
22405 Document /proc/[pid]/ns/
22406 Michael Kerrisk
22407 Some edit's to Eric Biederman's /proc/[pid]/ns/ additions
22408
22409 capabilities.7
22410 Michael Kerrisk
22411 List setns(2) as an operation allowed by CAP_SYS_ADMIN
22412
22413
22414 ==================== Changes in man-pages-3.36 ====================
22415
22416 Released: 2012-02-27, Christchurch
22417
22418
22419 Contributors
22420 ------------
22421
22422 The following people contributed patches/fixes or (noted in brackets
22423 in the changelog below) reports, notes and ideas that have been
22424 incorporated in changes in this release:
22425
22426 Alain Benedetti <alainb06@free.fr>
22427 carado <carado@savhon.org>
22428 Christoph Hellwig <hch@lst.de>
22429 Clemens Ladisch <clemens@ladisch.de>
22430 David Prévot <taffit@debian.org>
22431 Elie De Brauwer <eliedebrauwer@gmail.com>
22432 Guillem Jover <guillem@hadrons.org>
22433 Jessica McKellar <jesstess@mit.edu>
22434 Josef Bacik <josef@redhat.com>
22435 Junjiro Okajima <jro@mx3.ttcn.ne.jp>
22436 Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
22437 Michael Kerrisk <mtk.manpages@gmail.com>
22438 Mike Frysinger <vapier@gentoo.org>
22439 Pat Pannuto <pat.pannuto@gmail.com>
22440 Salvo Tomaselli <tiposchi@tiscali.it>
22441 Simone Piccardi <piccardi@truelite.it>
22442 Slaven Rezic <srezic@iconmobile.com>
22443 starlight <starlight@binnacle.cx>
22444 Stephan Mueller <stephan.mueller@atsec.com>
22445 Vijay Rao <vijay@portuosus.com>
22446 Walter Haidinger <walter.haidinger@gmx.at>
22447 Walter Harms <wharms@bfs.de>
22448 Yang Yang <wdscxsj@gmail.com>
22449
22450 Apologies if I missed anyone!
22451
22452
22453 New and rewritten pages
22454 -----------------------
22455
22456 sendmmsg.2
22457 Michael Kerrisk [Stephan Mueller]
22458 New page for sendmmsg(2)
22459 Some pieces inspired by an initial attempt by Stephan Mueller.
22460
22461
22462 Newly documented interfaces in existing pages
22463 ---------------------------------------------
22464
22465 fallocate.2
22466 Lucian Adrian Grijincu
22467 Document FALLOC_FL_PUNCH_HOLE
22468 FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38,
22469 for punching holes in the allocated space in a file.
22470
22471
22472 Changes to individual pages
22473 ---------------------------
22474
22475 dup.2
22476 Michael Kerrisk
22477 SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
22478
22479 fallocate.2
22480 Michael Kerrisk
22481 Substantial restructuring of DESCRIPTION
22482 The addition of a second class of operation ("hole punching")
22483 to the man page made it clear that some significant restructuring
22484 is required. So I substantially reworked the page, including the
22485 preexisting material on the default "file allocation" operation.
22486 Michael Kerrisk [Josef Bacik]
22487 Add further details for FALLOC_FL_PUNCH_HOLE
22488 Michael Kerrisk
22489 ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE
22490
22491 fork.2
22492 Michael Kerrisk
22493 NOTES: Describe clone() call equivalent to fork()
22494
22495 fsync.2
22496 Christoph Hellwig
22497 Various improvements
22498 - explain the situation with disk caches better
22499 - remove the duplicate fdatasync() explanation in the NOTES
22500 section
22501 - remove an incorrect note about fsync() generally requiring two
22502 writes
22503 - remove an obsolete ext2 example note
22504 - fsync() works on any file descriptor (doesn't need to be
22505 writable); correct the EBADF error code explanation
22506 Michael Kerrisk [Guillem Jover]
22507 Note that some systems require a writable file descriptor
22508 An edited version of Guillem Jover's comments:
22509 [While the file descriptor does not need to be writable on Linux]
22510 that's not a safe portable assumption to make on POSIX in general
22511 as that behavior is not specified and as such is
22512 implementation-specific. Some Unix systems do actually fail on
22513 read-only file descriptors, for example [HP-UX and AIX].
22514
22515 mount.2
22516 Michael Kerrisk [Junjiro Okajima]
22517 Removed erroneous statement about MS_RDONLY and bind mounts
22518
22519 open.2
22520 Jessica McKellar
22521 Fix grammar in O_DIRECT description
22522 Some small grammar fixes to the O_DIRECT description.
22523
22524 pipe.2
22525 Michael Kerrisk [Salvo Tomaselli]
22526 SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
22527 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750
22528
22529 sched_rr_get_interval.2
22530 Clemens Ladisch
22531 Update notes on modifying quantum
22532 Since Linux 2.6.24, it is no longer possible to
22533 modify the SCHED_RR quantum using setpriority(2).
22534 (Slight edits to Clemens' patch by mtk.)
22535 Michael Kerrisk
22536 Reordered various pieces of text
22537 Michael Kerrisk
22538 Reworded text of ESRCH error
22539
22540 send.2
22541 Michael Kerrisk
22542 Add mention of sendmmsg(2)
22543
22544 sync.2
22545 Michael Kerrisk [Simone Piccardi]
22546 PROTOTYPE: Fix return type of syncfs()
22547
22548 vfork.2
22549 Michael Kerrisk [starlight]
22550 Clarify what is duplicated in the child
22551 Add some words to make it clear to the reader that vfork(),
22552 like fork(), creates duplicates of process attributes
22553 in the child.
22554 Michael Kerrisk
22555 Note clone() flags equivalent to vfork()
22556 Michael Kerrisk [starlight, Mike Frysinger]
22557 Add some notes on reasons why vfork() still exists
22558 Michael Kerrisk [starlight]
22559 Clarify that calling *thread* is suspended during vfork()
22560 Michael Kerrisk
22561 CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
22562
22563 gets.3
22564 Michael Kerrisk
22565 Document C11 and glibc 2.16 changes affecting gets()
22566
22567 pthread_sigmask.3
22568 Michael Kerrisk [Pat Pannuto]
22569 Fix comment that was inconsistent with code in example program
22570
22571 sem_wait.3
22572 Walter Harms
22573 EXAMPLE: Remove extraneous line of output from shell session
22574
22575 wcsnrtombs.3
22576 wcsrtombs.3
22577 wcstombs.3
22578 Michael Kerrisk
22579 Fix-ups for e9c23bc636426366d659809bc99cd84661e86464
22580
22581 core.5
22582 Michael Kerrisk [Junjiro Okajima]
22583 Document %E specifier for core_pattern
22584
22585 passwd.5
22586 Michael Kerrisk [Walter Haidinger]
22587 s/asterisk/asterisk (*)/ to improve clarity
22588 Michael Kerrisk
22589 Correct note on passwd field value when shadowing is enabled
22590 When password shadowing is enabled, the password field
22591 contains an 'x' (not "*').
22592
22593 proc.5
22594 Elie De Brauwer
22595 Fix description of fourth field of /proc/loadavg
22596 SIgned-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
22597
22598 resolv.conf.5
22599 Michael Kerrisk [Slaven Rezic]
22600 Describe syntax used for comments
22601 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994
22602
22603 feature_test_macros.7
22604 Michael Kerrisk
22605 Document _ISOC11_SOURCE
22606
22607 inotify.7
22608 Michael Kerrisk [Yang Yang]
22609 Note that 'cookie' field is set to zero when unused
22610
22611 man.7
22612 Michael Kerrisk
22613 Various fixes for description of NAME section
22614 As noted by reporter:
22615 * The code sample given for the NAME section is incomplete because
22616 the actual content sample is not given.
22617 * Additionally, the description assumes that the item described is
22618 a command, which need not be the case.
22619 * The command makewhatis is not present on my system; the
22620 documented tool to create the whatis database is called mandb.
22621 * The description on .SH NAME in man(7) should either copy the
22622 relevant paragraph of lexgrog(1) or refer to it.
22623
22624
22625 ==================== Changes in man-pages-3.37 ====================
22626
22627 Released: 2012-03-06, Christchurch
22628
22629
22630 Contributors
22631 ------------
22632
22633 The following people contributed patches/fixes or (noted in brackets
22634 in the changelog below) reports, notes and ideas that have been
22635 incorporated in changes in this release:
22636
22637 Denys Vlasenko <dvlasenk@redhat.com>
22638 Mark R. Bannister <cambridge@users.sourceforge.net>
22639 Michael Kerrisk <mtk.manpages@gmail.com>
22640 Oleg Nesterov <oleg@redhat.com>
22641 Tejun Heo <tj@kernel.org>
22642
22643 Apologies if I missed anyone!
22644
22645
22646 New and rewritten pages
22647 -----------------------
22648
22649 getent.1
22650 Mark R. Bannister
22651 New page to document 'getent' binary provided by glibc
22652
22653
22654 Changes to individual pages
22655 ---------------------------
22656
22657 bdflush.2
22658 Michael Kerrisk
22659 Note that bdflush() is deprecated, and does nothing
22660
22661 nfsservctl.2
22662 Michael Kerrisk
22663 Note that this system call was removed in Linux 3.1
22664
22665 ptrace.2
22666 Denys Vlasenko [Oleg Nesterov, Tejun Heo]
22667 add extended description of various ptrace quirks
22668 Changes include:
22669
22670 s/parent/tracer/g, s/child/tracee/g - ptrace interface now
22671 is sufficiently cleaned up to not treat tracing process
22672 as parent.
22673
22674 Deleted several outright false statements:
22675 - pid 1 can be traced
22676 - tracer is not shown as parent in ps output
22677 - PTRACE_ATTACH is not "the same behavior as if tracee had done
22678 a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
22679 - SIGSTOP _can_ be injected.
22680 - Removed mentions of SunOS and Solaris as irrelevant.
22681 - Added a few more known bugs.
22682
22683 Added a large block of text in DESCRIPTION which doesn't focus
22684 on mechanical description of each flag and operation, but rather
22685 tries to describe a bigger picture. The targeted audience is
22686 a person which is reasonably knowledgeable in Unix but did not
22687 spend years working with ptrace, and thus may be unaware of its
22688 quirks. This text went through several iterations of review by
22689 Oleg Nesterov and Tejun Heo.
22690 This block of text intentionally uses as little markup as possible,
22691 otherwise future modifications to it will be very hard to make.
22692 Michael Kerrisk
22693 Global clean-up of page
22694 * Wording and formatting fixes to existing text and
22695 Denys Vlasenko's new text.
22696 * Various technical amendments and improvements to
22697 Denys Vlasenko's new text.
22698 * Added FIXME for various problems with the current text.
22699 Michael Kerrisk
22700 Integrated changes after further review from Denys Vlasenko
22701
22702 syscalls.2
22703 Michael Kerrisk
22704 Note that nfsservctl(2) was removed in Linux 3.1
22705 Note that bdflush(2) is deprecated
22706
22707 capabilities.7
22708 Michael Kerrisk
22709 Add CAP_WAKE_ALARM
22710 Michael Kerrisk
22711 Add various operations under CAP_SYS_ADMIN
22712 Add perf_event_open(2) to CAP_SYS_ADMIN
22713 Add VM86_REQUEST_IRQ vm86(2) command to CAP_SYS_ADMIN
22714 Update CAP_NET_ADMIN with notes from include/linux/capability.h
22715 Add nfsservctl(2) to CAP_SYS_ADMIN
22716 Michael Kerrisk
22717 Add ioctl(FIBMAP) under CAP_SYS_RAWIO
22718 Michael Kerrisk
22719 Add virtual terminal ioctl()s under CAP_SYS_TTY_CONFIG
22720 Michael Kerrisk
22721 Update CAP_NET_RAW with notes from include/linux/capability.h
22722 Michael Kerrisk
22723 Add F_SETPIPE_SZ case to CAP_SYS_RESOURCE
22724 Add POSIX messages queues queues_max case to CAP_SYS_RESOURCE
22725 Update CAP_SYS_RESOURCE with notes from include/linux/capability.h
22726 Michael Kerrisk
22727 SEE ALSO: Add libcap(3)
22728
22729 ld.so.8
22730 Michael Kerrisk
22731 Add --audit command-line option
22732
22733
22734 ==================== Changes in man-pages-3.38 ====================
22735
22736 Released: 2012-03-25, Christchurch
22737
22738
22739 Contributors
22740 ------------
22741
22742 The following people contributed patches/fixes or (noted in brackets
22743 in the changelog below) reports, notes, and ideas that have been
22744 incorporated in changes in this release:
22745
22746 Akihiro MOTOKI <amotoki@gmail.com>
22747 Artyom Pervukhin <artyom@evasive.ru>
22748 Beňas Petr <xbenas00@stud.fit.vutbr.cz>
22749 Ben Bacarisse <software@bsb.me.uk>
22750 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
22751 David Prévot <david@tilapin.org>
22752 Denis Barbier <bouzim@gmail.com>
22753 Denys Vlasenko <vda.linux@googlemail.com>
22754 Eric Blake <ebb9@byu.net>
22755 Iain Fraser <iainkfraser@gmail.com>
22756 Justin T Pryzby <justinp@norchemlab.com>
22757 Kirill Brilliantov <brilliantov@inbox.ru>
22758 Mark R Bannister <mark@proseconsulting.co.uk>
22759 Matthew Gregan <kinetik@flim.org>
22760 Michael Kerrisk <mtk.manpages@gmail.com>
22761 Nix <nix@esperi.org.uk>
22762 Peter Schiffer <pschiffe@redhat.com>
22763 Sergei Zhirikov <sfzhi@yahoo.com>
22764
22765 Apologies if I missed anyone!
22766
22767
22768 New and rewritten pages
22769 -----------------------
22770
22771 get_nprocs_conf.3
22772 Beňas Petr
22773 New page documenting get_nprocs_conf(3) and get_nprocs(3)
22774 Michael Kerrisk
22775 Some additions and improvements
22776
22777 malloc_get_state.3
22778 Michael Kerrisk
22779 New page documenting malloc_get_state(3) and malloc_set_state(3)
22780
22781 mallopt.3
22782 Michael Kerrisk
22783 New man page for mallopt(3)
22784
22785 mtrace.3
22786 Michael Kerrisk
22787 Complete rewrite of page, adding much more detail
22788
22789 scandirat.3
22790 Mark R Bannister
22791 New page for scandirat(3) (new in glibc 2.15)
22792
22793
22794 Newly documented interfaces in existing pages
22795 ---------------------------------------------
22796
22797 posix_memalign.3
22798 Michael Kerrisk
22799 Document aligned_alloc(3)
22800 aligned_alloc() is new in C11.
22801 Michael Kerrisk
22802 Document pvalloc(3)
22803
22804 qsort.3
22805 Mark R Bannister
22806 Add documentation of qsort_r(3)
22807 Ben Bacarisse
22808 Improvements to Mark R Bannister's qsort_r() patch
22809 Michael Kerrisk
22810 Add VERSIONS section for qsort_r()
22811
22812
22813 New and changed links
22814 ---------------------
22815
22816 aligned_alloc.3
22817 Michael Kerrisk
22818 New link to posix_memalign.3
22819
22820 get_nprocs.3
22821 Beňas Petr
22822 Link to new get_nprocs_conf.3 page
22823
22824 malloc_set_state.3
22825 Michael Kerrisk
22826 Link to new malloc_get_state.3 page
22827
22828 pvalloc.3
22829 Michael Kerrisk
22830 New link to posix_memalign.3
22831
22832
22833 Global changes
22834 --------------
22835
22836 Various pages
22837 Michael Kerrisk
22838 Global formatting fix: balance .nf/.fi pairs
22839
22840 Various pages
22841 Michael Kerrisk
22842 Global fix: place sections in correct order
22843
22844 Various pages
22845 Michael Kerrisk [Justin T Pryzby]
22846 Global fix: Remove duplicated words
22847 Remove instances of duplicate words found using Justin's
22848 grep-fu:
22849
22850 for f in man?/*.[1-9]; do
22851 grep -HE ' ([[:alpha:]]{2,} +)\1' "$f" |
22852 grep -Evw '(proc|hugetlbfs|XXX*|root|long) *\1';
22853 done | grep -E --colo ' ([[:alpha:]]{2,} +)\1'
22854
22855 Various pages
22856 Michael Kerrisk
22857 Correct order of SEE ALSO entries
22858
22859
22860 Changes to individual pages
22861 ---------------------------
22862
22863 futimesat.2
22864 Michael Kerrisk
22865 PROTOTYPE: Correct header file and feature test macro requirements
22866
22867 keyctl.2
22868 Bjarni Ingi Gislason
22869 Strip trailing tabs from source line
22870 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=664688
22871
22872 ptrace.2
22873 Denys Vlasenko
22874 Document PTRACE_GETEVENTMSG for PTRACE_EVENT_EXEC
22875 Denys Vlasenko
22876 Various fixes to recent updates of this page
22877
22878 symlinkat.2
22879 Michael Kerrisk [Eric Blake]
22880 PROTOTYPE: Correct header file
22881
22882 syscalls.2
22883 Michael Kerrisk
22884 Remove unimplemented system calls from main syscall list
22885 The unimplemented system calls are in any case noted lower down
22886 in the page. Also: rearrange the text describing the unimplemented
22887 system calls.
22888 Michael Kerrisk
22889 Note a few system calls that were removed in Linux 2.6
22890 Michael Kerrisk
22891 Add process_vm_readv(2) and process_vm_writev(2)
22892
22893 unlinkat.2
22894 Michael Kerrisk [Eric Blake]
22895 PROTOTYPE: Correct header file
22896 Michael Kerrisk
22897 PROTOTYPE: Add <fcntl.h> for AT_* constants
22898
22899 utimensat.2
22900 Michael Kerrisk
22901 PROTOTYPE: Add <fcntl.h> for AT_* constants
22902
22903 copysign.3
22904 Michael Kerrisk [Tolga Dalman]
22905 DESCRIPTION: Add a couple of examples
22906
22907 malloc.3
22908 Michael Kerrisk
22909 NOTES: Add a short discussion of arenas
22910 Michael Kerrisk
22911 Replace discussion of MALLOC_CHECK_ with pointer to mallopt(3)
22912 Michael Kerrisk
22913 SEE ALSO: Add mtrace(3)
22914 SEE ALSO: add malloc_get_state(3)
22915
22916 posix_memalign.3
22917 Michael Kerrisk
22918 Rename memalign() argument
22919 Rename "boundary" to "alignment" for consistency
22920 with posix_memalign().
22921 Michael Kerrisk
22922 Improve discussion of feature test macros and header files for valloc(3)
22923
22924 rtnetlink.3
22925 Kirill Brilliantov [Sergei Zhirikov]
22926 Fix example code, rta_len assignment should use RTA_LENGTH()
22927 See also http://bugs.debian.org/655088
22928
22929 scandir.3
22930 Mark R Bannister
22931 SEE ALSO: Add scandirat(3)
22932
22933 sigqueue.3
22934 Nix
22935 Remove rt_sigqueueinfo from TH line
22936 rt_sigqueueinfo() now has its own manual page, so should not
22937 be listed in the .TH line of this page.
22938
22939 tzset.3
22940 Peter Schiffer
22941 Correct description for Julian 'n' date format
22942 The Julian 'n' date format counts starting from 0, not 1.
22943 Michael Kerrisk
22944 Add some clarifying remarks to discussion of Julian day formats
22945
22946 packet.7
22947 Michael Kerrisk [Iain Fraser]
22948 Fix comment on 'sll_hatype' field
22949
22950 tcp.7
22951 Michael Kerrisk [Artyom Pervukhin]
22952 Correct RFC for TIME_WAIT assassination hazards
22953
22954
22955 ==================== Changes in man-pages-3.39 ====================
22956
22957 Released: 2012-04-17, Christchurch
22958
22959
22960 Contributors
22961 ------------
22962
22963 The following people contributed patches/fixes or (noted in brackets
22964 in the changelog below) reports, notes, and ideas that have been
22965 incorporated in changes in this release:
22966
22967 Abhijith Das <adas@redhat.com>
22968 Alexander Kruppa <akruppa@gmail.com>
22969 Andreas Jaeger <aj@suse.com>
22970 Armin Rigo <arigo@tunes.org>
22971 Cyrill Gorcunov <gorcunov@openvz.org>
22972 Denys Vlasenko <vda.linux@googlemail.com>
22973 Eric Blake <ebb9@byu.net>
22974 Felix <fkater@googlemail.com>
22975 Jak <jak@gmx.ca>
22976 Jeff Mahoney <jeffm@suse.com>
22977 Jesus Otero <jesus.otero@rysg.es>
22978 Jonathan Nieder <jrnieder@gmail.com>
22979 Kevin O'Gorman <kevinogorman4@gmail.com>
22980 Mark R Bannister <mark@proseconsulting.co.uk>
22981 Michael Kerrisk <mtk.manpages@gmail.com>
22982 Michael Welsh Duggan <mwd@cert.org>
22983 Mike Frysinger <vapier@gentoo.org>
22984 Petr Gajdos <pgajdos@suse.cz>
22985 Regid Ichira <regid23@yahoo.com>
22986 Reuben Thomas <rrt@sc3d.org>
22987 Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
22988 Simone Piccardi <piccardi@truelite.it>
22989 Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
22990 <who@connect.carleton.ca>
22991
22992 Apologies if I missed anyone!
22993
22994
22995 New and rewritten pages
22996 -----------------------
22997
22998 malloc_trim.3
22999 Michael Kerrisk
23000 New man page for malloc_trim(3)
23001
23002 malloc_usable_size.3
23003 Michael Kerrisk
23004 New man page for malloc_usable_size(3)
23005
23006
23007 Newly documented interfaces in existing pages
23008 ---------------------------------------------
23009
23010 prctl.2
23011 Cyrill Gorcunov
23012 Document PR_SET_MM (new in Linux 3.3)
23013 Michael Kerrisk
23014 Various edits and improvements to Cyrill's patch
23015
23016
23017 Changes to individual pages
23018 ---------------------------
23019
23020 epoll_create.2
23021 Michael Kerrisk
23022 Rework discussion of 'size' argument
23023 Michael Kerrisk
23024 Add .SS for description of epoll_create1()
23025
23026 epoll_wait.2
23027 Michael Kerrisk [Armin Rigo]
23028 Another thread can add to epoll instance while epoll_wait is blocked
23029 See https://bugzilla.kernel.org/show_bug.cgi?id=43072
23030 Michael Kerrisk
23031 Clarify that epoll_pwait() blocks calling *thread*
23032 A few wording improvements
23033
23034 fchmodat.2
23035 Michael Kerrisk [Mike Frysinger]
23036 Note difference between glibc wrapper and underlying system call
23037 The wrapper function has a 'flags' argument (which currently
23038 serves no purpose), while the underlying system call does not.
23039
23040 fcntl.2
23041 Abhijith Das
23042 Explain behaviour of F_GETLEASE during lease break
23043 Michael Kerrisk [Eric Blake]
23044 Change type of arg from "long" to "int"
23045 Various fcntl(2) commands require an integral 'arg'.
23046 The man page said it must be "long" in all such cases.
23047 However, for the cases covered by POSIX, there is an
23048 explicit requirement that these arguments be "int".
23049 Update the man page to reflect. Probably, all of the
23050 other "long" cases (not specified in POSIX) should
23051 be "int", and this patch makes them so. Based on a
23052 note fromEric Blake, relating to F_DUPFD_CLOEXEC.
23053
23054 gettimeofday.2
23055 Michael Kerrisk
23056 Reorganize content
23057 The main change is to move the historical information about
23058 the 'tz_dsttime' to NOTES.
23059 Michael Kerrisk [Felix]
23060 Note that compiler issues warnings if 'tv' is NULL
23061
23062 mmap.2
23063 Michael Kerrisk [Kevin O'Gorman]
23064 Clarify that this system call should not be invoked directly
23065 See https://bugzilla.kernel.org/show_bug.cgi?id=42892
23066 Michael Kerrisk
23067 Clarify NOTES discussion of mmap() versus mmap2()
23068
23069 poll.2
23070 Michael Kerrisk [Michael Welsh Duggan]
23071 Document negative value in 'fd' field
23072 Michael Kerrisk
23073 Document semantics of passing zero in 'events' field
23074
23075 ptrace.2
23076 Denys Vlasenko
23077 Various fixes
23078 For some reason, the PTRACE_TRACEME paragraph talks about some
23079 general aspects of ptraced process behavior. It repeats the
23080 "tracee stops on every signal" information even though that was
23081 already explained just a few paragraphs before. Then it describes
23082 legacy SIGTRAP on execve().
23083
23084 This patch deletes the first part, and moves the second part up,
23085 into the general ptrace description. It also adds
23086 "If PTRACE_O_TRACEEXEC option is not in effect" to the description
23087 of the legacy SIGTRAP on execve().
23088
23089 The patch also amends the part which says "For requests other
23090 than PTRACE_KILL, the tracee must be stopped." - PTRACE_ATTACH
23091 also doesn't require that.
23092
23093 sigaction.2
23094 Michael Kerrisk [Andreas Jaeger, ]
23095 Clarify that the use of SI_SIGIO is for Linux 2.2 only
23096 See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745
23097
23098 sigprocmask.2
23099 Mike Frysinger
23100 ERRORS: add EFAULT
23101
23102 times.2
23103 Michael Kerrisk [Simone Piccardi]
23104 ERRORS: Add EFAULT
23105
23106 div.3
23107 Michael Kerrisk [Reuben Thomas]
23108 CONFORMING TO: Add C99
23109
23110 fread.3
23111 Regid Ichira
23112 Clarify further that return value is number of items, not bytes
23113 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=665780
23114
23115 getaddrinfo.3
23116 Michael Kerrisk [Jak]
23117 Correct type of ai_addrlen field
23118
23119 malloc.3
23120 Michael Kerrisk
23121 SEE ALSO: add malloc_usable_size(3)
23122 SEE ALSO: Add malloc_trim(3)
23123
23124 mallopt.3
23125 Michael Kerrisk
23126 Fix text describing M_PERTURB and free()
23127 SEE ALSO: Add malloc_trim(3)
23128
23129 memchr.3
23130 Michael Kerrisk [Reuben Thomas]
23131 Remove mention of terminating null in description of rawmemchr()
23132
23133 perror.3
23134 Michael Kerrisk [Jesus Otero]
23135 Note that use of 'sys_errlist' is deprecated
23136
23137 rcmd.3
23138 Michael Kerrisk
23139 glibc eventually added a declaration of iruserok() in version 2.12
23140
23141 sysconf.3
23142 Michael Kerrisk [Ricardo Catalinas Jiménez]
23143 Add mention of _SC_SYMLOOP_MAX
23144
23145 nologin.5
23146 Michael Kerrisk [Tetsuo Handa]
23147 nologin must not only exist, but *be readable* to be effective
23148
23149 nsswitch.conf.5
23150 Mark R Bannister
23151 Significant rewrites and improvements
23152 This patch applies to nsswitch.conf.5 in man-pages-3.36.
23153
23154 My changes almost completely rewrite large sections of the
23155 man page. They are needed to add clarity, correct grammar,
23156 reduce confusion, and bring up-to-date with the latest glibc.
23157 I have checked the man page against the nss source code in
23158 glibc 2.14.90.
23159
23160 Historical notes are demoted to the footer.
23161
23162 The rewrite makes the man page much clearer to
23163 understand, more authoratitive, and easier to read.
23164 Michael Kerrisk
23165 Light edits to Mark Bannister's changes
23166
23167 capabilities.7
23168 Michael Kerrisk
23169 Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
23170
23171 epoll.7
23172 Michael Kerrisk
23173 Some minor clarifications at start of DESCRIPTION
23174
23175 netlink.7
23176 Jeff Mahoney [Petr Gajdos]
23177 Note cases where nonprivileged users can use netlink multicast groups
23178 See also https://bugzilla.novell.com/show_bug.cgi?id=754611
23179
23180 unix.7
23181 Michael Kerrisk [Tetsuo Handa]
23182 Add a detail on autobind feature
23183
23184 ld.so.8
23185 Jonathan Nieder [Reuben Thomas]
23186 Document effect of hwcaps on search path
23187 Wording by Aurelien Jarno from Debian glibc's r4701 (2011-06-04).
23188
23189 Addresses http://bugs.debian.org/622385
23190
23191
23192 ==================== Changes in man-pages-3.40 ====================
23193
23194 Released: 2012-04-27, Christchurch
23195
23196
23197 Contributors
23198 ------------
23199
23200 The following people contributed patches/fixes or (noted in brackets
23201 in the changelog below) reports, notes, and ideas that have been
23202 incorporated in changes in this release:
23203
23204 Alexey Toptygin <alexeyt@freeshell.org>
23205 Bernhard Walle <bernhard@bwalle.de>
23206 Brian F. G. Bidulock <bidulock@openss7.org>
23207 Brian M. Carlson <sandals@crustytoothpaste.net>
23208 Christopher Yeoh <cyeoh@au1.ibm.com>
23209 Daniel J Blueman <daniel@quora.org>
23210 Eric Blake <eblake@redhat.com>
23211 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
23212 James Hunt <james.hunt@ubuntu.com>
23213 John Sullivan <jsrhbz@kanargh.force9.co.uk>
23214 Jon Grant <jg@jguk.org>
23215 lepton <ytht.net@gmail.com>
23216 Marcel Holtmann <marcel@holtmann.org>
23217 Michael Kerrisk <mtk.manpages@gmail.com>
23218 Mike Frysinger <vapier@gentoo.org>
23219 Petr Baudis <pasky@ucw.cz>
23220 Simon Paillard <spaillard@debian.org>
23221 Stefan Puiu <stefan.puiu@gmail.com>
23222 Ulrich Drepper <drepper@gmail.com>
23223 Vadim Mikhailov <vadim.mikhailov@gmail.com>
23224
23225 Apologies if I missed anyone!
23226
23227
23228 New and rewritten pages
23229 -----------------------
23230
23231 process_vm_readv.2
23232 Mike Frysinger, Christopher Yeoh, Michael Kerrisk
23233 New page for process_vm_readv(2) and process_vm_writev(2)
23234
23235 mcheck.3
23236 Michael Kerrisk
23237 New man page for mcheck(3) and related functions
23238 Also describes mcheck_check_all(3), mcheck_pedantic(3),
23239 and mprobe(3)
23240
23241
23242 Newly documented interfaces in existing pages
23243 ---------------------------------------------
23244
23245 rcmd.3
23246 Michael Kerrisk
23247 Document "_af" variants of these functions
23248 Document rcmd_af(), rresvport_af(), iruserok_af(), ruserok_af().
23249 Also some restructuring and other clarifications.
23250
23251 rexec.3
23252 Michael Kerrisk
23253 Document rexec_af()
23254
23255
23256 New and changed links
23257 ---------------------
23258
23259 iruserok_af.3
23260 rcmd_af.3
23261 rresvport_af.3
23262 ruserok_af.3
23263 Michael Kerrisk
23264 New links to rcmd.3
23265
23266 rexec_af.3
23267 Michael Kerrisk
23268 New link to rexec.3
23269
23270
23271 Changes to individual pages
23272 ---------------------------
23273
23274 clock_getres.2
23275 Michael Kerrisk
23276 Clarify difference between CLOCK_MONOTONIC and CLOCK_MONOTONIC_RAW
23277 Note interactions of these two clocks with discontinuous
23278 adjustments to the system time and NTP/adjtime(2).
23279
23280 fallocate.2
23281 Michael Kerrisk [John Sullivan]
23282 Fix description of ENOSYS and EOPNOTSUP errors
23283 As reported in https://bugzilla.redhat.com/show_bug.cgi?id=680214
23284
23285 fchmodat.2
23286 Michael Kerrisk [Mike Frysinger]
23287 Improve discussion of difference between wrapper and underlying syscall
23288
23289 gettimeofday.2
23290 Michael Kerrisk
23291 gettimeofday() is affected by discontinuous jumps in the system time
23292 Advise reader to use clock_gettime(2), if they need a
23293 monotonically increasing time source.
23294 Michael Kerrisk
23295 SEE ALSO: Add clock_gettime(2)
23296
23297 prctl.2
23298 Michael Kerrisk
23299 Add PR_TASK_PERF_EVENTS_DISABLE and PR_TASK_PERF_EVENTS_ENABLE
23300 Add some basic documentation of these operations, with a pointer to
23301 tools/perf/design.txt for more information.
23302 Michael Kerrisk [Marcel Holtmann]
23303 Amend details of PR_SET_PDEATHSIG
23304
23305 ptrace.2
23306 Michael Kerrisk [Mike Frysinger]
23307 Note SPARC deviation with respect to get/set regs
23308 SPARC reverses the use of 'addr' and 'data' for
23309 PTRACE_GETREGS, PTRACE_GETFPREGS, PTRACE_SETREGS,
23310 and PTRACE_SETFPREGS.
23311
23312 send.2
23313 Stefan Puiu
23314 Document EACCES error case for UDP
23315
23316 sigaction.2
23317 Michael Kerrisk
23318 Remove mention of raise(3) for SI_USER
23319 For a long time now, glibc's raise(3) didn't yield SI_USER
23320 for the signal receiver, so remove mention of raise(3)
23321 here. The user can deduce the details, if needed, by looking
23322 at the recently updated raise(3) page.
23323
23324 aio_cancel.3
23325 Michael Kerrisk [Jon Grant]
23326 Rewrite RETURN VALUE section to be clearer
23327
23328 aio_init.3
23329 Michael Kerrisk [Jon Grant]
23330 Remove extraneous "POSIX" from NAME section
23331
23332 btree.3
23333 dbopen.3
23334 hash.3
23335 mpool.3
23336 recno.3
23337 Michael Kerrisk [Brian M. Carlson]
23338 Note that glibc no longer provides these interfaces
23339 glibc stopped providing these interfaces with v2.2.
23340 Nowadays, the user that finds these pages probably wants
23341 the libdb API, so note this in the page.
23342
23343 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=337581
23344
23345 fopen.3
23346 Michael Kerrisk
23347 BUGS: Note limitation on number of flag characters parsed in 'mode'
23348 Michael Kerrisk
23349 Note that 'c' and 'e' flags are ignored for fdopen()
23350 Determined from reading libio/iofdopen.c.
23351 Michael Kerrisk
23352 Document ",ccs=string" feature of 'mode' for fopen()/freopen()
23353
23354 getgrnam.3
23355 Michael Kerrisk [Ulrich Drepper]
23356 Fix discussion of _SC_GETGR_R_SIZE_MAX
23357 The value is not meant to be a maximum (as was specified in
23358 SUSv3) but an initial guess at the required size
23359 (as specified in SUSv4).
23360
23361 getpwnam.3
23362 Michael Kerrisk [Ulrich Drepper]
23363 Fix discussion of _SC_GETPW_R_SIZE_MAX
23364 The value is not meant to be a maximum (as was specified in
23365 SUSv3) but an initial guess at the required size
23366 (as specified in SUSv4).
23367
23368 malloc.3
23369 mallopt.3
23370 mtrace.3
23371 Michael Kerrisk
23372 SEE ALSO: add mcheck(3)
23373
23374 memchr.3
23375 Michael Kerrisk
23376 Clarify description, omitting mention of "strings" and "characters"
23377 The existing text slipped into talking about characters and
23378 strings, which could mislead readers into thing that, for
23379 example, searches for the byte '\0' are treated specially.
23380 Therefore, rewrite in terms of "bytes" and "memory areas".
23381
23382 At the same time, make a few source file clean-ups.
23383
23384 mkstemp.3
23385 Michael Kerrisk
23386 Add "mkstemps" and "mkostemps" to NAME line
23387
23388 posix_openpt.3
23389 Michael Kerrisk [Vadim Mikhailov]
23390 Add some details on use of the slave pathname
23391 An explicit pointer to ptsname(3) is useful, as is a note
23392 of the fact that the slave device pathname exists only as
23393 long as the master device is held open.
23394
23395 raise.3
23396 Michael Kerrisk
23397 Add some notes on underlying system call that is used
23398
23399 rcmd.3
23400 Michael Kerrisk
23401 Add some details of the rresvport() 'port' argument
23402
23403 resolver.3
23404 Petr Baudis
23405 Note that many options are documented in resolv.conf(5)
23406
23407 scandir.3
23408 Michael Kerrisk [Daniel J Blueman]
23409 Improve EXAMPLE source code: s/0/NULL/ in scandir() call
23410
23411 strchr.3
23412 James Hunt
23413 Explain behavior when searching for '\0'
23414
23415 strerror.3
23416 Eric Blake [Stefan Puiu]
23417 Improve strerror_r() description
23418 POSIX requires that perror() not modify the static storage
23419 returned by strerror(). POSIX 2008 and C99 both require that
23420 strerror() never return NULL (a strerror() that always
23421 returns "" for all inputs is valid for C99, but not for POSIX).
23422
23423 http://sourceware.org/bugzilla/show_bug.cgi?id=12204
23424 documents glibc's change to come into compliance with POSIX
23425 regarding strerror_r() return value. The GNU strerror_r() use
23426 of 'buf' was confusing - I ended up writing a test program that
23427 proves that 'buf' is unused for valid 'errnum', but contains
23428 truncated "unknown message" for out-of-range 'errnum'.
23429
23430 See also http://austingroupbugs.net/view.php?id=382
23431 Bernhard Walle
23432 Correct description of error return for XSI strerror_r()
23433 Michael Kerrisk [Eric Blake]
23434 Note how to use 'errno' to detect errors when calling strerror()
23435 Michael Kerrisk [Jon Grant]
23436 Add an example of the kind of string returned by strerror()
23437
23438 resolv.conf.5
23439 Petr Baudis
23440 Document "single-request" option
23441
23442 inotify.7
23443 Michael Kerrisk
23444 Note buffer size that guarantees being able to read at least one event
23445 James Hunt
23446 Correct description of size of inotify_event structure
23447
23448 iso_8859-1.7
23449 Eugen Dedu
23450 Add "-" for SOFT HYPHEN
23451 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
23452
23453 netdevice.7
23454 Brian F. G. Bidulock
23455 Document some SIOC configuration ioctls
23456 This patch adds common but missing SIOC configuration ioctls to
23457 the netdevice.7 manual pages that are not documented anywhere
23458 else. SIOCSIFPFLAGS and SIOCGIFPFLAGS are linux-specific. Flag
23459 values come from Linux 2.6.25 kernel headers for sockios. The
23460 others are standard BSD ioctls that have always been implemented
23461 by Linux and were verified from inspecting netdevice.c kernel
23462 code.
23463
23464 socket.7
23465 Michael Kerrisk [Alexey Toptygin]
23466 Correct description of SO_BROADCAST
23467
23468 tcp.7
23469 lepton
23470 Correct description for TCP_MAXSEG on modern kernel
23471
23472
23473 ==================== Changes in man-pages-3.41 ====================
23474
23475 Released: 2012-05-11, Christchurch
23476
23477
23478 Contributors
23479 ------------
23480
23481 The following people contributed patches/fixes or (noted in brackets
23482 in the changelog below) reports, notes, and ideas that have been
23483 incorporated in changes in this release:
23484
23485 Akihiro MOTOKI <amotoki@gmail.com>
23486 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
23487 Angelo Borsotti <angelo.borsotti@gmail.com>
23488 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
23489 Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
23490 Casper Dik <Casper.Dik@oracle.com>
23491 David Prévot <taffit@debian.org>
23492 D. Barbier <bouzim@gmail.com>
23493 Eric Blake <eblake@redhat.com>
23494 Hugh Dickins <hughd@google.com>
23495 Ivana Varekova <varekova@redhat.com>
23496 Jakub Jelinek <jakub@redhat.com>
23497 Jan Kara <jack@suse.cz>
23498 Jason Baron <jbaron@redhat.com>
23499 Jean-Michel Vourgère <jmv_deb@nirgal.com>
23500 Jeff Moyer <jmoyer@redhat.com>
23501 Josh Triplett <josh@joshtriplett.org>
23502 Kasper Dupont <kasperd@gmail.com>
23503 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
23504 Lauri Kasanen <curaga@operamail.com>
23505 Mel Gorman <mgorman@suse.de>
23506 Michael Kerrisk <mtk.manpages@gmail.com>
23507 Mike Frysinger <vapier@gentoo.org>
23508 Nick Piggin <npiggin@gmail.com>
23509 Paul Pluzhnikov <ppluzhnikov@google.com>
23510 Petr Baudis <pasky@ucw.cz>
23511 Ralph Corderoy <ralph@inputplus.co.uk>
23512 Rich Felker <bugdal@aerifal.cx>
23513 Simone Piccardi <piccardi@truelite.it>
23514 Simon Paillard <spaillard@debian.org>
23515 Stefan Puiu <stefan.puiu@gmail.com>
23516 Stephen Hemminger <shemminger@vyatta.com>
23517 Vincent Lefevre <vincent@vinc17.net>
23518 Yuri Kozlov <yuray@komyakino.ru>
23519
23520 Apologies if I missed anyone!
23521
23522
23523 New and rewritten pages
23524 -----------------------
23525
23526 get_robust_list.2
23527 Ivana Varekova [Michael Kerrisk]
23528 New page documenting get_robust_list(2) and set_robust_list(2)
23529
23530 mallinfo.3
23531 Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
23532 New page for mallinfo(3)
23533
23534 malloc_info.3
23535 Michael Kerrisk [Jakub Jelinek]
23536 New page for malloc_info(3)
23537
23538 malloc_stats.3
23539 Michael Kerrisk [KOSAKI Motohiro]
23540 New man page for malloc_stats(3)
23541
23542
23543 Newly documented interfaces in existing pages
23544 ---------------------------------------------
23545
23546 madvise.2
23547 Jason Baron
23548 Document MADV_DONTDUMP and MADV_DODUMP
23549
23550
23551 New and changed links
23552 ---------------------
23553
23554 set_robust_list.2
23555 Michael Kerrisk
23556 New link to new get_robust_list.2 page
23557
23558 LIST_ENTRY.3
23559 LIST_HEAD.3
23560 LIST_INIT.3
23561 LIST_INSERT_AFTER.3
23562 LIST_INSERT_HEAD.3
23563 LIST_REMOVE.3
23564 TAILQ_ENTRY.3
23565 TAILQ_HEAD.3
23566 TAILQ_INIT.3
23567 TAILQ_INSERT_AFTER.3
23568 TAILQ_INSERT_HEAD.3
23569 TAILQ_INSERT_TAIL.3
23570 TAILQ_REMOVE.3
23571 CIRCLEQ_ENTRY.3
23572 CIRCLEQ_HEAD.3
23573 CIRCLEQ_INIT.3
23574 CIRCLEQ_INSERT_AFTER.3
23575 CIRCLEQ_INSERT_BEFORE.3
23576 CIRCLEQ_INSERT_HEAD.3
23577 CIRCLEQ_INSERT_TAIL.3
23578 CIRCLEQ_REMOVE.3
23579 Michael Kerrisk
23580 New link to queue.3
23581 The queue(3) page documents these macros, so it makes sense to
23582 have links for the names.
23583
23584 DES_FAILED.3
23585 Michael Kerrisk
23586 New link to des_crypt.3
23587 The des_crypt(3) page documents this macro, so it makes sense
23588 to have a link for the name.
23589
23590 qsort_r.3
23591 Michael Kerrisk
23592 New link to qsort.3
23593 Overlooked to add this link in 3.38, when documentation of
23594 qsort_r() was added to the qsort.3 page.
23595
23596
23597 Global changes
23598 --------------
23599
23600 faccessat.2
23601 fchmodat.2
23602 fchownat.2
23603 fstatat.2
23604 futimesat.2
23605 inotify_init.2
23606 linkat.2
23607 mkdirat.2
23608 mknodat.2
23609 openat.2
23610 readlinkat.2
23611 renameat.2
23612 setns.2
23613 splice.2
23614 symlinkat.2
23615 sync.2
23616 tee.2
23617 unlinkat.2
23618 vmsplice.2
23619 Michael Kerrisk [Lauri Kasanen]
23620 Global fix: note glibc version that added library support
23621
23622 confstr.3
23623 strcasecmp.3
23624 strcat.3
23625 strcmp.3
23626 strcpy.3
23627 strdup.3
23628 strftime.3
23629 strlen.3
23630 strnlen.3
23631 strpbrk.3
23632 strspn.3
23633 strtok.3
23634 strxfrm.3
23635 Michael Kerrisk [Andries E. Brouwer]
23636 Clarify that these functions operate on bytes, not (wide) characters
23637 Change 'character(s)' to 'byte(s)' to make clear that these
23638 functions operate on bytes, not wide / UTF8 characters.
23639 (POSIX uses 'byte(s)' similarly, to make this point.)
23640
23641 icmp.7
23642 ipv6.7
23643 packet.7
23644 raw.7
23645 rtnetlink.7
23646 unix.7
23647 x25.7
23648 Michael Kerrisk
23649 Remove names of constants from NAME line
23650 Some of the sockets/network protocol pages included names of
23651 the corresponding address family constants in the NAME line,
23652 but this wasn't done consistently across all pages, and probably
23653 it adds little value in those pages that did do this. So, remove
23654 these constants from those pages that have them in the NAME
23655 section.
23656
23657
23658 Changes to individual pages
23659 ---------------------------
23660
23661 clock_getres.2
23662 Michael Kerrisk [Josh Triplett]
23663 Expand description of CLOCK_REALTIME
23664 Make it clear that this clock may be discontinuous, and is
23665 affected my incremental NTP and clock-adjtime(2) adjustments.
23666
23667 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872
23668
23669 epoll_wait.2
23670 Michael Kerrisk
23671 Clarify that 'timeout' is a *minimum* interval
23672 Make it clear that 'timeout' is a minimum interval; the actual
23673 interval will be rounded up to the system clock granularity,
23674 and may overrun because of kernel scheduling delays.
23675
23676 execve.2
23677 Michael Kerrisk
23678 Rewording to deemphasize libc5 details
23679
23680 fork.2
23681 Mike Frysinger
23682 ERRORS: add ENOSYS
23683 Can occur on, for example, non-MMU hardware.
23684
23685 getcpu.2
23686 Mike Frysinger
23687 Add RETURN VALUE and ERRORS sections
23688 Michael Kerrisk
23689 Refer reader to NOTES for more info about 'tcache'
23690 Michael Kerrisk
23691 DESCRIPTION: reword a sentence to be clearer
23692
23693 io_cancel.2
23694 io_destroy.2
23695 io_getevents.2
23696 io_setup.2
23697 io_submit.2
23698 Michael Kerrisk
23699 Rewrite to focus on system call API
23700 Rewrite to focus on the system call interface, adding
23701 some notes on the libaio wrapper differences.
23702 See the following mail:
23703 2012-05-07 "aio manuals", linux-man@vger
23704 http://thread.gmane.org/gmane.linux.man/1935/focus=2910
23705
23706 Other minor rewrites.
23707
23708 mount.2
23709 Michael Kerrisk
23710 Comment out an old Linux libc detail
23711
23712 open.2
23713 Nick Piggin [KOSAKI Motohiro, Jan Kara, Hugh Dickins]
23714 Describe race of direct I/O and fork()
23715 Rework 04cd7f64, which didn't capture the details correctly.
23716 See the April/May 2012 linux-man@ mail thread "[PATCH]
23717 Describe race of direct read and fork for unaligned buffers"
23718 http://thread.gmane.org/gmane.linux.kernel.mm/77571
23719
23720 poll.2
23721 Michael Kerrisk
23722 Clarify that 'timeout' is a *minimum* interval
23723 Make it clear that 'timeout' is a minimum interval; the actual
23724 interval will be rounded up to the system clock granularity,
23725 and may overrun because of kernel scheduling delays.
23726 Michael Kerrisk
23727 Clarify discussion of wrapper function emulation
23728 Clarify that glibc (as well as old libc) provides emulation
23729 using select(2) on older kernels that don't have a poll()
23730 system call.
23731 Michael Kerrisk
23732 Make the meaning of a zero timeout explicit
23733 Clarify that timeout==0 causes an immediate return, even if
23734 no file descriptors are ready.
23735
23736 pread.2
23737 Michael Kerrisk [Kasper Dupont]
23738 BUGS: Note O_APPEND + pwrite() does the wrong thing
23739 See https://bugzilla.kernel.org/show_bug.cgi?id=43178
23740
23741 recvmmsg.2
23742 Michael Kerrisk
23743 Clarify that 'timeout' is a *minimum* interval
23744 Make it clear that 'timeout' interval will be rounded up to the
23745 system clock granularity, and may overrun because of kernel
23746 scheduling delays.
23747
23748 select.2
23749 Michael Kerrisk
23750 Clarify that 'timeout' is a *minimum* interval
23751 Make it clear that 'timeout' is a minimum interval; the actual
23752 interval will be rounded up to the system clock granularity,
23753 and may overrun because of kernel scheduling delays.
23754 Michael Kerrisk
23755 Expand description of the self-pipe trick
23756 Michael Kerrisk
23757 Add further details on pselect6() system call that underlies pselect()
23758
23759 semop.2
23760 Michael Kerrisk
23761 Clarify that 'timeout' of semtimedop() is a *minimum* interval
23762 Make it clear that 'timeout' interval will be rounded up to the
23763 system clock granularity, and may overrun because of kernel
23764 scheduling delays.
23765
23766 signal.2
23767 Michael Kerrisk
23768 Note that 'sig_t' requires _BSD_SOURCE
23769 Also remove some old Linux libc details
23770
23771 sigwaitinfo.2
23772 Michael Kerrisk
23773 Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
23774 Make it clear that 'timeout' is a minimum interval; the actual
23775 interval will be rounded up to the system clock granularity,
23776 and may overrun because of kernel scheduling delays.
23777
23778 stat.2
23779 Bjarni Ingi Gislason
23780 Formatting fixes
23781 From "groff -ww" (or "man --warnings=w ..."):
23782
23783 warning: around line 442: table wider than line width
23784
23785 GNU man uses line length of 78.
23786
23787 Use text blocks. Two spaces between sentences or better: start
23788 each sentence in a new line.
23789
23790 syscalls.2
23791 Bjarni Ingi Gislason
23792 Formatting fixes
23793 From "groff -ww ..." (or "man --warnings=w ..."):
23794
23795 warning: around line 157: table wider than line width
23796
23797 Have to use text blocks. Move some text to its correct column.
23798 Split text to two columns to avoid hyphenation.
23799
23800 sysinfo.2
23801 Michael Kerrisk
23802 Remove reference to obsolete libc5
23803
23804 syslog.2
23805 Michael Kerrisk
23806 Remove some details about obsolete Linux libc
23807
23808 aio_cancel.3
23809 aio_error.3
23810 aio_fsync.3
23811 aio_read.3
23812 aio_return.3
23813 aio_suspend.3
23814 aio_write.3
23815 Michael Kerrisk
23816 ERRORS: Add/update ENOSYS error
23817
23818 aio_cancel.3
23819 Michael Kerrisk
23820 Clarify what happens when a request isn't successfully canceled
23821 Michael Kerrisk
23822 Add pointers to aio(7) and sigevent(7)
23823
23824 dbopen.3
23825 Michael Kerrisk
23826 SYNOPSIS: Add header file <fcntl.h>
23827 Upstreamed from Debian, and consistent with FreeBSD
23828 dbopen(3) man page.
23829
23830 fmemopen.3
23831 Michael Kerrisk
23832 Note details of POSIX.1-2008 specification of 'b' in 'mode'
23833 Michael Kerrisk [Rich Felker]
23834 BUGS: fmemopen() doesn't correctly set file position in some cases
23835 If 'mode' is append, but 'size' does not cover a null byte
23836 in 'buf', then fmemopen() incorrectly sets the initial file
23837 position to -1, rather than the next byte after the end of
23838 the buffer.
23839
23840 See http://sourceware.org/bugzilla/show_bug.cgi?id=13151
23841 Michael Kerrisk
23842 BUGS: fmemopen() incorrectly handles size==0 case
23843 If size is zero, fmemopen() fails, This is surprising behavior,
23844 and not specified in POSIX.1-2008.
23845
23846 See http://sourceware.org/bugzilla/show_bug.cgi?id=11216
23847
23848 Reported-by; Alex Shinn <alexshinn@gmail.com>
23849 Michael Kerrisk
23850 BUGS: Note silent ABI change for fmemopen() in glibc 2.9
23851 Michael Kerrisk [Rich Felker]
23852 BUGS: Append mode does not force writes to append
23853 Append mode correctly sets the initial offset but does
23854 not force subsequent writes to append at end of stream.
23855
23856 See http://sourceware.org/bugzilla/show_bug.cgi?id=13152
23857 Michael Kerrisk [Eric Blake]
23858 BUGS: Note inconsistent treatment of 'b' in 'mode'
23859 fopen() permits, for example, both "w+b" and "wb+",
23860 but only the latter is meaningful to fmemopen().
23861
23862 See http://sourceware.org/bugzilla/show_bug.cgi?id=12836
23863
23864 fopencookie.3
23865 Michael Kerrisk [Petr Baudis]
23866 Correct description of return for user-supplied 'write' function
23867 See http://sourceware.org/bugzilla/show_bug.cgi?id=2074
23868
23869 getaddrinfo.3
23870 Jean-Michel Vourgère
23871 Note that AI_ADDRCONFIG is not affected by loopback addresses
23872 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
23873
23874 iconv.3
23875 Michael Kerrisk
23876 Upstream useful NOTE from Debian
23877 Warn the reader that the pointer arguments can't be
23878 interpreted as C style strings. Also, note possible
23879 alignment requirements for the referenced bytes sequences,
23880 Michael Kerrisk
23881 Write a better paragraph introducing iconv() and its arguments
23882
23883 isgreater.3
23884 Michael Kerrisk [Vincent Lefevre]
23885 Clarify that the arguments to these macros must be real-floating
23886 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=609033
23887
23888 lio_listio.3
23889 Michael Kerrisk
23890 Clarify that async notification occurs when *all* I/Os complete
23891
23892 makedev.3
23893 Michael Kerrisk
23894 SYNOPSIS: Correct return types of major() and minor()
23895 See https://bugzilla.redhat.com/show_bug.cgi?id=754188
23896
23897 Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
23898
23899 malloc.3
23900 Michael Kerrisk
23901 SEE ALSO: Add malloc_info(3)
23902
23903 malloc_get_state.3
23904 Michael Kerrisk
23905 Fix wordos in function names in NAME line
23906
23907 mallopt.3
23908 Michael Kerrisk
23909 Fix example program
23910 The example code was a version that was not consistent with
23911 the shell output shown on the page.
23912
23913 Reported-bY: Simon Paillard <spaillard@debian.org>
23914 Michael Kerrisk
23915 Restore accidentally omitted line in shell session
23916 Michael Kerrisk
23917 SEE ALSO: Add malloc_stats(3)
23918
23919 mmap64.3
23920 Michael Kerrisk
23921 Change target of link to mmap.2 (was mmap2.2)
23922 Upstreamed from Red Hat / Fedora
23923
23924 realpath.3
23925 Michael Kerrisk [Casper Dik]
23926 Remove note about Solaris possibly returning a relative path
23927
23928 syslog.3
23929 Michael Kerrisk [Ralph Corderoy]
23930 Document behavior when 'ident' argument to openlog() is NULL
23931 See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096
23932 Michael Kerrisk
23933 Update CONFORMING TO for POSIX.1-2008
23934 POSIX.1-2008 doesn't change any details, but make
23935 that more explicit.
23936
23937 undocumented.3
23938 Michael Kerrisk
23939 Remove some functions that have been documented
23940
23941 sd.4
23942 Michael Kerrisk
23943 Remove reference to nonexistent scsi(4) page
23944 Upstreamed from RedHat / Fedora
23945
23946 sk98lin.4
23947 Michael Kerrisk [Stephen Hemminger]
23948 Note that this driver was removed in 2.6.28
23949 See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020
23950
23951 passwd.5
23952 Michael Kerrisk
23953 Upstream pieces from Red Hat/Fedora
23954 Note mention of empty password field.
23955 Add description of "*NP*" in password field.
23956 Michael Kerrisk
23957 Various minor fixes and improvements
23958
23959 proc.5
23960 Michael Kerrisk
23961 Note that CAP_SYS_ADMIN processes can override file-max
23962 Upstreamed from red Hat / Fedora
23963 Michael Kerrisk
23964 Document /proc/[pid]/cgroup
23965 Upstreamed from Red Hat / Fedora
23966
23967 resolv.conf.5
23968 Michael Kerrisk
23969 Take a Debian improvement into upstream
23970
23971 tzfile.5
23972 Michael Kerrisk
23973 Mention timezone directories in DESCRIPTION
23974 Note that timezone files are usually in /usr/lib/zoneinfo
23975 or /usr/share/zoneinfo.
23976 Michael Kerrisk
23977 Drop SYNOPSIS
23978 The SYNOPSIS doesn't correspond to a user-visible file.
23979 Michael Kerrisk
23980 SEE ALSO: Add pointer to glibc source file timezone/tzfile.h
23981 Michael Kerrisk
23982 SEE ALSO: add tzset(3) and tzselect(8)
23983
23984 ascii.7
23985 Bjarni Ingi Gislason
23986 Indent for "troff" makes table too wide
23987 Fix following from "groff -t -ww ...":
23988
23989 warning: around line 53: table wider than line width
23990
23991 Extra indent for "troff" makes the table look misplaced
23992 (default "ps" output).
23993
23994 cp1251.7
23995 Bjarni Ingi Gislason
23996 table too wide
23997 From "nroff -ww -t ...":
23998
23999 warning: around line 44: table wider than line width
24000
24001 Columns are made narrower (column gutter decreased).
24002
24003 ipv6.7
24004 Stefan Puiu
24005 Add ENODEV error for bind() to link-local IPv6 address
24006
24007 signal.7
24008 Michael Kerrisk [Simone Piccardi]
24009 Clarify that SIGLOST is unused
24010 Michael Kerrisk
24011 Comment out crufty BUGS text on SIGLOST
24012 It must be a very long time since the statement there
24013 about SIGLOST was true. (The text seems to date back to
24014 1996.)
24015 Michael Kerrisk
24016 Update architectures for tables of signal numbers
24017
24018 utf-8.7
24019 Brian M. Carlson
24020 Two clarifications
24021 This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
24022 encoding[0], and it also references RFC 3629 instead of RFC 2279.
24023
24024 [0] In order to have 0xc0, you'd have to have a two-byte encoding
24025 with all the data bits zero in the first byte (and thus only six
24026 bits of data), which would be an ASCII character encoded in the
24027 non-shortest form. Similarly with 0xc1.
24028
24029 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641
24030
24031 ldconfig.8
24032 nscd.8
24033 Michael Kerrisk
24034 Remove path prefix from NAME line
24035 Command names shown in NAME are normally just the basename,
24036 not the full pathname of the command.
24037
24038
24039 ==================== Changes in man-pages-3.42 ====================
24040
24041 Released: 2012-08-14, Konolfingen
24042
24043
24044 Contributors
24045 ------------
24046
24047 The following people contributed patches/fixes or (noted in brackets
24048 in the changelog below) reports, notes, and ideas that have been
24049 incorporated in changes in this release:
24050
24051 Aaron Peschel <aaron.peschel@gmail.com>
24052 Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
24053 Akihiro MOTOKI <amotoki@gmail.com>
24054 Alan Curry <pacman@kosh.dhis.org>
24055 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
24056 Christoph Lameter <cl@linux.com>
24057 Colin McCabe <cmccabe@alumni.cmu.edu>
24058 Daniel Zingaro <daniel.zingaro@utoronto.ca>
24059 David Prévot <taffit@debian.org>
24060 Denys Vlasenko <vda.linux@gmail.com>
24061 Henry Hu <henry.hu.sh@gmail.com>
24062 Herbert Xu <herbert@gondor.apana.org.au>
24063 Jan Engelhardt <jengelh@medozas.de>
24064 Jim Hill <gjthill@gmail.com>
24065 JoonSoo Kim <js1304@gmail.com>
24066 Kalle Olavi Niemitalo <kon@iki.fi>
24067 Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
24068 Michael Kerrisk <mtk.manpages@gmail.com>
24069 Michael S. Tsirkin <mst@redhat.com>
24070 Rasmus Villemoes <Rasmus.Villemoes@decode.is>
24071 Sami Kerola <kerolasa@iki.fi>
24072 Sam Varshavchik <mrsam@courier-mta.com>
24073 Shawn Landden <shawnlandden@gmail.com>
24074 Simon Paillard <spaillard@debian.org>
24075 Tolga Dalman <tolga.dalman@googlemail.com>
24076 Ulrich Drepper <drepper@gmail.com>
24077 Марк Коренберг <socketpair@gmail.com>
24078
24079 Apologies if I missed anyone!
24080
24081
24082 Global changes
24083 --------------
24084
24085 Various pages
24086 Sami Kerola
24087 Global fix: use UR macro where applicable
24088 The syntax .UR http://example.com paired with .UE will create
24089 links which one can interact, if the pager allows that. One
24090 way to see the effect is ask the man(1) command to use browser
24091 display, e.g.:
24092
24093 man -H man7/uri.7
24094
24095 ("\:" is optional groff syntax to permit hyphenless line breaks.)
24096
24097
24098 Changes to individual pages
24099 ---------------------------
24100
24101 ldd.1
24102 Michael Kerrisk
24103 Add security note on untrusted executables
24104 See also http://www.catonmat.net/blog/ldd-arbitrary-code-execution/
24105 and
24106 http://tldp.org/HOWTO/Program-Library-HOWTO/shared-libraries.html
24107
24108 clone.2
24109 Michael Kerrisk
24110 Rewrite discussion of sys_clone
24111
24112 futex.2
24113 Марк Коренберг
24114 Consolidate error descriptions to ERRORS
24115 Michael Kerrisk
24116 Various wording fix-ups
24117 Michael Kerrisk
24118 Fix description of EINVAL error
24119 The current text seems incorrect. Replace with a more general
24120 description.
24121
24122 getdents.2
24123 select_tut.2
24124 atof.3
24125 atoi.3
24126 pthread_create.3
24127 pthread_sigmask.3
24128 rtime.3
24129 setbuf.3
24130 tsearch.3
24131 netlink.7
24132 Michael Kerrisk [Jan Engelhardt]
24133 Remove unneeded casts
24134
24135 get_robust_list.2
24136 get_thread_area.2
24137 getcpu.2
24138 getdents.2
24139 gettid.2
24140 io_cancel.2
24141 io_destroy.2
24142 io_getevents.2
24143 io_setup.2
24144 io_submit.2
24145 ioprio_set.2
24146 kexec_load.2
24147 llseek.2
24148 modify_ldt.2
24149 mq_getsetattr.2
24150 pivot_root.2
24151 readdir.2
24152 rt_sigqueueinfo.2
24153 set_thread_area.2
24154 sgetmask.2
24155 spu_create.2
24156 spu_run.2
24157 subpage_prot.2
24158 sysctl.2
24159 tkill.2
24160 Michael Kerrisk
24161 Add note to SYNOPSIS that there is no glibc wrapper for system call
24162 Reduce the chance that the reader may be misled into thinking
24163 that there is a wrapper function for this system call by noting
24164 explicitly in the SYNOPSIS that there is no glibc wrapper and
24165 pointing the reader to NOTES for further details.
24166
24167 ioprio_set.2
24168 Colin McCabe
24169 Clarify the multithreaded behavior of ioprio_set(2)
24170 Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
24171 Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
24172 For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
24173 For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
24174 process group.
24175
24176 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
24177
24178 migrate_pages.2
24179 Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
24180 Fix description of return value
24181
24182 mount.2
24183 Michael Kerrisk
24184 For MS_REMOUNT, source is ignored
24185
24186 mprotect.2
24187 Michael Kerrisk [Rasmus Villemoes]
24188 'addr' argument is not const
24189 As reported by Rasmus:
24190
24191 Both my system's man-pages (3.22) and the latest online
24192 (3.41) show:
24193
24194 int mprotect(const void *addr, size_t len, int prot);
24195
24196 as the prototype for mprotect(2). However, POSIX [1] and the
24197 actual sys/mman.h (on all the systems I checked) do not have
24198 the const qualifier on the first argument.
24199
24200 msgctl.2
24201 semctl.2
24202 shmctl.2
24203 svipc.7
24204 Michael Kerrisk
24205 Don't mention that ipc_perm is defined in <sys/ipc.h>
24206 There's no need to mention that the 'ipc_perm' structure
24207 is defined in <sys/ipc.h>. That's an implementation detail,
24208 and furthermore <sys/ipc.h> is itself included by the other
24209 System V IPC header files. The current text might lead the
24210 reader to conclude that they must include <sys/ipc.h>, which
24211 is not the case (it is required neither on Linux, nor by the
24212 standards).
24213
24214 msgctl.2
24215 msgget.2
24216 msgop.2
24217 semctl.2
24218 semget.2
24219 semop.2
24220 shmctl.2
24221 shmget.2
24222 Michael Kerrisk
24223 NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
24224 Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
24225 header files aren't required by Linux or the standards, but may
24226 be needed for portability to old systems.
24227
24228 ptrace.2
24229 Denys Vlasenko
24230 Explain WNOHANG behavior and EINTR bug
24231 I didn't like the "SIGKILL operates similarly, with exceptions"
24232 phrase (if it's different, then it's not "similar", right?),
24233 and now I got around to changing it. Now it says simply:
24234 "SIGKILL does not generate signal-delivery-stop and therefore
24235 the tracer can't suppress it."
24236
24237 Replaced "why WNOHANG is not reliable" example with a more
24238 realistic one (the one which actually inspired to add this
24239 information to man page in the first place): we got
24240 ESRCH - process is gone! - but waitpid(WNOHANG) can still
24241 confusingly return 0 "no processes to wait for".
24242
24243 Replaced "This means that unneeded trailing arguments may
24244 be omitted" part with a much better recommendation
24245 to never do that and to supply zero arguments instead.
24246 (The part about "undocumentedness" of gcc behavior was bogus,
24247 btw - deleted).
24248
24249 Expanded BUGS section with the explanation and an example
24250 of visible strace behavior on the buggy syscalls which
24251 exit with EINTR on ptrace attach. I hope this will lead
24252 to people submitting better bug reports to lkml about
24253 such syscalls.
24254
24255 seteuid.2
24256 Michael Kerrisk
24257 Note glibc version where setegid() implementation changed
24258 In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
24259
24260 set_tid_address.2
24261 Michael Kerrisk
24262 Rename 'ctid' argument for consistency with clone(2) page
24263 Michael Kerrisk
24264 Some rewordings and minor clarifications
24265
24266 sigwaitinfo.2
24267 Michael Kerrisk [Daniel Zingaro]
24268 Some wording clarifications
24269 Mainly rewording things like "is delivered" to "becomes pending",
24270 which is more accurate terminology.
24271
24272 syscall.2
24273 Michael Kerrisk
24274 Add some more details to the description of syscall(2)
24275 And add another example of using syscall() to the program example.
24276
24277 syscalls.2
24278 Michael Kerrisk
24279 Add kcmp(2)
24280 Michael Kerrisk
24281 Move discussion of set_zone_reclaim(2) out of main table
24282 This system call was never visible to user space, so it makes
24283 sense to move it out of the main table of system calls into
24284 the notes below the table.
24285
24286 getifaddrs.3
24287 Michael Kerrisk [Adrian Dabrowski]
24288 Note that ifa_addr and ifa_netmask can be NULL
24289
24290 readdir.3
24291 Michael Kerrisk [Jan Engelhardt]
24292 Handle -1 error from pathconf() in example code snippet
24293 Improve the example demonstrating allocation of a buffer
24294 for readdir_r() to handle -1 error return from pathconf().
24295 Otherwise, naive readers may think that pathconf() return
24296 value can be used without checking.
24297
24298 realpath.3
24299 Shawn Landden
24300 Use past tense with ancient history (libc4, libc5)
24301
24302 regex.3
24303 Michael Kerrisk
24304 Correct SEE ALSO reference to glibc manual "regex" section
24305
24306 rtime.3
24307 Michael Kerrisk [Jan Engelhardt]
24308 Fix broken pointer cast in example code
24309
24310 sem_close.3
24311 sem_destroy.3
24312 sem_getvalue.3
24313 sem_init.3
24314 sem_open.3
24315 sem_post.3
24316 sem_unlink.3
24317 sem_wait.3
24318 sem_overview.7
24319 Michael Kerrisk
24320 Note that "cc -pthread" is required; "-lrt" no longer works
24321 See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/874418
24322
24323 sigwait.3
24324 Michael Kerrisk
24325 Reword "is delivered" to "becomes pending"
24326
24327 strcat.3
24328 Michael Kerrisk
24329 Add some text to emphasize the dangers of buffer overruns
24330 Michael Kerrisk
24331 NOTES: Add discussion of strlcat()
24332
24333 strcpy.3
24334 Michael Kerrisk
24335 Note that info is lost when strncpy() doesn't null terminate
24336 Michael Kerrisk
24337 Add some text to emphasize possibility of buffer runs with strcpy()
24338 Michael Kerrisk
24339 NOTES: Add a discussion of strlcpy()
24340 Inspired by https://lwn.net/Articles/506530/
24341 Michael Kerrisk
24342 Fix description of the null-byte padding performed by strncpy()
24343
24344 tsearch.3
24345 Michael Kerrisk
24346 NOTES: remove redundant discussion of unorthodox use of term "postorder"
24347 This point is already covered at greater length in the main
24348 text of the page (See the piece "More commonly, ...").
24349 Michael Kerrisk
24350 Clarify use for first argument to the twalk() 'action' function
24351 There's a number of details in POSIX that are omitted in
24352 the current version of this page.
24353 Michael Kerrisk
24354 Some wording fixes
24355
24356 core.5
24357 Michael Kerrisk
24358 Note effect of madvise(2) MADV_DONTDUMP flag
24359
24360 capabilities.7
24361 Michael Kerrisk
24362 Document CAP_BLOCK_SUSPEND
24363
24364 glob.7
24365 Bjarni Ingi Gislason
24366 Change 8 bit characters to 7 bit representation
24367 Fixes rendering errors for accented 'a' characters.
24368 Michael Kerrisk [Aaron Peschel]
24369 Update bash(1) command used to obtain classical globbing behavior
24370 The man page formerly noted the bash(1) v1 command to do this.
24371
24372 iso_8859-1.7
24373 Bjarni Ingi Gislason
24374 Explanation of SOFT HYPHEN and the code for it
24375 <groff: iso_8859-2.7>:89: warning: can't find special character `shc'
24376
24377 This is the only "iso_8859-*.7" file that has this (now)
24378 undefined character. The code in column four in "iso_8859-1.7" is
24379 "0x2D" ("HYPHEN, MINUS SIGN" or "HYPHEN-MINUS") instead of "0xAD".
24380 See Debian bug 156154 (or package "manpages").
24381
24382 There should be an explanation for this graphic character and the
24383 code should be 0xAD in iso_8859-1.7 (as in all others), even
24384 though "[gn]roff" does not display a "HYPHEN" in that position of
24385 the table.
24386
24387 The line with "SOFT HYPHEN" gets a footnote and a short
24388 explanation.
24389
24390 mdoc.7
24391 Bjarni Ingi Gislason
24392 Fixing a warning and a table
24393 Fis warning from "groff -ww ..." (or "man --warnings=w ..."):
24394
24395 <groff: mdoc.7>:294: warning:
24396 tab character in unquoted macro argument
24397
24398 In one table the distance between columns is too small in the
24399 "ps" output. (Bug in the groff "doc.tmac" macro?)
24400
24401 mdoc.samples.7
24402 Bjarni Ingi Gislason
24403 Fix warnings from [ng]roff, corrections
24404 From "man -ww ..." (groff -ww ...):
24405
24406 <standard input>:541: warning:
24407 tab character in unquoted macro argument
24408 [+3 similar warnings]
24409 <standard input>:813: warning: macro `Pu' not defined
24410 Usage: .Rv -std in sections 2 and 3 only (#1669)
24411 mdoc warning: A .Bl directive has no matching .El (#1821)
24412
24413 String "Pu" defined as a row of punctuation characters.
24414 ".Bl" and ".El" fixed.
24415 Some arguments, that start with a period or are the name of a
24416 macro, protected with "\&".
24417 Variable name for macro ".Rv" corrected.
24418
24419 netdevice.7
24420 Bjarni Ingi Gislason
24421 Line in table too long
24422 Fix warning from "man ..." ("nroff -ww ..."):
24423
24424 nroff: netdevice.7: warning: around line 98:
24425 table wider than line width
24426
24427 Fix: No right adjustment in text blocks in tables.
24428
24429 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673873
24430
24431 netlink.7
24432 Bjarni Ingi Gislason
24433 Line in table is too long
24434 Fix warning from "man ..." ("nroff -ww ..."):
24435
24436 nroff: netlink.7: warning: around line 195:
24437 table wider than line width
24438
24439 Horizontal line incorporated into table.
24440 No right adjustment of text blocks in tables.
24441
24442 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=673875
24443 Simon Paillard [Herbert Xu]
24444 Change description of "*_pid" fields to "Port ID"
24445 As reported by Herbert Xu, these should not be considered as PIDs.
24446
24447 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=383296
24448
24449 rtnetlink.7
24450 Bjarni Ingi Gislason
24451 Line in table too long
24452 Fix warning from "man ..." ("nroff -ww ..."):
24453
24454 nroff: rtnetlink.7: warning: around line 415:
24455 table wider than line width
24456
24457 Column gutter reduced to fit line length.
24458 Right adjustment in text blocks removed in tables.
24459 Some header made centered in tables.
24460 One table put on same page.
24461
24462 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674051
24463
24464 socket.7
24465 Martin H
24466 Document SO_MARK socket option
24467 Commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0 in Jan 2008 added
24468 the new SO_MARK socket option.
24469
24470 This patch is based on text from the commit message.
24471
24472 See https://bugzilla.kernel.org/show_bug.cgi?id=16461.
24473
24474 svipc.7
24475 Michael Kerrisk
24476 SYNOPSIS: Remove include of <sys/types.h> and <sys/ipc.h>
24477 Including <sys/types.h> and <sys/ipc.h> isn't needed on Linux
24478 and isn't really relevant for the explanation on this page.
24479
24480
24481 ==================== Changes in man-pages-3.43 ====================
24482
24483 Released: 2012-10-05, Munich
24484
24485
24486 Contributors
24487 ------------
24488
24489 The following people contributed patches/fixes or (noted in brackets
24490 in the changelog below) reports, notes, and ideas that have been
24491 incorporated in changes in this release:
24492
24493 Adrian Bunk <bunk@kernel.org>
24494 Anatoli Klassen <anatoli@aksoft.net>
24495 Andreas Schwab <schwab@linux-m68k.org>
24496 Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
24497 David Prévot <taffit@debian.org>
24498 Eric Dumazet <edumazet@google.com>
24499 Florian Weimer <fweimer@redhat.com>
24500 Frédéric Brière <fbriere@fbriere.net>
24501 Fredrik Arnerup <arnerup@kth.se>
24502 Guillem Jover <guillem@hadrons.org>
24503 Jan Engelhardt <jengelh@inai.de>
24504 Michael Kerrisk <mtk.manpages@gmail.com>
24505 Simon Josefsson <simon@josefsson.org>
24506 Stephane Fillod <fillods@users.sf.net>
24507 Trevor Woerner <twoerner@gmail.com>
24508 Yuri Kozlov <yuray@komyakino.ru>
24509
24510 Apologies if I missed anyone!
24511
24512
24513 Newly documented interfaces in existing pages
24514 ---------------------------------------------
24515
24516 getenv.3
24517 Michael Kerrisk [Florian Weimer, Andreas Schwab]
24518 Document secure_getenv(3)
24519
24520
24521 New and changed links
24522 ---------------------
24523
24524 phys.2
24525 Michael Kerrisk
24526 New link to unimplemented.2
24527
24528 secure_getenv.3
24529 Michael Kerrisk
24530 New link to getenv.3
24531
24532
24533 Global changes
24534 --------------
24535
24536 Various pages
24537 Michael Kerrisk
24538 Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
24539
24540 Various pages
24541 David Prévot [Michael Kerrisk]
24542 Global fix: Various consistency fixes for SEE ALSO
24543
24544 Various pages
24545 Michael Kerrisk
24546 Global fix: use "Linux kernel source" consistently
24547 Rather than "kernel source".
24548
24549 Various pages
24550 Michael Kerrisk
24551 Global fix: disable justification and hyphenation in SEE ALSO
24552 For a better visual result, disable justification and hyphenation
24553 in SEE ALSO where page names are long.
24554
24555 syscalls.2
24556 uname.2
24557 boot.7
24558 Michael Kerrisk
24559 Global fix: s/OS/operating system/
24560
24561
24562 Changes to individual pages
24563 ---------------------------
24564
24565 epoll_wait.2
24566 Michael Kerrisk [Fredrik Arnerup]
24567 Describe timeout limitation in kernels < 2.6.37
24568 As reported by Fredrik (and as far as I can tell the problem
24569 went back to 2.6.0):
24570
24571 The timeout argument has an upper limit. Any values above that
24572 limit are treated the same as -1, i.e. to wait indefinitely.
24573 The limit is given by:
24574
24575 #define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
24576 (LONG_MAX - 999ULL) / HZ)
24577
24578 That is, the limit depends on the size of a long and the timer
24579 frequency. Assuming the long is never smaller than 32 bits
24580 and HZ never larger than 1000, the worst case is 35 minutes.
24581 I think this should be mentioned under "BUGS".
24582
24583 Although this is likely to be fixed in the future
24584 (http://lkml.org/lkml/2010/8/8/144), the problem exists in
24585 at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
24586 are affected.
24587
24588 https://bugzilla.kernel.org/show_bug.cgi?id=20762
24589 Michael Kerrisk
24590 Add pointer to select(2) for discussion of close in another thread
24591
24592 getitimer.2
24593 Michael Kerrisk [Trevor Woerner]
24594 Note Linux's odd handling of the new_value==NULL case
24595 Michael Kerrisk [Trevor Woerner]
24596 Fix types used to declare fields in timeval struct
24597
24598 keyctl.2
24599 David Prévot
24600 Reorder SEE ALSO, without .br
24601
24602 poll.2
24603 Michael Kerrisk
24604 Add pointer to select(2) for discussion of close in another thread
24605
24606 select.2
24607 Michael Kerrisk [Stephane Fillod]
24608 Note behavior if monitored file descriptor is closed in another thread
24609 Executive summary: a sane application can't rely on any
24610 particular behavior if another thread closes a file descriptor
24611 being monitored by select().
24612
24613 See https://bugzilla.kernel.org/show_bug.cgi?id=40852
24614 Michael Kerrisk
24615 Clarify equivalent pselect() code in terms of threads
24616 s/sigprogmask/pthread_sigmask/
24617
24618 semop.2
24619 Michael Kerrisk
24620 Recast discussion of blocking behavior in terms of threads
24621 semop() blocks the calling thread, not the process.
24622 Michael Kerrisk
24623 SEE ALSO: Add clone(2)
24624 Give reader a clue about CLONE_SYSVSEM.
24625
24626 shutdown.2
24627 Michael Kerrisk [Eric Dumazet]
24628 Document EINVAL error (and associated bug)
24629 Eric Dumazet noted that EINVAL was not documented. Some further
24630 digging shows that it's also not diagnosed consistently.
24631 See https://bugzilla.kernel.org/show_bug.cgi?id=47111.
24632
24633 sigaction.2
24634 Michael Kerrisk
24635 Tweak SA_RESETHAND description
24636
24637 timer_settime.2
24638 Michael Kerrisk
24639 Small rewording around discussion of pointer arguments
24640
24641 wait4.2
24642 Adrian Bunk
24643 Note that these functions are nonstandard and recommend alternatives
24644 Some edits to Adrian's patch by mtk.
24645 Michael Kerrisk
24646 CONFORMING TO: Note SUS details for wait3()
24647
24648 gnu_get_libc_version.3
24649 Michael Kerrisk
24650 Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
24651
24652 pthread_kill.3
24653 pthread_sigqueue.3
24654 Michael Kerrisk
24655 Remove wording "another"
24656 Writing "another thread" in these pages implies that these
24657 functions can't be used to send a signal to the calling thread
24658 itself, which is of course untrue.
24659
24660 sigvec.3
24661 Michael Kerrisk
24662 Add "int" arg to sv_handler definition in sigvec structure
24663 Michael Kerrisk
24664 Fix small error in discussion of blocking of signals
24665 The signal that causes the handler to be invoked is blocked,
24666 but saying "by default" implies that this can be changed via
24667 the API. It cannot. (One needs sigaction(2) for that.)
24668
24669 syslog.3
24670 Simon Josefsson
24671 Remove (apparently bogus) text claiming LOG_AUTH is deprecated
24672 LOG_AUTH is in POSIX, and widely available. There
24673 seems to be no basis to the claim it is deprecated.
24674
24675 Quoting Simon:
24676 I cannot find any other source that claim LOG_AUTH is
24677 deprecated in any way. LOG_AUTH is distinct from
24678 LOG_AUTHPRIV. The GNU C Library manual only documents
24679 LOG_AUTH. The header files contains both without any
24680 comment. Common systems like Debian appear to refer to
24681 both auth and authpriv facilities in syslog configurations.
24682 Popular daemons appear to use both facilities.
24683 Both facilities are discussed in several RFCs.
24684
24685 See https://bugzilla.kernel.org/show_bug.cgi?id=46091
24686
24687 ttyname.3
24688 Michael Kerrisk
24689 SEE ALSO: Add ctermid(3)
24690
24691 proc.5
24692 Michael Kerrisk
24693 Clarify header file related to 'flags' field of /proc/PID/stat
24694 Michael Kerrisk [Frédéric Brière]
24695 Update description of 'starttime' field of /proc/PID/stat
24696 The unit of measurement changed from jiffies to clock ticks in
24697 Linux 2.6.
24698
24699 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891
24700 Michael Kerrisk
24701 Document /proc/sys/kernel/kptr_restrict
24702 Michael Kerrisk [Kees Cook]
24703 Document /proc/sys/fs/protected_symlinks
24704 Based on text in Documentation/sysctl/fs.txt by Kees Cook
24705 Michael Kerrisk [Kees Cook]
24706 Document /proc/sys/fs/protected_hardlinks
24707 Based on text in Documentation/sysctl/fs.txt by Kees Cook
24708
24709 capabilities.7
24710 Michael Kerrisk
24711 Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
24712
24713 ip.7
24714 Michael Kerrisk
24715 SEE ALSO: Add ipv6(7)
24716 SEE ALSO: Add icmp(7)
24717
24718 man-pages.7
24719 Michael Kerrisk
24720 Add some advice about disabling hyphenation in SEE ALSO
24721
24722 ld.so.8
24723 Michael Kerrisk
24724 Describe interpretation of slashes in dependency strings
24725 Michael Kerrisk
24726 Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
24727 This point is already noted when discussing search order for
24728 libraries, but it's worth repeating under the specific discussion
24729 of LD_LIBRARY_PATH further down the page.
24730 Michael Kerrisk
24731 Add some details for LD_PRELOAD
24732 Note that LD_PRELOAD list separator can be space or colon
24733
24734
24735 ==================== Changes in man-pages-3.44 ====================
24736
24737 Released: 2012-11-07, Barcelona
24738
24739
24740 Contributors
24741 ------------
24742
24743 The following people contributed patches/fixes or (noted in brackets
24744 in the changelog below) reports, notes, and ideas that have been
24745 incorporated in changes in this release:
24746
24747 Bert Hubert <bert.hubert@netherlabs.nl>
24748 David Prévot <taffit@debian.org>
24749 James Youngman <jay@gnu.org>
24750 Kees Cook <keescook@chromium.org>
24751 Lars Wirzenius <liw@iki.fi>
24752 Lucas De Marchi <lucas.de.marchi@gmail.com>
24753 Michael Kerrisk <mtk.manpages@gmail.com>
24754 Rusty Russell <rusty@rustcorp.com.au>
24755 Simon Paillard <spaillard@debian.org>
24756 Thomas Habets <thomas@habets.se>
24757
24758 Apologies if I missed anyone!
24759
24760
24761 New and rewritten pages
24762 -----------------------
24763
24764 delete_module.2
24765 Michael Kerrisk
24766 Rewrite to Linux 2.6+ reality
24767 Michael Kerrisk
24768 Change license and copyright
24769 There is now nothing left of the original FSF-copyrighted
24770 page. So, change the copyright and license.
24771 Michael Kerrisk [Lucas De Marchi, Rusty Russell]
24772 Substantial reorganization after comments from Rusty Russell
24773 Rusty notes that O_NONBLOCK is almost always used in
24774 practice. Therefore, it would be better to reorganize
24775 the page to consider that "the default".
24776
24777 init_module.2
24778 Michael Kerrisk
24779 Rewrite to Linux 2.6+ reality
24780 Michael Kerrisk
24781 Change copyright and license
24782 Little of the original page now remains. Change
24783 copyright and license
24784 Michael Kerrisk [Rusty Russell]
24785 Changes after review comments from Rusty Russell
24786 Kees Cook
24787 Add various pieces describing Linux 2.6+ behavior
24788 Pieces take from, or inspired by, a patch sent by Kees.
24789
24790 getauxval.3
24791 Michael Kerrisk
24792 Document getauxval() function added in glibc 2.16
24793
24794
24795 Global changes
24796 --------------
24797
24798 Various pages
24799 Michael Kerrisk
24800 Global fix: Use consistent capitalization in NAME section
24801 The line(s) in the NAME section should only use capitals
24802 where English usage dictates that. Otherwise, use
24803 lowercase throughout.
24804
24805 Various pages
24806 Michael Kerrisk
24807 Global fix: "userspace" ==> "user space" or "user-space"
24808 Existing pages variously use "userspace or "user space".
24809 But, "userspace" is not quite an English word.
24810 So change "userspace" to "user space" or, when used
24811 attributively, "user-space".
24812
24813
24814 Changes to individual pages
24815 ---------------------------
24816
24817 clock_getres.2
24818 clock_nanosleep.2
24819 Michael Kerrisk
24820 Linking with -lrt is no longer needed from glibc 2.17 onward
24821
24822 create_module.2
24823 Michael Kerrisk
24824 Note that this system call is present only in kernels before 2.6
24825 Michael Kerrisk
24826 Note that ENOSYS probably indicates kernel 2.6+
24827
24828 execve.2
24829 Michael Kerrisk
24830 Document treatment of PR_SET_PDEATHSIG on execve()
24831 Michael Kerrisk
24832 Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
24833
24834 fork.2
24835 Michael Kerrisk
24836 Note treatment of default timer slack value on fork()
24837
24838 getdomainname.2
24839 Simon Paillard [Lars Wirzenius]
24840 Point out that these calls relate to NIS, not DNS
24841 See http://bugs.debian.org/295635
24842
24843 get_kernel_syms.2
24844 Michael Kerrisk
24845 Note that this system call is present only in kernels before 2.6
24846
24847 ipc.2
24848 Michael Kerrisk
24849 Update note on architectures that don't have ipc()
24850 Replace mention of ia64 with x86-64 and ARM.
24851
24852 link.2
24853 Michael Kerrisk
24854 Add EPERM error triggered by /proc/sys/fs/protected_hardlink
24855
24856 prctl.2
24857 Michael Kerrisk
24858 Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
24859 Kees Cook
24860 update seccomp sections for mode 2 (BPF)
24861 This adds a short summary of the arguments used
24862 for "mode 2" (BPF) seccomp.
24863 Michael Kerrisk
24864 Small improvements to PR_SET_SECCOMP discussion
24865 Note type of 'arg3' for SECCOMP_MODE_FILTER.
24866 Add pointer to Documentation/prctl/seccomp_filter.txt.
24867 Michael Kerrisk
24868 Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
24869 Michael Kerrisk
24870 Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
24871 Michael Kerrisk
24872 Reword PR_SET_NAME and PR_GET_NAME in terms of threads
24873 Plus tfix
24874 Kees Cook
24875 document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
24876 This adds a short description of the no_new_privs bit,
24877 as described in Documentation/prctl/no_new_privs.txt.
24878
24879 ptrace.2
24880 Michael Kerrisk
24881 Clarify that some operations are not present on all architectures
24882 PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
24883 and PTRACE_GETSPREGS are not present on all architectures.
24884 PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
24885 on x86.
24886
24887 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
24888
24889 query_module.2
24890 Michael Kerrisk
24891 Add a few words clarifying reference to /sys/module
24892 Michael Kerrisk
24893 Note that this system call is present only in kernels before 2.6
24894 Michael Kerrisk
24895 Note that ENOSYS probably indicates kernel 2.6+
24896 Michael Kerrisk
24897 SEE ALSO: Add modinfo(8) and lsinfo(8)
24898 Michael Kerrisk
24899 Move some information in NOTES to VERSIONS
24900
24901 socketcall.2
24902 Michael Kerrisk
24903 Update note on architectures that don't have socketcall()
24904 Replace mention of ia64 with x86-64 and ARM.
24905
24906 times.2
24907 Thomas Habets
24908 Recommend clock_gettime(2) as alternative to times(2)
24909
24910 clock_getcpuclockid.3
24911 Michael Kerrisk
24912 Linking with -lrt is no longer needed from glibc 2.17 onward
24913
24914 fts.3
24915 Simon Paillard [James Youngman]
24916 Improve description of physical vs. logical tree walking
24917 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=633505
24918
24919 getenv.3
24920 Michael Kerrisk
24921 SEE ALSO: add getauxval(3)
24922
24923 proc.5
24924 Michael Kerrisk
24925 Document /proc/meminfo
24926 Info mostly taken from Documentation/filesystems/proc.txt
24927 and Documentation/vm/hugetlbpage.txt.
24928 Michael Kerrisk
24929 Default for /proc/sys/fs/protected_{hardlinks,symlinks} is now 0
24930 The default setting of 1 in/proc/sys/fs/protected_hardlinks
24931 and /proc/sys/fs/protected_symlinks caused one too many
24932 breakages for Linus's taste, so commit 561ec64ae67e changed
24933 the default for both files to 0.
24934 Note system call error yielded by /proc/sys/fs/protected_symlinks
24935 Note that violating 'protected_symlinks' restrictions
24936 causes system calls to fail with the error EACCES.
24937 Michael Kerrisk
24938 Since Linux 2.6.27, /proc/sys/kernel/modprobe depends on CONFIG_MODULES
24939
24940 ipv6.7
24941 Bert Hubert
24942 Document IPV6_RECVPKTINFO
24943
24944 man-pages.7
24945 Michael Kerrisk
24946 Note rules for capitalization in NAME section
24947
24948 time.7
24949 Michael Kerrisk
24950 Add a subsection on timer slack
24951
24952 ld.so.8
24953 Michael Kerrisk
24954 SEE ALSO: add getauxval(3)
24955
24956
24957 ==================== Changes in man-pages-3.45 ====================
24958
24959 Released: 2012-12-21, Christchurch
24960
24961
24962 Contributors
24963 ------------
24964
24965 The following people contributed patches/fixes or (noted in brackets
24966 in the changelog below) reports, notes, and ideas that have been
24967 incorporated in changes in this release:
24968
24969 Andi Kleen <andi@firstfloor.org>
24970 Cyril Hrubis <chrubis@suse.cz>
24971 David Prévot <taffit@debian.org>
24972 Elie De Brauwer <eliedebrauwer@gmail.com>
24973 Eric Dumazet <eric.dumazet@gmail.com>
24974 Felipe Pena <felipensp@gmail.com>
24975 Florian Weimer <fweimer@redhat.com>
24976 Gao Feng <gaofeng@cn.fujitsu.com>
24977 Jan Glauber <jang@linux.vnet.ibm.com>
24978 Jim Paris <jim@jtan.com>
24979 Jon Grant <jg@jguk.org>
24980 Julien Cristau <jcristau@debian.org>
24981 Michael Kerrisk <mtk.manpages@gmail.com>
24982 Mike Frysinger <vapier@gentoo.org>
24983 Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
24984 Simon Paillard <spaillard@debian.org>
24985 Thierry Vignaud <thierry.vignaud@gmail.com>
24986 Trevor Woerner <twoerner@gmail.com>
24987 YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
24988
24989 Apologies if I missed anyone!
24990
24991
24992 New and rewritten pages
24993 -----------------------
24994
24995 s390_runtime_instr.2
24996 Jan Glauber
24997 New page for s390-specific s390_runtime_instr(2)
24998
24999 if_nameindex.3
25000 YOSHIFUJI Hideaki
25001 Document if_nameindex(3) and if_freenameindex(3)
25002 Michael Kerrisk
25003 Edits, improvements and corrections to Hideaki's page
25004 Michael Kerrisk
25005 Add an example program
25006
25007 if_nametoindex.3
25008 YOSHIFUJI Hideaki
25009 New page documenting if_nametoindex(3) and if_indextoname(3)
25010
25011
25012 New and changed links
25013 ---------------------
25014
25015 if_freenameindex.3
25016 Michael Kerrisk
25017 New link to if_nameindex.3
25018
25019 if_indextoname.3
25020 Michael Kerrisk
25021 New link to if_nametoindex.3
25022
25023
25024 Global changes
25025 --------------
25026
25027 sysconf.3
25028 cciss.4
25029 Michael Kerrisk
25030 Global fix: s/runtime/run time/
25031
25032
25033 Changes to individual pages
25034 ---------------------------
25035
25036 clone.2
25037 Michael Kerrisk
25038 Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
25039
25040 delete_module.2
25041 Michael Kerrisk
25042 Small rewording of description of effect of O_TRUNC
25043
25044 getrlimit.2
25045 Michael Kerrisk [Trevor Woerner]
25046 Document Linux's nonstandard treatment or RLIMIT_CPU soft limit
25047 Upon encountering the RLIMIT_CPU soft limit when a SIGXCPU handler
25048 has been installed, Linux invokes the signal handler *and* raises
25049 the soft limit by one second. This behavior repeats until the
25050 limit is encountered. No other implementation that I tested
25051 (Solaris 10, FreeBSD 9.0, OpenBSD 5.0) does this, and it seems
25052 unlikely to be POSIX-conformant. The (Linux-specific)
25053 RLIMIT_RTTIME soft limit exhibits similar behavior.
25054 Michael Kerrisk
25055 Point reader at discussion of /proc/[pid]/limits in proc(5)
25056
25057 io_getevents.2
25058 Michael Kerrisk
25059 io_getevents() may cause segfault when called with invalid ctx_id
25060 For reference see: http://marc.info/?l=linux-aio&m=130089887002435&w=2
25061
25062 recv.2
25063 Michael Kerrisk [Eric Dumazet]
25064 UNIX domain sockets support MSG_TRUNC since 3.4
25065
25066 sendmmsg.2
25067 Elie De Brauwer
25068 Add example program for sendmmsg()
25069
25070 stat.2
25071 Simon Paillard
25072 Clarify description of EOVERFLOW error
25073 The EOVERFLOW error is not only for st_size, but also
25074 inode and block size fields. See glibc source file
25075 sysdeps/unix/sysv/linux/xstatconv.c and kernel source
25076 file fs/stat.c. Also, fix bit/byte confusion
25077 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604928
25078
25079 syscalls.2
25080 Michael Kerrisk
25081 Update various references to "i386" to "x86"
25082 Michael Kerrisk
25083 Add s390_runtime_instr(2)
25084
25085 sysctl.2
25086 Michael Kerrisk
25087 Mention CONFIG_SYSCTL_SYSCALL
25088 Michael Kerrisk
25089 Calls to sysctl() log warnings to the kernel log since 2.6.24
25090
25091 syslog.2
25092 Michael Kerrisk
25093 Substantially reorganize discussion of commands
25094 Make the layout of the discussion of the commands
25095 more readable.
25096 Michael Kerrisk
25097 Add kernel symbolic 'type' names
25098 Michael Kerrisk
25099 Clarify SYSLOG_ACTION_SIZE_UNREAD semantics
25100 SYSLOG_ACTION_SIZE_UNREAD returns the number of bytes
25101 available for reading via SYSLOG_ACTION_READ.
25102 Michael Kerrisk
25103 Clarify where SYSLOG_ACTION_READ_ALL places data it reads
25104 Michael Kerrisk
25105 Clarify semantics of SYSLOG_ACTION_CLEAR
25106 The SYSLOG_ACTION_CLEAR command (5) does not really clear
25107 the ring buffer; rather it affects the semantics of what
25108 is returned by commands 3 (SYSLOG_ACTION_READ_ALL) and
25109 4 (SYSLOG_ACTION_READ_CLEAR).
25110 Michael Kerrisk
25111 Clarify discussion of privileges for commands 3 and 10
25112 Michael Kerrisk
25113 Add mention of CONFIG_LOG_BUF_SHIFT
25114
25115 wait.2
25116 Michael Kerrisk
25117 BUGS: Document odd waitid() behavior when 'infop' is NULL
25118
25119 getifaddrs.3
25120 Michael Kerrisk [Julien Cristau]
25121 Update description of ifa_data to Linux 2.6+ reality
25122 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25123
25124 memcmp.3
25125 Michael Kerrisk [Jon Grant]
25126 Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25127 Note that sign of result equals sign of difference between
25128 first two bytes that differ (treated as "unsigned char")."
25129
25130 mkstemp.3
25131 Michael Kerrisk [Florian Weimer]
25132 Deemphasize discussion of mode 066 in glibc 2.0.6
25133 Glibc 2.0.6 is now so ld that the discussion of details
25134 of that version can be deemphasized placing just under
25135 NOTES.
25136
25137 See https://bugzilla.kernel.org/show_bug.cgi?id=51811
25138
25139 strcmp.3
25140 Michael Kerrisk [Jon Grant]
25141 Enhance RETURN VALUE text and remove redundant text from DESCRIPTION
25142 Note that sign of result equals sign of difference between
25143 first two bytes that differ (treated as "unsigned char")."
25144
25145 ttyname.3
25146 Michael Kerrisk
25147 Fix confused text in ERRORS
25148 The existing text suggested that the ERRORS applied
25149 only for ttyname_r(). However, 2 of the 3 errors
25150 can occur for ttyname().
25151
25152 undocumented.3
25153 Michael Kerrisk
25154 Remove some now documented functions
25155
25156 proc.5
25157 Michael Kerrisk [Jim Paris]
25158 Correct description of SwapFree in /proc/meminfo
25159 Michael Kerrisk
25160 Note change of /proc/[pid]/limits file permissions in 2.6.36
25161
25162 resolv.conf.5
25163 Simon Paillard
25164 Document IPv6 format for nameserver
25165 See: http://bugs.debian.org/610036
25166
25167 capabilities.7
25168 Michael Kerrisk [Rens van der Heijden]
25169 Correct URL for POSIX.1e draft
25170
25171 ipv6.7
25172 Gao Feng
25173 Add description of getsockopt() for IPV6_MTU
25174 In IPv4,IP_MTU is only supported by getsockopt.
25175 In IPv6, we can use IPV6_MTU to set socket's MTU,
25176 but the return value of getsockopt() is the path MTU.
25177
25178 rtnetlink.7
25179 Michael Kerrisk [Julien Cristau]
25180 Update description of IFLA_STATS to Linux 2.6+ reality
25181 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=526778
25182
25183 socket.7
25184 Michael Kerrisk [YOSHIFUJI Hideaki]
25185 Document 'sockaddr' and 'sockaddr_storage' types
25186 Andi Kleen
25187 Explain effect of SO_SNDTIMEO for connect()
25188 When SO_SNDTIMEO is set before connect(), then connect()
25189 may return EWOULDBLOCK when the timeout fires.
25190
25191
25192 ==================== Changes in man-pages-3.46 ====================
25193
25194 Released: 2013-01-27, Canberra
25195
25196
25197 Contributors
25198 ------------
25199
25200 The following people contributed patches/fixes or (noted in brackets
25201 in the changelog below) reports, notes, and ideas that have been
25202 incorporated in changes in this release:
25203
25204 Andrew Perepechko <andrew_perepechko@xyratex.com>
25205 Cédric Boutillier <cedric.boutillier@gmail.com>
25206 Cyrill Gorcunov <gorcunov@openvz.org>
25207 Daan Spitz <daan.f.spitz@gmail.com>
25208 David Prévot <taffit@debian.org>
25209 Elie De Brauwer <eliedebrauwer@gmail.com>
25210 Garrett Cooper <yanegomi@gmail.com>
25211 James Noble <James.Noble@daktronics.com>
25212 Justin Lebar <justin.lebar@gmail.com>
25213 Kees Cook <keescook@chromium.org>
25214 Lucas De Marchi <lucas.demarchi@profusion.mobi>
25215 Mark Hills <mark@pogo.org.uk>
25216 Maxin B. John <maxin.john@gmail.com>
25217 Michael Kerrisk <mtk.manpages@gmail.com>
25218 Michal Gorny <mgorny@gentoo.org>
25219 Peter Budny <bigpeteb@gmail.com>
25220 Peter Lekeynstein <lekensteyn@gmail.com>
25221 Rusty Russell <rusty@rustcorp.com.au>
25222 Samuel Thibault <sthibault@debian.org>
25223 Sam Varshavchik <mrsam@courier-mta.com>
25224 Shawn Landden <shawnlandden@gmail.com>
25225 Simon Paillard <spaillard@debian.org>
25226 Starlight <starlight.2013q1@binnacle.cx>
25227 Theodore Ts'o <tytso@mit.edu>
25228 Wolfgang Rohdewald <wolfgang@rohdewald.de>
25229 Zsbán Ambrus <ambrus@math.bme.hu>
25230
25231 Apologies if I missed anyone!
25232
25233
25234 New and rewritten pages
25235 -----------------------
25236
25237 kcmp.2
25238 Cyrill Gorcunov, Michael Kerrisk
25239 New page for kcmp(2)
25240
25241
25242 Newly documented interfaces in existing pages
25243 ---------------------------------------------
25244
25245 init_module.2
25246 Michael Kerrisk [Kees Cook, Rusty Russell, Lucas De Marchi]
25247 Document finit_module(2)
25248 Rusty Russell [Lucas De Marchi, Kees Cook]
25249 Document finit_module() 'flags' argument
25250 Document MODULE_INIT_IGNORE_MODVERSIONS and
25251 MODULE_INIT_IGNORE_VERMAGIC. (Some edits by mtk.)
25252
25253
25254 New and changed links
25255 ---------------------
25256
25257 finit_module.2
25258 Michael Kerrisk
25259 New link to init_module.2
25260
25261 __after_morecore_hook.3
25262 __free_hook.3
25263 __malloc_initialize_hook.3
25264 __memalign_hook.3
25265 __realloc_hook.3
25266 Michael Kerrisk
25267 New link to malloc_hook.3
25268
25269
25270 Global changes
25271 --------------
25272
25273 Various pages
25274 Michael Kerrisk
25275 Global fix: s/tty/terminal/
25276
25277
25278 Changes to individual pages
25279 ---------------------------
25280
25281 clone.2
25282 Michael Kerrisk
25283 Add kernel versions for various CLONE_* constants
25284 Michael Kerrisk
25285 CLONE_NEWIPC governs mechanisms that don't have filesystem pathnames
25286 Michael Kerrisk
25287 CLONE_NEWIPC doesn't mount the POSIX MQ file system
25288 Michael Kerrisk
25289 Add an example program (CLONE_NEWUTS)
25290 Michael Kerrisk
25291 Some reworking of CLONE_NEWIPC text
25292 No substantial content changes.
25293 Michael Kerrisk
25294 SEE ALSO: add kcmp(2)
25295 SEE ALSO: add setns(2)
25296
25297 fallocate.2
25298 Michael Kerrisk
25299 FALLOC_FL_* flags are defined in glibc only since 2.18
25300
25301 getxattr.2
25302 removexattr.2
25303 setxattr.2
25304 Michael Kerrisk [Andrew Perepechko, ]
25305 Note that ENOATTR is a synonym for ENODATA
25306 Various people have pointed out that strace(1) shows ENODATA
25307 for the case where the named attribute does not exist, or
25308 the process has no access to this attribute. ENODATA
25309 and ENOATTR are in fact defined as synonyms. Point this out
25310 in the man page, so that people understand the strace(1) info.
25311
25312 See https://bugzilla.kernel.org/show_bug.cgi?id=51871
25313
25314 getxattr.2
25315 listxattr.2
25316 removexattr.2
25317 setxattr.2
25318 Michael Kerrisk
25319 Put errors under ERRORS section
25320 The errno values on these pages were listed in a nonstandard
25321 way under the RETURN VALUE section. Put them in ERRORS sections.
25322
25323 init_module.2
25324 Michael Kerrisk [Rusty Russell]
25325 ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
25326
25327 link.2
25328 mkdir.2
25329 mknod.2
25330 open.2
25331 rename.2
25332 symlink.2
25333 write.2
25334 mkfifo.3
25335 Mark Hills
25336 Document EDQUOT error
25337 The return error EDQUOT is not documented in open(2), write(2),
25338 symlink(2) etc.
25339
25340 Whether inodes or disk blocks are required for each function
25341 is something I based on received wisdom and BSD documentation,
25342 rather than tracing the code to the kernel. For symlink(2)
25343 this certainly depends on the file system type.
25344
25345 listxattr.2
25346 Michael Kerrisk [Theodore Ts'o]
25347 Fix RETURN VALUE description
25348 On success, 0 may be returned, so change wording from
25349 "positive number" to "nonnegative number".
25350
25351 outb.2
25352 Michael Kerrisk
25353 Add SYNOPSIS
25354
25355 prctl.2
25356 Kees Cook
25357 Document PR_SET_PTRACER
25358 Document the Yama LSM's prctl handler that allows processes to
25359 declare ptrace restriction exception relationships via
25360 PR_SET_PTRACER.
25361 Michael Kerrisk
25362 Make it explicit that PR_SET_PTRACER replaces previous setting
25363 The attribute is a scalar, not a list.
25364 Shawn Landden
25365 Document EINVAL error for PR_SET_PTRACER
25366 Michael Kerrisk
25367 Document PR_GET_TID_ADDRESS
25368
25369 ptrace.2
25370 Michael Kerrisk
25371 Document PTRACE_O_EXITKILL
25372 Michael Kerrisk
25373 Place PTRACE_SETOPTIONS list in alphabetical order
25374
25375 query_module.2
25376 Michael Kerrisk
25377 Must be called using syscall(2)
25378 Yes, the call is way obsolete, but add this info
25379 for completeness.
25380
25381 recvmmsg.2
25382 Elie De Brauwer
25383 Add/correct kernel version info for recvmmsg() and MSG_WAITFORNONE
25384 This patch isolates the since/version related fixes as requested.
25385 This change introduces the following delta:
25386 * The page states it was added in 2.6.32 but it is only added
25387 2.6.33 (ref: http://kernelnewbies.org/Linux_2_6_33)
25388 * The MSG_WAITFORONE flag was in turn only added in 2.6.34
25389 (ref: http://kernelnewbies.org/Linux_2_6_34)
25390 Elie De Brauwer
25391 Add an example program
25392
25393 setns.2
25394 Michael Kerrisk
25395 Add example program
25396
25397 sigaction.2
25398 Michael Kerrisk [Zsbán Ambrus]
25399 Note feature test macro requirements for 'siginfo_t'
25400 See https://bugzilla.kernel.org/show_bug.cgi?id=52931
25401
25402 syscalls.2
25403 Michael Kerrisk
25404 Add kern_features(2)
25405 Michael Kerrisk
25406 Add utrap_install(2)
25407 Sparc-specific, present since ancient times
25408 Michael Kerrisk
25409 Add finit_module(2)
25410
25411 sysctl.2
25412 Michael Kerrisk [Garrett Cooper]
25413 ERRORS: EACCES as a synonym for EPRM
25414 See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25415 and http://thread.gmane.org/gmane.linux.ltp/11413/focus=957635
25416 From: Garrett Cooper <yanegomi <at> gmail.com>
25417 Subject: Re: [LTP] [PATCH] sysctl03: sysctl returns EACCES after 2.6.33-rc1
25418 Newsgroups: gmane.linux.kernel, gmane.linux.ltp
25419 Date: 2010-03-04 18:35:33 GMT
25420
25421 unshare.2
25422 Michael Kerrisk
25423 Update NOTES on unimplemented flags
25424 Michael Kerrisk
25425 Fix text problems in description of CLONE_FS
25426 Michael Kerrisk
25427 SEE ALSO: add kcmp(2)
25428 SEE ALSO: add setns(2)
25429 Michael Kerrisk
25430 Reorder CLONE_NEWUTS entry in list
25431
25432 difftime.3
25433 Michael Kerrisk [Michal Gorny]
25434 Remove crufty text about 'time_t' on "other systems"
25435 Back in 2006, some text came in via Debian patches that seems
25436 crufty. Remove it.
25437
25438 See https://bugzilla.kernel.org/show_bug.cgi?id=46731
25439
25440 getaddrinfo.3
25441 getnameinfo.3
25442 Michael Kerrisk [Peter Budny]
25443 Fix some confused references to function names
25444 See https://bugzilla.kernel.org/show_bug.cgi?id=52741
25445
25446 getspnam.3
25447 Michael Kerrisk [Wolfgang Rohdewald]
25448 ERRORS: Add EACCES
25449 See https://bugzilla.kernel.org/show_bug.cgi?id=52681
25450
25451 __setfpucw.3
25452 Michael Kerrisk
25453 Add proper page cross refs for alternate functions
25454
25455 core.5
25456 proc.5
25457 Kees Cook
25458 Clarify suid_dumpable versus core_pattern
25459 In Linux 3.6, additional requirements were placed on core_pattern
25460 when suid_dumpable is set to 2. Document this and include commit
25461 references.
25462 Justin Lebar
25463 statm's "shared" field refers to pages backed by files
25464 I noticed that statm's "shared" field doesn't match the sum of
25465 all the "shared" entries in smaps [1].
25466
25467 The kernel docs explain that statm's "shared" field is "number of
25468 pages that are shared (i.e. backed by a file)" [2]. smaps appears
25469 to call a page shared if it's mapped by at least two processes,
25470 which explains this discrepancy.
25471
25472 I'm not a kernel hacker, but it appears to me they do mean "i.e."
25473 and not "e.g." in the statm description: In
25474 fs/proc/task_mmu.c::task_statm, I see
25475
25476 *shared = get_mm_counter(mm, MM_FILEPAGES);
25477
25478 Here's a patch which updates the man page to match the (hopefully
25479 correct) kernel docs.
25480
25481 [1] https://bugzilla.mozilla.org/show_bug.cgi?id=807181
25482 [2] http://git.kernel.org/?p=linux/kernel/git/torvalds/linux.git;a=blob;f=Documentation/filesystems/proc.txt;h=a1793d670cd01bd374eddf54ffdfc768504291ff;hb=HEAD
25483
25484 proc.5
25485 Kees Cook
25486 Put /proc/sys/kernel/hotplug in alphabetical order
25487 Kees Cook
25488 Document /proc/sys/kernel/dmesg_restrict
25489 Kees Cook
25490 Linux 3.4 changed permissions needed to change kptr_restrict
25491 Michael Kerrisk [Samuel Thibault, Simon Paillard]
25492 Add field numbers for /proc/PID/stat
25493 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25494 Add numbering to /proc/stat "cpu" fields
25495 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25496 Michael Kerrisk
25497 Reorganize text describing /proc/stat "cpu" fields
25498 Michael Kerrisk
25499 Rewording of suid_dumpable text after comments from Kees Cook
25500 Michael Kerrisk [Samuel Thibault, Simon Paillard]
25501 Add field numbers for /proc/[pid]/statm
25502 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=553413
25503 Michael Kerrisk
25504 Document /proc/stat "cpu" "nice_guest" field
25505 Info taken from commit ce0e7b28fb75cb003cfc8d0238613aaf1c55e797
25506 Michael Kerrisk [Peter Lekeynstein]
25507 Document /prod/[pid]/oom_score_adj
25508 Text taken directly from Documentation/filesystems/proc.txt,
25509 with some light editing.
25510
25511 See https://bugzilla.kernel.org/show_bug.cgi?id=50421
25512
25513 shells.5
25514 Michael Kerrisk
25515 Add /etc/bash to list of example shells
25516
25517 ttytype.5
25518 Michael Kerrisk
25519 Add proper xref for termcap and terminfo pages
25520
25521 capabilities.7
25522 Michael Kerrisk
25523 Add kcmp(2) under CAP_SYS_PTRACE
25524
25525 man-pages.7
25526 Michael Kerrisk
25527 Update description of Section 7
25528
25529
25530 ==================== Changes in man-pages-3.47 ====================
25531
25532 Released: 2013-02-12, Christchurch
25533
25534
25535 Contributors
25536 ------------
25537
25538 The following people contributed patches/fixes or (noted in brackets
25539 in the changelog below) reports, notes, and ideas that have been
25540 incorporated in changes in this release:
25541
25542 David Prévot <taffit@debian.org>
25543 D. Barbier <bouzim@gmail.com>
25544 Lennart Poettering <lennart@poettering.net>
25545 Michael Kerrisk <mtk.manpages@gmail.com>
25546 Mike Frysinger <vapier@gentoo.org>
25547 Peter Schiffer <pschiffe@redhat.com>
25548 Radek Pazdera <rpazdera@redhat.com>
25549 Reuben Thomas <rrt@sc3d.org>
25550 Shawn Landden <shawnlandden@gmail.com>
25551 Simon Paillard <spaillard@debian.org>
25552 Vince Weaver <vweaver1@eecs.utk.edu>
25553
25554 Apologies if I missed anyone!
25555
25556
25557 New and rewritten pages
25558 -----------------------
25559
25560 perf_event_open.2
25561 Vincent Weaver
25562 New page documenting perf_event_open(2)
25563
25564 pthread_setname_np.3
25565 Chandan Apsangi, Michael Kerrisk
25566 New page for pthread_setname_np(3) and pthread_getname_np(3)
25567
25568 sln.8
25569 Michael Kerrisk [Peter Schiffer]
25570 New page documenting the 'sln' command provided by glibc
25571 Inspired by a Red Hat downstream page, but with rather
25572 more detail.
25573
25574
25575 Newly documented interfaces in existing pages
25576 ---------------------------------------------
25577
25578 prctl.2
25579 Michael Kerrisk [Shawn Landden, Lennart Poettering]
25580 Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
25581
25582 ip.7
25583 Radek Pazdera
25584 Add source-specific multicast sockopts
25585 This patch adds documentation of several source-specific multicast
25586 socket options that were added to kernel with implementation
25587 of IGMPv3 in 2.5.68.
25588
25589 The following socket options were added:
25590 IP_ADD_SOURCE_MEMBERSHIP
25591 IP_DROP_SOURCE_MEMBERSHIP
25592 IP_BLOCK_SOURCE
25593 IP_UNBLOCK_SOURCE
25594 IP_MSFILTER
25595
25596
25597 Pages moved across sections
25598 ---------------------------
25599
25600 getcontext.3
25601 Michael Kerrisk
25602 This page really belongs in Section 3 (moved from Section 2)
25603
25604 getdtablesize.3
25605 Michael Kerrisk
25606 Move from Section 2
25607
25608
25609 New and changed links
25610 ---------------------
25611
25612 getcontext.2
25613 Michael Kerrisk
25614 Make link to page moved into Section 3
25615
25616 getdtablesize.2
25617 Michael Kerrisk
25618 Link to renamed getdtablesize.3
25619
25620 setcontext.2
25621 Michael Kerrisk
25622 Modify link to point to Section 3
25623
25624 pthread_getname_np.3
25625 Michael Kerrisk
25626 New link to new pthread_setname_np.3
25627
25628 setcontext.3
25629 Michael Kerrisk
25630 Link to getcontext page renamed into Section 3
25631
25632
25633 Changes to individual pages
25634 ---------------------------
25635
25636 fallocate.2
25637 Michael Kerrisk
25638 SEE ALSO: add fallocate(1)
25639
25640 flock.2
25641 Michael Kerrisk
25642 SEE ALSO: add flock(1)
25643
25644 fork.2
25645 Michael Kerrisk
25646 SEE ALSO: add exit(2)
25647
25648 getpriority.2
25649 Michael Kerrisk
25650 BUGS: note that nice value is per-thread on Linux
25651
25652 getrlimit.2
25653 Michael Kerrisk
25654 SEE ALSO: add prlimit(1)
25655
25656 gettid.2
25657 Michael Kerrisk
25658 SEE ALSO: add various system calls that use thread IDs
25659
25660 ioprio_set.2
25661 Michael Kerrisk
25662 SEE ALSO: add ionice(1)
25663
25664 sched_setaffinity.2
25665 Michael Kerrisk
25666 SEE ALSO: add taskset(1)
25667
25668 sched_setparam.2
25669 Michael Kerrisk
25670 Scheduling policy and parameters are per-thread on Linux
25671 Direct the reader to the discussion in sched_setscheduler(2).
25672
25673 sched_setscheduler.2
25674 Michael Kerrisk
25675 Scheduling policy and parameters are per-thread on Linux
25676 Michael Kerrisk
25677 SEE ALSO: add chrt(1)
25678
25679 setsid.2
25680 Michael Kerrisk
25681 SEE ALSO: add setsid(1)
25682
25683 shmop.2
25684 Michael Kerrisk [Peter Schiffer]
25685 ERRORS: Add EIDRM
25686 Taken from Red Hat downstream patch
25687
25688 sigaction.2
25689 makecontext.3
25690 Michael Kerrisk
25691 Change getcontext/setcontext page ref to Section 3
25692
25693 signal.2
25694 Michael Kerrisk [Reuben Thomas]
25695 Clarify System V vs BSD semantics for signal()
25696
25697 syscalls.2
25698 Michael Kerrisk
25699 The list on this page is not just syscalls common to all platforms
25700 Michael Kerrisk
25701 Add perfctr(2)
25702 Add ppc_rtas(2)
25703 Michael Kerrisk
25704 Add kernel version number of utrap_install(2)
25705
25706 unimplemented.2
25707 Michael Kerrisk [Peter Schiffer]
25708 Remove mention of kernel version number in DESCRIPTION
25709
25710 inet.3
25711 Michael Kerrisk [Peter Schiffer]
25712 Fix error in EXAMPLE using inet_aton()
25713 See https://bugzilla.redhat.com/show_bug.cgi?id=837090
25714 Patch taken from Red Hat downstream.
25715
25716 posix_fallocate.3
25717 Michael Kerrisk
25718 SEE ALSO: add fallocate(1)
25719
25720 regex.3
25721 Reuben Thomas
25722 Clarify details of matching
25723 The first is that it's far from clear that the end points of the
25724 complete string match are stored in the zero'th element of the
25725 regmatch_t array; secondly, the phrase "next largest substring
25726 match" is positively misleading, implying some sort of size
25727 ordering, whereas in fact they are ordered according to their
25728 appearance in the regex pattern.
25729
25730 scanf.3
25731 Michael Kerrisk
25732 Clarify meaning of "string conversions" for 'm' modifier
25733 Mike Frysinger
25734 Update %a vs %m documentation
25735 POSIX.1-2008 adopted the 'm' flag for dynamic allocation. Update
25736 page to cover it and relegate the glibc-specific 'a' flag to
25737 NOTES.
25738
25739 strtol.3
25740 Michael Kerrisk [Peter Schiffer]
25741 Replace some bogus text about "thousands separator"
25742 See https://bugzilla.redhat.com/show_bug.cgi?id=652870
25743
25744 sysconf.3
25745 Michael Kerrisk [Peter Schiffer]
25746 Use "_SC_PAGESIZE" consistently on page
25747 s/_SC_PAGE_SIZE/_SC_PAGESIZE/ in one instance.
25748 From Red Hat downstream patch.
25749
25750 nscd.conf.5
25751 Peter Schiffer
25752 Add max-db-size and auto-propagate descriptions, default values, + misc
25753 * added missing valid services (services and netgroup)
25754 * added many default values for options
25755 * reordered options according to the nscd.conf file
25756 (logical order)
25757 * added 2 missing options: max-db-size and auto-propagate
25758
25759 nsswitch.conf.5
25760 Peter Schiffer
25761 Mention initgroups db
25762
25763 proc.5
25764 Michael Kerrisk
25765 Document /proc/profile
25766 Michael Kerrisk [Peter Schiffer]
25767 Update /proc/sys/fs/file-nr to include Linux 2.6 details
25768 Michael Kerrisk
25769 Clarify relationship between file-max and file-nr
25770 The third value in /proc/sys/fs/file-nr is the same as
25771 the value in /proc/sys/fs/file-max.
25772 Michael Kerrisk
25773 Note message written to kernel log when file-max limit is hit
25774 Info from Documentation/sysctl/fs.txt.
25775 Michael Kerrisk
25776 Mention lscpu(1) under discussion of /proc/cpuinfo
25777
25778 resolv.conf.5
25779 Michael Kerrisk [Peter Schiffer]
25780 Document "single-request-reopen" option
25781 Taken from Red Hat downstream patch
25782
25783 See https://bugzilla.redhat.com/show_bug.cgi?id=717770
25784 See http://thread.gmane.org/gmane.linux.man/3161
25785
25786 utmp.5
25787 Michael Kerrisk
25788 SEE ALSO: add utmpdump(1)
25789
25790 cpuset.7
25791 Simon Paillard
25792 Add missing 'cpuset.' prefix for some flags
25793 See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
25794
25795 svipc.7
25796 Michael Kerrisk
25797 SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
25798
25799 termio.7
25800 Michael Kerrisk
25801 SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
25802
25803 ld.so.8
25804 Michael Kerrisk [Peter Schiffer]
25805 LD_VERBOSE does not work with ld.so --list and --verify
25806 From Red Hat downstream patch
25807
25808 See https://bugzilla.redhat.com/show_bug.cgi?id=532629
25809 Michael Kerrisk
25810 SEE ALSO: add sln(8)
25811
25812 zdump.8
25813 Michael Kerrisk [Peter Schiffer]
25814 Bring up to date with zdump --help
25815 Patch taken from Red Hat downstream.
25816
25817
25818 ==================== Changes in man-pages-3.48 ====================
25819
25820 Released: 2013-03-05, Munich
25821
25822
25823 Contributors
25824 ------------
25825
25826 The following people contributed patches/fixes or (noted in brackets
25827 in the changelog below) reports, notes, and ideas that have been
25828 incorporated in changes in this release:
25829
25830 Andrey Vagin <avagin@openvz.org>
25831 Aristeu Rozanski <aris@ruivo.org>
25832 Colin Walters <walters@verbum.org>
25833 Cyril Hrubis <chrubis@suse.cz>
25834 Cyrill Gorcunov <gorcunov@openvz.org>
25835 Daniel P. Berrange <berrange@redhat.com>
25836 David Prévot <taffit@debian.org>
25837 D. Barbier <bouzim@gmail.com>
25838 Denys Vlasenko <vda.linux@googlemail.com>
25839 Flavio Leitner <fbl@redhat.com>
25840 Graham Gower <graham.gower@gmail.com>
25841 Ivana Varekova <varekova@redhat.com>
25842 Kai Kunschke <kai@kunfoo.org>
25843 Marcela Maslanova <mmaslano@redhat.com>
25844 Marc Lehmann <debian-reportbug@plan9.de>
25845 Marshel Abraham <Marshel.Abraham@in.bosch.com>
25846 Michael Kerrisk <mtk.manpages@gmail.com>
25847 Nathan Stratton Treadway <kernelbugs@nathanst.com>
25848 Pavel Emelyanov <xemul@parallels.com>
25849 Peter Schiffer <pschiffe@redhat.com>
25850 Simon Heimberg <simohe@besonet.ch>
25851 Simon Paillard <spaillard@debian.org>
25852 Török Edwin <edwintorok@gmail.com>
25853 Ulrich Drepper <drepper@redhat.com>
25854 Zack Weinberg <zackw@panix.com>
25855
25856 Apologies if I missed anyone!
25857
25858
25859 New and rewritten pages
25860 -----------------------
25861
25862 getunwind.2
25863 Marcela Maslanova
25864 New page documenting getunwind(2)
25865 Taken from Red Hat downstream man pages set
25866 Michael Kerrisk
25867 Much rewriting
25868 Some text taken from arch/ia64/kernel/unwind.c.
25869
25870 perfmonctl.2
25871 Ivana Varekova
25872 New page documenting IA-64-specific perfmonctl(2)
25873 Taken from Red Hat downstream man pages
25874 Michael Kerrisk
25875 Rework discussion of PFM_CREATE_CONTEXT
25876 Add VERSIONS and CONFORMING TO
25877 Note that there is no glibc wrapper
25878 Remove PFM_CREATE_EVTSETS, PFM_DELETE_EVTSETS, PFM_GETINFO_EVTSETS
25879 These don't exist, and it appears they never have.
25880 Fix argument types for PFM_WRITE_PMCS, PFM_WRITE_PMDS, PFM_READ_PMDS
25881 The types that were being used don't exist!
25882 Briefly document PFM_GET_FEATURES, PFM_DEBUG, PFM_GET_PMC_RESET_VAL
25883
25884 gai.conf.5
25885 Ulrich Drepper
25886 New page documenting gai.conf
25887 Taken from Red Hat downstream pages
25888
25889 nss.5
25890 Ulrich Drepper
25891 New page describing nss.conf
25892
25893
25894 Newly documented interfaces in existing pages
25895 ---------------------------------------------
25896
25897 clock_getres.2
25898 Cyril Hrubis
25899 Document CLOCK_REALTIME_COARSE and CLOCK_MONOTONIC_COARSE
25900 Cyril Hrubis
25901 Document CLOCK_BOOTTIME
25902 Michael Kerrisk
25903 Some improvements to CLOCK_BOOTTIME description
25904
25905 ptrace.2
25906 Denys Vlasenko
25907 Document PTRACE_GETREGSET, PTRACE_SETREGSET, PTRACE_SEIZE, and friends
25908 Document PTRACE_GETREGSET, PTRACE_SETREGSET,
25909 PTRACE_SEIZE, PTRACE_INTERRUPT, and PTRACE_LISTEN.
25910
25911
25912 New and changed links
25913 ---------------------
25914
25915 fattach.2
25916 fdetach.2
25917 getmsg.2
25918 isastream.2
25919 putmsg.2
25920 Michael Kerrisk [Peter Schiffer]
25921 New link to unimplemented.2
25922 Taken from Red Hat downstream.
25923
25924 See https://bugzilla.redhat.com/show_bug.cgi?id=436407
25925
25926
25927 Global changes
25928 --------------
25929
25930 Many pages
25931 Michael Kerrisk
25932 Global fix: remove unneeded double quotes in .SH headings
25933
25934 Many pages
25935 Michael Kerrisk
25936 Global fix: remove unneeded double quotes in .SS headings
25937
25938 Many pages
25939 Michael Kerrisk
25940 Global fix: use consistent capitalization in .SS headings
25941 Capitalization in .SS sections across pages (and sometimes even
25942 within a single page) is wildly inconsistent. Make it consistent.
25943 Capitalize first word in heading, but otherwise use lower case,
25944 except where English usage (e.g., proper nouns) or programming
25945 language requirements (e.g., identifier names) dictate otherwise.
25946
25947 Many pages
25948 Michael Kerrisk [Denys Vlasenko]
25949 Remove double blank lines in output
25950
25951 Various pages
25952 Michael Kerrisk
25953 Fix order of SH sections
25954
25955
25956 Changes to individual pages
25957 ---------------------------
25958
25959 accept.2
25960 Michael Kerrisk
25961 NAME: Add "accept4"
25962
25963 access.2
25964 Colin Walters
25965 Note that access() may also fail for FUSE
25966 Since in some cases (e.g. libguestfs's guestmount) it also has the
25967 semantics where files can appear owned by root, but are actually
25968 mutable by the user, despite what one might infer from the Unix
25969 permissions.
25970
25971 getpeername.2
25972 Michael Kerrisk [Kai Kunschke]
25973 Clarify semantics of getpeername() for datagram sockets
25974 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=674034
25975
25976 getuid.2
25977 Michael Kerrisk
25978 Remove duplicate section heading
25979
25980 mmap.2
25981 Cyril Hrubis
25982 Add note about partial page in BUGS section
25983 This adds a note about Linux behavior with partial page at the end
25984 of the object. The problem here is that a page that contains only
25985 part of a file (because the file size is not multiple of PAGE_SIZE)
25986 stays in page cache even after the mapping is unmapped and the file
25987 is closed. So if some process dirties such page, other mappings
25988 will see the changes rather than zeroes.
25989 Michael Kerrisk [Török Edwin]
25990 Some 'flags' values require a feature test macro to be defined
25991 Add text to NOTES noting that some MAP_* constants are
25992 defined only if a suitable feature test macro is defined.
25993 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=542601
25994 Cyril Hrubis
25995 Document EOVERFLOW error
25996
25997 open.2
25998 Michael Kerrisk
25999 Clarify list of file creation flags
26000 POSIX.1-2008 TC1 clarified this, so that O_CLOEXEC,
26001 O_DIRECTORY, and O_NOFOLLOW are also in this list.
26002
26003 prctl.2
26004 Cyrill Gorcunov
26005 Add some details for PR_GET_TID_ADDRESS
26006
26007 read.2
26008 Michael Kerrisk [Zack Weinberg]
26009 Clarify interaction of count==0 and error checking
26010 POSIX deliberately leaves this case open, so the man
26011 page should be less specific about what happens.
26012
26013 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533232
26014 Michael Kerrisk [Marc Lehmann]
26015 Remove crufty text about O_NONBLOCK on files
26016 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=700529
26017 Michael Kerrisk
26018 Clarify details for seekable files
26019
26020 unimplemented.2
26021 Michael Kerrisk [Peter Schiffer]
26022 Add various STREAMS interfaces to NAME
26023 Taken from Red Hat downstream.
26024
26025 See https://bugzilla.redhat.com/show_bug.cgi?id=436407
26026
26027 cexp2.3
26028 Michael Kerrisk
26029 Still does not exist in glibc 2.17
26030
26031 exit.3
26032 Michael Kerrisk
26033 Note that a call to execve() clears exit handler registrations
26034
26035 getaddrinfo.3
26036 Michael Kerrisk
26037 SEE ALSO: Add gai.conf(5)
26038
26039 malloc_trim.3
26040 Michael Kerrisk
26041 Remove duplicate section title
26042
26043 printf.3
26044 Marshel Abraham [Graham Gower, Graham Gower]
26045 Fix error handling in example code
26046 See https://bugzilla.kernel.org/show_bug.cgi?id=23282
26047
26048 pthread_yield.3
26049 Michael Kerrisk [Aristeu Rozanski]
26050 Add _GNU_SOURCE feature test macro to SYNOPSIS
26051
26052 resolver.3
26053 resolv.conf.5
26054 Michael Kerrisk [Nathan Stratton Treadway, Simon Heimberg]
26055 RES_DEBUG is only available if glibc is compiled with debug support
26056 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=692136
26057 and https://bugzilla.kernel.org/show_bug.cgi?id=43061
26058
26059 strtol.3
26060 Michael Kerrisk [Peter Schiffer]
26061 Remove crufty text from previous fix
26062
26063 core.5
26064 Michael Kerrisk
26065 Document CONFIG_COREDUMP
26066
26067 capabilities.7
26068 Andrey Vagin
26069 Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
26070
26071 inotify.7
26072 Michael Kerrisk
26073 A monitoring process can't easily distinguish events triggered by itself
26074
26075 ip.7
26076 Flavio Leitner [Peter Schiffer]
26077 Improve explanation about calling listen() or connect()
26078
26079 man-pages.7
26080 Michael Kerrisk
26081 Describe rules for capitalization in .SS headings
26082
26083 rtnetlink.7
26084 Pavel Emelyanov
26085 Add info about ability to create links with given index
26086 Since kernel v3.7 the RTM_NEWLINK message now accepts nonzero
26087 values in ifi_index field. Mention this fact in the respective
26088 rtnetlink.7 section.
26089
26090 socket.7
26091 Pavel Emelyanov
26092 SO_BINDTODEVICE is now readable
26093 SO_BINDTODEVICE is readable since kernel 3.8.
26094
26095
26096 ==================== Changes in man-pages-3.49 ====================
26097
26098 Released: 2013-03-10, Munich
26099
26100
26101 Contributors
26102 ------------
26103
26104 The following people contributed patches/fixes or (noted in brackets
26105 in the changelog below) reports, notes, and ideas that have been
26106 incorporated in changes in this release:
26107
26108 Michael Kerrisk <mtk.manpages@gmail.com>
26109
26110
26111 Global changes
26112 --------------
26113
26114 The goal of the changes below to consistently format copyright
26115 and license information in the comments in the page source
26116 at the top of each page. This allows for easy scripting to
26117 extract that information. Following these changes the comments
26118 the top of the page source should now consistently have the form:
26119
26120 .\" <copyright info, possibly spread over several lines>
26121 .\"
26122 .\" %%%LICENSE_START(<license-type>)
26123 .\" <license text>
26124 .\" %%%LICENSE_END
26125 .\" <other comments>
26126
26127 Note that the 'license-type' is merely descriptive. Its purpose is
26128 to simplify scripting for the purpose of gathering statistics on
26129 types of licenses used in man-pages. It is NOT a statement about
26130 the actual licensing of the page; that license is contain INSIDE the
26131 LICENSE_START...LICENSE_END clause.
26132
26133 All pages
26134 Michael Kerrisk
26135 Add a LICENSE_START()...LICENSE_END clause in source at
26136 top of each page that encapsulates the license text.
26137 Michael Kerrisk
26138 Put copyright info at top of page, followed by blank line and LICENSE
26139
26140 Various pages
26141 Michael Kerrisk
26142 Update info in source comments on where to get a copy of the GPL
26143
26144 Various pages
26145 Michael Kerrisk
26146 Remove "Hey Emacs" comment in page source
26147 Only certain pages have this; there is no consistency, so
26148 remove it from all pages
26149 Michael Kerrisk
26150 Remove "-*- nroff -*-" comment at top of source
26151
26152
26153 ==================== Changes in man-pages-3.50 ====================
26154
26155 Released: 2013-03-15, Munich
26156
26157
26158 Contributors
26159 ------------
26160
26161 The following people contributed patches/fixes or (noted in brackets
26162 in the changelog below) reports, notes, and ideas that have been
26163 incorporated in changes in this release:
26164
26165 Andrey Vagin <avagin@openvz.org>
26166 Bernhard Kuemel <bernhard@bksys.at>
26167 Elie De Brauwer <eliedebrauwer@gmail.com>
26168 Erik Saule <erik.saule@bmi.osu.edu>
26169 Florian Weimer <fweimer@bfk.de>
26170 Friedrich Delgado Friedrichs <friedel@nomaden.org>
26171 Jonathan Nieder <jrnieder@gmail.com>
26172 Jose Luis Domingo Lopez <debian@24x7linux.com>
26173 Mark R Bannister <mark@proseconsulting.co.uk>
26174 Michael Kerrisk <mtk.manpages@gmail.com>
26175 Sam Varshavchik <mrsam@courier-mta.com>
26176 Simon Paillard <spaillard@debian.org>
26177
26178 Apologies if I missed anyone!
26179
26180
26181 New and rewritten pages
26182 -----------------------
26183
26184 canonicalize_file_name.3
26185 Michael Kerrisk
26186 Rewrite page, adding much more detail
26187
26188
26189 Global changes
26190 --------------
26191
26192 Various pages
26193 Michael Kerrisk
26194 Global fix: s/END_LICENSE/LICENSE_END/
26195
26196 Various pages
26197 Michael Kerrisk
26198 Global fix: s/bitmask/bit mask/
26199
26200
26201 Changes to individual pages
26202 ---------------------------
26203
26204 getent.1
26205 Mark R Bannister
26206 netgroup description incorrectly refers to initgroups
26207
26208 capget.2
26209 Michael Kerrisk
26210 Update URL for libcap
26211
26212 fork.2
26213 Michael Kerrisk
26214 Port access permission bits (ioperm()) are turned off in the child
26215
26216 futex.2
26217 Michael Kerrisk
26218 'timeout' is a minimum duration that the call will wait, not a maximum
26219
26220 ioperm.2
26221 Michael Kerrisk
26222 Note that iopl() level of 3 is needed to access ports
26223 Michael Kerrisk
26224 'num' is *bits* not bytes!
26225 Michael Kerrisk
26226 Linux 2.6.8 lifted the port limit to 65,536
26227 See http://article.gmane.org/gmane.linux.kernel/202624/
26228 From: Stas Sergeev <stsp <at> aknet.ru>
26229 Subject: [patch][rfc] Larger IO bitmap
26230 Date: 2004-05-07 19:55:03 GMT
26231 Michael Kerrisk
26232 ioperm() operates on the calling *thread* (not process)
26233 Michael Kerrisk
26234 Clarify meaning of 'turn_on' argument
26235 Plus form formatting fixes.
26236 Michael Kerrisk
26237 Clarify that default state of permission bits in child is off
26238 Michael Kerrisk
26239 NOTES: add mention of /proc/ioports
26240 Michael Kerrisk
26241 SEE ALSO: add outb(2)
26242
26243 iopl.2
26244 Michael Kerrisk
26245 CAP_SYS_RAWIO is required to *raise* the I/O privilege level
26246 Michael Kerrisk
26247 Clarify that the two least significant bits of 'level' are what matter
26248 Michael Kerrisk
26249 SEE ALSO: add outb(2)
26250
26251 syscalls.2
26252 Michael Kerrisk
26253 Add version information for all (other) syscalls
26254 Michael Kerrisk
26255 Add perfmonctl(2)
26256
26257 futimes.3
26258 Michael Kerrisk [Jonathan Nieder]
26259 ERRORS: Add ENOSYS for lutimes()
26260 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=620746
26261
26262 getpass.3
26263 Michael Kerrisk [Erik Saule]
26264 Suggest use of the ECHO flag as an alternative
26265 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=644261
26266
26267 realpath.3
26268 Michael Kerrisk
26269 Document GNU extensions for EACCES and ENOENT errors
26270
26271 stdarg.3
26272 Michael Kerrisk [Friedrich Delgado Friedrichs]
26273 Describe va_copy()
26274 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
26275
26276 termios.3
26277 Michael Kerrisk [Bernhard Kuemel]
26278 Mention that noncanonical mode does not do input processing
26279 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=643854
26280
26281 random.4
26282 Elie De Brauwer
26283 Document write and document the ioctl interface of /dev/random
26284 The update consists out of two parts:
26285 - a minor thing which just documents what happens if a write to
26286 /dev/(u)random is performed, which is used in the example
26287 script but not explicitly mentioned.
26288 - the other (biggest) part is the documentation of the ioctl()
26289 interface which /dev/(u)random exposes. This ioctl() lives in
26290 drivers/char/random.c and the primitives can be found in
26291 include/linux/random.h
26292
26293 One comment remains, there used to be an RNDGETPOOL ioctl() which
26294 disappeared in v2.6.9. I found two patches on the net:
26295 - http://www.kernel.org/pub/linux/kernel/people/akpm/patches/2.6/2.6.8.1/2.6.8.1-mm4/broken-out/dev-random-remove-rndgetpool-ioctl.patch
26296 - https://lkml.org/lkml/2004/3/25/168
26297
26298 But as far as I can tell the first one got applied but the 2nd
26299 one seems more correct. The result is that even today one can
26300 still find traces of the RNDGETPOOL ioctl() in the header files.
26301 Is this there for historical reasons or because it might break
26302 userspace, even though using it will just give an EINVAL.
26303
26304 bootparam.7
26305 Jose Luis Domingo Lopez
26306 Document 'rootfstype' option
26307 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
26308
26309 capabilities.7
26310 Michael Kerrisk
26311 Add various pieces under CAP_SYS_RAWIO
26312 Info obtained by grepping the kernel source.
26313 Michael Kerrisk
26314 Add CAP_SYS_RESOURCE /proc/PID/oom_score_adj case
26315
26316 netlink.7
26317 Andrey Vagin
26318 Add a note about broadcast messages to multiple groups
26319
26320 socket.7
26321 Michael Kerrisk [Florian Weimer]
26322 Define _GNU_SOURCE to obtain the definition of 'struct ucred'
26323 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=572210
26324
26325
26326 ==================== Changes in man-pages-3.51 ====================
26327
26328 Released: 2013-04-17, Munich
26329
26330
26331 Contributors
26332 ------------
26333
26334 The following people contributed patches/fixes or (noted in brackets
26335 in the changelog below) reports, notes, and ideas that have been
26336 incorporated in changes in this release:
26337
26338 Andreas Jaeger <aj@suse.de>
26339 Andrew Clayton <andrew@digital-domain.net>
26340 Brian M. Carlson <sandals@crustytoothpaste.net>
26341 Changhee Han <ch0.han@lge.com>
26342 Cyril Hrubis <chrubis@suse.cz>
26343 Damien Grassart <damien@grassart.com>
26344 David Prévot <taffit@debian.org>
26345 Denis Barbier <bouzim@gmail.com>
26346 Jeff Moyer <jmoyer@redhat.com>
26347 Krzysztof Konopko <krzysztof.konopko@gmail.com>
26348 Kyle McMartin <kyle@mcmartin.ca>
26349 Mark H Weaver <mhw@netris.org>
26350 Michael Kerrisk <mtk.manpages@gmail.com>
26351 Mike Frysinger <vapier@gentoo.org>
26352 Nicolas Hillegeer <nicolas@hillegeer.com>
26353 Pavel Emelyanov <xemul@parallels.com>
26354 Peter Schiffer <pschiffe@redhat.com>
26355 Radek Pazdera <rpazdera@redhat.com>
26356 Ralph Loader <suckfish@ihug.co.nz>
26357 Simon Paillard <spaillard@debian.org>
26358 The Wanderer <wanderer@fastmail.fm>
26359
26360 Apologies if I missed anyone!
26361
26362
26363 Newly documented interfaces in existing pages
26364 ---------------------------------------------
26365
26366 sched_rr_get_interval.2
26367 Michael Kerrisk
26368 Document /proc/sys/kernel/sched_rr_timeslice_ms
26369
26370 proc.5
26371 Pavel Emelyanov
26372 Document /proc/[pid]/map_files directory
26373 This directory was added in Linux v3.3 and provides info about
26374 files being mmap-ed in a way very similar to how /proc/[pid]/fd
26375 works.
26376
26377 v2: Added examples of how links look like and noted dependency
26378 on kernel config option CONFIG_CHECKPOINT_RESTORE.
26379 Michael Kerrisk
26380 Document /proc/sys/kernel/shm_rmid_forced
26381
26382 capabilities.7
26383 Michael Kerrisk
26384 Document /proc/sys/kernel/cap_last_cap
26385
26386
26387 Global changes
26388 --------------
26389
26390 Various pages
26391 Michael Kerrisk
26392 Global fix: fix placement of word "only"
26393
26394 Various pages
26395 Simon Paillard
26396 License headers: consistent format
26397
26398 Various pages
26399 Michael Kerrisk
26400 Global fix: s/since kernel/since Linux/
26401
26402 Various System V IPC pages in Section 2
26403 Michael Kerrisk
26404 Add "System V" to .TH line and text
26405 Make it clear that these pages relate to System V IPC,
26406 not POSIX IPC.
26407
26408
26409 Changes to individual pages
26410 ---------------------------
26411
26412 access.2
26413 Michael Kerrisk [The Wanderer]
26414 Clarify RETURN VALUE for F_OK
26415 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=705293
26416
26417 alarm.2
26418 Michael Kerrisk
26419 Correct the description of behavior when 'seconds' is 0
26420
26421 clone.2
26422 Michael Kerrisk [Peter Schiffer]
26423 Add prototype for syscall to SYNOPSIS
26424 And further clarify the distinction between the system call
26425 and the wrapper function in the introductory text.
26426 Michael Kerrisk
26427 Update feature test macro requirements
26428 The requirements quietly changed in glibc 2.14
26429
26430 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26431 Michael Kerrisk [Mike Frysinger]
26432 Clarify differences between clone2() syscall and wrapper function
26433 Michael Kerrisk [Mike Frysinger]
26434 Note those architectures where the sys_clone argument order differs
26435 Michael Kerrisk [Mike Frysinger]
26436 Add short subsection noting that blackfin, m68k, and sparc are different
26437 Michael Kerrisk
26438 Move clone2() text to subsection in description
26439 The description of ia64 clone2() should follow the discussion
26440 of the raw system call interface.
26441 Michael Kerrisk
26442 Change subhead for ia64 discussion
26443
26444 getcpu.2
26445 Michael Kerrisk
26446 Recommend that 'tcache' should be specified as NULL nowadays
26447
26448 io_cancel.2
26449 Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
26450 Improve description
26451
26452 io_destroy.2
26453 Jeff Moyer
26454 Improve description
26455 The description was rather vague, citing a "list of I/O contexts"
26456 and stating that it "can" cancel outstanding requests. This
26457 update makes things more concrete so that the reader knows exactly
26458 what's going on.
26459
26460 io_getevents.2
26461 Jeff Moyer
26462 The 'timeout' argument is not updated
26463 I looked back through the kernel code, and the timeout was
26464 never updated in any case. I've submitted a patch upstream
26465 to change the comment above io_getevents.
26466
26467 io_setup.2
26468 Jeff Moyer
26469 Clarify nr_events
26470 nr_events is technically the number of completion events that can
26471 be stored in the completion ring. The wording of the man page:
26472 "capable of receiving at least nr_events" seems dubious to me,
26473 only because I worry that folks might interpret that to mean
26474 'nr_events' total, instead of 'nr_events' concurrently.
26475
26476 Further, I've added information on where to find the per-user
26477 limit on 'nr_events', /proc/sys/fs/aio-max-nr. Let me know if
26478 you think that is not relevant.
26479
26480 listxattr.2
26481 Michael Kerrisk
26482 Explain use of 'size' argument
26483
26484 lseek.2
26485 Michael Kerrisk [Andreas Jaeger]
26486 _GNU_SOURCE must be defined to get SEEK_DATA and SEEK_HOLE definitions
26487 See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
26488
26489 mmap.2
26490 Michael Kerrisk
26491 Add pointers to relevant /proc files described in proc(5)
26492
26493 posix_fadvise.2
26494 pread.2
26495 readahead.2
26496 sync_file_range.2
26497 truncate.2
26498 Michael Kerrisk
26499 Refer to syscall(2) for ABI semantics on certain 32-bit architectures
26500 Also: in sync_file_range.2 and posix_fadvise.2 remove description
26501 of conventional calling signature as flawed, and in
26502 posix_fadvise.2, de-emphasize focus on ARM, and rather phrase
26503 as a more general discussion of certain architectures.
26504
26505 readdir.2
26506 Michael Kerrisk
26507 readdir(2) doesn't exist on x86-64
26508
26509 semop.2
26510 Michael Kerrisk
26511 Clarify the discussion of 'semadj'
26512
26513 shmctl.2
26514 Michael Kerrisk
26515 Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
26516
26517 syscall.2
26518 Changhee Han
26519 Add notes that caution users when passing arguments to syscall()
26520 For example, passing 'long long' on ARM-32 requires special
26521 treatment.
26522 Mike Frysinger [Michael Kerrisk]
26523 Document the exact calling convention for architecture system calls
26524 Mike Frysinger [Kyle McMartin]
26525 Add PA-RISC details under calling conventions
26526 Michael Kerrisk [Mike Frysinger]
26527 Refine discussion of ARM and other ABIs
26528
26529 syscalls.2
26530 Michael Kerrisk
26531 Update kernel version number at start of list
26532
26533 umask.2
26534 Michael Kerrisk
26535 SEE ALSO: add acl(5)
26536
26537 unshare.2
26538 Michael Kerrisk
26539 Update feature test macro requirements
26540 The requirements quietly changed in glibc 2.14
26541
26542 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26543
26544 fopencookie.3
26545 Michael Kerrisk [Ralph Loader]
26546 Correct definition of cookie_io_functions_t
26547
26548 pthread_setname_np.3
26549 Andrew Clayton
26550 The thread argument is passed in by value
26551
26552 readir.3
26553 seekdir.3
26554 telldir.3
26555 Michael Kerrisk
26556 Eliminate the implication that these functions deal with "offsets"
26557 The directory position dealt with by the readdir() and
26558 friends is not a simple file offset in modern file systems.
26559 Typically, it is some kind of cookie value. Add text and
26560 make other changes to these pages to eliminate the
26561 implication that this is an offset, and warn the reader
26562 that directory positions should be treated strictly as
26563 opaque values.
26564
26565 In the process, rename the 'offset' argument of seekdir(3)
26566 to 'loc', and add some text to readdir(3) to note that
26567 the 'd_off' field is the same value returned by telldir(3)
26568 at the current directory position.
26569
26570 See also https://lwn.net/Articles/544298/
26571
26572 scalb.3
26573 Mark H Weaver
26574 Fix prototypes for scalbf() and scalbl()
26575
26576 sched_getcpu.3
26577 Michael Kerrisk
26578 Update feature test macro requirements
26579 The requirements quietly changed in glibc 2.14
26580
26581 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26582
26583 ualarm.3
26584 Michael Kerrisk [Nicolas Hillegeer]
26585 Add note on the behavior when 'usecs' is zero
26586 POSIX.1-2001 does not specify the behavior in this case
26587 and no other system that I checked documented the behavior.
26588 Probably, most or all systems do what Linux does in this
26589 case: cancel any pending alarm, just as alarm(0) does.
26590 Add that info in NOTES.
26591
26592 elf.5
26593 Mike Frysinger
26594 Add byte positions for all EI_xxx fields
26595 When describing e_ident, most of the EI_xxx defines mention the
26596 exact byte number. This is useful when manually hacking an ELF
26597 with a hex editor. However, the last few fields don't do this,
26598 which means you have to count things up yourself.
26599 Add a single word to each so you don't have to do that.
26600
26601 proc.5
26602 Michael Kerrisk
26603 Refer to sched_rr_get_interval(2) for info on sched_rr_timeslice_ms
26604 Since Linux 3.9, /proc/sys/kernel/sched_rr_timeslice_ms can
26605 be used to change the SCHED_RR quantum.
26606 Michael Kerrisk
26607 SEE ALSO: Add sysctl(8)
26608 Krzysztof Konopko
26609 Simplify the example of printing out environ
26610 The binutils package contains a very handy utility to
26611 print out null-byte delimited strings from a file. This
26612 can replace a rather complex expression with cat(1)
26613 provided as an example for printing out /proc/[pid]/environ.
26614 Michael Kerrisk
26615 Update /proc/PID/maps example
26616 Update to 64-bit example that includes "[heap]", "[stack],
26617 and "[vdso]"
26618 Michael Kerrisk
26619 Formatting fixes for /proc/PID/maps
26620 Mike Frysinger
26621 Document the "pathname" field of /proc/PID/maps
26622 Michael Kerrisk
26623 Add reference to capabilities(7) for /proc/sys/kernel/cap_last_cap
26624 Michael Kerrisk
26625 /proc/PID/maps: add a reference to mmap(2)
26626
26627 ip.7
26628 Radek Pazdera
26629 Document IP_MULTICAST_ALL
26630 This commit adds documentation for the IP_MULTICAST_ALL socket
26631 option.
26632
26633 The option was added to the Linux kernel in 2.6.31:
26634
26635 Author Nivedita Singhvi <niv@us.ibm.com>
26636 Commit f771bef98004d9d141b085d987a77d06669d4f4f
26637
26638 The description is based on a previous one [3] posted by the
26639 original author of the code -- Nivedita, but it is slightly
26640 re-worded.
26641
26642 I tested it myself and it works as described.
26643
26644 References:
26645 [1] http://lxr.free-electrons.com/source/net/ipv4/ip_sockglue.c#L972
26646 [2] http://lxr.free-electrons.com/source/net/ipv4/igmp.c#L2267
26647 [3] http://patchwork.ozlabs.org/patch/28902/
26648
26649 units.7
26650 Brian M. Carlson
26651 units should use an actual µ
26652 The units(7) man page uses an ASCII u in place of the actual Greek
26653 letter mu. Since we're in the twenty-first century, with
26654 UTF-8-compatible terminals and terminal emulators, we should use
26655 the actual letter µ instead of an ASCII approximation.
26656
26657 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
26658
26659
26660 ==================== Changes in man-pages-3.52 ====================
26661
26662 Released: 2013-07-04, Christchurch
26663
26664
26665 Contributors
26666 ------------
26667
26668 The following people contributed patches/fixes or (noted in brackets
26669 in the changelog below) reports, notes, and ideas that have been
26670 incorporated in changes in this release:
26671
26672 Adrian Bunk <bunk@kernel.org>
26673 Andrea Remondini <andrea@undeadlinks.com>
26674 Anthony Foiani <anthony.foiani@gmail.com>
26675 Brian Norris <computersforpeace@gmail.com>
26676 Cyril Hrubis <chrubis@suse.cz>
26677 Dan Jacobson <jidanni@jidanni.org>
26678 David Prévot <taffit@debian.org>
26679 Eric S. Raymond <esr@thyrsus.com>
26680 Georg Sauthoff <mail@georg.so>
26681 Jeff Moyer <jmoyer@redhat.com>
26682 Jérémie Galarneau <jeremie.galarneau@efficios.com>
26683 Jon Grant <jg@jguk.org>
26684 Manuel Traut <manut@linutronix.de>
26685 Марк Коренберг <socketpair@gmail.com>
26686 Michael Kerrisk <mtk.manpages@gmail.com>
26687 Mike Frysinger <vapier@gentoo.org>
26688 Pavel Emelyanov <xemul@parallels.com>
26689 Peng Haitao <penght@cn.fujitsu.com>
26690 Peter LaDow <petela@gocougs.wsu.edu>
26691 Petr Gajdos <pgajdos@suse.cz>
26692 Regid <regid23@nt1.in>
26693 Siddhesh Poyarekar <siddhesh@redhat.com>
26694 Simone Piccardi <piccardi@truelite.it>
26695 Simon Paillard <spaillard@debian.org>
26696 Vince Weaver <vincent.weaver@maine.edu>
26697 Yuri Kozlov <yuray@komyakino.ru>
26698
26699 Apologies if I missed anyone!
26700
26701
26702 Newly documented interfaces in existing pages
26703 ---------------------------------------------
26704
26705 perf_event_open.2
26706 Vince Weaver
26707 Add PERF_IOC_FLAG_GROUP documentation
26708 The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an
26709 argument, PERF_IOC_FLAG_GROUP. This wasn't documented at all
26710 until about a year ago (despite the support being there from
26711 the beginning) so I missed this when initially writing
26712 the man page.
26713
26714 socket.7
26715 Pavel Emelyanov, Michael Kerrisk
26716 Document SO_PEEK_OFF option
26717 Since Linux 3.4 there appeared an ability to specify the
26718 offset in bytes from which the data will be MSG_PEEK-ed.
26719 Describe this socket option in the socket(7) page, where
26720 all the other socket options are described.
26721
26722
26723 Global changes
26724 --------------
26725
26726 Various pages
26727 Michael Kerrisk
26728 Convert inline formatting (\fX...\fP) to dot-directive formatting
26729
26730 readdir.2
26731 asprintf.
26732 getline.3
26733 getlogin.3
26734 pthread_setname_np.3
26735 readdir.3
26736 strerror.3
26737 Michael Kerrisk [Jon Grant]
26738 Clarify that terminating null byte is '\0'
26739
26740
26741 Changes to individual pages
26742 ---------------------------
26743
26744 execve.2
26745 Peter LaDow
26746 Add envp to the Linux notes about NULL pointers
26747 During the review of static analysis results, we discovered a
26748 functional, but non-portable, use of execve(). For example:
26749
26750 char *cmd[] = { "/path/to/some/file", NULL };
26751 execve(cmd[0], cmd, NULL);
26752
26753 The call succeeds. Yet, the static analysis tool (rightly)
26754 pointed out that envp could be dereferenced. But digging into
26755 glibc and the kernel, it appears that like argv, envp when NULL
26756 is treated as if it were an empty list.
26757
26758 So, to clear things up, I'm submitting this patch to update the
26759 man page to indicate that envp is treated like argv.
26760
26761 fallocate.2
26762 Michael Kerrisk
26763 RETURN VALUE: mention that 'errno' is set on error
26764
26765 io_setup.2
26766 Cyril Hrubis [Jeff Moyer]
26767 Clarify the nr_events parameter
26768 Currently the io_setup.2 man page describes what the kernel really
26769 does, i.e., that the resulting context may be able to hold more
26770 than the 'nr_event's operations because the memory allocated in
26771 kernel is rounded to be multiple of page size.
26772
26773 It is better not to expose this implementation detail and
26774 simply state that the resulting context is suitable for
26775 'nr_events' operations.
26776
26777 perf_event_open.2
26778 Vince Weaver
26779 Clarify the perf_event_open() wakeup_events/wakeup_watermark fields
26780 Clarify the perf_event_open() wakeup_events/wakeup_watermark
26781 fields a bit, based on info from kernel commit cfeb1d90a1b1.
26782 Vince Weaver
26783 Update to match the Linux 3.10 release
26784 This patch updates the perf_event_open() documentation to include
26785 new interfaces added in the 3.10 kernel.
26786
26787 It also documents a few [To be documented] instances left over
26788 from the 3.7 kernel.
26789 Vince Weaver
26790 Small correction to description of 'flags' argument
26791
26792 prctl.2
26793 Michael Kerrisk
26794 Note equivalents of PR_SET_NAME
26795 pthread_setname_np() and pthread_getname_np() and
26796 /proc/self/task/TID/comm provide access to the same
26797 attribute.
26798
26799 pread.2
26800 Michael Kerrisk [Марк Коренберг]
26801 pread() and pwrite() are especially useful in multithreaded applications
26802
26803 recv.2
26804 Michael Kerrisk
26805 RETURN VALUE: mention that 'errno' is set on error
26806
26807 semctl.2
26808 Michael Kerrisk [Simone Piccardi]
26809 'sem_nsems' is 'unsigned long' since Linux 2.4
26810
26811 shmget.2
26812 Michael Kerrisk
26813 Rewrite RETURN VALUE and mention that 'errno' is set on error
26814
26815 sigaction.2
26816 Michael Kerrisk [Brian Norris]
26817 RETURN VALUE: mention that 'errno' is set on error
26818
26819 signal.2
26820 Michael Kerrisk
26821 RETURN VALUE: mention that 'errno' is set on error
26822
26823 sigpending.2
26824 Michael Kerrisk
26825 RETURN VALUE: mention that 'errno' is set on error
26826
26827 sigprocmask.2
26828 Michael Kerrisk
26829 RETURN VALUE: mention that 'errno' is set on error
26830
26831 sigsuspend.2
26832 Michael Kerrisk
26833 RETURN VALUE: mention that 'errno' is set on error
26834
26835 syscall.2
26836 Mike Frysinger
26837 Document s390/s390x calling convention
26838
26839 a64l.3
26840 Peng Haitao
26841 ATTRIBUTES: Note function that is not thread-safe
26842 The function l64a() is not thread safe.
26843
26844 abs.3
26845 Peng Haitao
26846 ATTRIBUTES: Note functions that are thread-safe
26847 The functions abs(), labs(), llabs() and imaxabs() are
26848 thread-safe.
26849
26850 aio_error.3
26851 Peng Haitao
26852 ATTRIBUTES: Note function that is thread-safe
26853 The function aio_error() is thread safe.
26854
26855 aio_return.3
26856 Peng Haitao
26857 ATTRIBUTES: Note function that is thread-safe
26858 The function aio_return() is thread safe.
26859
26860 alloca.3
26861 Adrian Bunk
26862 Correct information on getting non-inlined version with gcc+glibc
26863 - remove the incorrect information that -fno-builtin would help
26864 - add -std=c11 to the list of strict options
26865 - emphasize more that both the gcc option and not including
26866 alloca.h are needed
26867 - add the #ifdef from the glibc alloca.h to make the situation
26868 clearer
26869
26870 bindresvport.3
26871 Peng Haitao
26872 ATTRIBUTES: Note function that is thread-safe
26873 Before glibc 2.17, bindresvport() is not thread-safe.
26874 Since glibc 2.17, it is thread-safe, the patch can refer to URL:
26875 http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5
26876
26877 canonicalize_file_name.3
26878 Michael Kerrisk
26879 Put CONFORMING TO section in right location
26880
26881 catgets.3
26882 Michael Kerrisk [Jon Grant]
26883 Clarify that null byte is '\0'
26884
26885 ceil.3
26886 Peng Haitao
26887 ATTRIBUTES: Note functions that are thread-safe
26888 The functions ceil(), ceilf() and ceill() are thread safe.
26889
26890 cimag.3
26891 Peng Haitao
26892 ATTRIBUTES: Note functions that are thread-safe
26893 The functions cimag(), cimagf() and cimagl() are thread safe.
26894
26895 clock_getcpuclockid.3
26896 Peng Haitao
26897 ATTRIBUTES: Note function that is thread-safe
26898 The function clock_getcpuclockid() is thread safe.
26899
26900 conj.3
26901 Peng Haitao
26902 ATTRIBUTES: Note functions that are thread-safe
26903 The functions conj(), conjf() and conjl() are thread safe.
26904
26905 crypt.3
26906 Peng Haitao
26907 ATTRIBUTES: Note function that is not thread-safe
26908 The function crypt() is not thread safe.
26909
26910 ctermid.3
26911 Peng Haitao
26912 ATTRIBUTES: Note function that is thread safe with exceptions
26913 The function ctermid() is thread safe with exceptions.
26914
26915 dirfd.3
26916 Michael Kerrisk
26917 RETURN VALUE: mention that 'errno' is set on error
26918
26919 drand48.3
26920 Peng Haitao
26921 ATTRIBUTES: Note functions that are not thread-safe
26922 The functions drand48(), erand48(), lrand48(), nrand48(),
26923 mrand48(), jrand48(), srand48(), seed48() and lcong48() are
26924 not thread safe.
26925
26926 ecvt.3
26927 Peng Haitao
26928 ATTRIBUTES: Note functions that are not thread-safe
26929 The functions ecvt() and fcvt() return a string located in a
26930 static buffer which is overwritten by the next call to the
26931 functions, so they are not thread-safe.
26932
26933 encrypt.3
26934 Peng Haitao
26935 ATTRIBUTES: Note functions that are not thread-safe
26936 The functions encrypt() and setkey() are not thread safe.
26937
26938 ether_aton.3
26939 Peng Haitao
26940 ATTRIBUTES: Note functions that are not thread-safe
26941 The functions ether_aton() and ether_ntoa() are not thread safe.
26942
26943 fcloseall.3
26944 Peng Haitao
26945 ATTRIBUTES: Note function that is not thread-safe
26946 The function fcloseall() is not thread safe.
26947
26948 ferror.3
26949 Peng Haitao
26950 ATTRIBUTES: Note functions that are thread-safe
26951 The functions ferror(), clearerr(), feof() and fileno() are
26952 thread safe.
26953
26954 fgetgrent.3
26955 Michael Kerrisk
26956 RETURN VALUE: mention that 'errno' is set on error
26957
26958 fgetpwent.3
26959 Michael Kerrisk
26960 RETURN VALUE: mention that 'errno' is set on error
26961
26962 fgetwc.3
26963 Michael Kerrisk
26964 RETURN VALUE: mention that 'errno' is set on error
26965
26966 fmtmsg.3
26967 Peng Haitao
26968 ATTRIBUTES: Note function that is thread-safe
26969 Before glibc 2.16, fmtmsg() is not thread-safe.
26970 Since glibc 2.16, it is thread-safe, the patch can refer to URL:
26971 http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94
26972
26973 fputwc.3
26974 Michael Kerrisk
26975 RETURN VALUE: mention that 'errno' is set on error
26976
26977 getdate.3
26978 Peng Haitao
26979 ATTRIBUTES: Note functions that are and aren't thread-safe
26980
26981 getgrent.3
26982 Peng Haitao
26983 ATTRIBUTES: Note function that is not thread-safe
26984 The function getgrent() is not thread safe.
26985
26986 getgrnam.3
26987 Peng Haitao
26988 ATTRIBUTES: Note functions that are and aren't thread-safe
26989
26990 getline.3
26991 Michael Kerrisk
26992 RETURN VALUE: mention that 'errno' is set on error
26993
26994 getlogin.3
26995 Peng Haitao
26996 ATTRIBUTES: Note function that is not thread-safe
26997 The function getlogin() is not thread safe.
26998 The function cuserid() is thread-safe with exceptions.
26999 Michael Kerrisk
27000 RETURN VALUE: mention that 'errno' is set on error
27001
27002 getpass.3
27003 Peng Haitao
27004 ATTRIBUTES: Note functions that are not thread-safe
27005
27006 getpwent.3
27007 Peng Haitao
27008 ATTRIBUTES: Note function that is not thread-safe
27009 The function getpwent() is not thread safe.
27010
27011 getpwnam.3
27012 Peng Haitao
27013 ATTRIBUTES: Note functions that are and aren't thread-safe
27014
27015 getspnam.3
27016 Michael Kerrisk
27017 RETURN VALUE: mention that 'errno' is set on error
27018
27019 getttyent.3
27020 Peng Haitao
27021 ATTRIBUTES: Note functions that are not thread-safe
27022
27023 getusershell.3
27024 Peng Haitao
27025 ATTRIBUTES: Note functions that are not thread-safe
27026 The functions getusershell(), setusershell() and endusershell()
27027 are not thread safe.
27028
27029 getutent.3
27030 Michael Kerrisk
27031 RETURN VALUE: mention that 'errno' is set on error
27032
27033 hsearch.3
27034 Michael Kerrisk
27035 RETURN VALUE: mention that 'errno' is set on error
27036
27037 hsearch.3
27038 Peng Haitao
27039 ATTRIBUTES: Note functions that are not thread-safe
27040 The functions hsearch(), hcreate() and hdestroy() are not
27041 thread-safe.
27042
27043 localeconv.3
27044 Peng Haitao
27045 ATTRIBUTES: Note functions that are not thread-safe
27046 The function localeconv() returns a pointer to a structure which
27047 might be overwritten by subsequent calls to localeconv() or by
27048 calls to setlocale(), so it is not thread-safe.
27049 Peng Haitao
27050 Add RETURN VALUE section
27051
27052 malloc_info.3
27053 Michael Kerrisk
27054 RETURN VALUE: mention that 'errno' is set on error
27055
27056 mblen.3
27057 Peng Haitao
27058 ATTRIBUTES: Note function that is not thread-safe
27059 The function mblen() is not thread safe.
27060
27061 mbrlen.3
27062 Peng Haitao
27063 ATTRIBUTES: Note function that is thread safe with exceptions
27064 The function mbrlen() is thread safe with exceptions.
27065
27066 mbrtowc.3
27067 Peng Haitao
27068 ATTRIBUTES: Note function that is thread safe with exceptions
27069 The function mbrtowc() is thread safe with exceptions.
27070
27071 mktemp.3
27072 Michael Kerrisk
27073 RETURN VALUE: mention that 'errno' is set on error
27074
27075 modf.3
27076 Peng Haitao
27077 ATTRIBUTES: Note functions that are thread-safe
27078 The functions modf(), modff() and modfl() are thread safe.
27079
27080 popen.3
27081 Michael Kerrisk
27082 RETURN VALUE: mention that 'errno' is set on error
27083
27084 pthread_attr_setinheritsched.3
27085 Michael Kerrisk
27086 Note the scheduling attributes affected by this function
27087
27088 pthread_attr_setschedparam.3
27089 pthread_attr_setschedpolicy.3
27090 pthread_attr_setscope.3
27091 Michael Kerrisk [Manuel Traut, Siddhesh Poyarekar]
27092 The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED
27093 In order for the attributes set by these functions to have
27094 an effect, the caller must use pthread_attr_setinheritsched(3)
27095 to set the inherit-scheduler attribute of the attributes object
27096 to PTHREAD_EXPLICIT_SCHED.
27097
27098 ptsname.3
27099 Peng Haitao
27100 ATTRIBUTES: Note function that is not thread-safe
27101 The function ptsname() is not thread safe.
27102
27103 putenv.3
27104 Michael Kerrisk
27105 RETURN VALUE: mention that 'errno' is set on error
27106
27107 putpwent.3
27108 Michael Kerrisk
27109 RETURN VALUE: mention that 'errno' is set on error
27110
27111 qecvt.3
27112 Peng Haitao
27113 ATTRIBUTES: Note functions that are not thread-safe
27114 The functions qecvt() and qfcvt() are not thread-safe.
27115
27116 random.3
27117 Michael Kerrisk
27118 RETURN VALUE: mention that 'errno' is set on error
27119 Michael Kerrisk
27120 Add EINVAL error for setstate()
27121 Michael Kerrisk
27122 BUGS: initstate() does not return NULL on error
27123 http://sourceware.org/bugzilla/show_bug.cgi?id=15380
27124
27125 random_r.3
27126 Michael Kerrisk
27127 RETURN VALUE: mention that 'errno' is set on error
27128
27129 readdir.3
27130 Peng Haitao
27131 ATTRIBUTES: Note functions that are not thread-safe
27132 The data returned by readdir() may be overwritten by subsequent
27133 calls to readdir() for the same directory stream, so it is not
27134 thread-safe.
27135
27136 re_comp.3
27137 Peng Haitao
27138 ATTRIBUTES: Note functions that are not thread-safe
27139 The functions re_comp() and re_exec() are not thread safe.
27140
27141 rexec.3
27142 Peng Haitao
27143 ATTRIBUTES: Note functions that are not thread-safe
27144 The functions rexec() and rexec_af() are not thread safe.
27145
27146 round.3
27147 Peng Haitao
27148 ATTRIBUTES: Note functions that are thread-safe
27149 The functions round(), roundf() and roundl() are thread safe.
27150
27151 scalbln.3
27152 Peng Haitao
27153 ATTRIBUTES: Note functions that are thread-safe
27154 The functions scalbn(), scalbnf(), scalbnl(), scalbln(),
27155 scalblnf() and scalblnl() are thread safe.
27156
27157 scandir.3
27158 Michael Kerrisk
27159 RETURN VALUE: mention that 'errno' is set on error
27160
27161 siginterrupt.3
27162 Michael Kerrisk
27163 RETURN VALUE: mention that 'errno' is set on error
27164
27165 signbit.3
27166 Peng Haitao
27167 ATTRIBUTES: Note macro that is thread-safe
27168 The macro signbit() is thread safe.
27169
27170 sigsetops.3
27171 Michael Kerrisk
27172 RETURN VALUE: mention that 'errno' is set on error
27173
27174 stdio_ext.3
27175 Peng Haitao
27176 ATTRIBUTES: Note functions that are not thread-safe
27177 The functions __fbufsize(), __fpending(), __fpurge() and
27178 __fsetlocking() are not thread safe.
27179
27180 strdup.3
27181 Michael Kerrisk
27182 RETURN VALUE: mention that 'errno' is set on error
27183
27184 strerror.3
27185 Peng Haitao
27186 ATTRIBUTES: Note function that is not thread-safe
27187 The function strerror() is not thread safe.
27188
27189 strftime.3
27190 Michael Kerrisk
27191 Clarify details of return value
27192 Michael Kerrisk
27193 BUGS: 'errno' is not set if the result string would exceed 'max' bytes
27194
27195 strtok.3
27196 Peng Haitao
27197 ATTRIBUTES: Note function that is not thread-safe
27198 The function strtok() is not thread safe.
27199 Michael Kerrisk [Georg Sauthoff]
27200 Add more detail on the operation of strtok()
27201 Add a number of missing details on the operation of strtok()
27202
27203 tempnam.3
27204 Michael Kerrisk
27205 RETURN VALUE: mention that 'errno' is set on error
27206
27207 timegm.3
27208 Jérémie Galarneau
27209 copy the string returned by getenv()
27210 The example of a portable version of timegm() uses the string
27211 returned by getenv() after calling setenv() on the same
27212 environment variable. The tz string may be invalid as per
27213 getenv.3:
27214
27215 "The string pointed to by the return value of getenv()
27216 may be statically allocated, and can be modified by a
27217 subsequent call to getenv(), putenv(3), setenv(3), or
27218 unsetenv(3)."
27219
27220 tmpnam.3
27221 Peng Haitao
27222 ATTRIBUTES: Note function that is thread safe with exceptions
27223 The function tmpnam() is thread safe with exceptions.
27224
27225 trunc.3
27226 Peng Haitao
27227 ATTRIBUTES: Note functions that are thread-safe
27228 The functions trunc(), truncf() and truncl() are thread safe.
27229
27230 ttyname.3
27231 Michael Kerrisk
27232 ATTRIBUTES: Note functions that are and aren't thread-safe
27233
27234 ttyslot.3
27235 Michael Kerrisk
27236 ATTRIBUTES: Note functions that are not thread-safe
27237
27238 usleep.3
27239 Michael Kerrisk
27240 RETURN VALUE: mention that 'errno' is set on error
27241
27242 wcsdup.3
27243 Michael Kerrisk
27244 RETURN VALUE: mention that 'errno' is set on error
27245
27246 core.5
27247 Michael Kerrisk
27248 Implicitly adding the PID to a core filename was dropped in 2.6.27
27249
27250 proc.5
27251 Michael Kerrisk
27252 Document /proc/[pid]/fd/ anon_inode symlinks
27253 Mike Frysinger
27254 Document /proc/[pid]/fd/ symlinks a bit more
27255 Describe the type:[inode] syntax used in this dir
27256
27257 bootparam.7
27258 Michael Kerrisk [Dan Jacobson]
27259 Remove outdated text on LILO and LoadLin
27260 Strike the discussion of LILO and LoadLin, which
27261 are long obsolete, and make a brief mention of GRUB.
27262 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019
27263 Regid
27264 Remove mention of the deprecated rdev(8)
27265 The deprecated rdev(8) command was removed from util-linux in 2010.
27266 See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO
27267 Andrea Remondini
27268 Document the 'resume' boot parameter
27269
27270 inotify.7
27271 Michael Kerrisk [Jon Grant]
27272 Clarify that null byte is '\0'
27273
27274 iso_8859-2.7
27275 Eric S. Raymond
27276 Remove incorrect reference to nonexistent groff glyph \[shc]
27277 The reference incorrectly attempted to duplicate an
27278 actual soft hyphen (hex 0xad) just before it in the file.
27279
27280 man-pages.7
27281 Peng Haitao
27282 Add description of "ATTRIBUTES"
27283 "ATTRIBUTES" section can mention thread safety,
27284 cancellation safety, and async-cancel-safety.
27285
27286 socket.7
27287 Michael Kerrisk
27288 Note that 'optval' for socket options is an 'int' in most cases
27289
27290 tcp.7
27291 Michael Kerrisk
27292 Note that 'optval' for socket options is an 'int' in most cases
27293
27294 udp.7
27295 Michael Kerrisk
27296 Note that 'optval' for socket options is an 'int' in most cases
27297
27298
27299 ==================== Changes in man-pages-3.53 ====================
27300
27301 Released: 2013-07-31, Munich
27302
27303
27304 Contributors
27305 ------------
27306
27307 The following people contributed patches/fixes or (noted in brackets
27308 in the changelog below) reports, notes, and ideas that have been
27309 incorporated in changes in this release:
27310
27311 Al Viro <viro@ZenIV.linux.org.uk>
27312 Andrey Vagin <avagin@openvz.org>
27313 Benjamin Poirier <bpoirier@suse.de>
27314 Chris Heath <chris@heathens.co.nz>
27315 Chuck Coffing <clc@alum.mit.edu>
27316 David Prévot <taffit@debian.org>
27317 Denys Vlasenko <dvlasenk@redhat.com>
27318 Dmitry V. Levin <ldv@altlinux.org>
27319 Felix Schulte <Felix_Schulte@McAfee.com>
27320 Graud <graud@gmx.com>
27321 Michael Kerrisk <mtk.manpages@gmail.com>
27322 Oleg Nesterov <oleg@redhat.com>
27323 Peng Haitao <penght@cn.fujitsu.com>
27324 Peter Schiffer <pschiffe@redhat.com>
27325 Simon Paillard <spaillard@debian.org>
27326 Vince Weaver <vincent.weaver@maine.edu>
27327
27328 Apologies if I missed anyone!
27329
27330
27331 New and rewritten pages
27332 -----------------------
27333
27334 restart_syscall.2
27335 Michael Kerrisk
27336 New page for restart_syscall(2) system call
27337
27338
27339 Newly documented interfaces in existing pages
27340 ---------------------------------------------
27341
27342 fchownat.2
27343 Michael Kerrisk
27344 Document AT_EMPTY_PATH
27345
27346 fstatat.2
27347 Michael Kerrisk
27348 Document AT_EMPTY_PATH
27349
27350 linkat.2
27351 Michael Kerrisk
27352 Document AT_EMPTY_PATH
27353
27354 open.2
27355 Michael Kerrisk [Al Viro]
27356 Document O_PATH
27357 See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
27358
27359
27360 Changes to individual pages
27361 ---------------------------
27362
27363 clock_nanosleep.2
27364 futex.2
27365 nanosleep.2
27366 poll.2
27367 sigaction.2
27368 sigreturn.2
27369 signal.7
27370 Michael Kerrisk
27371 SEE ALSO: add restart_syscall(2)
27372
27373 open.2
27374 Michael Kerrisk [Geoffrey Thomas]
27375 Remove warning that O_DIRECTORY is only for use with opendir(3)
27376 O_DIRECTORY can also be used with, for example, O_PATH.
27377
27378 perf_event_open.2
27379 Vince Weaver
27380 Improve PERF_SAMPLE_BRANCH_STACK documentation
27381 Vince Weaver
27382 Fix indentation of the MMAP layout section
27383 The indentation of the MMAP layout section wasn't quite right.
27384 I think this improves things but I admit I'm not an expert at the
27385 low-level indentation directives.
27386 Vince Weaver
27387 Update PERF_IOC_FLAG_GROUP info
27388 It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9
27389 (in Linux 2.6.31, the initial perf_event release) until
27390 724b6daa1 (Linux 3.4).
27391
27392 I've done some extensive kernel source code digging plus
27393 running tests of various kernels and I hope the info
27394 presented is accurate now.
27395
27396 (Patch edited somewhat by mtk.)
27397 Vince Weaver
27398 Improve sysfs files documentation
27399 This improves the documentation of the various
27400 perf_event_open()-related sysfs files.
27401
27402 ptrace.2
27403 Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
27404 If SEIZE was used, initial auto-attach stop is EVENT_STOP
27405 For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP
27406 is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used.
27407
27408 Mention the same thing again in the description of
27409 PTRACE_EVENT_STOP.
27410 Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
27411 Mention that PTRACE_PEEK* libc API and kernel API are different
27412 Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin]
27413 Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior
27414
27415 readlink.2
27416 Michael Kerrisk
27417 Document use of empty 'pathname' argument
27418 Michael Kerrisk
27419 Change error check in example program from "< 0" to "== -1"
27420 Chuck Coffing
27421 Fix possible race condition in readlink.2 example
27422 I noticed that the example in the readlink.2 man pages does error
27423 checking for a race condition that would cause the value of the
27424 symbolic link to get larger. However, it doesn't handle the
27425 opposite case, in which the value gets shorter. (The NULL
27426 terminator is always set at the old, longer offset.) This could
27427 cause the program to operate on uninitialized data.
27428
27429 setpgid.2
27430 Michael Kerrisk [Graud]
27431 s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
27432 See https://bugzilla.kernel.org/show_bug.cgi?id=60504
27433
27434 clog2.3
27435 Michael Kerrisk
27436 Note that these functions are still not present in glibc 2.17
27437
27438 dirfd.3
27439 Peng Haitao
27440 ATTRIBUTES: Note function that is thread-safe
27441 The function dirfd() is thread safe.
27442
27443 div.3
27444 Peng Haitao
27445 ATTRIBUTES: Note functions that are thread-safe
27446 The functions div(), ldiv(), lldiv() and imaxdiv() are thread
27447 safe.
27448
27449 fabs.3
27450 Peng Haitao
27451 ATTRIBUTES: Note functions that are thread-safe
27452 The functions fabs(), fabsf() and fabsl() are thread safe.
27453
27454 fdim.3
27455 Peng Haitao
27456 ATTRIBUTES: Note functions that are thread-safe
27457 The functions fdim(), fdimf() and fdiml() are thread safe.
27458
27459 fflush.3
27460 Peng Haitao
27461 ATTRIBUTES: Note function that is thread-safe
27462 The function fflush() is thread safe.
27463
27464 finite.3
27465 Peng Haitao
27466 ATTRIBUTES: Note functions that are thread-safe
27467 The functions finite(), finitef(), finitel(), isinf(), isinff(),
27468 isinfl(), isnan(), isnanf() and isnanl() are thread safe.
27469
27470 flockfile.3
27471 Peng Haitao
27472 ATTRIBUTES: Note functions that are thread-safe
27473 The functions flockfile(), ftrylockfile() and funlockfile() are
27474 thread safe.
27475
27476 floor.3
27477 Peng Haitao
27478 ATTRIBUTES: Note functions that are thread-safe
27479 The functions floor(), floorf() and floorl() are thread safe.
27480
27481 resolv.conf.5
27482 Simon Paillard
27483 Explain how to set empty domain
27484 See http://bugs.debian.org/463575
27485
27486 capabilities.7
27487 Michael Kerrisk
27488 Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
27489
27490 inotify.7
27491 Michael Kerrisk [Felix Schulte]
27492 Clarify description of IN_MOVED_FROM and IN_MOVED_TO
27493
27494 man-pages.7
27495 Michael Kerrisk
27496 DESCRIPTION should note versions for new interface features or behavior
27497
27498 udp.7
27499 Benjamin Poirier
27500 Add missing #include directive
27501 Using the UDP_CORK socket option documented in udp.7 requires
27502 including <netinet/udp.h>.
27503
27504 ld.so.8
27505 Michael Kerrisk
27506 Rework rpath token expansion text
27507 Michael Kerrisk
27508 Describe $PLATFORM rpath token
27509 Michael Kerrisk
27510 Describe $LIB rpath token
27511 Michael Kerrisk
27512 Document LD_BIND_NOT
27513 Michael Kerrisk [Simon Paillard]
27514 Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL
27515
27516
27517 ==================== Changes in man-pages-3.54 ====================
27518
27519 Released: 2013-09-17, Munich
27520
27521
27522 Contributors
27523 ------------
27524
27525 The following people contributed patches/fixes or (noted in brackets
27526 in the changelog below) reports, notes, and ideas that have been
27527 incorporated in changes in this release:
27528
27529 A. Costa <agcosta@gis.net>
27530 Akihiro MOTOKI <amotoki@gmail.com>
27531 Andreas Wiese <aw-lkml@instandbesetzt.net>
27532 Andrew Hunter <andrewhhunter@gmail.com>
27533 Chen Gang <gang.chen@asianux.com>
27534 Christopher Hall <chall0@gmail.com>
27535 Christos Tsopokis <christos@tsopokis.gr>
27536 David Prévot <taffit@debian.org>
27537 D. Barbier <bouzim@gmail.com>
27538 Doug Goldstein <cardoe@cardoe.com>
27539 Elie De Brauwer <eliedebrauwer@gmail.com>
27540 Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
27541 Felix Janda <felix.janda@posteo.de>
27542 G.raud <graud@gmx.com>
27543 Hannes Landeholm <hannes@jumpstarter.io>
27544 J. Bruce Fields <bfields@fieldses.org>
27545 J. Bruce Fields <bfields@redhat.com>
27546 Johan Erlandsson <jeoerl@gmail.com>
27547 Jon Grant <jg@jguk.org>
27548 Magnus Reftel <magnus.reftel@gmail.com>
27549 Marko Myllynen <myllynen@redhat.com>
27550 Michael Kerrisk <mtk.manpages@gmail.com>
27551 Oleg Nesterov <oleg@redhat.com>
27552 Peng Haitao <penght@cn.fujitsu.com>
27553 Peter Schiffer <pschiffe@redhat.com>
27554 Robert Harris <robert.harris@fixnetix.com>
27555 Rodrigo Campos <rodrigo@sdfg.com.ar>
27556 Simon Paillard <spaillard@debian.org>
27557 Stas <stas.grumbler@gmail.com>
27558 Vince Weaver <vincent.weaver@maine.edu>
27559 Will Newton <will.newton@linaro.org>
27560 Zdenek Pavlas <zpavlas@redhat.com>
27561 Zsbán Ambrus <ambrus@math.bme.hu>
27562
27563 Apologies if I missed anyone!
27564
27565
27566
27567 Newly documented interfaces in existing pages
27568 ---------------------------------------------
27569
27570 ioctl_list.2
27571 Zsbán Ambrus
27572 Document FAT_IOCTL_GET_ATTRIBUTES
27573 The attached patch adds four ioctls from linux/msdos_fs.h to the
27574 ioctl_list(2) manpage.
27575
27576 The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a
27577 file a mounted vfat file system. I tested this on Linux
27578 2.6.33, an example script can be found at
27579 http://www.perlmonks.com/?node_id=832623
27580
27581
27582 Global changes
27583 --------------
27584
27585 Various pages
27586 Michael Kerrisk
27587 Global fix: s/file system/filesystem/
27588 Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c,
27589 "filesystem" is the form used by the great majority of man pages
27590 outside the man-pages project and in a number of other sources,
27591 so let's go with that.
27592
27593
27594 Changes to individual pages
27595 ---------------------------
27596
27597 access.2
27598 J. Bruce Fields
27599 Fix outdated NFS information
27600 Note that NFS versions since version 3 support an "access" call
27601 so that the client doesn't have to guess permissions or ID
27602 mapping on its own.
27603
27604 (See RFC 1813 sections 1.7 and 3.3.4.)
27605
27606 adjtimex.2
27607 Michael Kerrisk
27608 SEE ALSO: Add adjtimex(8)
27609
27610 clock_getres.2
27611 Michael Kerrisk [Rodrigo Campos]
27612 Note circumstances in which "SMP" note applies.
27613 Michael Kerrisk
27614 Add kernel version for CLOCK_*_CPUTIME_ID
27615 CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID
27616 appeared in 2.6.12.
27617 Michael Kerrisk
27618 Add VERSIONS section
27619
27620 futex.2
27621 Michael Kerrisk
27622 The 'timeout' can be rounded upwards by clock granularity and also overrun
27623
27624 kill.2
27625 Michael Kerrisk
27626 Small improvements to text on historical rules for permissions
27627
27628 nfsservctl.2
27629 Michael Kerrisk
27630 Note commands that were only in Linux 2.4.x and earlier
27631
27632 open.2
27633 Robert Harris
27634 Add mmap(2) to list of calls that fail when given an O_PATH descriptor
27635 Doug Goldstein
27636 Add EINVAL to errors list
27637 EINVAL can be returned by open(2) when the underlying filesystem
27638 doesn't support O_DIRECT. It is documented in the NOTES section
27639 but this patch adds it to the list of possible errors.
27640
27641 perf_event_open.2
27642 Vince Weaver
27643 PERF_SAMPLE_BRANCH_STACK updates
27644 This started out as just adding the new perf_event_open features
27645 from Linux 3.11 (which was the addition of transactional memory
27646 defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a
27647 general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation.
27648
27649 The main clarification is that at least one of the non-privilege
27650 values must be set or else perf_event_open() will return an EINVAL
27651 error.
27652 Michael Kerrisk
27653 Reorder text describing fields of 'perf_event_header' structure
27654 Place the fields with the shorter descriptions first, to make the
27655 information easier to read.
27656
27657 poll.2
27658 Michael Kerrisk
27659 Clarify wording of 'timeout' as a "minimum" interval
27660
27661 sched_setaffinity.2
27662 Michael Kerrisk [Christos Tsopokis]
27663 Clarify that these system calls affect a per-thread attribute
27664
27665 sched_setparam.2
27666 Michael Kerrisk
27667 Clarify that this system call applies to threads (not processes)
27668
27669 sched_setscheduler.2
27670 Michael Kerrisk
27671 Clarify that this system call applies to threads (not processes)
27672
27673 select.2
27674 Michael Kerrisk [G.raud]
27675 Clarify wording of 'timeout' as a "minimum" interval
27676
27677 setfsgid.2
27678 Michael Kerrisk [Oleg Nesterov]
27679 Clarify description of return value
27680 More clearly describe the weirdness in the return value of this
27681 system call, and note the problems it creates in BUGS
27682 Michael Kerrisk
27683 Correct header file in SYNOPSIS
27684 Michael Kerrisk
27685 Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete
27686 Michael Kerrisk
27687 Wording improvements
27688
27689 setfsuid.2
27690 Michael Kerrisk [Oleg Nesterov]
27691 Clarify description of return value
27692 More clearly describe the weirdness in the return value of this
27693 system call, and note the problems it creates in BUGS
27694 Michael Kerrisk [Chen Gang]
27695 Clarify historical details and note that setfsuid() is obsolete
27696 Michael Kerrisk
27697 Wording improvements
27698 Michael Kerrisk
27699 Correct header file in SYNOPSIS
27700
27701 sigwaitinfo.2
27702 Michael Kerrisk
27703 Clarify wording of 'timeout' as a "minimum" interval
27704
27705 syscall.2
27706 Johan Erlandsson
27707 Add missing argument in example
27708 Johan Erlandsson
27709 Correct registers for arm/EABI
27710 Registers was off by one.
27711
27712 Reference:
27713 http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4
27714
27715 See also:
27716 http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx
27717 https://wiki.debian.org/ArmEabiPort
27718 http://en.wikipedia.org/wiki/Calling_convention#ARM
27719
27720 wait.2
27721 Michael Kerrisk [Hannes Landeholm]
27722 Add details on the fifth argument provided by raw waitid() system call
27723 See https://bugzilla.kernel.org/show_bug.cgi?id=60744
27724
27725 clock.3
27726 Michael Kerrisk
27727 clock() switched from using times(2) to clock_gettime() in glibc 2.18
27728
27729 drand48_r.3
27730 Peng Haitao
27731 ATTRIBUTES: Note functions that are thread-safe
27732 The functions drand48_r(), erand48_r(), lrand48_r(),
27733 nrand48_r(), mrand48_r(), jrand48_r(), srand48_r(), seed48_r(),
27734 and lcong48_r() are thread safe.
27735
27736 fma.3
27737 Peng Haitao
27738 ATTRIBUTES: Note functions that are thread-safe
27739 The functions fma(), fmaf() and fmal() are thread safe.
27740
27741 fmax.3
27742 Peng Haitao
27743 ATTRIBUTES: Note functions that are thread-safe
27744 The functions fmax(), fmaxf() and fmaxl() are thread safe.
27745
27746 fmin.3
27747 Peng Haitao
27748 ATTRIBUTES: Note functions that are thread-safe
27749 The functions fmin(), fminf() and fminl() are thread safe.
27750
27751 fpclassify.3
27752 Peng Haitao
27753 ATTRIBUTES: Note functions that are thread-safe
27754 The functions fpclassify(), isfinite(), isnormal(), isnan(), and
27755 isinf() are thread safe.
27756
27757 frexp.3
27758 Peng Haitao
27759 ATTRIBUTES: Note functions that are thread-safe
27760 The functions frexp(), frexpf() and frexpl() are thread safe.
27761
27762 gethostbyname.3
27763 Michael Kerrisk [Jon Grant]
27764 gai_strerror() is the modern replacement for herror() and hstrerror()
27765 Michael Kerrisk
27766 Update feature test macro requirements for herror() and hstrerror()
27767 Michael Kerrisk
27768 Add feature test macro requirements for h_errno
27769
27770 ilogb.3
27771 Peng Haitao
27772 ATTRIBUTES: Note functions that are thread-safe
27773 The functions ilogb(), ilogbf() and ilogbl() are thread safe.
27774
27775 ldexp.3
27776 Peng Haitao
27777 ATTRIBUTES: Note functions that are thread-safe
27778 The functions ldexp(), ldexpf() and ldexpl() are thread safe.
27779
27780 lrint.3
27781 Peng Haitao
27782 ATTRIBUTES: Note functions that are thread-safe
27783 The functions lrint(), lrintf(), lrintl(), llrint(), llrintf(),
27784 and llrintl() are thread safe.
27785
27786 lround.3
27787 Peng Haitao
27788 ATTRIBUTES: Note functions that are thread-safe
27789 The functions lround(), lroundf(), lroundl(), llround(),
27790 llroundf() and llroundl() are thread safe.
27791
27792 lseek64.3
27793 Peng Haitao
27794 ATTRIBUTES: Note function that is thread-safe
27795 The function lseek64() is thread safe.
27796
27797 mbsinit.3
27798 Peng Haitao
27799 ATTRIBUTES: Note function that is thread-safe
27800 The function mbsinit() is thread safe.
27801
27802 nextafter.3
27803 Peng Haitao
27804 ATTRIBUTES: Note functions that are thread-safe
27805 The functions nextafter(), nextafterf(), nextafterl(),
27806 nexttoward(), nexttowardf() and nexttowardl() are thread safe.
27807
27808 posix_memalign.3
27809 Michael Kerrisk [Will Newton]
27810 'errno" is indeterminate after a call to posix_memalign()
27811 Michael Kerrisk [Will Newton]
27812 Clarify wording on "return value" when size==0
27813
27814 printf.3
27815 Christopher Hall
27816 Correctly describe the meaning of a negative precision
27817 The printf(3) manpage says that a negative precision is taken to
27818 be zero, whereas printf(3p) says that a negative precision is
27819 taken as if the precision were omitted. glibc agrees with the
27820 latter (POSIX) specification.
27821
27822 Test code:
27823
27824 printf("%f\n",42.0); // "42.000000"
27825 printf("%.*f\n",0,42.0); // "42"
27826 printf("%.*f\n",-1,42.0); // "42.000000"
27827
27828 This patch corrects the explanation to match what actually happens.
27829
27830 rewinddir.3
27831 Peng Haitao
27832 ATTRIBUTES: Note function that is thread-safe
27833 The function rewinddir() is thread safe.
27834
27835 rint.3
27836 Peng Haitao
27837 ATTRIBUTES: Note functions that are thread-safe
27838 The functions nearbyint(), nearbyintf(), nearbyintl(), rint(),
27839 rintf() and rintl() are thread safe.
27840
27841 seekdir.3
27842 Peng Haitao
27843 ATTRIBUTES: Note function that is thread-safe
27844 The function seekdir() is thread safe.
27845
27846 telldir.3
27847 Peng Haitao
27848 ATTRIBUTES: Note function that is thread-safe
27849 The function telldir() is thread safe.
27850
27851 wctomb.3
27852 Peng Haitao
27853 ATTRIBUTES: Note function that is not thread-safe
27854 The function wctomb() is not thread safe.
27855
27856 wavelan.4
27857 Michael Kerrisk [Elie De Brauwer]
27858 This driver disappeared in 2.56.35
27859
27860 dir_colors.5
27861 Michael Kerrisk [Stas]
27862 Add various synonyms
27863 See http://bugs.debian.org/553477
27864 Simon Paillard [Stas]
27865 Add keywords SUID, SGID, STICKY, STICKY_OTHER_WRITABLE, OTHER_WRITABLE
27866 See http://bugs.debian.org/553477
27867 See ls.c and dircolors.c in coreutils
27868
27869 proc.5
27870 Peter Schiffer
27871 Document /proc/[pid]/io file
27872 Attempt to document fields in the /proc/[pid]/io file, based on
27873 the Documentation/filesystems/proc.txt. The text will probably
27874 need some grammar corrections.
27875 Michael Kerrisk [Marko Myllynen]
27876 /proc/sys/fs/inode-max went away in Linux 2.4
27877 Also, the 'preshrink' field in /proc/sys/fs/inode-state became
27878 a dummy value in Linux 2.4.
27879
27880 See https://bugzilla.kernel.org/show_bug.cgi?id=60836
27881 Michael Kerrisk [A. Costa]
27882 Note block size used by /proc/partitions
27883 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=666972
27884 Michael Kerrisk
27885 Add rationale on drop_caches and note that it can hurt performance
27886 See also http://lwn.net/Articles/562211/
27887
27888 bootparam.7
27889 Michael Kerrisk [Eugen Dedu]
27890 Remove "lilo" entries from SEE ALSO
27891 See http://bugs.debian.org/604019
27892
27893 inotify.7
27894 Michael Kerrisk
27895 SEE ALSO: add inotifywait(1) and inotifywatch(1)
27896
27897 ip.7
27898 Simon Paillard
27899 IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility)
27900 Kernel added compatibility only recently in
27901 3a084ddb4bf299a6e898a9a07c89f3917f0713f7
27902 See: http://bugs.debian.org/607979
27903
27904 standards.7
27905 Michael Kerrisk
27906 Add mention of SUSv4-TC1 (POSIX.1-2013)
27907
27908
27909 ==================== Changes in man-pages-3.55 ====================
27910
27911 Released: 2013-12-12, Christchurch
27912
27913
27914 Contributors
27915 ------------
27916
27917 The following people contributed patches/fixes or (noted in brackets
27918 in the changelog below) reports, notes, and ideas that have been
27919 incorporated in changes in this release:
27920
27921 Alfred Agrell <alfred@agrell.info>
27922 Andreas Sandberg <andreas.sandberg@it.uu.se>
27923 Christoph Hellwig <hch@infradead.org>
27924 David Gibson <david@gibson.dropbear.id.au>
27925 David Prévot <taffit@debian.org>
27926 Fabrice Bauzac <libnoon@gmail.com>
27927 Greg Price <price@mit.edu>
27928 Jon Grant <jg@jguk.org>
27929 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
27930 Liu Jiaming <storypku@gmail.com>
27931 Maxin B. John <maxin.john@enea.com>
27932 Michael Kerrisk <mtk.manpages@gmail.com>
27933 Paolo Bonzini <bonzini@gnu.org>
27934 Peng Haitao <penght@cn.fujitsu.com>
27935 Robert P. J. Day <rpjday@crashcourse.ca>
27936 Rodrigo Campos <rodrigo@sdfg.com.ar>
27937 Shawn Landden <shawn@churchofgit.com>
27938 Trevor Bramwell <trevor@bramwell.net>
27939 Vince Weaver <vincent.weaver@maine.edu>
27940 Yang Yang <yangyang.gnu@gmail.com>
27941 Yuanhang Zheng <zhengyhn@gmail.com>
27942 Yuri Kozlov <yuray@komyakino.ru>
27943 janh <a0vhv@t-online.de>
27944
27945 Apologies if I missed anyone!
27946
27947
27948 Global changes
27949 --------------
27950
27951 assert.3
27952 assert_perror.3
27953 rexec.3
27954 rpc.3
27955 Michael Kerrisk [Jon Grant]
27956 Reword a sentence to use more gender-neutral language
27957
27958
27959 Changes to individual pages
27960 ---------------------------
27961
27962 execve.2
27963 Michael Kerrisk
27964 'arg...' for interpreter scripts starts with argv[1]
27965
27966 fallocate.2
27967 Christoph Hellwig
27968 Clarify the zeroing behavior
27969 fallocate() zeroes only space that did not previously contain
27970 data, but leaves existing data untouched.
27971
27972 futex.2
27973 Rodrigo Campos
27974 Fix link to Rusty's futex example library
27975 When I asked to webmaster@kernel.org, Konstantin Ryabitsev
27976 answered that the ".nl." is "an obsolete scheme and really
27977 should be changed to just ftp.kernel.org".
27978
27979 getgroups.2
27980 Michael Kerrisk
27981 Note that NGROUPS_MAX is defined in <limits.h>
27982 Michael Kerrisk
27983 Clarify that sysconf(_SC_NGROUPS_MAX) is a run-time technique
27984 Michael Kerrisk
27985 Document /proc/sys/kernel/ngroups_max
27986
27987 ioctl.2
27988 Michael Kerrisk [KOSAKI Motohiro, David Gibson]
27989 'request' argument is typed as 'unsigned long' in glibc
27990 See https://bugzilla.kernel.org/show_bug.cgi?id=42705
27991
27992 perf_event_open.2
27993 Vince Weaver
27994 Linux 3.12 rdpmc/mmap
27995 It turns out that the perf_event mmap page rdpmc/time setting was
27996 broken, dating back to the introduction of the feature. Due
27997 to a mistake with a bitfield, two different values mapped to
27998 the same feature bit.
27999
28000 A new somewhat backwards compatible interface was introduced
28001 in Linux 3.12. A much longer report on the issue can be found
28002 here:
28003 https://lwn.net/Articles/567894/
28004 Vince Weaver
28005 Linux 3.12 adds PERF_SAMPLE_IDENTIFIER
28006 A new PERF_SAMPLE_IDENTIFIER sample type was added in Linux 3.12.
28007 Vince Weaver
28008 E2BIG documentation
28009 The following documents the E2BIG error return for
28010 perf_event_open().
28011
28012 I actually ran into this error the hard way and it took me
28013 half a day to figure out why my ->size value was changing.
28014 Vince Weaver
28015 Linux 3.12 adds PERF_EVENT_IOC_ID
28016 A new perf_event related ioctl, PERF_EVENT_IOC_ID, was added
28017 in Linux 3.12.
28018 Vince Weaver
28019 PERF_COUNT_SW_DUMMY support
28020 Support for the PERF_COUNT_SW_DUMMY event type was added in
28021 Linux 3.12.
28022 Vince Weaver [Andreas Sandberg]
28023 PERF_EVENT_IOC_PERIOD update
28024 The PERF_EVENT_IOC_PERIOD ioctl was broken until 2.6.36,
28025 and it turns out that the ARM architecture has some
28026 differing behavior too.
28027
28028 pipe.2
28029 Trevor Bramwell
28030 Fix error in example program
28031
28032 poll.2
28033 Michael Kerrisk [Paolo Bonzini]
28034 Clarify meaning of events==0
28035 events==0 does not mean that revents is always returned as
28036 zero. The "output only" events (POLLHUP, POLLERR, POLLNVAL)
28037 can still be returned.
28038
28039 See https://bugzilla.kernel.org/show_bug.cgi?id=61911
28040
28041 readlink.2
28042 Michael Kerrisk [Yuanhang Zheng]
28043 Fix typo in error message in example program
28044
28045 recv.2
28046 Michael Kerrisk
28047 Remove out-of-date statement that UNIX domain does not support MSG_TRUNC
28048 Should have removed that sentence as part of
28049 commit a25601b48b822eb1882ae336574b8d062a17e564
28050
28051 sched_get_priority_max.2
28052 Michael Kerrisk
28053 Add SCHED_IDLE to discussion
28054
28055 send.2
28056 Michael Kerrisk
28057 RETURN VALUE: these calls return number of bytes (not characters) sent
28058
28059 setreuid.2
28060 Michael Kerrisk
28061 Small clarification to description of when saved set-user-ID is set
28062
28063 sigpending.2
28064 Michael Kerrisk
28065 Note treatment of signals that are blocked *and* ignored
28066
28067 stat.2
28068 Michael Kerrisk
28069 Note filesystem support for nanosecond timestamps
28070 Add some detail on which native filesystems do and don't
28071 support nanosecond timestamps.
28072 Michael Kerrisk
28073 Cosmetic reworking of timestamp discussion in NOTES
28074 Michael Kerrisk [Yang Yang]
28075 Update discussion of nanosecond timestamps
28076 The existing text describes the timestamp fields as 'time_t'
28077 and delegates discussion of nanosecond timestamps under NOTES.
28078 Nanosecond timestamps have been around for a while now,
28079 and are in POSIX.1-2008, so reverse the orientation of the
28080 discussion, putting the nanosecond fields into DESCRIPTION
28081 and detailing the historical situation under NOTES.
28082
28083 symlink.2
28084 Michael Kerrisk
28085 Further fine tuning of argument names
28086 Follow-up to f2ae6dde0c68448bec986d12fe32268a2c98bfd9
28087 See https://sourceware.org/bugzilla/show_bug.cgi?id=16073
28088 Michael Kerrisk [Fabrice Bauzac]
28089 Give arguments of symlink() more meaningful names
28090
28091 adjtime.3
28092 Peng Haitao
28093 ATTRIBUTES: Note function that is thread-safe
28094 The function adjtime() is thread safe.
28095
28096 alloca.3
28097 Peng Haitao
28098 ATTRIBUTES: Note function that is thread-safe
28099 The function alloca() is thread safe.
28100
28101 asinh.3
28102 Peng Haitao
28103 ATTRIBUTES: Note functions that are thread-safe
28104 The functions asinh(), asinhf() and asinhl() are thread safe.
28105
28106 atan.3
28107 Peng Haitao
28108 ATTRIBUTES: Note functions that are thread-safe
28109 The functions atan(), atanf() and atanl() are thread safe.
28110
28111 atof.3
28112 Peng Haitao
28113 ATTRIBUTES: Note function that is thread safe with exceptions
28114 The function atof() is thread safe with exceptions.
28115
28116 atoi.3
28117 Peng Haitao
28118 ATTRIBUTES: Note functions that are thread safe with exceptions
28119 The functions atoi(), atol() and atoll() are thread safe with
28120 exceptions.
28121
28122 bcmp.3
28123 Peng Haitao
28124 ATTRIBUTES: Note function that is thread-safe
28125 The function bcmp() is thread safe.
28126
28127 bcopy.3
28128 Peng Haitao
28129 ATTRIBUTES: Note function that is thread-safe
28130 The function bcopy() is thread safe.
28131
28132 bsd_signal.3
28133 Peng Haitao
28134 ATTRIBUTES: Note function that is thread-safe
28135 The function bsd_signal() is thread safe.
28136
28137 bzero.3
28138 Peng Haitao
28139 ATTRIBUTES: Note function that is thread-safe
28140 The function bzero() is thread safe.
28141
28142 cbrt.3
28143 Peng Haitao
28144 ATTRIBUTES: Note functions that are thread-safe
28145 The functions cbrt(), cbrtf() and cbrtl() are thread safe.
28146
28147 copysign.3
28148 Peng Haitao
28149 ATTRIBUTES: Note functions that are thread-safe
28150 The functions copysign(), copysignf() and copysignl() are thread
28151 safe.
28152
28153 cos.3
28154 Peng Haitao
28155 ATTRIBUTES: Note functions that are thread-safe
28156 The functions cos(), cosf() and cosl() are thread safe.
28157
28158 cproj.3
28159 Peng Haitao
28160 ATTRIBUTES: Note functions that are thread-safe
28161 The functions cproj(), cprojf() and cprojl() are thread safe.
28162
28163 creal.3
28164 Peng Haitao
28165 ATTRIBUTES: Note functions that are thread-safe
28166 The functions creal(), crealf() and creall() are thread safe.
28167
28168 daemon.3
28169 Peng Haitao
28170 ATTRIBUTES: Note function that is thread-safe
28171 The function daemon() is thread safe.
28172
28173 des_crypt.3
28174 Peng Haitao
28175 ATTRIBUTES: Note functions that are thread-safe
28176 The functions ecb_crypt(), cbc_crypt() and des_setparity() are
28177 thread safe.
28178
28179 difftime.3
28180 Peng Haitao
28181 ATTRIBUTES: Note function that is thread-safe
28182 The function difftime() is thread safe.
28183
28184 dysize.3
28185 Peng Haitao
28186 ATTRIBUTES: Note function that is thread-safe
28187 The function dysize() is thread safe.
28188
28189 erf.3
28190 Peng Haitao
28191 ATTRIBUTES: Note functions that are thread-safe
28192 The functions erf(), erff() and erfl() are thread safe.
28193
28194 erfc.3
28195 Peng Haitao
28196 ATTRIBUTES: Note functions that are thread-safe
28197 The functions erfc(), erfcf() and erfcl() are thread safe.
28198
28199 euidaccess.3
28200 Peng Haitao
28201 ATTRIBUTES: Note functions that are thread-safe
28202 The functions euidaccess() and eaccess() are thread safe.
28203
28204 expm1.3
28205 Peng Haitao
28206 ATTRIBUTES: Note functions that are thread-safe
28207 The functions expm1(), expm1f() and expm1l() are thread safe.
28208
28209 fexecve.3
28210 Michael Kerrisk
28211 POSIX.1-2008 specifies fexecve()
28212 Michael Kerrisk
28213 Explain the use and rationale of fexecve()
28214
28215 ftime.3
28216 Peng Haitao
28217 ATTRIBUTES: Note function that is thread-safe
28218 The function ftime() is thread safe.
28219
28220 ftok.3
28221 Peng Haitao
28222 ATTRIBUTES: Note function that is thread-safe
28223 The function ftok() is thread safe.
28224
28225 ftw.3
28226 Michael Kerrisk
28227 nftw() visits directories with FTW_D if FTW_DEPTH was not specified
28228 Michael Kerrisk
28229 Explain probable cause of FTW_NS
28230
28231 futimes.3
28232 Peng Haitao
28233 ATTRIBUTES: Note functions that are thread-safe
28234 The functions futimes() and lutimes() are thread safe.
28235
28236 getaddrinfo.3
28237 Michael Kerrisk
28238 Explain one use case for AI_ADDRCONFIG
28239 Michael Kerrisk
28240 Highlight difference in ai_flags when hints==NULL
28241 NOTES already described how glibc differs from POSIX.
28242 Add a pointer to that text from the point in DESCRIPTION
28243 where hints==NULL is discussed.
28244
28245 kcmp.3
28246 Shawn Landden
28247 Reword slightly awkward section
28248
28249 malloc.3
28250 Greg Price
28251 Scale back promises of alignment
28252 It's not true that the return value is suitably aligned for "any
28253 variable"; for example, it's unsuitable for a variable like
28254 float *x __attribute__ ((__vector_size__ (32)));
28255 which requires 32-byte alignment. Types like this are defined in
28256 <avxintrin.h>, and with 16-byte alignment in <emmintrin.h> and
28257 <xmmintrin.h>, so the application programmer need not even know
28258 that a vector_size attribute has been applied.
28259
28260 On an x86 architecture, a program that loads from or stores to a
28261 pointer with this type derived from malloc can crash because GCC
28262 generates an aligned load/store, like MOVDQA.
28263
28264 The C99 standard (TC3, as of N1256) does say the return value is
28265 suitably aligned for "any type of object". The C11 standard (as
28266 of N1570) revises this to any type with "fundamental alignment",
28267 which means an alignment "supported by the implementation in all
28268 contexts", which I suppose tautologically includes aligning
28269 malloc/realloc return values.
28270
28271 The actual behavior of current glibc malloc is to align to the
28272 greater of 2 * sizeof(size_t) and __alignof__ (long double),
28273 which may be one bit greater than this commit promises.
28274
28275 mq_receive.3
28276 Michael Kerrisk [janh]
28277 msg_len must be greater than *or equal to* mq_msgsize
28278 See https://bugzilla.kernel.org/show_bug.cgi?id=64571
28279
28280 setenv.3
28281 Michael Kerrisk
28282 Clarify that setenv() returns success in the overwrite==0 case
28283
28284 sigsetops.3
28285 Michael Kerrisk [Robert P. J. Day]
28286 Add 'const' to sigisemptyset(), sigorset(), sigandset() declarations
28287 Michael Kerrisk
28288 Rework text describing sigisemptyset(), sigorset(), and sigandset()
28289
28290 statvfs.3
28291 Peng Haitao
28292 ATTRIBUTES: Note functions that are thread-safe
28293 The functions statvfs() and fstatvfs() are thread safe.
28294
28295 stdarg.3
28296 Peng Haitao
28297 ATTRIBUTES: Note macros that are thread-safe
28298 The macros va_start(), va_arg(), va_end() and va_copy() are
28299 thread safe.
28300
28301 termios.3
28302 Peng Haitao
28303 ATTRIBUTES: Note functions that are thread-safe
28304 The functions tcgetattr(), tcsetattr(), tcsendbreak(),
28305 tcdrain(), tcflush(), tcflow(), cfmakeraw(), cfgetispeed(),
28306 cfgetospeed(), cfsetispeed(), cfsetospeed() and cfsetspeed()
28307 are thread safe.
28308
28309 ungetwc.3
28310 Peng Haitao
28311 ATTRIBUTES: Note function that is thread-safe
28312 The function ungetwc() is thread safe.
28313
28314 unlockpt.3
28315 Peng Haitao
28316 ATTRIBUTES: Note function that is thread-safe
28317 The function unlockpt() is thread safe.
28318
28319 usleep.3
28320 Peng Haitao
28321 ATTRIBUTES: Note function that is thread-safe
28322 The function usleep() is thread safe.
28323
28324 wcpcpy.3
28325 Peng Haitao
28326 ATTRIBUTES: Note function that is thread-safe
28327 The function wcpcpy() is thread safe.
28328
28329 wcscasecmp.3
28330 Peng Haitao
28331 ATTRIBUTES: Note function that is thread safe with exceptions
28332 The function wcscasecmp() is thread safe with exceptions.
28333
28334 wcscat.3
28335 Peng Haitao
28336 ATTRIBUTES: Note function that is thread-safe
28337 The function wcscat() is thread safe.
28338
28339 wcschr.3
28340 Peng Haitao
28341 ATTRIBUTES: Note function that is thread-safe
28342 The function wcschr() is thread safe.
28343
28344 wcscmp.3
28345 Peng Haitao
28346 ATTRIBUTES: Note function that is thread-safe
28347 The function wcscmp() is thread safe.
28348
28349 wcscpy.3
28350 Peng Haitao
28351 ATTRIBUTES: Note function that is thread-safe
28352 The function wcscpy() is thread safe.
28353
28354 wcscspn.3
28355 Peng Haitao
28356 ATTRIBUTES: Note function that is thread-safe
28357 The function wcscspn() is thread safe.
28358
28359 wcslen.3
28360 Peng Haitao
28361 ATTRIBUTES: Note function that is thread-safe
28362 The function wcslen() is thread safe.
28363
28364 wcsncasecmp.3
28365 Peng Haitao
28366 ATTRIBUTES: Note function that is thread safe with exceptions
28367 The function wcsncasecmp() is thread safe with exceptions.
28368
28369 wcsncat.3
28370 Peng Haitao
28371 ATTRIBUTES: Note function that is thread-safe
28372 The function wcsncat() is thread safe.
28373
28374 wcsncmp.3
28375 Peng Haitao
28376 ATTRIBUTES: Note function that is thread-safe
28377 The function wcsncmp() is thread safe.
28378
28379 wcsncpy.3
28380 Peng Haitao
28381 ATTRIBUTES: Note function that is thread-safe
28382 The function wcsncpy() is thread safe.
28383
28384 wcsnlen.3
28385 Peng Haitao
28386 ATTRIBUTES: Note function that is thread-safe
28387 The function wcsnlen() is thread safe.
28388
28389 wcspbrk.3
28390 Peng Haitao
28391 ATTRIBUTES: Note function that is thread-safe
28392 The function wcspbrk() is thread safe.
28393
28394 wcsrchr.3
28395 Peng Haitao
28396 ATTRIBUTES: Note function that is thread-safe
28397 The function wcsrchr() is thread safe.
28398
28399 wcsspn.3
28400 Peng Haitao
28401 ATTRIBUTES: Note function that is thread-safe
28402 The function wcsspn() is thread safe.
28403
28404 wcsstr.3
28405 Peng Haitao
28406 ATTRIBUTES: Note function that is thread-safe
28407 The function wcsstr() is thread safe.
28408
28409 wcstoimax.3
28410 Peng Haitao
28411 ATTRIBUTES: Note functions that are thread safe with exceptions
28412 The functions wcstoimax() and wcstoumax() are thread safe with
28413 exceptions.
28414
28415 wcstok.3
28416 Peng Haitao
28417 ATTRIBUTES: Note function that is thread-safe
28418 The function wcstok() is thread safe.
28419
28420 wcswidth.3
28421 Peng Haitao
28422 ATTRIBUTES: Note function that is thread safe with exceptions
28423 The function wcswidth() is thread safe with exceptions.
28424
28425 wctrans.3
28426 Peng Haitao
28427 ATTRIBUTES: Note function that is thread safe with exceptions
28428 The function wctrans() is thread safe with exceptions.
28429
28430 wctype.3
28431 Peng Haitao
28432 ATTRIBUTES: Note function that is thread safe with exceptions
28433 The function wctype() is thread safe with exceptions.
28434
28435 wcwidth.3
28436 Peng Haitao
28437 ATTRIBUTES: Note function that is thread safe with exceptions
28438 The function wcwidth() is thread safe with exceptions.
28439
28440 wmemchr.3
28441 Peng Haitao
28442 ATTRIBUTES: Note function that is thread-safe
28443 The function wmemchr() is thread safe.
28444
28445 wmemcmp.3
28446 Peng Haitao
28447 ATTRIBUTES: Note function that is thread-safe
28448 The function wmemcmp() is thread safe.
28449
28450 wmemcpy.3
28451 Peng Haitao
28452 ATTRIBUTES: Note function that is thread-safe
28453 The function wmemcpy() is thread safe.
28454
28455 wmemmove.3
28456 Peng Haitao
28457 ATTRIBUTES: Note function that is thread-safe
28458 The function wmemmove() is thread safe.
28459
28460 wmemset.3
28461 Peng Haitao
28462 ATTRIBUTES: Note function that is thread-safe
28463 The function wmemset() is thread safe.
28464
28465 tty_ioctl.4
28466 Michael Kerrisk [Liu Jiaming]
28467 Note that 'arg' should be 0 in the usual case when using TIOCSCTTY
28468 Michael Kerrisk
28469 Rework text on root to discuss just in terms of capabilities
28470
28471 proc.5
28472 Michael Kerrisk
28473 Document /proc/sys/kernel/ngroups_max
28474
28475 capabilities.7
28476 Michael Kerrisk
28477 Fix 2 version numbers under "Effect of user ID changes on capabilities"
28478
28479 feature_test_macros.7
28480 Michael Kerrisk
28481 Add _ISOC11_SOURCE to example program
28482
28483 tcp.7
28484 Michael Kerrisk
28485 Fix (nontrivial) wordo in discussion of MSG_TRUNC
28486 s/MSG_PEEK/MSG_TRUNC/
28487
28488 ld.so.8
28489 Michael Kerrisk [Alfred Agrell]
28490 Fix crufty wording in one sentence
28491
28492
28493 ==================== Changes in man-pages-3.56 ====================
28494
28495 Released: 2014-01-11, Christchurch
28496
28497 In memory of Doris Church (1939-2013)
28498
28499
28500 Contributors
28501 ------------
28502
28503 The following people contributed patches/fixes or (noted in brackets
28504 in the changelog below) reports, notes, and ideas that have been
28505 incorporated in changes in this release:
28506
28507 Andre Majorel <aym-xunil@teaser.fr>
28508 Arif Zaman <arifz@lums.edu.pk>
28509 Bert Wesarg <bert.wesarg@googlemail.com>
28510 Daniel Borkmann <dborkman@redhat.com>
28511 David Malcolm <dmalcolm@redhat.com>
28512 David Prévot <taffit@debian.org>
28513 Dongsheng Song <dongsheng.song@gmail.com>
28514 Elie De Brauwer <eliedebrauwer@gmail.com>
28515 James Smith <james@theta.pw>
28516 Janne Blomqvist <blomqvist.janne@gmail.com>
28517 Joseph S. Myers <joseph@codesourcery.com>
28518 Luke Hutchison <luke.hutch@mit.edu>
28519 Marco Dione <mdione@grulic.org.ar>
28520 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
28521 Mathieu Malaterre <malat@debian.org>
28522 Matthias Klose <doko@debian.org>
28523 Michael Kerrisk <mtk.manpages@gmail.com>
28524 Mike Frysinger <vapier@gentoo.org>
28525 Moritz 'Morty' Strübe <morty@gmx.net>
28526 Nadav Har'El <nyh@math.technion.ac.il>
28527 Ondřej Bílka <neleai@seznam.cz>
28528 Prádraig Brady <P@draigBrady.com>
28529 Peng Haitao <penght@cn.fujitsu.com>
28530 Raphael Geissert <geissert@debian.org>
28531 Shawn Landden <shawn@churchofgit.com>
28532 Simon Paillard <spaillard@debian.org>
28533 Stephen Kell <srk31@srcf.ucam.org>
28534 Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
28535 Sworddragon2 <sworddragon2@aol.com>
28536 Vince Weaver <vincent.weaver@maine.edu>
28537 Willem de Bruijn <willemb@google.com>
28538 Yuri Kozlov <yuray@komyakino.ru>
28539
28540 Apologies if I missed anyone!
28541
28542
28543 New and rewritten pages
28544 -----------------------
28545
28546 fgetc.3
28547 gets.3
28548 David Malcolm
28549 Split gets(3) to isolate unsafe gets(3) to a page on its own
28550 Currently man3/gets.3 documents various safe I/O functions, along
28551 with the toxic "gets" function.
28552
28553 At the risk of being melodramatic, this strikes me as akin to
28554 storing rat poison in a food cabinet, in the same style of
28555 packaging as the food, but with a post-it note on it saying
28556 "see warnings below".
28557
28558 I think such "never use this" functions should be quarantined
28559 into their own manpages, rather than listing them alongside
28560 sane functions.
28561
28562 The attached patch does this for "gets", moving the documentation
28563 of the good functions from man3/gets.3 into man3/fgetc.3,
28564 updating the SO links in the relevant functions to point at the
28565 latter.
28566
28567 It then rewrites man3/gets.3 to spell out that "gets" is toxic
28568 and should never be used (with a link to CWE-242 for good
28569 measure).
28570 Michael Kerrisk [Andre Majorel]
28571 Tweaks to David Malcolm's patch
28572
28573 vdso.7
28574 Mike Frysinger
28575 New page documenting the vDSO mapped into each process by the kernel
28576
28577
28578 Newly documented interfaces in existing pages
28579 ---------------------------------------------
28580
28581 reboot.2
28582 Elie De Brauwer
28583 Document LINUX_REBOOT_SW_SUSPEND
28584
28585
28586 New and changed links
28587 ---------------------
28588
28589 fgets.3
28590 getc.3
28591 getchar.3
28592 ungetc.3
28593 Michael Kerrisk
28594 Adjust links to gets(3) to point to fgetc(3)
28595
28596
28597 Global changes
28598 --------------
28599
28600 Various pages
28601 Michael Kerrisk
28602 Global fix of "NULL pointer"
28603 Change "NULL pointer" to "NULL" or null pointer".
28604 POSIX uses the term "null pointer", not "NULL pointer".
28605
28606 Various pages
28607 Michael Kerrisk
28608 Stylistic changes to code example
28609 For ease of reading, don't embed assignments inside if().
28610
28611 Various pages
28612 Michael Kerrisk
28613 Replace uses of "i.e.," in main text with "that is" or similar
28614 Usual man-pages style is to use "i.e." only within
28615 parenthetical expressions.
28616
28617 Various pages
28618 Michael Kerrisk
28619 Replace uses of "e.g." in main text with "for example" or similar
28620 Usual man-pages style is to use "e.g." only within
28621 parenthetical expressions.
28622
28623 Various pages
28624 Michael Kerrisk
28625 Add "Program source" subheading under EXAMPLE
28626
28627 Various pages
28628 Michael Kerrisk
28629 Add "static" to global variables and functions in example program
28630
28631
28632 Changes to individual pages
28633 ---------------------------
28634
28635 clock_getres.2
28636 Michael Kerrisk [Nadav Har'El]
28637 Improve description of CLOCK_PROCESS_CPUTIME_ID
28638 See https://bugzilla.kernel.org/show_bug.cgi?id=67291
28639
28640 close.2
28641 Michael Kerrisk [P?draig Brady]
28642 Note that errors from close() should be used only for diagnosis
28643 In particular, retrying after EINTR is a bad idea.
28644
28645 See http://austingroupbugs.net/view.php?id=529
28646
28647 See http://thread.gmane.org/gmane.comp.lib.glibc.alpha/37702
28648 Subject: [RFC][BZ #14627] Make linux close errno to EINPROGRESS
28649 when interrupted in signal.
28650
28651 execve.2
28652 Michael Kerrisk [Marco Dione]
28653 Add further cases to EFAULT error
28654 See https://sourceware.org/bugzilla/show_bug.cgi?id=16402
28655
28656 perf_event_open.2
28657 Vince Weaver [Sudhanshu Goswami]
28658 Clarify issues with the disabled bit
28659 Clarify the perf_event_open behavior with respect to the disabled
28660 bit and creating event groups.
28661 Vince Weaver [Sudhanshu Goswami]
28662 Clarify issues with the exclusive bit
28663 Warn that using the perf_event_open "exclusive" bit, while
28664 it might seem like a good idea, might lead to all 0 results
28665 in some common usage cases.
28666
28667 reboot.2
28668 Elie De Brauwer
28669 Mention RB_POWER_OFF
28670 The manpage did not mention RB_POWER_OFF which is the glibc
28671 symbolic name for LINUX_REBOOT_CMD_POWER_OFF.
28672
28673 $ cd /usr/include
28674 $ cat x86_64-linux-gnu/sys/reboot.h | grep POWER_OFF
28675 define RB_POWER_OFF 0x4321fedc
28676 Elie De Brauwer
28677 Add "Linux" to kernel version numbers
28678 Michael Kerrisk
28679 Add RB_SW_SUSPEND synonym
28680 Michael Kerrisk
28681 Add RB_KEXEC synonym
28682
28683 setpgid.2
28684 Michael Kerrisk [Joseph S. Myers]
28685 BSD getpgrp() and setpgrp() go away in glibc 2.19
28686
28687 socket.2
28688 Michael Kerrisk [Dongsheng Song]
28689 Remove crufty statement that AF_INET does not support SOCK_SEQPACKET
28690 Linux AF_INET supports SOCK_SEQPACKET via SCTP.
28691
28692 syscall.2
28693 Mike Frysinger
28694 Fix ia64 registers
28695 The original list of registers was created by confusing strace
28696 source code--this is for parsing legacy 32-bit code (which is
28697 dead and no one cares). Update the list to reflect native ia64
28698 syscall interface.
28699
28700 syscall.2
28701 syscalls.2
28702 getauxval.3
28703 Mike Frysinger
28704 Add references to new vdso(7) page
28705
28706 utimensat.2
28707 Michael Kerrisk
28708 Small wording improvement for times!=NULL case
28709
28710 dlopen.3
28711 Michael Kerrisk [Mike Frysinger]
28712 Update remarks on cast needed when assigning dlsym() return value
28713 POSIX.1-2013 eases life when casting the dlsym() return value to a
28714 function pointer
28715 Michael Kerrisk [Stephen Kell]
28716 Fix description of dli_sname
28717 See https://sourceware.org/bugzilla/show_bug.cgi?id=16262
28718
28719 getline.3
28720 Michael Kerrisk [Luke Hutchison]
28721 Correct description of how '*n' is used when '*lineptr' == NULL
28722 See https://sourceware.org/bugzilla/show_bug.cgi?id=5468
28723 Michael Kerrisk
28724 Remove SEE ALSO reference to unsafe gets(3)
28725
28726 mcheck.3
28727 Simon Paillard [Raphael Geissert]
28728 typo in compiler flag
28729 See http://bugs.debian.org/732464
28730
28731 mkstemp.3
28732 Michael Kerrisk [Janne Blomqvist]
28733 Better describe 'flags' that can be specified for mkostemp()
28734
28735 printf.3
28736 Michael Kerrisk [Arif Zaman]
28737 Fix memory leak in snprintf() example
28738 See http://stackoverflow.com/questions/19933479/snprintf-man-page-example-memory-leak
28739
28740 pthread_kill.3
28741 Michael Kerrisk [Mathieu Desnoyers]
28742 POSIX.1-2008 removes ESRCH
28743 POSIX.1-2001 mistakenly documented an ESRCH error, and
28744 POSIX.1-2008 removes this error. Glibc does return
28745 this error in cases where it can determine that a thread ID
28746 is invalid, but equally, the use of an invalid thread ID
28747 can cause a segmentation fault.
28748
28749 puts.3
28750 Michael Kerrisk
28751 SEE ALSO: replace reference to gets(3) with fgets(3)
28752
28753 scanf.3
28754 Michael Kerrisk [Ondřej Bílka]
28755 Improve discussion of obsolete 'a' dynamic allocation modifier
28756
28757 setjmp.3
28758 Michael Kerrisk [Joseph S. Myers]
28759 BSD setjmp() semantics go away in glibc 2.19
28760
28761 sigpause.3
28762 Michael Kerrisk [Joseph S. Myers]
28763 BSD sigpause() goes away in glibc 2.19
28764 Michael Kerrisk
28765 Correct feature text macro requirements
28766 Peng Haitao
28767 ATTRIBUTES: Note function that is thread-safe
28768 The function sigpause() is thread safe.
28769
28770 sigqueue.3
28771 Peng Haitao
28772 ATTRIBUTES: Note function that is thread-safe
28773 The function sigqueue() is thread safe.
28774
28775 sigwait.3
28776 Peng Haitao
28777 ATTRIBUTES: Note function that is thread-safe
28778 The function sigwait() is thread safe.
28779
28780 sin.3
28781 Peng Haitao
28782 ATTRIBUTES: Note functions that are thread-safe
28783 The functions sin(), sinf() and sinl() are thread safe.
28784
28785 sincos.3
28786 Peng Haitao
28787 ATTRIBUTES: Note functions that are thread-safe
28788 The functions sincos(), sincosf() and sincosl() are thread safe.
28789
28790 string.3
28791 Moritz 'Morty' Strübe
28792 Add short description of the functions
28793 It is helpful to have a short description about what the different
28794 functions in string.h do.
28795 Michael Kerrisk
28796 Fixes and enhancements to Moritz Strübe's patch
28797
28798 strptime.3
28799 Michael Kerrisk [Mathieu Malaterre, Simon Paillard]
28800 Add number ranges to comments in 'tm' structure
28801 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729570
28802 Michael Kerrisk
28803 Point to ctime(3) for more details on 'tm' structure
28804 Michael Kerrisk
28805 Some rewording and reorganization
28806
28807 strsep.3
28808 Michael Kerrisk
28809 Clarify description
28810 The use of "symbols" in the existing description is confusing;
28811 it's "bytes". Other fixes as well.
28812
28813 strspn.3
28814 Michael Kerrisk [Mathieu Malaterre]
28815 Improve description in NAME
28816 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659
28817
28818 strstr.3
28819 Michael Kerrisk
28820 Clarify RETURN VALUE: s/substring/located substring/
28821
28822 sysv_signal.3
28823 Peng Haitao
28824 ATTRIBUTES: Note function that is thread-safe
28825 The function sysv_signal() is thread safe.
28826
28827 tan.3
28828 Peng Haitao
28829 ATTRIBUTES: Note functions that are thread-safe
28830 The functions tan(), tanf() and tanl() are thread safe.
28831
28832 tanh.3
28833 Peng Haitao
28834 ATTRIBUTES: Note functions that are thread-safe
28835 The functions tanh(), tanhf() and tanhl() are thread safe.
28836
28837 toascii.3
28838 Peng Haitao
28839 ATTRIBUTES: Note function that is thread-safe
28840 The function toascii() is thread safe.
28841
28842 toupper.3
28843 Peng Haitao
28844 ATTRIBUTES: Note functions that are thread safe with exceptions
28845 The functions toupper() and tolower() are thread safe with
28846 exceptions.
28847
28848 towctrans.3
28849 Peng Haitao
28850 ATTRIBUTES: Note function that is thread-safe
28851 The function towctrans() is thread safe.
28852
28853 towlower.3
28854 Peng Haitao
28855 ATTRIBUTES: Note function that is thread safe with exceptions
28856 The function towlower() is thread safe with exceptions.
28857
28858 towupper.3
28859 Peng Haitao
28860 ATTRIBUTES: Note function that is thread safe with exceptions
28861 The function towupper() is thread safe with exceptions.
28862
28863 ualarm.3
28864 Peng Haitao
28865 ATTRIBUTES: Note function that is thread-safe
28866 The function ualarm() is thread safe.
28867
28868 wcpncpy.3
28869 Peng Haitao
28870 ATTRIBUTES: Note function that is thread-safe
28871 The function wcpncpy() is thread safe.
28872
28873 proc.5
28874 Michael Kerrisk [Sworddragon2]
28875 Fix formula for CommitLimit under /proc/meminfo
28876 See https://bugzilla.kernel.org/show_bug.cgi?id=60991
28877
28878 credentials.7
28879 Michael Kerrisk
28880 List APIs that operate on process groups
28881 Michael Kerrisk
28882 Add details on controlling terminal and foreground/background jobs
28883
28884 feature_test_macros.7
28885 Michael Kerrisk
28886 Document _DEFAULT_SOURCE
28887 Michael Kerrisk [Joseph S. Myers]
28888 From glibc 2.19, _BSD_SOURCE no longer causes __FAVOR_BSD
28889 Starting with glibc 2.19, _BSD_SOURCE no longer causes BSD
28890 definitions to be favored in cases where standards conflict.
28891
28892 libc.7
28893 Mike Frysinger
28894 SEE ALSO: add various entries
28895
28896 man-pages.7
28897 Michael Kerrisk [Mike Frysinger]
28898 Add STYLE GUIDE section
28899 Incorporate some of the existing material in the page
28900 into the STYLE GUIDE, and add a lot more material, mainly
28901 drawn from the "Global changes" sections in the release
28902 changelogs.
28903 Michael Kerrisk
28904 Add historical note on reason for use of American spelling
28905 Michael Kerrisk [Mike Frysinger]
28906 Various improvements to style guide
28907
28908 packet.7
28909 Willem de Bruijn [Daniel Borkmann]
28910 Document fanout, ring, and auxiliary options
28911 This patch adds descriptions of the common packet socket options
28912 PACKET_AUXDATA, PACKET_FANOUT, PACKET_RX_RING, PACKET_STATISTICS,
28913 PACKET_TX_RING
28914 and the ring-specific options
28915 PACKET_LOSS, PACKET_RESERVE, PACKET_TIMESTAMP, PACKET_VERSION
28916 Michael Kerrisk
28917 Add kernel version numbers for PACKET_VERSION and PACKET_TIMESTAMP
28918
28919 ld.so.8
28920 Michael Kerrisk [Matthias Klose]
28921 Default output file for D_DEBUG is stderr not stdout
28922 See https://sourceware.org/bugzilla/show_bug.cgi?id=6874
28923
28924
28925
28926 ==================== Changes in man-pages-3.57 ====================
28927
28928 Released: 2014-01-24, Munich
28929
28930
28931 Contributors
28932 ------------
28933
28934 The following people contributed patches/fixes or (noted in brackets
28935 in the changelog below) reports, notes, and ideas that have been
28936 incorporated in changes in this release:
28937
28938 Andi Kleen <andi@firstfloor.org>
28939 Andre Majorel <aym-xunil@teaser.fr>
28940 Andrey Vagin <avagin@openvz.org>
28941 Andy Lutomirski <luto@amacapital.net>
28942 Axel Beckert <abe@debian.org>
28943 Bernhard Walle <bernhard@bwalle.de>
28944 Brandon Edens <bedens@fitbit.com>
28945 Eliezer Tamir <eliezer.tamir@linux.intel.com>
28946 Gioele Barabucci <gioele@svario.it>
28947 Ian Abbott <abbotti@mev.co.uk>
28948 Jerry Chu <hkchu@google.com>
28949 Jonas Jonsson <jonas@websystem.se>
28950 Marc Lehmann <debian-reportbug@plan9.de>
28951 Michael Kerrisk <mtk.manpages@gmail.com>
28952 Mike Frysinger <vapier@gentoo.org>
28953 Peng Haitao <penght@cn.fujitsu.com>
28954 Reuben Thomas <rrt@sc3d.org>
28955 Simone Piccardi <piccardi@truelite.it>
28956 Simon Paillard <spaillard@debian.org>
28957 Thomas Posch <man-pages@online.posch.name>
28958 Tilman Schmidt <tilman@imap.cc>
28959 Vince Weaver <vincent.weaver@maine.edu>
28960 Yuri Kozlov <yuray@komyakino.ru>
28961 Марк Коренберг <socketpair@gmail.com>
28962
28963 Apologies if I missed anyone!
28964
28965
28966 Newly documented interfaces in existing pages
28967 ---------------------------------------------
28968
28969 msgop.2
28970 Michael Kerrisk
28971 Document MSG_COPY
28972
28973 open.2
28974 Michael Kerrisk, Andy Lutomirski
28975 Document O_TMPFILE
28976 O_TMPFILE is new in Linux 3.11
28977
28978 perf_event_open.2
28979 Vince Weaver [Andi Kleen]
28980 PERF_SAMPLE_TRANSACTION support in Linux 3.13
28981 The following patch adds descriptions of the new perf_event_open.2
28982 PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13.
28983
28984 The descriptions are based on information provided by Andi Kleen,
28985 both in the e-mail
28986
28987 [PATCH 1/6] perf, core: Add generic transaction flags v5
28988
28989 sent to the linux-kernel list as well as an e-mail
28990
28991 [PATCH] Document transaction flags in perf_event_open manpage
28992
28993 sent to the linux-man list.
28994
28995 The implementation is based heavily on the Intel Haswell
28996 processor. Documentation can be found at this page:
28997 http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0
28998 as well as in section 18.11.5.1 of volume 3 of the
28999 Intel 64 and IA-32 Architecture Software Developer's Manual.
29000
29001 ptrace.2
29002 Andrey Vagin
29003 Add description for PTRACE_PEEKSIGINFO
29004 Retrieve signals without removing them from a queue.
29005 Andrey Vagin
29006 Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
29007 These two commands allow to examine and change mask of blocked
29008 signals.
29009
29010 socket.7
29011 Eliezer Tamir
29012 Add description for SO_BUSY_POLL
29013 Add description for the SO_BUSY_POLL socket option.
29014
29015 tcp.7
29016 Michael Kerrisk [Jerry Chu]
29017 Document TCP_USER_TIMEOUT
29018 Text slightly adapted from Jerry Chu's (excellent) commit
29019 message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3).
29020 Michael Kerrisk
29021 Document TCP_CONGESTION
29022
29023
29024 Global changes
29025 --------------
29026
29027 Various pages
29028 Michael Kerrisk
29029 Reword to avoid use of "etc."
29030
29031 Various pages
29032 Peng Haitao [Andre Majorel]
29033 Make wording around thread-safety and setlocale() more precise
29034
29035 getdate.3
29036 strptime.3
29037 locale.5
29038 Michael Kerrisk
29039 Replace "weekday" with less ambiguous language
29040 Notwithstanding POSIX's use of the term "weekday", in everyday
29041 English, "weekday" is commonly understood to mean a day in the
29042 set [Monday..Friday] (vs one of the "weekend" days).
29043
29044
29045 Changes to individual pages
29046 ---------------------------
29047
29048 epoll_wait.2
29049 Michael Kerrisk [Jonas Jonsson]
29050 Clarify wording of EINTR error
29051 See https://bugzilla.kernel.org/show_bug.cgi?id=66571
29052
29053 faccessat.2
29054 Michael Kerrisk
29055 Note that the system call takes only three arguments
29056
29057 fallocate.2
29058 Michael Kerrisk
29059 Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
29060
29061 fcntl.2
29062 Michael Kerrisk
29063 BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
29064 Michael Kerrisk
29065 Add subsections under BUGS
29066 There's several bugs listed. It's helpful to mark
29067 them separately.
29068 Michael Kerrisk
29069 POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG
29070
29071 getrlimit.2
29072 Michael Kerrisk [Марк Коренберг]
29073 Note that rlim_cur can be set lower than current resource consumption
29074
29075 getsockopt.2
29076 Michael Kerrisk
29077 SEE ALSO: add ip(7) and udp(7)
29078
29079 keyctl.2
29080 Michael Kerrisk
29081 SEE ALSO: mention Documentation/security/keys.txt
29082
29083 linkat.2
29084 Michael Kerrisk
29085 Add ENOENT for O_TMPFILE created with O_EXCL
29086 Michael Kerrisk
29087 ERRORS: Add EINVAL
29088
29089 lseek.2
29090 Michael Kerrisk
29091 Note which filesystems support SEEK_HOLE/SEEK_DATA
29092
29093 msgop.2
29094 Michael Kerrisk
29095 Note that MSG_EXCEPT is Linux-specific
29096
29097 open.2
29098 Michael Kerrisk
29099 Update CONFORMING TO
29100 Add POSIX.1-2008. Add mention of O_TMPFILE.
29101 Update text on various flags that were added in POSIX.1-2008, and
29102 whose definitions can, since glibc 2.12, be obtained by suitably
29103 defining _POSIX_C_SOURCE or _XOPEN_SOURCE
29104 Michael Kerrisk
29105 Add pointer in description to BUGS, for O_ASYNC limitation
29106 Michael Kerrisk
29107 Remove crufty duplicate text on modifying file status flags
29108
29109 ptrace.2
29110 Michael Kerrisk
29111 Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
29112
29113 select.2
29114 Michael Kerrisk [Marc Lehmann]
29115 RETURN VALUE: Fix discussion of treatment of file descriptor sets
29116 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370
29117
29118 syscalls.2
29119 Michael Kerrisk
29120 Remove madvise1() from main list
29121 madvise1() is one of the system calls that was never
29122 implemented, and listed toward the bottom of the page.
29123
29124 timer_create.2
29125 Michael Kerrisk
29126 Add pointer to proc(5) for info on /proc/[pid]/timers
29127
29128 unlinkat.2
29129 Michael Kerrisk [Mike Frysinger:]
29130 ERRORS: Add EISDIR
29131 See https://bugzilla.kernel.org/show_bug.cgi?id=29702
29132
29133 ferror.3
29134 Michael Kerrisk
29135 clearerr(), feof(), and ferror() are also POSIX-conformant
29136 Michael Kerrisk [Reuben Thomas]
29137 CONFORMING TO: add fileno()
29138
29139 gets.3
29140 Ian Abbott
29141 SEE ALSO: add fgets(3)
29142
29143 mq_receive.3
29144 mq_send.3
29145 Michael Kerrisk [Simone Piccardi]
29146 SYNOPSIS: s/unsigned/unsigned int/
29147
29148 printf.3
29149 Michael Kerrisk
29150 Small reorganization of text in EXAMPLE
29151
29152 rand.3
29153 Michael Kerrisk
29154 s/unsigned/unsigned int/ in example
29155
29156 stpcpy.3
29157 Peng Haitao
29158 ATTRIBUTES: Note function that is thread-safe
29159 The function stpcpy() is thread safe.
29160
29161 stpncpy.3
29162 Peng Haitao
29163 ATTRIBUTES: Note function that is thread-safe
29164 The function stpncpy() is thread safe.
29165
29166 strcat.3
29167 Peng Haitao
29168 ATTRIBUTES: Note functions that are thread-safe
29169 The functions strcat() and strncat() are thread safe.
29170
29171 strchr.3
29172 Peng Haitao
29173 ATTRIBUTES: Note functions that are thread-safe
29174 The functions strchr(), strrchr() and strchrnul() are thread safe.
29175
29176 strcmp.3
29177 Peng Haitao
29178 ATTRIBUTES: Note functions that are thread-safe
29179 The functions strcmp() and strncmp() are thread safe.
29180
29181 strftime.3
29182 Brandon Edens
29183 Change "week day" to "day of week"
29184 See https://bugzilla.kernel.org/show_bug.cgi?id=68861
29185
29186 strstr.3
29187 Peng Haitao
29188 ATTRIBUTES: Note function that is thread safe with exceptions
29189 The function strstr() is thread safe.
29190 The function strcasestr() is thread safe with exceptions.
29191
29192 strtod.3
29193 Peng Haitao
29194 ATTRIBUTES: Note functions that are thread safe with exceptions
29195 The functions strtod(), strtof() and strtold() are thread safe
29196 with exceptions.
29197
29198 strtoimax.3
29199 Peng Haitao
29200 ATTRIBUTES: Note functions that are thread safe with exceptions
29201 The functions strtoimax() and strtoumax() are thread safe with
29202 exceptions.
29203
29204 strtol.3
29205 Peng Haitao
29206 ATTRIBUTES: Note functions that are thread safe with exceptions
29207 The functions strtol(), strtoll() and strtoq() are thread safe
29208 with exceptions.
29209
29210 tcgetpgrp.3
29211 Peng Haitao
29212 ATTRIBUTES: Note functions that are thread-safe
29213 The functions tcgetpgrp() and tcsetpgrp() are thread safe.
29214
29215 tcgetsid.3
29216 Peng Haitao
29217 ATTRIBUTES: Note function that is thread-safe
29218 The function tcgetsid() is thread safe.
29219
29220 core.5
29221 Bernhard Walle
29222 Mention that %E exists since Linux 3.0
29223 '%E' in the 'core_pattern' has been introduced in kernel commit
29224 57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in
29225 version 3.0. Add that information to the manual page.
29226
29227 filesystems.5
29228 Michael Kerrisk [Axel Beckert]
29229 Add reference to proc(5) for more details on /proc/filesystems
29230 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590
29231
29232 locale.5
29233 Michael Kerrisk
29234 SEE ALSO: add locale(7)
29235
29236 proc.5
29237 Michael Kerrisk
29238 Document /proc/[pid]/timers
29239 Michael Kerrisk
29240 Update discussion of wchan
29241 Remove crufty reference to /etc/psdatabase in /proc/PID/stat.
29242 Add /proc/PID/wchan.
29243
29244 See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452
29245
29246 environ.7
29247 Michael Kerrisk [Gioele Barabucci]
29248 Correct reference to locale(7) (not locale(5))
29249 locale(7) is the right place for details of the LC_*
29250 environment variables.
29251
29252 See http://bugs.debian.org/638186
29253 Michael Kerrisk
29254 Improve references for discussion of locale environment variables
29255 Michael Kerrisk
29256 SEE ALSO: add catopen(3)
29257 Michael Kerrisk
29258 SEE ALSO: add locale(5)
29259
29260 man-pages.7
29261 Michael Kerrisk
29262 Prefer "usable" over "useable"
29263
29264 netdevice.7
29265 Tilman Schmidt
29266 Document SIOCGIFCONF case ifc_req==NULL
29267 Add the missing description of the possibility to call SIOCGIFCONF
29268 with ifc_req==NULL to determine the needed buffer size, as
29269 described in
29270 http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html
29271 and verified against source files net/core/dev_ioctl.c and
29272 net/ipv4/devinet.c in the current kernel git tree.
29273 This functionality has been present since the beginning of the 2.6
29274 series. It's about time it gets documented.
29275
29276 While I'm at it, also generally clarify the section on
29277 SIOCGIFCONF.
29278
29279 standards.7
29280 Michael Kerrisk
29281 Enhance description of V7
29282 Michael Kerrisk
29283 Add C11
29284
29285 tcp.7
29286 Michael Kerrisk
29287 Describe format of tcp_*_congestion_control /proc files
29288 Describe format of tcp_allowed_congestion_control and
29289 tcp_available_congestion_control.
29290
29291
29292 ==================== Changes in man-pages-3.58 ====================
29293
29294 Released: 2014-02-11, Munich
29295
29296
29297 Contributors
29298 ------------
29299
29300 The following people contributed patches/fixes or (noted in brackets
29301 in the changelog below) reports, notes, and ideas that have been
29302 incorporated in changes in this release:
29303
29304 Cyril Hrubis <chrubis@suse.cz>
29305 Daniel Borkmann <dborkman@redhat.com>
29306 David Prévot <taffit@debian.org>
29307 Fabrice Bauzac <libnoon@gmail.com>
29308 Michael Kerrisk <mtk.manpages@gmail.com>
29309 Mike Frysinger <vapier@gentoo.org>
29310 Network Nut <sillystack@gmail.com>
29311 Ola Olsson <ola1olsson@gmail.com>
29312 Peng Haitao <penght@cn.fujitsu.com>
29313 Peter Schiffer <pschiffe@redhat.com>
29314 Simone Piccardi <piccardi@truelite.it>
29315 Simon Paillard <spaillard@debian.org>
29316 Yuri Kozlov <yuray@komyakino.ru>
29317 Марк Коренберг <socketpair@gmail.com>
29318 未卷起的浪 <ayjj_8109@qq.com>
29319
29320 Apologies if I missed anyone!
29321
29322
29323 Newly documented interfaces in existing pages
29324 ---------------------------------------------
29325
29326 pipe.2
29327 Michael Kerrisk
29328 Document the pipe2() O_DIRECT flag added in Linux 3.4
29329
29330 packet.7
29331 Daniel Borkmann
29332 Document PACKET_QDISC_BYPASS
29333 New in Linux 3.14.
29334
29335
29336 Global changes
29337 --------------
29338
29339 Various pages
29340 Simon Paillard
29341 Formatting fix: add space between function and () if BR or IR
29342 Detected through the regex:
29343 git grep -P '^\.(BR|IR) [\w]*\([\d]*\)$'
29344
29345 Various pages
29346 Simon Paillard
29347 Formatting fix: add space between word and punctuation if BR or IR
29348 Detected through the regex:
29349 git grep -P '^\.(BR|IR) [^ ]*[,\.]$'
29350
29351 Could probably be extended to match more cases and fix in perl.
29352
29353 Various pages
29354 Michael Kerrisk
29355 Use Oxford comma
29356
29357 gettid.2
29358 restart_syscall.2
29359 passwd.5
29360 socket.7
29361 Michael Kerrisk
29362 Fix order of SEE ALSO entries
29363
29364
29365 Changes to individual pages
29366 ---------------------------
29367
29368 epoll_wait.2
29369 Michael Kerrisk [Network Nut]
29370 Remove word "minimum" from the description of 'timeout'
29371
29372 epoll_wait.2
29373 poll.2
29374 select.2
29375 Michael Kerrisk
29376 Go into more detail on timeout and when call will cease blocking
29377
29378 getxattr.2
29379 listxattr.2
29380 removexattr.2
29381 setxattr.2
29382 Michael Kerrisk [Fabrice Bauzac]
29383 Correct header file is <sys/xattr.h> (not <xattr/xattr.h>)
29384 See https://bugzilla.kernel.org/show_bug.cgi?id=70141
29385
29386 msgctl.2
29387 Cyril Hrubis
29388 Add note about ignored arg to IPC_RMID
29389
29390 prctl.2
29391 Michael Kerrisk [Марк Коренберг]
29392 PR_SET_PDEATHSIG value is preserved across execve(2)
29393
29394 recv.2
29395 Michael Kerrisk
29396 Rework and reorganize the text in various parts of the page.
29397 Isolate details specific to recv() vs recvfrom() vs recvmsg()
29398 Place details specific to each system call under a
29399 separate subheading.
29400 Rework discussion of 'src_addr' and 'addrlen' for recvfrom()
29401 Add description of 'buf' and 'len' in recvfrom() section
29402 'addrlen' should be 0 (*not* NULL) when 'src_addr' is NULL
29403 Improve text describing recvfrom() call that is equivalent to recv()
29404 Michael Kerrisk [未卷起的浪]
29405 Describe the various cases where the return value can be 0
29406
29407 shmctl.2
29408 Michael Kerrisk
29409 Note that 'buf' is ignored for IPC_RMID
29410
29411 symlinkat.2
29412 Michael Kerrisk
29413 Make argument names consistent with symlink(2) page
29414
29415 isalpha.3
29416 Peng Haitao
29417 ATTRIBUTES: Note functions that are thread-safe
29418 The functions isalnum(), isalpha(), isascii(), isblank(),
29419 iscntrl(), isdigit(), isgraph(), islower(), isprint(),
29420 ispunct(), isspace(), isupper() and isxdigit() are thread safe.
29421
29422 isatty.3
29423 Peng Haitao
29424 ATTRIBUTES: Note function that is thread-safe
29425 The function isatty() is thread safe.
29426
29427 isgreater.3
29428 Peng Haitao
29429 ATTRIBUTES: Note macros that are thread-safe
29430 The macros isgreater(), isgreaterequal(), isless(),
29431 islessequal(), islessgreater() and isunordered() are thread safe.
29432
29433 iswalnum.3
29434 Peng Haitao
29435 ATTRIBUTES: Note function that is thread safe with exceptions
29436 The function iswalnum() is thread safe with exceptions.
29437
29438 iswalpha.3
29439 Peng Haitao
29440 ATTRIBUTES: Note function that is thread safe with exceptions
29441 The function iswalpha() is thread safe with exceptions.
29442
29443 iswblank.3
29444 Peng Haitao
29445 ATTRIBUTES: Note function that is thread safe with exceptions
29446 The function iswblank() is thread safe with exceptions.
29447
29448 iswcntrl.3
29449 Peng Haitao
29450 ATTRIBUTES: Note function that is thread safe with exceptions
29451 The function iswcntrl() is thread safe with exceptions.
29452
29453 lockf.3
29454 Michael Kerrisk [Simone Piccardi]
29455 Fix incorrect argument mentioned under EINVAL error
29456
29457 pthread_kill.3
29458 Michael Kerrisk
29459 Add feature test macro requirements
29460
29461 pthread_sigmask.3
29462 Michael Kerrisk
29463 Add feature test macro requirements
29464
29465 strtoul.3
29466 Peng Haitao
29467 ATTRIBUTES: Note functions that are thread safe with exceptions
29468 The functions strtoul(), strtoull() and strtouq() are thread safe
29469 with exceptions.
29470
29471 nscd.conf.5
29472 Peter Schiffer
29473 Add note about default values
29474
29475 proc.5
29476 Michael Kerrisk
29477 SEE ALSO: Add some further kernel Documentation/sysctl files
29478
29479 man-pages.7
29480 Michael Kerrisk
29481 ATTRIBUTES sections come after VERSIONS
29482 Peng Haitao has consistently ordered the ATTRIBUTES after
29483 VERSIONS, so adjust the text in man-pages.7
29484
29485 vdso.7
29486 Michael Kerrisk
29487 Add words "virtual dynamic shared object" in DESCRIPTION
29488
29489
29490 ==================== Changes in man-pages-3.59 ====================
29491
29492 Released: 2014-02-16, Munich
29493
29494
29495 Contributors
29496 ------------
29497
29498 The following people contributed patches/fixes or (noted in brackets
29499 in the changelog below) reports, notes, and ideas that have been
29500 incorporated in changes in this release:
29501
29502 Michael Kerrisk <mtk.manpages@gmail.com>
29503 Peter Schiffer <pschiffe@redhat.com>
29504 Weizhou Pan <cs.wzpan@gmail.com>
29505
29506 Apologies if I missed anyone!
29507
29508
29509 Global changes
29510 --------------
29511
29512 Various pages
29513 Peter Schiffer, Michael Kerrisk [Weizhou Pan]
29514 Convert pages containing non-ASCII in source code comments to use UTF-8
29515 Done using a slightly modified version of Peter Schiffer's
29516 convert_to_utf_8.sh script. The script was modified so as *not*
29517 a "coding:" marker to the groff source. For now, we'll only put
29518 that marker on pages that contain non-ASCII characters in the
29519 rendered text.
29520
29521 See https://bugzilla.kernel.org/show_bug.cgi?id=60807
29522
29523 armscii-8.7
29524 cp1251.7
29525 iso_8859-1.7
29526 iso_8859-10.7
29527 iso_8859-11.7
29528 iso_8859-13.7
29529 iso_8859-14.7
29530 iso_8859-15.7
29531 iso_8859-16.7
29532 iso_8859-2.7
29533 iso_8859-3.7
29534 iso_8859-4.7
29535 iso_8859-5.7
29536 iso_8859-6.7
29537 iso_8859-7.7
29538 iso_8859-8.7
29539 iso_8859-9.7
29540 koi8-r.7
29541 koi8-u.7
29542 Peter Schiffer, Michael Kerrisk [Weizhou Pan]
29543 Convert pages containing non-ASCII to use UTF-8
29544 Done using Peter Schiffer's convert_to_utf_8.sh script.
29545 These pages containing non-ASCII in the rendered characters, and
29546 so the script inserts a "coding:" marker into the groff source.
29547
29548 See https://bugzilla.kernel.org/show_bug.cgi?id=60807
29549
29550
29551 ==================== Changes in man-pages-3.60 ====================
29552
29553 Released: 2014-02-18, Munich
29554
29555
29556 Contributors
29557 ------------
29558
29559 The following people contributed patches/fixes or (noted in brackets
29560 in the changelog below) reports, notes, and ideas that have been
29561 incorporated in changes in this release:
29562
29563 David Prévot <taffit@debian.org>
29564 D. Barbier <bouzim@gmail.com>
29565 Kalle Olavi Niemitalo <kon@iki.fi>
29566 Michael Kerrisk <mtk.manpages@gmail.com>
29567 Simon Paillard <spaillard@debian.org>
29568
29569 Apologies if I missed anyone!
29570
29571
29572 Changes to individual pages
29573 ---------------------------
29574 sigvec.3
29575 Michael Kerrisk [Kalle Olavi Niemitalo]
29576 Fix error in code snippet
29577 s/sigpause/sigmask/
29578
29579 armscii-8.7
29580 cp1251.7
29581 iso_8859-1.7
29582 iso_8859-10.7
29583 iso_8859-11.7
29584 iso_8859-13.7
29585 iso_8859-14.7
29586 iso_8859-15.7
29587 iso_8859-16.7
29588 iso_8859-2.7
29589 iso_8859-3.7
29590 iso_8859-4.7
29591 iso_8859-5.7
29592 iso_8859-6.7
29593 iso_8859-7.7
29594 iso_8859-8.7
29595 iso_8859-9.7
29596 koi8-u.7
29597 Michael Kerrisk [Simon Paillard]
29598 Remove comment that glyphs in column 4 may not display correctly
29599 With the conversion to UTF-8, the glyphs in column 4 of the
29600 tables in these pages will display regardless of whether the
29601 environment is configured for the corresponding character set.
29602
29603 iso_8859-11.7
29604 iso_8859-13.7
29605 D. Barbier [Simon Paillard]
29606 Fix encoding mistakes in 5f7f4042b8848127d852c6fa7c02e31ccfaeeae5
29607 Fixed via:
29608
29609 for f in iso_8859-11 iso_8859-13; do
29610 cp man7/$f.7 $f
29611 iconv -f utf8 -t latin1 $f | iconv -f iso-${f#iso_} -t utf8 > man7/$f.7
29612 done
29613
29614
29615
29616
29617 ==================== Changes in man-pages-3.61 ====================
29618
29619 Released: 2014-02-26, Munich
29620
29621
29622 Contributors
29623 ------------
29624
29625 The following people contributed patches/fixes or (noted in brackets
29626 in the changelog below) reports, notes, and ideas that have been
29627 incorporated in changes in this release:
29628
29629 Andrew Hunter <ahh@google.com>
29630 Carlos O'Donell <carlos@redhat.com>
29631 Christoph Hellwig <hch@infradead.org>
29632 Daniel Borkmann <dborkman@redhat.com>
29633 Duncan de Wet <duncandewet@gmail.com>
29634 Kir Kolyshkin <kir@openvz.org>
29635 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
29636 Michael Kerrisk <mtk.manpages@gmail.com>
29637 Neil Horman <nhorman@tuxdriver.com>
29638 Peng Haitao <penght@cn.fujitsu.com>
29639 Simon Paillard <spaillard@debian.org>
29640 Sulaiman Mustafa <seininn@hush.com>
29641 Xiawei Chen <chenxiawei@gmail.com>
29642
29643 Apologies if I missed anyone!
29644
29645
29646 New and rewritten pages
29647 -----------------------
29648
29649 A note from Christoph Hellwig prompted me to perform a task that has
29650 been queued for a while: merging the text of the man pages for the
29651 *at([23]) ("directory file descriptor") APIs into their corresponding
29652 traditional pages. When the *at([23]) pages were originally written
29653 (mostly in 2006), the APIs were not part of POSIX and (in most cases)
29654 were not available on other systems. So, it made some sense to wall
29655 them off into their own separate pages. Eight years later, with the
29656 APIs now all in POSIX (except scandirat()), it is much more sensible
29657 to document the newer APIs alongside their traditional counterparts,
29658 so that the newer APIs are not "hidden", and the reader can more
29659 easily see the differences between the APIs.
29660
29661 Thus, the text of 14 pairs of pages has been merged, and the "merged
29662 from" pages have been converted to links to the "merged to" pages.
29663 Along the way, a few other fixes were made to the pages, as noted
29664 below.
29665
29666 One page that did not undergo such a change was utimensat(2), which
29667 is different enough from utime(2) that it warrants a separate page.
29668 Unlike the other *at() pages, the utimensat(2) page was also already
29669 self-contained, rather than defining itself in terms of differences
29670 from utime(2) as the other *at() pages did.
29671
29672 access.2
29673 Michael Kerrisk
29674 Merge text from faccessat(2)
29675 Michael Kerrisk
29676 Remove faccessat() race warning
29677 That point is already covered in existing text in this page.
29678 Michael Kerrisk
29679 access() also conforms to POSIX.1-2008
29680
29681 chmod.2
29682 Michael Kerrisk
29683 Merge text from fchmodat(2)
29684 Michael Kerrisk
29685 Use argument name 'pathname' throughout page
29686 (Some APIs were using 'path' while others used 'pathname')
29687 Michael Kerrisk
29688 CONFORMING TO: chmod() and fchmod() are also in POSIX.1-2008
29689
29690 chown.2
29691 Michael Kerrisk
29692 Merge text of fchownat(2)
29693 Michael Kerrisk
29694 AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
29695 Michael Kerrisk
29696 Use argument name 'pathname' throughout page
29697 (Some APIs were using 'path' while others used 'pathname')
29698 Michael Kerrisk
29699 Remove sentence that fchownat() is present on Solaris
29700 That point was only really relevant before fchownat() was
29701 standardized in POSIX.1.2008.
29702 Michael Kerrisk
29703 CONFORMING TO: chown(), fchown(), lchown() are in POSIX.1-2008
29704
29705 link.2
29706 Michael Kerrisk
29707 Merge text of linkat(2)
29708 Michael Kerrisk
29709 CONFORMING TO: link() is in POSIX.1-2008
29710 Michael Kerrisk
29711 AT_EMPTY_PATH is Linux-specific and requires _GNU_SOURCE
29712
29713 mkdir.2
29714 Michael Kerrisk
29715 Merge text of mkdirat(2)
29716 Michael Kerrisk
29717 CONFORMING TO: mkdir() is in POSIX.1-2008
29718
29719 mknod.2
29720 Michael Kerrisk
29721 Merge text of mknodat(2)
29722 Michael Kerrisk
29723 CONFORMING TO: mknod(2) is in POSIX.1-2008
29724
29725 open.2
29726 Michael Kerrisk
29727 Merge text from openat(2)
29728 Michael Kerrisk
29729 Remove sentence that openat() is present on Solaris
29730 That point was only really relevant before openat() was
29731 standardized in POSIX.1.2008.
29732
29733 readlink.2
29734 Michael Kerrisk
29735 Merge text of readlinkat(2)
29736 Michael Kerrisk
29737 CONFORMING TO: readlink() is in POSIX.1-2008.
29738 Michael Kerrisk
29739 Use argument name 'pathname' throughout page
29740 (Some APIs were using 'path' while others used 'pathname')
29741
29742 rename.2
29743 Michael Kerrisk
29744 Merge text of renameat(2)
29745 Michael Kerrisk
29746 CONFORMING TO: rename(2) is in POSIX.1-2008
29747
29748 stat.2
29749 Michael Kerrisk
29750 Merge text from fstatat(2)
29751 Michael Kerrisk
29752 AT_EMPTY_PATH and AT_NO_AUTOMOUNT are Linux-specific
29753 These flags require _GNU_SOURCE.
29754 Michael Kerrisk
29755 Use argument name 'pathname' throughout page
29756 (Some APIs were using 'path' while others used 'pathname')
29757 Michael Kerrisk
29758 Remove sentence that fstatat() is present on Solaris
29759 That point was only really relevant before fstatat() was
29760 standardized in POSIX.1.2008.
29761 Michael Kerrisk
29762 CONFORMING TO: stat(), fstat(), lstat() are specified in POSIX.1-2008
29763
29764 symlink.2
29765 Michael Kerrisk
29766 Merge text of symlinkat(2)
29767 Michael Kerrisk
29768 CONFORMING TO: symlink() is in POSIX.1-2008
29769
29770 unlink.2
29771 Michael Kerrisk
29772 Merge text of unlinkat(2)
29773 Michael Kerrisk
29774 Remove sentence that unlinkat() is present on Solaris
29775 That point was only really relevant before unlinkat() was
29776 standardized in POSIX.1.2008.
29777 Michael Kerrisk
29778 CONFORMING TO: unlink() is in POSIX.1-2008
29779
29780 mkfifo.3
29781 Michael Kerrisk
29782 Merge text of mkfifoat(3)
29783 Michael Kerrisk
29784 CONFORMING TO: mkfifo() is in POSIX.1-2008
29785
29786 scandir.3
29787 Michael Kerrisk
29788 Merge text of scandirat(3)
29789 Michael Kerrisk
29790 Update feature test macro requirements
29791 The FTM requirements changed in glibc 2.10.
29792 Michael Kerrisk
29793 Remove libc4/libc5 note under CONFORMING TO
29794 No-one much cares about Linux libc these days.
29795 Michael Kerrisk
29796 Put detail about alphasort under a NOTES heading
29797 This text was under CONFORMING TO, which made no sense.
29798 Michael Kerrisk
29799 Rework CONFORMING TO text
29800
29801
29802 Newly documented interfaces in existing pages
29803 ---------------------------------------------
29804
29805 prctl.2
29806 Kir Kolyshkin
29807 Document PR_SET_MM options in Linux 3.5
29808 Some of the PR_SET_MM options were merged to vanilla kernel
29809 later, and appeared in Linux 3.5. Those are:
29810
29811 - PR_SET_MM_ARG_START
29812 - PR_SET_MM_ARG_END
29813 - PR_SET_MM_ENV_START
29814 - PR_SET_MM_ENV_END
29815 - PR_SET_MM_AUXV
29816 - PR_SET_MM_EXE_FILE
29817
29818 socket.7
29819 Neil Horman
29820 Document the SO_RXQ_OVFL socket option
29821 Michael Kerrisk
29822 Add kernel version number for SO_RXQ_OVFL
29823
29824
29825 New and changed links
29826 ---------------------
29827
29828 faccessat.2
29829 Michael Kerrisk
29830 Convert to link to access.2
29831
29832 fchmodat.2
29833 Michael Kerrisk
29834 Convert to link to chmod.2
29835
29836 fchownat.2
29837 Michael Kerrisk
29838 Convert to link to chown.2
29839
29840 fstatat.2
29841 Michael Kerrisk
29842 Convert to link to stat.2
29843
29844 linkat.2
29845 Michael Kerrisk
29846 Convert to link to link.2
29847
29848 mkdirat.2
29849 Michael Kerrisk
29850 Convert to link to mkdir.2
29851
29852 mknodat.2
29853 Michael Kerrisk
29854 Convert to link to mknod.2
29855
29856 openat.2
29857 Michael Kerrisk
29858 Convert to link to open.2
29859
29860 readlinkat.2
29861 Michael Kerrisk
29862 Convert to link to symlink.2
29863
29864 renameat.2
29865 Michael Kerrisk
29866 Convert to link rename.2
29867
29868 symlinkat.2
29869 Michael Kerrisk
29870 Convert to link to symlink.2
29871
29872 unlinkat.2
29873 Michael Kerrisk
29874 Convert to link to unlink.2
29875
29876 mkfifoat.3
29877 Michael Kerrisk
29878 Convert to link to mkfifo.3
29879
29880 scandirat.3
29881 Michael Kerrisk
29882 Convert to link to scandir.3
29883
29884
29885 Changes to individual pages
29886 ---------------------------
29887
29888 alarm.2
29889 Michael Kerrisk
29890 Note semantics of alarm with respect to fork() and execve()
29891
29892 fcntl.2
29893 Michael Kerrisk
29894 Warn that F_GETLK info may already be out of date when the call returns
29895
29896 intro.2
29897 Michael Kerrisk
29898 Describe policy on documenting differences between syscall and glibc API
29899
29900 mmap2.2
29901 Michael Kerrisk
29902 Reword note on glibc mmap() wrapper invocation of mmap2()
29903 Michael Kerrisk
29904 This system call does not exist on x86-64
29905
29906 msgctl.2
29907 Michael Kerrisk
29908 ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
29909
29910 prctl.2
29911 Michael Kerrisk [Xiawei Chen]
29912 Clarify that PR_GET_TIMERSLACK is returned as the function result
29913 Michael Kerrisk
29914 Clarify that PR_GET_SECCOMP is returned as function result
29915 Michael Kerrisk
29916 Clarify that PR_GET_NO_NEW_PRIVS is returned as function result
29917
29918 ptrace.2
29919 Michael Kerrisk [Andrew Hunter]
29920 Make it clearer that glibc and syscall APIs differ for PTRACE_PEEK*
29921 Thanks to Denys Vlasenko's additions in 78686915aed6bd12
29922 this page does note that the glibc API for PTRACE_PEEK*
29923 differs from the raw syscall interface. But, as the report
29924 at https://bugzilla.kernel.org/show_bug.cgi?id=70801 shows,
29925 this information could be more obvious. This patch makes its so.
29926
29927 sgetmask.2
29928 Michael Kerrisk
29929 Note that these system calls don't exist on x86-64
29930
29931 swapon.2
29932 Michael Kerrisk
29933 Split EINVAL cases into separate entries under ERRORS
29934 Michael Kerrisk
29935 Add EINVAL error for invalid flags to swapon()
29936
29937 syscalls.2
29938 Michael Kerrisk
29939 SEE ALSO: add intro(2)
29940
29941 umount.2
29942 Michael Kerrisk
29943 Split EINVAL cases into separate items
29944 Michael Kerrisk
29945 ERRORS: Add EINVAL case that was new in 2.6.34
29946
29947 utime.2
29948 Michael Kerrisk
29949 Add note that modern applications probably want utimensat(2) etc.
29950
29951 crypt.3
29952 Michael Kerrisk [KOSAKI Motohiro]
29953 ERRORS: Add EINVAL and EPERM errors
29954 See https://bugzilla.kernel.org/show_bug.cgi?id=69771
29955
29956 getifaddrs.3
29957 Michael Kerrisk
29958 Enhance example program
29959 Print statistics for AF_PACKET interfaces.
29960 Add missing feature test macro definition.
29961 Reformat output.
29962
29963 iswctype.3
29964 Peng Haitao
29965 ATTRIBUTES: Note function that is thread-safe
29966 The function iswctype() is thread safe.
29967
29968 sem_post.3
29969 Peng Haitao
29970 ATTRIBUTES: Note function that is thread-safe
29971 The function sem_post() is thread safe.
29972
29973 sem_unlink.3
29974 Peng Haitao
29975 ATTRIBUTES: Note function that is thread-safe
29976 The function sem_unlink() is thread safe.
29977
29978 sem_wait.3
29979 Peng Haitao
29980 ATTRIBUTES: Note functions that are thread-safe
29981 The functions sem_wait(), sem_trywait() and sem_timedwait() are
29982 thread safe.
29983
29984 setbuf.3
29985 Peng Haitao
29986 ATTRIBUTES: Note functions that are thread-safe
29987 The functions setbuf(), setbuffer(), setlinebuf() and setvbuf()
29988 are thread safe.
29989
29990 strlen.3
29991 Peng Haitao
29992 ATTRIBUTES: Note function that is thread-safe
29993 The function strlen() is thread safe.
29994
29995 strnlen.3
29996 Peng Haitao
29997 ATTRIBUTES: Note function that is thread-safe
29998 The function strnlen() is thread safe.
29999
30000 strpbrk.3
30001 Peng Haitao
30002 ATTRIBUTES: Note function that is thread-safe
30003 The function strpbrk() is thread safe.
30004
30005 strsep.3
30006 Peng Haitao
30007 ATTRIBUTES: Note function that is thread-safe
30008 The function strsep() is thread safe.
30009
30010 swab.3
30011 Peng Haitao
30012 ATTRIBUTES: Note function that is thread-safe
30013 The function swab() is thread safe.
30014
30015 resolv.conf.5
30016 Carlos O'Donell
30017 DESCRIPTION: mention that the data is trusted
30018 In a recent discussion about DNSSEC it was brought to my
30019 attention that not all system administrators may understand
30020 that the information in /etc/resolv.conf is fully trusted.
30021 The resolver implementation in glibc treats /etc/resolv.conf
30022 as a fully trusted source of DNS information and passes on
30023 the AD-bit for DNSSEC as trusted.
30024
30025 This patch adds a clarifying sentence to make it absolutely
30026 clear that indeed this source of information is trusted.
30027
30028 ascii.7
30029 Michael Kerrisk [Sulaiman Mustafa]
30030 Fix rendering of single quote (decimal character 39)
30031 Michael Kerrisk
30032 SEE ALSO: add utf-8(7)
30033 Michael Kerrisk [Duncan de Wet]
30034 Remove mention of ISO 8859-1 as being the default encoding on Linux
30035
30036 packet.7
30037 Neil Horman
30038 Document PACKET_FANOUT_QM fanout mode
30039 Michael Kerrisk
30040 Add kernel version for PACKET_FANOUT_QM
30041 Daniel Borkmann
30042 Improve PACKET_QDISC_BYPASS description
30043
30044 socket.7
30045 Michael Kerrisk
30046 Add kernel version number for SO_BUSY_POLL
30047
30048
30049 ==================== Changes in man-pages-3.62 ====================
30050
30051 Released: 2014-03-11, Munich
30052
30053
30054 Contributors
30055 ------------
30056
30057 The following people contributed patches/fixes or (noted in brackets
30058 in the changelog below) reports, notes, and ideas that have been
30059 incorporated in changes in this release:
30060
30061 Cyril Hrubis <chrubis@suse.cz>
30062 Joseph S. Myers <joseph@codesourcery.com>
30063 Marius Gaubas <marius@livejournalinc.com>
30064 Michael Kerrisk <mtk.manpages@gmail.com>
30065 Mike Frysinger <vapier@gentoo.org>
30066 Peng Haitao <penght@cn.fujitsu.com>
30067 Rick Stanley <rstanley@rsiny.com>
30068 Simon Paillard <spaillard@debian.org>
30069
30070 Apologies if I missed anyone!
30071
30072
30073 New and rewritten pages
30074 -----------------------
30075
30076 locale.1
30077 Michael Kerrisk [review from Mike Frysinger]
30078 New page describing locale(1)
30079
30080
30081 Newly documented interfaces in existing pages
30082 ---------------------------------------------
30083
30084 locale.5
30085 Michael Kerrisk
30086 Document LC_ADDRESS
30087 Michael Kerrisk
30088 Document LC_IDENTIFICATION
30089 Michael Kerrisk
30090 Document LC_MEASUREMENT
30091 Michael Kerrisk
30092 Document LC_NAME
30093 Michael Kerrisk
30094 Document LC_PAPER
30095 Michael Kerrisk
30096 Document LC_TELEPHONE
30097
30098
30099 Removed Pages
30100 -------------
30101
30102 sync.8
30103 Michael Kerrisk [Christoph Hellwig, Pádraig Brady]
30104 Sometime in the 20th century (before my watch), a sync(8)
30105 page into man-pages. It documents the sync command from
30106 "fileutils", which long ago become coreutils, and the
30107 piece under NOTES note some behavior of sync(2)
30108 that ceased to be true many years ago. The man-pages
30109 project generally focuses on only Linux kernel and
30110 (g)libc interfaces, so this sync(8) page doesn't really
30111 belong. Furthermore, coreutils has a sync(1) page which
30112 covers the same command. After discussions on the
30113 coreutils list, I've decided to retire this page from
30114 man-pages.
30115
30116 Changes to individual pages
30117 ---------------------------
30118
30119 clone.2
30120 Michael Kerrisk
30121 Note that CLONE_THREAD also in effect requires CLONE_VM
30122
30123 stat.2
30124 Michael Kerrisk [Marius Gaubas]
30125 Warn the reader that the 'stat' structure definition is not precise
30126 Padding fields aren't shown, and the order of fields varies
30127 somewhat across architectures.
30128
30129 gethostbyname.3
30130 Michael Kerrisk
30131 Remove redundant FTM requirements
30132 _GNU_SOURCE implies _SVID_SOURCE and _BSD_SOURCE, so
30133
30134 _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE
30135
30136 is the same as
30137
30138 _BSD_SOURCE || _SVID_SOURCE
30139
30140 getutmp.3
30141 Michael Kerrisk
30142 SEE ALSO: add utmpdump(1)
30143
30144 log1p.3
30145 Peng Haitao
30146 ATTRIBUTES: Note functions that are thread-safe
30147 The functions log1p(), log1pf() and log1pl() are thread safe.
30148
30149 logb.3
30150 Peng Haitao
30151 ATTRIBUTES: Note functions that are thread-safe
30152 The functions logb(), logbf() and logbl() are thread safe.
30153
30154 memccpy.3
30155 Peng Haitao
30156 ATTRIBUTES: Note function that is thread-safe
30157 The function memccpy() is thread safe.
30158
30159 memchr.3
30160 Peng Haitao
30161 ATTRIBUTES: Note functions that are thread-safe
30162 The functions memchr(), memrchr() and rawmemchr() are thread safe.
30163
30164 mktemp.3
30165 Michael Kerrisk
30166 Make warning not to use this function more prominent
30167
30168 qecvt.3
30169 Michael Kerrisk [Joseph S. Myers]
30170 Recommend snprintf(3) not sprintf(3)
30171
30172 raise.3
30173 Peng Haitao
30174 ATTRIBUTES: Note function that is thread-safe
30175 The function raise() is thread safe.
30176
30177 remove.3
30178 Peng Haitao
30179 ATTRIBUTES: Note function that is thread-safe
30180 The function remove() is thread safe.
30181
30182 sem_destroy.3
30183 Peng Haitao
30184 ATTRIBUTES: Note function that is thread-safe
30185 The function sem_destroy() is thread safe.
30186
30187 sem_getvalue.3
30188 Peng Haitao
30189 ATTRIBUTES: Note function that is thread-safe
30190 The function sem_getvalue() is thread safe.
30191
30192 sem_init.3
30193 Peng Haitao
30194 ATTRIBUTES: Note function that is thread-safe
30195 The function sem_init() is thread safe.
30196
30197 sockatmark.3
30198 Peng Haitao
30199 ATTRIBUTES: Note function that is thread-safe
30200 The function sockatmark() is thread safe.
30201
30202 strcpy.3
30203 Peng Haitao
30204 ATTRIBUTES: Note functions that are thread-safe
30205 The functions strcpy() and strncpy() are thread safe.
30206 Michael Kerrisk [Rick Stanley]
30207 Fix a bug, and improve discussion of forcing termination with strncpy()
30208
30209 strspn.3
30210 Peng Haitao
30211 ATTRIBUTES: Note functions that are thread-safe
30212 The functions strspn() and strcspn() are thread safe.
30213
30214 tempnam.3
30215 Michael Kerrisk
30216 Make warning not to use this function more prominent
30217
30218 tmpnam.3
30219 Michael Kerrisk
30220 Recommend use mkstemp(3) or tmpfile(3) instead
30221
30222 locale.5
30223 Michael Kerrisk
30224 Add intro section that lists all of the LC categories
30225 Michael Kerrisk
30226 'p_cs_precedes' is for *positive* values
30227 Michael Kerrisk
30228 Clarify 'p_sign_posn' and 'n_sign_posn'; simplify 'n_sign_posn'
30229 Add initial sentence for 'p_sign_posn' and 'n_sign_posn'.
30230 Remove repeated list for 'n_sign_posn'.
30231 Michael Kerrisk
30232 Document LC_MESSAGES 'yesstr' and 'nostr'
30233 Michael Kerrisk
30234 Clarify LC_MONETARY 'n_cs_precedes'
30235 Michael Kerrisk
30236 LC_MONETARY: Document 'int_p_sign_posn' and 'int_n_sign_posn'
30237 Michael Kerrisk
30238 Clarify/rework 'p_cs_precedes' and 'n_cs_precedes'
30239 Michael Kerrisk
30240 LC_MONETARY: document 'int_p_sep_by_space' and 'int_n_sep_by_space'
30241 Michael Kerrisk
30242 Remove crufty reference to POSIX.2
30243 Michael Kerrisk
30244 LC_MONETARY: document 'int_p_cs_precedes' and 'int_n_cs_precedes'
30245 Michael Kerrisk
30246 Clarify/simplify 'n_sep_by_space'
30247 Michael Kerrisk
30248 LC_TIME: document 'cal_direction' and 'date_fmt'
30249 Michael Kerrisk
30250 Clarify 'p_sep_by_space'
30251
30252 feature_test_macros.7
30253 Michael Kerrisk
30254 _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
30255 Michael Kerrisk
30256 _GNU_SOURCE implicitly defines other macros
30257 Saying that _GNU_SOURCE has the "effects of" other macros is not
30258 quite precise.
30259 Michael Kerrisk
30260 Reword glibc version for _ISOC95_SOURCE
30261 Michael Kerrisk
30262 _ISOC99_SOURCE also exposes C95 definitions
30263 Michael Kerrisk
30264 _ISOC11_SOURCE implies the effects of _ISOC99_SOURCE
30265 Michael Kerrisk
30266 Note version number for _POSIX_C_SOURCE >= 200112L implies C99/C95
30267 _POSIX_C_SOURCE >= 200112L causes C95 definitions to be
30268 exposed only since glibc 2.12 and C99 definitions only
30269 since 2.10.
30270 Michael Kerrisk
30271 _XOPEN_SOURCE may implicitly define _POSIX_SOURCE and _POSIX_C_SOURCE
30272 Michael Kerrisk
30273 Reword glibc version for _ISOC99_SOURCE
30274 Michael Kerrisk
30275 Rework discussion of _ISOC99_SOURCE
30276 Michael Kerrisk
30277 Improve discussion of _DEFAULT_SOURCE
30278 Michael Kerrisk
30279 _POSIX_C_SOURCE >= 200112L implies C95 and C95 features
30280
30281
30282
30283 ==================== Changes in man-pages-3.63 ====================
30284
30285 Released: 2014-03-18, Munich
30286
30287
30288 Contributors
30289 ------------
30290
30291 The following people contributed patches/fixes or (noted in brackets
30292 in the changelog below) reports, notes, and ideas that have been
30293 incorporated in changes in this release:
30294
30295 Carlos O'Donell <carlos@redhat.com>
30296 Christoph Hellwig <hch@infradead.org>
30297 Corrado Zoccolo <czoccolo@gmail.com>
30298 Gregory P. Smith <gps@google.com>
30299 Joseph S. Myers <joseph@codesourcery.com>
30300 Michael Kerrisk <mtk.manpages@gmail.com>
30301 Mike Frysinger <vapier@gentoo.org>
30302 Peng Haitao <penght@cn.fujitsu.com>
30303 Phillip Susi <psusi@ubuntu.com>
30304 Robert P. J. Day <rpjday@crashcourse.ca>
30305 Stefan Puiu <stefan.puiu@gmail.com>
30306 Zhu Yanhai <zhu.yanhai@gmail.com>
30307
30308 Apologies if I missed anyone!
30309
30310
30311 New and rewritten pages
30312 -----------------------
30313
30314 duplocale.3
30315 Michael Kerrisk
30316 New page documenting duplocale(3)
30317
30318 newlocale.3
30319 Michael Kerrisk [Mike Frysinger]
30320 New page documenting newlocale(3) and freelocale(3)
30321
30322 towlower.3
30323 Michael Kerrisk
30324 Largely rewrite description of towlower() to be simpler and clearer
30325
30326 towupper.3
30327 Michael Kerrisk
30328 Largely rewrite description of towupper() to be simpler and clearer
30329
30330 uselocale.3
30331 Michael Kerrisk
30332 New page documenting uselocale(3)
30333
30334
30335 Newly documented interfaces in existing pages
30336 ---------------------------------------------
30337
30338 open.2
30339 Michael Kerrisk
30340 Document O_DSYNC and rewrite discussion of O_SYNC
30341
30342 isalpha.3
30343 Michael Kerrisk
30344 Document the "_l" locale APIs
30345 The GNU C library v2.3 added some locale APIs, most of which
30346 were later specified in POSIX.1-2008, namely:
30347
30348 isalnum_l()
30349 isalpha_l()
30350 isblank_l()
30351 iscntrl_l()
30352 isdigit_l()
30353 isgraph_l()
30354 islower_l()
30355 isprint_l()
30356 ispunct_l()
30357 isspace_l()
30358 isupper_l()
30359 isxdigit_l()
30360 isascii_l()
30361
30362 Also update and correct various pieces in CONFORMING TO
30363 (and remove a few crufty old pieces there).
30364
30365 strerror.3
30366 Michael Kerrisk
30367 Document strerror_l()
30368
30369 toupper.3
30370 Michael Kerrisk
30371 Document toupper_l() and tolower_l()
30372
30373 towlower.3
30374 Michael Kerrisk
30375 Document towlower_l()
30376
30377 towupper.3
30378 Michael Kerrisk
30379 Document towupper_l()
30380
30381 proc.5
30382 Michael Kerrisk
30383 Document /proc/sys/kernel/random/uuid
30384
30385 locale.7
30386 Michael Kerrisk
30387 Document LC_ADDRESS
30388 Document LC_IDENTIFICATION
30389 Document LC_MEASUREMENT
30390 Document LC_NAME
30391 Document LC_PAPER
30392 Document LC_TELEPHONE
30393
30394
30395 New and changed links
30396 ---------------------
30397
30398 freelocale.3
30399 Michael Kerrisk
30400 New link to new newlocale.3 page
30401
30402 isalnum_l.3
30403 isascii_l.3
30404 isblank_l.3
30405 iscntrl_l.3
30406 isdigit_l.3
30407 isgraph_l.3
30408 islower_l.3
30409 isprint_l.3
30410 ispunct_l.3
30411 isspace_l.3
30412 isupper_l.3
30413 isxdigit_l.3
30414 Michael Kerrisk
30415 New links to isalpha.3
30416
30417 tolower_l.3
30418 toupper_l.3
30419 Michael Kerrisk
30420 New links to toupper.3
30421
30422 towlower_l.3
30423 Michael Kerrisk
30424 New link to towlower.3
30425
30426 towupper_l.3
30427 Michael Kerrisk
30428 New link to towupper.3
30429
30430
30431 Global changes
30432 --------------
30433
30434 Various pages
30435 Michael Kerrisk
30436 Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
30437
30438
30439 Changes to individual pages
30440 ---------------------------
30441
30442 mount.2
30443 Michael Kerrisk
30444 SEE ALSO: add blkid(1)
30445
30446 msgop.2
30447 Michael Kerrisk
30448 Document two MSG_COPY failure modes
30449 Since Linux 3.14, the kernel now diagnoses two errors
30450 when using msgrcv() MSG_COPY:
30451 * MSG_COPY must be specified with IPC_NOWAIT
30452 * MSG_COPY can't be specified with MSG_EXCEPT
30453
30454 open.2
30455 Michael Kerrisk
30456 Organize some material under additional subheadings in NOTES
30457 There's an amorphous mass of material under NOTES. Structure
30458 it with some subheadings, and do a little reorganizing.
30459 Michael Kerrisk
30460 Add other system calls and functions that are like openat()
30461 fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a
30462 directory file descriptor argument for the same reason as openat().
30463 Also: reword the rationale for the *at() functions somewhat.
30464 Michael Kerrisk
30465 Clarify ELOOP error interaction with O_PATH
30466
30467 readahead.2
30468 Phillip Susi [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig]
30469 Don't claim the call blocks until all data has been read
30470 The readahead(2) man page was claiming that the call blocks until
30471 all data has been read into the cache. This is incorrect.
30472
30473 See https://bugzilla.kernel.org/show_bug.cgi?id=54271
30474
30475 stat.2
30476 Michael Kerrisk
30477 SEE ALSO: add ls(1) and stat(1)
30478
30479 fts.3
30480 Christoph Hellwig [Michael Kerrisk]
30481 The fts(3) API does not work with LFS builds
30482 As pointed out during a recent discussion on libc-hacker the
30483 fts(3) APIs can't be used with large file offsets:
30484
30485 https://sourceware.org/bugzilla/show_bug.cgi?id=15838
30486
30487 mbrtowc.3
30488 mbsnrtowcs.3
30489 mbsrtowcs.3
30490 mbtowc.3
30491 Michael Kerrisk
30492 Add entries in SEE ALSO
30493 Mainly inspired by the POSIX pages.
30494
30495 mbsinit.3
30496 Michael Kerrisk
30497 SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)
30498
30499 mbsrtowcs.3
30500 wcsrtombs.3
30501 Michael Kerrisk
30502 SEE ALSO: add mbsinit(3)
30503
30504 mbstowcs.3
30505 Michael Kerrisk [Stefan Puiu]
30506 Add example program
30507 And add some SEE ALSO entries
30508
30509 memcmp.3
30510 Peng Haitao
30511 ATTRIBUTES: Note function that is thread-safe
30512 The function memcmp() is thread safe.
30513
30514 memcpy.3
30515 Peng Haitao
30516 ATTRIBUTES: Note function that is thread-safe
30517 The function memcpy() is thread safe.
30518
30519 memfrob.3
30520 Peng Haitao
30521 ATTRIBUTES: Note function that is thread-safe
30522 The function memfrob() is thread safe.
30523
30524 memmem.3
30525 Peng Haitao
30526 ATTRIBUTES: Note function that is thread-safe
30527 The function memmem() is thread safe.
30528
30529 memmove.3
30530 Peng Haitao
30531 ATTRIBUTES: Note function that is thread-safe
30532 The function memmove() is thread safe.
30533
30534 mempcpy.3
30535 Peng Haitao
30536 ATTRIBUTES: Note functions that are thread-safe
30537 The functions mempcpy() and wmempcpy() are thread safe.
30538
30539 memset.3
30540 Peng Haitao
30541 ATTRIBUTES: Note function that is thread-safe
30542 The function memset() is thread safe.
30543
30544 strerror.3
30545 Michael Kerrisk
30546 CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008
30547 Michael Kerrisk
30548 Add SS heading for strerror_r()
30549
30550 toupper.3
30551 Michael Kerrisk
30552 Rewrite to more explicitly bring locales into the discussion
30553 Michael Kerrisk
30554 Retitle BUGS section to NOTES
30555 These are not really bugs, just background info.
30556
30557 wcrtomb.3
30558 wcsnrtombs.3
30559 wcsrtombs.3
30560 wcstombs.3
30561 wctomb.3
30562 Michael Kerrisk
30563 SEE ALSO: add various entries
30564 Mainly inspired by POSIX
30565
30566 core.5
30567 Mike Frysinger [Michael Kerrisk]
30568 Document core_pattern %d specifier
30569 Document %P core_pattern specifier
30570 Michael Kerrisk
30571 Rearrange core_pattern specifiers alphabetically
30572
30573 locale.5
30574 Michael Kerrisk
30575 SEE ALSO: add newlocale(3) + duplocale(3)
30576
30577 feature_test_macros.7
30578 Michael Kerrisk [Joseph S. Myers]
30579 Remove mention of bogus _ISOC95_SOURCE macro
30580 The _ISOC95_SOURCE macro is defined in <features.h>, but it
30581 does nothing. So remove discussion of it, and move some of
30582 the discussion of C95 under the _ISOC99_SOURCE subhead.
30583 Michael Kerrisk [Carlos O'Donell]
30584 Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE
30585 To compile warning-free across glibc < 2.20 and glibc >= 2.20
30586 code may been to define both _DEFAULT_SOURCE and either
30587 _BSD_SOURCE or _SVID_SOURCE.
30588 Michael Kerrisk
30589 Reword description of C90
30590
30591 locale.7
30592 Michael Kerrisk
30593 Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API
30594 Michael Kerrisk
30595 Remove reference to LI18NUX2000
30596 LI18NUX2000 is difficult to even find these days, and in any case
30597 this page does not document gettext(), so notes about gettext()
30598 in the CONFORMING TO section here make no sense.
30599 Michael Kerrisk
30600 SEE ALSO: add mbstowcs(3) and wcstombs(3)
30601 SEE ALSO: add newlocale(3) + duplocale(3)
30602
30603 man-pages.7
30604 Michael Kerrisk
30605 Add preferred term "superblock"
30606 Michael Kerrisk
30607 Add preferred terms "uppercase" and "lowercase"
30608
30609
30610
30611 ==================== Changes in man-pages-3.64 ====================
30612
30613 Released: 2014-04-06, Munich
30614
30615
30616 Contributors
30617 ------------
30618
30619 The following people contributed patches/fixes or (noted in brackets
30620 in the changelog below) reports, notes, and ideas that have been
30621 incorporated in changes in this release:
30622
30623 Abhay Sachan <sachan.abhay@gmail.com>
30624 Alexey Samsonov <samsonov@google.com>
30625 Andrey Vagin <avagin@openvz.org>
30626 Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
30627 Christoph Hellwig <hch@infradead.org>
30628 David Prévot <taffit@debian.org>
30629 Eric Dumazet <edumazet@google.com>
30630 Eric W. Biederman <ebiederm@xmission.com>
30631 Jan Kara <jack@suse.cz>
30632 Kir Kolyshkin <kir@openvz.org>
30633 Michael Kerrisk <mtk.manpages@gmail.com>
30634 Mike Frysinger <vapier@gentoo.org>
30635 NeilBrown <neilb@suse.de>
30636 Peng Haitao <penght@cn.fujitsu.com>
30637 Peter Hurley <peter@hurleysoftware.com>
30638 Petr Gajdos <pgajdos@suse.cz>
30639 Robert P. J. Day <rpjday@crashcourse.ca>
30640 Vince Weaver <vincent.weaver@maine.edu>
30641 Yuri Kozlov <yuray@komyakino.ru>
30642
30643 Apologies if I missed anyone!
30644
30645
30646 New and rewritten pages
30647 -----------------------
30648
30649 open_by_handle_at.2
30650 Michael Kerrisk [Mike Frysinger, Neil Brown, Aneesh Kumar K.V,
30651 Christoph Hellwig]
30652 New page describing name_to_handle_at(2) and open_by_handle_at(2)
30653
30654 inotify.7
30655 Michael Kerrisk
30656 Rewrite introductory section
30657 Reorganize "Limitations and caveats" subsection
30658 Michael Kerrisk
30659 Further describe the race when adding a watch to a new subtree
30660 Michael Kerrisk
30661 Directory renames may invalidate multiple paths cached by application
30662 Michael Kerrisk
30663 Add paragraph on cache consistency checking
30664 Michael Kerrisk
30665 Mention cache rebuilding to handle overflow events
30666 Michael Kerrisk
30667 Moving an object to another filesystem generates IN_DELETE_SELF
30668 Michael Kerrisk [Jan Kara]
30669 Add text on dealing with rename() events
30670 Michael Kerrisk
30671 Note rationale and consequences of event coalescing
30672 Michael Kerrisk [Eric W. Biederman]
30673 Inotify doesn't work for remote and pseudo filesystems
30674 Michael Kerrisk
30675 Add some examples of events generated by various system calls
30676 Michael Kerrisk
30677 BUGS: IN_ONESHOT does now cause IN_IGNORED when the watch is dropped
30678 A silent change as a result of the fanotify work in kernel 2.6.36.
30679 Michael Kerrisk
30680 Note that IN_DELETE_SELF will be followed by IN_IGNORED
30681 Michael Kerrisk
30682 Note that IN_UNMOUNT will be followed by an IN_IGNORED event
30683 Michael Kerrisk
30684 Inotify does not report events for mmap(2) and msync(2)
30685 Michael Kerrisk
30686 Add examples of syscalls that trigger IN_ATTRIB
30687 Michael Kerrisk
30688 Add some examples of syscalls that trigger IN_MODIFY
30689 Michael Kerrisk
30690 execve(2) also generates IN_ACCESS
30691 Michael Kerrisk
30692 Add examples of syscalls that trigger IN_CREATE
30693
30694
30695 Newly documented interfaces in existing pages
30696 ---------------------------------------------
30697
30698 perf_event_open.2
30699 Vince Weaver [Michael Kerrisk]
30700 Document the PERF_FLAG_FD_CLOEXEC flag
30701 The Linux 3.14 release adds support for the PERF_FLAG_FD_CLOEXEC
30702 flag.
30703
30704 feature_test_macros.7
30705 Michael Kerrisk
30706 Document _LARGEFILE_SOURCE
30707
30708 tcp.7
30709 Michael Kerrisk [Eric Dumazet]
30710 Document /proc/sys/net/ipv4/tcp_autocorking
30711 Text heavily based on Documentation/networking/ip-sysctl.txt
30712
30713
30714 New and changed links
30715 ---------------------
30716
30717 name_to_handle_at.2
30718 Michael Kerrisk
30719 New link to new open_by_handle_at(2) page
30720
30721
30722 Global changes
30723 --------------
30724
30725 fmemopen.3
30726 getaddrinfo.3
30727 mq_notify.3
30728 offsetof.3
30729 aio.7
30730 Michael Kerrisk
30731 Print size_t/ssize_t values using %z printf() modifier
30732 There are fewer and fewer systems these days that don't
30733 support the %z specifier mandated in C99. So replace the
30734 use of %ld/%lu + (long) cast with %zd/%zu.
30735
30736
30737 Changes to individual pages
30738 ---------------------------
30739
30740 bdflush.2
30741 fsync.2
30742 sync.2
30743 Kir Kolyshkin
30744 SEE ALSO: remove update(8) reference
30745 Remove reference to update(8) man page, since there is no such
30746 page. This is an ancient BSD leftover I believe.
30747
30748 chown.2
30749 Michael Kerrisk
30750 Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30751
30752 getxattr.2
30753 Abhay Sachan
30754 Fix RETURN VALUE description
30755 A EA can have length zero.
30756
30757 inotify_add_watch.2
30758 Michael Kerrisk
30759 ERRORS: add ENAMETOOLONG
30760
30761 inotify_init.2
30762 Michael Kerrisk
30763 Add pointer to inotify(7)
30764
30765 link.2
30766 Michael Kerrisk
30767 When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
30768 directory
30769
30770 mmap.2
30771 Andrey Vagin
30772 The file descriptor for a file mapping must be readable
30773 There is no difference between MAP_SHARED and MAP_PRIVATE.
30774
30775 open.2
30776 Michael Kerrisk
30777 SEE ALSO: add open_by_name_at(2)
30778
30779 perf_event_open.2
30780 Vince Weaver
30781 Document PERF_EVENT_IOC_PERIOD behavior change
30782 Linux 3.14 (in commit bad7192b842c83e580747ca57104dd51fe08c223)
30783 changes the perf_event PERF_EVENT_IOC_PERIOD ioctl() behavior
30784 on all architectures to update immediately, to match the behavior
30785 found on ARM.
30786
30787 stat.2
30788 Michael Kerrisk
30789 Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30790
30791 syscalls.2
30792 Michael Kerrisk
30793 Add sched_getattr() and sched_setattr()
30794 And update kernel version to 3.14
30795
30796 abort.3
30797 Peng Haitao
30798 ATTRIBUTES: Note function that is thread-safe
30799 The function abort() is thread safe.
30800
30801 confstr.3
30802 Michael Kerrisk
30803 SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
30804
30805 exit.3
30806 Peng Haitao
30807 ATTRIBUTES: Note function that is not thread-safe
30808 The function exit() is not thread safe.
30809
30810 fenv.3
30811 Peng Haitao
30812 ATTRIBUTES: Note functions that are thread-safe
30813 The functions feclearexcept(), fegetexceptflag(), feraiseexcept(),
30814 fesetexceptflag(), fetestexcept(), fegetround(), fesetround(),
30815 fegetenv(), feholdexcept(), fesetenv(), feupdateenv(),
30816 feenableexcept(), fedisableexcept() and fegetexcept() are thread
30817 safe.
30818
30819 fpathconf.3
30820 Michael Kerrisk
30821 SEE ALSO: add confstr(3)
30822
30823 fseek.3
30824 Michael Kerrisk [Petr Gajdos]
30825 Document EINVAL error for negative file offset
30826
30827 fseeko.3
30828 Michael Kerrisk
30829 Add feature test macro requirements
30830
30831 fts.3
30832 Michael Kerrisk [Mike Frysinger]
30833 Remove mention of "32-bit systems" in BUGS
30834
30835 fwide.3
30836 wprintf.3
30837 Michael Kerrisk [Robert P. J. Day]
30838 Remove mention of bogus _ISOC95_SOURCE feature test macro
30839
30840 getline.3
30841 Alexey Samsonov
30842 Caller should free the allocated buffer even if getline() failed
30843 Relevant discussion in glibc bugzilla:
30844 https://sourceware.org/bugzilla/show_bug.cgi?id=5666
30845
30846 getloadavg.3
30847 Peng Haitao
30848 ATTRIBUTES: Note function that is thread-safe
30849 The function getloadavg() is thread safe.
30850
30851 getpt.3
30852 Peng Haitao
30853 ATTRIBUTES: Note function that is thread-safe
30854 The function getpt() is thread safe.
30855
30856 if_nametoindex.3
30857 Peng Haitao
30858 ATTRIBUTES: Note functions that are thread-safe
30859 The functions if_nametoindex() and if_indextoname() are thread safe.
30860
30861 index.3
30862 Peng Haitao
30863 ATTRIBUTES: Note functions that are thread-safe
30864 The functions index() and rindex() are thread safe.
30865
30866 mkfifo.3
30867 Peng Haitao
30868 ATTRIBUTES: Note functions that are thread-safe
30869 The functions mkfifo() and mkfifoat() are thread safe.
30870
30871 netlink.3
30872 Michael Kerrisk
30873 SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
30874
30875 random.3
30876 Peng Haitao
30877 ATTRIBUTES: Note functions that are thread-safe
30878 The functions random(), srandom(), initstate() and setstate()
30879 are thread safe.
30880
30881 random_r.3
30882 Peng Haitao
30883 ATTRIBUTES: Note functions that are thread-safe
30884 The functions random_r(), srandom_r(), initstate_r() and
30885 setstate_r() are thread safe.
30886
30887 sigvec.3
30888 Peng Haitao
30889 ATTRIBUTES: Note functions that are thread-safe
30890 The functions sigvec(), sigblock(), sigsetmask() and
30891 siggetmask() are thread safe.
30892
30893 The macro sigmask() is thread safe.
30894
30895 sysconf.3
30896 Michael Kerrisk
30897 SEE ALSO: add confstr(3)
30898
30899 termios.3
30900 Michael Kerrisk [Peter Hurley]
30901 Fix error in discussion of MIN > 0, TIME == 0 noncanonical mode
30902 As reported by Peter Hurley, for the MIN > 0, TIME == 0 case:
30903
30904 read() may unblock when MIN bytes are available but return
30905 up to the 'count' parameter if more input arrives in between
30906 waking and copying into the user buffer.
30907 ...
30908 read() may also _not_ return until MIN bytes have been
30909 received, even if 'count' bytes have been received.
30910 Michael Kerrisk
30911 Add a note on interaction of O_NONBLOCK with noncanonical MIN/TIME
30912 POSIX leaves the behavior open.
30913 Michael Kerrisk
30914 Clarify termination conditions for MIN > 0, TIME > 0
30915 Michael Kerrisk
30916 Clarify behavior if data is available before noncanonical read()
30917 Michael Kerrisk
30918 Add descriptive titles to noncanonical read() cases
30919
30920 symlink.7
30921 Michael Kerrisk
30922 Add subsection on opening a symbolic link with O_PATH
30923 Michael Kerrisk
30924 name_to_handle_at(2) and open_by_handle_at(2) optionally follow symlinks
30925 Michael Kerrisk
30926 Mention use of readlink(2) to read contents of a symlink
30927
30928
30929 ==================== Changes in man-pages-3.65 ====================
30930
30931 Released: 2014-04-20, Munich
30932
30933
30934 Contributors
30935 ------------
30936
30937 The following people contributed patches/fixes or (noted in brackets
30938 in the changelog below) reports, notes, and ideas that have been
30939 incorporated in changes in this release:
30940
30941 Alex Thorlton <athorlton@sgi.com>
30942 Ashish Sangwan <a.sangwan@samsung.com>
30943 Christopher Covington <cov@codeaurora.org>
30944 Christoph Hellwig <hch@infradead.org>
30945 Craig McQueen <craig.mcqueen@beamcommunications.com>
30946 Dave Chinner <david@fromorbit.com>
30947 David Prévot <taffit@debian.org>
30948 Greg Troxel <gdt@ir.bbn.com>
30949 Matthew Dempsky <mdempsky@chromium.org>
30950 Michael Kerrisk <mtk.manpages@gmail.com>
30951 Mike Frysinger <vapier@gentoo.org>
30952 Namjae Jeon <namjae.jeon@samsung.com>
30953 Peng Haitao <penght@cn.fujitsu.com>
30954 Petr Gajdos <pgajdos@suse.cz>
30955 Richard Hansen <rhansen@bbn.com>
30956 Simon Paillard <spaillard@debian.org>
30957 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
30958 Vince Weaver <vincent.weaver@maine.edu>
30959 Yuri Kozlov <yuray@komyakino.ru>
30960
30961 Apologies if I missed anyone!
30962
30963
30964 New and rewritten pages
30965 -----------------------
30966
30967 inet_net_pton.3
30968 Michael Kerrisk
30969 New page describing inet_net_pton(3) and inet_net_ntop(3)
30970
30971
30972 Newly documented interfaces in existing pages
30973 ---------------------------------------------
30974
30975 fallocate.2
30976 Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
30977 Document FALLOC_FL_COLLAPSE_RANGE
30978
30979 prctl.2
30980 Michael Kerrisk [Alex Thorlton]
30981 Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
30982
30983 proc.5
30984 Michael Kerrisk
30985 Document /proc/[pid]/stack
30986 Michael Kerrisk
30987 Document /proc/[pid]/clear_refs
30988
30989
30990 New and changed links
30991 ---------------------
30992
30993 inet_net_ntop.3
30994 Michael Kerrisk
30995 New link to new inet_net_pton.3
30996
30997
30998 Changes to individual pages
30999 ---------------------------
31000
31001 fcntl.2
31002 Michael Kerrisk
31003 Note the race when O_CLOEXEC is used at same time as fork()+execve()
31004
31005 madvise.2
31006 Michael Kerrisk
31007 SEE ALSO: see prctl(2)
31008 Because of PR_SET_THP_DISABLE.
31009
31010 mlock.2
31011 Michael Kerrisk
31012 Describe treatment of MCL_FUTURE during fork(2) and execve(2)
31013
31014 msync.2
31015 Michael Kerrisk [Richard Hansen, Greg Troxel]
31016 Warn that one of MS_SYNC or MS_ASYNC is required
31017
31018 open.2
31019 Michael Kerrisk
31020 Add more detail on the race that O_CLOEXEC is designed to avoid
31021 Michael Kerrisk [Matthew Dempsky]
31022 Remove crufty text stating that O_DIRECTORY is Linux-specific
31023 Michael Kerrisk
31024 Note which filesystems support O_TMPFILE
31025
31026 perf_event_open.2
31027 Vince Weaver [Michael Kerrisk]
31028 Clarify EACCES and EPERM errors
31029 Clarify the reasons for EACCES and EPERM errors.
31030 Vince Weaver [Michael Kerrisk]
31031 Make the ERRORS section more comprehensive.
31032 Determined both by code inspection and by writing a large
31033 number of test programs.
31034
31035 personality.2
31036 Michael Kerrisk
31037 Available execution domains are listed in <sys/personality.h>
31038 Michael Kerrisk
31039 Fix discussion of return value
31040
31041 prctl.2
31042 Michael Kerrisk
31043 ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
31044 ERRORS: document EINVAL for PR_SET_PDEATHSIG
31045 ERRORS: document EINVAL for PR_SET_TIMING
31046 ERRORS: document EINVAL for PR_SET_DUMPABLE
31047 ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
31048
31049 shmget.2
31050 Michael Kerrisk
31051 Rewrite description of SHMMNI default value
31052 Michael Kerrisk
31053 Note default value of SHMMAX
31054 Note default value for SHMALL
31055
31056 byteorder.3
31057 Peng Haitao
31058 ATTRIBUTES: Note functions that are thread-safe
31059 The functions htonl(), htons(), ntohl() and ntohs() are thread
31060 safe.
31061
31062 fexecve.3
31063 Michael Kerrisk [Steven Stewart-Gallus]
31064 If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
31065 See https://bugzilla.kernel.org/show_bug.cgi?id=74481
31066
31067 ffs.3
31068 Peng Haitao
31069 ATTRIBUTES: Note functions that are thread-safe
31070 The functions ffs(), ffsl() and ffsll() are thread safe.
31071
31072 getauxval.3
31073 Peng Haitao
31074 ATTRIBUTES: Note function that is thread-safe
31075 The function getauxval() is thread safe.
31076
31077 getcontext.3
31078 Peng Haitao
31079 ATTRIBUTES: Note functions that are thread-safe
31080 The functions getcontext() and setcontext() are thread safe.
31081
31082 getsubopt.3
31083 Peng Haitao
31084 ATTRIBUTES: Note function that is thread-safe
31085 The function getsubopt() is thread safe.
31086
31087 getutmp.3
31088 Peng Haitao
31089 ATTRIBUTES: Note functions that are thread-safe
31090 The functions getutmp() and getutmpx() are thread safe.
31091
31092 inet.3
31093 Michael Kerrisk
31094 Note success and error return for inet_aton()
31095
31096 inet.3
31097 Michael Kerrisk [Craig McQueen]
31098 The form 'a.b' if is suitable for Class A addresses (not class C)
31099 Michael Kerrisk
31100 SEE ALSO: add inet_net_pton(3)
31101
31102 makecontext.3
31103 Peng Haitao
31104 ATTRIBUTES: Note functions that are thread-safe
31105 The functions makecontext() and swapcontext() are thread safe.
31106
31107 pthread_attr_setdetachstate.3
31108 Peng Haitao
31109 ATTRIBUTES: Note functions that are thread-safe
31110 The functions pthread_attr_setdetachstate() and
31111 pthread_attr_getdetachstate() are thread safe.
31112
31113 pthread_attr_setguardsize.3
31114 Peng Haitao
31115 ATTRIBUTES: Note functions that are thread-safe
31116 The functions pthread_attr_setguardsize() and
31117 pthread_attr_getguardsize() are thread safe.
31118
31119 sigsetops.3
31120 Peng Haitao
31121 ATTRIBUTES: Note functions that are thread-safe
31122 The functions sigemptyset(), sigfillset(), sigaddset(),
31123 sigdelset(), sigismember(), sigisemptyset(), sigorset() and
31124 sigandset() are thread safe.
31125
31126 proc.5
31127 Petr Gajdos
31128 Improve /proc/[pid]/smaps entries description
31129 Michael Kerrisk
31130 /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
31131 Michael Kerrisk
31132 Note kernel version for /proc/sys/kernel/{shmall,shmmax}
31133 Michael Kerrisk
31134 Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
31135
31136 capabilities.7
31137 Michael Kerrisk
31138 SEE ALSO: add capsh(1)
31139
31140 libc.7
31141 Michael Kerrisk
31142 Add musl libc
31143
31144
31145 ==================== Changes in man-pages-3.66 ====================
31146
31147 Released: 2014-05-08, Munich
31148
31149
31150 Contributors
31151 ------------
31152
31153 The following people contributed patches/fixes or (noted in brackets
31154 in the changelog below) reports, notes, and ideas that have been
31155 incorporated in changes in this release:
31156
31157 Alan Curry <rlwinm@sdf.org>
31158 Carsten Andrich <carsten.andrich@tu-ilmenau.de>
31159 Daniel Borkmann <dborkman@redhat.com>
31160 David Prévot <taffit@debian.org>
31161 Eric Siegerman <pub08-knl@davor.org>
31162 Heinrich Schuchardt <xypron.glpk@gmx.de>
31163 Jan Kara <jack@suse.cz>
31164 Jan Moskyto Matejka <mq@suse.cz>
31165 John Marshall <jm18@sanger.ac.uk>
31166 Lukáš Czerner <lczerner@redhat.com>
31167 Manfred Spraul <manfred@colorfullife.com>
31168 Michael Kerrisk <mtk.manpages@gmail.com>
31169 Miklos Szeredi <miklos@szeredi.hu>
31170 Neil Horman <nhorman@tuxdriver.com>
31171 Peng Haitao <penght@cn.fujitsu.com>
31172 Peter Schiffer <pschiffe@redhat.com>
31173 Randy Dunlap <rdunlap@infradead.org>
31174 Silvan Jegen <s.jegen@gmail.com>
31175 Simon Paillard <spaillard@debian.org>
31176 Stefan Puiu <stefan.puiu@gmail.com>
31177 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31178 Stijn Hinterding <contact@stijnhinterding.nl>
31179 Willem de Bruijn <willemb@google.com>
31180 Yuri Kozlov <yuray@komyakino.ru>
31181
31182 Apologies if I missed anyone!
31183
31184
31185 New and rewritten pages
31186 -----------------------
31187
31188 fanotify_init.2
31189 Heinrich Schuchardt, Michael Kerrisk
31190 New page documenting fanotify_init(2)
31191
31192 fanotify_mark.2
31193 Heinrich Schuchardt, Michael Kerrisk
31194 New page documenting fanotify_mark(2)
31195
31196 sched_setscheduler.2
31197 Michael Kerrisk
31198 Page rewritten
31199 Stripped out the general scheduling material, which
31200 moved to sched(7), and rewrote much of the remainder.
31201 Changed copyright and license since pretty much all
31202 of the content was or is written by mtk.
31203
31204 fanotify.7
31205 Heinrich Schuchardt, Michael Kerrisk
31206 New page providing overview of the fanotify API
31207
31208 sched.7
31209 Michael Kerrisk
31210 New page providing an overview of the scheduling APIs
31211 Most of this content derives from sched_setscheduler(2). In
31212 preparation for adding a sched_setattr(2) page, it makes
31213 sense to isolate out this general content to a separate
31214 page that is referred to by the other scheduling pages.
31215
31216
31217 Newly documented interfaces in existing pages
31218 ---------------------------------------------
31219
31220 fallocate.2
31221 Lukas Czerner [Michael Kerrisk]
31222 Document FALLOC_FL_ZERO_RANGE
31223 FALLOC_FL_ZERO_RANGE was added in Linux 3.14,
31224 for zeroing ranges in the allocated space in a file.
31225
31226 rename.2
31227 Miklos Szeredi [Michael Kerrisk]
31228 Document renameat2() system call added in Linux 3.15
31229
31230 shmop.2
31231 Michael Kerrisk
31232 Document SHM_EXEC
31233
31234
31235 Changes to individual pages
31236 ---------------------------
31237
31238 flock.2
31239 Michael Kerrisk
31240 Employ term "open file description" in DESCRIPTION
31241 And include reference to open(2) for an explanation of the term.
31242
31243 getpriority.2
31244 Michael Kerrisk
31245 SEE ALSO: add sched(7)
31246
31247 getsockopt.2
31248 Carsten Andrich
31249 SEE ALSO: add packet(7)
31250
31251 link.2
31252 Michael Kerrisk [Steven Stewart-Gallus]
31253 Document ENOENT error for linkat()
31254 See https://bugzilla.kernel.org/show_bug.cgi?id=73301
31255
31256 msgget.2
31257 Michael Kerrisk
31258 Reword EEXIST error
31259
31260 msgop.2
31261 Michael Kerrisk
31262 Note capability required to raise MQ size beyond MSGMNB
31263
31264 msync.2
31265 Michael Kerrisk [Heinrich Schuchardt]
31266 s/flushes... back to disk/flushes... back to filesystem/
31267
31268 nice.2
31269 Michael Kerrisk
31270 SEE ALSO: add sched(7)
31271
31272 open.2
31273 Peter Schiffer
31274 Update note on alignment of user buffer and file offset for O_DIRECT
31275 The sentence in open(2) man page in notes for O_DIRECT flag:
31276
31277 "Under Linux 2.6, alignment to 512-byte boundaries suffices."
31278
31279 is not universally correct. The alignment is a property of the
31280 storage, for example, 4k-sector drives with no 512 byte sector
31281 emulation will be unable to perform 512-byte direct I/O.
31282 Michael Kerrisk
31283 Note some of the various synonyms for "open file description"
31284 Michael Kerrisk
31285 Remove repetitious text on use of fcntl() to change file status flags
31286
31287 open_by_handle_at.2
31288 Michael Kerrisk
31289 Mention FreeBSD analogs
31290
31291 posix_fadvise.2
31292 Michael Kerrisk [Eric Siegerman]
31293 Fix wording error under "Architecture-specific variants"
31294 See https://bugzilla.kernel.org/show_bug.cgi?id=75431
31295
31296 process_vm_readv.2
31297 Michael Kerrisk [Stijn Hinterding]
31298 Add feature test macro requirements
31299 The _GNU_SOURCE FTM must be defined.
31300
31301 read.2
31302 Michael Kerrisk
31303 BUGS: detail nonatomicity bug with respect to file offset updates
31304 This bug was fixed in Linux 3.14, with commit
31305 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
31306 See also http://thread.gmane.org/gmane.linux.kernel/1649458
31307
31308 sched_get_priority_max.2
31309 Michael Kerrisk
31310 Small changes consistent with migration of content to sched(7)
31311
31312 sched_rr_get_interval.2
31313 Michael Kerrisk
31314 Small changes consistent with migration of content to sched(7)
31315
31316 sched_setaffinity.2
31317 Michael Kerrisk
31318 Small changes consistent with migration of content to sched(7)
31319
31320 sched_setparam.2
31321 Michael Kerrisk
31322 Small changes consistent with migration of content to sched(7)
31323
31324 sched_yield.2
31325 Michael Kerrisk
31326 Small changes consistent with migration of content to sched(7)
31327
31328 semget.2
31329 Michael Kerrisk
31330 Consolidate discussion on noninitialization of semaphores
31331 The fact that semget() does not initialize the semaphores
31332 in a new set was covered in two places (in DESCRIPTION
31333 and BUGS). Consolidate these into one place (in NOTES)
31334 and also point out that POSIX.1-2008 says that a future
31335 version of the standard may require an implementation to
31336 initialize the semaphores to 0.
31337 Michael Kerrisk
31338 Clarify SEMMNS versus SEMMSL*SEMMNI
31339 Michael Kerrisk
31340 Rework EINVAL text a little
31341 Michael Kerrisk
31342 Clarify wording for EEXIST error
31343
31344 shmget.2
31345 Manfred Spraul
31346 Clarify SHMALL
31347 The default for SHMALL is a limit of 8 GB, regardless of
31348 PAGE_SIZE. The current documentation does not mention that
31349 and is therefore more difficult to understand than necessary.
31350 Manfred Spraul
31351 Correct math error
31352 2097152 is 2^21, not 2^20.
31353 Michael Kerrisk
31354 Reword EEXIST error
31355 Michael Kerrisk
31356 Clarify one of the EINVAL cases
31357 Michael Kerrisk
31358 Note that SHM_NORESERVE is a Linux extension
31359 Michael Kerrisk [Simon Paillard]
31360 Fix kernel version numbers in discussion of SHMALL
31361 Michael Kerrisk
31362 Rework EINVAL text
31363 Michael Kerrisk
31364 Move and rework discussion of mode bits
31365 Michael Kerrisk
31366 Reword description of O_EXCL
31367
31368 shmop.2
31369 Michael Kerrisk
31370 Move fork(2), execve(2), _exit(2) discussion to NOTES
31371 Michael Kerrisk
31372 Add subheads for shmat() and shmdt()
31373 Michael Kerrisk
31374 Rework discussion of SHM_RDONLY and SHM_REMAP into list format
31375 Michael Kerrisk
31376 Structure the attach cases as a list
31377
31378 sigaction.2
31379 Alan Curry
31380 Fix bad cross reference (times(2) not time(2))
31381 The system call that reports child CPU usage is times(2),
31382 not time(2).
31383
31384 symlink.2
31385 Michael Kerrisk [Steven Stewart-Gallus]
31386 Document ENOENT error for symlinkat()
31387 See https://bugzilla.kernel.org/show_bug.cgi?id=73301
31388
31389 syscalls.2
31390 Michael Kerrisk
31391 Add renameat2()
31392 And bump kernel version.
31393
31394 write.2
31395 Michael Kerrisk
31396 BUGS: detail nonatomicity bug with respect to file offset updates
31397 This bug was fixed in Linux 3.14, with commit
31398 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4
31399 See also http://thread.gmane.org/gmane.linux.kernel/1649458
31400
31401 pthread_attr_setinheritsched.3
31402 Peng Haitao
31403 ATTRIBUTES: Note functions that are thread-safe
31404 The functions pthread_attr_setinheritsched() and
31405 pthread_attr_getinheritsched() are thread safe.
31406
31407 pthread_attr_setschedparam.3
31408 Peng Haitao
31409 ATTRIBUTES: Note functions that are thread-safe
31410 The functions pthread_attr_setschedparam() and
31411 pthread_attr_getschedparam() are thread safe.
31412
31413 pthread_attr_setschedpolicy.3
31414 Peng Haitao
31415 ATTRIBUTES: Note functions that are thread-safe
31416 The functions pthread_attr_setschedpolicy() and
31417 pthread_attr_getschedpolicy() are thread safe.
31418
31419 pthread_attr_setscope.3
31420 Peng Haitao
31421 ATTRIBUTES: Note functions that are thread-safe
31422 The functions pthread_attr_setscope() and pthread_attr_getscope()
31423 are thread safe.
31424
31425 pthread_attr_setstack.3
31426 Peng Haitao
31427 ATTRIBUTES: Note functions that are thread-safe
31428 The functions pthread_attr_setstack() and pthread_attr_getstack()
31429 are thread safe.
31430
31431 sched_getcpu.3
31432 Michael Kerrisk
31433 SEE ALSO: add sched(7)
31434
31435 termios.3
31436 Michael Kerrisk [Yuri Kozlov]
31437 Rework intro text for 'c_oflag'
31438 Michael Kerrisk
31439 OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text
31440
31441 proc.5
31442 Jan Moskyto Matejka [Randy Dunlap]
31443 Improve description of /proc/stat 'intr' field
31444 The sum at the beginning of line "intr" includes also
31445 unnumbered interrupts.
31446
31447 packet.7
31448 Carsten Andrich [Neil Horman]
31449 Improve sockopt documentation for packet sockets
31450 Carsten Andrich [Willem de Bruijn]
31451 PACKET_LOSS has inverse meaning
31452 Stefan Puiu [Daniel Borkmann, Carsten Andrich]
31453 Status in PACKET_RX_RING is actually a bit mask
31454 Michael Kerrisk [Carsten Andrich]
31455 SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c
31456
31457
31458 ==================== Changes in man-pages-3.67 ====================
31459
31460 Released: 2014-05-21, Munich
31461
31462
31463 Contributors
31464 ------------
31465
31466 The following people contributed patches/fixes or (noted in brackets
31467 in the changelog below) reports, notes, and ideas that have been
31468 incorporated in changes in this release:
31469
31470 Andy Lutomirski <luto@amacapital.net>
31471 Aurelien Jarno <aurelien@aurel32.net>
31472 Bill Allombert <ballombe@debian.org>
31473 Christoph Hellwig <hch@infradead.org>
31474 Davidlohr Bueso <davidlohr@hp.com>
31475 Heinrich Schuchardt <xypron.glpk@gmx.de>
31476 Ingo Schwarze <schwarze@usta.de>
31477 Jan Kara <jack@suse.cz>
31478 Jon Grant <jg@jguk.org>
31479 Juri Lelli <juri.lelli@gmail.com>
31480 Lucas De Marchi <lucas.demarchi@profusion.mobi>
31481 Michael Kerrisk <mtk.manpages@gmail.com>
31482 Peng Haitao <penght@cn.fujitsu.com>
31483 Peter Zijlstra <peterz@infradead.org>
31484 Rasmus Villemoes <rv@rasmusvillemoes.dk>
31485 Sam Varshavchik <mrsam@courier-mta.com>
31486 Simon Paillard <spaillard@debian.org>
31487 Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31488 Török Edwin <edwin@etorok.net>
31489 William Morriss <wjmelements@gmail.com>
31490 Yuri Kozlov <yuray@komyakino.ru>
31491
31492 Apologies if I missed anyone!
31493
31494
31495 New and rewritten pages
31496 -----------------------
31497
31498 sched_setattr.2
31499 Michael Kerrisk, Peter Zijlstra [Juri Lelli]
31500 New page describing sched_setattr(2) and sched_getattr(2)
31501
31502 system.3
31503 Michael Kerrisk
31504 Rewrote large parts of the page and added a number of details
31505
31506
31507 Newly documented interfaces in existing pages
31508 ---------------------------------------------
31509
31510 sched.7
31511 Peter Zijlstra, Michael Kerrisk [Juri Lelli]
31512 Document SCHED_DEADLINE
31513
31514 New and changed links
31515 ---------------------
31516
31517 renameat2.2
31518 Michael Kerrisk
31519 New link to rename.2
31520
31521 sched_getattr.2
31522 Michael Kerrisk
31523 New link to new sched_setattr
31524
31525
31526 Changes to individual pages
31527 ---------------------------
31528
31529 bind.2
31530 Michael Kerrisk
31531 ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31532
31533 chown.2
31534 Michael Kerrisk
31535 NOTES: Add some subheadings
31536
31537 connect.2
31538 Michael Kerrisk [William Morriss]
31539 ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion
31540 Verified from testing and the kernel source.
31541 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775
31542 Michael Kerrisk
31543 Remove mention of ip_local_port_range under EAGAIN error
31544
31545 create_module.2
31546 delete_module.2
31547 init_module.2
31548 query_module.2
31549 Michael Kerrisk [Lucas De Marchi]
31550 Clarify glibc header file declaration/ABI wrapper details
31551 create_module(), delete_module(), init_module(), and
31552 query_module() are not declared in header files, but
31553 through an accident of history glibc provides an ABI
31554 for them that it continues to maintain, for
31555 compatibility reasons.
31556
31557 execve.2
31558 Michael Kerrisk [Steven Stewart-Gallus]
31559 Note SIGKILL case when execve() fails beyond the point of no return
31560 Michael Kerrisk
31561 NOTES: Add a subheading and reorder paragraphs
31562
31563 fanotify_init.2
31564 Heinrich Schuchardt [Michael Kerrisk]
31565 Document range of permitted flags for event_f_flags
31566 With a new patch included in the mm tree, event_f_flags is
31567 checked for allowable values.
31568
31569 fcntl.2
31570 Michael Kerrisk
31571 Add "file locking" subheading under NOTES
31572
31573 fork.2
31574 Michael Kerrisk
31575 ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
31576 SCHED_DEADLINE tasks can fail with EAGAIN unless the
31577 reset-on-fork flag is set.
31578
31579 futex.2
31580 Michael Kerrisk
31581 Note that there is no glibc wrapper
31582
31583 getpriority.2
31584 Rasmus Villemoes
31585 Fix prototypes for getpriority() and setpriority()
31586 The who argument has type id_t (which happens to be u32 on linux).
31587
31588 get_robust_list.2
31589 Rasmus Villemoes
31590 Add <sys/types.h> to synopsis of get_robust_list()
31591 If one were to implement wrappers for [gs]et_robust_list() using the
31592 given prototypes, one would also have to include sys/types.h to get
31593 a definition of size_t.
31594
31595 getrusage.2
31596 Michael Kerrisk [Bill Allombert]
31597 _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition
31598 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569
31599
31600 link.2
31601 open.2
31602 Andy Lutomirski [Michael Kerrisk]
31603 Update AT_EMPTY_PATH and O_PATH documentation
31604
31605 listen.2
31606 Michael Kerrisk
31607 ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31608
31609 mbind.2
31610 Rasmus Villemoes
31611 Fix prototype for mbind(2)
31612 The nmask argument is const. The return type in numaif.h is long.
31613 (Well, at least <numaif.h> says nmask is const. The current kernel
31614 does not define it as a const argument, but sys_mbind() only
31615 passes it to get_nodes(), which does treat it as const.)
31616
31617 msgop.2
31618 Davidlohr Bueso [Michael Kerrisk]
31619 Enhance description of "full queue" criteria
31620
31621 poll.2
31622 Rasmus Villemoes
31623 Add <signal.h> to synopsis for ppoll()
31624 One needs to #include <signal.h> to get the definition of the
31625 type (sigset_t) of the mask argument to ppoll().
31626
31627 readlink.2
31628 Rasmus Villemoes
31629 Fix return type of readlinkat()
31630
31631 recv.2
31632 Michael Kerrisk
31633 Clarify details of msg_name and msg_namelen fields
31634
31635 recvmmsg.2
31636 Michael Kerrisk
31637 Describe timeout bug
31638 See https://bugzilla.kernel.org/show_bug.cgi?id=75371
31639 and http://thread.gmane.org/gmane.linux.man/5677
31640
31641 remap_file_pages.2
31642 Andy Lutomirski [Christoph Hellwig, Andy Lutomirski]
31643 remap_file_pages() has no benefit for real files
31644 Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused
31645 remap_file_pages to be emulated when used on real file.
31646
31647 sched_get_priority_max.2
31648 Michael Kerrisk
31649 'policy' can also be SCHED_DEADLINE
31650
31651 sched_setaffinity.2
31652 Rasmus Villemoes
31653 Fix prototype for sched_setaffinity()
31654 The mask argument is const.
31655
31656 sched_setparam.2
31657 Michael Kerrisk
31658 ERRORS: mark errors that apply just for sched_setparam()
31659 Michael Kerrisk
31660 ERRORS: Add EINVAL for invalid arguments
31661 Michael Kerrisk
31662 SEE ALSO: add sched_setattr(2)
31663
31664 sched_setscheduler.2
31665 Michael Kerrisk
31666 ERRORS: mark errors that apply just to sched_setscheduler()
31667 Michael Kerrisk
31668 ERRORS: add EINVAL case for pid < 0
31669 Michael Kerrisk
31670 ERRORS: separate out EINVAL cases
31671
31672 semget.2
31673 Michael Kerrisk
31674 NOTES: Add subheadings and reorder paragraphs
31675
31676 semop.2
31677 Rasmus Villemoes
31678 Fix prototypes for semop() and semtimedop()
31679 The nsops arguments have type size_t, not unsigned, and the
31680 timeout argument of semtimedop() is const.
31681 Michael Kerrisk
31682 NOTES: Add a subheading
31683
31684 send.2
31685 Michael Kerrisk
31686 Add details on various 'msghdr' fields
31687 Michael Kerrisk
31688 ERRORS: Add EAGAIN for ephemeral port range exhaustion
31689 Michael Kerrisk
31690 Add some subheadings under DESCRIPTION
31691
31692 shmget.2
31693 Michael Kerrisk
31694 NOTES: Add a subheading
31695
31696 stat.2
31697 Michael Kerrisk [Aurelien Jarno]
31698 Describe feature test macro requirements for file type test macros
31699 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240
31700 Michael Kerrisk
31701 Update FTM requirements for lstat()
31702 Michael Kerrisk
31703 Split discussion of 'st_mode' fields into type and permissions
31704 Michael Kerrisk
31705 Move text on S_I*() macros to follow text on S_I* macros
31706 That ordering is more logical
31707
31708 stime.2
31709 Rasmus Villemoes
31710 Fix prototype for stime()
31711 The argument is const, both according to the actual header files and
31712 according to <http://www.sco.com/developers/devspecs/vol1a.pdf>.
31713
31714 syscall.2
31715 Rasmus Villemoes
31716 Fix prototype for syscall()
31717 The first argument and the return value of syscall() has type long,
31718 not int.
31719
31720 getopt.3
31721 Michael Kerrisk
31722 EXAMPLE: Add subheadings to distinguish the two example programs
31723
31724 malloc.3
31725 Michael Kerrisk
31726 Reword text referring to mallopt(3)
31727 Linux libc is no longer "recent"; drop mention of it.
31728
31729 pthread_attr_setinheritsched.3
31730 pthread_attr_setschedparam.3
31731 pthread_attr_setschedpolicy.3
31732 pthread_setaffinity_np.3
31733 pthread_setschedparam.3
31734 pthread_setschedprio.3
31735 pthread_yield.3
31736 pthreads.7
31737 Michael Kerrisk
31738 Change references to "sched_setscheduler(2)" to "sched(7)"
31739 Change consistent with the fact that the scheduling overview
31740 page is now sched(7) not sched_setscheduler(2).
31741
31742 pthread_attr_setstackaddr.3
31743 Peng Haitao
31744 ATTRIBUTES: Note functions that are thread-safe
31745 The functions pthread_attr_setstackaddr() and
31746 pthread_attr_getstackaddr() are thread safe.
31747
31748 pthread_attr_setstacksize.3
31749 Peng Haitao
31750 ATTRIBUTES: Note functions that are thread-safe
31751 The functions pthread_attr_setstacksize() and
31752 pthread_attr_getstacksize() are thread safe.
31753
31754 pthread_kill.3
31755 Peng Haitao
31756 ATTRIBUTES: Note function that is thread-safe
31757 The function pthread_kill() is thread safe.
31758
31759 pthread_kill_other_threads_np.3
31760 Peng Haitao
31761 ATTRIBUTES: Note function that is thread-safe
31762 The function pthread_kill_other_threads_np() is thread safe.
31763
31764 pthread_self.3
31765 Peng Haitao
31766 ATTRIBUTES: Note function that is thread-safe
31767 The function pthread_self() is thread safe.
31768
31769 pthread_setcancelstate.3
31770 Michael Kerrisk
31771 Add paragraph breaks to "Asynchronous cancelability" subsection
31772
31773 pthread_setcancelstate.3
31774 Peng Haitao
31775 ATTRIBUTES: Note functions that are thread-safe
31776 The functions pthread_setcancelstate() and
31777 pthread_setcanceltype() are thread safe.
31778 Michael Kerrisk
31779 NOTES: Add some subheadings
31780
31781 pthread_setschedparam.3
31782 Peng Haitao
31783 ATTRIBUTES: Note functions that are thread-safe
31784 The functions pthread_setschedparam() and pthread_getschedparam()
31785 are thread safe.
31786
31787 pthread_setschedprio.3
31788 Peng Haitao
31789 ATTRIBUTES: Note function that is thread-safe
31790 The function pthread_setschedprio() is thread safe.
31791
31792 pthread_sigmask.3
31793 Peng Haitao
31794 ATTRIBUTES: Note function that is thread-safe
31795 The function pthread_sigmask() is thread safe.
31796
31797 pthread_sigqueue.3
31798 Peng Haitao
31799 ATTRIBUTES: Note function that is thread-safe
31800 The function pthread_sigqueue() is thread safe.
31801
31802 pthread_testcancel.3
31803 Peng Haitao
31804 ATTRIBUTES: Note function that is thread-safe
31805 The function pthread_testcancel() is thread safe.
31806
31807 pthread_yield.3
31808 Peng Haitao
31809 ATTRIBUTES: Note function that is thread-safe
31810 The function pthread_yield() is thread safe.
31811
31812 remquo.3
31813 Peng Haitao
31814 ATTRIBUTES: Note functions that are thread-safe
31815 The functions remquo(), remquof() and remquol() are thread safe.
31816
31817 rtime.3
31818 Peng Haitao
31819 ATTRIBUTES: Note function that is thread-safe
31820 The function rtime() is thread safe.
31821
31822 sched_getcpu.3
31823 Peng Haitao
31824 ATTRIBUTES: Note function that is thread-safe
31825 The function sched_getcpu() is thread safe.
31826
31827 stpcpy.3
31828 Ingo Schwarze
31829 Note some history of stpcpy()
31830 Quoting Ingo:
31831 I just noticed that the stpcpy(3) manual contains a speculation
31832 that appears to be untrue on closer investigation: That function
31833 did not originate in MS DOS, but in Lattice C on AmigaDOS.
31834
31835 Here is a patch against the git master HEAD to fix that, and add
31836 some more historical information. To provide some background and
31837 allow you to more easily verify the correctness of the patch, i'm
31838 appending my mail to <misc@openbsd.org>, where i'm giving some
31839 more details about the history and pointing to some primary
31840 sources. That mail also contains the (similar, but shorter)
31841 patch i just committed to the OpenBSD manual page.
31842
31843 strcasecmp.3
31844 Michael Kerrisk [Aurelien Jarno, Török Edwin]
31845 Explain why strcasecmp()+strncasecmp() are also declared in <string.h>
31846 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436
31847
31848 strcpy.3
31849 Michael Kerrisk
31850 NOTES: Add a subheading
31851
31852 fd.4
31853 Michael Kerrisk [Sam Varshavchik]
31854 Fix floppy disk device names
31855 The naming convention shown in the page was ancient.
31856 Now, the page is consistent with Documentation/devices.txt
31857 (where it is noted that "The use of the capital letters
31858 D, H and E for the 3.5" models have been deprecated, since
31859 the drive type is insignificant for these devices"
31860
31861 proc.5
31862 Michael Kerrisk
31863 Document /proc/timer_stats
31864 Michael Kerrisk
31865 (Briefly) document /proc/timer_list
31866 Michael Kerrisk
31867 Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us}
31868 Reference sched(7) for an explanation of these two files
31869
31870 capabilities.7
31871 Michael Kerrisk
31872 Mention sched_setattr(2) under CAP_SYS_NICE
31873
31874 cpuset.7
31875 Michael Kerrisk
31876 SEE ALSO: add sched(7)
31877
31878 credentials.7
31879 Michael Kerrisk
31880 Mention sched_getattr() as a place where credentials are checked
31881
31882 fanotify.7
31883 Heinrich Schuchardt [Jan Kara]
31884 BUGS: error events can be lost when reading from fanotify FD
31885 Michael Kerrisk [Heinrich Schuchardt]
31886 Fix description of FAN_EVENT_NEXT()
31887 FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a
31888 pointer to the next metadata structure. In addition, generally
31889 rework the description to be a bit clearer and more detailed.
31890 Heinrich Schuchardt
31891 Document FAN_EVENT_METADATA_LEN
31892
31893 ip.7
31894 Michael Kerrisk
31895 Note cases where an ephemeral port is used
31896 Michael Kerrisk
31897 Remove BUGS text on glibc failing to declare in_pktinfo
31898 Michael Kerrisk
31899 Clarify 'ip_local_port_range' and mention the term "ephemeral ports"
31900 Michael Kerrisk
31901 Note some more details about assignment of ephemeral ports
31902 Michael Kerrisk
31903 BUGS: ephemeral port range exhaustion is diagnosed inconsistently
31904 Different system calls use different 'errno' values to diagnose
31905 exhaustion of the ephemeral port range.
31906
31907 sched.7
31908 Michael Kerrisk
31909 Document sched_rt_period_us and sched_rt_runtime_us /proc files
31910 And rework and relocate the text on dealing with runaway
31911 real-time processes.
31912 Michael Kerrisk
31913 Mention sched_setattr(2) in list of APIs that can change policies
31914 Michael Kerrisk
31915 sched_setattr(2) can also be used to set 'nice' value
31916 Michael Kerrisk
31917 Remove mention of sched_setscheduler() when talking about sched_priority
31918 There are nowadays multiple ways to set sched_priority (and
31919 in fact there always were, since we also had sched_setparam(2)).
31920 Michael Kerrisk
31921 SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt
31922 Michael Kerrisk
31923 Don't mention sched_setscheduler(2) in discussions of setting policies
31924 In a couple of places, sched_setscheduler(2) is mentioned as the
31925 way of setting policies. But now there is sched_setattr(2) as
31926 well, rewrite the text in a more generic way.
31927 Michael Kerrisk
31928 Rework summary text describing sched_setattr(2) and sched_getattr(2)
31929 Note that these APIs are a superset of sched_setscheduler(2)
31930 and sched_getscheduler(2).
31931 Michael Kerrisk
31932 Remove crufty text relating to sched_setscheduler()
31933 All of the removed text is in sched_setscheduler(2) and
31934 should have been trimmed from this page.
31935 Michael Kerrisk
31936 SEE ALSO: Mention more files in Documentation/scheduler/ directory
31937
31938
31939 ==================== Changes in man-pages-3.68 ====================
31940
31941 Released: 2014-05-28, Munich
31942
31943
31944 Contributors
31945 ------------
31946
31947 The following people contributed patches/fixes or (noted in brackets
31948 in the changelog below) reports, notes, and ideas that have been
31949 incorporated in changes in this release:
31950
31951 Alastair McKinstry <mckinstry@computer.org>
31952 Carsten Grohmann <carstengrohmann@gmx.de>
31953 Colin Williams <colinwilliams1968@gmail.com>
31954 Heinrich Schuchardt <xypron.glpk@gmx.de>
31955 Lars Wirzenius <liw@iki.fi>
31956 Marko Myllynen <myllynen@redhat.com>
31957 Michael Kerrisk <mtk.manpages@gmail.com>
31958 Peng Haitao <penght@cn.fujitsu.com>
31959 Rasmus Villemoes <rv@rasmusvillemoes.dk>
31960 Richard Braakman <richard.braakman@jollamobile.com>
31961 Simon Paillard <spaillard@debian.org>
31962
31963 Apologies if I missed anyone!
31964
31965
31966 New and rewritten pages
31967 -----------------------
31968
31969 localedef.1
31970 Marko Myllynen, Richard Braakman, Alastair McKinstry, Lars Wirzenius
31971 New page for localedef(1)
31972 Add new page based on Debian localedef(1) page.
31973
31974
31975 New and changed links
31976 ---------------------
31977
31978 procfs.5
31979 New link to proc.5
31980 Since the term "procfs" is widely used, it seems reasonable to have
31981 a link from that name to proc(5).
31982
31983
31984 Changes to individual pages
31985 ---------------------------
31986
31987 locale.1
31988 Marko Myllynen
31989 Provide a step-by-step example of how to use a custom locale
31990 Marko Myllynen
31991 Use LC_TELEPHONE instead of LC_MESSAGES in the example
31992 yesstr/nostr in LC_MESSAGES are planned to be changed at some
31993 point [1], so it's better to provide an example which won't
31994 be obsoleted by that change.
31995
31996 [1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975
31997
31998 adjtimex.2
31999 Michael Kerrisk
32000 Add feature test macro requirements
32001
32002 clone.2
32003 Michael Kerrisk
32004 ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
32005
32006 fork.2
32007 Michael Kerrisk
32008 ERRORS: add pid_max and threads-max to EAGAIN
32009 And rewrite text to be the same as pthread_create(3).
32010
32011 getrlimit.2
32012 Michael Kerrisk
32013 RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
32014
32015 remap_file_pages.2
32016 Rasmus Villemoes
32017 Fix prototype
32018 The pgoff argument has type size_t, not ssize_t (and in the
32019 kernel it is unsigned long).
32020
32021 set_mempolicy.2
32022 Rasmus Villemoes
32023 Fix prototype for set_mempolicy(2)
32024 The nodemask argument is const. The return type in numaif.h is long.
32025
32026 swapon.2
32027 Rasmus Villemoes
32028 Remove header from synopsis
32029 The <asm/page.h> header is not readily available, and the comment
32030 seems to indicate that it is for getting PAGE_SIZE. But it is
32031 never mentioned why one would need to know that, and it is in any
32032 case better obtained using sysconf(), provided by <unistd.h>.
32033
32034 a64l.3
32035 Rasmus Villemoes
32036 Fix prototype for a64l()
32037 The argument is const, both according to POSIX and the
32038 glibc headers.
32039
32040 adjtime.3
32041 Rasmus Villemoes
32042 Add required header
32043 The prototype for adjtime(3) is declared in <sys/time.h>.
32044
32045 argz_add.3
32046 Rasmus Villemoes
32047 Fix prototypes
32048 Update the prototypes of argz_{delete,extract,next} to agree with
32049 glibc headers and manual.
32050
32051 bstring.3
32052 Rasmus Villemoes
32053 Fix prototypes
32054 The length parameter n has type size_t in bcmp(), bcopy() and
32055 bzero().
32056
32057 envz_add.3
32058 Rasmus Villemoes
32059 Fix prototypes
32060 The envz_len parameters for envz_entry() and envz_get() are not
32061 passed by reference.
32062
32063 fpathconf.3
32064 Rasmus Villemoes
32065 Fix prototype
32066 The path argument to pathconf() is const.
32067
32068 fseek.3
32069 Rasmus Villemoes
32070 Fix prototype
32071 The pos argument to fsetpos() is const.
32072
32073 gcvt.3
32074 Rasmus Villemoes
32075 Fix prototype
32076 The ndigit parameter to gcvt() has type int.
32077
32078 getaddrinfo_a.3
32079 Rasmus Villemoes
32080 Fix prototype
32081 The pointer arguments to gai_suspend() are const.
32082
32083 getauxval.3
32084 Rasmus Villemoes
32085 Fix permissions
32086 There doesn't seem to be any reason for getauxval.3 to be
32087 executable...
32088
32089 getnameinfo.3
32090 Rasmus Villemoes
32091 Fix prototype
32092 The hostlen and servlen parameters have type socklen_t.
32093 (The types changed in glibc 2.2)
32094 Michael Kerrisk
32095 Note types of 'hostlen'; and 'servlen' in glibc < 2.2
32096
32097 getrpcent.3
32098 Rasmus Villemoes
32099 Fix prototype
32100 The argument to getrpcbyname() is const.
32101
32102 getrpcport.3
32103 Rasmus Villemoes
32104 Add #include and fix prototype
32105 The prototype for getrpcport() is obtained by #include'ing
32106 <rpc/rpc.h>. Also, update its prototype.
32107
32108 getspnam.3
32109 Rasmus Villemoes
32110 Fix prototype
32111 The struct spwd argument to putspent() is const.
32112
32113 getutent.3
32114 Rasmus Villemoes
32115 Fix prototypes
32116 The arguments to getutid(), getutline(), and pututline()
32117 are const.
32118
32119 inet.3
32120 Rasmus Villemoes
32121 Fix prototype
32122 The parameters to inet_makeaddr have type in_addr_t.
32123
32124 inet_net_pton.3
32125 Rasmus Villemoes
32126 srcfix, cfix
32127 Use a consistent style throughout the man-pages.
32128
32129 key_setsecret.3
32130 Rasmus Villemoes
32131 Fix prototypes
32132 Remove const qualifiers from arguments to key_decryptsession,
32133 key_encryptsession, and key_setsecret.
32134
32135 makecontext.3
32136 Rasmus Villemoes
32137 Fix prototype
32138 The second argument to swapcontext() is const.
32139
32140 makedev.3
32141 Rasmus Villemoes
32142 Fix prototype
32143 gnu_dev_makedev, and hence its trivial macro wrapper makedev, takes
32144 two unsigned int parameters; this is consistent with it being the
32145 inverse of (gnu_dev_)major/minor, which return unsigned int.
32146
32147 malloc_trim.3
32148 Rasmus Villemoes
32149 Fix prototype
32150 As mentioned further down, malloc_trim returns an integer.
32151
32152 mq_getattr.3
32153 Rasmus Villemoes
32154 Fix prototype
32155 The newattr parameter to mq_setattr is const.
32156
32157 newlocale.3
32158 Marko Myllynen
32159 List all available category masks
32160 Michael Kerrisk
32161 Add LC_ALL_MASK description
32162
32163 nl_langinfo.3
32164 Marko Myllynen
32165 Expand the example code a bit
32166 Better illustrate querying elements from different categories.
32167
32168 perror.3
32169 Rasmus Villemoes
32170 Fix declaration
32171 The elements of the array sys_errlist are also const.
32172
32173 pthread_attr_setaffinity_np.3
32174 pthread_attr_setdetachstate.3
32175 pthread_attr_setguardsize.3
32176 pthread_attr_setinheritsched.3
32177 pthread_attr_setschedparam.3
32178 pthread_attr_setschedpolicy.3
32179 pthread_attr_setscope.3
32180 pthread_attr_setstack.3
32181 pthread_attr_setstackaddr.3
32182 pthread_attr_setstacksize.3
32183 Rasmus Villemoes
32184 Constify parameters
32185 Each of the pthread_attr_get* functions extract some piece of
32186 information from a pthread_attr_t, which is passed by const
32187 reference. Add the const keyword to the prototypes of these
32188 functions.
32189
32190 pthread_cleanup_push_defer_np.3
32191 Michael Kerrisk [Rasmus Villemoes]
32192 Add feature test macro requirements
32193
32194 pthread_create.3
32195 Michael Kerrisk [Carsten Grohmann]
32196 Add pid_max limit to EAGAIN error cases
32197
32198 pthread_equal.3
32199 Peng Haitao
32200 ATTRIBUTES: Note function that is thread-safe
32201 The function pthread_equal() is thread safe.
32202
32203 pthread_exit.3
32204 Peng Haitao
32205 ATTRIBUTES: Note function that is thread-safe
32206 The function pthread_exit() is thread safe.
32207
32208 pthread_getcpuclockid.3
32209 Peng Haitao
32210 ATTRIBUTES: Note function that is thread-safe
32211 The function pthread_getcpuclockid() is thread safe.
32212
32213 pthread_setaffinity_np.3
32214 Peng Haitao
32215 ATTRIBUTES: Note functions that are thread-safe
32216 The functions pthread_setaffinity_np() and
32217 pthread_getaffinity_np() are thread safe.
32218
32219 pthread_setconcurrency.3
32220 Peng Haitao
32221 ATTRIBUTES: Note functions that are thread-safe
32222 The functions pthread_setconcurrency() and
32223 pthread_getconcurrency() are thread safe.
32224
32225 pthread_setname_np.3
32226 Rasmus Villemoes
32227 Fix prototype
32228 The name parameter of pthread_getname_np is an output parameter and
32229 hence not const.
32230
32231 pthread_setschedparam.3
32232 Rasmus Villemoes
32233 Fix prototypes
32234 Add return type for pthread_{s,g}etschedparam.
32235
32236 pthread_setschedprio.3
32237 Rasmus Villemoes
32238 Fix prototype
32239 Add return type for pthread_setschedprio.
32240
32241 pthread_sigqueue.3
32242 Rasmus Villemoes
32243 Add missing #include <signal.h>
32244
32245 rcmd.3
32246 Rasmus Villemoes
32247 Fix prototypes
32248 Unlike the BSDs, the second argument of rcmd() and rcmd_af() has
32249 type unsigned short.
32250 The first argument of iruserok_af() has type const void*.
32251
32252 re_comp.3
32253 Rasmus Villemoes
32254 Fix prototypes
32255 re_comp and re_exec take const char* arguments.
32256
32257 resolver.3
32258 Rasmus Villemoes
32259 Fix prototypes and extern-declaration
32260 Fix const- and signedness of various char* parameters.
32261
32262 Also, there is no "struct state", but _res is a struct
32263 __res_state. (Actually, _res is errno-like in that it is really a
32264 macro expanding to (*__res_state()).)
32265
32266 rexec.3
32267 Rasmus Villemoes
32268 Fix prototypes
32269 The user, passwd and cmd arguments to rexec and rexec_af are all
32270 const.
32271
32272 rtime.3
32273 Rasmus Villemoes
32274 Replace header
32275 The header <rpc/des_crypt.h> does not provide rtime();
32276 <rpc/auth_des.h> does, as is also implied in both the NOTES and
32277 EXAMPLE sections.
32278
32279 scandir.3
32280 Rasmus Villemoes
32281 Fix prototypes
32282 The alphasort and versionsort functions take arguments of type
32283 const struct dirent **, not const void *.
32284
32285 setlocale.3
32286 Michael Kerrisk [Marko Myllynen]
32287 Simplify locale category listing and add GNU-specific locale categories
32288 Some information that was here will move to locale(7).
32289 Marko Myllynen
32290 Remove now obsolete NOTES section
32291
32292 setnetgrent.3
32293 Rasmus Villemoes
32294 Fix prototype
32295 The buflen argument to getnetgrent_r has type size_t.
32296
32297 sigvec.3
32298 Rasmus Villemoes
32299 Fix prototype
32300 The vec argument to sigvec is const.
32301
32302 tsearch.3
32303 Rasmus Villemoes
32304 Fix prototype
32305 The rootp argument to tfind is "void * const *",
32306 not "const void **".
32307
32308 core.5
32309 Michael Kerrisk
32310 Core dump files are nowadays core.pid by default
32311
32312 locale.5
32313 Marko Myllynen
32314 Document mon_grouping and grouping properly
32315 Michael Kerrisk
32316 Note default value for 'first_workday'
32317 Michael Kerrisk [Marko Myllynen]
32318 Add brief descriptions of collating-element and collating-symbol
32319 Marko Myllynen
32320 t_fmt_ampm is needed only for locales that employ AM/PM convention
32321 Michael Kerrisk [Marko Myllynen]
32322 Remove crufty reference to /usr/lib/nls/src
32323 That file is nowhere to be found
32324 Marko Myllynen
32325 Clarify LC_TIME/am_pm and LC_NAME keywords usage
32326 am_pm should be defined only if AM/PM convention is used to signal
32327 applications they should not try to print them when using them in
32328 unwanted.
32329
32330 Same for all LC_NAME keywords expect for name_fmt which should be
32331 always defined.
32332 Marko Myllynen
32333 Clarify lang_term / lang_lib
32334 As noted by Keld Simonsen in the lib-locales@sourceware mailing
32335 list:
32336
32337 https://sourceware.org/ml/libc-locales/2014-q2/msg00008.html
32338 From: Keld Simonsen <keld at rap dot rap dot dk>
32339 To: Marko Myllynen <myllynen at redhat dot com>
32340 Date: Tue, 29 Apr 2014 17:02:09 +0200
32341
32342 lang_term reflects ISO 639-2/T (terminology) codes, while
32343 lang_lib reflects ISO 639-2/B (bibliographic) codes.
32344 lang_term is preferred over lang_lib codes for locale names.
32345 There are 20 specific ISO 639-2/B codes.
32346 Marko Myllynen
32347 Correct the FILES section
32348
32349 proc.5
32350 Michael Kerrisk
32351 'pid_max' is a system-wide limit on number of threads and processes
32352 Since PIDs > /proc/sys/kernel/pid_max are not allocated, this
32353 file thus also imposes a system-wide limit on the number of
32354 threads and processes.
32355
32356 capabilities.7
32357 Michael Kerrisk
32358 CAP_SYS_ADMIN allows overriding RLIMIT_NPROC
32359 Michael Kerrisk
32360 CAP_SYS_PTRACE allows process_vm_readv(2) and process_vm_writev(2)
32361
32362 charsets.7
32363 Michael Kerrisk [Marko Myllynen]
32364 Remove crufty statement that Romanian may be switching to ISO 8859-16
32365 Michael Kerrisk
32366 Remove ancient paragraph on charsets supported in glibc 2.3.2
32367 That test is rather ancient, and probably of little use.
32368
32369 fanotify.7
32370 Heinrich Schuchardt
32371 Fix to example program: fanotify read() should use aligned buffer
32372
32373 inotify.7
32374 Heinrich Schuchardt
32375 Add example program
32376 This example of the usage of the inotify API shows the
32377 usage of inotify_init1(2) and inotify_add_watch(2) as well
32378 as polling and reading from the inotify file descriptor.
32379 Heinrich Schuchardt
32380 munmap() does not generate inotify events
32381
32382 locale.7
32383 Marko Myllynen [Michael Kerrisk]
32384 Document the LOCPATH environment variable
32385 Michael Kerrisk
32386 Add further details on various categories
32387
32388
32389
32390 ==================== Changes in man-pages-3.69 ====================
32391
32392 Released: 2014-06-14, Munich
32393
32394
32395 Contributors
32396 ------------
32397
32398 The following people contributed patches/fixes or (noted in brackets
32399 in the changelog below) reports, notes, and ideas that have been
32400 incorporated in changes in this release:
32401
32402 Cyril Hrubis <chrubis@suse.cz>
32403 Jan Chaloupka <jchaloup@redhat.com>
32404 Jeff Layton <jlayton@poochiereds.net>
32405 Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
32406 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
32407 Marko Myllynen <myllynen@redhat.com>
32408 Michael Kerrisk <mtk.manpages@gmail.com>
32409 NeilBrown <neilb@suse.de>
32410 Peng Haitao <penght@cn.fujitsu.com>
32411 Petr Gajdos <pgajdos@suse.cz>
32412 Qian Lei <qianl.fnst@cn.fujitsu.com>
32413 Rasmus Villemoes <rv@rasmusvillemoes.dk>
32414 Vasiliy Kulikov <segoon@openwall.com>
32415 Walter Harms <wharms@bfs.de>
32416 Yuri Kozlov <yuray@komyakino.ru>
32417
32418 Apologies if I missed anyone!
32419
32420
32421 New and rewritten pages
32422 -----------------------
32423
32424 iconv.1
32425 Marko Myllynen [Michael Kerrisk]
32426 New page for the iconv(1) command
32427
32428 iconvconfig.8
32429 Marko Myllynen
32430 New page for iconvconfig(8)
32431
32432
32433 Newly documented interfaces in existing pages
32434 ---------------------------------------------
32435
32436 fcntl.2
32437 Jeff Layton, Michael Kerrisk
32438 Document open file description locks
32439 As provided by the fcntl() operations F_OFD_SETLK,
32440 F_OFD_SETLKW, and F_OFD_GETLK
32441
32442
32443 Changes to individual pages
32444 ---------------------------
32445
32446 locale.1
32447 Marko Myllynen
32448 Add FILES section, add charmap(5) reference
32449 Marko Myllynen
32450 Align with recent charmap(5) / repertoiremap(5) changes
32451
32452 execve.2
32453 Michael Kerrisk [NeilBrown]
32454 Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()
32455 Michael Kerrisk [Vasiliy Kulikov]
32456 RLIMIT_NPROC is checked only if preceded by set*uid()
32457 Michael Kerrisk [Vasiliy Kulikov, NeilBrown, KOSAKI Motohiro]
32458 Document EAGAIN error
32459 See also https://bugzilla.kernel.org/show_bug.cgi?id=42704
32460
32461 fcntl.2
32462 Michael Kerrisk
32463 Detail the limitations of traditional (process-associated) locks
32464 Michael Kerrisk [Jeff Layton]
32465 Describe how to check whether the kernel supports a particular command
32466 Michael Kerrisk
32467 ERRORS: add EINVAL for invalid 'cmd'
32468 Michael Kerrisk
32469 Add para introducing advisory locks and noting existence of OFD locks
32470 Michael Kerrisk [Jeff Layton]
32471 Add notes on F_SETLKW deadlock detection and its limitations
32472 Michael Kerrisk
32473 Add an explicit note that mandatory locking is not in POSIX
32474 Michael Kerrisk
32475 Rewrite introductory paragraphs on mandatory locking
32476 Make the structure more logical, and also explicitly mention
32477 OFD locks.
32478 Michael Kerrisk [Jeff Layton]
32479 Reword discussion of mandatory lock bug a little
32480 Jeff Layton confirmed that the bug remains even in modern kernels.
32481 Michael Kerrisk
32482 Explain POSIX background to EACCES/EAGAIN error for F_GETLK
32483 Michael Kerrisk
32484 Add NOTES subhead for record locking and NFS
32485 Michael Kerrisk [NeilBrown]
32486 Note treatment of locks when an NFS client loses contact with the server
32487 Michael Kerrisk [Jeff Layton]
32488 nfsv4leasetime controls the "contact lost" interval for NFSv4
32489
32490 flock.2
32491 Michael Kerrisk
32492 In some modern BSDs, fcntl() and flock() locks do interact
32493 So, reword and extend the discussion of this topic in NOTES.
32494 Michael Kerrisk
32495 Move NOTES text describing implementation of flock()
32496 Michael Kerrisk [NeilBrown]
32497 Add more details on NFS, including Linux 2.6.37 changes
32498 Also: move NOTES text describing interaction of fcntl()
32499 and flock() locks.
32500
32501 fork.2
32502 Michael Kerrisk
32503 Add notes on inheritance of flock() and OFD locks across fork()
32504
32505 lseek.2
32506 Michael Kerrisk
32507 Add reference to open(2) for discussion of file descriptors and OFDs
32508
32509 open.2
32510 Michael Kerrisk
32511 Rework and extend the discussion of open file descriptions
32512
32513 open_by_handle_at.2
32514 Rasmus Villemoes
32515 Add reference to feature_test_macros(7)
32516
32517 recvmmsg.2
32518 Rasmus Villemoes
32519 Add reference to feature_test_macros(7)
32520
32521 remap_file_pages.2
32522 Michael Kerrisk [Kirill A. Shutemov]
32523 Note that remap_file_pages() is deprecated
32524
32525 sendmmsg.2
32526 Rasmus Villemoes
32527 Add reference to feature_test_macros(7)
32528
32529 seteuid.2
32530 Michael Kerrisk
32531 seteuid() and setegid() are implemented as library functions
32532 Michael Kerrisk
32533 Error checking should always be performed, even when caller is UID 0
32534
32535 setresuid.2
32536 Michael Kerrisk
32537 Document EAGAIN error that can occur after kernel alloc_uid() failure
32538 Michael Kerrisk
32539 Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32540 Michael Kerrisk
32541 Correct the description of the EAGAIN error
32542 Michael Kerrisk
32543 Error checking should always be performed, even when caller is UID 0
32544
32545 setreuid.2
32546 Michael Kerrisk
32547 Document EAGAIN error that can occur after kernel alloc_uid() failure
32548 Michael Kerrisk
32549 Error checking should always be performed, even when caller is UID 0
32550 Michael Kerrisk
32551 Add EAGAIN error for hitting RLIMIT_NPROC limit
32552 Michael Kerrisk
32553 Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32554
32555 setuid.2
32556 Michael Kerrisk
32557 Document EAGAIN error that can occur after kernel alloc_uid() failure
32558 Michael Kerrisk
32559 Correct the description of the EAGAIN error
32560 Michael Kerrisk
32561 Error checking should always be performed, even when caller is UID 0
32562 Michael Kerrisk
32563 Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs
32564
32565 statfs.2
32566 Cyril Hrubis
32567 Update MAGIC constants
32568 Most of the updates are taken from /usr/include/linux/magic.h,
32569 some were found by grepping the Linux source code.
32570 Cyril Hrubis [Michael Kerrisk]
32571 fstatfs(2) was broken on file descriptors from pipe(2)
32572
32573 syscalls.2
32574 Michael Kerrisk
32575 Note that remap_file_pages() is deprecated
32576
32577 basename.3
32578 Peng Haitao
32579 ATTRIBUTES: Note functions that are thread-safe
32580 The functions basename() and dirname() are thread safe.
32581
32582 catgets.3
32583 Peng Haitao
32584 ATTRIBUTES: Note function that is thread-safe
32585 The function catgets() is thread safe.
32586
32587 getdate.3
32588 Rasmus Villemoes
32589 Use blank definition of _GNU_SOURCE in example program
32590
32591 getdirentries.3
32592 Peng Haitao
32593 ATTRIBUTES: Note function that is thread-safe
32594 The function getdirentries() is thread safe.
32595
32596 getdtablesize.3
32597 Peng Haitao
32598 ATTRIBUTES: Note function that is thread-safe
32599 The function getdtablesize() is thread safe.
32600
32601 iconv.3
32602 Qian Lei [Peng Haitao]
32603 ATTRIBUTES: Note function that is thread-safe
32604 The function iconv() is thread safe.
32605 Michael Kerrisk
32606 SEE ALSO: add iconvconfig(8)
32607
32608 lockf.3
32609 Qian Lei [Peng Haitao]
32610 ATTRIBUTES: Note function that is thread-safe
32611 The function lockf() is thread safe.
32612
32613 malloc_get_state.3
32614 Rasmus Villemoes
32615 SYNOPSIS: use correct header
32616 The nonstandard functions malloc_set_state() and
32617 malloc_get_state() are provided by <malloc.h> not <stdlib.h>.
32618
32619 malloc_usable_size.3
32620 Qian Lei
32621 ATTRIBUTES: Note function that is thread-safe
32622 The function malloc_usable_size() is thread safe.
32623
32624 matherr.3
32625 Qian Lei [Peng Haitao]
32626 ATTRIBUTES: Note function that is thread-safe
32627 The function matherr() is thread safe.
32628
32629 mkdtemp.3
32630 Peng Haitao
32631 ATTRIBUTES: Note function that is thread-safe
32632 The function mkdtemp() is thread safe.
32633
32634 mkstemp.3
32635 Peng Haitao
32636 ATTRIBUTES: Note functions that are thread-safe
32637 The functions mkstemp(), mkostemp(), mkstemps() and mkostemps()
32638 are thread safe.
32639
32640 mq_close.3
32641 Qian Lei
32642 ATTRIBUTES: Note function that is thread-safe
32643 The function mq_close() is thread safe.
32644
32645 mq_getattr.3
32646 Qian Lei
32647 ATTRIBUTES: Note function that is thread-safe
32648 The functions mq_getattr() and mq_setattr() are thread safe.
32649
32650 mq_open.3
32651 Peng Haitao
32652 ATTRIBUTES: Note function that is thread-safe
32653 The function mq_open() is thread safe.
32654
32655 mq_receive.3
32656 Peng Haitao
32657 ATTRIBUTES: Note functions that are thread-safe
32658 The functions mq_receive() and mq_timedreceive() are thread safe.
32659
32660 mq_send.3
32661 Peng Haitao
32662 ATTRIBUTES: Note functions that are thread-safe
32663 The functions mq_send() and mq_timedsend() are thread safe.
32664
32665 mq_unlink.3
32666 Qian Lei
32667 ATTRIBUTES: Note function that is thread-safe
32668 The function mq_unlink() is thread safe.
32669
32670 posix_fallocate.3
32671 Peng Haitao
32672 ATTRIBUTES: Note function that is thread-safe
32673 The function posix_fallocate() is thread safe.
32674
32675 posix_openpt.3
32676 Peng Haitao
32677 ATTRIBUTES: Note function that is thread-safe
32678 The function posix_openpt() is thread safe.
32679
32680 siginterrupt.3
32681 Peng Haitao
32682 ATTRIBUTES: Note function that is not thread-safe
32683 The function siginterrupt() is not thread safe.
32684
32685 system.3
32686 Peng Haitao
32687 ATTRIBUTES: Note function that is thread-safe
32688 The function system() is thread safe.
32689
32690 charmap.5
32691 Marko Myllynen
32692 Update to match current glibc
32693 charmap(5) was outdated, bring it to closer to reality by fixing
32694 syntax descriptions to match current glibc code and practices,
32695 adding missing options, removing obsolete comments and references,
32696 and removing now incorrect examples.
32697
32698 locale.5
32699 Marko Myllynen
32700 Clarify AM/PM settings a bit
32701 localedef(1) complains if really undefined, should be empty instead.
32702 Also: add some SEE ALSO references.
32703 Marko Myllynen
32704 Document glibc conventions regarding days and week
32705 Based on existing practice and glibc community wiki page at
32706 https://sourceware.org/glibc/wiki/Locales
32707
32708 proc.5
32709 Michael Kerrisk [Jan Chaloupka, Walter Harms]
32710 Add a brief description of /proc/fs
32711
32712 repertoiremap.5
32713 Marko Myllynen
32714 New page for repertoiremap(5)
32715 Rather obsolete feature but localedef(1) refers to repertoiremaps.
32716
32717 bootparam.7
32718 Petr Gajdos
32719 Describe 'rootflags' and 'rootdelay' kernel parameters
32720 Patch based on text from Documentation/kernel-parameters.txt
32721
32722 charsets.7
32723 Marko Myllynen
32724 Update to reflect past developments
32725 Rewrite the introduction to make Unicode's prominence more obvious.
32726 Reformulate parts of the text to reflect current Unicode world.
32727 Minor clarification for ASCII/ISO sections, some other minor fixes.
32728 Marko Myllynen
32729 List CJK encodings in the order of C, J, K
32730
32731 environ.7
32732 Michael Kerrisk
32733 SEE ALSO: add env(1), printenv(1), ld.so(8)
32734
32735 locale.7
32736 Marko Myllynen
32737 Add some SEE ALSO references
32738
32739 man-pages.7
32740 Michael Kerrisk
32741 Note that .TH 'date' field is nowadays automatically updated by scripts
32742
32743 signal.7
32744 Michael Kerrisk
32745 Describe EINTR semantics for recvmmsg(2)
32746 Michael Kerrisk
32747 Clarify text describing EINTR semantics for socket interfaces
32748
32749 unicode.7
32750 Marko Myllynen
32751 Update to reflect past developments
32752 The unicode(7) page will look more modern with few small changes:
32753
32754 - drop old BUGS section, editors cope with UTF-8 ok these days,
32755 and perhaps the state-of-the-art is better described elsewhere
32756 anyway than in a man page
32757 - drop old suggestion about avoiding combined characters
32758 - refer to LANANA for Linux zone, add registry file reference
32759 - drop a reference to an inactive/dead mailing list
32760 - update some reference URLs
32761
32762 utf-8.7
32763 Marko Myllynen
32764 Drop an old comment about UTF-8 replacing ISO 8859
32765 And add locale(1) under SEE ALSO.
32766
32767
32768 ==================== Changes in man-pages-3.70 ====================
32769
32770 Released: 2014-07-08, Munich
32771
32772
32773 Contributors
32774 ------------
32775
32776 The following people contributed patches/fixes or (noted in brackets
32777 in the changelog below) reports, notes, and ideas that have been
32778 incorporated in changes in this release:
32779
32780 Carlos O'Donell <carlos@redhat.com>
32781 Elie De Brauwer <eliedebrauwer@gmail.com>
32782 Florian Weimer <fweimer@redhat.com>
32783 Heinrich Schuchardt <xypron.glpk@gmx.de>
32784 Marko Myllynen <myllynen@redhat.com>
32785 Michael Kerrisk <mtk.manpages@gmail.com>
32786 Nadav Har'El <nyh@math.technion.ac.il>
32787 NeilBrown <neilb@suse.de>
32788 Rich Felker <dalias@libc.org>
32789 Robert P. J. Day <rpjday@crashcourse.ca>
32790 Simon Paillard <spaillard@debian.org>
32791 Tomi Salminen <tlsalmin@gmail.com>
32792 Walter Harms <wharms@bfs.de>
32793 Yuri Kozlov <yuray@komyakino.ru>
32794 Кирилл <kirillnow@gmail.com>
32795
32796 Apologies if I missed anyone!
32797
32798
32799 New and rewritten pages
32800 -----------------------
32801
32802 sprof.1
32803 Michael Kerrisk [Marko Myllynen]
32804 New page for the glibc sprof(1) command
32805
32806
32807 Newly documented interfaces in existing pages
32808 ---------------------------------------------
32809
32810 epoll_ctl.2
32811 NeilBrown
32812 Document EPOLLWAKEUP
32813
32814 epoll.7
32815 NeilBrown
32816 Document EPOLLWAKEUP
32817
32818
32819 Changes to individual pages
32820 ---------------------------
32821
32822 iconv.1
32823 iconvconfig.8
32824 Marko Myllynen
32825 Clarify gconv file terminology a bit
32826
32827 ldd.1
32828 Michael Kerrisk
32829 SEE ALSO: add sprof(1)
32830
32831 connect.2
32832 Michael Kerrisk
32833 ERRORS: add EPROTOTYPE
32834 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
32835
32836 dup.2
32837 Michael Kerrisk [Rich Felker]
32838 Fix erroneous discussion regarding closing 'newfd' before calling dup2()
32839 And propose a workaround if the caller cares about catching
32840 close() time errors.
32841
32842 See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
32843 and http://austingroupbugs.net/view.php?id=411
32844 Michael Kerrisk
32845 Rework and enhance discussion of dup2()
32846 In particular, note that dup2() performs the steps of closing
32847 and reusing 'newfd' atomically.
32848 Michael Kerrisk
32849 Add subhead for dup3()
32850
32851 epoll_ctl.2
32852 Michael Kerrisk
32853 BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND
32854 If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
32855 is silently ignored.
32856
32857 fcntl.2
32858 Michael Kerrisk [Tomi Salminen]
32859 The return value for F_SETPIPE_SZ is the pipe capacity
32860 Michael Kerrisk
32861 ERRORS: Document ENOTDIR error for F_NOTIFY
32862 Michael Kerrisk
32863 Use proper page cross-references in F_NOTIFY discussion
32864 Michael Kerrisk
32865 Suggest the use of real-time signals with F_NOTIFY
32866
32867 getitimer.2
32868 Michael Kerrisk
32869 Rewrite a few pieces to clarify some details
32870
32871 inotify_add_watch.2
32872 Michael Kerrisk
32873 Clarify that the target of a watch is an i-node
32874 The target of a watch is an i-node, not a pathname. Clarify
32875 the text to prevent the reader possibly misunderstanding
32876 that establishing watches by two different links to the same
32877 file might create different watch descriptors.
32878
32879 open.2
32880 Michael Kerrisk [Кирилл]
32881 O_CLOEXEC is also one the flags not ignored when O_PATH is specified
32882
32883 pipe.2
32884 Elie De Brauwer
32885 PIPE_BUF is defined in limits.h
32886 To make use of PIPE_BUF in an application one should include
32887 <limits.h>. Adding a reference to this inclusion.
32888
32889 poll.2
32890 Michael Kerrisk [Nadav Har'El]
32891 The negate-fd-to-ignore technique does not work for file descriptor 0
32892 See https://bugzilla.kernel.org/show_bug.cgi?id=79411
32893
32894 set_tid_address.2
32895 Michael Kerrisk [Rich Felker]
32896 Use "thread" rather than "process" in DESCRIPTION
32897 Michael Kerrisk
32898 SEE ALSO: add gettid(2)
32899
32900 shmop.2
32901 Michael Kerrisk
32902 Explain SHMLBA in much more detail
32903
32904 splice.2
32905 Michael Kerrisk
32906 Document EAGAIN error
32907 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32908
32909 syscalls.2
32910 Carlos O'Donell
32911 Add prlimit64(2)
32912 While trying to reconcile the new features in glibc with the
32913 documented entries in the linux kernel man pages I noticed that
32914 glibc exports prlimit64 for use by 32-bit applications (as does
32915 the linux kernel), but that prlimit64 was not defined in the
32916 syscalls list or in the prlimit-related page.
32917
32918 This is not the complete fix for this, but I don't have the time
32919 to explain why and when prlimit64 should be used (or how it should
32920 be used safely). Therefore I'm just patching the syscalls.2 list
32921 to show that prlimit64 exists and was added in 2.6.36 (verified
32922 with git by checking out the tags before and after).
32923
32924 syslog.2
32925 Michael Kerrisk
32926 Rework introductory paragraph
32927 Michael Kerrisk [Robert P. J. Day]
32928 Rework text describing loglevels
32929 The kernel header file mentioned in the discussion of the KERN_*
32930 constants has morphed and is no longer exported inside glibc.
32931 And the definitions of the constants themselves changed subtly
32932 with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
32933 So, rewrite the description of the constants to be a bit more
32934 abstract.
32935 Michael Kerrisk
32936 Rewrite parts of the page, and import /proc/sys/kernel/printk
32937 * Move /proc/sys/kernel/printk from proc(5) to this page,
32938 and correct various details in the discussion of that file.
32939 * Rewrite and correct various other details on the page.
32940 * Clean out some crufty text.
32941 * Miscellaneous minor fixes.
32942 Michael Kerrisk
32943 Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description
32944 Details changed in Linux 2.6.32
32945
32946 tee.2
32947 Michael Kerrisk
32948 Document EAGAIN error
32949 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32950
32951 vmsplice.2
32952 Michael Kerrisk
32953 Document EAGAIN error
32954 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32955
32956 ether_aton.3
32957 Michael Kerrisk
32958 Make description of ether_line() bug a little more informative
32959
32960 mallopt.3
32961 Michael Kerrisk [Florian Weimer]
32962 MALLOC_MMAP_THRESHOLD_ and MALLOC_MMAP_MAX_ *do* work in setgid programs
32963 My testing on this point was bogus, overlooking details of
32964 strace(1)'s behavior with setuid programs.
32965
32966 See https://sourceware.org/bugzilla/show_bug.cgi?id=12155
32967
32968 printf.3
32969 Michael Kerrisk [Rich Felker]
32970 Remove libc4 and libc5 details
32971 Rich Felker noted that "scare text" in the man page warned about
32972 the use of snprintf() on libc, and that some people had cited
32973 this as a reason not to use snprintf(). Linux libc is now
32974 ancient history, so there is no real need to keep that text.
32975 But, while we're at it, we may as well clear out all of the
32976 other ancient libc4 and libc5 pieces in the page. They are
32977 nowadays more clutter than help.
32978 Michael Kerrisk
32979 SUSv3 and later agree with C99 for the snprintf() return value
32980 Determined by inspection of the SUSv3 and SUSv4 specifications.
32981 Michael Kerrisk
32982 Remove some old text about glibc 2.0 changes
32983 We probably don't now need such ancient info.
32984 Michael Kerrisk
32985 Update references to standards for C and S conversion specifiers
32986
32987 profil.3
32988 Michael Kerrisk
32989 SEE ALSO: add sprof(1)
32990
32991 charmap.5
32992 Marko Myllynen
32993 Various minor updates and improvements
32994 - more precise title
32995 - extend description a bit
32996 - document previously omitted WIDTH_DEFAULT
32997 Marko Myllynen
32998 Remove accidental ISO C compliance reference
32999 glibc refers in locale/programs/charmap.c to ISO C 99 section
33000 7.17.(2) and ISO C 99 section 5.2.1.(3) that if a character map
33001 is not ASCII compatible then the locale using it is not ISO C
33002 compliant. This does not state anything about the character set
33003 itself.
33004
33005 proc.5
33006 Michael Kerrisk
33007 Replace /proc/sys/kernel/printk discussion with reference to syslog(2)
33008 It makes more sense to have the /proc/sys/kernel/printk with
33009 the related material in syslog(2).
33010 Michael Kerrisk
33011 Rewrite /proc/sys/kernel/printk description
33012
33013 inotify.7
33014 Michael Kerrisk
33015 Clarify which events are generated for watched directories
33016 Really, with respect to watched directories, events fall into
33017 three classes (not two, as was shown):
33018
33019 * Events that can be generated only for the watched directory.
33020 * Events that can be generated only for objects that are inside
33021 the watched directory.
33022 * Events that can be generated both for the watched directory
33023 and for objects inside the directory.
33024
33025 So, mark these three classes more clearly in the list of inotify
33026 events.
33027 Heinrich Schuchardt [Michael Kerrisk]
33028 BUGS: Note possible bug triggered by watch descriptor reuse
33029 Watch descriptor IDs are returned by inotify_add_watch().
33030 When calling inotify_rm_watch() an IN_IGNORED is placed on the
33031 inotify queue pointing to the ID of the removed watch.
33032
33033 inotify_add_watch() should not return a watch descriptor ID for
33034 which events are still on the queue but should return an
33035 unused ID.
33036
33037 Unfortunately, the existing Kernel code does not provide such a
33038 guarantee.
33039
33040 Actually, in rare cases watch descriptor IDs are returned by
33041 inotify_add_watch() for which events are still on the inotify
33042 queue.
33043
33044 See https://bugzilla.kernel.org/show_bug.cgi?id=77111
33045 Michael Kerrisk
33046 Add further detail to the watch descriptor reuse bug
33047 As well as inotify_rm_watch(), file deletion and unmounting a
33048 filesystem can also cause a watch descriptor to be deleted.
33049 Michael Kerrisk
33050 The watch descriptor reuse bug may be hard to hit in practice
33051 Explain the circumstances in detail, indicating that the
33052 bug may be very unlikely to occur in practice.
33053 Michael Kerrisk
33054 Clarify description of IN_EXCL_UNLINK
33055 Clarify the text a little, in particular making it clearer
33056 that the target of a watch is an i-node (not a pathname).
33057 Michael Kerrisk
33058 Clarify IN_ONESHOT explanation
33059 Make it clearer that the target of monitoring is an i-node,
33060 not a pathname.
33061 Michael Kerrisk
33062 Make comment on 'mask' field more accurate
33063
33064 libc.7
33065 Michael Kerrisk
33066 Clarify man-pages policy on documenting C libraries other than glibc
33067 Michael Kerrisk
33068 Use absolute dates in discussion of libc vs glibc
33069
33070 pipe.7
33071 Elie De Brauwer
33072 Add reference that the pipe capacity can be changed
33073 In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and
33074 /proc/sys/fs/pipe-max-size are defined, however
33075 pipe(7) still defines the pipe capacity as being
33076 a static entity. Adding a reference to fcntl(2).
33077 Michael Kerrisk [Walter Harms]
33078 Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
33079
33080 ld.so.8
33081 Michael Kerrisk
33082 Clarify that LD_PROFILE can specify just a single shared object
33083 Michael Kerrisk
33084 Clarify that LD_PROFILE output is appended to target file
33085 The LD_PROFILE output is appended to any existing
33086 contents of the target file.
33087 Michael Kerrisk
33088 SEE ALSO: add sprof(1)
33089
33090
33091 ==================== Changes in man-pages-3.71 ====================
33092
33093 Released: 2014-08-17, Chicago
33094
33095
33096 Contributors
33097 ------------
33098
33099 The following people contributed patches/fixes or (noted in brackets
33100 in the changelog below) reports, notes, and ideas that have been
33101 incorporated in changes in this release:
33102
33103 Adrian Bunk <bunk@kernel.org>
33104 Damir Nedzibovic <d.nedzibovic@anoxtech.com>
33105 David Prévot <taffit@debian.org>
33106 D. Barbier <bouzim@gmail.com>
33107 Jakub Wilk <jwilk@debian.org>
33108 Jan Chaloupka <jchaloup@redhat.com>
33109 Marko Myllynen <myllynen@redhat.com>
33110 Michael Kerrisk <mtk.manpages@gmail.com>
33111 Mike Frysinger <vapier@gentoo.org>
33112 NeilBrown <neilb@suse.de>
33113 Paul Jackson <pj@usa.net>
33114 Peng Haitao <penght@cn.fujitsu.com>
33115 Rahul Bedarkar <rahulbedarkar89@gmail.com>
33116 Rob Landley <rob@landley.net>
33117 Ryan Hammonds <rhammonds@unicoi.com>
33118 Simon Paillard <spaillard@debian.org>
33119 Ville Ylenius <ville@ylenius.net>
33120 Vince Weaver <vincent.weaver@maine.edu>
33121 Yuri Kozlov <yuray@komyakino.ru>
33122
33123 Apologies if I missed anyone!
33124
33125
33126 New and rewritten pages
33127 -----------------------
33128
33129 group_member.3
33130 Michael Kerrisk
33131 New page documenting group_member(3)
33132
33133 isfdtype.3
33134 Michael Kerrisk
33135 New page documenting isfdtype(3)
33136
33137
33138 Newly documented interfaces in existing pages
33139 ---------------------------------------------
33140
33141 perf_event_open.2
33142 Vince Weaver
33143 Document new comm_exec flag
33144 Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
33145 added support for differentiating between process renames
33146 caused by exec versus those caused by other methods.
33147 Vince Weaver
33148 Document new mmap2 record type
33149 Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
33150 enabled the enhanced mmap2 record support.
33151 The interface was added in Linux 3.12 but disabled until
33152 Linux 3.16.
33153 Vince Weaver
33154 Document PERF_SAMPLE_BRANCH_COND
33155 Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
33156 adds support for gathering PERF_SAMPLE_BRANCH_COND
33157 conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
33158 sampling.
33159
33160 proc.5
33161 Michael Kerrisk
33162 Document /proc/PID/comm
33163 Michael Kerrisk
33164 Document /proc/PID/pagemap
33165 Michael Kerrisk
33166 Document /proc/PID/personality
33167 Michael Kerrisk
33168 Document /proc/PID/syscall
33169 Michael Kerrisk
33170 Document /proc/kpagecount
33171 Michael Kerrisk
33172 Document /proc/kpageflags
33173 Michael Kerrisk
33174 Document /proc/sys/vm/overcommit_kbytes
33175
33176 capabilities.7
33177 Michael Kerrisk
33178 Add CAP_AUDIT_READ
33179 CAP_AUDIT_READ is new in Linux 3.16.
33180
33181
33182 Global changes
33183 --------------
33184
33185 ldd.1
33186 clone.2
33187 execve.2
33188 getpagesize.2
33189 ioperm.2
33190 msgop.2
33191 readv.2
33192 recv.2
33193 select.2
33194 send.2
33195 seteuid.2
33196 shmop.2
33197 signal.2
33198 sync.2
33199 sysinfo.2
33200 utime.2
33201 abs.3
33202 atoi.3
33203 catopen.3
33204 clearenv.3
33205 ctime.3
33206 des_crypt.3
33207 ecvt.3
33208 flockfile.3
33209 fseeko.3
33210 ftime.3
33211 ftok.3
33212 ftw.3
33213 getcwd.3
33214 getdtablesize.3
33215 getline.3
33216 getpass.3
33217 getpass.3
33218 getutent.3
33219 glob.3
33220 insque.3
33221 lseek64.3
33222 memmem.3
33223 mkstemp.3
33224 mktemp.3
33225 on_exit.3
33226 openpty.3
33227 putenv.3
33228 putenv.3
33229 qecvt.3
33230 realpath.3
33231 realpath.3
33232 remove.3
33233 setbuf.3
33234 sigpause.3
33235 strftime.3
33236 strptime.3
33237 tzset.3
33238 xcrypt.3
33239 utmp.5
33240 environ.7
33241 ipv6.7
33242 packet.7
33243 Michael Kerrisk
33244 Remove ancient Linux libc details
33245
33246 access.2
33247 brk.2
33248 chmod.2
33249 eventfd.2
33250 gethostname.2
33251 getpriority.2
33252 mmap.2
33253 poll.2
33254 ptrace.2
33255 readv.2
33256 sched_setaffinity.2
33257 select.2
33258 seteuid.2
33259 signalfd.2
33260 sync_file_range.2
33261 timer_create.2
33262 uname.2
33263 wait.2
33264 Michael Kerrisk
33265 NOTES: add "C library/kernel ABI differences" subheading
33266
33267
33268 Changes to individual pages
33269 ---------------------------
33270
33271 access.2
33272 Michael Kerrisk
33273 Glibc falls back to using access() on kernels that lack faccessat()
33274
33275 bdflush.2
33276 fsync.2
33277 sync.2
33278 proc.5
33279 Adrian Bunk
33280 Change "sync(1)" to "sync(8)"
33281
33282 bind.2
33283 Michael Kerrisk [Ryan Hammonds]
33284 Correct EINVAL error description
33285 As pointed out by Ryan:
33286
33287 My application is trying to bind an IPv4 UDP socket to an
33288 address. I've found that passing an invalid address length
33289 to bind() causes bind to return EINVAL. According to the
33290 bind(2) manpage, this should only occur when using unix
33291 domain sockets (which I am not).
33292
33293 chmod.2
33294 Michael Kerrisk
33295 Glibc falls back to chmod() on kernels that don't support fchmodat()
33296 Michael Kerrisk
33297 Glibc falls back to chown()/lchown() on kernels that lack fchownat()
33298
33299 epoll_wait.2
33300 Michael Kerrisk
33301 NOTES: describe raw epoll_pwait() system call differences
33302
33303 getgroups.2
33304 Michael Kerrisk
33305 SEE ALSO: add group_member(3)
33306
33307 getpriority.2
33308 Michael Kerrisk
33309 Enhance discussion of kernel nice range versus user-space nice range
33310 Michael Kerrisk
33311 Move text describing nice range on other systems
33312
33313 getrlimit.2
33314 Michael Kerrisk
33315 Add cross reference to core(5) in discussion of RLIMIT_CORE
33316 Michael Kerrisk
33317 Describe the "large" resource limit bug on 32-bit platforms
33318 See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
33319 Michael Kerrisk
33320 Glibc's setrlimit() and getrlimit() are implemented using prlimit()
33321
33322 kexec_load.2
33323 Michael Kerrisk
33324 Note limit of 16 for 'nr_segments'
33325 Michael Kerrisk
33326 Clarify the 'flags' bits that contain the architecture
33327 Michael Kerrisk
33328 Add KEXEC_ARCH_68K to list of architectures for 'flags'
33329 Michael Kerrisk
33330 Reword description of 'flags' a little
33331
33332 link.2
33333 Michael Kerrisk
33334 Glibc falls back to link() on kernels that lack linkat()
33335 Unless 'flags' contains AT_SYMLINK_FOLLOW.
33336
33337 mkdir.2
33338 Michael Kerrisk
33339 Glibc falls back to mkdir() on kernels that don't support mkdirat()
33340
33341 perf_event_open.2
33342 Vince Weaver
33343 Clarify PERF_SAMPLE_STACK_USER usage
33344 This clarifies the PERF_SAMPLE_STACK_USER section.
33345 I found these issue while implementing some code that uses
33346 the option. The important change is fixing the name of the
33347 sample_stack_user parameter, the rest is just some wording
33348 fixes and minor clarifications.
33349 Vince Weaver
33350 Clarify PERF_SAMPLE_DATA_SRC usage
33351 When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
33352 you need to shift the masks before doing the compare.
33353
33354 Although the value you are checking (perf_mem_data_src) is
33355 specified as a bitfield so this might all fall apart if trying
33356 to access the field in a cross-endian way. The Power people
33357 were working on this issue, not sure if they resolved it.
33358
33359 poll.2
33360 Michael Kerrisk
33361 Describe fifth argument (sigsetsize) of raw ppoll() system call
33362
33363 process_vm_readv.2
33364 Michael Kerrisk [Ville Ylenius]
33365 Fix typo in example program
33366
33367 readlink.2
33368 Michael Kerrisk
33369 Glibc falls back to readlink() on kernels that lack readlinkat()
33370
33371 recv.2
33372 Michael Kerrisk
33373 'addrlen' should be NULL (not 0) if we don't need sender address
33374
33375 rename.2
33376 Michael Kerrisk
33377 Glibc falls back to rename() when the kernel doesn't have renameat()
33378
33379 sigwaitinfo.2
33380 Michael Kerrisk
33381 The raw sigtimedwait() system call has a fifth argument
33382
33383 symlink.2
33384 Michael Kerrisk
33385 Glibc falls back to symlink() on kernels that lack symlinkat()
33386
33387 sysinfo.2
33388 Michael Kerrisk
33389 Add VERSIONS section
33390
33391 unlink.2
33392 Michael Kerrisk
33393 Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
33394
33395 atoi.3
33396 Michael Kerrisk
33397 Downgrade discussion of atoq()
33398 Remove most references to atoq() in this page, since this function
33399 was present only in Linux libc (not glibc).
33400
33401 cerf.3
33402 cexp2.3
33403 clog2.3
33404 Michael Kerrisk
33405 Update version number on "Not yet in glibc" sentence
33406
33407 fgetgrent.3
33408 getgrent.3
33409 getgrent_r.3
33410 getgrnam.3
33411 Michael Kerrisk [Rob Landley]
33412 Clarify that 'gr_mem' is a NULL-terminated array of pointers
33413
33414 fseeko.3
33415 Michael Kerrisk
33416 Add VERSIONS section
33417
33418 ftw.3
33419 Michael Kerrisk
33420 Add VERSIONS section
33421
33422 getauxval.3
33423 Michael Kerrisk
33424 Document ENOENT error
33425 And add an entry to BUGS explaining the ambiguity that was
33426 present before the addition of this error.
33427
33428 getgrouplist.3
33429 Michael Kerrisk
33430 SEE ALSO: add group_member(3)
33431
33432 getline.3
33433 Rahul Bedarkar
33434 Close opened file at end of example program
33435
33436 memmem.3
33437 Michael Kerrisk
33438 Rewrite text of glibc 2.0 bug
33439
33440 printf.3
33441 Michael Kerrisk [Jakub Wilk]
33442 Clarify details of the %n conversion specifier
33443 See http://bugs.debian.org/756602
33444 Michael Kerrisk [Jakub Wilk]
33445 Note use of 'j', 'z', and 't' length modifiers for '%n'
33446 See http://bugs.debian.org/756602
33447 Michael Kerrisk
33448 Update with some SUSv3 details
33449
33450 setbuf.3
33451 Michael Kerrisk
33452 Remove ancient Linux libc and 4.x BSD details
33453
33454 strstr.3
33455 Michael Kerrisk
33456 Remove discussion of Linux libc bugs
33457 Linux libc is old enough that we needn't care any longer.
33458
33459 strtod.3
33460 Michael Kerrisk
33461 Explain NAN(n-char-sequence)
33462
33463 strtod.3
33464 Michael Kerrisk
33465 SEE ALSO: add nan(3), nanf(3), NANL(3)
33466
33467 updwtmp.3
33468 Michael Kerrisk
33469 Replace AVAILABILITY section with note to link logwtmp() using -lutil
33470 Linux libc details are no longer needed these days.
33471
33472 core.5
33473 Rahul Bedarkar
33474 Close opened file in example program
33475
33476 proc.5
33477 Michael Kerrisk
33478 Fix kernel version numbers for /proc/PID/stat fields
33479
33480 proc.5
33481 Jan Chaloupka
33482 Add missing proc stats fields
33483 Adding missing proc stats fields from
33484 https://www.kernel.org/doc/Documentation/filesystems/proc.txt
33485 Michael Kerrisk [Simon Paillard]
33486 Remove crufty text under 'timer_stats'
33487 Michael Kerrisk
33488 Update /proc/PID/stat 'state' field documentation
33489 Michael Kerrisk
33490 Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
33491 Michael Kerrisk
33492 Refer to getauxval(3) in discussion of /proc/PID/auxv
33493 Michael Kerrisk
33494 Rework formatting of /proc/PID/stat list
33495 Make the field numbers more prominent.
33496 Michael Kerrisk
33497 Note that /proc/PID/cmdline is read-only
33498 Michael Kerrisk
33499 Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
33500 Michael Kerrisk
33501 Improve discussion of /proc/sys/vm/overcommit_ratio
33502
33503 charsets.7
33504 David Prévot [Marko Myllynen]
33505 Tidy up list
33506 Remove German from main list, to be consistent with earlier
33507 removal of Dutch and French (in commit a8ed5f7430e0d1).
33508
33509 inotify.7
33510 Michael Kerrisk
33511 Note that IN_ONLY_DIR can be used to avoid races
33512 Michael Kerrisk
33513 Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
33514 Michael Kerrisk
33515 Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM
33516
33517 man-pages.7
33518 Michael Kerrisk
33519 Add description of "C library/kernel ABI differences" subsection
33520 Michael Kerrisk
33521 Rework text describing sections (stylistic improvements)
33522
33523 vdso.7
33524 Mike Frysinger
33525 Add new i386 vdso symbols in Linux 3.15
33526 Michael Kerrisk
33527 Note kernel version that exports new i386 symbols (Linux 3.15)
33528
33529
33530 ==================== Changes in man-pages-3.72 ====================
33531
33532 Released: 2014-09-07, Mountain View
33533
33534
33535 Contributors
33536 ------------
33537
33538 The following people contributed patches/fixes or (noted in brackets
33539 in the changelog below) reports, notes, and ideas that have been
33540 incorporated in changes in this release:
33541
33542 Christian von Roques <roques@mti.ag>
33543 Holger Hans Peter Freyther <holger@moiji-mobile.com>
33544 Michael Haardt <michael@moria.de>
33545 Michael Kerrisk <mtk.manpages@gmail.com>
33546 Mike Frysinger <vapier@gentoo.org>
33547 Peter Schiffer <pschiffe@redhat.com>
33548 Rusty Russell <rusty@rustcorp.com.au>
33549 Sorin Dumitru <sdumitru@ixiacom.com>
33550
33551 Apologies if I missed anyone!
33552
33553
33554 New and rewritten pages
33555 -----------------------
33556
33557 memusage.1
33558 Peter Schiffer, Michael Kerrisk [Jan Chaloupka]
33559 New page for glibc memusage(1) command
33560
33561 memusagestat.1
33562 Peter Schiffer [Jan Chaloupka, Michael Kerrisk]
33563 New page for glibc memusagestat(1) command
33564
33565 mtrace.1
33566 Peter Schiffer [Jan Chaloupka]
33567 New page describing the glibc mtrace(1) command
33568
33569
33570 Changes to individual pages
33571 ---------------------------
33572
33573 connect.2
33574 Michael Haardt
33575 Note that a new socket should be used if connect() fails
33576
33577 fcntl.2
33578 Michael Kerrisk
33579 One must define _GNU_SOURCE to get the F_OFD_* definitions
33580
33581 poll.2, select.2
33582 Rusty Russell
33583 Fix erroneous description of "available for write".
33584 POSIX says: "POLLOUT Normal data may be written without
33585 blocking.". This "may" is misleading, see the POSIX
33586 write page:
33587
33588 Write requests to a pipe or FIFO shall be handled in the
33589 same way as a regular file with the following exceptions:
33590 ...
33591 If the O_NONBLOCK flag is clear, a write request may cause
33592 the thread to block, but on normal completion it shall
33593 return nbyte.
33594 ...
33595 When attempting to write to a file descriptor (other than a
33596 pipe or FIFO) that supports non-blocking writes and cannot
33597 accept the data immediately:
33598
33599 If the O_NONBLOCK flag is clear, write() shall block the
33600 calling thread until the data can be accepted.
33601
33602 If the O_NONBLOCK flag is set, write() shall not block the
33603 thread. If some data can be written without blocking the
33604 thread, write() shall write what it can and return the
33605 number of bytes written. Otherwise, it shall return -1 and
33606 set errno to [EAGAIN].
33607
33608 The net result is that write() of more than 1 byte on a
33609 socket, pipe or FIFO which is "ready" may block: write()
33610 (unlike read!) will attempt to write the entire buffer and
33611 only return a short write under exceptional circumstances.
33612
33613 Indeed, this is the behaviour we see in Linux:
33614
33615 https://github.com/rustyrussell/ccan/commit/897626152d12d7fd13a8feb36989eb5c8c1f3485
33616 https://plus.google.com/103188246877163594460/posts/BkTGTMHDFgZ
33617
33618 errno.3
33619 Michael Kerrisk
33620 SEE ALSO: add errno(1)
33621
33622 rtnetlink.3
33623 Holger Hans Peter Freyther
33624 Fix parameters for the send() call in the example
33625
33626 inotify.7
33627 Michael Kerrisk
33628 IN_OPEN and IN_CLOSE_NOWRITE can also occur for directories
33629 Michael Kerrisk
33630 IN_CLOSE_WRITE occurs only for files (not monitored directory)
33631 Michael Kerrisk
33632 IN_MODIFY is generated for files only (not monitored directories)
33633 Michael Kerrisk
33634 IN_ACCESS occurs only for files inside directories
33635 IN_ACCESS does not occur for monitored directory.
33636
33637 packet.7
33638 Sorin Dumitru
33639 Fix include file
33640 It looks like most of the socket options from this man pages
33641 are not defined in <netpacket/packet.h>. They are defined in
33642 <linux/if_packet.h> so we should include that one.
33643
33644
33645 ==================== Changes in man-pages-3.73 ====================
33646
33647 Released: 2014-09-21, Munich
33648
33649
33650 Contributors
33651 ------------
33652
33653 The following people contributed patches/fixes or (noted in brackets
33654 in the changelog below) reports, notes, and ideas that have been
33655 incorporated in changes in this release:
33656
33657 David Prévot <taffit@debian.org>
33658 Eric W. Biederman <ebiederm@xmission.com>
33659 J. Bruce Fields <bfields@fieldses.org>
33660 Justin Cormack <justin@street-vision.com>
33661 Lorenzo Beretta <lory.fulgi@infinito.it>
33662 Michael Kerrisk <mtk.manpages@gmail.com>
33663 Rob Landley <rob@landley.net>
33664 Serge E. Hallyn <serge@hallyn.com>
33665 Serge Hallyn <serge.hallyn@ubuntu.com>
33666 Vasily Kulikov <segoon@openwall.com>
33667 Vincent Lefevre <vincent@vinc17.net>
33668 Vitaly Rybnikov <frodox@zoho.com>
33669 Yuri Kozlov <yuray@komyakino.ru>
33670
33671 Apologies if I missed anyone!
33672
33673
33674 New and rewritten pages
33675 -----------------------
33676
33677 namespaces.7
33678 Michael Kerrisk [Eric W. Biederman]
33679 New page providing overview of Linux namespaces
33680
33681 pid_namespaces.7
33682 Michael Kerrisk [Eric W. Biederman, Vasily Kulikov, Rob Landley,
33683 Serge Hallyn]
33684 New page describing PID namespaces
33685
33686 user_namespaces.7
33687 Michael Kerrisk [Eric W. Biederman, Andy Lutomirski, Serge Hallyn]
33688 New page describing user namespaces.
33689
33690
33691 Newly documented interfaces in existing pages
33692 ---------------------------------------------
33693
33694 clone.2
33695 Eric W. Biederman [Michael Kerrisk]
33696 Document CLONE_NEWUSER for creating a new user namespace
33697
33698 setns.2
33699 Eric W. Biederman, Michael Kerrisk
33700 Document the PID, user, and mount namespace support
33701 Document CLONE_NEWPID, CLONE_NEWUSER, and CLONE_NEWNS flags.
33702
33703 unshare.2
33704 Michael Kerrisk [Eric W. Biederman]
33705 Document CLONE_NEWPID
33706 Michael Kerrisk [Eric W. Biederman]
33707 Document CLONE_NEWUSER
33708 Michael Kerrisk
33709 Document CLONE_THREAD, CLONE_SIGHAND, and CLONE_VM
33710
33711
33712 Changes to individual pages
33713 ---------------------------
33714
33715 clone.2
33716 Michael Kerrisk
33717 Move some CLONE_NEWNET text to namespaces.7
33718 Michael Kerrisk
33719 Move some CLONE_NEWUTS text 2 to namespaces.7
33720 Michael Kerrisk
33721 Move some CLONE_NEWIPC text to namespaces.7
33722 Michael Kerrisk
33723 Reword discussion of CLONE_NEWNS, removing text also in namespaces(7)
33724 Michael Kerrisk
33725 Standardize text on CLONE_NEW* flags and CAP_SYS_ADMIN
33726 Michael Kerrisk
33727 EINVAL if (CLONE_NEWUSER|CLONE_NEWPID) && (CLONE_THREAD|CLONE_PARENT)
33728 Michael Kerrisk
33729 Add more detail on the meaning of CLONE_SYSVSEM
33730
33731 flock.2
33732 Michael Kerrisk [J. Bruce Fields]
33733 Don't mention "classical BSD" in discussion of fcntl()/flock interaction
33734 The noninteraction of flock(2) and fcntl(2) locks does
33735 not seem to be classical BSD semantics (at least, checking
33736 the 4.4BSD sources suggest that the lock types do interact,
33737 although there have been other systems also where fcntl()
33738 and flock() locks do not interact). So, fix the text
33739 discussing "classical BSD" lock semantics.
33740
33741 getunwind.2
33742 Michael Kerrisk [Yuri Kozlov]
33743 Fix description of return value
33744 s/size of unwind table/size of the unwind data/
33745
33746 mount.2
33747 Eric W. Biederman
33748 Clarify use of 'mountflags' and 'data' for MS_REMOUNT
33749
33750 reboot.2
33751 Michael Kerrisk [Justin Cormack, Eric W. Biederman]
33752 Document effect of reboot() inside PID namespaces
33753
33754 semop.2
33755 Michael Kerrisk
33756 Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
33757
33758 seteuid.2
33759 setgid.2
33760 setresuid.2
33761 setreuid.2
33762 setuid.2
33763 Michael Kerrisk
33764 EINVAL can occur if UID/GID is not valid in caller's user namespace
33765
33766 setns.2
33767 Michael Kerrisk [Eric W. Biederman]
33768 Clarify capabilities required for reassociating with a mount namespace
33769 Michael Kerrisk
33770 Specify kernel version on each CLONE_NEW* flag
33771 And remove text on flags from VERSIONS.
33772
33773 unshare.2
33774 Michael Kerrisk
33775 Add an example program
33776 Michael Kerrisk
33777 Clarify semantics of CLONE_SYSVSEM
33778 Michael Kerrisk
33779 CLONE_SYSVSEM does not require CAP_SYS_ADMIN
33780 Michael Kerrisk
33781 Note flags implied by CLONE_THREAD and CLONE_VM
33782
33783 clock.3
33784 Michael Kerrisk [Vincent Lefevre]
33785 The implementation uses clock_gettime() was to improve *accuracy*
33786 (The man page text mistakenly used the word "precision".)
33787
33788 drand48.3
33789 Michael Kerrisk [Lorenzo Beretta]
33790 Remove crufty text about SVID 3 marking drand48() obsolete
33791 See http://bugs.debian.org/758293
33792
33793 proc.5
33794 Michael Kerrisk
33795 Move /proc/[pid]/mounts text to namespaces.7
33796 Michael Kerrisk
33797 Move /proc/[pid]/mountstats text to namespaces.7
33798
33799 capabilities.7
33800 Michael Kerrisk
33801 Refer reader to user_namespaces(7) for a discussion of capabilities
33802 Michael Kerrisk
33803 Document CAP_SETUID and CAP_SETGID for user namespace mappings
33804 Michael Kerrisk
33805 setns() needs CAP_SYS_ADMIN in the *target* namespace
33806 Michael Kerrisk
33807 Since Linux 3.8, user namespaces no longer require CAP_SYS_ADMIN
33808
33809 mq_overview.7
33810 Michael Kerrisk
33811 Refer to namespaces(7) for info on POSIX MQs and IPC namespaces
33812
33813 svipc.7
33814 Michael Kerrisk
33815 Refer to namespaces(7) for info on System V IPC and IPC namespaces
33816
33817
33818 ==================== Changes in man-pages-3.74 ====================
33819
33820 Released: 2014-10-03, Munich
33821
33822
33823 Contributors
33824 ------------
33825
33826 The following people contributed patches/fixes or (noted in brackets
33827 in the changelog below) reports, notes, and ideas that have been
33828 incorporated in changes in this release:
33829
33830 Arto Bendiken <arto@bendiken.net>
33831 Ben Hutchings <ben@decadent.org.uk>
33832 Benjamin Herr <ben@0x539.de>
33833 C. Alex North-Keys <erlkonig@talisman.org>
33834 Carlos O'Donell <carlos@redhat.com>
33835 Cyril Hrubis <chrubis@suse.cz>
33836 Davidlohr Bueso <dave@stgolabs.net>
33837 Doug Ledford <dledford@redhat.com>
33838 Elie De Brauwer <eliedebrauwer@gmail.com>
33839 Heinrich Schuchardt <xypron.glpk@gmx.de>
33840 Jonny Grant <jg@jguk.org>
33841 Lanchon <lanchon@gmail.com>
33842 Manfred Spraul <manfred@colorfullife.com>
33843 Marko Myllynen <myllynen@redhat.com>
33844 Michael Kerrisk <mtk.manpages@gmail.com>
33845 Shriramana Sharma <samjnaa@gmail.com>
33846 Thomas Mack <mack@ifis.cs.tu-bs.de>
33847 Wieland Hoffmann <themineo@gmail.com>
33848
33849 Apologies if I missed anyone!
33850
33851
33852 New and rewritten pages
33853 -----------------------
33854
33855 pldd.1
33856 Michael Kerrisk
33857 New page for pldd(1) command added to glibc in version 2.15
33858
33859 cp1252.7
33860 Marko Myllynen
33861 New page documenting CP 1252
33862 CP 1252 is probably one of the most used Windows Code Pages so
33863 let's add a page for it alongside with the already provided
33864 CP 1251 page.
33865
33866 Table generated from /usr/share/i18n/charmaps/CP1252.
33867
33868
33869 Newly documented interfaces in existing pages
33870 ---------------------------------------------
33871
33872 mq_overview.7
33873 Michael Kerrisk
33874 Document /proc/sys/fs/mqueue/msgsize_default
33875 Michael Kerrisk
33876 Document /proc/sys/fs/mqueue/msg_default
33877
33878
33879 Changes to individual pages
33880 ---------------------------
33881
33882 ldd.1
33883 Michael Kerrisk
33884 SEE ALSO: add pldd(1)
33885
33886 execve.2
33887 Michael Kerrisk [C. Alex North-Keys]
33888 Remove unneeded ".sh" extension in interpreter script example
33889 See https://bugzilla.kernel.org/show_bug.cgi?id=84701
33890
33891 fanotify_init.2
33892 Heinrich Schuchardt
33893 BUGS: O_CLOEXEC is ignored
33894 Michael Kerrisk [Heinrich Schuchardt]
33895 The 'event_f_flags' failure to check invalid flags was fixed in 3.15
33896
33897 fanotify_mark.2
33898 Michael Kerrisk
33899 Note that various bugs were fixed in Linux 3.16
33900
33901 getrlimit.2
33902 Michael Kerrisk [Doug Ledford]
33903 Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
33904
33905 open.2
33906 Michael Kerrisk [Shriramana Sharma]
33907 Fix number and formula in description of EOVERFLOW error
33908
33909 readlink.2
33910 Michael Kerrisk [Ben Hutchings]
33911 Fix description of readlinkat() with empty 'pathname'
33912 Michael Kerrisk
33913 SEE ALSO: add realpath(3)
33914
33915 sched_setattr.2
33916 sched_setscheduler.2
33917 Michael Kerrisk
33918 SEE ALSO: add chrt(1)
33919
33920 shmget.2
33921 Manfred Spraul [Michael Kerrisk, Davidlohr Bueso]
33922 Update for increase of SHMALL and SHMMAX
33923 The default values of SHMALL and SHMMAX have been increased.
33924
33925 syscalls.2
33926 Michael Kerrisk
33927 Add 3 new system calls added in Linux 3.17
33928
33929 vmsplice.2
33930 Cyril Hrubis
33931 vmsplice() does not fail when nr_segs==0
33932 This nr_segs==0 case is no-op; the call succeeds and no
33933 EINVAL error is returned.
33934
33935 dlopen.3
33936 Michael Kerrisk
33937 SEE ALSO: add pldd(1)
33938
33939 fseeko.3
33940 Michael Kerrisk [Thomas Mack]
33941 _FILE_OFFSET_BITS must be defined before including any header file
33942
33943 getgrent.3
33944 Carlos O'Donell
33945 Add ENOENT and EAGAIN to error list
33946
33947 mq_getattr.3
33948 Michael Kerrisk
33949 Add an example program
33950 The example program can be used to discover the default
33951 'mq_maxmsg' and 'mq_msgsize' values used to create a queue with
33952 a mq_open(3) call in which 'attr' is NULL.
33953
33954 mq_open.3
33955 Michael Kerrisk
33956 Two /proc files control the defaults for the attrp==NULL case
33957 Refer the reader to the discussion in mq_overview(7) for a
33958 discussion of these files, which exist since Linux 3.5.
33959
33960 realpath.3
33961 Michael Kerrisk
33962 SEE ALSO: add realpath(1)
33963
33964 proc.5
33965 Elie De Brauwer
33966 Document /proc/buddyinfo
33967 This patch adds a short description about the contents of
33968 /proc/buddyinfo and how this file can be used to assist
33969 in checking for memory fragmentation issues.
33970 Michael Kerrisk
33971 Mention pmap(1) in discussion of /proc/PID/smaps
33972
33973 armscii-8.7
33974 Marko Myllynen
33975 Charset pages unification, minor cleanups
33976
33977 ascii.7
33978 Marko Myllynen
33979 Charset pages unification, minor cleanups
33980 This and [the related *.7] patches will provide unification of
33981 charset pages, minor cleanups, and some unifying cosmetic
33982 changes. References are adjusted so that all pages include
33983 a reference to charsets(7), which contains a description of
33984 these sets, stray comments are removed, some obsolete
33985 statements (like ISO 8859-1 being the de-facto ASCII
33986 replacement) are removed, and some minor reformatting
33987 to minimize diff's between the pages are done.
33988
33989 The actual substance, the character tables, remain unchanged.
33990
33991 This series changes the following pages (under man7): ascii,
33992 armscii, cp1251, koi8-r, koi8-u, and all of iso_8859-*.
33993
33994 cp1251.7
33995 Marko Myllynen
33996 Charset pages unification, minor cleanups
33997
33998 iso_8859-10.7
33999 Marko Myllynen
34000 Charset pages unification, minor cleanups
34001
34002 iso_8859-11.7
34003 Marko Myllynen
34004 Charset pages unification, minor cleanups
34005
34006 iso_8859-13.7
34007 Marko Myllynen
34008 Charset pages unification, minor cleanups
34009
34010 iso_8859-14.7
34011 Marko Myllynen
34012 Charset pages unification, minor cleanups
34013
34014 iso_8859-15.7
34015 Marko Myllynen
34016 Charset pages unification, minor cleanups
34017
34018 iso_8859-16.7
34019 Marko Myllynen
34020 Charset pages unification, minor cleanups
34021
34022 iso_8859-1.7
34023 Marko Myllynen
34024 Charset pages unification, minor cleanups
34025
34026 iso_8859-2.7
34027 Marko Myllynen
34028 Charset pages unification, minor cleanups
34029
34030 iso_8859-3.7
34031 Marko Myllynen
34032 Charset pages unification, minor cleanups
34033
34034 iso_8859-4.7
34035 Marko Myllynen
34036 Charset pages unification, minor cleanups
34037
34038 iso_8859-5.7
34039 Marko Myllynen
34040 Charset pages unification, minor cleanups
34041
34042 iso_8859-6.7
34043 Marko Myllynen
34044 Charset pages unification, minor cleanups
34045
34046 iso_8859-7.7
34047 Marko Myllynen
34048 Charset pages unification, minor cleanups
34049
34050 iso_8859-8.7
34051 Marko Myllynen
34052 Charset pages unification, minor cleanups
34053
34054 iso_8859-9.7
34055 Marko Myllynen
34056 Charset pages unification, minor cleanups
34057
34058 koi8-r.7
34059 Marko Myllynen
34060 Charset pages unification, minor cleanups
34061 - remove stray comments, streamline description
34062 (charsets(7) and Wikipedia provide more detailed
34063 and up-to-date description)
34064 - list differences between koi8-r.7 vs koi8-u.7
34065
34066 koi8-u.7
34067 Marko Myllynen
34068 Charset pages unification, minor cleanups
34069 - remove stray comments, streamline description
34070 (charsets(7) and Wikipedia provide more detailed
34071 and up-to-date description)
34072 - list differences between koi8-r.7 vs koi8-u.7
34073
34074 mq_overview.7
34075 Michael Kerrisk
34076 Update queues_max details for Linux 3.14
34077 And in general rework the text a little.
34078 Michael Kerrisk
34079 Update discussion of HARD_MSGMAX
34080 The limit has changed in 2.6.33 and then again in 3.5.
34081 Michael Kerrisk [Arto Bendiken]
34082 Update details for 'queues_max' limit
34083 Things changed in Linux 3.5.
34084 See https://bugs.launchpad.net/bugs/1155695
34085 Michael Kerrisk
34086 Update details on defaults and ceiling for 'msgsize_max' limit
34087 Michael Kerrisk
34088 Rework discussion of HARD_MSGMAX
34089 Michael Kerrisk [Davidlohr Bueso]
34090 Various fixes after review from Davidlohr Bueso
34091
34092 sched.7
34093 Michael Kerrisk
34094 SEE ALSO: add taskset(1)
34095
34096 ld.so.8
34097 Michael Kerrisk
34098 SEE ALSO: add pldd(1)
34099 Michael Kerrisk
34100 SEE ALSO: add dlopen(3)
34101 Michael Kerrisk
34102 SEE ALSO: add ld(1)
34103
34104
34105
34106 ==================== Changes in man-pages-3.75 ====================
34107
34108 Released: 2014-10-15, Düsseldorf
34109
34110
34111 Contributors
34112 ------------
34113
34114 The following people contributed patches/fixes or (noted in brackets
34115 in the changelog below) reports, notes, and ideas that have been
34116 incorporated in changes in this release:
34117
34118 Jonny Grant <jg@jguk.org>
34119 Michael Kerrisk <mtk.manpages@gmail.com>
34120 Robert Schweikert <rjschwei@suse.com>
34121 Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
34122 Walter Harms <wharms@bfs.de>
34123
34124 Apologies if I missed anyone!
34125
34126
34127 New and rewritten pages
34128 -----------------------
34129
34130 pthread_rwlockattr_setkind_np.3
34131 Robert Schweikert [Michael Kerrisk]
34132 New page documenting pthread_rwlockattr_[sg]etkind_np(3)
34133 Documents pthread_rwlockattr_setkind_np(3) and
34134 pthread_rwlockattr_getkind_np(3).
34135
34136
34137 New and changed links
34138 ---------------------
34139
34140 pthread_rwlockattr_getkind_np.3
34141 Robert Schweikert
34142 New link to pthread_rwlockattr_setkind_np(3)
34143
34144
34145 Changes to individual pages
34146 ---------------------------
34147
34148 readlink.2
34149 Michael Kerrisk [Jonny Grant]
34150 Add free() call to example program
34151
34152 readv.2
34153 Michael Kerrisk
34154 The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments
34155
34156 signal.7
34157 Michael Kerrisk
34158 pthread_mutex_lock() and pthread_cond_wait() are restartable
34159 pthread_mutex_lock(, pthread_cond_wait(), and related APIs are
34160 automatically restarted if interrupted by a signal handler.
34161
34162 unix.7
34163 Michael Kerrisk [Carlos O'Donell, David Miller, Tetsuo Handa]
34164 Various additions and rewordings
34165 Notable changes:
34166 * Clarify some details for pathname sockets.
34167 * Add some advice on portably coding with pathname sockets.
34168 * Note the "buggy" behavior for pathname sockets when
34169 the supplied pathname is 108 bytes (after a report by
34170 Tetsuo Handa).
34171
34172
34173 ==================== Changes in man-pages-3.76 ====================
34174
34175 Released: 2014-12-31, Munich
34176
34177
34178 Contributors
34179 ------------
34180
34181 The following people contributed patches/fixes or (noted in brackets
34182 in the changelog below) reports, notes, and ideas that have been
34183 incorporated in changes in this release:
34184
34185 Adam Jiang <jiang.adam@gmail.com>
34186 Andrea Balboni <andrea.balboni@unimore.it>
34187 Andreas Schwab <schwab@suse.de>
34188 Bernhard Walle <bernhard@bwalle.de>
34189 Carlos O'Donell <carlos@redhat.com>
34190 David Wragg <david@wragg.org>
34191 Florian Westphal <fw@strlen.de>
34192 Heinrich Schuchardt <xypron.glpk@gmx.de>
34193 Huxiaoxiang <huxiaoxiang@huawei.com>
34194 Jan Chaloupka <jchaloup@redhat.com>
34195 Jonathan Wakely <jwakely@redhat.com>
34196 Jonny Grant <jg@jguk.org>
34197 Josh Triplett <josh@joshtriplett.org>
34198 Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
34199 Laurent Georget <laurent.georget@supelec.fr>
34200 Manuel López-Ibáñez <lopezibanez@gmail.com>
34201 Marko Myllynen <myllynen@redhat.com>
34202 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
34203 Mel Gorman <mgorman@suse.de>
34204 Michael Gehring <mg@ebfe.org>
34205 Michael Haardt <michael@moria.de>
34206 Michael Kerrisk <mtk.manpages@gmail.com>
34207 Mike Frysinger <vapier@gentoo.org>
34208 Rasmus Villemoes <rv@rasmusvillemoes.dk>
34209 Richard Weinberger <richard@nod.at>
34210 Rich Felker <dalias@libc.org>
34211 Scott Harvey <scott.harvey@stonybrook.edu>
34212 Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
34213 Simon Newton <nomis52@gmail.com>
34214 Simon Paillard <spaillard@debian.org>
34215 Sven Hoexter <sven@stormbind.net>
34216 Tobias Werth <werth@cs.fau.de>
34217 Weijie Yang <weijie.yang.kh@gmail.com>
34218 Will Newton <will.newton@linaro.org>
34219 Yuri Kozlov <yuray@komyakino.ru>
34220 刘湃 <liupai_work@163.com>
34221 尹杰 <writalnaie@gmail.com>
34222
34223 Apologies if I missed anyone!
34224
34225
34226 New and rewritten pages
34227 -----------------------
34228
34229 adjtimex.2
34230 Laurent Georget
34231 Add fields in struct timex description
34232 This patch updates the man page with the new fields added in
34233 struct timex since last edition of the man page.
34234 Laurent Georget [Michael Kerrisk]
34235 Document ADJ_TAI
34236 Michael Kerrisk
34237 Improve description of ADJ_OFFSET_SINGLESHOT
34238 Michael Kerrisk
34239 Add brief documentation of ADJ_MICRO and ADJ_NANO
34240 Michael Kerrisk
34241 Reformat return value list
34242 And remove numeric values, since they're not needed
34243 Michael Kerrisk
34244 Other 'modes' bits are ignored on ADJ_OFFSET_*
34245 Other bits in 'modes' are ignored if modes contains
34246 ADJ_OFFSET_SINGLESHOT or ADJ_OFFSET_SS_READ.
34247 Michael Kerrisk
34248 Add nanosecond details
34249 Fixes https://bugzilla.kernel.org/show_bug.cgi?id=61171.
34250 Michael Kerrisk
34251 Document ADJ_OFFSET_SS_READ
34252 Michael Kerrisk
34253 Reformat 'times' flags as list
34254 And remove numeric values, since they're not needed.
34255 Michael Kerrisk
34256 Note effect of ADJ_NANO for ADJ_SETOFFSET
34257 Michael Kerrisk
34258 Add comment noting that timex structure contains padding bytes
34259 Michael Kerrisk
34260 Add more details to description of 'tai' field
34261 Michael Kerrisk
34262 Note meaning of "PLL" abbreviation
34263 Michael Kerrisk
34264 Clarify which 'timex' field is used by each 'modes' bit
34265 Michael Kerrisk
34266 Document timex 'status' bits
34267 Michael Kerrisk
34268 Clarify treatment of other 'modes' bits for ADJ_OFFSET_*
34269 Michael Kerrisk
34270 Update RFC number: RFC 5905 obsoletes RFC 1305
34271 Michael Kerrisk
34272 Briefly document ADJ_SETOFFSET
34273 Michael Kerrisk
34274 Note PPS (pulse per second) fields in timex structure
34275
34276 sigreturn.2
34277 Michael Kerrisk
34278 Add (a lot) more detail on the signal trampoline
34279 And rewrite much of the page.
34280
34281
34282 Newly documented interfaces in existing pages
34283 ---------------------------------------------
34284
34285 proc.5
34286 Bernhard Walle
34287 Document /proc/thread-self
34288 /proc/thread-self has been introduced in Linux 3.17 with
34289 commit 0097875bd41528922fb3bb5f348c53f17e00e2fd.
34290 Sven Hoexter [Michael Kerrisk, Kamezawa Hiroyuki]
34291 Document "VmSwap" field of /proc/[pid]/status
34292 Florian Westphal
34293 Document /proc/net/netfilter/nfnetlink_queue
34294
34295
34296 Changes to individual pages
34297 ---------------------------
34298
34299 localedef.1
34300 Marko Myllynen
34301 Mention default path for compiled files
34302
34303 clock_nanosleep.2
34304 Michael Kerrisk
34305 Note that 'clock_id' can also be a CPU clock ID
34306
34307 epoll_ctl.2
34308 Michael Kerrisk
34309 Regular files and directories can't be monitored with epoll_ctl()
34310
34311 ioctl.2
34312 Heinrich Schuchardt
34313 Rename 'd' argument to 'fd' in text
34314 In most other manpages file descriptors are called 'fd'.
34315 This patches renames attribute 'd' to 'fd'.
34316
34317 madvise.2
34318 Michael Kerrisk
34319 VERSIONS: Support for madvise() is now configurable
34320 Support for this system call now depends on the
34321 CONFIG_ADVISE_SYSCALLS configuration option.
34322
34323 open.2
34324 Michael Kerrisk
34325 Enhance rationale discussion for openat() and friends
34326
34327 posix_fadvise.2
34328 Mel Gorman
34329 Document the behavior of partial page discard requests
34330 It is not obvious from the interface that "partial page discard"
34331 requests are ignored. It should be spelled out.
34332 Michael Kerrisk [Weijie Yang]
34333 ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case
34334 Michael Kerrisk
34335 Support for fadvise64() is now configurable
34336 Support for this system call now depends on the
34337 CONFIG_ADVISE_SYSCALLS configuration option.
34338
34339 prctl.2
34340 Andreas Schwab
34341 Correct description of null-termination in PR_GET_NAME and PR_SET_NAME
34342 The size of the process name has always been at most 16 byte
34343 _including_ the null terminator. This also means that the
34344 name returned by PR_GET_NAME is always null-terminated.
34345 Michael Kerrisk
34346 PR_SET_NAME silently truncates strings that exceed 16 bytes
34347
34348 restart_syscall.2
34349 Michael Kerrisk
34350 Add some text explaining why restart_syscall() exists
34351
34352 sched_setaffinity.2
34353 Michael Kerrisk
34354 NOTES: Add paragraph on how to discover set of CPUs available on system
34355 Michael Kerrisk
34356 SEE ALSO: add nproc(1) and lscpu(1)
34357
34358 select.2
34359 Michael Kerrisk
34360 SEE ALSO: add restart_syscall(2)
34361
34362 semop.2
34363 Michael Kerrisk
34364 Add note that interrupted semtimedop() returns 'timeout' unchanged
34365 Michael Kerrisk
34366 Remove information about semtimedop() EAGAIN that is repeated elsewhere
34367 Michael Kerrisk
34368 Add subsection head for semtimedop()
34369
34370 setsid.2
34371 Michael Kerrisk
34372 Rewrite some pieces and add some details
34373 Among other changes, add an explanation of why setsid() can't
34374 be called from a process group leader
34375
34376 sgetmask.2
34377 Michael Kerrisk
34378 Since 3.16, support for these system calls is configurable
34379 Support for these calls is now dependent on the setting of the
34380 CONFIG_SGETMASK_SYSCALL option.
34381
34382 sigaction.2
34383 Michael Kerrisk
34384 Document SA_RESTORER
34385 Michael Kerrisk
34386 Add some detail on the sa_restorer field
34387 Michael Kerrisk
34388 SEE ALSO: add sigreturn(2)
34389
34390 splice.2
34391 Michael Kerrisk
34392 Reformat description of 'fd_in' and 'off_in' to improve readability
34393
34394 syscall.2
34395 Michael Kerrisk
34396 SEE ALSO: add errno(3)
34397
34398 syscalls.2
34399 Michael Kerrisk
34400 SEE ALSO: add errno(3)
34401 Michael Kerrisk
34402 3.19 adds execveat()
34403 Michael Kerrisk
34404 Add bpf(2) to list
34405
34406 tee.2
34407 Michael Kerrisk
34408 Add shell session demonstrating use of the example program
34409
34410 tkill.2
34411 Michael Kerrisk [Rich Felker]
34412 Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
34413
34414 abort.3
34415 Michael Kerrisk
34416 Note that SIGABRT is raised as though raise(3) is called
34417 Also note that abort() is POSIX.1-2008 compliant.
34418
34419 cmsg.3
34420 David Wragg
34421 Ensure buf is suitably aligned in sending example
34422 Inspection of the definition of CMSG_FIRSTHDR (both in glibc and
34423 the suggested definition in RFC3542) shows that it yields the
34424 msg_control field. So when sending, the pointer placed in
34425 msg_control should be suitably aligned as a struct cmsghdr.
34426 In the sending example, buf was declared as a bare char array,
34427 and so is not necessarily suitably aligned.
34428
34429 The solution here involves placing buf inside a union, and is
34430 based on the sockets/scm_rights_send.c sample from The Linux
34431 Programming Interface "dist" source code collection.
34432
34433 exp10.3
34434 Michael Kerrisk
34435 Before glibc 2.19, exp() did not give ERANGE error on underflow
34436 http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787
34437
34438 ftw.3
34439 Michael Kerrisk
34440 FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
34441
34442 getopt.3
34443 Michael Kerrisk [Jonny Grant]
34444 Ensure that 'nsecs' is used
34445
34446 ilogb.3
34447 Michael Kerrisk [Will Newton]
34448 Since glibc 2.16, ilogb() does correctly diagnose domain errors
34449
34450 memcmp.3
34451 Michael Haardt
34452 Document return value for n==0 case
34453 Michael Haardt
34454 Warn against use of memcmp() for comparing security-critical data
34455
34456 mq_open.3
34457 Michael Kerrisk
34458 Document the O_CLOEXEC flag
34459 Michael Kerrisk
34460 Place 'flags' constants in alphabetical order
34461
34462 pow.3
34463 Manuel López-Ibáñez
34464 Add note on performance characteristics of pow()
34465
34466 pthread_setschedparam.3
34467 Simon Newton
34468 Fix logic error in example program
34469 The example program will crash if -A is used, since 'attr'
34470 is uninitialized.
34471
34472 $ ./a.out -A
34473 *** Error in `./a.out': free(): invalid pointer: 0xb779c3c4 ***
34474 Aborted (core dumped)
34475 刘湃
34476 Small fixes to example program
34477
34478 sigvec.3
34479 Michael Kerrisk
34480 Starting with version 2.21, glibc no longer exports sigvec()
34481
34482 sysconf.3
34483 Josh Triplett
34484 Document _SC_NGROUPS_MAX
34485 Already documented in getgroups(2), but not in sysconf(3).
34486
34487 termios.3
34488 Michael Kerrisk
34489 SEE ALSO: add tset(1)
34490
34491 tgamma.3
34492 Michael Kerrisk
34493 Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
34494
34495 wordexp.3
34496 Carlos O'Donell
34497 Make it clear that WRDE_NOCMD prevents command substitution
34498 The use of WRDE_NOCMD prevents command substitution. If the flag
34499 WRDE_NOCMD is set then no command substitution shall occur and
34500 the error WRDE_CMDSUB will be returned if such substitution is
34501 requested when processing the words.
34502
34503 The manual page as-is makes it seem like the command substitution
34504 occurs, and an error is returned *after* the substitution.
34505 This patch clarifies that.
34506
34507 locale.5
34508 Marko Myllynen
34509 Describe the formats of values
34510 locale(5) describes what a locale should define but doesn't
34511 spell out how (in what format). The patch attempts to address
34512 this, it also has few trivial additional enhancements.
34513
34514 * Reference to locale(7) for category descriptions.
34515 * Clarify first_workday in NOTES a bit.
34516 * Add upstream BZ reference for two missing LC_ADDRESS fields.
34517 Marko Myllynen
34518 Fix miscoded character
34519
34520 resolv.conf.5
34521 Jan Chaloupka
34522 Add missing no-tld-query option
34523 Based on commit [1], the no-tld-query option exists for
34524 resolv.conf configuration file. Description of this option
34525 is provided in [2]. This patch just copies this option
34526 into resolv.conf.5 man page. Plus changes 'a' member
34527 into 'an' before 'unqualified name as if it ...'
34528 on the third line of [2]. Based on [3], this option
34529 was added in glibc 2.14 as solving [4] bug.
34530
34531 [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
34532 [2] http://www.daemon-systems.org/man/resolv.conf.5.html man page.
34533 [3] https://sourceware.org/git/?p=glibc.git;a=blob;f=NEWS;h=952f32af17e7fb49c4c1a305de673a13075bfaf5;hb=f87dfb1f11c01f2ccdc40d81e134cd06b32e28e8
34534 [4] https://sourceware.org/bugzilla/show_bug.cgi?id=12734
34535
34536 credentials.7
34537 Josh Triplett
34538 Cross-reference getgroups(2)
34539 Since credentials.7 discusses supplementary GIDs, it should
34540 reference getgroups(2).
34541
34542 fanotify.7
34543 Heinrich Schuchardt
34544 Allow relative paths in example
34545 The current example code requires passing an absolute
34546 path to the mount to be watched.
34547
34548 By passing AT_FDCWD to fanotify_mark it can use both
34549 absolute and relative paths.
34550 Heinrich Schuchardt
34551 fallocate(2) creates no events
34552 fallocate(2) should create FAN_MODIFY events but does not.
34553 Heinrich Schuchardt [Michael Kerrisk]
34554 fanotify notifies only events generated on the same mount
34555 Unfortunately, fanotify does not inform listeners for all paths
34556 under which a touched filesystem object is visible, but only the
34557 listener using the same path as the process touching the
34558 filesystem object.
34559 Heinrich Schuchardt
34560 Update BUGS to note bugs still not fixed in 3.17
34561 I bumped the Linux version number in the BUGS section to 3.17.
34562
34563 inotify.7
34564 Heinrich Schuchardt
34565 fallocate(2) does not trigger inotify events
34566 Calling fallocate(2) does not result in inotify events.
34567
34568 locale.7
34569 Marko Myllynen
34570 Improve LOCPATH description
34571 LOCPATH is ignored by privileged programs.
34572
34573 Add locale archive references.
34574
34575 Add FILES section.
34576
34577 man-pages.7
34578 Michael Kerrisk [Laurent Georget]
34579 Clarify that SEE ALSO entries may refer to pages from other projects
34580
34581 signal.7
34582 Michael Kerrisk
34583 Mention other "slow devices"
34584 Reads from eventfd(2), signalfd(2), timerfd(2), inotify(7),
34585 and fanotify(7) file descriptors are also slow operations
34586 that are restartable.
34587 Michael Kerrisk
34588 Fix SO_RECVTIMEO/ SO_SENDTIMEO confusion in text
34589 Michael Kerrisk
34590 Since Linux 3.8, reads on inotify(7) file descriptors are restartable
34591 Michael Kerrisk
34592 inotify(7) reads no longer show the odd EINTR error after SIGCONT
34593 Since kernel 3.7, reads from inotify(7) file descriptors no longer
34594 show the (Linux oddity) behavior of failing with EINTR when the
34595 process resumes after a stop signal + SIGCONT.
34596 Michael Kerrisk
34597 SEE ALSO: add sigreturn(2)
34598
34599 unix.7
34600 Michael Kerrisk [Scott Harvey]
34601 Fix buglet in code snippet in BUGS section
34602
34603 ld.so.8
34604 Carlos O'Donell
34605 Add --inhibit-cache option
34606 The dynamic loader has 6 options, only 5 are documented.
34607 This patch documents the sixth option i.e. `--inhibit-cache`.
34608 Jonathan Wakely [Siddhesh Poyarekar]
34609 Correct documentation of $ORIGIN
34610 As noted by Siddhesh:
34611
34612 The ld.so man page says:
34613
34614 $ORIGIN (or equivalently ${ORIGIN})
34615 This expands to the directory containing the
34616 application executable. Thus, an application located
34617 in somedir/app could be compiled with
34618
34619 This is incorrect since it expands to the directory containing
34620 the DSO and not the application executable. This seems like
34621 deliberate behaviour in dl-object.c, so it needs to be fixed in
34622 the man page.
34623
34624 See http://stackoverflow.com/questions/26280738/what-is-the-equivalent-of-loader-path-for-rpath-specification-on-linux/26281226#26281226
34625
34626
34627
34628 ==================== Changes in man-pages-3.77 ====================
34629
34630 Released: 2015-01-10, Munich
34631
34632
34633 Contributors
34634 ------------
34635
34636 The following people contributed patches/fixes or (noted in brackets
34637 in the changelog below) reports, notes, and ideas that have been
34638 incorporated in changes in this release:
34639
34640 Akihiro Motoki <amotoki@gmail.com>
34641 Alexandre Bique <bique.alexandre@gmail.com>
34642 Andre Majorel <aym-xunil@teaser.fr>
34643 Andy Lutomirski <luto@amacapital.net>
34644 Daniel Borkmann <dborkman@redhat.com>
34645 Dave Hansen <dave.hansen@intel.com>
34646 Elie De Brauwer <eliedebrauwer@gmail.com>
34647 Heinrich Schuchardt <xypron.glpk@gmx.de>
34648 Ignat Loskutov <ignat.loskutov@gmail.com>
34649 Jeff Epler <jepler@unpythonic.net>
34650 Jérôme Pouiller <jezz@sysmic.org>
34651 Kees Cook <keescook@chromium.org>
34652 Laurent Georget <laurent.georget@supelec.fr>
34653 Masanari Iida <standby24x7@gmail.com>
34654 Michael Haardt <michael@moria.de>
34655 Michael Kerrisk <mtk.manpages@gmail.com>
34656 Mike Frysinger <vapier@gentoo.org>
34657 Richard Cochran <richardcochran@gmail.com>
34658 Stephan Mueller <stephan.mueller@atsec.com>
34659 Troy Davis <troy@yort.com>
34660 Vince Weaver <vincent.weaver@maine.edu>
34661 Will Drewry <wad@chromium.org>
34662
34663 Apologies if I missed anyone!
34664
34665
34666 New and rewritten pages
34667 -----------------------
34668
34669 seccomp.2
34670 Kees Cook, Michael Kerrisk, Will Drewry [Andy Lutomirski]
34671 New page documenting seccomp(2)
34672 Combines documentation from prctl, in-kernel seccomp_filter.txt
34673 and dropper.c, along with details specific to the new system call.
34674
34675
34676 Newly documented interfaces in existing pages
34677 ---------------------------------------------
34678
34679 netlink.7
34680 Stephan Mueller [Michael Kerrisk]
34681 Add NETLINK_CRYPTO
34682
34683
34684 Changes to individual pages
34685 ---------------------------
34686
34687 adjtimex.2
34688 Laurent Georget [Richard Cochran, Jeff Epler]
34689 Clarify the 'ppm scaling' used in struct timex
34690 This patch makes explicit and clarifies the unit used for
34691 the fields "freq", "ppsfreq" and "stabil" in struct timex.
34692 Michael Kerrisk [Masanari Iida]
34693 Note that TIME_ERROR is the modern synonym for TIME_BAD
34694
34695 perf_event_open.2
34696 Vince Weaver
34697 Clarify the PERF_FLAG_FD_* flags
34698 This change clarifies the behavior of the PERF_FLAG_FD_OUTPUT and
34699 PERF_FLAG_FD_NO_GROUP flags to perf_event_open(), and removes
34700 the related FIXME comments.
34701
34702 While writing tests to validate the behavior of these flags I
34703 discovered that PERF_FLAG_FD_OUTPUT has been broken since the
34704 2.6.35 kernel release.
34705
34706 prctl.2
34707 Dave Hansen [Michael Kerrisk]
34708 Add description of Intel MPX calls
34709 The 3.19 kernel will have support for Intel MPX, including
34710 a pair of new prctl() calls (PR_MPX_ENABLE_MANAGEMENT and
34711 PR_MPX_DISABLE_MANAGEMENT) for enabling and disabling the
34712 kernel's management of the "bounds tables". Add a
34713 descriptions of the interface.
34714 Michael Kerrisk
34715 Add mention of seccomp(2) under PR_SET_SECCOMP
34716 Michael Kerrisk
34717 Suggest /proc/PID/status "Seccomp" as alternative to PR_GET_SECCOMP
34718 Michael Kerrisk
34719 SIGKILL can also occur PR_GET_SECCOMP in SECCOMP_MODE_FILTER mode
34720 Kees Cook [Andy Lutomirski]
34721 Document SECCOMP_MODE_FILTER vs EFAULT
34722 This notes the distinction made between EINVAL and EFAULT when
34723 attempting to use SECCOMP_MODE_FILTER with PR_SET_SECCOMP.
34724
34725 setns.2
34726 pid_namespaces.7
34727 Mike Frysinger
34728 Elaborate discussion of the PID namespace descendant limitation
34729 The setns(2) man page already mentions that CLONE_NEWPID may only
34730 be used with descendant namespaces, but this nuance could be
34731 listed in a few more places so it is not missed.
34732
34733 shmget.2
34734 Michael Kerrisk [Akihiro Motoki]
34735 Make wording of SHMALL description a little clearer
34736
34737 sigaction.2
34738 Michael Kerrisk
34739 Add siginfo_t fields for SECCOMP_RET_TRAP
34740
34741 memchr.3
34742 strstr.3
34743 Alexandre Bique
34744 Reference memmem(3) in SEE ALSO section
34745
34746 memcmp.3
34747 Michael Kerrisk [Michael Haardt]
34748 NOTES: add some detail on avoiding memcmp() of cryptographic data
34749 Wording largely based on comments from Michael Haardt.
34750
34751 pthread_tryjoin_np.3
34752 Jérôme Pouiller [Michael Kerrisk]
34753 Document EINVAL error for pthread_timedjoin_np()
34754
34755 mem.4
34756 Elie De Brauwer
34757 /dev/kmem depends on CONFIG_DEVKMEM
34758 Elie De Brauwer
34759 Correct /dev/port group in example
34760 mem.4 mentions that group for /dev/port should be set to 'mem'
34761 However, all other files (/dev/mem and /dev/kmem) use the kmem
34762 group in their examples and on my system /dev/port belongs to
34763 kmem. Hence the 'mem' group was probably a typo:
34764 Elie De Brauwer
34765 Add CONFIG_STRICT_DEVMEM
34766 Since 2.6.26 the CONFIG_NONPROMISC_DEVMEM options limits the
34767 physical addresses which can be accessed through /dev/mem.
34768
34769 random.4
34770 Heinrich Schuchardt
34771 Describe handling of O_NONBLOCK
34772 /dev/random and /dev/urandom treat O_NONBLOCK differently.
34773 This should be described in the manpage.
34774 Heinrich Schuchardt
34775 Mention PRNG used by urandom
34776 /dev/urandom uses a pseudo-random number generator to replace
34777 missing entropy.
34778
34779 proc.5
34780 Michael Kerrisk
34781 Document "Seccomp" field of /proc/PID/status
34782
34783 epoll.7
34784 Michael Kerrisk [Ignat Loskutov]
34785 Use epoll_create1() rather than epoll_create() in the code example
34786 epoll_create1() is more or less the preferred API for new
34787 applications, since it allows for some flags and avoids the
34788 misdesigned epoll_create() argument, and so it seems sensible
34789 to use that in the example, rather than epoll_create().
34790
34791 tcp.7
34792 Troy Davis
34793 Clarify tcp_tw_recycle on Internet-facing hosts
34794 Clarify that tcp_tw_recycle will break communication with many
34795 general-purpose remote Internet hosts (namely, remote NAT devices)
34796 even when the Linux device itself is not behind NAT.
34797
34798
34799 ==================== Changes in man-pages-3.78 ====================
34800
34801 Released: 2015-01-22, Munich
34802
34803
34804 Contributors
34805 ------------
34806
34807 The following people contributed patches/fixes or (noted in brackets
34808 in the changelog below) reports, notes, and ideas that have been
34809 incorporated in changes in this release:
34810
34811 Akihiro Motoki <amotoki@gmail.com>
34812 Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
34813 Carlos O'Donell <carlos@redhat.com>
34814 Christian Seiler <christian@iwakd.de>
34815 Daniel J Blueman <daniel@quora.org>
34816 David Drysdale <drysdale@google.com>
34817 David Herrmann <dh.herrmann@gmail.com>
34818 Elie De Brauwer <eliedebrauwer@gmail.com>
34819 Elliot Hughes <enh@google.com>
34820 Jessica McKellar <jessica.mckellar@gmail.com>
34821 Kees Cook <keescook@chromium.org>
34822 Michael Hayes <mike@aiinc.ca>
34823 Michael Kerrisk <mtk.manpages@gmail.com>
34824 Rich Felker <dalias@aerifal.cx>
34825 Vince Weaver <vincent.weaver@maine.edu>
34826
34827 Apologies if I missed anyone!
34828
34829
34830 New and rewritten pages
34831 -----------------------
34832
34833 execveat.2
34834 David Drysdale, Michael Kerrisk [Rich Felker]
34835 New page for execveat(2)
34836
34837 memfd_create.2
34838 Michael Kerrisk, David Herrmann
34839 New page for memfd_create() system call
34840 Including notes about file sealing
34841
34842 s390_pci_mmio_write.2
34843 Alexey Ishchuk
34844 New page for s390 s390_pci_mmio_write() and s390_pci_mmio_read()
34845 New manual page for the new PCI MMIO memory access system
34846 calls, s390_pci_mmio_write() and s390_pci_mmio_read(),
34847 added for the s390 platform.
34848
34849
34850 Newly documented interfaces in existing pages
34851 ---------------------------------------------
34852
34853 fcntl.2
34854 David Herrmann [Michael Kerrisk]
34855 Document F_ADD_SEALS and F_GET_SEALS commands
34856
34857 proc.5
34858 Elie De Brauwer
34859 Document /proc/sys/vm/compact_memory
34860 Michael Kerrisk
34861 Document /proc/sys/fs/nr_open
34862
34863
34864 New and changed links
34865 ---------------------
34866
34867 s390_pci_mmio_read.2
34868 Michael Kerrisk
34869 New link to new s390_pci_mmio_write(2) page
34870
34871
34872 Changes to individual pages
34873 ---------------------------
34874
34875 dup.2
34876 Michael Kerrisk
34877 Add reference to RLIMIT_NOFILE for EMFILE error
34878 Michael Kerrisk
34879 Add reference to RLIMIT_NOFILE for EBADF error on 'newfd'.
34880
34881 execve.2
34882 fexecve.3
34883 Michael Kerrisk
34884 SEE ALSO: add execveat(2)
34885
34886 fallocate.2
34887 mmap.2
34888 open.2
34889 truncate.2
34890 write.2
34891 Michael Kerrisk
34892 ERRORS: add EPERM for operation denied by file seal
34893
34894 fcntl.2
34895 Michael Kerrisk
34896 ERRORS: add EBUSY case for F_SETPIPE_SZ
34897 Michael Kerrisk
34898 Add reference to RLIMIT_NOFILE for F_DUPFD EINVAL error on 'arg'.
34899 Michael Kerrisk
34900 ERRORS: add open file description lock error cases
34901
34902 getrlimit.2
34903 Michael Kerrisk
34904 Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max
34905
34906 mbind.2
34907 Michael Kerrisk [Daniel J Blueman]
34908 Clarify EFAULT text
34909
34910 mmap.2
34911 shmget.2
34912 shm_open.3
34913 Michael Kerrisk
34914 SEE ALSO: add memfd_create(2)
34915
34916 open.2
34917 Michael Kerrisk
34918 Refer to RLIMIT_NOFILE for explanation of EMFILE error
34919 Michael Kerrisk
34920 Add execveat(2) in system call list under "Rationale for openat()"
34921
34922 perf_event_open.2
34923 Vince Weaver
34924 Clarify description of overflow events
34925 Update the perf_event_open manpage to be more consistent when
34926 discussing overflow events. It merges the discussion of
34927 poll-type notifications with those generated by SIGIO
34928 signal handlers.
34929 This addresses the remaining FIXMEs is the document.
34930 Vince Weaver
34931 Remove inaccurate paragraph describing attr.config
34932 Remove an inaccurate paragraph about values in the attr.config
34933 field. This information was never true in any released kernel;
34934 it somehow snuck into the manpage because it is still described
34935 this way in tools/perf/design.txt in the kernel source tree.
34936 Michael Kerrisk
34937 Correct the kernel version number for PERF_COUNT_HW_CACHE_NODE
34938 Michael Kerrisk
34939 Add some kernel version numbers to various fields and constants
34940
34941 ptrace.2
34942 sigaction.2
34943 seccomp.2
34944 Kees Cook
34945 Ptrace and siginfo details
34946 While writing some additional seccomp tests, I realized
34947 PTRACE_EVENT_SECCOMP wasn't documented yet. Fixed this, and added
34948 additional notes related to ptrace events SIGTRAP details.
34949
34950 readv.2
34951 Michael Kerrisk
34952 Update details on glibc readv()/writev() wrapper behavior
34953 And add a historical detail about Linux 2.0.
34954
34955 select.2
34956 Michael Kerrisk
34957 Mention RLIMIT_NOFILE as a possible cause of EINVAL error
34958
34959 syscall.2
34960 Kees Cook
34961 Add arm64 and mips
34962 Add mips and arm64 to tables, along with some further
34963 details on these architectures,
34964
34965 syscalls.2
34966 Michael Kerrisk
34967 Add s390_pci_mmio_read(2) and s390_pci_mmio_write(2)
34968 Michael Kerrisk
34969 Note kernel() version that introduced get_kernel_syms()
34970 Note kernel version that introduced ppc_rtas()
34971 Note kernel version that introduced create_module()
34972 Note kernel version that added setup()
34973 Michael Kerrisk
34974 Remove some details for sync_file_range2()
34975 Make the table a bit simpler. The details can anyway be
34976 found in the system call man page.
34977
34978 utimensat.2
34979 Michael Kerrisk [Elliot Hughes]
34980 If both tv_sec fields are UTIME_OMIT, the file need not exist
34981 As noted by Elliot, if both tv_sec fields are UTIME_OMIT,
34982 utimensat() will return success even if the file does not exist.
34983
34984 errno.3
34985 Michael Kerrisk
34986 The RLIMIT_NOFILE resource limit is a common cause of EMFILE
34987
34988 exec.3
34989 Michael Kerrisk
34990 SEE ALSO: add execveat(2)
34991
34992 fclose.3
34993 Carlos O'Donell
34994 Consistency fix: use "stream" as name for "FILE *" argument
34995 Harmonize all the manual pages to use "stream" for FILE*
34996 instead of randomly using "fp" or "stream." Choosing something
34997 and being consistent helps users scan the man pages quickly
34998 and understand what they are looking at.
34999
35000 fexecve.3
35001 Michael Kerrisk
35002 Rewrite the script+close-on-exec problem as a BUG
35003 Also, add one or two details about this scenario.
35004 Michael Kerrisk
35005 The natural idiom when using fexecve() is to use the close-on-exec flag
35006
35007 fmemopen.3
35008 Michael Kerrisk
35009 Consistency fix: use "stream" as name for "FILE *" argument
35010
35011 fopencookie.3
35012 Michael Kerrisk
35013 Consistency fix: use "stream" as name for "FILE *" argument
35014
35015 getgrent_r.3
35016 Carlos O'Donell
35017 Consistency fix: use "stream" as name for "FILE *" argument
35018
35019 getline.3
35020 Michael Kerrisk
35021 Consistency fix: use "stream" as name for "FILE *" argument
35022
35023 getmntent.3
35024 Carlos O'Donell
35025 Consistency fix: use "stream" as name for "FILE *" argument
35026
35027 getpw.3
35028 Michael Kerrisk [Carlos O'Donell]
35029 Describe return value when 'uid' is not found
35030
35031 getpwent_r.3
35032 Carlos O'Donell
35033 Consistency fix: use "stream" as name for "FILE *" argument
35034
35035 getspnam.3
35036 Carlos O'Donell
35037 Consistency fix: use "stream" as name for "FILE *" argument
35038
35039 malloc_info.3
35040 Carlos O'Donell
35041 Consistency fix: use "stream" as name for "FILE *" argument
35042
35043 posix_fallocate.3
35044 Michael Kerrisk
35045 Note that posix_fallocate() is implemented using fallocate(2)
35046
35047 putgrent.3
35048 Carlos O'Donell
35049 Consistency fix: use "stream" as name for "FILE *" argument
35050 Harmonize all the manual pages to use "stream" for FILE*
35051 instead of randomly using "fp" or "stream." Choosing something
35052 and being consistent helps users scan the man pages quickly
35053 and understand what they are looking at.
35054
35055 locale.5
35056 Akihiro Motoki
35057 Correct variable name
35058
35059 proc.5
35060 Michael Kerrisk
35061 Remove bogus statement about NR_OPEN being a ceiling for file-max
35062
35063
35064 ==================== Changes in man-pages-3.79 ====================
35065
35066 Released: 2015-02-01, Munich
35067
35068
35069 Contributors
35070 ------------
35071
35072 The following people contributed patches/fixes or (noted in brackets
35073 in the changelog below) reports, notes, and ideas that have been
35074 incorporated in changes in this release:
35075
35076 Akihiro Motoki <amotoki@gmail.com>
35077 Heinrich Schuchardt <xypron.glpk@gmx.de>
35078 J William Piggott <elseifthen@gmx.com>
35079 Masanari Iida <standby24x7@gmail.com>
35080 Michael Kerrisk <mtk.manpages@gmail.com>
35081 Scot Doyle <lkml14@scotdoyle.com>
35082 Sergey V. Zubkov <cubbi@cubbi.com>
35083 Stephan Mueller <stephan.mueller@atsec.com>
35084 Vince Weaver <vincent.weaver@maine.edu>
35085 Vivek Goyal <vgoyal@redhat.com>
35086
35087 Apologies if I missed anyone!
35088
35089
35090 New and rewritten pages
35091 -----------------------
35092
35093 getrandom.2
35094 Heinrich Schuchardt, Theodore T'so, Michael Kerrisk
35095 New page documenting getrandom(2)
35096 Kernel 3.17 introduces a new system call getrandom(2).
35097
35098 kexec_load.2
35099 Vivek Goyal, Michael Kerrisk
35100 Add documentation of kexec_file_load(2)
35101 Michael Kerrisk, Vivek Goyal
35102 Rewrite and extend documentation of kexec_load().
35103
35104
35105 New and changed links
35106 ---------------------
35107
35108 kexec_file_load.2
35109 Michael Kerrisk
35110 New link to kexec_load.2
35111
35112 Changes to individual pages
35113 ---------------------------
35114
35115 personality.2
35116 Michael Kerrisk
35117 SEE ALSO: add setarch(8)
35118
35119 prctl.2
35120 Michael Kerrisk
35121 Unused arguments of PR_MPX_(EN,DIS}ABLE_MANAGEMENT must be zero
35122
35123 reboot.2
35124 Michael Kerrisk
35125 SEE ALSO: add kexec_load(2)
35126
35127 socket.2
35128 Stephan Mueller
35129 document AF_ALG
35130 Add a reference to the AF_ALG protocol accessible via socket(2).
35131
35132 fflush.3
35133 Michael Kerrisk [Sergey V. Zubkov]
35134 Clarify that flushing of input streams occurs only for seekable files
35135 See https://bugzilla.kernel.org/show_bug.cgi?id=91931
35136 Michael Kerrisk [Sergey V. Zubkov]
35137 POSIX.1-2008 specifies the behavior when flushing input streams
35138 POSIX.1-2001 did not have a specification for input streams,
35139 but POSIX.1-2008 added one.
35140
35141 getopt.3
35142 Michael Kerrisk
35143 SEE ALSO: add getopt(1)
35144
35145 random.3
35146 Heinrich Schuchardt
35147 SEE ALSO: add getrandom(2)
35148
35149 termios.3
35150 Michael Kerrisk
35151 SEE ALSO: add reset(1), setterm(1), tput(1)
35152
35153 tzset.3
35154 J William Piggott
35155 Document behavior when TZ filespec omits the colon
35156 If the TZ filespec omits the leading colon, glibc will parse
35157 it for any valid format, i.e., it will still work.
35158 J William Piggott
35159 Add description for posixrules file
35160 J William Piggott
35161 Correct system timezone file path
35162 J William Piggott
35163 There are only two TZ formats
35164 tzset(3) currently states that there are three TZ formats. The
35165 first two it lists are actually variations of the POSIX-style
35166 TZ format, of which there are at least five variations.
35167
35168 This patch corrects this to match the POSIX specification of
35169 TZ having only two formats.
35170 J William Piggott
35171 Filespec omitted incorrect
35172 Paragraph three of the DESCRIPTION section says
35173 that when TZ is set, but empty, then UTC is used.
35174
35175 Later it says if the TZ filespec is omitted then the file
35176 /usr/share/zoneinfo/localtime is used. This is incorrect,
35177 it will use UTC in that case as well.
35178 J William Piggott
35179 Fix incorrect TZ string representation
35180 The TZ string representation indicates that the start/end
35181 rules are required; this is incorrect.
35182 J William Piggott
35183 Add ENVIRONMENT section + other rearrangements
35184 FILES section was overly verbose and included
35185 environment variables. Added ENVIRONMENT section,
35186 removing ENV VARS from the FILES section.
35187
35188 random.4
35189 Heinrich Schuchardt
35190 SEE ALSO: add getrandom(2)
35191
35192 passwd.5
35193 Michael Kerrisk
35194 SEE ALSO: add chfn(1), chsh(1)
35195
35196 capabilities.7
35197 Michael Kerrisk
35198 SEE ALSO: add setpriv(1)
35199
35200 signal.7
35201 Michael Kerrisk
35202 Add getrandom(2) to list of restartable system calls
35203 Michael Kerrisk
35204 Add F_OFD_SETLKW to list of restartable operations
35205
35206
35207
35208 ==================== Changes in man-pages-3.80 ====================
35209
35210 Released: 2015-02-21, Munich
35211
35212
35213 Contributors
35214 ------------
35215
35216 The following people contributed patches/fixes or (noted in brackets
35217 in the changelog below) reports, notes, and ideas that have been
35218 incorporated in changes in this release:
35219
35220 Akihiro Motoki <amotoki@gmail.com>
35221 Andy Lutomirski <luto@amacapital.net>
35222 Bill McConnaughey <mcconnau@biochem.wustl.edu>
35223 Chris Mayo <aklhfex@gmail.com>
35224 Christophe Blaess <Christophe@blaess.fr>
35225 David Wilson <dw@botanicus.net>
35226 Denys Vlasenko <dvlasenk@redhat.com>
35227 Doug Goldstein <cardoe@gentoo.org>
35228 Eric Wong <normalperson@yhbt.net>
35229 Heinrich Schuchardt <xypron.glpk@gmx.de>
35230 J William Piggott <elseifthen@gmx.com>
35231 James Hunt <james.hunt@ubuntu.com>
35232 Jan Chaloupka <jchaloup@redhat.com>
35233 Jan Stancek <jstancek@redhat.com>
35234 Jeff Layton <jlayton@poochiereds.net>
35235 Jens Thoms Toerring <jt@toerring.de>
35236 Kevin Easton <kevin@guarana.org>
35237 Luke Faraone <lfaraone@debian.org>
35238 Mark Seaborn <mseaborn@chromium.org>
35239 Mathieu Malaterre <malat@debian.org>
35240 Michael Kerrisk <mtk.manpages@gmail.com>
35241 Michal Hocko <mhocko@suse.cz>
35242 Minchan Kim <minchan@kernel.org>
35243 Patrick Horgan <phorgan1@gmail.com>
35244 Peng Haitao <penght@cn.fujitsu.com>
35245 Ralf Baechle <ralf@linux-mips.org>
35246 Rob Somers <uberkermit@gmail.com>
35247 Simon Paillard <spaillard@debian.org>
35248 Stephen Smalley <sds@tycho.nsa.gov>
35249 Tao Ma <tao.ma@oracle.com>
35250 Tobias Herzke <tobias.linuxpatches.2014@gi2.herzkes.de>
35251 Vince Weaver <vincent.weaver@maine.edu>
35252 Vlastimil Babka <vbabka@suse.cz>
35253 Zbigniew Brzeziński <zbigniew.brzezinski@student.put.poznan.pl>
35254
35255 Apologies if I missed anyone!
35256
35257
35258 New and rewritten pages
35259 -----------------------
35260
35261 ioctl_fat.2
35262 Heinrich Schuchardt [Michael Kerrisk]
35263 New man page for the ioctl(2) FAT API
35264 The ioctl(2) system call may be used to retrieve information about
35265 the FAT file system and to set file attributes.
35266
35267 madvise.2
35268 Michael Kerrisk
35269 Summary: this page has been significantly reorganised and rewritten
35270 Michael Kerrisk
35271 Recast discussion of 'advice' into two groups of values
35272 madvise() is one of those system calls that has congealed over
35273 time, as has the man page. It's helpful to split the discussion
35274 of 'advice' into those flags into two groups:
35275
35276 * Those flags that are (1) widespread across implementations;
35277 (2) have counterparts in posix_madvise(3); and (3) were present
35278 in the initial Linux madvise implementation.
35279 * The rest, which are values that (1) may not have counterparts
35280 in other implementations; (2) have no counterparts in
35281 posix_madvise(3); and (3) were added to Linux in more recent
35282 times.
35283 Michael Kerrisk
35284 Explicitly list the five flags provided by posix_fadvise()
35285 Over time, bit rot has afflicted this page. Since the original
35286 text was written many new Linux-specific flags have been added.
35287 So, now it's better to explicitly list the flags that
35288 correspond to the POSIX analog of madvise().
35289 Jan Chaloupka [Hugh Dickins, Michael Kerrisk]
35290 Starting with Linux 3.5, more file systems support MADV_REMOVE
35291 Michael Kerrisk
35292 Split EINVAL error into separate cases
35293 Michael Kerrisk
35294 Explain MADV_REMOVE in terms of file hole punching
35295 Michael Kerrisk
35296 MADV_REMOVE can be applied only to shared writable mappings
35297 Michael Kerrisk
35298 MADV_REMOVE cannot be applied to locked or Huge TLB pages
35299 Michael Kerrisk [Vlastimil Babka]
35300 Clarify that MADV_DONTNEED has effect on pages only if it succeeds
35301 Michael Kerrisk [Vlastimil Babka]
35302 Clarifications for MADV_DONTNEED
35303 Michael Kerrisk [Michal Hocko]
35304 Improve MADV_DONTNEED description
35305 Michael Kerrisk
35306 MADV_DONTNEED cannot be applied to Huge TLB or locked pages
35307 Michael Kerrisk [Vlastimil Babka]
35308 Remove mention of "shared pages" as a cause of EINVAL for MADV_DONTNEED
35309 Michael Kerrisk [Vlastimil Babka]
35310 Note Huge TLB as a cause of EINVAL for MADV_DONTNEED
35311 Michael Kerrisk [Minchan Kim]
35312 Add mention of VM_PFNMAP in discussion of MADV_DONTNEED and MADV_REMOVE
35313 Michael Kerrisk
35314 Drop sentence saying that kernel may ignore 'advice'
35315 The sentence creates misunderstandings, and does not really
35316 add information.
35317 Michael Kerrisk
35318 Note that some Linux-specific 'advice' change memory-access semantics
35319 Michael Kerrisk
35320 NOTES: Remove crufty text about "command" versus "advice"
35321 The point made in this fairly ancient text is more or less evident
35322 from the DESCRIPTION, and it's not clear what "standard" is being
35323 referred to.
35324 Michael Kerrisk
35325 Mention POSIX.1-2008 addition of POSIX_MADV_NOREUSE
35326 Michael Kerrisk
35327 Remove "POSIX.1b" from CONFORMING TO
35328 Michael Kerrisk
35329 Move mention of posix_fadvise() from CONFORMING TO to SEE ALSO
35330 Michael Kerrisk
35331 ERRORS: add EPERM error case for MADV_HWPOISON
35332 Michael Kerrisk
35333 Note that madvise() is nonstandard, but widespread
35334
35335
35336 Newly documented interfaces in existing pages
35337 ---------------------------------------------
35338
35339 proc.5
35340 Michael Kerrisk
35341 (Briefly) document /proc/PID/attr/socketcreate
35342 Michael Kerrisk
35343 (Briefly) document /proc/PID/attr/keycreate
35344 Michael Kerrisk [Stephen Smalley]
35345 Document /proc/PID/attr/{current,exec,fscreate,prev}
35346 Heavily based on Stephen Smalley's text in
35347 https://lwn.net/Articles/28222/
35348 From: Stephen Smalley <sds@epoch.ncsc.mil>
35349 To: LKML and others
35350 Subject: [RFC][PATCH] Process Attribute API for Security Modules
35351 Date: 08 Apr 2003 16:17:52 -0400
35352 Michael Kerrisk
35353 Document /proc/sys/kernel/auto_msgmni
35354
35355 socket.7
35356 David Wilson [Michael Kerrisk]
35357 Document SO_REUSEPORT socket option
35358
35359
35360 New and changed links
35361 ---------------------
35362
35363 get_thread_area.2
35364 Andy Lutomirski
35365 Make get_thread_area.2 a link to rewritten set_thread_area.2 page
35366
35367
35368 Changes to individual pages
35369 ---------------------------
35370
35371 time.1
35372 Michael Kerrisk
35373 Make option argument formatting consistent with other pages
35374
35375 access.2
35376 Denys Vlasenko
35377 Explain how access() check treats capabilities
35378 We have users who are terribly confused why their binaries
35379 with CAP_DAC_OVERRIDE capability see EACCESS from access() calls,
35380 but are able to read the file.
35381
35382 The reason is access() isn't the "can I read/write/execute this
35383 file?" question, it is the "(assuming that I'm a setuid binary,)
35384 can *the user who invoked me* read/write/execute this file?"
35385 question.
35386
35387 That's why it uses real UIDs as documented, and why it ignores
35388 capabilities when capability-endorsed binaries are run by non-root
35389 (this patch adds this information).
35390
35391 To make users more likely to notice this less-known detail,
35392 the patch expands the explanation with rationale for this logic
35393 into a separate paragraph.
35394
35395 arch_prctl.2
35396 set_thread_area.2
35397 get_thread_area.2
35398 Andy Lutomirski
35399 Improve TLS documentation
35400 The documentation for set_thread_area was very vague. This
35401 improves it, accounts for recent kernel changes, and merges
35402 it with get_thread_area.2.
35403
35404 get_thread_area.2 now becomes a link.
35405
35406 While I'm at it, clarify the related arch_prctl.2 man page.
35407
35408 cacheflush.2
35409 Ralf Baechle
35410 Update some portability details and bugs
35411 Michael Kerrisk
35412 Refer reader to BUGS in discussion of EINVAL error
35413
35414 capget.2
35415 Michael Kerrisk
35416 Document V3 capabilities constants
35417 Michael Kerrisk
35418 Rewrite discussion of kernel versions that support file capabilities
35419 File capabilities ceased to be optional in Linux 2.6.33.
35420
35421 clone.2
35422 Peng Haitao
35423 Fix description of CLONE_PARENT_SETTID
35424 CLONE_PARENT_SETTID only stores child thread ID in parent memory.
35425
35426 clone.2
35427 execve.2
35428 Kevin Easton
35429 Document interaction of execve(2) with CLONE_FILES
35430 This patch the fact that a successful execve(2) in a process that
35431 is sharing a file descriptor table results in unsharing the table.
35432
35433 I discovered this through testing and verified it by source
35434 inspection - there is a call to unshare_files() early in
35435 do_execve_common().
35436
35437 fcntl.2
35438 Michael Kerrisk [Jeff Layton]
35439 Clarify cases of conflict between traditional record and OFD locks
35440 Verified by experiment on Linux 3.15 and 3.19rc4.
35441
35442 fork.2
35443 Michal Hocko
35444 EAGAIN is not reported when task allocation fails
35445 I am not sure why we have:
35446
35447 "EAGAIN fork() cannot allocate sufficient memory to copy
35448 the parent's page tables and allocate a task structure
35449 or the child."
35450
35451 The text seems to be there from the time when man-pages
35452 were moved to git so there is no history for it.
35453
35454 And it doesn't reflect reality: the kernel reports both
35455 dup_task_struct and dup_mm failures as ENOMEM to the
35456 userspace. This seems to be the case from early 2.x times
35457 so let's simply remove this part.
35458 Heinrich Schuchardt
35459 Child and parent run in separate memory spaces
35460 fork.2 should clearly point out that child and parent
35461 process run in separate memory spaces.
35462 Michael Kerrisk
35463 NOTES: add "C library/kernel ABI differences" subheading
35464
35465 getpid.2
35466 Michael Kerrisk
35467 NOTES: add "C library/kernel ABI differences" subheading
35468
35469 getxattr.2
35470 Michael Kerrisk
35471 Various rewordings plus one or two details clarified
35472 Michael Kerrisk
35473 Add pointer to example in listxattr(2)
35474
35475 killpg.2
35476 Michael Kerrisk
35477 NOTES: add "C library/kernel ABI differences" subheading
35478
35479 listxattr.2
35480 Heinrich Schuchardt
35481 Provide example program
35482 Michael Kerrisk
35483 Reword discussion of size==0 case
35484 Michael Kerrisk
35485 Add note on handling increases in sizes of keys or values
35486 Michael Kerrisk
35487 Remove mention of which filesystems implement ACLs
35488 Such a list will only become outdated (as it already was).
35489
35490 migrate_pages.2
35491 Jan Stancek
35492 Document EFAULT and EINVAL errors
35493 I encountered these errors while writing testcase for migrate_pages
35494 syscall for LTP (Linux test project).
35495
35496 I checked stable kernel tree 3.5 to see which paths return these.
35497 Both can be returned from get_nodes(), which is called from:
35498 SYSCALL_DEFINE4(migrate_pages, pid_t, pid, unsigned long, maxnode,
35499 const unsigned long __user *, old_nodes,
35500 const unsigned long __user *, new_nodes)
35501
35502 The testcase does following:
35503 EFAULT
35504 a) old_nodes/new_nodes is area mmaped with PROT_NONE
35505 b) old_nodes/new_nodes is area not mmapped in process address
35506 space, -1 or area that has been just munmmaped
35507
35508 EINVAL
35509 a) maxnodes overflows kernel limit
35510 b) new_nodes contain node, which has no memory or does not exist
35511 or is not returned for get_mempolicy(MPOL_F_MEMS_ALLOWED).
35512
35513 modify_ldt.2
35514 Andy Lutomirski
35515 Overhaul the documentation
35516 This clarifies the behavior and documents all four functions.
35517 Andy Lutomirski
35518 Clarify the lm bit's behavior
35519 The lm bit should never have existed in the first place. Sigh.
35520
35521 mprotect.2
35522 Mark Seaborn
35523 Mention effect of READ_IMPLIES_EXEC personality flag
35524 I puzzled over mprotect()'s effect on /proc/*/maps for a while
35525 yesterday -- it was setting "x" without PROT_EXEC being specified.
35526 Here is a patch to add some explanation.
35527
35528 msgget.2
35529 Michael Kerrisk
35530 Add details of MSGMNI default value
35531
35532 msgop.2
35533 Michael Kerrisk
35534 Clarify wording of MSGMAX and MSGMNB limits
35535
35536 perf_event_open.2
35537 Vince Weaver
35538 Clarify PERF_EVENT_IOC_REFRESH behavior
35539 Currently the PERF_EVENT_IOC_REFRESH ioctl, when applied to a group
35540 leader, will refresh all children. Also if a refresh value of 0
35541 is chosen then the refresh becomes infinite (never runs out).
35542 Back in 2011 PAPI was relying on these behaviors but I was told
35543 that both were unsupported and subject to being removed at any time.
35544 (See https://lkml.org/lkml/2011/5/24/337 )
35545 However the behavior has not been changed.
35546
35547 This patch updates the manpage to still list the behavior as
35548 unsupported, but removes the inaccurate description of it
35549 only being a problem with 2.6 kernels.
35550
35551 prctl.2
35552 Michael Kerrisk [Bill McConnaughey]
35553 Mention file capabilities in discussion of PR_SET_DUMPABLE
35554 Michael Kerrisk
35555 Greatly expand discussion of "dumpable" flag
35556 In particular, detail the interactions with
35557 /proc/sys/fs/suid_dumpable.
35558 Michael Kerrisk
35559 Reorder paragraphs describing PR_SET_DUMPABLE
35560 Michael Kerrisk
35561 Mention SUID_DUMP_DISABLE and SUID_DUMP_USER under PR_SET_DUMPABLE
35562 Michael Kerrisk
35563 Executing a file with capabilities also resets the parent death signal
35564
35565 ptrace.2
35566 James Hunt
35567 Explain behaviour should ptrace tracer call execve(2)
35568 This behaviour was verified by reading the kernel source and
35569 confirming the behaviour using a test program.
35570 Denys Vlasenko
35571 Add information on PTRACE_SEIZE versus PTRACE_ATTACH differences
35572 Extend description of PTRACE_SEIZE with the short summary of its
35573 differences from PTRACE_ATTACH.
35574
35575 The following paragraph:
35576
35577 PTRACE_EVENT_STOP
35578 Stop induced by PTRACE_INTERRUPT command, or group-stop, or ini-
35579 tial ptrace-stop when a new child is attached (only if attached
35580 using PTRACE_SEIZE), or PTRACE_EVENT_STOP if PTRACE_SEIZE was used.
35581
35582 has an editing error (the part after last comma makes no sense).
35583 Removing it.
35584
35585 Mention that legacy post-execve SIGTRAP is disabled by PTRACE_SEIZE.
35586
35587 sched_setattr.2
35588 Michael Kerrisk [Christophe Blaess]
35589 SYNOPSIS: remove 'const' from 'attr' sched_getattr() argument
35590
35591 semget.2
35592 Michael Kerrisk
35593 Note default value for SEMMNI and SEMMSL
35594
35595 semop.2
35596 Michael Kerrisk
35597 Note defaults for SEMOPM and warn against increasing > 1000
35598
35599 sendfile.2
35600 Eric Wong
35601 Caution against modifying sent pages
35602
35603 setxattr.2
35604 Michael Kerrisk
35605 ERRORS: add ENOTSUP for invalid namespace prefix
35606 Michael Kerrisk
35607 Remove redundant text under ENOTSUP error
35608 Michael Kerrisk
35609 Note that zero-length attribute values are permitted
35610 Michael Kerrisk
35611 Rework text describing 'flags' argument
35612
35613 stat.2
35614 Michael Kerrisk
35615 NOTES: add "C library/kernel ABI differences" subheading
35616
35617 statfs.2
35618 Michael Kerrisk [Jan Chaloupka]
35619 Document the 'f_flags' field added in Linux 2.6.36
35620 Michael Kerrisk
35621 Clarify that 'statfs' structure has some padding bytes
35622 The number of padding bytes has changed over time, as some
35623 bytes are used, so describe this aspect of the structure
35624 less explicitly.
35625 Tao Ma
35626 Add OCFS2_SUPER_MAGIC
35627 Michael Kerrisk
35628 Use __fsword_t in statfs structure definition
35629 This more closely matches modern glibc reality.
35630 Michael Kerrisk
35631 Add a note on the __fsword_t type
35632 Michael Kerrisk
35633 Document 'f_spare' more vaguely
35634
35635 wait.2
35636 Michael Kerrisk
35637 Note that waitpid() is a wrapper for wait4()
35638 Michael Kerrisk
35639 Note that wait() is a library function implemented via wait4()
35640
35641 wait4.2
35642 Michael Kerrisk
35643 NOTES: add "C library/kernel ABI differences" subheading
35644
35645 encrypt.3
35646 Rob Somers
35647 Improve code example
35648 I (and some others) found that the original example code
35649 did not seem to work as advertised. The new code (used by
35650 permission of the original author, Jens Thoms Toerring)
35651 was found on comp.os.linux.development.
35652
35653 mktemp.3
35654 Luke Faraone
35655 DESCRIPTION reference to BUGS corrected
35656 mktemp(3)'s DESCRIPTION referenced NOTES, but no such
35657 section exists. Corrected to refer to BUGS.
35658
35659 pthread_attr_setschedparam.3
35660 Tobias Herzke
35661 Describe EINVAL in ERRORS
35662
35663 resolver.3
35664 host.conf.5
35665 Simon Paillard
35666 host.conf 'order' option deprecated, replaced by nsswitch.conf(5)
35667 http://www.sourceware.org/bugzilla/show_bug.cgi?id=2389
35668 http://repo.or.cz/w/glibc.git/commit/b9c65d0902e5890c4f025b574725154032f8120a
35669
35670 Reported at http://bugs.debian.org/270368,
35671 http://bugs.debian.org/396633, and http://bugs.debian.org/344233.
35672
35673 statvfs.3
35674 Michael Kerrisk
35675 Document missing 'f_flag' bit values
35676 And reorganize information relating to which flags are in
35677 POSIX.1.
35678 Michael Kerrisk [Jan Chaloupka]
35679 statvfs() now populates 'f_flag' from statfs()'s f_flag field
35680 These changes came with glibc 2.13, and the kernel's addition of
35681 a 'f_flags' field in Linux 2.6.36.
35682
35683 syslog.3
35684 Michael Kerrisk [Doug Goldstein]
35685 Remove unneeded <stdarg.h>
35686 vsyslog() does not need this.
35687
35688 tzset.3
35689 J William Piggott
35690 Add offset format
35691 tzset.3 does not illustrate the POSIX offset format.
35692 Specifically, there is no indication in the manual
35693 what the optional components of it are.
35694
35695 random.4
35696 Michael Kerrisk
35697 Note maximum number of bytes returned by read(2) on /dev/random
35698 Michael Kerrisk [Mathieu Malaterre]
35699 Since Linux 3.16, reads from /dev/urandom return at most 32 MB
35700 See https://bugs.debian.org/775328 and
35701 https://bugzilla.kernel.org/show_bug.cgi?id=80981#c9
35702
35703 core.5
35704 Michael Kerrisk [Bill McConnaughey]
35705 Executing a file that has capabilities also prevents core dumps
35706 Michael Kerrisk
35707 Document "%i" and "%I" core_pattern specifiers
35708
35709 intro.5
35710 Michael Kerrisk
35711 Remove words "and protocols"
35712 There are no protocol descriptions in Section 5. Protocols are
35713 in Section 7.
35714
35715 proc.5
35716 Michael Kerrisk
35717 Add reference to prctl(2) in discussion of /proc/sys/fs/suid_dumpable
35718 And note that /proc/sys/fs/suid_dumpable defines the
35719 value assigned to the process "dumpable" flag in certain
35720 circumstances.
35721 Michael Kerrisk
35722 Note that CAP_SYS_ADMIN is required to list /proc/PID/map_files
35723 This might however change in the future; see the Jan 2015 LKML thread:
35724
35725 Re: [RFC][PATCH v2] procfs: Always expose /proc/<pid>/map_files/
35726 and make it readable
35727
35728 resolv.conf.5
35729 Michael Kerrisk
35730 SEE ALSO: add nsswitch.conf(5)
35731
35732 capabilities.7
35733 Michael Kerrisk
35734 Mention SECBIT_KEEP_CAPS as an alternative to prctl() PR_SET_KEEPCAPS
35735 Chris Mayo
35736 NOTES: add last kernel versions for obsolete options
35737 The CONFIG_SECURITY_CAPABILITIES option was removed by
35738 commit 5915eb53861c5776cfec33ca4fcc1fd20d66dd27
35739
35740 The CONFIG_SECURITY_FILE_CAPABILITIES option removed in
35741 Linux 2.6.33 as already mentioned in DESCRIPTION.
35742
35743 pthreads.7
35744 Michael Kerrisk
35745 SEE ALSO: add fork(2)
35746
35747 unix.7
35748 Jan Chaloupka
35749 Mention SOCK_STREAM socket for ioctl_type of ioctl()
35750 from https://bugzilla.redhat.com/show_bug.cgi?id=1110401.
35751
35752 unix.7 is not clear about socket type of ioctl_type argument of
35753 ioctl() function. The description of SIOCINQ is applicable only
35754 for SOCK_STREAM socket. For SOCK_DGRAM, udp(7) man page gives
35755 correct description of SIOCINQ
35756
35757 ldconfig.8
35758 Michael Kerrisk
35759 Place options in alphabetical order
35760 Michael Kerrisk
35761 Note glibc version number for '-l' option
35762 Michael Kerrisk
35763 Document -c/--format option
35764 Michael Kerrisk
35765 Add long form of some options
35766 Michael Kerrisk [Patrick Horgan]
35767 ld.so.conf uses only newlines as delimiters
35768 mtk: confirmed by reading source of parse_conf() in
35769 elf/ldconfig.c.
35770 Michael Kerrisk
35771 Document -V/--version option
35772 Michael Kerrisk
35773 Document -i/--ignore-aux-cache option
35774
35775 ld.so.8
35776 Michael Kerrisk
35777 Relocate "Hardware capabilities" to be a subsection under notes
35778 This is more consistent with standard man-pages headings
35779 and layout.
35780 Michael Kerrisk
35781 (Briefly) document LD_TRACE_PRELINKING
35782 Michael Kerrisk
35783 Remove duplicate description of LD_BIND_NOT
35784
35785
35786 ==================== Changes in man-pages-3.81 ====================
35787
35788 Released: 2015-03-02, Munich
35789
35790
35791 Contributors
35792 ------------
35793
35794 The following people contributed patches/fixes or (noted in brackets
35795 in the changelog below) reports, notes, and ideas that have been
35796 incorporated in changes in this release:
35797
35798 Alexandre Oliva <aoliva@redhat.com>
35799 Carlos O'Donell <carlos@redhat.com>
35800 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
35801 Michael Kerrisk <mtk.manpages@gmail.com>
35802 Peng Haitao <penght@cn.fujitsu.com>
35803
35804 Apologies if I missed anyone!
35805
35806
35807 New and rewritten pages
35808 -----------------------
35809
35810 attributes.7
35811 Alexandre Oliva, Michael Kerrisk [Carlos O'Donell]
35812 New page describing POSIX safety concepts
35813
35814
35815 Global changes
35816 --------------
35817
35818 Many pages
35819 Peng Haitao, Michael Kerrisk
35820 Reformat existing thread-safety information to use a
35821 tabular format, rather than plain text.
35822
35823
35824 Changes to individual pages
35825 ---------------------------
35826
35827 mmap.2
35828 Ma Shimiao
35829 ATTRIBUTES: Note functions that are thread-safe
35830 The function mmap() and munmap() are thread safe.
35831
35832 a64l.3
35833 Ma Shimiao
35834 Modify thread-safety information
35835 As annotation in glibc manual is more detailed, change the
35836 thread-safety information to be the same as glibc manual.
35837
35838 acos.3
35839 Ma Shimiao
35840 ATTRIBUTES: Note functions that are thread-safe
35841 The function acos(), acosf() and acosl() are thread safe.
35842
35843 acosh.3
35844 Ma Shimiao
35845 ATTRIBUTES: Note functions that are thread-safe
35846 The function acosh(), acoshf() and acoshl() are thread safe.
35847
35848 addseverity.3
35849 Ma Shimiao
35850 ATTRIBUTES: Note function is thread-safe
35851 The function addseverity() is thread safe.
35852
35853 aio_cancel.3
35854 Ma Shimiao
35855 ATTRIBUTES: Note function that is thread-safe
35856 The function aio_cancel() is thread safe.
35857
35858 aio_fsync.3
35859 Ma Shimiao
35860 ATTRIBUTES: Note function that is thread-safe
35861 The function aio_fsync() is thread safe.
35862
35863 aio_read.3
35864 Ma Shimiao
35865 ATTRIBUTES: Note function that is thread-safe
35866 The function aio_read() is thread safe.
35867
35868 aio_suspend.3
35869 Ma Shimiao
35870 ATTRIBUTES: Note function that is thread-safe
35871 The function aio_suspend() is thread safe.
35872
35873 aio_write.3
35874 Ma Shimiao
35875 ATTRIBUTES: Note function that is thread-safe
35876 The function aio_write() is thread safe.
35877
35878 argz_add.3
35879 Ma Shimiao
35880 ATTRIBUTES: Note functions that are thread-safe
35881
35882 asin.3
35883 Ma Shimiao
35884 ATTRIBUTES: Note functions that are thread-safe
35885 The function asin(), asinf() and asinl() are thread safe.
35886
35887 assert.3
35888 Ma Shimiao
35889 ATTRIBUTES: Note function that is thread-safe
35890 Its marking matches glibc marking.
35891
35892 assert_perror.3
35893 Ma Shimiao
35894 ATTRIBUTES: Note function that is thread-safe
35895 Its marking matches glibc marking.
35896
35897 atan2.3
35898 Ma Shimiao
35899 ATTRIBUTES: Note functions that are thread-safe
35900 The function atan2(), atan2f() and atan2l() are thread safe.
35901
35902 atanh.3
35903 Ma Shimiao
35904 ATTRIBUTES: Note functions that are thread-safe
35905 The function atanh(), atanhf() and atanhl() are thread safe.
35906
35907 backtrace.3
35908 Ma Shimiao
35909 ATTRIBUTES: Note function that is thread-safe
35910 The markings match glibc markings.
35911
35912 btowc.3
35913 Ma Shimiao
35914 ATTRIBUTES: Note function that is thread-safe
35915 The function btowc() in glibc is thread safe.
35916 Its marking matches glibc marking.
35917
35918 cabs.3
35919 Ma Shimiao
35920 ATTRIBUTES: Note functions that are thread-safe
35921 The function cabs(), cabsf() and cabsl() are thread safe.
35922
35923 cacos.3
35924 Ma Shimiao
35925 ATTRIBUTES: Note functions that are thread-safe
35926 The function cacos(), cacosf() and cacosl() are thread safe.
35927
35928 cacosh.3
35929 Ma Shimiao
35930 ATTRIBUTES: Note functions that are thread-safe
35931 The functions cacosh(), cacoshf() and cacoshl() in glibc are
35932 thread safe. Its markings match glibc markings.
35933
35934 canonicalize_file_name.3
35935 Ma Shimiao
35936 ATTRIBUTES: Note function that is thread-safe
35937 The functions canonicalize_file_name() in glibc is thread safe.
35938 Its marking matches glibc marking.
35939
35940 carg.3
35941 Ma Shimiao
35942 ATTRIBUTES: Note functions that are thread-safe
35943 The function carg(), cargf() and cargl() are thread safe.
35944
35945 casin.3
35946 Ma Shimiao
35947 ATTRIBUTES: Note functions that are thread-safe
35948 The functions casin(), casinf() and casinl() are thread safe.
35949 Their markings match glibc markings.
35950
35951 casinh.3
35952 Ma Shimiao
35953 ATTRIBUTES: Note functions that are thread-safe
35954 The functions casinh(), casinhf() and casinhl() in glibc are
35955 thread safe. Its markings match glibc markings.
35956
35957 catan.3
35958 Ma Shimiao
35959 ATTRIBUTES: Note functions that are thread-safe
35960 The functions catan(), catanf() and catanl() are thread safe.
35961 Their markings match glibc markings.
35962
35963 catanh.3
35964 Ma Shimiao
35965 ATTRIBUTES: Note functions that are thread-safe
35966 The functions catanh(), catanhf() and catanhl() in glibc are
35967 thread safe. Its markings match glibc markings.
35968
35969 catopen.3
35970 Peng Haitao
35971 ATTRIBUTES: Note functions that are thread-safe
35972 The functions catopen() and catclose() are thread safe.
35973
35974 cfree.3
35975 Ma Shimiao
35976 ATTRIBUTES: Note function that is thread-safe
35977 The function cfree() in glibc is thread safe.
35978 Its marking matches glibc marking.
35979
35980 clog10.3
35981 Ma Shimiao
35982 ATTRIBUTES: Note functions that are thread-safe
35983 The functions clog10(), clog10f() and clog10l() in glibc are
35984 thread safe. Its markings match glibc markings.
35985
35986 clog.3
35987 Ma Shimiao
35988 ATTRIBUTES: Note functions that are thread-safe
35989 The function clog(), clogf() and clogl() are thread safe.
35990
35991 closedir.3
35992 Ma Shimiao
35993 ATTRIBUTES: Note function that is thread-safe
35994 The function closedir() in glibc is thread safe.
35995 Its marking matches glibc marking.
35996
35997 confstr.3
35998 Ma Shimiao
35999 ATTRIBUTES: Note function that is thread-safe
36000 The function confstr() is thread safe.
36001
36002 cosh.3
36003 Ma Shimiao
36004 ATTRIBUTES: Note functions that are thread-safe
36005 The functions cosh(), coshf() and coshl() in glibc are thread safe.
36006 Its markings match glibc markings.
36007
36008 cpow.3
36009 Ma Shimiao
36010 ATTRIBUTES: Note functions that are thread-safe
36011 The functions cpow(), cpowf() and cpowl() in glibc are thread safe.
36012 Its markings match glibc markings.
36013
36014 crypt.3
36015 Ma Shimiao
36016 Modify thread-safety information
36017 As annotation in glibc manual is more detailed, change the
36018 thread-safety information to be the same as glibc manual.
36019
36020 ctermid.3
36021 Ma Shimiao
36022 Modify thread-safety information
36023 According to the change of source code, ctermid's level has been
36024 changed from MT-Unsafe to MT-Safe. After modifying, the marking
36025 matches the glibc marking.
36026
36027 drand48.3
36028 Ma Shimiao
36029 Modify thread-safety information
36030 As annotation in glibc manual is more detailed, change the
36031 thread-safety information to be the same as glibc manual.
36032
36033 drand48_r.3
36034 Ma Shimiao
36035 Modify thread-safety information
36036 As annotation in glibc manual is more detailed, change the
36037 thread-safety information to be the same as glibc manual.
36038
36039 ecvt.3
36040 Ma Shimiao
36041 Modify thread-safety information
36042 As annotation in glibc manual is more detailed, change the
36043 thread-safety information to be same as glibc manual.
36044
36045 ecvt_r.3
36046 Ma Shimiao
36047 ATTRIBUTES: Note function that is thread-safe
36048 The markings match glibc markings.
36049
36050 encrypt.3
36051 Ma Shimiao
36052 Modify thread-safety information
36053 As annotation in glibc manual is more detailed, change the
36054 thread-safety information to be the same as glibc manual.
36055
36056 envz_add.3
36057 Ma Shimiao
36058 ATTRIBUTES: Note functions that are thread-safe
36059 The markings match glibc markings.
36060
36061 exec.3
36062 Peng Haitao
36063 ATTRIBUTES: Note functions that are thread-safe
36064 The functions execl(), execlp(), execle(), execv(), execvp() and
36065 execvpe() are thread safe.
36066
36067 exit.3
36068 Ma Shimiao
36069 Modify thread-safety information
36070 As annotation in glibc manual is more detailed, change the
36071 thread-safety information to be the same as glibc manual.
36072
36073 exp10.3
36074 Ma Shimiao
36075 ATTRIBUTES: Note functions that are thread-safe
36076
36077 exp2.3
36078 Ma Shimiao
36079 ATTRIBUTES: Note functions that are thread-safe
36080 The function exp2(), exp2f() and exp2l() are thread safe.
36081
36082 exp.3
36083 Ma Shimiao
36084 ATTRIBUTES: Note functions that are thread-safe
36085 The function exp(), expf() and expl() are thread safe.
36086
36087 fclose.3
36088 Ma Shimiao
36089 ATTRIBUTES: Note function that is thread-safe
36090 The function fclose() is thread safe.
36091 Its marking matches glibc marking.
36092
36093 fcloseall.3
36094 Ma Shimiao
36095 Modify thread-safety information
36096 As annotation in glibc manual is more detailed, change the
36097 thread-safety information to be the same as glibc manual.
36098
36099 fgetc.3
36100 Ma Shimiao
36101 ATTRIBUTES: Note functions that are thread-safe
36102 The markings match glibc markings.
36103
36104 fgetwc.3
36105 Ma Shimiao
36106 ATTRIBUTES: Note functions that are thread-safe
36107 The markings match glibc markings.
36108
36109 fgetws.3
36110 Ma Shimiao
36111 ATTRIBUTES: Note function that is thread-safe
36112 The marking matches glibc marking.
36113
36114 fmod.3
36115 Ma Shimiao
36116 ATTRIBUTES: Note functions that are thread-safe
36117 The function fmod(), fmodf() and fmodl() are thread safe.
36118
36119 fnmatch.3
36120 Peng Haitao
36121 ATTRIBUTES: Note function that is thread safe with exceptions
36122 The function fnmatch() is thread safe with exceptions.
36123
36124 fopen.3
36125 Ma Shimiao
36126 ATTRIBUTES: Note function that is thread-safe
36127 The markings match glibc markings.
36128
36129 fopencookie.3
36130 Ma Shimiao
36131 ATTRIBUTES: Note function that is thread-safe
36132 The marking matches glibc marking.
36133
36134 fread.3
36135 Peng Haitao
36136 ATTRIBUTES: Note functions that are thread-safe
36137 The functions fread() and fwrite() are thread safe.
36138
36139 gamma.3
36140 Peng Haitao
36141 ATTRIBUTES: Note functions that are not thread-safe
36142 The functions gamma(), gammaf() and gammal() are not thread safe.
36143 Ma Shimiao
36144 Modify thread-safety information
36145 As annotation in glibc manual is more detailed, change the
36146 thread-safety information to be the same as glibc manual.
36147
36148 getcontext.3
36149 Ma Shimiao
36150 Modify thread-safety information
36151 As annotation in glibc manual is more detailed, change the
36152 thread-safety information to be the same as glibc manual.
36153
36154 getcwd.3
36155 Peng Haitao
36156 ATTRIBUTES: Note functions that are thread-safe
36157 The functions getcwd(), getwd() and get_current_dir_name() are
36158 thread safe.
36159
36160 getdate.3
36161 Ma Shimiao
36162 Modify thread-safety information
36163 As annotation in glibc manual is more detailed, change the
36164 thread-safety information to be the same as glibc manual.
36165
36166 getenv.3
36167 Peng Haitao
36168 ATTRIBUTES: Note functions that are thread-safe
36169 The functions getenv() and secure_getenv() are thread safe.
36170
36171 getfsent.3
36172 Peng Haitao
36173 ATTRIBUTES: Note functions that are not thread-safe
36174 The functions setfsent(), getfsent(), endfsent(), getfsspec()
36175 and getfsfile() are not thread safe.
36176 Ma Shimiao
36177 Modify thread-safety information
36178 As annotation in glibc manual is more detailed, change the
36179 thread-safety information to be the same as glibc manual.
36180
36181 getgrent.3
36182 Ma Shimiao
36183 ATTRIBUTES: Note function that is thread-safe
36184 Its marking matches glibc marking.
36185 Ma Shimiao
36186 Modify thread-safety information
36187 As annotation in glibc manual is more detailed, change the
36188 thread-safety information to be the same as glibc manual.
36189
36190 getgrnam.3
36191 Ma Shimiao
36192 Modify thread-safety information
36193 As annotation in glibc manual is more detailed, change the
36194 thread-safety information to be the same as glibc manual.
36195
36196 getgrouplist.3
36197 Peng Haitao
36198 ATTRIBUTES: Note function that is thread safe with exceptions
36199 The function getgrouplist() is thread safe with exceptions.
36200
36201 getlogin.3
36202 Ma Shimiao
36203 Modify thread-safety information
36204 As annotation in glibc manual is more detailed, change the
36205 thread-safety information to be the same as glibc manual.
36206
36207 getopt.3
36208 Peng Haitao
36209 ATTRIBUTES: Note functions that are not thread-safe
36210 The functions getopt(), getopt_long() and getopt_long_only() are
36211 not thread safe.
36212 Ma Shimiao
36213 Modify thread-safety information
36214 As annotation in glibc manual is more detailed, change the
36215 thread-safety information to be the same as glibc manual.
36216
36217 getpass.3
36218 Ma Shimiao
36219 Modify thread-safety information
36220 As annotation in glibc manual is more detailed, change the
36221 thread-safety information to be the same as glibc manual.
36222
36223 getpwent.3
36224 Ma Shimiao
36225 Modify thread-safety information
36226 As annotation in glibc manual is more detailed, change the
36227 thread-safety information to be the same as glibc manual.
36228
36229 getpwnam.3
36230 Ma Shimiao
36231 Modify thread-safety information
36232 As annotation in glibc manual is more detailed, change the
36233 thread-safety information to be the same as glibc manual.
36234
36235 gets.3
36236 Ma Shimiao
36237 ATTRIBUTES: Note function that is thread-safe
36238 Its marking matches glibc marking.
36239
36240 getw.3
36241 Peng Haitao
36242 ATTRIBUTES: Note functions that are thread-safe
36243 The functions getw() and putw() are thread safe.
36244
36245 gnu_get_libc_version.3
36246 Peng Haitao
36247 ATTRIBUTES: Note functions that are thread-safe
36248 The functions gnu_get_libc_version() and gnu_get_libc_release()
36249 are thread safe.
36250
36251 hsearch.3
36252 Ma Shimiao
36253 Modify thread-safety information
36254 As annotation in glibc manual is more detailed, change the
36255 thread-safety information to be the same as glibc manual.
36256
36257 iconv.3
36258 Peng Haitao
36259 Modify thread-safety information
36260
36261 inet.3
36262 Peng Haitao
36263 ATTRIBUTES: Note functions that are thread safe with exceptions
36264 The functions inet_aton() and inet_addr() are thread safe with
36265 exceptions.
36266 The functions inet_network(), inet_ntoa(), inet_makeaddr(),
36267 inet_lnaof() and inet_netof() are thread safe.
36268 Modify thread-safety information
36269 After researching and talking, we think inet_network() and
36270 inet_ntoa() should be marked with locale.
36271 After changing, the markings match glbc markings.
36272
36273 inet_pton.3
36274 Peng Haitao
36275 ATTRIBUTES: Note function that is thread safe with exceptions
36276 The function inet_pton() is thread safe with exceptions.
36277
36278 iswdigit.3
36279 Peng Haitao
36280 ATTRIBUTES: Note function that is thread safe with exceptions
36281 The function iswdigit() is thread safe with exceptions.
36282
36283 iswgraph.3
36284 Peng Haitao
36285 ATTRIBUTES: Note function that is thread safe with exceptions
36286 The function iswgraph() is thread safe with exceptions.
36287
36288 iswlower.3
36289 Peng Haitao
36290 ATTRIBUTES: Note function that is thread safe with exceptions
36291 The function iswlower() is thread safe with exceptions.
36292
36293 iswprint.3
36294 Peng Haitao
36295 ATTRIBUTES: Note function that is thread safe with exceptions
36296 The function iswprint() is thread safe with exceptions.
36297
36298 iswpunct.3
36299 Peng Haitao
36300 ATTRIBUTES: Note function that is thread safe with exceptions
36301 The function iswpunct() is thread safe with exceptions.
36302
36303 iswspace.3
36304 Peng Haitao
36305 ATTRIBUTES: Note function that is thread safe with exceptions
36306 The function iswspace() is thread safe with exceptions.
36307
36308 iswupper.3
36309 Peng Haitao
36310 ATTRIBUTES: Note function that is thread safe with exceptions
36311 The function iswupper() is thread safe with exceptions.
36312
36313 iswxdigit.3
36314 Peng Haitao
36315 ATTRIBUTES: Note function that is thread safe with exceptions
36316 The function iswxdigit() is thread safe with exceptions.
36317
36318 j0.3
36319 Ma Shimiao
36320 ATTRIBUTES: Note functions that are thread-safe
36321 The function j0(), j1f() jnl() and so on are thread safe.
36322
36323 lio_listio.3
36324 Ma Shimiao
36325 ATTRIBUTES: Note function that is thread-safe
36326 Its marking matches glibc marking.
36327
36328 log10.3
36329 Ma Shimiao
36330 ATTRIBUTES: Note functions that are thread-safe
36331 The function log10(), log10f() and log10l() are thread safe.
36332
36333 log2.3
36334 Ma Shimiao
36335 ATTRIBUTES: Note functions that are thread-safe
36336 The function log2(), log2f() and log2l() are thread safe.
36337
36338 log.3
36339 Ma Shimiao
36340 ATTRIBUTES: Note functions that are thread-safe
36341 The function log(), logf() and logl() are thread safe.
36342
36343 makecontext.3
36344 Ma Shimiao
36345 Modify thread-safety information
36346 As annotation in glibc manual is more detailed, change the
36347 thread-safety information to be the same as glibc manual.
36348
36349 makedev.3
36350 Peng Haitao
36351 ATTRIBUTES: Note macros that are thread-safe
36352 The macros makedev(), major() and minor() are thread safe.
36353
36354 malloc.3
36355 Ma Shimiao
36356 ATTRIBUTES: Note functions that are thread-safe
36357 The function malloc(), free(), calloc() and realloc() are
36358 thread safe.
36359
36360 mblen.3
36361 Ma Shimiao
36362 Modify thread-safety information
36363 As annotation in glibc manual is more detailed, change the
36364 thread-safety information to be the same as glibc manual.
36365
36366 mbstowcs.3
36367 Ma Shimiao
36368 ATTRIBUTES: Note function that is thread-safe
36369 The marking matches glibc marking.
36370
36371 mbtowc.3
36372 Peng Haitao
36373 ATTRIBUTES: Note function that is not thread-safe
36374 The function mbtowc() is not thread safe.
36375 Ma Shimiao
36376 Modify thread-safety information
36377 As annotation in glibc manual is more detailed, change the
36378 thread-safety information to be the same as glibc manual.
36379
36380 mktemp.3
36381 Peng Haitao
36382 ATTRIBUTES: Note function that is thread-safe
36383 The function mktemp() is thread safe.
36384
36385 mtrace.3
36386 Peng Haitao
36387 ATTRIBUTES: Note functions that are not thread-safe
36388 The functions mtrace() and muntrace() are not thread safe.
36389
36390 nan.3
36391 Ma Shimiao
36392 ATTRIBUTES: Note functions that are thread-safe
36393 The markings match glibc markings.
36394
36395 nl_langinfo.3
36396 Peng Haitao
36397 ATTRIBUTES: Note function that is thread safe with exceptions
36398 The function nl_langinfo() is thread safe with exceptions.
36399
36400 opendir.3
36401 Ma Shimiao
36402 ATTRIBUTES: Note function that is thread-safe
36403 The markings match glibc markings.
36404
36405 pow10.3
36406 Ma Shimiao
36407 ATTRIBUTES: Note functions that are thread-safe
36408 The function pow10(), pow10f() and pow10l() are thread safe.
36409
36410 pow.3
36411 Ma Shimiao
36412 ATTRIBUTES: Note functions that are thread-safe
36413 The function pow(), powf() and powl() are thread safe.
36414
36415 pthread_setcancelstate.3
36416 Michael Kerrisk
36417 Add async-signal-safety information
36418
36419 ptsname.3
36420 Ma Shimiao
36421 Modify thread-safety information
36422 As annotation in glibc manual is more detailed, change the
36423 thread-safety information to be the same as glibc manual.
36424
36425 putenv.3
36426 Ma Shimiao
36427 ATTRIBUTES: Note function that is thread-unsafe
36428 The function putenv() is thread unsafe.
36429
36430 puts.3
36431 Peng Haitao
36432 ATTRIBUTES: Note functions that are thread-safe
36433 The functions fputc(), fputs(), putc(), putchar() and puts() are
36434 thread safe.
36435
36436 putwchar.3
36437 Ma Shimiao
36438 ATTRIBUTES: Note function that is thread-safe
36439 The marking matches glibc marking.
36440
36441 qecvt.3
36442 Ma Shimiao
36443 Modify thread-safety information
36444 As annotation in glibc manual is more detailed, change the
36445 thread-safety information to be same as glibc manual.
36446
36447 rand.3
36448 Peng Haitao
36449 ATTRIBUTES: Note macros that are thread-safe
36450 The functions rand(), rand_r() and srand() are thread safe.
36451
36452 random_r.3
36453 Ma Shimiao
36454 Modify thread-safety information
36455 As annotation in glibc manual is more detailed, change the
36456 thread-safety information to be the same as glibc manual.
36457
36458 readdir.3
36459 Ma Shimiao
36460 Modify thread-safety information
36461 As annotation in glibc manual is more detailed, change the
36462 thread-safety information to be same as glibc manual.
36463
36464 realpath.3
36465 Ma Shimiao
36466 ATTRIBUTES: Note function that is thread-safe
36467 The marking matches glibc marking.
36468
36469 regex.3
36470 Peng Haitao
36471 ATTRIBUTES: Note functions that are thread safe with exceptions
36472 The functions regcomp() and regexec() are thread safe with
36473 exceptions.
36474 The functions regerror() and regfree() are thread safe.
36475
36476 remainder.3
36477 Ma Shimiao
36478 ATTRIBUTES: Note function that is thread-safe
36479 The markings match glibc markings.
36480
36481 scalb.3
36482 Ma Shimiao
36483 ATTRIBUTES: Note functions that are thread-safe
36484 The function scalb(), scalbf() and scalbl() are thread safe.
36485
36486 setenv.3
36487 Ma Shimiao
36488 ATTRIBUTES: Note functions that are thread-unsafe
36489 The function setenv() and unsetenv() are thread unsafe.
36490
36491 siginterrupt.3
36492 Ma Shimiao
36493 Modify thread-safety information
36494 As annotation in glibc manual is more detailed, change the
36495 thread-safety information to be the same as glibc manual.
36496
36497 sigset.3
36498 Peng Haitao
36499 ATTRIBUTES: Note macros that are thread-safe
36500 The functions sigset(), sighold(), sigrelse() and sigignore()
36501 are thread safe.
36502
36503 sinh.3
36504 Ma Shimiao
36505 ATTRIBUTES: Note functions that are thread-safe
36506 The function sinh(), sinhf() and sinhl() are thread safe.
36507
36508 sqrt.3
36509 Ma Shimiao
36510 ATTRIBUTES: Note functions that are thread-safe
36511 The function sqrt(), sqrtf() and sqrtl() are thread safe.
36512
36513 stdarg.3
36514 Ma Shimiao
36515 Modify thread-safety information
36516 As annotation in glibc manual is more detailed, change the
36517 thread-safety information to be the same as glibc manual.
36518
36519 stdio_ext.3
36520 Ma Shimiao
36521 Modify thread-safety information
36522 Change the thread safety information to be the same as glibc.
36523
36524 strcasecmp.3
36525 Peng Haitao
36526 ATTRIBUTES: Note functions that are thread safe with exceptions
36527 The functions strcasecmp() and strncasecmp() are thread safe
36528 with exceptions.
36529
36530 strerror.3
36531 Ma Shimiao
36532 Modify thread-safety information
36533 As annotation in glibc manual is more detailed, change the
36534 thread-safety information to be the same as glibc manual.
36535
36536 strfmon.3
36537 Ma Shimiao
36538 ATTRIBUTES: Note function that is thread-safe
36539 Its marking matches glibc marking.
36540
36541 strfry.3
36542 Peng Haitao
36543 ATTRIBUTES: Note function that is thread-safe
36544 The function strfry() is thread safe.
36545
36546 strftime.3
36547 Peng Haitao
36548 ATTRIBUTES: Note function that is thread safe with exceptions
36549 The function strftime() is thread safe with exceptions.
36550
36551 strptime.3
36552 Peng Haitao
36553 ATTRIBUTES: Note function that is thread safe with exceptions
36554 The function strptime() is thread safe with exceptions.
36555
36556 strtok.3
36557 Ma Shimiao
36558 Modify thread-safety information
36559 As annotation in glibc manual is more detailed, change the
36560 thread-safety information to be the same as glibc manual.
36561
36562 strverscmp.3
36563 Peng Haitao
36564 ATTRIBUTES: Note function that is thread-safe
36565 The function strverscmp() is thread safe.
36566
36567 strxfrm.3
36568 Ma Shimiao
36569 ATTRIBUTES: Note function that is thread-safe
36570 The marking matches glibc marking.
36571
36572 syslog.3
36573 Peng Haitao
36574 ATTRIBUTES: Note functions that are thread safe with exceptions
36575 The functions openlog() and closelog() are thread safe.
36576 The functions syslog() and vsyslog() are thread safe with
36577 exceptions.
36578
36579 tempnam.3
36580 Peng Haitao
36581 ATTRIBUTES: Note function that is thread-safe
36582 The function tempnam() is thread safe.
36583
36584 termios.3
36585 Ma Shimiao
36586 Modify thread-safety information
36587 As annotation in glibc manual is more detailed, change the
36588 thread-safety information to be the same as glibc manual.
36589 Ma Shimiao
36590 Modify thread-safety information
36591 As this is man page for Linux, we don't need thread safety
36592 information for bsd
36593
36594 tgamma.3
36595 Ma Shimiao
36596 ATTRIBUTES: Note functions that are thread-safe
36597 The functions tgamma(), tgammaf() and tgammal() in glibc are
36598 thread safe. Its markings match glibc markings.
36599
36600 timegm.3
36601 Peng Haitao
36602 ATTRIBUTES: Note functions that are thread safe with exceptions
36603 The functions timelocal() and timegm() are thread safe with
36604 exceptions.
36605
36606 tmpfile.3
36607 Ma Shimiao
36608 ATTRIBUTES: Note function that is thread-safe
36609 Its markings match glibc markings.
36610
36611 tmpnam.3
36612 Peng Haitao
36613 Modify thread-safety information
36614 When the argument s is NULL, tmpnam() should be MT-Unsafe.
36615
36616 toupper.3
36617 Ma Shimiao
36618 Modify thread-safety information
36619 After researching and talking, we think toupper() and tolower()
36620 should not be marked with locale.
36621 After changing, the markings match glbc markings.
36622
36623 tsearch.3
36624 Ma Shimiao
36625 ATTRIBUTES: Note functions that are thread-safe
36626 The functions' markings match glibc markings.
36627
36628 ttyname.3
36629 Ma Shimiao
36630 Modify thread-safety information
36631 As annotation in glibc manual is more detailed, change the
36632 thread-safety information to be same as glibc manual.
36633
36634 tzset.3
36635 Peng Haitao
36636 ATTRIBUTES: Note function that is thread safe with exceptions
36637 The function tzset() is thread safe with exceptions.
36638
36639 wcsdup.3
36640 Ma Shimiao
36641 ATTRIBUTES: Note function that is thread-safe
36642 Its marking matches glibc marking.
36643
36644 wctomb.3
36645 Ma Shimiao
36646 Modify thread-safety information
36647 As annotation in glibc manual is more detailed, change the
36648 thread-safety information to be the same as glibc manual.
36649
36650 y0.3
36651 Ma Shimiao
36652 ATTRIBUTES: Note functions that are thread-safe
36653 The function y0(), y1f() ynl() and so on are thread safe.
36654
36655 man-pages.7
36656 Michael Kerrisk
36657 Refer reader to attributes(7) for details of ATTRIBUTES section
36658 Michael Kerrisk
36659 SEE ALSO: add attributes(7)
36660
36661 pthreads.7
36662 Michael Kerrisk
36663 SEE ALSO: add attributes(7)
36664
36665 standards.7
36666 Michael Kerrisk
36667 SEE ALSO: add attributes(7)
36668
36669
36670
36671 ==================== Changes in man-pages-3.82 ====================
36672
36673 Released: 2015-03-29, Paris
36674
36675 Contributors
36676 ------------
36677
36678 The following people contributed patches/fixes or (noted in brackets
36679 in the changelog below) reports, notes, and ideas that have been
36680 incorporated in changes in this release:
36681
36682 Alban Crequy <alban.crequy@gmail.com>
36683 Andy Lutomirski <luto@amacapital.net>
36684 Bert Wesarg <bert.wesarg@googlemail.com>
36685 Bill Pemberton <wfp5p@worldbroken.com>
36686 Chris Delozier <c.s.delozier@gmail.com>
36687 David Madore <david.madore@ens.fr>
36688 Dmitry Deshevoy <mityada@gmail.com>
36689 Eric W. Biederman <ebiederm@xmission.com>
36690 Heinrich Schuchardt <xypron.glpk@gmx.de>
36691 Jakub Wilk <jwilk@debian.org>
36692 Jann Horn <jann@thejh.net>
36693 Jason Vas Dias <jason.vas.dias@gmail.com>
36694 Josh Triplett <josh@joshtriplett.org>
36695 J William Piggott <elseifthen@gmx.com>
36696 Kees Cook <keescook@chromium.org>
36697 Konstantin Shemyak <konstantin@shemyak.com>
36698 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
36699 Matt Turner <mattst88@gmail.com>
36700 Michael Kerrisk <mtk.manpages@gmail.com>
36701 Michael Witten <mfwitten@gmail.com>
36702 Mikael Pettersson <mikpelinux@gmail.com>
36703 Namhyung Kim <namhyung@gmail.com>
36704 Nicolas FRANCOIS <nicolas.francois@centraliens.net>
36705 Paul E Condon <pecondon@mesanetworks.net>
36706 Peter Adkins <peter.adkins@kernelpicnic.net>
36707 Scot Doyle <lkml14@scotdoyle.com>
36708 Shawn Landden <shawn@churchofgit.com>
36709 Stéphane Aulery <saulery@free.fr>
36710 Stephen Smalley <sds@tycho.nsa.gov>
36711 Taisuke Yamada <tai@rakugaki.org>
36712 Torvald Riegel <triegel@redhat.com>
36713 Vincent Lefevre <vincent@vinc17.net>
36714 <ygrex@ygrex.ru>
36715 Yuri Kozlov <yuray@komyakino.ru>
36716
36717 Apologies if I missed anyone!
36718
36719
36720 New and rewritten pages
36721 -----------------------
36722
36723 nptl.7
36724 Michael Kerrisk
36725 New page with details of the NPTL POSIX threads implementation
36726
36727
36728 Newly documented interfaces in existing pages
36729 ---------------------------------------------
36730
36731 user_namespaces.7
36732 Eric W. Biederman [Michael Kerrisk]
36733 Document /proc/[pid]/setgroups
36734
36735
36736 Changes to individual pages
36737 ---------------------------
36738
36739 intro.1
36740 Stéphane Aulery
36741 Prompt is not % but $
36742 Stéphane Aulery
36743 Various improvements
36744 - Add reference to other common shells dash(1), ksh(1)
36745 - Add a reference to stdout(3)
36746 - Separate cp and mv descriptions
36747 - Add examples of special cases of cd
36748 - Add su(1) and shutdown(8) references for section Logout
36749 and poweroff
36750 - Move Control-D to section Logout and poweroff
36751 - Fix some little formatting errors
36752 Stéphane Aulery
36753 Add cross references cited
36754 Stéphane Aulery
36755 Order SEE ALSO section
36756
36757 clone.2
36758 Josh Triplett
36759 Document that clone() silently ignores CLONE_PID and CLONE_STOPPED
36760 Normally, system calls return EINVAL for flags they don't support.
36761 Explicitly document that clone does *not* produce an error for
36762 these two obsolete flags.
36763 Michael Kerrisk
36764 Small rewording of explanation of clone() wrt threads
36765 Clone has so many effects that it's an oversimplification to say
36766 that the *main* use of clone is to create a thread. (In fact,
36767 the use of clone() to create new processes may well be more
36768 common, since glibc's fork() is a wrapper that calls clone().)
36769
36770 getgroups.2
36771 Michael Kerrisk [Shawn Landden]
36772 Add discussion of NPTL credential-changing mechanism
36773 At the kernel level, credentials (UIDs and GIDs) are a per-thread
36774 attribute. NPTL uses a signal-based mechanism to ensure that
36775 when one thread changes its credentials, all other threads change
36776 credentials to the same values. By this means, the NPTL
36777 implementation conforms to the POSIX requirement that the threads
36778 in a process share credentials.
36779 Michael Kerrisk
36780 ERRORS: add EPERM for the case where /proc/PID/setgroups is "deny"
36781 Michael Kerrisk
36782 Note capability associated with EPERM error for setgroups(2)
36783 Michael Kerrisk
36784 Refer reader to user_namespaces(7) for discussion of /proc/PID/setgroups
36785 The discussion of /proc/PID/setgroups has moved from
36786 proc(5) to user_namespaces(7).
36787
36788 getpid.2
36789 Michael Kerrisk
36790 Note that getppid() returns 0 if parent is in different PID namespace
36791
36792 getsockopt.2
36793 Konstantin Shemyak
36794 Note RETURN VALUE details when netfilter is involved
36795
36796 ioctl_list.2
36797 Heinrich Schuchardt
36798 SEE ALSO ioctl_fat.2
36799 Add FAT_IOCTL_GET_VOLUME_ID
36800 SEE ALSO ioctl_fat.2
36801 Heinrich Schuchardt
36802 include/linux/ext2_fs.h
36803 Include linux/ext2_fs.h does not contain any ioctl definitions
36804 anymore.
36805
36806 Request codes EXT2_IOC* have been replaced by FS_IOC* in
36807 linux/fs.h.
36808
36809 Some definitions of FS_IOC_* use long* but the actual code expects
36810 int* (see fs/ext2/ioctl.c).
36811
36812 msgop.2
36813 Bill Pemberton
36814 Remove EAGAIN as msgrcv() errno
36815 The list of errnos for msgrcv() lists both EAGAIN and ENOMSG as
36816 the errno for no message available with the IPC_NOWAIT flag.
36817 ENOMSG is the errno that will be set.
36818 Bill Pemberton
36819 Add an example program
36820
36821 open.2
36822 Michael Kerrisk [Jason Vas Dias]
36823 Mention blocking semantics for FIFO opens
36824 See https://bugzilla.kernel.org/show_bug.cgi?id=95191
36825
36826 seccomp.2
36827 Jann Horn [Kees Cook, Mikael Pettersson, Andy Lutomirski]
36828 Add note about alarm(2) not being sufficient to limit runtime
36829 Jann Horn
36830 Explain blacklisting problems, expand example
36831 Michael Kerrisk [Kees Cook]
36832 Add mention of libseccomp
36833
36834 setgid.2
36835 Michael Kerrisk
36836 Clarify that setgid() changes all GIDs when caller has CAP_SETGID
36837 Michael Kerrisk [Shawn Landden]
36838 Add discussion of NPTL credential-changing mechanism
36839 At the kernel level, credentials (UIDs and GIDs) are a per-thread
36840 attribute. NPTL uses a signal-based mechanism to ensure that
36841 when one thread changes its credentials, all other threads change
36842 credentials to the same values. By this means, the NPTL
36843 implementation conforms to the POSIX requirement that the threads
36844 in a process share credentials.
36845
36846 setresuid.2
36847 Michael Kerrisk [Shawn Landden]
36848 Add discussion of NPTL credential-changing mechanism
36849 At the kernel level, credentials (UIDs and GIDs) are a per-thread
36850 attribute. NPTL uses a signal-based mechanism to ensure that
36851 when one thread changes its credentials, all other threads change
36852 credentials to the same values. By this means, the NPTL
36853 implementation conforms to the POSIX requirement that the threads
36854 in a process share credentials.
36855
36856 setreuid.2
36857 Michael Kerrisk [Shawn Landden]
36858 Add discussion of NPTL credential-changing mechanism
36859 At the kernel level, credentials (UIDs and GIDs) are a per-thread
36860 attribute. NPTL uses a signal-based mechanism to ensure that
36861 when one thread changes its credentials, all other threads change
36862 credentials to the same values. By this means, the NPTL
36863 implementation conforms to the POSIX requirement that the threads
36864 in a process share credentials.
36865 Michael Kerrisk
36866 SEE ALSO: add credentials(7)
36867
36868 setuid.2
36869 Michael Kerrisk
36870 Clarify that setuid() changes all UIDs when caller has CAP_SETUID
36871 Michael Kerrisk [Shawn Landden]
36872 Add discussion of NPTL credential-changing mechanism
36873 At the kernel level, credentials (UIDs and GIDs) are a per-thread
36874 attribute. NPTL uses a signal-based mechanism to ensure that
36875 when one thread changes its credentials, all other threads change
36876 credentials to the same values. By this means, the NPTL
36877 implementation conforms to the POSIX requirement that the threads
36878 in a process share credentials.
36879
36880 sigaction.2
36881 Michael Kerrisk
36882 Add discussion of rt_sigaction(2)
36883 Michael Kerrisk
36884 Note treatment of signals used internally by NPTL
36885 The glibc wrapper gives an EINVAL error on attempts to change the
36886 disposition of either of the two real-time signals used by NPTL.
36887
36888 sigpending.2
36889 Michael Kerrisk
36890 Add discussion of rt_sigpending(2)
36891
36892 sigprocmask.2
36893 Michael Kerrisk
36894 Add discussion of rt_sigprocmask(2)
36895 Michael Kerrisk
36896 Note treatment of signals used internally by NPTL
36897 The glibc wrapper silently ignores attempts to block the two
36898 real-time signals used by NPTL.
36899
36900 sigreturn.2
36901 Michael Kerrisk
36902 Add discussion of rt_sigreturn(2)
36903
36904 sigsuspend.2
36905 Michael Kerrisk
36906 Add discussion of rt_sigsuspend(2)
36907
36908 sigwaitinfo.2
36909 Michael Kerrisk
36910 Note treatment of signals used internally by NPTL
36911 The glibc wrappers silently ignore attempts to wait for
36912 signals used by NPTL.
36913 Michael Kerrisk
36914 Add discussion of rt_sigtimedwait(2)
36915
36916 socket.2
36917 Heinrich Schuchardt
36918 SEE ALSO close(2)
36919 The description mentions close(2). Hence it should also be
36920 referenced in the SEE ALSO section.
36921
36922 syscall.2
36923 Jann Horn
36924 Add x32 ABI
36925
36926 umount.2
36927 Eric W. Biederman
36928 Document the effect of shared subtrees on umount(2)
36929 Eric W. Biederman
36930 Correct the description of MNT_DETACH
36931 I recently realized that I had been reasoning improperly about
36932 what umount(MNT_DETACH) did based on an insufficient description
36933 in the umount.2 man page, that matched my intuition but not the
36934 implementation.
36935
36936 When there are no submounts, MNT_DETACH is essentially harmless to
36937 applications. Where there are submounts, MNT_DETACH changes what
36938 is visible to applications using the detach directories.
36939 Michael Kerrisk
36940 Move "shared mount + umount" text to a subsection in NOTES
36941
36942 aio_return.3
36943 Stéphane Aulery
36944 Document the return value on error
36945 Reported by Alexander Holler <holler@ahsoftware.de>
36946
36947 clock.3
36948 Stéphane Aulery
36949 CLOCKS_PER_SEC = 1000000 is required by XSI, not POSIX
36950 Debian Bug #728213 reported by Tanaka Akira <akr@fsij.org>
36951
36952 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728213
36953
36954 dlopen.3
36955 Michael Kerrisk
36956 Amend error in description of dlclose() behavior
36957 The current text says that unloading depends on whether
36958 the reference count falls to zero *and no other libraries
36959 are using symbols in this library*. That latter text has
36960 been there since man-pages-1.29, but it seems rather dubious.
36961 How could the implementation know whether other libraries
36962 are still using symbols in this library? Furthermore, no
36963 other implementation's man page mentions this point.
36964 Seems best to drop this point.
36965 Michael Kerrisk
36966 Add some details for RTLD_DEFAULT
36967 Michael Kerrisk
36968 Add some details on RTLD_NEXT and preloading
36969 Michael Kerrisk
36970 RTLD_NEXT works for symbols generally, not just functions
36971 The common use case is for functions, but RTLD_NEXT
36972 also applies to variable symbols.
36973 Michael Kerrisk
36974 dlclose() recursively closes dependent libraries
36975 Note that dlclose() recursively closes dependent libraries
36976 that were loaded by dlopen()
36977 Michael Kerrisk
36978 Rename second dlopen() argument from "flag" to "flags"
36979 This is more consistent with other such arguments
36980 Michael Kerrisk
36981 Reformat text on RTLD_DEFAULT and RTLD_NEXT
36982
36983 fmemopen.3
36984 Ma Shimiao
36985 ATTRIBUTES: Note functions that are thread-safe
36986 The markings match glibc markings.
36987
36988 fpathconf.3
36989 Ma Shimiao
36990 ATTRIBUTES: Note functions that are thread-safe
36991 The marking matches glibc marking.
36992
36993 fputwc.3
36994 Ma Shimiao
36995 ATTRIBUTES: Note functions that are thread-safe
36996 The marking matches glibc marking.
36997
36998 fputws.3
36999 Ma Shimiao
37000 ATTRIBUTES: Note function that is thread-safe
37001 The marking matches glibc marking.
37002
37003 fseek.3
37004 Ma Shimiao
37005 ATTRIBUTES: Note functions that are thread-safe
37006 The markings match glibc markings.
37007
37008 fseeko.3
37009 Ma Shimiao
37010 ATTRIBUTES: Note functions that are thread-safe
37011 The markings match glibc markings.
37012
37013 gcvt.3
37014 Ma Shimiao
37015 ATTRIBUTES: Note function that is thread-safe
37016 The marking matches glibc marking.
37017
37018 getline.3
37019 Ma Shimiao
37020 ATTRIBUTES: Note functions that are thread-safe
37021 The marking matches glibc marking.
37022
37023 getwchar.3
37024 Ma Shimiao
37025 ATTRIBUTES: Note function that is thread-safe
37026 The marking matches glibc marking.
37027
37028 hypot.3
37029 Ma Shimiao
37030 ATTRIBUTES: Note functions that are thread-safe
37031 The markings match glibc markings.
37032
37033 iconv_open.3
37034 Ma Shimiao
37035 ATTRIBUTES: Note function that is thread-safe
37036 The marking matches glibc marking.
37037
37038 if_nameindex.3
37039 Ma Shimiao
37040 ATTRIBUTES: Note functions that are thread-safe
37041 The markings match glibc markings.
37042
37043 initgroups.3
37044 Ma Shimiao
37045 ATTRIBUTES: Note function that is thread-safe
37046 The markings match glibc markings.
37047
37048 mq_open.3
37049 Torvald Riegel
37050 Add EINVAL error case for invalid name
37051 This behavior is implementation-defined by POSIX. If the name
37052 doesn't start with a '/', glibc returns EINVAL without attempting
37053 the syscall.
37054
37055 popen.3
37056 Ma Shimiao
37057 ATTRIBUTES: Note functions that are thread-safe
37058 The marking matches glibc marking.
37059
37060 pthread_kill.3
37061 Michael Kerrisk
37062 Note treatment of signals used internally by NPTL
37063 The glibc pthread_kill() function gives an error on attempts
37064 to send either of the real-time signals used by NPTL.
37065
37066 pthread_sigmask.3
37067 Michael Kerrisk
37068 Note treatment of signals used internally by NPTL
37069 The glibc implementation silently ignores attempts to block the two
37070 real-time signals used by NPTL.
37071
37072 pthread_sigqueue.3
37073 Michael Kerrisk
37074 Note treatment of signals used internally by NPTL
37075 The glibc pthread_sigqueue() function gives an error on attempts
37076 to send either of the real-time signals used by NPTL.
37077
37078 resolver.3
37079 Stéphane Aulery [Jakub Wilk]
37080 Document missing options used by _res structure indicate defaults
37081 Missing options: RES_INSECURE1, RES_INSECURE2, RES_NOALIASES,
37082 USE_INET6, ROTATE, NOCHECKNAME, RES_KEEPTSIG, BLAST, USEBSTRING,
37083 NOIP6DOTINT, USE_EDNS0, SNGLKUP, SNGLKUPREOP, RES_USE_DNSSEC,
37084 NOTLDQUERY, DEFAULT
37085
37086 Written from the glibc source and resolv.conf.5.
37087
37088 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=527136
37089 Stéphane Aulery
37090 RES_IGNTC is implemented
37091
37092 rint.3
37093 Matt Turner
37094 Document that halfway cases are rounded to even
37095 Per IEEE-754 rounding rules.
37096
37097 The round(3) page describes the behavior of rint and nearbyint
37098 in the halfway cases by saying:
37099
37100 These functions round x to the nearest integer, but round
37101 halfway cases away from zero [...], instead of to the
37102 nearest even integer like rint(3)
37103
37104 sigqueue.3
37105 Michael Kerrisk
37106 NOTES: add "C library/kernel ABI differences" subheading
37107 Michael Kerrisk
37108 Clarify version info (mention rt_sigqueueinfo())
37109
37110 sigsetops.3
37111 Michael Kerrisk
37112 Note treatment of signals used internally by NPTL
37113 The glibc sigfillset() function excludes the two real-time
37114 signals used by NPTL.
37115
37116 sigwait.3
37117 Michael Kerrisk
37118 Note treatment of signals used internally by NPTL
37119 The glibc sigwait() silently ignore attempts to wait for
37120 signals used by NPTL.
37121
37122 strcoll.3
37123 Ma Shimiao
37124 ATTRIBUTES: Note function that is thread-safe
37125 The markings match glibc markings.
37126
37127 strdup.3
37128 Ma Shimiao
37129 ATTRIBUTES: Note functions that are thread-safe
37130 The marking matches glibc marking.
37131
37132 tzset.3
37133 J William Piggott
37134 Add 'std' quoting information
37135
37136 ulimit.3
37137 Ma Shimiao
37138 ATTRIBUTES: Note function that is thread-safe
37139 The marking matches glibc marking.
37140
37141 wcstombs.3
37142 Ma Shimiao
37143 ATTRIBUTES: Note function that is thread-safe
37144 The marking matches glibc marking.
37145
37146 wctob.3
37147 Ma Shimiao
37148 ATTRIBUTES: Note function that is thread-safe
37149 The marking matches glibc marking.
37150
37151 xdr.3
37152 Taisuke Yamada
37153 Clarified incompatibility and correct usage of XDR API
37154 See http://bugs.debian.org/628099
37155
37156 console_codes.4
37157 Scot Doyle
37158 Add Console Private CSI sequence 15
37159 An undocumented escape sequence in drivers/tty/vt/vt.c brings the
37160 previously accessed virtual terminal to the foreground.
37161 mtk: Patch misattributed to Taisuke Yamada in Git commit
37162 because of a muck up on my part.
37163 Michael Kerrisk
37164 Add kernel version number for CSI sequence 15
37165
37166 random.4
37167 Michael Kerrisk
37168 Fix permissions shown for the devices
37169 These days, the devices are RW for everyone.
37170
37171 filesystems.5
37172 Michael Kerrisk
37173 Remove dubious claim about comparative performance of ext2
37174 Perhaps it was the best filesystem performance-wise in
37175 the 20th century, when that text was written. That probably
37176 ceased to be true quite a long time ago, though.
37177 Stéphane Aulery
37178 Add cross references for ext filesystems
37179 Stéphane Aulery
37180 Specifies the scope of this list and its limits.
37181
37182 host.conf.5
37183 hosts.5
37184 resolv.conf.5
37185 Stéphane Aulery [Paul E Condon]
37186 Cross references of these pages.
37187 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=298259
37188
37189 host.conf.5
37190 Stéphane Aulery
37191 Rework discussion of nospoof, spoofalert, spoof and RESOLV_SPOOF_CHECK
37192 The keywords and environment variables "nospoof", "spoofalert",
37193 "spoof" and RESOLV_SPOOF_CHECK were added to glibc 2.0.7 but
37194 never implemented
37195
37196 Move descriptions to historical section and reorder it for clarity
37197
37198 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=773443
37199
37200 hosts.5
37201 Stéphane Aulery [Vincent Lefevre]
37202 Mention 127.0.1.1 for FQDN and IPv6 examples
37203 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=562890
37204
37205 proc.5
37206 Taisuke Yamada
37207 Document /proc/PID/status VmPin field
37208 See https://bugs.launchpad.net/bugs/1071746
37209 Michael Kerrisk
37210 Document (the obsolete) /proc/PID/seccomp
37211 Michael Kerrisk
37212 Replace description of 'uid_map' with a reference to user_namespaces(7)
37213 All of the information in proc(5) was also present in
37214 user_namespaces(7), but the latter was more detailed
37215 and up to date.
37216 Taisuke Yamada
37217 Fix SELinux /proc/pid/attr/current example
37218 Since the /proc/pid/attr API was added to the kernel, there
37219 have been a couple of changes to the SELinux handling of
37220 /proc/pid/attr/current. Fix the SELinux /proc/pid/attr/current
37221 example text to reflect these changes and note which kernel
37222 versions first included the changes.
37223
37224 securetty.5
37225 Stéphane Aulery [Nicolas FRANCOIS]
37226 Note that the pam_securetty module also uses this file
37227 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=528015
37228
37229 This patch is a modified version of the one proposed without
37230 parts specific to Debian.
37231
37232 boot.7
37233 Michael Witten
37234 Copy edit
37235 While a lot of the changes are issues of presentation,
37236 there are also issues of grammar and punctuation.
37237 Michael Witten
37238 Mention `systemd(1)' and its related `bootup(7)'
37239 It's important that the reader receive contemporary information.
37240
37241 credentials.7
37242 Michael Kerrisk
37243 SEE ALSO: add pthreads(7)
37244 Michael Kerrisk
37245 Add reference to nptl(7)
37246
37247 feature_test_macros.7
37248 Michael Kerrisk
37249 Update discussion of _FORTIFY_SOURCE
37250 Since the initial implementation a lot more checks were added.
37251 Describe all the checks would be too verbose (and would soon
37252 fall out of date as more checks are added). So instead, describe
37253 the kinds of checks that are done more generally.
37254 Also a few other minor edits to the text.
37255
37256 hier.7
37257 Stéphane Aulery
37258 First patch of a series to achieve compliance with FHS 2.3
37259 Stéphane Aulery
37260 SGML and XML directories are separated in FHS 2.3
37261 Stéphane Aulery
37262 Add missing directories defined by FHS 2.3
37263 Stéphane Aulery
37264 Identify which directories are optional
37265 Stéphane Aulery
37266 Document /initrd, /lost+found and /sys
37267 Ubuntu Bug #70094 reported by Brian Beck
37268 https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/70094
37269 Stéphane Aulery
37270 Explain YP, which is not obvious
37271
37272 ipv6.7
37273 Stéphane Aulery [David Madore]
37274 SOL_IPV6 and other SOL_* options socket are not portable
37275 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=472447
37276
37277 man-pages.7
37278 Michael Kerrisk [Bill Pemberton]
37279 Add indent(1) command that produces desired formatting for example code
37280 Stéphane Aulery
37281 Improve description of sections in accordance with intro pages
37282
37283 packet.7
37284 Michael Kerrisk
37285 Rework description of fanout algorithms as list
37286 Michael Kerrisk
37287 Remove mention of needing UID 0 to create packet socket
37288 The existing text makes no sense. The check is based
37289 purely on a capability check. (Kernel function
37290 net/packet/af_packet.c::packet_create()
37291 Michael Kerrisk
37292 Remove text about ancient glibc not defining SOL_PACKET
37293 This was fixed in glibc 2.1.1, which is a long while ago.
37294 And in any case, there is nothing special about this case;
37295 it's just one of those times when glibc lags.
37296 Michael Kerrisk
37297 Rework description of 'sockaddr_ll' fields as a list
37298 Michael Kerrisk
37299 Various minor edits
37300
37301 pthreads.7
37302 Michael Kerrisk
37303 Add references to nptl(7)
37304
37305 raw.7
37306 Michael Kerrisk
37307 Rephrase "Linux 2.2" language to "Linux 2.2 or later"
37308 The man page was written in the LInux 2.2 timeframe, and
37309 some phrasing was not future-proof.
37310
37311 signal.7
37312 Michael Kerrisk
37313 Note when Linux added realtime signals
37314 Michael Kerrisk
37315 Correct the range of realtime signals
37316 Michael Kerrisk
37317 Summarize 2.2 system call changes that resulted from larger signal sets
37318 Michael Kerrisk
37319 SEE ALSO: add nptl(7)
37320
37321 tcp.7
37322 Peter Adkins
37323 Document removal of TCP_SYNQ_HSIZE
37324 Looking over the man page for 'tcp' I came across a reference to
37325 tuning the 'TCP_SYNQ_HSIZE' parameter when increasing
37326 'tcp_max_syn_backlog' above 1024. However, this static sizing was
37327 removed back in Linux 2.6.20 in favor of dynamic scaling - as
37328 part of commit 72a3effaf633bcae9034b7e176bdbd78d64a71db.
37329
37330 user_namespaces.7
37331 Eric W. Biederman
37332 Update the documentation to reflect the fixes for negative groups
37333 Files with access permissions such as rwx---rwx give fewer
37334 permissions to their group then they do to everyone else. Which
37335 means dropping groups with setgroups(0, NULL) actually grants a
37336 process privileges.
37337
37338 The unprivileged setting of gid_map turned out not to be safe
37339 after this change. Privileged setting of gid_map can be
37340 interpreted as meaning yes it is ok to drop groups. [ Eric
37341 additionally noted: Setting of gid_map with privilege has been
37342 clarified to mean that dropping groups is ok. This allows
37343 existing programs that set gid_map with privilege to work
37344 without changes. That is, newgidmap(1) continues to work
37345 unchanged.]
37346
37347 To prevent this problem and future problems, user namespaces were
37348 changed in such a way as to guarantee a user can not obtain
37349 credentials without privilege that they could not obtain without
37350 the help of user namespaces.
37351
37352 This meant testing the effective user ID and not the filesystem
37353 user ID, as setresuid(2) and setregid(2) allow setting any process
37354 UID or GID (except the supplementary groups) to the effective ID.
37355
37356 Furthermore, to preserve in some form the useful applications
37357 that have been setting gid_map without privilege, the file
37358 /proc/[pid]/setgroups was added to allow disabling setgroups(2).
37359 With setgroups(2) permanently disabled in a user namespace, it
37360 again becomes safe to allow writes to gid_map without privilege.
37361 Michael Kerrisk
37362 Rework some text describing permission rules for updating map files
37363 No (intentional) change to the facts, but this restructuring
37364 should make the meaning easier to grasp.
37365 Michael Kerrisk
37366 Update kernel version associated with 5-line limit for map files
37367 As at Linux 3.18, the limit is still five lines, so mention the
37368 more recent kernel version in the text.
37369 Michael Kerrisk [Alban Crequy]
37370 Handle /proc/PID/setgroups in the example program
37371 Michael Kerrisk
37372 Rework text describing restrictions on updating /proc/PID/setgroups
37373 No (intentional) changes to factual description, but the
37374 restructured text is hopefully easier to grasp.
37375 Michael Kerrisk
37376 Explain why the /proc/PID/setgroups file was added
37377
37378 ldconfig.8
37379 Michael Kerrisk
37380 Note use of /lib64 and /usr/lib64 on some 64-bit architectures
37381
37382 ld.so.8
37383 Michael Kerrisk
37384 Note the use of /lib64 and /usr/lib64 on some 64-bit architectures
37385
37386
37387
37388 ==================== Changes in man-pages-3.83 ====================
37389
37390 Released: 2015-04-19, Munich
37391
37392
37393 Contributors
37394 ------------
37395
37396 The following people contributed patches/fixes or (noted in brackets
37397 in the changelog below) reports, notes, and ideas that have been
37398 incorporated in changes in this release:
37399
37400 Andreas Baak <andreas.baak@gmail.com>
37401 Andreas Dilger <adilger@dilger.ca>
37402 cdlscpmv <cdlscpmv@gmail.com>
37403 Cyrill Gorcunov <gorcunov@openvz.org>
37404 Darrick J. Wong <darrick.wong@oracle.com>
37405 David Rientjes <rientjes@google.com>
37406 Dima Tisnek <dimaqq@gmail.com>
37407 Eric Sandeen <sandeen@redhat.com>
37408 Fabien Pichot <fpichot@bouledef.eu>
37409 Felix Sedlmeier <sedlmeier@gmx.de>
37410 Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
37411 Heinrich Schuchardt <xypron.glpk@gmx.de>
37412 Jann Horn <jann@thejh.net>
37413 Jon Grant <jg@jguk.org>
37414 Jonny Grant <jg@jguk.org>
37415 Kees Cook <keescook@chromium.org>
37416 Masanari Iida <standby24x7@gmail.com>
37417 Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
37418 Michael Kerrisk <mtk.manpages@gmail.com>
37419 Nikos Mavrogiannopoulos <nmav@gnutls.org>
37420 Omar Sandoval <osandov@osandov.com>
37421 Pierre Chifflier <pollux@debian.org>
37422 Robin H. Johnson <robbat2@gentoo.org>
37423 Rob Landley <rob@landley.net>
37424 Theodore Ts'o <tytso@mit.edu>
37425 Vlastimil Babka <vbabka@suse.cz>
37426 Walter Harms <wharms@bfs.de>
37427 William Woodruff <william@tuffbizz.com>
37428 YOSHIFUJI Hideaki <hideaki.yoshifuji@miraclelinux.com>
37429 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
37430
37431 Apologies if I missed anyone!
37432
37433
37434 New and rewritten pages
37435 -----------------------
37436
37437 posix_madvise.3
37438 Michael Kerrisk
37439 New page documenting posix_madvise(3)
37440
37441 ftw.3
37442 Michael Kerrisk
37443 Reorganize the page to give primacy to nftw()
37444 nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.
37445
37446 Newly documented interfaces in existing pages
37447 ---------------------------------------------
37448
37449 getdents.2
37450 Michael Kerrisk [Dima Tisnek]
37451 Document getdents64()
37452 See https://bugzilla.kernel.org/show_bug.cgi?id=14795
37453
37454 mount.2
37455 Michael Kerrisk, Theodore Ts'o [Eric Sandeen, Andreas Dilger,
37456 Omar Sandoval, Darrick J. Wong]
37457 Document MS_LAZYTIME
37458
37459 proc.5
37460 Michael Kerrisk
37461 Document /proc/sys/kernel/randomize_va_space
37462 Michael Kerrisk
37463 Document /proc/PID/fdinfo epoll format
37464 Michael Kerrisk
37465 Describe /proc/PID/fdinfo eventfd format
37466 Michael Kerrisk
37467 Document /proc/PID/fdinfo signalfd format
37468
37469
37470 New and changed links
37471 ---------------------
37472
37473 newfstatat.2
37474 Michael Kerrisk
37475 New link to fstatat64.2
37476
37477 prlimit64.2
37478 Michael Kerrisk
37479 New link to getrlimit.2
37480
37481
37482 Global changes
37483 --------------
37484
37485 Various section 3 math pages
37486 Michael Kerrisk
37487 Note that these functions are also in POSIX.1-2001 and POSIX.1-2008
37488
37489
37490 Changes to individual pages
37491 ---------------------------
37492
37493 getent.1
37494 Robin H. Johnson
37495 Document options
37496 The options to getent are now documented, after being around for
37497 nearly a decade without changes.
37498 Michael Kerrisk
37499 Document help and version options
37500
37501 fallocate.2
37502 Michael Kerrisk
37503 Fix kernel version number for FALLOC_FL_ZERO_RANGE
37504 FALLOC_FL_ZERO_RANGE was added in 3.15, not 3.14.
37505 Michael Kerrisk
37506 Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
37507
37508 getrlimit.2
37509 Michael Kerrisk
37510 Note that the underlying system call for prlimit() is prlimit64()
37511 Michael Kerrisk
37512 Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements
37513 "_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
37514 declaration.
37515
37516 ioctl_list.2
37517 Nikos Mavrogiannopoulos
37518 SIOCADDRT accepts in6_rtmsg in INET6 protocol
37519 Heinrich Schuchardt
37520 TFD_IOC_SET_TICKS
37521 timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to
37522 ioctl_list.2, too.
37523
37524 llseek.2
37525 Michael Kerrisk
37526 Advise reader to use lseek(2) instead
37527 Michael Kerrisk
37528 llseek() exists on 32-bit platforms to support seeking to large offsets
37529
37530 madvise.2
37531 David Rientjes
37532 Specify MADV_REMOVE returns EINVAL for hugetlbfs
37533 madvise(2) actually returns with error EINVAL for MADV_REMOVE
37534 when used for hugetlb VMAs, not EOPNOTSUPP, and this has been
37535 the case since MADV_REMOVE was introduced in commit f6b3ec238d12
37536 ("madvise(MADV_REMOVE): remove pages from tmpfs shm backing
37537 store"). Specify the exact behavior.
37538 Michael Kerrisk
37539 SEE ALSO: add posix_madvise(2)
37540
37541 poll.2
37542 Michael Kerrisk [Andreas Baak]
37543 SEE ALSO: add epoll(7)
37544
37545 posix_fadvise.2
37546 Michael Kerrisk
37547 Add "C library/kernel ABI differences" subsection
37548
37549 pread.2
37550 Michael Kerrisk
37551 Add "C library/kernel ABI differences" subsection
37552
37553 seccomp.2
37554 Michael Kerrisk [Pierre Chifflier, Kees Cook]
37555 Note that seccomp_data is read-only
37556
37557 stat.2
37558 Michael Kerrisk
37559 Add some details on various "stat" versions
37560 Three versions of "stat" appeared on 32-bit systems,
37561 dealing with structures of different (increasing) sizes.
37562 Explain some of the details, and also note that the
37563 situation is simpler on modern 64-bit architectures.
37564 Michael Kerrisk
37565 Add mention of newfstatat()
37566 The underlying system call for fstatat() is newfstatat()
37567 on some architectures.
37568
37569 symlink.2
37570 Michael Kerrisk [Jonny Grant]
37571 ERRORS: add linkpath=="" case for ENOENT
37572
37573 syscalls.2
37574 Michael Kerrisk
37575 Remove prlimit()
37576 There really is only the prlimit64() system call.
37577 Michael Kerrisk
37578 Add some details about the "multiple versions of system calls"
37579 The multiple-system-call-version phenomenon is particularly a
37580 feature of older 32-bit platforms. Hint at that fact in the text.
37581
37582 timerfd_create.2
37583 Cyrill Gorcunov [Michael Kerrisk]
37584 Document TFD_IOC_SET_TICKS ioctl() operation
37585 Michael Kerrisk
37586 Add some details to C library/kernel ABI differences
37587
37588 unshare.2
37589 Michael Kerrisk [Fabien Pichot]
37590 Remove mention of "System V" from discussion of CLONE_NEWIPC
37591 These days, CLONE_NEWIPC also affects POSIX message queues.
37592
37593 asprintf.3
37594 Zeng Linggang
37595 ATTRIBUTES: Note functions that are thread-safe
37596
37597 carg.3
37598 Michael Kerrisk
37599 Add introductory sentence explaining what these functions calculate
37600
37601 ccos.3
37602 Ma Shimiao
37603 ATTRIBUTES: Note functions that are thread-safe
37604 Michael Kerrisk
37605 Add introductory sentence explaining what these functions calculate
37606
37607 ccosh.3
37608 Michael Kerrisk
37609 Add introductory sentence explaining what these functions calculate
37610
37611 cexp.3
37612 Ma Shimiao
37613 ATTRIBUTES: Note functions that are thread-safe
37614
37615 clock.3
37616 Ma Shimiao
37617 ATTRIBUTES: Note functions that is thread-safe
37618
37619 clog.3
37620 Michael Kerrisk
37621 Add introductory sentence explaining what these functions calculate
37622
37623 csin.3
37624 Ma Shimiao
37625 ATTRIBUTES: Note functions that are thread-safe
37626 Michael Kerrisk
37627 Add introductory sentence explaining what these functions calculate
37628
37629 csinh.3
37630 Ma Shimiao
37631 ATTRIBUTES: Note functions that are thread-safe
37632 Michael Kerrisk
37633 Add introductory sentence explaining what these functions calculate
37634
37635 csqrt.3
37636 Ma Shimiao
37637 ATTRIBUTES: Note functions that are thread-safe
37638 Michael Kerrisk
37639 Simplify description of what these functions calculate
37640
37641 ctan.3
37642 Ma Shimiao
37643 ATTRIBUTES: Note functions that are thread-safe
37644 Michael Kerrisk
37645 Add introductory sentence explaining what these functions calculate
37646
37647 ctanh.3
37648 Ma Shimiao
37649 ATTRIBUTES: Note functions that are thread-safe
37650 Michael Kerrisk
37651 Add introductory sentence explaining what these functions calculate
37652
37653 ctime.3
37654 Zeng Linggang
37655 ATTRIBUTES: Note functions that aren't thread-safe
37656
37657 exec.3
37658 Michael Kerrisk
37659 SYNOPSIS: Clarify calling signature for execl() and execlp()
37660 Michael Kerrisk [Andreas Baak]
37661 Correct prototype for execle()
37662 Make the prototype shown into correct C.
37663
37664 ftw.3
37665 Michael Kerrisk [Felix Sedlmeier]
37666 ftw() and nftw() differ for the non-stat-able symlink case
37667 The POSIX specification of ftw() says that an un-stat-able
37668 symlink may yield either FTW_NS or FTW_SL. The specification
37669 of nftw() does not carry this statement.
37670 Michael Kerrisk
37671 CONFORMING TO: add POSIX.1-2008
37672 Michael Kerrisk
37673 Update POSIX version references in NOTES
37674
37675 getcwd.3
37676 Jann Horn [Michael Kerrisk]
37677 Note behavior for unreachable current working directory
37678 Michael Kerrisk
37679 Add ENOMEM error
37680
37681 gethostbyname.3
37682 Michael Kerrisk [Jonny Grant]
37683 Clarify that NO_ADDRESS and NO_DATA are synonyms
37684 Michael Kerrisk
37685 Add some detail for NO_DATA
37686 Text consistent with POSIX and FreeBSD's gethostbyname() man page.
37687 Zeng Linggang
37688 ATTRIBUTES: Note functions that aren't thread-safe
37689
37690 getnetent.3
37691 Zeng Linggang
37692 ATTRIBUTES: Note functions that aren't thread-safe
37693
37694 get_nprocs_conf.3
37695 Zeng Linggang
37696 ATTRIBUTES: Note functions that are thread-safe
37697
37698 getutent.3
37699 Zeng Linggang
37700 ATTRIBUTES: Note functions that aren't thread-safe
37701
37702 glob.3
37703 Zeng Linggang
37704 ATTRIBUTES: Note functions that aren't thread-safe
37705
37706 insque.3
37707 Ma Shimiao
37708 ATTRIBUTES: Note functions that are thread-safe
37709
37710 login.3
37711 Zeng Linggang
37712 ATTRIBUTES: Note functions that aren't thread-safe
37713
37714 lseek64.3
37715 Michael Kerrisk
37716 Clarify details with respect to 32-bit and 64-bit systems
37717
37718 malloc.3
37719 Michael Kerrisk
37720 Add ENOMEM error
37721
37722 mbsnrtowcs.3
37723 Zeng Linggang
37724 ATTRIBUTES: Note function that isn't thread-safe
37725
37726 mbsrtowcs.3
37727 Zeng Linggang
37728 ATTRIBUTES: Note function that isn't thread-safe
37729
37730 mq_notify.3
37731 Michael Kerrisk
37732 Add "C library/kernel ABI differences" subsection
37733
37734 mq_open.3
37735 Michael Kerrisk [Fabien Pichot]
37736 NOTES: explain differences from the underlying system call
37737 The check for the slash at the start of a pathname is done in glibc
37738
37739 openpty.3
37740 Zeng Linggang
37741 ATTRIBUTES: Note functions that aren't thread-safe
37742
37743 perror.3
37744 Zeng Linggang
37745 ATTRIBUTES: Note function that is thread-safe
37746
37747 posix_memalign.3
37748 Zeng Linggang
37749 ATTRIBUTES: Note functions that aren't thread-safe
37750
37751 printf.3
37752 Zeng Linggang
37753 ATTRIBUTES: Note functions that are thread-safe
37754 Walter Harms [Michael Kerrisk]
37755 Simplify the example code
37756
37757 qsort.3
37758 Michael Kerrisk [Rob Landley]
37759 alphasort() and versionsort() are not suitable for 'compar'
37760 In glibc 2.10, the prototypes of alphasort() and versionsort()
37761 were changed so that the arguments switched from 'const void *' to
37762 'const struct dirent **', to match the POSIX.1-2008 specification
37763 of alphasort(). As such, compiler warnings will result if
37764 these functions are used as the arguments of qsort().
37765
37766 warning: passing argument 4 of 'qsort' from incompatible
37767 pointer type
37768 expected '__compar_fn_t' but argument is of type
37769 'int (*)(const struct dirent **, const struct dirent **)'
37770
37771 Therefore, remove the ancient NOTES text suggesting that
37772 alphasort() and versionsort() can be used as suitable
37773 'compar' arguments for qsort().
37774
37775 realpath.3
37776 Michael Kerrisk [Jon Grant]
37777 Add ENOMEM error
37778
37779 scandir.3
37780 Michael Kerrisk
37781 glibc 2.10 changed the argument types for alphasort() and versionsort()
37782 Zeng Linggang
37783 ATTRIBUTES: Note functions that are thread-safe
37784
37785 scanf.3
37786 Zeng Linggang
37787 ATTRIBUTES: Note functions that are thread-safe
37788
37789 setnetgrent.3
37790 Zeng Linggang
37791 ATTRIBUTES: Note functions that aren't thread-safe
37792
37793 significand.3
37794 Ma Shimiao
37795 ATTRIBUTES: Note functions that are thread-safe
37796
37797 strcasecmp.3
37798 Michael Kerrisk [Jonny Grant]
37799 Clarify that strcasecmp() does a byte-wise comparison
37800 Michael Kerrisk
37801 CONFORMING TO: add POSIX.1-2008
37802
37803 unlocked_stdio.3
37804 Zeng Linggang
37805 ATTRIBUTES: Note functions that aren't thread-safe
37806
37807 updwtmp.3
37808 Zeng Linggang
37809 ATTRIBUTES: Note functions that aren't thread-safe
37810
37811 wcrtomb.3
37812 Zeng Linggang
37813 ATTRIBUTES: Note function that isn't thread-safe
37814
37815 wcsnrtombs.3
37816 Zeng Linggang
37817 ATTRIBUTES: Note function that isn't thread-safe
37818
37819 wcsrtombs.3
37820 Zeng Linggang
37821 ATTRIBUTES: Note function that isn't thread-safe
37822
37823 wordexp.3
37824 Zeng Linggang
37825 ATTRIBUTES: Note functions that aren't thread-safe
37826
37827 wprintf.3
37828 Zeng Linggang
37829 ATTRIBUTES: Note functions that are thread-safe
37830
37831 proc.5
37832 Michael Kerrisk
37833 Describe "mnt_id" field of /proc/PID/fdinfo
37834 Michael Kerrisk
37835 Note that abstract sockets are included in /proc/net/unix
37836 Michael Kerrisk
37837 Update description /proc/sys/unix 'Type' field
37838 The existing text was very crufty. UNIX domain sockets
37839 support more than SOCK_STREAM for a _very_ long time now.
37840 Michael Kerrisk
37841 Add some detail to /proc/PID/timers
37842 Michael Kerrisk [Vlastimil Babka]
37843 Enhance discussion of /proc/PID/status 'VmSwap' field
37844
37845 epoll.7
37846 Michael Kerrisk
37847 SEE ALSO: add poll(2) and select(2)
37848
37849 icmp.7
37850 YOSHIFUJI Hideaki/吉藤英明
37851 Document net.ipv4.ping_group_range knob
37852
37853 nptl.7
37854 Michael Kerrisk
37855 Add reference to timer_create(2)
37856
37857
37858 ==================== Changes in man-pages-4.00 ====================
37859
37860 Released: 2015-05-07, Munich
37861
37862
37863 Contributors
37864 ------------
37865
37866 The following people contributed patches/fixes or (noted in brackets
37867 in the changelog below) reports, notes, and ideas that have been
37868 incorporated in changes in this release:
37869
37870 Advait Dixi <advaitdixit@hotmail.com>
37871 Alain Kalker <a.c.kalker@gmail.com>
37872 Andi Kleen <andi@firstfloor.org>
37873 Andreas Gruenbacher <agruenba@redhat.com>
37874 Andreas Heiduk <asheiduk@googlemail.com>
37875 Askar Safin <safinaskar@mail.ru>
37876 Brice Goglin <Brice.Goglin@inria.fr>
37877 Cameron Norman <camerontnorman@gmail.com>
37878 Carlos O'Donell <carlos@redhat.com>
37879 Chris Metcalf <cmetcalf@tilera.com>
37880 Christophe Lohr <Christophe.Lohr@telecom-bretagne.eu>
37881 Christopher Head <chead@chead.ca>
37882 Christoph Hellwig <hch@infradead.org>
37883 David Wilcox <davidvsthegiant@gmail.com>
37884 Denis Du <denisdu@ruggedcom.com>
37885 Egmont Koblinger <egmont@gmail.com>
37886 Filipe Brandenburger <filbranden@gmail.com>
37887 Filipus Klutiero <chealer@gmail.com>
37888 Florian Weimer <fweimer@redhat.com>
37889 Frédéric Maria <frederic.maria@free.fr>
37890 Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
37891 Graham Shaw <gdshaw@riscpkg.org>
37892 Gregor Jasny <igjasny@googlemail.com>
37893 Guillem Jover <guillem@hadrons.org>
37894 Guy Harris <guy@alum.mit.edu>
37895 Heinrich Schuchardt <xypron.glpk@gmx.de>
37896 Ian Pilcher <arequipeno@gmail.com>
37897 Jann Horn <jann@thejh.net>
37898 Jason Newton <nevion@gmail.com>
37899 J. Bruce Fields <bfields@fieldses.org>
37900 Jiri Pirko <jpirko@redhat.com>
37901 Joachim Wuttke <j.wuttke@fz-juelich.de>
37902 Joern Heissler <contact@joern.heissler.de>
37903 Jonathan Nieder <jrnieder@gmail.com>
37904 Joonas Salo <salo.joonas@gmail.com>
37905 Jussi Lehtola <jussilehtola@fedoraproject.org>
37906 Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
37907 KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
37908 Laurence Gonsalves <laurence@xenomachina.com>
37909 Magnus REFTEL <magnus.xm.reftel@stericsson.com>
37910 Michael Kerrisk <mtk.manpages@gmail.com>
37911 NeilBrown <neilb@suse.de>
37912 Regid Ichira <regid23@nt1.in>
37913 Sam Varshavchik <mrsam@courier-mta.com>
37914 Steinar H. Gunderson <sgunderson@bigfoot.com>
37915 Stéphane Aulery <saulery@free.fr>
37916 Stephane Fillod <fillods@users.sf.net>
37917 Tetsuo Handa <from-linux-kernel@i-love.sakura.ne.jp>
37918 Thomas Hood <jdthood@gmail.com>
37919 Urs Thuermann <urs@isnogud.escape.de>
37920 Vasiliy Kulikov <segooon@gmail.com>
37921 Vegard Nossum <vegard.nossum@gmail.com>
37922 Weijie Yang <weijie.yang@samsung.com>
37923 William Woodruff <william@tuffbizz.com>
37924 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
37925
37926 Apologies if I missed anyone!
37927
37928
37929 New and rewritten pages
37930 -----------------------
37931
37932 get_phys_pages.3
37933 William Woodruff
37934 Document get_phys_pages() and get_avphys_pages()
37935
37936 loop.4
37937 Urs Thuermann, Michael Kerrisk
37938 New page documenting the loop device
37939
37940 xattr.7
37941 Andreas Gruenbacher
37942 Import attr(5) man page from the 'attr' project
37943 After discussions with Andreas Gruenbacher, it makes sense to
37944 move this page into man-pages, since it mostly relates to
37945 kernel details. Since this is an overview page,
37946 we'll move it to Section 7.
37947 Michael Kerrisk
37948 Rename page
37949 "xattr" is a more meaningful name than "attr" (it resonates
37950 with the names of the system calls), so as long as we are
37951 moving the page to a new section, we'll change the name as well,
37952 and retain an acl(5) link so that old references remain valid.
37953
37954
37955 Newly documented interfaces in existing pages
37956 ---------------------------------------------
37957
37958 mmap.2
37959 Michael Kerrisk [Andi Kleen]
37960 Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
37961
37962 shmget.2
37963 Michael Kerrisk [Andi Kleen]
37964 Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
37965
37966 resolver.3
37967 Michael Kerrisk [Jonathan Nieder]
37968 Add descriptions of some other resolver functions
37969 Add res_ninit(), res_nquery(), res_nsearch(),
37970 and res_nquerydomain(), res_nmkquery(), res_nsend().
37971
37972 tty_ioctl.4
37973 Frédéric Maria [Stephane Fillod, Andreas Heiduk]
37974 Document TIOCMIWAIT and TIOCGICOUNT
37975 Michael Kerrisk
37976 Document TIOCGEXCL
37977 Michael Kerrisk
37978 Document TIOGCPKT
37979 Michael Kerrisk
37980 Document TIOCSPTLCK
37981 Michael Kerrisk
37982 Document TIOCGPTLCK
37983
37984
37985 New and changed links
37986 ---------------------
37987
37988 CMSG_DATA.3
37989 Michael Kerrisk
37990 New link to cmsg(3)
37991
37992 CMSG_LEN.3
37993 Michael Kerrisk
37994 New link to cmsg(3)
37995
37996 dprintf.3
37997 Michael Kerrisk
37998 Convert to a link to printf.3
37999
38000 get_avphys_pages.3
38001 William Woodruff
38002 New link to new get_phys_pages.3 page
38003
38004 res_ninit.3
38005 res_nmkquery.3
38006 res_nquery.3
38007 res_nquerydomain.3
38008 res_nsearch.3
38009 res_nsend.3
38010 Michael Kerrisk
38011 New links to resolver(3) man page
38012
38013 loop-control.4
38014 Michael Kerrisk
38015 New link to loop.4
38016
38017 attr.5
38018 Michael Kerrisk
38019 New link to xattr(7)
38020
38021
38022 Global changes
38023 --------------
38024
38025 chown.2
38026 execve.2
38027 prctl.2
38028 truncate.2
38029 proc.5
38030 capabilities.7
38031 ld.so.8
38032 Michael Kerrisk
38033 Tighter wording: 'mode bit' rather than 'permission bit'
38034 For sticky, set-UID, and set-GID mode bits (as used in POSIX).
38035
38036
38037 Changes to individual pages
38038 ---------------------------
38039
38040 add_key.2
38041 keyctl.2
38042 request_key.2
38043 Michael Kerrisk
38044 SEE ALSO: add keyrings(7)
38045
38046 add_key.2
38047 request_key.2
38048 Michael Kerrisk
38049 SEE ALSO: add keyctl(3)
38050
38051 epoll_ctl.2
38052 Michael Kerrisk
38053 After EPOLLHUP, EOF will be seen only after all data has been consumed
38054
38055 epoll_wait.2
38056 Michael Kerrisk
38057 Clarify that signal mask treatment in epoll_pwait() is per-thread
38058 s/sigprocmask()/pthread_sigmask()/
38059
38060 fcntl.2
38061 Michael Kerrisk [Vegard Nossum]
38062 Note an F_SETSIG corner case
38063
38064 get_mempolicy.2, set_mempolicy
38065 Brice Goglin
38066 Policy is per thread, not per process
38067
38068 getxattr.2
38069 listxattr.2
38070 removexattr.2
38071 setxattr.2
38072 capabilities.7
38073 Michael Kerrisk
38074 Adjust "attr(5)" references to "xattr(7)"
38075
38076 ioctl.2
38077 Michael Kerrisk
38078 SEE ALSO: add console_ioctl(2) and tty_ioctl(2)
38079
38080 listxattr.2
38081 xattr.7
38082 Michael Kerrisk
38083 Describe listxattr(2) E2BIG error and document it as a BUG
38084
38085 mkdir.2
38086 Michael Kerrisk
38087 Wording fixes + point reader at stat(2) for explanation of file mode
38088 Michael Kerrisk [Andreas Grünbacher]
38089 Further tweaks to text on S_ISVTX and 'mode' argument
38090
38091 mknod.2
38092 Michael Kerrisk
38093 Rewordings + point reader at stat(2) for details of mode bits
38094
38095 mmap.2
38096 Michael Kerrisk
38097 Remove text that implies that munmap() syncs MAP_SHARED mapping to file
38098 The existing text in this page:
38099
38100 MAP_SHARED Share this mapping. Updates to the mapping
38101 are visible to other processes that map this
38102 file, and are carried through to the underly‐
38103 ing file. The file may not actually be
38104 updated until msync(2) or munmap() is called.
38105
38106 implies that munmap() will sync the mapping to the underlying
38107 file. POSIX doesn't require this, and some light reading of the
38108 code and some light testing (fsync() after munmap() of a large
38109 file) also indicates that Linux doesn't do this.
38110
38111 msync.2
38112 Michael Kerrisk
38113 Rework text of DESCRIPTION
38114 Rewrite the text somewhat, for easier comprehension.
38115 No (intentional) changes to factual content
38116
38117 nfsservctl.2
38118 Michael Kerrisk [J. Bruce Fields]
38119 Note that nfsservctl() was replaced by files in nfsd filesystem
38120
38121 open.2
38122 Michael Kerrisk [Andreas Gruenbacher]
38123 open() honors the S_ISVTX, S_ISUID, and S_ISGID bits in 'mode'
38124 Michael Kerrisk
38125 Tighten wording: use 'mode bit' rather than 'permission bit'
38126 Michael Kerrisk [NeilBrown]
38127 BUGS: O_CREAT | O_DIRECTORY succeeds if pathname does not exist
38128
38129 poll.2
38130 Michael Kerrisk [Ian Pilcher]
38131 Clarify that signal mask treatment in ppoll() is per-thread
38132 s/sigprocmask()/pthread_sigmask()/
38133 Michael Kerrisk [Sam Varshavchik]
38134 After POLLHUP, EOF will be seen only after all data has been consumed
38135 Michael Kerrisk
38136 Make it clearer which bits are ignored in 'events'
38137
38138 prctl.2
38139 Michael Kerrisk [David Wilcox, Filipe Brandenburger]
38140 Note that "parent" for purposes of PR_SET_DEATHSIG is a *thread*
38141 See https://bugzilla.kernel.org/show_bug.cgi?id=43300
38142
38143 sendfile.2
38144 Michael Kerrisk [Jason Newton]
38145 Note that sendfile does not support O_APPEND for 'out_fd'
38146 See https://bugzilla.kernel.org/show_bug.cgi?id=82841
38147 Michael Kerrisk [Gregor Jasny]
38148 RETURN VALUE: note the possibility of "short sends"
38149 See https://bugzilla.kernel.org/show_bug.cgi?id=97491
38150 Michael Kerrisk [Askar Safin]
38151 Clarify text on 'out_fd' and regular files in Linux 2.4
38152 See https://bugzilla.kernel.org/show_bug.cgi?id=86001
38153
38154 shutdown.2
38155 Michael Kerrisk [Stéphane Aulery]
38156 BUGS: UNIX domain sockets now detect invalid 'how' values
38157 Bug fixed in Linux 3.7.
38158 See https://bugzilla.kernel.org/show_bug.cgi?id=47111
38159
38160 sigaction.2
38161 Michael Kerrisk
38162 Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
38163
38164 stat.2
38165 Jann Horn
38166 Add note about stat() being racy
38167 Andreas Gruenbacher
38168 Improve description of some mode constants
38169 Michael Kerrisk [Andreas Grünbacher]
38170 Remove excessive leading zeros on some constants
38171 Michael Kerrisk
38172 Add text on POSIX terms "file mode bits" and "file permission bits"
38173 Recent changes to various pages employ this distinction.
38174 Michael Kerrisk
38175 Tighten wording: use 'mode bit' rather than 'permission bit'
38176 According to POSIX, the 9 UGO*RWX bits are permissions, and
38177 'mode' is used to refer to collectively to those bits plus sticky,
38178 set-UID, and set_GID bits.
38179
38180 syslog.2
38181 Michael Kerrisk
38182 SEE ALSO: add dmesg(1)
38183
38184 umask.2
38185 open.2
38186 mknod.2
38187 mkdir.2
38188 Andreas Gruenbacher
38189 Explain what default ACLs do
38190 Explain the effect that default ACLs have (instead of the umask)
38191 in umask.2. Mention that default ACLs can have an affect in
38192 open.2, mknod.2, and mkdir.2.
38193
38194 unshare.2
38195 Michael Kerrisk [Florian Weimer]
38196 Give the reader a hint that unshare() works on processes or threads
38197 See https://bugzilla.kernel.org/show_bug.cgi?id=59281
38198
38199 atexit.3
38200 Zeng Linggang
38201 ATTRIBUTES: Note function that is thread-safe
38202
38203 bsearch.3
38204 Zeng Linggang
38205 ATTRIBUTES: Note function that is thread-safe
38206
38207 cmsg.3
38208 Michael Kerrisk [Christopher Head]
38209 Fix error in SCM_RIGHTS code sample
38210 Remove erroneous second initialization of msg.msg_controllen
38211 in the example code for SCM_RIGHTS.
38212 See https://bugzilla.kernel.org/show_bug.cgi?id=15952
38213
38214 CPU_SET.3
38215 Chris Metcalf
38216 Clarify language about "available" cpus
38217 The CPU_SET.3 man page uses the adjective "available" when
38218 explaining what the argument to CPU_SET() means. This is
38219 confusing, since "available" isn't well-defined. The kernel
38220 has a set of adjectives (possible, present, online, and active)
38221 that qualify cpus, but normally none of these are what the
38222 cpu_set_t bit index means: it's just "which cpu", using the
38223 kernel's internal numbering system, even if that cpu isn't
38224 possible or present.
38225
38226 This change removes the word "available" and adds a sentence
38227 warning that cpu sets may not be contiguous due to dynamic
38228 cpu hotplug, etc.
38229
38230 err.3
38231 Zeng Linggang
38232 ATTRIBUTES: Note functions that are thread-safe
38233
38234 ftw.3
38235 Zeng Linggang
38236 ATTRIBUTES: Note functions that are thread-safe
38237
38238 gethostbyname.3
38239 Carlos O'Donell
38240 NSS plugins searched first
38241 Carlos O'Donell
38242 "order" is obsolete
38243
38244 gethostid.3
38245 Zeng Linggang
38246 ATTRIBUTES: Note functions that are/aren't thread-safe
38247
38248 getmntent.3
38249 Zeng Linggang
38250 ATTRIBUTES: Note functions that are/aren't thread-safe
38251
38252 get_nprocs_conf.3
38253 Michael Kerrisk
38254 Use exit() rather than return in main()
38255
38256 getopt.3
38257 Michael Kerrisk [Guy Harris]
38258 Remove crufty BUGS section
38259 See https://bugzilla.kernel.org/show_bug.cgi?id=90261
38260
38261 iconv_close.3
38262 Zeng Linggang
38263 ATTRIBUTES: Note function that is thread-safe
38264
38265 inet_ntop.3
38266 Zeng Linggang
38267 ATTRIBUTES: Note function that is thread-safe
38268
38269 longjmp.3
38270 Zeng Linggang
38271 ATTRIBUTES: Note functions that are thread-safe
38272
38273 lsearch.3
38274 Zeng Linggang
38275 ATTRIBUTES: Note functions that are thread-safe
38276
38277 mcheck.3
38278 Zeng Linggang
38279 ATTRIBUTES: Note functions that aren't thread-safe
38280
38281 on_exit.3
38282 Zeng Linggang
38283 ATTRIBUTES: Note function that is thread-safe
38284
38285 printf.3
38286 Michael Kerrisk [Egmont Koblinger]
38287 Merge dprintf() and vdprintf() discussion into this page
38288 Michael Kerrisk
38289 SEE ALSO: add puts(3)
38290 Michael Kerrisk
38291 Move return value discussion to proper RETURN VALUE section
38292
38293 putpwent.3
38294 Zeng Linggang
38295 ATTRIBUTES: Note function that is thread-safe
38296
38297 qsort.3
38298 Zeng Linggang
38299 ATTRIBUTES: Note functions that are thread-safe
38300
38301 regex.3
38302 Michael Kerrisk [Laurence Gonsalves]
38303 Fix error in description of 'cflags'
38304 'cflags' is a bit mask of *zero* (not one) or more flags.
38305
38306 resolver.3
38307 Stéphane Aulery
38308 Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
38309
38310 scanf.3
38311 Joern Heissler
38312 Improve description of %n specifier
38313
38314 setjmp.3
38315 Zeng Linggang
38316 ATTRIBUTES: Note functions that are thread-safe
38317
38318 setlocale.3
38319 Zeng Linggang
38320 ATTRIBUTES: Note function that isn't thread-safe
38321
38322 setlogmask.3
38323 Zeng Linggang
38324 ATTRIBUTES: Note function that isn't thread-safe
38325
38326 sleep.3
38327 Zeng Linggang
38328 ATTRIBUTES: Note function that isn't thread-safe
38329
38330 strsignal.3
38331 Zeng Linggang
38332 ATTRIBUTES: Note function that isn't thread-safe
38333
38334 sysconf.3
38335 Zeng Linggang
38336 ATTRIBUTES: Note function that is thread-safe
38337
38338 undocumented.3
38339 William Woodruff
38340 Remove documented functions
38341
38342 tty_ioctl.4
38343 Michael Kerrisk [Denis Du]
38344 Fix error in code example
38345
38346 proc.5
38347 Michael Kerrisk [Cameron Norman, Vasiliy Kulikov]
38348 Document /proc mount options
38349 Document the 'hidepid' and 'gid' mount options that were added in
38350 Linux 3.3. See https://bugzilla.kernel.org/show_bug.cgi?id=90641
38351 Based on text by Vasiliy Kulikov in
38352 Documentation/filesystems/proc.txt.
38353 Michael Kerrisk [Kirill A. Shutemov]
38354 Improve description of /proc/PID/status
38355 Guillem Jover
38356 Document /proc/PID/exe behaviour on unlinked pathnames
38357 Michael Kerrisk [Weijie Yang]
38358 Document /proc/PID/status VmPMD
38359
38360 resolv.conf.5
38361 Stéphane Aulery [Thomas Hood]
38362 Document use-vc option added to glibc 2.14
38363 Fix Ubuntu bug #1110781:
38364 https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
38365 Stéphane Aulery [Thomas Hood]
38366 Document RES_SNGLKUPREOP
38367 Fix Ubuntu bug #1110781:
38368 https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/1110781
38369
38370 tzfile.5
38371 Sam Varshavchik
38372 Add various details on version 2 format
38373
38374 aio.7
38375 Michael Kerrisk
38376 Add details and update URL for OLS 2003 paper on AIO
38377
38378 bootparam.7
38379 Michael Kerrisk [Alain Kalker]
38380 Update discussion of 'debug' option
38381 See https://bugzilla.kernel.org/show_bug.cgi?id=97161
38382 Michael Kerrisk
38383 Summary of multiple changes: remove cruft from this page.
38384 Much of the detail on hardware specifics in this page dates
38385 from the 20th century. (The last major update to this page was in
38386 man-pages-1.14!) It's hugely out of date now (many of these
38387 devices disappeared from the kernel years ago.) So, I've taken
38388 a large scythe to the page to remove anything that looks
38389 seriously dated. In the process, the page has shrunk to less
38390 than 50% of its previous size.
38391 Michael Kerrisk
38392 Remove "buff=" details
38393 This seems to have gone away in Linux 2.2.
38394 Michael Kerrisk
38395 Remove crufty "Mouse drivers" options
38396 Michael Kerrisk
38397 Remove crufty "General non-device-specific boot arguments" options
38398 Michael Kerrisk
38399 Remove crufty "Hard disks" options
38400 Michael Kerrisk
38401 Remove crufty "mem=" details
38402 Michael Kerrisk
38403 Remove crufty details on IBM MCA bus devices
38404 Michael Kerrisk
38405 Remove 'swap=" details
38406 This seems to have gone away in Linux 2.2,
38407 Michael Kerrisk
38408 Remove crufty floppy disk driver options
38409 In the specific case of floppy drives: the drivers still
38410 exist, but it's been a while since most of saw these devices
38411 in the wild. So, just refer the reader to the kernel source
38412 file for details. (The detail in this man page was after all
38413 originally drawn from that file.)
38414 Remove crufty "ISDN drivers" options
38415 Michael Kerrisk
38416 Remove crufty "line printer driver" options
38417 Michael Kerrisk
38418 Remove crufty "Serial port drivers" options
38419 Michael Kerrisk
38420 Remove crufty reference to CONFIG_BUGi386
38421 That option disappeared in Linux 2.4.
38422 Michael Kerrisk
38423 Remove crufty text
38424 "bootsetups array" dates from Linux 2.0.
38425 Michael Kerrisk
38426 Remove crufty "Video hardware" options
38427 Michael Kerrisk
38428 Remove crufty SCSI device driver options
38429
38430 fanotify.7
38431 Michael Kerrisk [Heinrich Schuchardt]
38432 Since Linux 3.19, fallocate(2) generates FAN_MODIFY events
38433
38434 inotify.7
38435 Michael Kerrisk [Heinrich Schuchardt]
38436 Since Linux 3.19, fallocate(2) generates IN_MODIFY events
38437
38438 ip.7
38439 Michael Kerrisk
38440 Explain how IP_ADD_MEMBERSHIP determines its argument type
38441 Michael Kerrisk [Jiri Pirko, Magnus REFTEL]
38442 Clarify details of the IP_MULTICAST_IF socket option
38443 Michael Kerrisk [Advait Dixi]
38444 Remove dubious text that says that SO_PRIORITY sets IP TOS
38445 See https://bugzilla.kernel.org/show_bug.cgi?id=35852
38446 Michael Kerrisk
38447 Relocate misplaced text describing ENOPROTOOPT error
38448
38449 packet.7
38450 Graham Shaw
38451 Add sll_protocol to list of required fields for outbound packets
38452
38453 pthreads.7
38454 Michael Kerrisk [KOSAKI Motohiro]
38455 Using thread IDs whose lifetime has expired gives undefined behavior
38456 See https://bugzilla.kernel.org/show_bug.cgi?id=53061
38457
38458 raw.7
38459 Michael Kerrisk [Tetsuo Handa]
38460 For incoming datagrams, sin_port is set to zero
38461 Michael Kerrisk
38462 Mention sendto(), recvfrom(), and so on when discussing address format
38463 This gives the reader a little context for the following
38464 discussion of 'sin_port'.
38465 Michael Kerrisk
38466 Remove crufty reference to <netinet/in.h>
38467 Michael Kerrisk
38468 Replace reference to RFC 1700 with pointer to IANA protocol number list
38469
38470 signal.7
38471 Michael Kerrisk [Steinar H. Gunderson]
38472 Clarify that I/O operations on disks are not interrupted by signals
38473 See https://bugzilla.kernel.org/show_bug.cgi?id=97721
38474
38475 unix.7
38476 Michael Kerrisk [Christophe Lohr]
38477 Remove mention of UNIX_PATH_MAX
38478 This kernel constant is not exposed to user space.
38479 Michael Kerrisk
38480 Note the 108 bytes for sun_path is how things are done on Linux
38481 And refer the reader to NOTES for discussion of portability.
38482
38483 xattr.7
38484 Michael Kerrisk
38485 Document EA limits for Btrfs
38486 Michael Kerrisk
38487 Document VFS-imposed limits on EAs
38488 VFS imposes a 255-byte limit on EA names, and a 64kB limit on
38489 EA values.
38490 Michael Kerrisk
38491 The ext[234] block limitation applies to sum of all EAs
38492 It is not a per-EA limit.
38493 Michael Kerrisk
38494 Clarify permissions required to work with 'user' EAs
38495 Michael Kerrisk
38496 ext2 and ext3 no longer need mounting with 'user_xattr' for user EAs
38497 Michael Kerrisk
38498 Add various relevant pages to SEE ALSO
38499 Michael Kerrisk
38500 Add CONFORMING TO section
38501 Michael Kerrisk
38502 Modify headings to man-pages norms
38503 Michael Kerrisk
38504 Btrfs also supports extended attributes
38505 Michael Kerrisk
38506 File capabilities are implemented using *security* attributes
38507 Not *system* attributes
38508 Michael Kerrisk
38509 Describe limit on EA values for JFS, XFS, and Reiserfs
38510 Michael Kerrisk
38511 Explicitly mention some of the xattr system calls in DESCRIPTION
38512 Naming the system calls helps to orient the reader
38513
38514 nscd.8
38515 Michael Kerrisk
38516 Add mention of 'services' and 'netgroup' databases
38517 This makes the page consistent with nscd.conf(5).
38518
38519
38520 ==================== Changes in man-pages-4.01 ====================
38521
38522 Released: 2015-07-23, Munich
38523
38524
38525 Contributors
38526 ------------
38527
38528 The following people contributed patches/fixes or (noted in brackets
38529 in the changelog below) reports, notes, and ideas that have been
38530 incorporated in changes in this release:
38531
38532 Alexei Starovoitov <ast@plumgrid.com>
38533 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
38534 Arjun Shankar <arjun@redhat.com>
38535 Ashish Sangwan <a.sangwan@samsung.com>
38536 Ben Woodard <woodard@redhat.com>
38537 Carlos O'Donell <carlos@redhat.com>
38538 Christoph Thompson <cjsthompson@gmail.com>
38539 Cortland Setlow <cortland.setlow@gmail.com>
38540 Daniel Borkmann <daniel@iogearbox.net>
38541 David Leppik <dleppik@vocalabs.com>
38542 Dilyan Palauzov <dilyan.palauzov@aegee.org>
38543 Doug Klima <cardoe@gentoo.org>
38544 Eric B Munson <emunson@akamai.com>
38545 Florian Weimer <fweimer@redhat.com>
38546 Hack NDo <hackndo@gmail.com>
38547 Jann Horn <jann@thejh.net>
38548 Jens Axboe <axboe@fb.com>
38549 Jian Wen <wenjianhn@gmail.com>
38550 Joerg Roedel <jroedel@suse.de>
38551 Julian Orth <ju.orth@gmail.com>
38552 Kees Cook <keescook@chromium.org>
38553 Laszlo Ersek <lacos@caesar.elte.hu>
38554 Marko Myllynen <myllynen@redhat.com>
38555 Mehdi Aqadjani Memar <m.aqadjanimemar@student.vu.nl>
38556 Michael Kerrisk <mtk.manpages@gmail.com>
38557 Michal Hocko <mhocko@suse.cz>
38558 Mike Frysinger <vapier@gentoo.org>
38559 Mike Hayward <hayward@loup.net>
38560 Miklos Szeredi <miklos@szeredi.hu>
38561 Namhyung Kim <namhyung@gmail.com>
38562 Namjae Jeon <namjae.jeon@samsung.com>
38563 Nathan Lynch <nathan_lynch@mentor.com>
38564 NeilBrown <neilb@suse.de>
38565 Pádraig Brady <P@draigBrady.com>
38566 Pavel Machek <pavel@ucw.cz>
38567 Peter Hurley <peter@hurleysoftware.com>
38568 Sam Varshavchik <mrsam@courier-mta.com>
38569 Scot Doyle <lkml14@scotdoyle.com>
38570 Stephan Mueller <stephan.mueller@atsec.com>
38571 Tobias Stoeckmann <tobias@stoeckmann.org>
38572 Tulio Magno Quites Machado Filho <tuliom@linux.vnet.ibm.com>
38573 Uwe Kleine-König <uwe+debian@kleine-koenig.org>
38574 Vegard Nossum <vegard.nossum@oracle.com>
38575 Ville Skyttä <ville.skytta@iki.fi>
38576 Vince Weaver <vincent.weaver@maine.edu>
38577 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
38578 文剑 <wenjianhn@gmail.com>
38579
38580 Apologies if I missed anyone!
38581
38582
38583 New and rewritten pages
38584 -----------------------
38585
38586 bpf.2
38587 Alexei Starovoitov, Michael Kerrisk [Daniel Borkmann]
38588 New page documenting bpf(2)
38589
38590 __ppc_get_timebase.3
38591 Tulio Magno Quites Machado Filho
38592 New page documenting __ppc_get_timebase() and __ppc_get_timebase_freq()
38593 Glibc 2.16 was released with a new function for the Power
38594 architecture that can read its Time Base Register.
38595 Glibc 2.17 adds a function to read the frequency at which the Time
38596 Base Register of Power processors is updated.
38597
38598 queue.3
38599 Michael Kerrisk [David Leppik, Doug Klima]
38600 Reimport from latest FreeBSD page
38601 Long ago, Doug Klima noted that many macros were not
38602 documented in the queue(3) page. Fix by reimporting from
38603 latest [1] FreeBSD man page.
38604
38605 [1] Revision 263142, Modified Fri Mar 14 03:07:51 2014 UTC
38606
38607 This also fixes https://sourceware.org/bugzilla/show_bug.cgi?id=1506
38608
38609 This time, I'll learn from past mistakes and not convert
38610 from 'mdoc' to 'man' macros.
38611 Michael Kerrisk
38612 Use subsections in DESCRIPTION
38613 Michael Kerrisk
38614 Remove SEE ALSO reference to nonexistent tree(3)
38615 Michael Kerrisk
38616 Use real hyphens in code samples
38617 Michael Kerrisk
38618 Comment out text for functions not in glibc
38619 Michael Kerrisk
38620 Replace HISTORY with CONFORMING TO
38621
38622
38623 Newly documented interfaces in existing pages
38624 ---------------------------------------------
38625
38626 rename.2
38627 Michael Kerrisk [Miklos Szeredi]
38628 Document RENAME_WHITEOUT
38629 Heavily based on text by Miklos Szeredi.
38630
38631
38632 New and changed links
38633 ---------------------
38634
38635 __ppc_get_timebase_freq.3
38636 Tulio Magno Quites Machado Filho
38637 New link to new __ppc_get_timebase(3) page
38638
38639 LIST_EMPTY.3
38640 LIST_FIRST.3
38641 LIST_FOREACH.3
38642 LIST_HEAD_INITIALIZER.3
38643 LIST_INSERT_BEFORE.3
38644 LIST_NEXT.3
38645 SLIST_EMPTY.3
38646 SLIST_ENTRY.3
38647 SLIST_FIRST.3
38648 SLIST_FOREACH.3
38649 SLIST_HEAD.3
38650 SLIST_HEAD_INITIALIZER.3
38651 SLIST_INIT.3
38652 SLIST_INSERT_AFTER.3
38653 SLIST_INSERT_HEAD.3
38654 SLIST_NEXT.3
38655 SLIST_REMOVE.3
38656 SLIST_REMOVE_HEAD.3
38657 STAILQ_CONCAT.3
38658 STAILQ_EMPTY.3
38659 STAILQ_ENTRY.3
38660 STAILQ_FIRST.3
38661 STAILQ_FOREACH.3
38662 STAILQ_HEAD.3
38663 STAILQ_HEAD_INITIALIZER.3
38664 STAILQ_INIT.3
38665 STAILQ_INSERT_AFTER.3
38666 STAILQ_INSERT_HEAD.3
38667 STAILQ_INSERT_TAIL.3
38668 STAILQ_NEXT.3
38669 STAILQ_REMOVE.3
38670 STAILQ_REMOVE_HEAD.3
38671 TAILQ_CONCAT.3
38672 TAILQ_EMPTY.3
38673 TAILQ_FIRST.3
38674 TAILQ_FOREACH.3
38675 TAILQ_FOREACH_REVERSE.3
38676 TAILQ_HEAD_INITIALIZER.3
38677 TAILQ_INSERT_BEFORE.3
38678 TAILQ_LAST.3
38679 TAILQ_NEXT.3
38680 TAILQ_PREV.3
38681 TAILQ_SWAP.3
38682 Michael Kerrisk
38683 New links to queue.3
38684
38685
38686 Global changes
38687 --------------
38688
38689 Various pages
38690 Michael Kerrisk [Andries E. Brouwer]
38691 Remove "ABI" from "C library/kernel ABI differences" subheadings
38692 The "ABI" doesn't really convey anything significant in
38693 the title. These subsections are about describing differences
38694 between the kernel and (g)libc interfaces.
38695
38696
38697 Changes to individual pages
38698 ---------------------------
38699
38700 intro.1
38701 Michael Kerrisk [Andries E. Brouwer]
38702 Drop intro paragraph on '$?' shell variable
38703 As Andries notes, this piece of text is rather out of place in
38704 a page that was intended to provide a tutorial introduction for
38705 beginners logging in on a Linux system.
38706
38707 locale.1
38708 Marko Myllynen
38709 A minor output format clarification
38710 A minor clarification for the locale output format which was
38711 brought up at
38712 https://sourceware.org/bugzilla/show_bug.cgi?id=18516.
38713
38714 For reference, see
38715 https://sourceware.org/bugzilla/show_bug.cgi?id=18516
38716 http://pubs.opengroup.org/onlinepubs/9699919799/utilities/locale.html
38717
38718 Add CONFORMING TO section
38719
38720 capget.2
38721 Julian Orth
38722 Clarify that hdrp->pid==0 is equivalent gettid() not getpid()
38723
38724 chroot.2
38725 Jann Horn
38726 chroot() is not intended for security; document attack
38727 It is unfortunate that this discourages this use of chroot(2)
38728 without pointing out alternative solutions - for example,
38729 OpenSSH and vsftpd both still rely on chroot(2) for security.
38730
38731 Bind mounts should theoretically be usable as a replacement, but
38732 currently, they have a similar problem (CVE-2015-2925) that hasn't
38733 been fixed in ~6 months, so I'd rather not add it to the manpage
38734 as a solution before a fix lands.
38735
38736 clock_getres.2
38737 Zeng Linggang
38738 ATTRIBUTES: Note functions that are thread-safe
38739
38740 eventfd.2
38741 Zeng Linggang
38742 ATTRIBUTES: Note function that is thread-safe
38743
38744 execve.2
38745 Michael Kerrisk
38746 Elaborate on envp/argv as NULL behavior
38747
38748 _exit.2
38749 Michael Kerrisk
38750 Open stdio frames are not flushed, temporary files are deleted
38751 Many years ago, text was added to the page saying that it is
38752 implementation-dependent whether stdio streams are flushed and
38753 whether temporary are removed. In part, this change appears to
38754 be because POSIX.1-2001 added text related to this point.
38755 However, that seems to have been an error in POSIX, and the
38756 text was subsequently removed for POSIX.1-2008. See
38757 https://collaboration.opengroup.org/austin/interps/documents/9984/AI-085.txt
38758 Austin Group Interpretation reference 1003.1-2001 #085
38759
38760 fallocate.2
38761 Namjae Jeon [Michael Kerrisk]
38762 Document FALLOC_FL_INSERT_RANGE
38763 Michael Kerrisk
38764 Since Linux 4.2, ext4 supports FALLOC_FL_INSERT_RANGE
38765
38766 fcntl.2
38767 Michael Kerrisk
38768 OFD locks are proposed for inclusion in the next POSIX revision
38769
38770 getrlimit.2
38771 Zeng Linggang
38772 ATTRIBUTES: Note functions that are thread-safe
38773
38774 getrusage.2
38775 Zeng Linggang
38776 ATTRIBUTES: Note function that is thread-safe
38777
38778 gettid.2
38779 Michael Kerrisk
38780 Note that for a thread group leader, gettid() == getpid()
38781
38782 iopl.2
38783 Michael Kerrisk
38784 Remove some historical libc5 and glibc 1 details
38785 These details are ancient, and long ago ceased to be relevant.
38786
38787 ioprio_set.2
38788 Michael Kerrisk [Jens Axboe]
38789 Document meaning of ioprio==0
38790
38791 mlock.2
38792 Michael Kerrisk [Mehdi Aqadjani Memar]
38793 Document another ENOMEM error case
38794 ENOMEM can occur if locking/unlocking in the middle of a region
38795 would increase the number of VMAs beyond the system limit (64k).
38796
38797 mmap.2
38798 Michal Hocko [Eric B Munson]
38799 Clarify MAP_POPULATE
38800 David Rientjes has noticed that MAP_POPULATE wording might promise
38801 much more than the kernel actually provides and intends to provide.
38802 The primary usage of the flag is to pre-fault the range. There is
38803 no guarantee that no major faults will happen later on. The pages
38804 might have been reclaimed by the time the process tries to access
38805 them.
38806 Michal Hocko [Eric B Munson]
38807 Clarify MAP_LOCKED semantics
38808 MAP_LOCKED had a subtly different semantic from mmap(2)+mlock(2)
38809 since it has been introduced.
38810 mlock(2) fails if the memory range cannot get populated to
38811 guarantee that no future major faults will happen on the range.
38812 mmap(MAP_LOCKED) on the other hand silently succeeds even if
38813 the range was populated only partially.
38814
38815 Fixing this subtle difference in the kernel is rather awkward
38816 because the memory population happens after mm locks have been
38817 dropped and so the cleanup before returning failure (munlock)
38818 could operate on something else than the originally mapped area.
38819
38820 E.g. speculative userspace page fault handler catching SEGV and
38821 doing mmap(fault_addr, MAP_FIXED|MAP_LOCKED) might discard portion
38822 of a racing mmap and lead to lost data. Although it is not clear
38823 whether such a usage would be valid, mmap page doesn't explicitly
38824 describe requirements for threaded applications so we cannot
38825 exclude this possibility.
38826
38827 This patch makes the semantic of MAP_LOCKED explicit and suggests
38828 using mmap + mlock as the only way to guarantee no later major
38829 page faults.
38830 Michael Kerrisk
38831 ERRORS: point out that ENOMEM can occur even for munmap()
38832
38833 mprotect.2
38834 Michael Kerrisk
38835 Note ENOMEM error that can occur when we reach limit on maximum VMAs
38836
38837 open.2
38838 read.2
38839 write.2
38840 Michael Kerrisk [Mike Hayward]
38841 Clarify that O_NONBLOCK is a no-op for regular files and block devices
38842
38843 perf_event_open.2
38844 Vince Weaver [Joerg Roedel]
38845 Exclude_host/exclude_guest clarification
38846 This patch relates to the exclude_host and exclude_guest bits added
38847 by the following commit:
38848
38849 exclude_host, exclude_guest; Linux 3.2
38850 commit a240f76165e6255384d4bdb8139895fac7988799
38851 Author: Joerg Roedel <joerg.roedel@amd.com>
38852 Date: Wed Oct 5 14:01:16 2011 +0200
38853
38854 perf, core: Introduce attrs to count in either host or guest mode
38855
38856 The updated manpage text clarifies that the "exclude_host" and
38857 "exclude_guest" perf_event_open() attr bits only apply in the
38858 context of a KVM environment and are currently x86 only.
38859 Vince Weaver
38860 Document PERF_SAMPLE_REGS_INTR
38861 This patch relates to the addition of PERF_SAMPLE_REGS_INTR
38862 support added in the following commit:
38863
38864 perf_sample_regs_intr; Linux 3.19
38865 commit 60e2364e60e86e81bc6377f49779779e6120977f
38866 Author: Stephane Eranian <eranian@google.com>
38867
38868 perf: Add ability to sample machine state on interrupt
38869
38870 The primary difference between PERF_SAMPLE_REGS_INTR and the
38871 existing PERF_SAMPLE_REGS_USER is that the new support will
38872 return kernel register values. Also if precise_ip is
38873 set higher than 0 then the PEBS register state will be returned
38874 rather than the saved interrupt state.
38875
38876 This patch incorporates feedback from Stephane Eranian and
38877 Andi Kleen.
38878
38879 prctl.2
38880 seccomp.2
38881 Michael Kerrisk
38882 Clarify that SECCOMP_SET_MODE_STRICT disallows exit_group(2)
38883 These days, glibc implements _exit() as a wrapper around
38884 exit_group(2). (When seccomp was originally introduced, this was
38885 not the case.) Give the reader a clue that, despite what glibc is
38886 doing, what SECCOMP_SET_MODE_STRICT permits is the true _exit(2)
38887 system call, and not exit_group(2).
38888
38889 pread.2
38890 read.2
38891 readv.2
38892 sendfile.2
38893 write.2
38894 Michael Kerrisk
38895 Clarify that Linux limits transfers to a maximum of 0x7ffff000 bytes
38896 See https://bugs.debian.org/629994 and
38897 https://bugs.debian.org/630029.
38898
38899 pread.2
38900 Michael Kerrisk
38901 Rewrite RETURN VALUE section
38902 (Also drop the text on pwrite() returning zero; that seems bogus.)
38903
38904 ptrace.2
38905 Michael Kerrisk [Vegard Nossum]
38906 PTRACE_O_TRACEEXIT clarification
38907
38908 readv.2
38909 Michael Kerrisk
38910 Remove BUGS heading
38911 The text on mixing I/O syscalls and stdio is a general point
38912 of behavior. It's not a bug as such.
38913
38914 recv.2
38915 send.2
38916 Michael Kerrisk
38917 Explain some subtleties of MSG_DONTWAIT versus O_NONBLOCK
38918
38919 rename.2
38920 Michael Kerrisk
38921 Michael Kerrisk
38922 Note that RENAME_NOREPLACE can't be employed with RENAME_EXCHANGE
38923
38924 sched_setaffinity.2
38925 Michael Kerrisk
38926 Add an example program
38927 Michael Kerrisk [Florian Weimer]
38928 Explain how to deal with 1024-CPU limitation of glibc's cpu_set_t type
38929 Michael Kerrisk
38930 Mention the use of the 'isolcpus' kernel boot option
38931
38932 sched_setattr.2
38933 Julian Orth
38934 Remove a const attribute
38935 The attr argument of sched_setattr was documented as const but the
38936 kernel will modify the size field of this struct if it contains an
38937 invalid value. See the documentation of the size field for details.
38938
38939 seccomp.2
38940 Michael Kerrisk
38941 SEE ALSO: add bpf(2)
38942
38943 send.2
38944 Michael Kerrisk
38945 Expand on subtleties of MSG_NOSIGNAL versus ignoring SIGPIPE
38946
38947 sigaltstack.2
38948 Zeng Linggang
38949 ATTRIBUTES: Note function that is thread-safe
38950
38951 socket.2
38952 Stephan Mueller
38953 Update documentation reference for AF_ALG
38954
38955 truncate.2
38956 Michael Kerrisk
38957 ERRORS: ftruncate() can fail if the file descriptor is not writable
38958
38959 utimensat.2
38960 Zeng Linggang
38961 ATTRIBUTES: Note functions that are thread-safe
38962 After research, We think utimensat() and futimens() are thread-safe.
38963 But, there are not markings of utimensat() and futimens() in glibc
38964 document.
38965
38966 clearenv.3
38967 Zeng Linggang
38968 ATTRIBUTES: Note function that is not thread-safe
38969
38970 dl_iterate_phdr.3
38971 Zeng Linggang
38972 ATTRIBUTES: Note function that is thread-safe
38973
38974 error.3
38975 Zeng Linggang
38976 ATTRIBUTES: Note functions that are/aren't thread-safe
38977
38978 fexecve.3
38979 Zeng Linggang
38980 ATTRIBUTES: Note function that is thread-safe
38981
38982 fpurge.3
38983 Zeng Linggang
38984 ATTRIBUTES: Note function that is thread-safe
38985
38986 fread.3
38987 Andries E. Brouwer
38988 Clarify terminology
38989 In the "RETURN VALUE" section the word item is in italics
38990 as if it were one of the function parameters. But the word
38991 "item" occurs here for the first time, earlier the text
38992 uses "element". [Patch improves this.]
38993
38994 fts.3
38995 Zeng Linggang
38996 ATTRIBUTES: Note functions that are/aren't thread-safe
38997
38998 getaddrinfo.3
38999 Zeng Linggang
39000 ATTRIBUTES: Note functions that are thread-safe
39001
39002 getaddrinfo_a.3
39003 Zeng Linggang
39004 ATTRIBUTES: Note functions that are thread-safe
39005
39006 getauxval.3
39007 Michael Kerrisk
39008 File capabilities also trigger AT_SECURE
39009 Michael Kerrisk
39010 (Briefly) document AT_HWCAP2
39011
39012 getgrent_r.3
39013 Zeng Linggang
39014 ATTRIBUTES: Note functions that are/aren't thread-safe
39015
39016 gethostbyname.3
39017 Michael Kerrisk [Laszlo Ersek]
39018 Remove mention of IPv6 addresses, which are not supported
39019 As reported by Laszlo Ersek:
39020
39021 gethostbyname(3) fails to resolve the IPv6 address "::1",
39022 but the manual page says: "If name is an IPv4 or IPv6 address,
39023 no lookup is performed and gethostbyname() simply copies name
39024 into the h_name field [...]".
39025
39026 Debian bug report:
39027 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=455762
39028
39029 glibc bug report:
39030 http://sourceware.org/bugzilla/show_bug.cgi?id=5479
39031
39032 SUSv3 link for gethostbyname(3):
39033 http://www.opengroup.org/onlinepubs/000095399/functions/gethostbyname.html
39034
39035 It seems that the glibc behavior is conformant, and the manual
39036 page is in error.
39037
39038 getifaddrs.3
39039 Zeng Linggang
39040 ATTRIBUTES: Note functions that are thread-safe
39041
39042 getnameinfo.3
39043 Zeng Linggang
39044 ATTRIBUTES: Note function that is thread-safe
39045
39046 getnetent_r.3
39047 Zeng Linggang
39048 ATTRIBUTES: Note functions that are thread-safe
39049
39050 getprotoent.3
39051 Zeng Linggang
39052 ATTRIBUTES: Note functions that aren't thread-safe
39053
39054 getprotoent_r.3
39055 Zeng Linggang
39056 ATTRIBUTES: Note functions that are thread-safe
39057
39058 getpw.3
39059 Zeng Linggang
39060 ATTRIBUTES: Note function that is thread-safe
39061
39062 getpwent_r.3
39063 Zeng Linggang
39064 ATTRIBUTES: Note functions that are/aren't thread-safe
39065
39066 getrpcent.3
39067 Zeng Linggang
39068 ATTRIBUTES: Note functions that are/aren't thread-safe
39069
39070 getrpcent_r.3
39071 Zeng Linggang
39072 ATTRIBUTES: Note functions that are thread-safe
39073
39074 getrpcport.3
39075 Zeng Linggang
39076 ATTRIBUTES: Note function that is thread-safe
39077
39078 getservent.3
39079 Zeng Linggang
39080 ATTRIBUTES: Note functions that aren't thread-safe
39081
39082 getservent_r.3
39083 Zeng Linggang
39084 ATTRIBUTES: Note functions that are thread-safe
39085
39086 gsignal.3
39087 Zeng Linggang
39088 ATTRIBUTES: Note functions that are thread-safe
39089
39090 key_setsecret.3
39091 Zeng Linggang
39092 ATTRIBUTES: Note functions that are thread-safe
39093
39094 malloc_get_state.3
39095 Zeng Linggang
39096 ATTRIBUTES: Note functions that are thread-safe
39097
39098 malloc_info.3
39099 Zeng Linggang
39100 ATTRIBUTES: Note function that is thread-safe
39101
39102 malloc_stats.3
39103 Zeng Linggang
39104 ATTRIBUTES: Note function that is thread-safe
39105
39106 malloc_trim.3
39107 Zeng Linggang
39108 ATTRIBUTES: Note function that is thread-safe
39109
39110 MB_LEN_MAX.3
39111 Michael Kerrisk
39112 Clarify meaning of MB_LEN_MAX
39113 Michael Kerrisk [Pádraig Brady]
39114 MB_LEN_MAX is 16 in modern glibc versions
39115
39116 memcpy.3
39117 Michael Kerrisk
39118 NOTES: describe the glibc 2.13 changes that revealed buggy applications
39119 Adding a note on this point seems worthwhile as a way of
39120 emphasizing the point that the buffers must not overlap.
39121
39122 mq_notify.3
39123 Zeng Linggang
39124 ATTRIBUTES: Note function that is thread-safe
39125
39126 perror.3
39127 Michael Kerrisk
39128 Some wording improvements and clarifications
39129
39130 profil.3
39131 Zeng Linggang
39132 ATTRIBUTES: Note function that is not thread-safe
39133
39134 psignal.3
39135 Zeng Linggang
39136 ATTRIBUTES: Note functions that are thread-safe
39137
39138 pthread_attr_init.3
39139 Zeng Linggang
39140 ATTRIBUTES: Note functions that are thread-safe
39141 Michael Kerrisk
39142 Use "%zd" for printing size_t in example code
39143
39144 pthread_attr_setaffinity_np.3
39145 Zeng Linggang
39146 ATTRIBUTES: Note functions that are thread-safe
39147
39148 pthread_cancel.3
39149 Zeng Linggang
39150 ATTRIBUTES: Note function that is thread-safe
39151
39152 pthread_cleanup_push.3
39153 Zeng Linggang
39154 ATTRIBUTES: Note functions that are thread-safe
39155
39156 pthread_create.3
39157 Zeng Linggang
39158 ATTRIBUTES: Note function that is thread-safe
39159
39160 pthread_detach.3
39161 Zeng Linggang
39162 ATTRIBUTES: Note function that is thread-safe
39163
39164 pthread_getattr_np.3
39165 Zeng Linggang
39166 ATTRIBUTES: Note function that is thread-safe
39167
39168 pthread_join.3
39169 Zeng Linggang
39170 ATTRIBUTES: Note function that is thread-safe
39171
39172 pthread_setname_np.3
39173 Zeng Linggang
39174 ATTRIBUTES: Note functions that are thread-safe
39175
39176 pthread_tryjoin_np.3
39177 Zeng Linggang
39178 ATTRIBUTES: Note functions that are thread-safe
39179
39180 putgrent.3
39181 Zeng Linggang
39182 ATTRIBUTES: Note function that is thread-safe
39183
39184 rcmd.3
39185 Zeng Linggang
39186 ATTRIBUTES: Note functions that are/aren't thread-safe
39187
39188 resolver.3
39189 Zeng Linggang
39190 ATTRIBUTES: Note functions that are thread-safe
39191
39192 rpc.3
39193 Zeng Linggang
39194 ATTRIBUTES: Note functions that are thread-safe
39195
39196 rpmatch.3
39197 Zeng Linggang
39198 ATTRIBUTES: Note function that is thread-safe
39199
39200 sem_close.3
39201 Zeng Linggang
39202 ATTRIBUTES: Note function that is thread-safe
39203
39204 sem_open.3
39205 Zeng Linggang
39206 ATTRIBUTES: Note function that is thread-safe
39207
39208 setaliasent.3
39209 Zeng Linggang
39210 ATTRIBUTES: Note functions that are/aren't thread-safe
39211
39212 setlocale.3
39213 Marko Myllynen
39214 Update CONFORMING TO
39215 http://pubs.opengroup.org/onlinepubs/9699919799/functions/setlocale.html
39216
39217 setlocale.3
39218 Marko Myllynen
39219 Tweak C/POSIX locale portability description
39220 As discussed earlier, the current description might be a little
39221 bit too stringent, let's avoid the issue by describing the
39222 portability aspect on a slightly higher level.
39223
39224 References:
39225
39226 http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap06.html
39227 http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html
39228 http://pubs.opengroup.org/onlinepubs/9699919799/functions/setlocale.html
39229
39230 shm_open.3
39231 Zeng Linggang
39232 ATTRIBUTES: Note functions that are thread-safe
39233
39234 strfmon.3
39235 Marko Myllynen
39236 Document strfmon_l(3)
39237 Describe strfmon_l(3).
39238
39239 http://pubs.opengroup.org/onlinepubs/9699919799/functions/strfmon.html
39240 Marko Myllynen
39241 Fix CONFORMING TO
39242 AFAICS strfmon(3) is now defined in POSIX and the glibc
39243 implementation is as specified there.
39244
39245 http://pubs.opengroup.org/onlinepubs/9699919799/functions/strfmon.html
39246 Marko Myllynen
39247 Rewrite the example
39248 I think the example is more accurate when we use the exact
39249 locale names and also the Euro sign where appropriate.
39250
39251 xcrypt.3
39252 Zeng Linggang
39253 ATTRIBUTES: Note functions that are thread-safe
39254
39255 xdr.3
39256 Zeng Linggang
39257 ATTRIBUTES: Note functions that are thread-safe
39258
39259 console_codes.4
39260 Scot Doyle [Pavel Machek, Michael Kerrisk]
39261 Add CSI sequence for cursor blink interval
39262 Add a Console Private CSI sequence to specify the current
39263 console's cursor blink interval. The interval is specified
39264 as a number of milliseconds until the next cursor display
39265 state toggle, from 50 to 65535.
39266
39267 null.4
39268 Michael Kerrisk
39269 Note that reads from /dev/zero are interruptible since Linux 2.6.31
39270
39271 core.5
39272 Michael Kerrisk
39273 Mention 'coredump_filter' boot option
39274
39275 host.conf.5
39276 Michael Kerrisk
39277 Wording fix: s/resolv+/the resolver library/
39278 The term "resolv+" seems to be historical cruft.
39279
39280 hosts.equiv.5
39281 Carlos O'Donell
39282 Fix format, clarify IdM needs, and provide examples.
39283 In some recent work with a Red Hat customer I had the opportunity
39284 to discuss the fine nuances of the ruserok() function and related
39285 API which are used to implement rlogin and rsh.
39286
39287 It came to my attention after working with QE on some automated
39288 internal testing that there were no good examples in the hosts.equiv
39289 manual page showing how the format was supposed to work for this
39290 file and for ~/.rhosts, worse the "format" line showed that there
39291 should be spaces between arguments when that would clearly lead
39292 to incorrect behaviour. In addition some things that the format
39293 allows you to write are just wrong like "-host -user" which makes
39294 no sense since the host is already rejected, and should be written
39295 as "host -user" instead. I added notes in the example to make it
39296 clear that "-host -user" is invalid.
39297
39298 I fixed three things:
39299
39300 (a) The format line.
39301 - Either +, or [-]hostname, or +@netgrp or -@netgrp.
39302 - Either +, or [-]username, or +@netgrp or -@netgrp.
39303 - You must specify something in the hostname portion so remove
39304 optional brackets.
39305
39306 (b) Clarify language around credentials
39307 - If the host is not trusted you must provide credentials to
39308 the login system and that could be anything really and it
39309 depends on your configuration e.g. PAM or whatever IdM you have.
39310
39311 (c) Provide real-world examples
39312 - Provide several real world examples and some corner case
39313 examples for how you would write something. Hopefully others
39314 can add examples as they see fit.
39315 Michael Kerrisk [Carlos O'Donell, Arjun Shankar]
39316 Improve explanation in EXAMPLE
39317
39318 locale.5
39319 Marko Myllynen
39320 Document map to_inpunct, map to_outpunct
39321 See e.g. fa_IR for reference.
39322 Marko Myllynen
39323 Document class in LC_CTYPE
39324 See e.g. the locale zh_CN and
39325
39326 http://en.cppreference.com/w/cpp/string/wide/towctrans
39327 http://en.cppreference.com/w/cpp/string/wide/wctrans
39328 Marko Myllynen
39329 Add iconv(1) reference
39330 Marko Myllynen
39331 Document character transliteration
39332 See e.g. da_DK for reference.
39333
39334 (Not sure should we actually provide an example here?)
39335 Marko Myllynen
39336 Document era keywords
39337 This patch completes the LC_TIME section - since these era
39338 keywords are so tightly coupled, I'm providing them as a
39339 single patch.
39340
39341 Based on
39342 http://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap07.html
39343 http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
39344 Marko Myllynen
39345 Document default_missing
39346 Marko Myllynen
39347 Document outdigit and alt_digits
39348 See e.g. fa_IR for reference.
39349 Marko Myllynen
39350 Refer to locale(7) more prominently
39351 It's probably a good idea to refer to locale(7) so that a reader
39352 can check what a category is about before describing them in
39353 detail.
39354 Marko Myllynen
39355 Document charclass and charconv
39356 See e.g. the locales ja_JP and ko_KR and
39357
39358 http://en.cppreference.com/w/cpp/string/wide/towctrans
39359 http://en.cppreference.com/w/cpp/string/wide/wctrans
39360 Marko Myllynen
39361 Copy is not exclusive in LC_CTYPE and LC_COLLATE
39362 See e.g. da_DK for reference.
39363 Marko Myllynen
39364 Remove the FIXME for timezone
39365 The timezone of LC_TIME is not in POSIX, only 6 (out of ~300)
39366 glibc locales define it, the glibc code comment below from
39367 glibc.git/programs/ld-time.c seems to suggest it's not a good
39368 idea, and there's been a proposal in upstream [1] to remove the
39369 existing timezone definitions from glibc locales so I think
39370 it's actually better to leave this one undocumented:
39371
39372 /* XXX We don't perform any tests on the timezone value since this is
39373 simply useless, stupid $&$!@... */
39374
39375 1) https://sourceware.org/ml/libc-alpha/2015-06/msg00098.html
39376
39377 Move the remaining LC_COLLATE FIXMEs together while at it.
39378 Marko Myllynen
39379 Fix country_isbn format
39380 Both plain numbers and Unicode code points are used in
39381 glibc locales but checking the code reveals that country_isbn
39382 is handled like the rest of its category expect for country_num
39383 which was clarified earlier.
39384 Marko Myllynen
39385 Sort according to the standard
39386 Sort the options so that those defined in POSIX are listed first,
39387 then followed by those defined in ISO/IEC TR 14652 in the order
39388 of common convention in many widely used glibc locales.
39389
39390 Actual descriptions are unchanged.
39391
39392 http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap07.html
39393 Marko Myllynen
39394 Refer to strftime(3) where appropriate
39395 The relationship between the locale time format syntax
39396 and strftime() cannot be considered as obvious.
39397 Marko Myllynen
39398 Document map "totitle"
39399 See e.g. locales/i18n for reference.
39400 Michael Kerrisk [Marko Myllynen]
39401 Remove BUGS section saying man page is not complete
39402 To some degree, this is true of many pages. And anyway, this
39403 page is much better after recent work by Marko.
39404
39405 proc.5
39406 Michael Kerrisk
39407 List /proc/vmstat fields
39408 Michael Kerrisk
39409 Tweak /proc/vmstat text
39410 Michael Kerrisk
39411 Add /proc/crypto entry with a pointer to further information
39412 Michael Kerrisk [Kees Cook]
39413 Document /proc/sys/kernel/sysctl_writes_strict
39414 Based on text in Documentation/sysctl/kernel.txt.
39415 Michael Kerrisk
39416 Move misordered /proc/[pid]/timers entry
39417 Michael Kerrisk
39418 Refer to bpf(2) for explanation of /proc/sys/net/core/bpf_jit_enable
39419
39420 repertoiremap.5
39421 Marko Myllynen
39422 Symbolic names AKA mnemonics
39423 A long time ago in glibc, repertoire maps were used (but they
39424 were removed already in 2000), those mapping files were named
39425 as mnemonics, so "mnemonic" is a term that would almost
39426 certainly come up if somebody studies glibc side (perhaps even
39427 the related standards like ISO 9945 [which I don't have access
39428 to]) so I thought it's worth to mention to term in the man page
39429 to make sure we're talking about the same thing, otherwise
39430 someone might wonder is that something different or not.
39431
39432 IOW, symbolic names and mnemonics are often used interchangeably,
39433 let's mention the other often used term in the page, too.
39434
39435 capabilities.7
39436 Michael Kerrisk
39437 CAP_SYS_ADMIN allows calling bpf(2)
39438
39439 locale.7
39440 Marko Myllynen
39441 LC_CTYPE determines transliteration rules on glibc systems
39442
39443 packet.7
39444 文剑 [Cortland Setlow]
39445 Fix description of binding a packet socket to an interface
39446
39447 pty.7
39448 NeilBrown [Peter Hurley]
39449 Clarify asynchronous nature of PTY I/O
39450 A PTY is not like a pipe - there may be delayed between data
39451 being written at one end and it being available at the other.
39452
39453 This became particularly apparent after
39454 commit f95499c3030f
39455 ("n_tty: Don't wait for buffer work in read() loop")
39456 in Linux 3.12
39457
39458 See also the mail thread at https://lkml.org/lkml/2015/5/1/35
39459 Date Mon, 04 May 2015 12:32:04 -0400
39460 From Peter Hurley <>
39461 Subject Re: [PATCH bisected regression] input_available_p()
39462 sometimes says 'no' when it should say 'yes'
39463
39464 rtld-audit.7
39465 Ben Woodard
39466 Use correct printf() specifier for pointer types
39467 In the example code you used %x rather than %p in the example
39468 code for an audit library. The problem is that it truncates the
39469 pointers on 64b platforms. So you get something like:
39470
39471 la_symbind64(): symname = strrchr sym->st_value = 0x7f4b8a3f8960
39472 ndx = 222 flags = 0x0 refcook = 8b53e5c8 defcook = 8b537e30
39473
39474 rather than:
39475
39476 la_symbind64(): symname = fclose sym->st_value = 0x7fa452dd49b0
39477 ndx = 1135 flags = 0x0 refcook = 0x7fa453f395c8 defcook = 0x7fa453f32e30
39478
39479 This has bitten me a handful of times when playing around with
39480 audit test libraries to investigate its behavior.
39481
39482 sched.7
39483 Michael Kerrisk
39484 Remove ancient, wildly optimistic prediction about future of RT patches
39485 It seems the patches were not merged by 2.6.30...
39486
39487 socket.7
39488 Michael Kerrisk
39489 SEE ALSO: add bpf(2)
39490
39491 vdso.7
39492 Nathan Lynch [Mike Frysinger]
39493 Update for ARM
39494 The 32-bit ARM architecture in Linux has gained a vDSO as of the
39495 4.1 release. (I was the primary author.)
39496
39497 Document the symbols exported by the ARM VDSO.
39498
39499 Accepted kernel submission:
39500 http://lists.infradead.org/pipermail/linux-arm-kernel/2015-March/332573.html
39501
39502
39503 ==================== Changes in man-pages-4.02 ====================
39504
39505 Released: 2015-08-08, Munich
39506
39507
39508 Contributors
39509 ------------
39510
39511 The following people contributed patches/fixes or (noted in brackets
39512 in the changelog below) reports, notes, and ideas that have been
39513 incorporated in changes in this release:
39514
39515 Carlos O'Donell <carlos@redhat.com>
39516 Daniel Borkmann <daniel@iogearbox.net>
39517 David Rientjes <rientjes@google.com>
39518 Dilyan Palauzov <dilyan.palauzov@aegee.org>
39519 Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
39520 Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
39521 Goswin von Brederlow <goswin-v-b@web.de>
39522 Heinrich Schuchardt <xypron.glpk@gmx.de>
39523 Jonathan David Amery <jdamery@ysolde.ucam.org>
39524 Michael Kerrisk <mtk.manpages@gmail.com>
39525 Mike Frysinger <vapier@gentoo.org>
39526 Mike Kravetz <mike.kravetz@oracle.com>
39527 Nicholas Miell <nmiell@gmail.com>
39528 Nikola Forró <nforro@redhat.com>
39529 Sam Varshavchik <mrsam@courier-mta.com>
39530 Yaarit <yaarit@gmail.com>
39531 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
39532
39533 Apologies if I missed anyone!
39534
39535
39536 New and rewritten pages
39537 -----------------------
39538
39539 dladdr.3
39540 Michael Kerrisk
39541 New page documenting dladdr() and dladdr1()
39542 Relocate/rewrite dladdr() text formerly contained in dlopen(3).
39543
39544 Add documentation of dladdr1().
39545 Zeng Linggang
39546 ATTRIBUTES: Note functions that are thread-safe
39547
39548 dlerror.3
39549 Michael Kerrisk
39550 Migrate dlerror(3) to new separate man page
39551 Michael Kerrisk
39552 Note that the returned message may be in a statically allocated buffer
39553 Michael Kerrisk
39554 Note that the returned string does not include a trailing newline
39555 Zeng Linggang
39556 ATTRIBUTES: Note function that is thread-safe
39557
39558 dlinfo.3
39559 Michael Kerrisk
39560 New page describing dlinfo(3)
39561 Zeng Linggang
39562 ATTRIBUTES: Note function that is thread-safe
39563
39564 dlopen.3
39565 Michael Kerrisk
39566 This page was substantially rewritten and enhanced. Notably:
39567 * the dladdr(), dlsym, dlvsym(), and dlerror() content were moved
39568 to separate new pages;
39569 * documentation for dlmopen was added;
39570 * and other changes as noted below.
39571 Zeng Linggang
39572 ATTRIBUTES: Note functions that are thread-safe
39573 Michael Kerrisk
39574 Move atexit() discussion under "Initialization and Finalization"
39575 Michael Kerrisk
39576 Move discussion of _init() and _fini() to NOTES
39577 Michael Kerrisk
39578 Rework the discussion of initialization and finalization functions
39579 Deemphasize the obsolete _init/_fini and give more prominence
39580 to gcc constructors/destructors.
39581 Michael Kerrisk
39582 dlclose() will unload the object when all references have been released
39583 Michael Kerrisk
39584 EXAMPLE: Remove mention of "-rdynamic"
39585 That option isn't needed for compiling and running this program.
39586 Michael Kerrisk
39587 Remove reference to ld.so info page
39588 The command "info ld.so" simply shows the man page...
39589 Michael Kerrisk
39590 Add VERSIONS section
39591 Michael Kerrisk
39592 Reorganize conformance information for 'flags'
39593
39594 dlsysm.3
39595 Michael Kerrisk
39596 Move dlsym() and dlvsym() content to new separate page
39597 Zeng Linggang
39598 ATTRIBUTES: Note functions that are thread-safe
39599
39600
39601 Newly documented interfaces in existing pages
39602 ---------------------------------------------
39603
39604 dlopen.3
39605 Michael Kerrisk, Carlos O'Donell
39606 Document dlmopen(3)
39607
39608 nl_langinfo.3
39609 Sam Varshavchik, Michael Kerrisk
39610 Add documentation for nl_langinfo_l(3)
39611
39612 __ppc_set_ppr_med.3
39613 Gabriel F. T. Gomes
39614 Document PPC functions providing access to PPR
39615 GNU C Library 2.18 adds functions (__ppc_set_ppr_low(3),
39616 __ppc_set_ppr_med(3), __ppc_set_ppr_med_low(3)) that provide
39617 access to the Program Priority Register (PPR).
39618
39619 __ppc_yield.3
39620 Gabriel F. T. Gomes
39621 Document PPC performance-hint functions
39622 GNU C Library 2.18 adds functions __ppc_yield(3), __ppc_mdoio(3),
39623 and __ppc_mdoom(3) that can be used provide a hint that
39624 performance could be improved if shared resources are released
39625 for use by other processors.
39626
39627
39628 New and changed links
39629 ---------------------
39630
39631 dladdr1.3
39632 Michael Kerrisk
39633 New link to (new) dladdr(3) page
39634
39635 dlmopen.3
39636 Michael Kerrisk
39637 New link to dlopen.3
39638
39639 dlvsym.3
39640 Michael Kerrisk
39641 Adjust link to point to new self-contained dlsym(3) page
39642
39643 nl_langinfo_l.3
39644 Michael Kerrisk
39645 New link to nl_langinfo.3
39646
39647 __ppc_mdoio.3
39648 Gabriel F. T. Gomes
39649 New link to __ppc_yield.3
39650
39651 __ppc_mdoom.3
39652 Gabriel F. T. Gomes
39653 New link to __ppc_yield.3
39654
39655 __ppc_set_ppr_low.3
39656 Gabriel F. T. Gomes
39657 New link to __ppc_set_ppr_med.3
39658
39659 __ppc_set_ppr_med_low.3
39660 Gabriel F. T. Gomes
39661 New link to __ppc_set_ppr_med.3
39662
39663
39664 Global changes
39665 --------------
39666
39667 Very many pages
39668 Michael Kerrisk
39669 Update CONFORMING TO section to reflect POSIX.1-2001 and POSIX.1-2008
39670 details. (By now, I believe all pages should be up to date with
39671 respect to appropriately mentioning POSIX.1-2001 and POSIX.1-2008.)
39672
39673 ldd.1
39674 sprof.1
39675 execve.2
39676 dlopen.3
39677 ld.so.8
39678 Michael Kerrisk
39679 Prefer "shared object" over "shared library"
39680 The man pages variously use "shared library" or "shared object".
39681 Try to more consistently use one term ("shared object"), while
39682 also pointing out on a few pages that the terms are synonymous.
39683
39684
39685 Changes to individual pages
39686 ---------------------------
39687
39688 accept.2
39689 Michael Kerrisk
39690 Add mention of POSIX.1-2008 regarding EAGAIN vs EWOULDBLOCK
39691
39692 bpf.2
39693 Daniel Borkmann
39694 Various updates/follow-ups to address some fixmes
39695 A couple of follow-ups to the bpf(2) man-page, besides others:
39696
39697 * Description of map data types
39698 * Explanation on eBPF tail calls and program arrays
39699 * Paragraph on tc holding ref of the eBPF program in the kernel
39700 * Updated ASCII image with tc ingress and egress invocations
39701 * __sync_fetch_and_add() and example usage mentioned on arrays
39702 * minor reword on the licensing and other minor fixups
39703
39704 execve.2
39705 Michael Kerrisk
39706 Reword text on POSIX and #!
39707
39708 io_getevents.2
39709 Michael Kerrisk
39710 Note return value on interruption by a signal handler
39711 Michael Kerrisk
39712 Clarify details of return value for timeout-expired case
39713 Michael Kerrisk
39714 Clarify and extend discussion of 'timeout' argument
39715
39716 mmap.2
39717 Michael Kerrisk
39718 Note that 'length' need not be a page-size multiple for munmap()
39719 Michael Kerrisk [David Rientjes, David Rientjes, Mike Kravetz]
39720 Describe mmap()/munmap() argument requirements for huge-page mappings
39721 Michael Kerrisk
39722 Move discussion of timestamps to NOTES
39723 A straight move; no changes to the content.
39724 This content is better placed in NOTES.
39725
39726 seccomp.2
39727 Michael Kerrisk
39728 SEE ALSO: mention libseccomp pages
39729 SEE ALSO: add scmp_sys_resolver(1)
39730
39731 sigaction.2
39732 Michael Kerrisk
39733 Correct the list of flags that were added in POSIX.1-2001
39734
39735 socketpair.2
39736 Michael Kerrisk [Goswin von Brederlow]
39737 Clarify use of SOCK_* flags in 'type' argument
39738 See http://bugs.debian.org/794217
39739
39740 atexit.3
39741 Michael Kerrisk
39742 SEE ALSO: add dlopen(3)
39743
39744 clock_getcpuclockid.3
39745 Michael Kerrisk
39746 Improve wording of EPERM error
39747 It's imprecise to say that this is an "optional" error
39748 in POSIX.1.
39749
39750 dl_iterate_phdr.3
39751 Michael Kerrisk
39752 Note that 'size' allows callback() to discover structure extensions
39753 Michael Kerrisk
39754 SEE ALSO: add dladdr(3)
39755 Michael Kerrisk
39756 CONFORMING TO: note that this function appears on some other systems
39757
39758 fseeko.3
39759 Michael Kerrisk
39760 Remove crufty NOTES section
39761 This ancient System V detail is unneeded.
39762
39763 getutent.3
39764 Michael Kerrisk
39765 Mention POSIX.1-2008 for the "utmpx" functions
39766
39767 iconv_close.3
39768 iconv_open.3
39769 Michael Kerrisk
39770 CONFORMING TO: change "UNIX98" to "SUSv2"
39771
39772 malloc.3
39773 Michael Kerrisk
39774 Change "UNIX 98" to "SUSv2"
39775
39776 mktemp.3
39777 Gleb Fotengauer-Malinovskiy
39778 Reference mkdtemp(3) in addition to mkstemp(3)
39779 Mention mkdtemp(3) as another secure alternative to mktemp(3).
39780
39781 See also https://sourceware.org/bugzilla/show_bug.cgi?id=2898.
39782
39783 mq_receive.3
39784 mq_send.3
39785 Michael Kerrisk
39786 Clarify discussion of 'timeout'
39787 In particular, remove the word 'ceiling', which falsely
39788 suggests that the call might return prematurely.
39789
39790 nl_langinfo.3
39791 Michael Kerrisk
39792 Explicitly describe the return value on success
39793 Michael Kerrisk
39794 POSIX specifies that the caller may not modify the returned string
39795 Michael Kerrisk
39796 Enhance RETURN VALUE description
39797 Note some further cases where returned string may be
39798 invalidated or overwritten.
39799
39800 perror.3
39801 Michael Kerrisk
39802 Reformat CONFORMING to information
39803 Michael Kerrisk
39804 Note that 'sys_errlist' and 'sys_nerr' are not in POSIX.1
39805
39806 posix_openpt.3
39807 Michael Kerrisk
39808 Reword text regarding systems that don't have posix_openpt()
39809
39810 printf.3
39811 Michael Kerrisk
39812 CONFORMING TO: update details for dprintf() and vdprintf()
39813
39814 setlogmask.3
39815 Michael Kerrisk
39816 Remove useless statement in CONFORMING TO
39817 Saying that the description in PSOX.1-2001 is flawed,
39818 without saying what the fla is, is not helpful.
39819 (And no, I don't know what the flaw is.)
39820
39821 shm_open.3
39822 Michael Kerrisk
39823 Add POSIX.1-2008 details regarding group ID of new shared memory object
39824
39825 strfmon.3
39826 Michael Kerrisk
39827 Fix erroneous CONFORMING to
39828 strfmon() is in POSIX.1.
39829
39830 fanotify.7
39831 Heinrich Schuchardt
39832 Clarify effects of file moves
39833 If files or directories are moved to other mounts, the inode is
39834 deleted. Fanotify marks are lost.
39835
39836 mq_overview.7
39837 Michael Kerrisk
39838 Remove unneeded CONFORMING TO section
39839
39840 nptl.7
39841 Michael Kerrisk [Nicholas Miell]
39842 Note that i386 and x86-64 binaries can't share mutexes
39843
39844 sched.7
39845 Nikola Forró
39846 Fix descriptions of sched_get_priority_max() / sched_get_priority_min()
39847
39848 sem_overview.7
39849 Michael Kerrisk
39850 Remove unneeded CONFORMING TO section
39851
39852 shm_overview.7
39853 Michael Kerrisk
39854 Remove unneeded CONFORMING TO section
39855
39856 sigevent.7
39857 Michael Kerrisk
39858 Remove unneeded CONFORMING TO section
39859
39860 symlink.7
39861 Michael Kerrisk
39862 Update with POSIX.1-2008 details for link(2)
39863
39864 ld.so.8
39865 Michael Kerrisk [Jonathan David Amery]
39866 Items in LD_LIBRARY_PATH can also be delimited by semicolons
39867 See http://bugs.debian.org/794559.
39868
39869
39870 ==================== Changes in man-pages-4.03 ====================
39871
39872 Released: 2015-12-05, Munich
39873
39874
39875 Contributors
39876 ------------
39877
39878 The following people contributed patches/fixes or (noted in brackets
39879 in the changelog below) reports, notes, and ideas that have been
39880 incorporated in changes in this release:
39881
39882 Alexander Shishkin <alexander.shishkin@linux.intel.com>
39883 Alexei Starovoitov <ast@plumgrid.com>
39884 Andy Lutomirski <luto@kernel.org>
39885 Arto Bendiken <arto@bendiken.net>
39886 Carlos O'Donell <carlos@redhat.com>
39887 Casper Ti. Vector <caspervector@gmail.com>
39888 Daniel Borkmann <daniel@iogearbox.net>
39889 David Drysdale <drysdale@google.com>
39890 Eric B Munson <emunson@akamai.com>
39891 Florian Weimer <fweimer@redhat.com>
39892 Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
39893 Heinrich Schuchardt <xypron.glpk@gmx.de>
39894 Ingo Molnar <mingo@kernel.org>
39895 Jakub Wilk <jwilk@jwilk.net>
39896 Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
39897 Jonathan Wakely <jwakely@redhat.com>
39898 Jonny Grant <jg@jguk.org>
39899 Kees Cook <keescook@chromium.org>
39900 Maria Guseva <m.guseva@samsung.com>
39901 Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
39902 Meikun Wang <alikewmk@gmail.com>
39903 Michael Kerrisk <mtk.manpages@gmail.com>
39904 Michal Hocko <mhocko@suse.com>
39905 Mike Frysinger <vapier@gentoo.org>
39906 Namhyung Kim <namhyung@gmail.com>
39907 Nikola Forró <nforro@redhat.com>
39908 Olivier TARTROU <olivier.tartrou@gmail.com>
39909 Peter Hurley <peter@hurleysoftware.com>
39910 Peter Zijlstra (Intel) <peterz@infradead.org>
39911 Ross Zwisler <ross.zwisler@linux.intel.com>
39912 Serge Hallyn <serge.hallyn@canonical.com>
39913 Silvan Jegen <s.jegen@gmail.com>
39914 Stefan Tauner <tauner@technikum-wien.at>
39915 Steven Rostedt <rostedt@goodmis.org>
39916 Tobias Stoeckmann <tobias@stoeckmann.org>
39917 Tycho Andersen <tycho.andersen@canonical.com>
39918 Ville Skyttä <ville.skytta@iki.fi>
39919 Vince Weaver <vincent.weaver@maine.edu>
39920 Zeng Linggang <zenglg.jy@cn.fujitsu.com>
39921
39922 Apologies if I missed anyone!
39923
39924
39925 Newly documented interfaces in existing pages
39926 ---------------------------------------------
39927
39928 perf_event_open.2
39929 Vince Weaver
39930 4.1 adds AUX sample support
39931 Vince Weaver
39932 4.1 data_offset and data_size fields
39933 Vince Weaver [Alexander Shishkin]
39934 Document aux_{head,tail,offset,size} support
39935 Vince Weaver
39936 4.0 update rdpmc documentation
39937 Vince Weaver
39938 4.1 adds PERF_RECORD_ITRACE_START
39939 Vince Weaver
39940 Document 4.1 clockid support
39941 Vince Weaver [Steven Rostedt, Masami Hiramatsu]
39942 4.1 PERF_EVENT_IOC_SET_BPF support
39943 Vince Weaver
39944 4.1 adds AUX_FLAG_OVERWRITE support
39945 Vince Weaver
39946 4.1 PERF_SAMPLE_BRANCH_CALL_STACK
39947 Vince Weaver
39948 4.1 adds aux_watermark
39949 Vince Weaver
39950 Add possibility of EBUSY error
39951
39952 prctl.2
39953 Andy Lutomirski [Kees Cook, Serge Hallyn]
39954 Document operations for ambient capabilities
39955 Michael Kerrisk
39956 Rework PR_CAP_AMBIENT text
39957 Note that arg4 and arg5 must be zero for CAP_AMBIENT
39958 RETURN VALUE: Add PR_CAP_AMBIENT + PR_CAP_AMBIENT_IS_SET case
39959 ERRORS: document PR_CAP_AMBIENT error cases
39960
39961 __ppc_set_ppr_med.3
39962 Gabriel F. T. Gomes
39963 Document PPC functions providing access to PPR
39964 GNU C Library commit 1747fcda4902a3b46183d93fb16ed9b436b2608b
39965 extends the priorities that can be set to the Program Priority
39966 Register (PPR), with the functions: __ppc_set_ppr_very_low(3)
39967 and __ppc_set_ppr_med_high(3).
39968
39969 capabilities.7
39970 Andy Lutomirski [Kees Cook, Serge Hallyn]
39971 Document ambient capabilities
39972 Michael Kerrisk
39973 Various additions and reworkings for ambient capability text
39974
39975
39976 New and changed links
39977 ---------------------
39978
39979 __ppc_set_ppr_med_high.3
39980 Gabriel F. T. Gomes
39981 New link to __ppc_set_ppr_med.3
39982
39983 __ppc_set_ppr_very_low.3
39984 Gabriel F. T. Gomes
39985 New link to __ppc_set_ppr_med.3
39986
39987
39988 Changes to individual pages
39989 ---------------------------
39990
39991 mremap.2
39992 Eric B Munson [Michal Hocko]
39993 Add note about mremap() with locked areas
39994 When mremap() is used to move or expand a mapping that is locked
39995 with mlock() or equivalent it will attempt to populate the new
39996 area. However, like mmap(MAP_LOCKED), mremap() will not fail if
39997 the area cannot be populated. Also like mmap(MAP_LOCKED) this
39998 might come as a surprise to users and should be noted.
39999 open.2
40000 Michael Kerrisk [David Drysdale]
40001 Remove accidental mention of O_TTY_INIT
40002 An earlier edit mentioned O_TTY_INIT as a file creation flag.
40003 That's true, according POSIX, but Linux does not implement
40004 this flag, so remove mention of it.
40005
40006 pipe.2
40007 Michael Kerrisk
40008 SEE ALSO: add splice(2)
40009
40010 prctl.2
40011 Michael Kerrisk
40012 Reorder options alphabetically
40013 Employ a pseudo-alphabetical order, ordering options after removal
40014 of any "PR_", "PR_SET_", or "PR_GET" prefix.
40015 Michael Kerrisk
40016 Fix alphabetical misplacements in ERRORS
40017
40018 ptrace.2
40019 Tycho Andersen
40020 Document PTRACE_O_SUSPEND_SECCOMP flag
40021 Michael Kerrisk
40022 Document /proc/sys/kernel/yama/ptrace_scope
40023 Michael Kerrisk
40024 Note that PTRACE_ATTACH cannot be applied to nondumpable processes
40025 Michael Kerrisk
40026 SEE ALSO: add prctl(2)
40027
40028 reboot.2
40029 Casper Ti. Vector
40030 1-argument reboot() is also provided by alternative libc
40031
40032 seccomp.2
40033 Michael Kerrisk
40034 Describe use of 'instruction_pointer' data field
40035 Michael Kerrisk [Kees Cook]
40036 Note why all filters in a set are executed even after SECCOMP_RET_KILL
40037
40038 signalfd.2
40039 Michael Kerrisk
40040 Describe semantics with respect to SCM_RIGHTS
40041
40042 syscalls.2
40043 Michael Kerrisk
40044 Add mlock(2)
40045 Michael Kerrisk
40046 Add userfaultfd()
40047
40048 daemon.3
40049 Michael Kerrisk [Johannes Stüttgen]
40050 Note that daemon() is buggy with respect to controlling tty acquisition
40051
40052 dirfd.3
40053 Jonathan Wakely
40054 Remove outdated NOTES
40055 As stated in the SYNOPSIS, since glibc 2.10 this function is also
40056 declared by the relevant X/Open and POSIX macros.
40057
40058 dlopen.3
40059 Michael Kerrisk
40060 Make it more explicit that LD_BIND_NOW overrides RTLD_LAZY
40061 Michael Kerrisk [Florian Weimer]
40062 Correct the pathname used in EXAMPLE
40063 Quoting Florian:
40064
40065 This does not work because libm.so can be a linker script:
40066
40067 handle = dlopen("libm.so", RTLD_LAZY);
40068
40069 The proper way to do this is to include <gnu/lib-names.h>
40070 and use LIBM_SO.
40071
40072 See https://bugzilla.kernel.org/show_bug.cgi?id=108821
40073 Michael Kerrisk
40074 Include a shell session showing build/run in EXAMPLE
40075 Michael Kerrisk
40076 Change arguments to main() to "void" in EXAMPLE
40077
40078 fgetgrent.3
40079 Zeng Linggang
40080 ATTRIBUTES: Note function that is not thread-safe
40081
40082 fgetpwent.3
40083 Zeng Linggang
40084 ATTRIBUTES: Note function that is not thread-safe
40085
40086 getauxval.3
40087 Michael Kerrisk
40088 Add some details for AT_SECURE
40089
40090 getspnam.3
40091 Zeng Linggang
40092 ATTRIBUTES: Note functions that are/aren't thread-safe
40093
40094 mallinfo.3
40095 Zeng Linggang
40096 ATTRIBUTES: Note function that is not thread-safe
40097
40098 mallopt.3
40099 Carlos O'Donell
40100 Document M_ARENA_TEST and M_ARENA_MAX
40101
40102 posix_fallocate.3
40103 Michael Kerrisk
40104 Clarify text relating to MT-safety
40105 Carlos O'Donell
40106 Mention glibc emulation caveats
40107
40108 termios.3
40109 Olivier TARTROU
40110 Add missing details on behaviour of PARMRK
40111 For a serial terminal, with a specific configuration, input bytes
40112 with value 0377 are passed to the program as two bytes, 0377 0377.
40113
40114 tty_ioctl.4
40115 Michael Kerrisk [Peter Hurley]
40116 Note that TIOCTTYGSTRUCT went away in Linux 2.5.67
40117
40118 core.5
40119 Ross Zwisler
40120 Add info about DAX coredump filtering flags
40121 Kernel 4.4 added two new core dump filtering flags,
40122 MMF_DUMP_DAX_PRIVATE and MMF_DUMP_DAX_SHARED.
40123
40124 These flags allow us to explicitly filter DAX mappings.
40125 This is desirable because DAX mappings, like hugetlb
40126 mappings, have the potential to be very large.
40127
40128 nsswitch.conf.5
40129 Nikola Forró
40130 Add list of files being read when "files" service is used
40131 This is not mentioned anywhere. Users can assume that the file
40132 being read is something like /etc/$DATABASE, but that's not
40133 always the case. It's better to explicitly specify which
40134 file is read for each respective database. The list of
40135 files was acquired from glibc source code.
40136
40137 proc.5
40138 Heinrich Schuchardt [Michael Kerrisk]
40139 Add details for threads-max
40140 Add detail information for threads-max.
40141 The checks for minimum and maximum values exist since kernel 4.1.
40142 https://lkml.org/lkml/2015/3/15/96
40143 Heinrich Schuchardt
40144 /proc/sys: Describe whitespace characters
40145 Michael Kerrisk
40146 Document 'CapAmb' in /proc/PID/status
40147 Michael Kerrisk
40148 Add reference to ptrace(2) for /proc/sys/kernel/yama/ptrace_scope
40149
40150 aio.7
40151 Michael Kerrisk [Meikun Wang]
40152 Add missing include file, <fcntl.h>, to example program
40153
40154 mq_overview.7
40155 Michael Kerrisk [Arto Bendiken]
40156 Document QSIZE bug that appeared in 3.5 and was fixed in 4.2
40157
40158 path_resolution.7
40159 Michael Kerrisk
40160 Clarify recursive resolution of symlinks and note limits
40161
40162 pipe.7
40163 Michael Kerrisk
40164 SEE ALSO: add splice(2)
40165
40166 rtld-audit.7
40167 Namhyung Kim
40168 Fix (typo) error in la_pltenter() description
40169 s/la_pltenter()/la_pltexit()/
40170
40171 la_pltenter() is called regardless of the value of
40172 framesizep but la_pltexit() is called only if la_pltenter()
40173 returns with non-zero framesizep set. I spent long time to
40174 figure out why la_pltexit() is not called at all.
40175
40176 signal.7
40177 Michael Kerrisk [Michael Hocko]
40178 Note async-signal-safe functions added by POSIX.1-2008 TC1
40179
40180 tcp.7
40181 Daniel Borkmann [Michael Kerrisk]
40182 Improve paragraphs on tcp_ecn and add tcp_ecn_fallback bullet
40183 Improve description of tcp_ecn, fix the RFC number and it's
40184 not a boolean anymore since long time, and add a description
40185 for tcp_ecn_fallback.
40186
40187 See also kernel doc under Documentation/networking/ip-sysctl.txt
40188 on tcp_ecn and tcp_ecn_fallback.
40189
40190 ld.so.8
40191 Michael Kerrisk
40192 LD_POINTER_GUARD has been removed in glibc 2.23
40193 Michael Kerrisk
40194 Describe secure-execution mode
40195 Michael Kerrisk [Maria Guseva]
40196 Replace mentions of set-UID/set-GID programs with secure-execution mode
40197 Inspired by a patch from Maria Guseva.
40198 Maria Guseva [Silvan Jegen]
40199 LD_DEBUG is effective in secure-execution mode if /etc/suid-debug exists
40200
40201
40202 ==================== Changes in man-pages-4.04 ====================
40203
40204 Released: 2015-12-29, Munich
40205
40206
40207 Contributors
40208 ------------
40209
40210 The following people contributed patches/fixes or (noted in brackets
40211 in the changelog below) reports, notes, and ideas that have been
40212 incorporated in changes in this release:
40213
40214 Alexander Monakov <amonakov@ispras.ru>
40215 Andries E. Brouwer <Andries.Brouwer@cwi.nl>
40216 Archie Cobbs <archie.cobbs@gmail.com>
40217 Carlos O'Donell <carlos@redhat.com>
40218 Colin Rice <colin@daedrum.net>
40219 Darren Hart <dvhart@infradead.org>
40220 Davidlohr Bueso <dave@stgolabs.net>
40221 Dmitry V. Levin <ldv@altlinux.org>
40222 Eric B Munson <emunson@akamai.com>
40223 Heinrich Schuchardt <xypron.glpk@gmx.de>
40224 H.J. Lu <hjl.tools@gmail.com>
40225 Jakub Wilk <jwilk@jwilk.net>
40226 Jonathan Wakely <jwakely@redhat.com>
40227 Jonny Grant <jg@jguk.org>
40228 Laurent Georget <laurent.georget@supelec.fr>
40229 Lennart Poettering <lennart@poettering.net>
40230 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
40231 Michael Kerrisk <mtk.manpages@gmail.com>
40232 Michal Hocko <mhocko@suse.com>
40233 Mike Frysinger <vapier@gentoo.org>
40234 Pádraig Brady <P@draigBrady.com>
40235 Paul Eggert <eggert@cs.ucla.edu>
40236 Pavel Machek <pavel@ucw.cz>
40237 Phil Blundell <pb@pbcl.net>
40238 Richard Voigt <richardvoigt@gmail.com>
40239 Rich Felker <dalias@libc.org>
40240 Rusty Russell <rusty@rustcorp.com.au>
40241 Thomas Gleixner <tglx@linutronix.de>
40242 Tom Gundersen <teg@jklm.no>
40243 Torvald Riegel <triegel@redhat.com>
40244 Vincent Lefevre <vincent@vinc17.net>
40245 Vlastimil Babka <vbabka@suse.cz>
40246 Walter Harms <wharms@bfs.de>
40247 Zack Weinberg <zackw@panix.com>
40248
40249
40250 Apologies if I missed anyone!
40251
40252
40253 New and rewritten pages
40254 -----------------------
40255
40256 futex.2
40257 Michael Kerrisk, Thomas Gleixner, Torvald Riegel [Davidlohr Bueso, Heinrich Schuchardt, Darren Hart, Rusty Russell, Pavel Machek, Rich Felker]
40258 Rewrite and massively expand page
40259
40260 membarrier.2
40261 Mathieu Desnoyers [Michael Kerrisk]
40262 New page documenting membarrier() system call
40263
40264
40265 Newly documented interfaces in existing pages
40266 ---------------------------------------------
40267
40268 mlock.2
40269 Eric B Munson [Michal Hocko, Vlastimil Babka, Michael Kerrisk]
40270 Document mlock2(2) and MCL_ONFAULT
40271
40272
40273 New and changed links
40274 ---------------------
40275
40276 mlock2.2
40277 Eric B Munson
40278 New link to mlock.2
40279
40280
40281 Global changes
40282 --------------
40283
40284 Various pages
40285 Michael Kerrisk
40286 ERRORS: standardize text for EMFILE error
40287
40288 Various pages
40289 Michael Kerrisk
40290 ERRORS: standardize error text for ENOTSOCK error
40291
40292 Various pages
40293 Michael Kerrisk
40294 ERRORS: standardize text for ENFILE error
40295
40296
40297 Changes to individual pages
40298 ---------------------------
40299
40300 clock_getres.2
40301 Michael Kerrisk
40302 SEE ALSO: add vdso(7)
40303
40304 epoll_create.2
40305 Michael Kerrisk
40306 ERRORS: add another EMFILE error case
40307
40308 fanotify_init.2
40309 Michael Kerrisk
40310 ERRORS: add an EMFILE error case
40311
40312 fork.2
40313 Michael Kerrisk
40314 Child of MT-process is restricted to async-signal-safe functions
40315
40316 getcpu.2
40317 Michael Kerrisk
40318 SEE ALSO: add vdso(7)
40319
40320 getrlimit.2
40321 Michael Kerrisk [Lennart Poettering]
40322 The init of measurement for RLIMIT_RSS is bytes, not pages
40323
40324 get_robust_list.2
40325 Michael Kerrisk
40326 Reword EINVAL error text
40327
40328 gettimeofday.2
40329 Carlos O'Donell
40330 Expand on the historical meaning of tz_dsttime
40331 Michael Kerrisk
40332 SEE ALSO: add vdso(7)
40333
40334 inotify_init.2
40335 Michael Kerrisk
40336 ERRORS: add an EMFILE error case
40337
40338 personality.2
40339 Dmitry V. Levin
40340 Note kernel and glibc versions that introduced this system call
40341
40342 poll.2
40343 Richard Voigt
40344 timeout_ts is a pointer, so use -> not . for member access
40345 Michael Kerrisk
40346 Shorten name of timeout argument for ppoll()
40347 The name is overly long, and does not hint at the fact
40348 that this argument is a pointer. Fix this by renaming:
40349 s/timeout_ts/tmo_p/
40350
40351 sendfile.2
40352 Laurent Georget
40353 Document more ERRORS
40354
40355 sigreturn.2
40356 Michael Kerrisk
40357 SEE ALSO: add vdso(7)
40358
40359 socketcall.2
40360 Michael Kerrisk
40361 Since Linux 4.3, x86-32 provides direct system calls for the sockets API
40362
40363 time.2
40364 Zack Weinberg
40365 Explain why the glibc time() wrapper never sets 'errno'
40366 Michael Kerrisk [H.J. Lu]
40367 Where time() is provided by vDSO, an invalid address may give SIGSEGV
40368 Michael Kerrisk [Paul Eggert]
40369 Describe EOVERFLOW details
40370 Michael Kerrisk
40371 SEE ALSO: add vdso(7)
40372 Michael Kerrisk
40373 Rename 't' argument to 'tloc'
40374
40375 dlerror.3
40376 Michael Kerrisk [Jonny Grant]
40377 Clarify that the string returned by dlerror() is null terminated
40378
40379 dlopen.3
40380 Michael Kerrisk
40381 Include a shell session showing build/run in EXAMPLE
40382 Michael Kerrisk
40383 Change arguments to main() to "void" in EXAMPLE
40384
40385 drand48.3
40386 Michael Kerrisk [Vincent Lefevre]
40387 Correct descriptions of ranges returned by these functions
40388 See http://bugs.debian.org/803459
40389
40390 errno.3
40391 Michael Kerrisk
40392 Note probable cause of ENFILE error
40393
40394 fnmatch.3
40395 Pádraig Brady
40396 Describe the FNM_EXTMATCH flag and pattern syntax
40397
40398 iconv.3
40399 Andries E. Brouwer
40400 NOTES: describe correct usage for flushing partially buffered input
40401
40402 random_r.3
40403 Michael Kerrisk [Archie Cobbs]
40404 Clarify need to use initstate_r()
40405
40406 tzset.3
40407 Carlos O'Donell
40408 Clarify "daylight" and remove erroneous note
40409
40410 random.4
40411 Michael Kerrisk [Tom Gundersen]
40412 Rework example scripts to assume 'poolsize' unit is bits, not bytes
40413 Michael Kerrisk [Walter Harms]
40414 Use modern command substitution syntax in shell session log
40415
40416 proc.5
40417 Michael Kerrisk
40418 Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error
40419
40420 futex.7
40421 Heinrich Schuchardt
40422 SEE ALSO updates
40423 Michael Kerrisk
40424 Note some other locking primitives that are built with futexes
40425 Heinrich Schuchardt
40426 NPTL, avoid abbreviation
40427 Michael Kerrisk
40428 Note that a futex is 4 bytes on all platforms
40429
40430 vdso.7
40431 Michael Kerrisk
40432 Add note on strace(1) and vDSO
40433
40434 ld.so.8
40435 H.J. Lu [Michael Kerrisk]
40436 Document LD_PREFER_MAP_32BIT_EXEC
40437 Michael Kerrisk
40438 Clarify setting of LD_BIND_NOT
40439 Michael Kerrisk
40440 Clarify setting of LD_DYNAMIC_WEAK
40441 Michael Kerrisk
40442 Clarify setting of LD_TRACE_PRELINKING
40443 Michael Kerrisk
40444 Clarify some details for LD_SHOW_AUXV
40445
40446
40447 ==================== Changes in man-pages-4.05 ====================
40448
40449 Released: 2016-03-15, Christchurch
40450
40451
40452 Contributors
40453 ------------
40454
40455 The following people contributed patches/fixes or (noted in brackets
40456 in the changelog below) reports, notes, and ideas that have been
40457 incorporated in changes in this release:
40458
40459 Adhemerval Zanella <adhemerval.zanella@linaro.org>
40460 Akihiro Suda <suda.kyoto@gmail.com>
40461 Alan Aversa <alan.aversa@cox.net>
40462 Alan Cox <etchedpixels@gmail.com>
40463 Alec Leamas <leamas.alec@gmail.com>
40464 Alex Henrie <alexhenrie24@gmail.com>
40465 Alexander Miller <alex.miller@gmx.de>
40466 Andreas Gruenbacher <agruenba@redhat.com>
40467 Andreas Schwab <schwab@suse.de>
40468 Anna Schumaker <Anna.Schumaker@Netapp.com>
40469 Askar Safin <safinaskar@mail.ru>
40470 Bill O. Gallmeister <bgallmeister@gmail.com>
40471 Carlos O'Donell <carlos@redhat.com>
40472 Chris Pick <kernel@chrispick.com>
40473 Christoph Hellwig <hch@infradead.org>
40474 Craig Gallek <kraig@google.com>
40475 Darrick J. Wong <darrick.wong@oracle.com>
40476 Davidlohr Bueso <dave@stgolabs.net>
40477 Dmitry V. Levin <ldv@altlinux.org>
40478 Dr. Tobias Quathamer <toddy@debian.org>
40479 Eric Blake <eblake@redhat.com>
40480 Eric Dumazet <edumazet@google.com>
40481 Florian Weimer <fweimer@redhat.com>
40482 Gabriel Corona <gabriel.corona@enst-bretagne.fr>
40483 Heinrich Schuchardt <xypron.glpk@gmx.de>
40484 Ivan Shapovalov <intelfx@intelfx.name>
40485 Jakub Wilk <jwilk@jwilk.net>
40486 Jason Baron <jbaron@akamai.com>
40487 Jason Vas Dias <jason.vas.dias@gmail.com>
40488 Jérémie Galarneau <jeremie.galarneau@efficios.com>
40489 Jeremy Harris <jeharris@redhat.com>
40490 Joachim Wuttke <j.wuttke@fz-juelich.de>
40491 Joe Stein <joeaarons@gmail.com>
40492 John Stultz <john.stultz@linaro.org>
40493 Josh Triplett <josh@joshtriplett.org>
40494 Kondo, Naoya <kondo-naoya@jp.fujitsu.com>
40495 Krzysztof Adamski <k@japko.eu>
40496 Manfred Spraul <manfred@colorfullife.com>
40497 Marianne CHEVROT <blackmoor@openmailbox.org>
40498 Marko Myllynen <myllynen@redhat.com>
40499 Mark Post <mpost@suse.com>
40500 Martin Gebert <Murphy.Gebert@gmx.de>
40501 Mats Wichmann <mats@linuxfoundation.org>
40502 Matt Zimmerman <mdz@debian.org>
40503 Michael Kerrisk <mtk.manpages@gmail.com>`
40504 Mike Frysinger <vapier@gentoo.org>
40505 Minchan Kim <minchan@kernel.org>
40506 Naoya Kondo <kondo-naoya@jp.fujitsu.com>
40507 Naresh Kamboju <naresh.kernel@gmail.com>
40508 Nikola Forró <nforro@redhat.com>
40509 Nikos Mavrogiannopoulos <nmav@gnutls.org>
40510 Orion Poplawski <orion@cora.nwra.com>
40511 Pakin Yury <zxwarior@yandex.ru>
40512 Patrick Donnelly <batrick@batbytes.com>
40513 Paul Eggert <eggert@cs.ucla.edu>
40514 Paul Pluzhnikov <ppluzhnikov@google.com>
40515 Peter Hurley <peter@hurleysoftware.com>
40516 Peter Wu <peter@lekensteyn.nl>
40517 Petr Gajdos <pgajdos@suse.cz>
40518 Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
40519 Rasmus Villemoes <Rasmus.Villemoes@decode.is>
40520 Rich Felker <dalias@aerifal.cx>
40521 Simon Que <sque@chromium.org>
40522 Stephan Bergmann <sbergman@redhat.com>
40523 Stéphane Aulery <lkppo@free.fr>
40524 Stephen Hurd <shurd@sasktel.net>
40525 Vincent Bernat <bernat@luffy.cx>
40526 William Preston <wpreston@suse.de>
40527 Yuri Kozlov <yuray@komyakino.ru>
40528 Zefram <zefram@fysh.org>
40529
40530 Apologies if I missed anyone!
40531
40532
40533 New and rewritten pages
40534 -----------------------
40535
40536 copy_file_range.2
40537 Anna Schumaker [Darrick J. Wong, Christoph Hellwig, Michael Kerrisk]
40538 New page documenting copy_file_range()
40539 copy_file_range() is a new system call for copying ranges of data
40540 completely in the kernel. This gives filesystems an opportunity to
40541 implement some kind of "copy acceleration", such as reflinks or
40542 server-side-copy (in the case of NFS).
40543
40544 personality.2
40545 Michael Kerrisk
40546 This page has been greatly expanded, to add descriptions of
40547 personality domains.
40548
40549 fmemopen.3
40550 Michael Kerrisk [Adhemerval Zanella]
40551 Significant reworking of this page:
40552 * Rework discussion of the (obsolete) binary mode
40553 * Split open_memstream(3) description into a separate page.
40554 * Note various fmemopen() bugs that were fixed in glibc 2.22
40555 * Greatly expand description of 'mode' argument
40556 * Rework description of 'buf' and 'len' arguments
40557 * Expand discussion of "current position" for fmemopen() stream
40558
40559 ntp_gettime.3
40560 Michael Kerrisk
40561 New page describing ntp_gettime(3) and ntp_gettimex(3)
40562
40563 open_memstream.3
40564 Michael Kerrisk
40565 New page created by split of fmemopen(3).
40566 At the same time, add and rework a few details in the text.
40567
40568 posix_spawn.3
40569 Bill O. Gallmeister, Michael Kerrisk
40570 New man page documenting posix_spawn(3) and posix_spawnp(3)
40571
40572 readdir.3
40573 Michael Kerrisk [Florian Weimer]
40574 Split readdir_r() content into separate page
40575 As suggested by Florian Weimer:
40576
40577 It may make sense to move this documentation to a separate
40578 manual page, specific to readdir_r. This will keep the
40579 readdir() documentation nice and crisp. Most programmers
40580 will never have to consult all these details.
40581 Michael Kerrisk
40582 Near complete restructuring of the page and add some further details
40583 Michael Kerrisk [Florian Weimer, Rich Felker, Paul Eggert]
40584 Add a lot more detail on portable use of the 'd_name' field
40585
40586 readdir_r.3
40587 Michael Kerrisk [Florian Weimer]
40588 New page created after split of readdir(3).
40589 Michael Kerrisk [Florian Weimer]
40590 Explain why readdir_r() is deprecated and readdir() is preferred
40591 Michael Kerrisk [Florian Weimer]
40592 Remove misleading code example using pathconf()
40593
40594 lirc.4
40595 Alec Leamas
40596 New page documenting lirc device driver
40597
40598
40599 Newly documented interfaces in existing pages
40600 ---------------------------------------------
40601
40602 adjtimex.2
40603 Michael Kerrisk
40604 Document ntp_adjtime(3)
40605
40606 epoll_ctl.2
40607 Michael Kerrisk [Jason Baron]
40608 Document EPOLLEXCLUSIVE
40609
40610 madvise.2
40611 Minchan Kim [Michael Kerrisk]
40612 Document MADV_FREE
40613 Document the MADV_FREE flag added to madvise() in Linux 4.5.
40614
40615 proc.5
40616 Michael Kerrisk
40617 Document CmaTotal and CmaFree fields of /proc/meminfo
40618 Michael Kerrisk
40619 Document additional /proc/meminfo fields
40620 Document DirectMap4k, DirectMap4M, DirectMap2M, DirectMap1G
40621 Michael Kerrisk
40622 Document MemAvailable /proc/meminfo field
40623 Michael Kerrisk
40624 Document inotify /proc/PID/fdinfo entries
40625 Michael Kerrisk
40626 Document fanotify /proc/PID/fdinfo entries
40627 Michael Kerrisk
40628 Add some kernel version numbers for /proc/PID/fdinfo entries
40629 Michael Kerrisk [Patrick Donnelly]
40630 /proc/PID/fdinfo displays the setting of the close-on-exec flag
40631 Note also the pre-3.1 bug in the display of this info.
40632
40633 socket.7
40634 Craig Gallek [Michael Kerrisk, Vincent Bernat]
40635 Document some BPF-related socket options
40636 Document the behavior and the first kernel version for each of the
40637 following socket options:
40638
40639 SO_ATTACH_FILTER
40640 SO_ATTACH_BPF
40641 SO_ATTACH_REUSEPORT_CBPF
40642 SO_ATTACH_REUSEPORT_EBPF
40643 SO_DETACH_FILTER
40644 SO_DETACH_BPF
40645 SO_LOCK_FILTER
40646
40647
40648 New and changed links
40649 ---------------------
40650
40651 isalpha_l.3
40652 Michael Kerrisk
40653 New link to isalpha.3
40654
40655 longjmp.3
40656 Michael Kerrisk
40657 Replace page with link to setjmp(3), which now incorporates longjmp()
40658
40659 ntp_adjtime.3
40660 Michael Kerrisk
40661 New link to adjtimex(2)
40662
40663 ntp_gettimex.3
40664 Michael Kerrisk
40665 New link to ntp_gettime.3
40666
40667 open_wmemstream.3
40668 Michael Kerrisk
40669 Update link to point to new open_memstream(2) page
40670
40671 posix_spawnp.3
40672 Michael Kerrisk
40673 New link to new posix_spawn.3 page
40674
40675 siglongjmp.3
40676 Michael Kerrisk
40677 Rewire link to point to setjmp(3)
40678
40679 strerror_l.3
40680 Michael Kerrisk
40681 New link to strerror.3
40682 Fix missing link
40683
40684
40685 Global changes
40686 --------------
40687
40688 Various pages
40689 Michael Kerrisk
40690 Update FTM requirements (_DEFAULT_SOURCE)
40691 Michael Kerrisk
40692 Update feature test macro requirements
40693 Update to use _DEFAULT_SOURCE, and also changes brought by
40694 glibc commit 266865c0e7b79d4196e2cc393693463f03c90bd8.
40695
40696 Various pages
40697 Michael Kerrisk
40698 Simplify FTM requirements
40699 Looking at <features.h> (or feature_test_macros(7)), one can
40700 see that when _XOPEN_SOURCE is defined with the value 700
40701 (or greater), then _POSIX_C_SOURCE is defined with the value
40702 200809L (or greater). Therefore, terms in the man pages such as
40703
40704 _XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
40705
40706 can be simplified to:
40707
40708 _POSIX_C_SOURCE\ >=\ 200809L
40709
40710 Various pages
40711 Michael Kerrisk
40712 Simplify FTM requirements
40713 Looking at <features.h> (or feature_test_macros(7)), one can
40714 see that when _XOPEN_SOURCE is defined with the value 600
40715 (or greater), then _POSIX_C_SOURCE is defined with the value
40716 200112L (or greater). Therefore, terms in the man pages such as
40717
40718 _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
40719
40720 can be simplified to:
40721
40722 _POSIX_C_SOURCE\ >=\ 200112L
40723
40724 Various pages
40725 Michael Kerrisk
40726 Simplify FTM requirements
40727 _XOPEN_SOURCE implies _POSIX_C_SOURCE >=2, so simplify FTM
40728 requirements in various pages.
40729
40730 Various pages
40731 Michael Kerrisk
40732 Remove "or 'cc -std=c99'" from SYNOPSIS
40733 Under the FTM requirements all of these pages document the
40734 requirement for _ISOC99_SOURCE. And feature_test_macros(7) now
40735 documents that "cc -std=c99" produces the same effect as defining
40736 _ISOC99_SOURCE. So, all of these pages don't additionally need
40737 to specify "or 'cc -std=c99'" under the FTM requirements
40738 in the SYNOPSIS. Removing that redundant text also simplifies
40739 the SYNOPSIS a little.
40740
40741 Various pages
40742 Michael Kerrisk
40743 Simplify FTM requirements
40744 Looking at <features.h> (or feature_test_macros(7)), one can
40745 see that when _XOPEN_SOURCE is defined with the value 600
40746 (or greater), then _POSIX_C_SOURCE is defined with the value
40747 200112L (or greater). Therefore, terms in the man pages such as
40748
40749 _XOPEN_SOURCE\ >=\ 600 || _POSIX_C_SOURCE\ >=\ 200112L
40750
40751 can be simplified to:
40752
40753 _POSIX_C_SOURCE\ >=\ 200112L
40754
40755 Various pages
40756 Michael Kerrisk
40757 Remove references to _XOPEN_SOURCE_EXTENDED in SYNOPSIS
40758 _XOPEN_SOURCE_EXTENDED is obsolete (it existed in SUSv1, but not
40759 subsequent standards). _XOPEN_SOURCE >= 500 produces the same
40760 effects as (_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED). Modifying
40761 the SYNOPSIS of various ages that contain:
40762
40763 _XOPEN_SOURCE\ >=\ 500 ||
40764 _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
40765
40766 to just:
40767
40768 _XOPEN_SOURCE\ >=\ 500
40769
40770 This has the following benefits:
40771
40772 a) Simplifying the SYNOPSIS by removing ancient
40773 historical information.
40774
40775 b) Preventing users from being misled into using
40776 _XOPEN_SOURCE_EXTENDED in new source code.
40777
40778 Various pages
40779 Michael Kerrisk
40780 Remove mention of the obsolete _POSIX_SOURCE macro from SYNOPSIS
40781 _POSIX_SOURCE was a POSIX.1-1990 creation that was soon made
40782 obsolete bu _POSIX_C_SOURCE. Retaining mention of it
40783 in the feature test macro requirements section of the
40784 SYNOPSIS doesn't contain important information, and may
40785 mislead readers into actually trying to use this macro.
40786 A few mentions of it are maintained in a some pages where
40787 defining _POSIX_SOURCE inhibits some behavior.
40788
40789 Various sockets-related pages
40790 Michael Kerrisk [Carlos O'Donell]
40791 Use consistent argument/variable names for socket addresses and lengths
40792 As noted by Carlos, there's quite a bit of inconsistency across
40793 pages. Use 'addr' and 'addrlen' consistently in variables and
40794 function arguments.
40795
40796 Various pages
40797 Michael Kerrisk
40798 Wording fix: "current file offset" ==> "file offset"
40799 "File offset" is the preferred POSIX terminology.
40800
40801 Various pages
40802 Michael Kerrisk
40803 Word "descriptor" more precisely
40804 Use either "file descriptor" or "message queue descriptor".
40805
40806 Various pages
40807 Michael Kerrisk
40808 ERRORS: add reference to signal(7) in description of EINTR
40809
40810
40811 Changes to individual pages
40812 ---------------------------
40813
40814 locale.1
40815 Marko Myllynen
40816 Add "locale -c charmap" as an example
40817 Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.
40818
40819 localedef.1
40820 Marko Myllynen
40821 Add hint on purpose of --no-archive
40822 Indicate why using --no-archive might be a good idea. The issue
40823 is that if you create a custom locale with localedef(1) and put
40824 it to the locale archive then during the next glibc upgrade the
40825 locale archive is updated as well and your custom locale is gone.)
40826
40827 accept.2
40828 Michael Kerrisk
40829 ERRORS: improve description for EBADF
40830
40831 adjtimex.2
40832 Michael Kerrisk [John Stultz]
40833 Various improvements after feedback from John Stultz
40834 Michael Kerrisk
40835 Remove FTM requirements
40836 It seems that adjtimex() never needed _BSD_SOURCE (and my
40837 earlier commit 5918743bc8b02b was simply a blunder).
40838 Michael Kerrisk
40839 Split EINVAL error cases
40840 Michael Kerrisk
40841 Note treatment of out-of-range buf.offset
40842 Michael Kerrisk
40843 Don't refer reader to adjtime(3)
40844 Probably, it's not wise to suggest adjtime(3) as the more
40845 portable API. Rather, ntp_adjtime(3) should be used.
40846 Michael Kerrisk [Naresh Kamboju]
40847 Update details of buf.offset EINVAL error
40848 Michael Kerrisk
40849 SEE ALSO: add ntp_gettime(3)
40850 Michael Kerrisk
40851 Improve description of some PPS timex fields
40852 Michael Kerrisk
40853 Add ATTRIBUTES section
40854 William Preston [Petr Gajdos]
40855 Update a detail in adjtimex return value description
40856 Michael Kerrisk
40857 Note range constraints and clamping for ADJ_FREQUENCY
40858
40859 bdflush.2
40860 Michael Kerrisk
40861 Note that glibc support for this system call went away in version 2.23
40862
40863 bind.2
40864 Michael Kerrisk
40865 Improve description of ENOENT error
40866
40867 bpf.2
40868 Michael Kerrisk
40869 Document close-on-exec semantics
40870 The close-on-exec file descriptor flag is automatically enabled
40871 for FDs returned by bpf().
40872
40873 chmod.2
40874 Michael Kerrisk
40875 Clarify terminology (file mode versus file permission bits)
40876
40877 chown.2
40878 Michael Kerrisk
40879 ERRORS: improve EBADF description
40880
40881 clone.2
40882 unshare.2
40883 Michael Kerrisk
40884 Remove mention of _BSD_SOURCE and _SVID_SOURCE
40885 The right way to expose declarations for these Linux-specific
40886 system calls was always _GNU_SOURCE. Mentioning the historical
40887 use of _BSD_SOURCE and _SVID_SOURCE just clouds the issue.
40888
40889 connect.2
40890 Michael Kerrisk
40891 ERRORS: improve EBADF description
40892
40893 create_module.2
40894 Michael Kerrisk
40895 Glibc 2.23 removed last vestiges of support for this system call
40896
40897 delete_module.2
40898 Michael Kerrisk
40899 Glibc 2.23 removed last vestiges of support for this system call
40900
40901 epoll_ctl.2
40902 Michael Kerrisk
40903 Document ELOOP error for circular monitoring loops
40904
40905 eventfd.2
40906 Michael Kerrisk
40907 Note that eventfd info is available in /proc/PID/fdinfo
40908
40909 execve.2
40910 Michael Kerrisk [Krzysztof Adamski]
40911 Add EPERM error for capabilities check of capability-dumb binaries
40912 Michael Kerrisk
40913 Add reference to ld-linux.so(8)
40914 Michael Kerrisk
40915 SEE ALSO: add system(3)
40916
40917 fanotify_init.2
40918 Michael Kerrisk
40919 Note kernel version that allowed O_CLOEXEC for event_f_flags
40920
40921 fcntl.2
40922 flock.2
40923 Michael Kerrisk
40924 SEE ALSO: add lslocks(8)
40925
40926 fcntl.2
40927 Michael Kerrisk [Jason Vas Dias]
40928 Rework description of F_SETOWN
40929 As suggested by Jason, make it clearer that I/O signalling
40930 requires the use of both F_SETOWN and O_ASYNC. While we're at,
40931 make a few other cleanups to the text.
40932 Michael Kerrisk
40933 Remove mention of _BSD_SOURCE to get definition of F_SETOWN/F_GETOWN
40934 This usage went away in glibc 2.20, and the simplest remedy
40935 is just to omit mention of it.
40936
40937 futex.2
40938 Michael Kerrisk
40939 FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
40940
40941 get_kernel_syms.2
40942 Michael Kerrisk
40943 Note that glibc does not support this system call
40944
40945 init_module.2
40946 Michael Kerrisk
40947 Glibc 2.23 removed last vestiges of support for this system call
40948
40949 ioctl_list.2
40950 Heinrich Schuchardt
40951 Include uapi/linux/wireless.h
40952 Add the list of wireless IOCTLs.
40953 Heinrich Schuchardt
40954 Path to sockios.h
40955 sockios.h is now in include/uapi
40956 Heinrich Schuchardt
40957 Add reference to netdevice.7
40958 netdevice.7 describes most of the IOCTLs of sockios.h
40959 Heinrich Schuchardt
40960 Transfer structure (wireless.h IOCTLs)
40961 The sole parameter to be passed to the wireless.h IOCTLs is
40962 of type struct iwreq *.
40963
40964 ioperm.2
40965 Michael Kerrisk [Alex Henrie]
40966 ioperm.2: Permissions are inherited across fork(2)
40967 See https://bugzilla.kernel.org/show_bug.cgi?id=99911
40968
40969 iopl.2
40970 Michael Kerrisk [Alex Henrie]
40971 Permissions are not inherited across fork(2) or preserved on execve(2)
40972 See https://bugzilla.kernel.org/show_bug.cgi?id=99901
40973
40974 lseek.2
40975 Michael Kerrisk
40976 FUSE now supports SEEK_HOLE and SEEK_DATA
40977 Michael Kerrisk
40978 NFS supports SEEK_HOLE and SEEK_DATA
40979
40980 Michael Kerrisk
40981 SEE ALSO: add open(2)
40982
40983 madvise.2
40984 Michael Kerrisk
40985 Clarify MADV_HWPOISON wording to say that it applies to a page range
40986
40987 mknod.2
40988 Michael Kerrisk
40989 SEE ALSO: add mknod(1)
40990
40991 mount.2
40992 Michael Kerrisk
40993 SEE ALSO: add findmnt(8)
40994
40995 open.2
40996 Michael Kerrisk
40997 NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
40998 Mark Post [Petr Gajdos]
40999 O_TMPFILE support is now provided bt Btrfs
41000
41001 pipe.2
41002 Michael Kerrisk [Eric Blake]
41003 Note treatment of 'pipefd' on error
41004
41005 poll.2
41006 Michael Kerrisk [Josh Triplett]
41007 Document spurious EAGAIN error that can occur on other systems
41008 Light reworking of text proposed by Josh Triplett.
41009
41010 readlink.2
41011 Michael Kerrisk
41012 Clarify EINVAL error description
41013
41014 recv.2
41015 Heinrich Schuchardt
41016 Equivalence to read()
41017 Describe the recv(2)-read(2) and the recvfrom(2)-recv(2)
41018 equivalences for zero-valued arguments.
41019 Michael Kerrisk
41020 MSG_WAITALL has no effect for datagram sockets
41021
41022 recv.2
41023 cmsg.3
41024 Nikola Forró
41025 Fix type of cmsg_len member of cmsghdr structure
41026 The type shown for cmsg_len member of cmsghdr structure is socklen_t,
41027 but the actual type used by glibc and the kernel is size_t.
41028 The information was obtained from glibc source code:
41029 http://bit.ly/21m1RMp
41030 Michael Kerrisk
41031 Note that cmsg_len is typed as socklen_t in POSIX.1
41032
41033
41034 sched_setaffinity.2
41035 Michael Kerrisk [Florian Weimer, Florian Weimer]
41036 Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
41037 Michael Kerrisk [Florian Weimer]
41038 Add reference to CPU_ALLOC(3)
41039
41040 sched_setattr.2
41041 Michael Kerrisk [Akihiro Suda]
41042 EPERM depends on affinity mask of target thread, not calling thread
41043
41044 select.2
41045 Michael Kerrisk [Josh Triplett]
41046 Document spurious EAGAIN error that can occur on other systems
41047 Light reworking of text proposed by Josh Triplett.
41048 Nikos Mavrogiannopoulos
41049 Mention the 'fd_set' size limitation early and refer to poll(2)
41050 Change this because of the serious limitation of select()
41051 imposing a limit on the range of file descriptors that can
41052 be monitored. This is currently mentioned too late in the
41053 documentation (in the NOTES section). The man page should
41054 warn early and refer to poll(2) as soon as possible.
41055 Michael Kerrisk
41056 Add details on the glibc fixed-size fd_set limitation
41057 No modern application should use select() on Linux.
41058
41059 select_tut.2
41060 Michael Kerrisk
41061 Some readability fixes to example program
41062 Michael Kerrisk
41063 Better variable names in example program
41064 Michael Kerrisk
41065 Simplify 'if' logic in example program
41066 Michael Kerrisk
41067 Use correct type (socklen_t) for addrlen
41068
41069 semctl.2
41070 Michael Kerrisk [Davidlohr Bueso, Manfred Spraul, Philip Semanchuk]
41071 NOTES: note when 'sempid' is set on various implementations
41072 See https://bugzilla.kernel.org/show_bug.cgi?id=112271 and
41073 http://thread.gmane.org/gmane.linux.kernel/2162754/
41074 Subject: [PATCH] Don't set sempid in semctl syscall.
41075 Date: 2016-02-26 12:21:38 GMT
41076
41077 semop.2
41078 Michael Kerrisk
41079 Tweak comment describing 'sempid'
41080
41081 sendfile.2
41082 Askar Safin
41083 Fix incorrect description in text referring to splice(2)
41084 Michael Kerrisk
41085 SEE ALSO: add copy_file_range(2)
41086
41087 setpgid.2
41088 Michael Kerrisk
41089 Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
41090
41091 signalfd.2
41092 Michael Kerrisk
41093 Note that signalfd info is available in /proc/PID/fdinfo
41094
41095 sigprocmask.2
41096 Michael Kerrisk [Mike Frysinger]
41097 Explicitly refer the reader to sigsetops(3)
41098 This man page did not make it obvious which functions
41099 should be used for manipulating signals sets, nor where
41100 those functions were documented.
41101
41102 socketpair.2
41103 Michael Kerrisk [Eric Blake]
41104 Note treatment of 'sv' on error
41105
41106 splice.2
41107 Askar Safin
41108 Improve description of 0 return value.
41109 See https://bugzilla.kernel.org/show_bug.cgi?id=90911
41110
41111 statfs.2
41112 Michael Kerrisk [Jakub Wilk]
41113 Use consistent case for hex constants
41114
41115 sync.2
41116 Christoph Hellwig
41117 Clarify description and document the Linux data integrity guarantees
41118
41119 syscall.2
41120 Mike Frysinger
41121 Add more architectures and improve error documentation
41122 Move the error register documentation into the main table rather
41123 than listing them in sentences after the fact.
41124
41125 Add sparc error return details.
41126
41127 Add details for alpha/arc/m68k/microblaze/nios2/powerpc/superh/
41128 tile/xtensa.
41129
41130 syscalls.2
41131 Michael Kerrisk
41132 Add copy_file_range(2)
41133
41134 times.2
41135 Kondo, Naoya
41136 Fix an incorrect description in NOTES
41137 The text has an incorrect description in NOTES, it says
41138 that (2^32/HZ) - 300 is about 429 million. It is correct
41139 only if HZ=10 which does not look common today. So just
41140 removing "(i.e., about 429 million)" is good enough.
41141
41142 truncate.2
41143 Michael Kerrisk
41144 SEE ALSO: add truncate(1)
41145
41146 uselib.2
41147 Michael Kerrisk
41148 Mention CONFIG_USELIB
41149 Michael Kerrisk
41150 Note that glibc does not support this (obsolete) system call
41151
41152 wait.2
41153 wait4.2
41154 Michael Kerrisk
41155 Rename the "status" argument to "wstatus"
41156 The fact that exit(3)/_exit(2) has an argument called
41157 "status" and the same name is used in the arguments to the
41158 wait*() calls can a little too easily lead the user into
41159 thinking that the two arguments hold the same information,
41160 when of course they don't. So, use a different name
41161 for the argument of the wait*() functions, to reduce
41162 the chances of such confusion.
41163
41164 backtrace.3
41165 Michael Kerrisk [Martin Gebert]
41166 Small fixes to example program
41167
41168 clearenv.3
41169 Michael Kerrisk [Matt Zimmerman]
41170 Clarify the use and effect of clearenv()
41171 See http://bugs.debian.org/679323
41172 Michael Kerrisk
41173 Variables can be added to the environment after calling clearenv()
41174
41175 clog10.3
41176 Michael Kerrisk
41177 Show an alternative equivalence for clog10()
41178 Michael Kerrisk
41179 Update CONFORMING TO
41180 Fix grammar error and add C11.
41181
41182 dl_iterate_phdr.3
41183 Michael Kerrisk [Paul Pluzhnikov]
41184 Describe 'struct dl_phdr_info' fields added in glibc 2.4
41185 See https://bugzilla.kernel.org/show_bug.cgi?id=103011
41186 Michael Kerrisk [Simon Que]
41187 Note that first object visited by 'callback' is the main program
41188 See https://bugzilla.kernel.org/show_bug.cgi?id=94141
41189
41190 errno.3
41191 Michael Kerrisk
41192 Add some explanation of ENOENT error
41193
41194 exec.3
41195 Michael Kerrisk
41196 SEE ALSO: add system(3)
41197
41198 exp.3
41199 Michael Kerrisk [Joachim Wuttke]
41200 SEE ALSO: add expm1(3)
41201
41202 fopen.3
41203 Michael Kerrisk
41204 SEE ALSO: add open_memstream(3)
41205
41206 fts.3
41207 Michael Kerrisk
41208 BUGS: glibc-2.23 now has LFS support for the fts functions
41209
41210 gamma.3
41211 Michael Kerrisk [Alan Cox]
41212 gamma() was documented in SVID 2
41213
41214 getaddrinfo.3
41215 Michael Kerrisk [Andreas Schwab, Orion Poplawski]
41216 Update FTM requirements for glibc 2.22
41217 Since glibc 2.22 getaddrinfo() etc. are only declared for
41218 POSIX.1-2001 or later.
41219
41220 getcwd.3
41221 Michael Kerrisk
41222 SEE ALSO: add pwd(1)
41223
41224 opendir.3
41225 Michael Kerrisk
41226 Help the reader by explicitly mentioning the use of readdir(3)
41227
41228 perror.3
41229 Michael Kerrisk
41230 Suggest use of strerror(3) in place of deprecated 'sys_errlist'
41231
41232 posix_fallocate.3
41233 Jérémie Galarneau
41234 ERRORS: add EINTR
41235 The glibc implementation of posix_fallocate(), which calls
41236 fallocate(), may be interrupted. The fallocate() emulation
41237 also makes use of pread()/pwrite(), which may also be
41238 interrupted.
41239
41240 posix_memalign.3
41241 Michael Kerrisk [Eric Blake]
41242 Note posix_memalign()'s treatment of 'memptr' on error
41243
41244 pthread_setaffinity_np.3
41245 Michael Kerrisk
41246 SEE ALSO: add CPU_SET(3)
41247
41248 queue.3
41249 Dr. Tobias Quathamer
41250 Remove double CONFORMING TO section
41251
41252 rcmd.3
41253 Nikola Forró
41254 Add missing condition concerning .rhosts file
41255 The list of conditions determining if iruserok() and ruserok()
41256 functions automatically fail is incomplete. According to glibc
41257 source code, the functions also fail if the .rhosts file
41258 is hard linked anywhere.
41259
41260 setbuf.3
41261 Michael Kerrisk
41262 SEE ALSO: add stdbuf(1)
41263
41264 setjmp.3
41265 Michael Kerrisk
41266 Rewrite and merge longjmp()/siglongjmp() discussion into this page
41267 The discussion of nonlocal gotos is much easier to read if
41268 setjmp() and longjmp() are discussed in the same page. While
41269 we're at it, rework almost the entire text and add several
41270 more details.
41271 Michael Kerrisk
41272 Note the interactions of longjmp() and non-async-signal-safe functions
41273 POSIX.1-2008 TC2 adds explicit text on this point.
41274 See http://austingroupbugs.net/view.php?id=516#c1195
41275 Michael Kerrisk
41276 Explain why nonlocal gotos make code harder to maintain
41277 Michael Kerrisk
41278 Reword warning on longjmp() to function that has already returned
41279 Michael Kerrisk
41280 Remove reference to obsolete _XOPEN_SOURCE_EXTENDED
41281
41282 sleep.3
41283 Michael Kerrisk
41284 SEE ALSO: add sleep(1)
41285
41286 strftime.3
41287 Michael Kerrisk [Jeremy Harris]
41288 Note which 'tm' fields are used to calculate each output string
41289 See https://bugzilla.redhat.com/show_bug.cgi?id=1162218
41290
41291 strlen.3
41292 Michael Kerrisk [Alan Aversa]
41293 CONFORMING TO: add C11
41294
41295 system.3
41296 Michael Kerrisk
41297 SEE ALSO: add execve(2)
41298
41299 termios.3
41300 Dr. Tobias Quathamer
41301 Document line length in canonical mode
41302 See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/tree/drivers/tty/n_tty.c#n1673
41303 See https://bugs.debian.org/797479
41304 Michael Kerrisk
41305 SEE ALSO: add tty(1)
41306 Michael Kerrisk [Peter Hurley]
41307 Further improvements to recent tweaks of canonical mode 4096 char limit
41308
41309 timegm.3
41310 Michael Kerrisk [Stephen Hurd, Mats Wichmann]
41311 Remove sample implementation of timegm()
41312 Stephen and Mats both question the wisdom of showing a portable
41313 *non-thread-safe* implementation of timegm(), and I find it
41314 hard to disagree. So, remove this code.
41315
41316 See https://bugzilla.kernel.org/show_bug.cgi?id=103701
41317 Michael Kerrisk
41318 Expand DESCRIPTION a little
41319
41320 st4.4
41321 Dr. Tobias Quathamer
41322 Remove spurious copyright section
41323
41324 tty_ioctl.4
41325 Michael Kerrisk
41326 SEE ALSO: add ldattach(1)
41327
41328 elf.5
41329 Michael Kerrisk [Gabriel Corona, Mike Frysinger]
41330 Fix description of STV_PROTECTED
41331 Michael Kerrisk
41332 Improve description of STV_DEFAULT
41333 Michael Kerrisk
41334 Improve description of STV_HIDDEN
41335 Chris Pick
41336 Remove erroneous, duplicate SHN_* section
41337 Michael Kerrisk [Chris Pick]
41338 Reword discussion of range values a little
41339
41340 gai.conf.5
41341 Michael Kerrisk
41342 Add VERSIONS section
41343
41344 group.5
41345 Michael Kerrisk
41346 SEE ALSO: add groups(2)
41347 SEE ALSO: add gpasswd(1)
41348 SEE ALSO: add sg(1)
41349 SE ALSO: add gshadow(5)
41350 SEE ALSO: add chgrp(1)
41351
41352 locale.5
41353 Marko Myllynen [Mike Frysinger]
41354 tel + fax are deprecated
41355
41356 nsswitch.conf.5
41357 Nikola Forró
41358 Update NSS compatibility mode description
41359
41360 utmp.5
41361 Michael Kerrisk
41362 SEE ALSO: add lslogins(1)
41363
41364 aio.7
41365 Andreas Gruenbacher
41366 Improve example
41367 When aio_sigevent.sigev_notify is set to SIGEV_SIGNAL, signal
41368 handlers called for asynchronous I/O operations will have
41369 si->si_code set to SI_ASYNCIO. Check to make sure that
41370 si->si_value.sival_ptr is defined.
41371
41372 capabilities.7
41373 Michael Kerrisk
41374 Explain safety check for capability-dumb binaries
41375 Michael Kerrisk
41376 SEE ALSO: add sg(1), su(1)
41377 SEE ALSO: add id(1), group(5), passwd(5)
41378
41379 credentials.7
41380 Michael Kerrisk
41381 SEE ALSO: add groups(2)
41382
41383 environ.7
41384 Michael Kerrisk
41385 Describe the Bourne "NAME=value command" syntax
41386 Michael Kerrisk
41387 Add some details describing hos shell's environment is initialized
41388 Michael Kerrisk
41389 Note that child of fork(2) inherits copy of parent's environment
41390 Michael Kerrisk
41391 SEE ALSO: add pam_env(3)
41392
41393 epoll.7
41394 Michael Kerrisk
41395 Mention that epoll info is available via /proc/PID/fdinfo
41396
41397 fanotify.7
41398 Michael Kerrisk
41399 Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
41400
41401
41402 feature_test_macros.7
41403 Michael Kerrisk
41404 Add a summary of some FTM key points
41405 Michael Kerrisk
41406 Give an early hint about some macros being defined by default
41407 Michael Kerrisk
41408 Clarify relation between _XOPEN_SOURCE >=500 and _XOPEN_SOURCE_EXTENDED
41409 Emphasize that defining _XOPEN_SOURCE >=500 produces same
41410 effects as defining _XOPEN_SOURCE_EXTENDED.
41411 Michael Kerrisk
41412 Note that man pages don't mention _XOPEN_SOURCE_EXTENDED
41413 As per previous commit, mention of _XOPEN_SOURCE_EXTENDED
41414 has generally been removed from the man pages.
41415 Michael Kerrisk
41416 Note effects of "cc -std=c99" and "cc -std=c11"
41417 Michael Kerrisk
41418 Clarify some _ISOC99_SOURCE / _DEFAULT_SOURCE details
41419 Michael Kerrisk
41420 Clarify that _XOPEN_SOURCE_EXTENDED is obsolete
41421 Since SUSv2, _XOPEN_SOURCE_EXTENDED is no longer specified
41422 in the standard.
41423
41424 inotify.7
41425 Michael Kerrisk
41426 Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
41427
41428 ip.7
41429 Eric Dumazet
41430 Document IP_BIND_ADDRESS_NO_PORT socket option
41431
41432 mq_overview.7
41433 Michael Kerrisk
41434 Note that the close-on-exec flag is automatically set on MQ descriptors
41435
41436 namespaces.7
41437 Michael Kerrisk
41438 SEE ALSO: add lsns(1)
41439 lsns(1) was recently added in util-linux, probably to appear
41440 in next release (2.28?).
41441
41442 pipe.7
41443 Michael Kerrisk [Jason Vas Dias]
41444 Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
41445 Michael Kerrisk
41446 SEE ALSO: add mkfifo(1)
41447
41448 signal.7
41449 Michael Kerrisk
41450 Note the interactions of longjmp() and non-async-signal-safe functions
41451 See http://austingroupbugs.net/view.php?id=516#c1195.
41452
41453 socket.7
41454 Michael Kerrisk
41455 SEE ALSO: add pcap(3)
41456 SEE ALSO: add wireshark(1) and tcpdump(8)
41457
41458 standards.7
41459 Michael Kerrisk
41460 Add POSIX.1-2008 TC2 (POSIX.1-2016)
41461
41462 svipc.7
41463 Michael Kerrisk
41464 Tweak description of 'sempid'
41465 Michael Kerrisk
41466 SEE ALSO: add lsipc(1)
41467
41468 symlink.7
41469 Michael Kerrisk [Zefram]
41470 Some "magic" symlinks have permissions other than 0777
41471 See https://bugs.debian.org/743525
41472
41473 time.7
41474 Michael Kerrisk
41475 SEE ALSO: add timeout(1)
41476 SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)
41477
41478 unicode.7
41479 Dr. Tobias Quathamer
41480 Document private use areas
41481 See https://bugs.debian.org/285444
41482
41483 unix.7
41484 Heinrich Schuchardt
41485 Add example
41486 A complete example demonstrating the usage of sockets for local
41487 interprocess communication is added.
41488 Michael Kerrisk
41489 Introduce term "sequenced-packet" for SOCK_SEQPACKET
41490 Michael Kerrisk
41491 Some wording improvements
41492
41493
41494 ==================== Changes in man-pages-4.06 ====================
41495
41496 Released: 2016-05-09, Oslo
41497
41498
41499 Contributors
41500 ------------
41501
41502 The following people contributed patches/fixes or (noted in brackets
41503 in the changelog below) reports, notes, and ideas that have been
41504 incorporated in changes in this release:
41505
41506 Alexander Miller <alex.miller@gmx.de>
41507 Alon Bar-Lev <alon.barlev@gmail.com>
41508 Benjamin Poirier <bpoirier@suse.com>
41509 Christoph Hellwig <hch@lst.de>
41510 Colin Ian King <colin.king@canonical.com>
41511 Dr. Tobias Quathamer <toddy@debian.org>
41512 Ed Avis <eda@waniasset.com>
41513 Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
41514 Heinrich Schuchardt <xypron.glpk@gmx.de>
41515 Jakub Wilk <jwilk@jwilk.net>
41516 Jordan Birks <birkses@hotmail.com>
41517 Marko Myllynen <myllynen@redhat.com>
41518 Michael Kerrisk <mtk.manpages@gmail.com>
41519 Mike Frysinger <vapier@gentoo.org>
41520 Nikola Forró <nforro@redhat.com>
41521 Rasmus Villemoes <linux@rasmusvillemoes.dk>
41522 Serge E. Hallyn <serge@hallyn.com>
41523 Serge Hallyn <serge.hallyn@ubuntu.com>
41524 Valery Reznic <valery_reznic@yahoo.com>
41525 Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
41526
41527 Apologies if I missed anyone!
41528
41529
41530 New and rewritten pages
41531 -----------------------
41532
41533 cgroups.7
41534 Serge Hallyn, Michael Kerrisk
41535 New page documenting cgroups
41536
41537 cgroup_namespaces.7
41538 Michael Kerrisk [Serge Hallyn]
41539 New page describing cgroup namespaces
41540
41541
41542 Newly documented interfaces in existing pages
41543 ---------------------------------------------
41544
41545 clone.2
41546 Michael Kerrisk
41547 Document CLONE_NEWCGROUP
41548
41549 readv.2
41550 Christoph Hellwig
41551 Document preadv2() and pwritev2()
41552 setns.2
41553 Michael Kerrisk
41554 Document CLONE_NEWCGROUP
41555
41556 unshare.2
41557 Michael Kerrisk
41558 Document CLONE_NEWCGROUP
41559
41560
41561 Changes to individual pages
41562 ---------------------------
41563
41564 clock_getres.2
41565 Michael Kerrisk [Rasmus Villemoes]
41566 Note that coarse clocks need architecture and VDSO support
41567
41568 clone.2
41569 fork.2
41570 Nikola Forró
41571 Document ERESTARTNOINTR error code
41572
41573 clone.2
41574 Michael Kerrisk [Colin Ian King]
41575 ERRORS: add EINVAL for improperly aligned 'child_stack' value
41576
41577 execve.2
41578 Michael Kerrisk [Valery Reznic]
41579 Since Linux 2.6.28, recursive script interpretation is supported
41580
41581 fcntl.2
41582 Michael Kerrisk
41583 Note that mandatory locking is now governed by a configuration option
41584
41585 fsync.2
41586 Michael Kerrisk [Georg Sauthoff]
41587 Give some examples of files where sync can fail with EINVAL
41588
41589 getrlimit.2
41590 Michael Kerrisk
41591 SEE ALSO: add cgroups(7)
41592
41593 ioctl_fat.2
41594 Heinrich Schuchardt
41595 Use %04x to print volume ID
41596 Leading zeroes should be used when display a FAT volume ID.
41597
41598 ioprio_set.2
41599 Michael Kerrisk
41600 SEE ALSO: add cgroups(7)
41601
41602 lseek.2
41603 Michael Kerrisk
41604 Note that 'off_t' is an integer data type defined by POSIX
41605
41606 memfd_create.2
41607 Michael Kerrisk
41608 Note that memfd_create() does not have a glibc wrapper
41609
41610 mount.2
41611 Michael Kerrisk
41612 MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
41613
41614 quotactl.2
41615 Michael Kerrisk
41616 Document Q_GETNEXTQUOTA and Q_XGETNEXTQUOTA
41617 Michael Kerrisk
41618 Rework/reorder ERRORS list
41619 Make into a single alphabetically ordered list
41620 Michael Kerrisk
41621 Note kernel version that removed Q_GETSTATS
41622 Michael Kerrisk
41623 Add kernel version for G_GETINFO, Q_SETINFO, and Q_GETFMT
41624
41625 readv.2
41626 Michael Kerrisk
41627 Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
41628
41629 semctl.2
41630 Michael Kerrisk
41631 From kernel 4.6, Linux now updates 'sempid' on SETALL operations
41632
41633 sigaction.2
41634 Michael Kerrisk
41635 Document SEGV_BNDERR
41636 Michael Kerrisk
41637 Document SEGV_PKUERR
41638
41639 syscalls.2
41640 Michael Kerrisk
41641 Add preadv2() and pwritev2()
41642
41643 write.2
41644 Michael Kerrisk
41645 Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
41646
41647 makedev.3
41648 Mike Frysinger
41649 Use <sys/sysmacros.h> in SYNOPSIS
41650 Defining these functions via <sys/types.h> causes problems for
41651 some folk. As noted by Zack Wein:
41652
41653 libstdc++ force-enables _GNU_SOURCE, which means people
41654 writing in C++ _can't_ avoid these nonstandard macros by
41655 using a strict conformance mode.
41656
41657 Since glibc has basically always used <sys/sysmacros.h>,
41658 update the docs to have people include that instead.
41659 Michael Kerrisk
41660 NOTES: mention that <sys/types.h> may also define these macros
41661
41662 popen.3
41663 Nikola Forró
41664 RETURN VALUE: describe successful case
41665 Reference:
41666 http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
41667 http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html
41668
41669 strtod.3
41670 Michael Kerrisk [Ed Avis]
41671 Improve a detail in RETURN VALUE
41672
41673 core.5
41674 Michael Kerrisk
41675 Document /proc/sys/kernel/core_pipe_limit
41676
41677 locale.5
41678 Marko Myllynen
41679 Adjust LC_IDENTIFICATION / abbreviation
41680 Tiny tweak to locale.5 based on the on ISO/IEC TR 14652:
41681
41682 http://www.open-std.org/jtc1/SC22/WG20/docs/n972-14652ft.pdf
41683 Marko Myllynen
41684 Update LC_ADDRESS after glibc change
41685 This patch updates locale.5 to match the recent glibc change
41686 in commit a837257199ffab76237385b830cc7b6179fc2f18
41687 Marko Myllynen
41688 Complete LC_COLLATE
41689 Here's the first attempt to (almost) complete the locale.5 manual
41690 page by documenting all (but perhaps one) of the missing
41691 LC_COLLATE keywords.
41692 Mike Frysinger
41693 country_car: Add a better description
41694
41695
41696 nsswitch.conf.5
41697 Marko Myllynen
41698 Document group merging
41699 Document the recently merged glibc group merge support.
41700 Glibc commit ced8f8933673f4efda1d666d26a1a949602035ed
41701 https://sourceware.org/glibc/wiki/Proposals/GroupMerging
41702
41703 proc.5
41704 Michael Kerrisk
41705 Move /proc/PID/cgroup discussion to cgroups(7) page
41706 Michael Kerrisk
41707 Add some background on why /proc/PID/mountinfo was added
41708 Michael Kerrisk
41709 Improve description of /proc/PID/mountinfo 'root' field
41710 Michael Kerrisk
41711 Add pointer to cgroups(7) for documentation of /proc/cgroups
41712 Michael Kerrisk
41713 Add reference to core(5) for info on /proc/sys/kernel/core_pipe_limit
41714
41715 cpuset.7
41716 Michael Kerrisk
41717 SEE ALSO: add cgroups(7)
41718
41719 ip.7
41720 Benjamin Poirier
41721 Fix incorrect sockopt name
41722 "IP_LEAVE_GROUP" does not exist. It was perhaps a confusion with
41723 MCAST_LEAVE_GROUP. Change the text to IP_DROP_MEMBERSHIP which has
41724 the same function as MCAST_LEAVE_GROUP and is documented in the
41725 ip.7 man page.
41726
41727 Reference:
41728 Linux kernel net/ipv4/ip_sockglue.c do_ip_setsockopt()
41729
41730 namespaces.7
41731 Michael Kerrisk
41732 SEE ALSO: add cgroups(7), cgroup_namespaces(7)
41733
41734 vdso.7
41735 Zubair Lutfullah Kakakhel [Mike Frysinger]
41736 Update for MIPS
41737 Document the symbols exported by the MIPS VDSO.
41738 VDSO support was added from kernel 4.4 onwards.
41739
41740 See https://git.kernel.org/cgit/linux/kernel/git/torvalds/linux.git/log/arch/mips/vdso
41741 Michael Kerrisk [Rasmus Villemoes]
41742 The __kernel_clock_* interfaces don't support *_COARSE clocks on PowerPC
41743
41744 ld.so.8
41745 Michael Kerrisk [Alon Bar-Lev]
41746 Document use of $ORIGIN, $LIB, and $PLATFORM in environment variables
41747 These strings are meaningful in LD_LIBRARY_PATH and LD_PRELOAD.
41748
41749
41750 ==================== Changes in man-pages-4.07 ====================
41751
41752 Released: 2016-07-17, Ulm
41753
41754
41755 Contributors
41756 ------------
41757
41758 The following people contributed patches/fixes or (noted in brackets
41759 in the changelog below) reports, notes, and ideas that have been
41760 incorporated in changes in this release:
41761
41762 Alec Leamas <leamas.alec@gmail.com>
41763 Andrey Vagin <avagin@openvz.org>
41764 Andy Lutomirski <luto@amacapital.net>
41765 Carsten Grohmann <carstengrohmann@gmx.de>
41766 Chris Gassib <position0x45@hotmail.com>
41767 Christoph Hellwig <hch@lst.de>
41768 Darren Hart <dvhart@infradead.org>
41769 Darrick J. Wong <darrick.wong@oracle.com>
41770 Élie Bouttier <elie@bouttier.eu>
41771 Eric Biggers <ebiggers3@gmail.com>
41772 Eric W. Biederman <ebiederm@xmission.com>
41773 Florian Weimer <fweimer@redhat.com>
41774 Håkon Sandsmark <hsandsma@cisco.com>
41775 Iustin Pop <iustin@k1024.org>
41776 Jacob Willoughby <jacob@spacemonkey.com>
41777 Jakub Wilk <jwilk@jwilk.net>
41778 James H Cownie <james.h.cownie@intel.com>
41779 Jann Horn <jann@thejh.net>
41780 John Wiersba <jrw32982@yahoo.com>
41781 Jörn Engel <joern@purestorage.com>
41782 Josh Triplett <josh@kernel.org>
41783 Kai Mäkisara <kai.makisara@kolumbus.fi>
41784 Kees Cook <keescook@chromium.org>
41785 Keno Fischer <keno@juliacomputing.com>
41786 Li Peng <lip@dtdream.com>
41787 Marko Kevac <marko@kevac.org>
41788 Marko Myllynen <myllynen@redhat.com>
41789 Michael Kerrisk <mtk.manpages@gmail.com>
41790 Michał Zegan <webczat_200@poczta.onet.pl>
41791 Miklos Szeredi <mszeredi@redhat.com>
41792 Mitch Walker <mitch@gearnine.com>
41793 Neven Sajko <nsajko@gmail.com>
41794 Nikos Mavrogiannopoulos <nmav@redhat.com>
41795 Omar Sandoval <osandov@fb.com>
41796 Ori Avtalion <ori@avtalion.name>
41797 Rahul Bedarkar <rahulbedarkar89@gmail.com>
41798 Robin Kuzmin <kuzmin.robin@gmail.com>
41799 Rob Landley <rob@landley.net>
41800 Shawn Landden <shawn@churchofgit.com>
41801 Stefan Puiu <stefan.puiu@gmail.com>
41802 Stephen Smalley <sds@tycho.nsa.gov>
41803 Szabolcs Nagy <szabolcs.nagy@arm.com>
41804 Thomas Gleixner <tglx@linutronix.de>
41805 Tobias Stoeckmann <tobias@stoeckmann.org>
41806 Tom Callaway <tcallawa@redhat.com>
41807 Tom Gundersen <teg@jklm.no>
41808 Vince Weaver <vincent.weaver@maine.edu>
41809 W. Trevor King <wking@tremily.us>
41810 "Yuming Ma(马玉明)" <mayuming@le.com>
41811
41812 Apologies if I missed anyone!
41813
41814
41815 New and rewritten pages
41816 -----------------------
41817
41818 ioctl_fideduperange.2
41819 Darrick J. Wong [Christoph Hellwig, Michael Kerrisk]
41820 New page documenting the FIDEDUPERANGE ioctl
41821 Document the FIDEDUPERANGE ioctl, formerly known as
41822 BTRFS_IOC_EXTENT_SAME.
41823
41824 ioctl_ficlonerange.2
41825 Darrick J. Wong [Christoph Hellwig, Michael Kerrisk]
41826 New page documenting FICLONE and FICLONERANGE ioctls
41827 Document the FICLONE and FICLONERANGE ioctls, formerly known as
41828 the BTRFS_IOC_CLONE and BTRFS_IOC_CLONE_RANGE ioctls.
41829
41830 nextup.3
41831 Michael Kerrisk
41832 New page documenting nextup(), nextdown(), and related functions
41833
41834 mount_namespaces.7
41835 Michael Kerrisk [Michael Kerrisk]
41836 New page describing mount namespaces
41837
41838
41839 Newly documented interfaces in existing pages
41840 ---------------------------------------------
41841
41842 mount.2
41843 Michael Kerrisk
41844 Document flags used to set propagation type
41845 Document MS_SHARED, MS_PRIVATE, MS_SLAVE, and MS_UNBINDABLE.
41846 Michael Kerrisk
41847 Document the MS_REC flag
41848
41849 ptrace.2
41850 Michael Kerrisk [Kees Cook, Jann Horn, Eric W. Biederman, Stephen Smalley]
41851 Document ptrace access modes
41852
41853 proc.5
41854 Michael Kerrisk
41855 Document /proc/[pid]/timerslack_ns
41856 Michael Kerrisk
41857 Document /proc/PID/status 'Ngid' field
41858 Michael Kerrisk
41859 Document /proc/PID/status fields: 'NStgid', 'NSpid', 'NSpgid', 'NSsid'
41860 Michael Kerrisk
41861 Document /proc/PID/status 'Umask' field
41862
41863
41864 New and changed links
41865 ---------------------
41866
41867 preadv2.2
41868 pwritev2.2
41869 Michael Kerrisk
41870 New links to readv(2)
41871
41872 nextdown.3
41873 nextdownf.3
41874 nextdownl.3
41875 nextupf.3
41876 nextupl.3
41877 Michael Kerrisk
41878 New links to nextup(3)
41879
41880
41881 Changes to individual pages
41882 ---------------------------
41883
41884 ldd.1
41885 Michael Kerrisk
41886 Add a little more detail on why ldd is unsafe with untrusted executables
41887 Michael Kerrisk
41888 Add more detail on the output of ldd
41889
41890 localedef.1
41891 Marko Myllynen
41892 Drop --old-style description
41893 The glibc upstream decided to drop localedef(1) --old-style
41894 option [1] altogether, I think we can do the same with
41895 localedef(1), the option hasn't done anything in over 16
41896 years and I doubt anyone uses it.
41897
41898 add_key.2
41899 Mitch Walker
41900 Empty payloads are not allowed in user-defined keys
41901
41902 chroot.2
41903 Michael Kerrisk
41904 SEE ALSO: add pivot_root(2)
41905
41906 clone.2
41907 Michael Kerrisk
41908 Add reference to mount_namespaces(7) under CLONE_NEWNS description
41909
41910 fork.2
41911 Michael Kerrisk
41912 Add ENOMEM error for PID namespace where "init" has died
41913
41914 futex.2
41915 Michael Kerrisk
41916 Correct an ENOSYS error description
41917 Since Linux 4.5, FUTEX_CLOCK_REALTIME is allowed with FUTEX_WAIT.
41918 Michael Kerrisk [Darren Hart]
41919 Remove crufty text about FUTEX_WAIT_BITSET interpretation of timeout
41920 Since Linux 4.5, FUTEX_WAIT also understands
41921 FUTEX_CLOCK_REALTIME.
41922 Michael Kerrisk [Thomas Gleixner]
41923 Explain how to get equivalent of FUTEX_WAIT with an absolute timeout
41924 Michael Kerrisk
41925 Describe FUTEX_BITSET_MATCH_ANY
41926 Describe FUTEX_BITSET_MATCH_ANY and FUTEX_WAIT and FUTEX_WAKE
41927 equivalences.
41928 Michael Kerrisk
41929 Note that at least one bit must be set in mask for BITSET operations
41930 At least one bit must be set in the 'val3' mask supplied for the
41931 FUTEX_WAIT_BITSET and FUTEX_WAKE_BITSET operations.
41932 Michael Kerrisk [Thomas Gleixner, Darren Hart]
41933 Fix descriptions of various timeouts
41934 Michael Kerrisk
41935 Clarify clock default and choices for FUTEX_WAIT
41936
41937 getitimer.2
41938 Michael Kerrisk
41939 Substantial rewrites to various parts of the page
41940 Michael Kerrisk [Tom Callaway]
41941 Change license to note that page may be modified
41942 The page as originally written carried text that said the page may
41943 be freely distributed but made no statement about modification.
41944 In the 20+ years since it was first written, the page has in fact
41945 seen repeated, sometimes substantial, modifications, and only a
41946 small portion of the original text remains. One could I suppose
41947 rewrite the last few pieces that remain from the original,
41948 but as the largest contributor to the pages existing text,
41949 I'm just going to relicense it to explicitly note that
41950 modification is permitted. (I presume the failure by the
41951 original author to grant permission to modify was simply an
41952 oversight; certainly, the large number of people who have
41953 changed the page have taken that to be the case.)
41954
41955 See also https://bugzilla.kernel.org/show_bug.cgi?id=118311
41956
41957 get_mempolicy.2
41958 Michael Kerrisk [Jörn Engel]
41959 Correct rounding to 'maxnodes' (bits, not bytes)
41960 Michael Kerrisk [Jörn Engel]
41961 Fix prototype for get_mempolicy()
41962 In numaif.h, 'addr' is typed as 'void *'
41963
41964 getpriority.2
41965 Michael Kerrisk
41966 Make discussion of RLIMIT_NICE more prominent
41967 The discussion of RLIMIT_NICE was hidden under the EPERM error,
41968 where it was difficult to find. Place some relevant text in
41969 DESCRIPTION.
41970 Michael Kerrisk
41971 Note that getpriority()/setpriority deal with same attribute as nice(2)
41972 Michael Kerrisk [Robin Kuzmin]
41973 Clarify equivalence between lower nice value and higher priority
41974
41975 get_robust_list.2
41976 Michael Kerrisk
41977 get_robust_list() is governed by PTRACE_MODE_READ_REALCREDS
41978
41979 ioctl.2
41980 Michael Kerrisk
41981 SEE ALSO: add ioctl_fideduperange(2) and ioctl_ficlonerange(2)
41982
41983 kcmp.2
41984 Michael Kerrisk
41985 kcmp() is governed by PTRACE_MODE_READ_REALCREDS
41986 Shawn Landden
41987 Note about SECURITY_YAMA
41988 kill.2
41989 Michael Kerrisk [John Wiersba]
41990 Clarify the meaning if sig==0
41991
41992 lookup_dcookie.2
41993 Michael Kerrisk
41994 SEE ALSO: add oprofile(1)
41995
41996 mmap.2
41997 Michael Kerrisk [Rahul Bedarkar]
41998 EXAMPLE: for completeness, add munmap() and close() calls
41999
42000 mount.2
42001 Michael Kerrisk
42002 Restructure discussion of 'mountflags' into functional groups
42003 The existing text makes no differentiation between different
42004 "classes" of mount flags. However, certain flags such as
42005 MS_REMOUNT, MS_BIND, MS_MOVE, etc. determine the general
42006 type of operation that mount() performs. Furthermore, the
42007 choice of which class of operation to perform is performed in
42008 a certain order, and that order is significant if multiple
42009 flags are specified. Restructure and extend the text to
42010 reflect these details.
42011 Michael Kerrisk
42012 Relocate text on multimounting and mount stacking to NOTES
42013 The text was somewhat out of place in its previous location;
42014 NOTES is a better location.
42015 Michael Kerrisk
42016 Remove version numbers attached to flags that are modifiable on remount
42017 This information was simply bogus. Mea culpa.
42018 Michael Kerrisk
42019 Refer reader to mount_namespaces(7) for details on propagation types
42020 Michael Kerrisk
42021 SEE ALSO: s/namespaces(7)/mount_namespaces(7)/
42022 Omar Sandoval
42023 MS_BIND still ignores mountflags
42024 This is clear from the do_mount() function in the kernel as of v4.6.
42025 Michael Kerrisk
42026 Note the default treatment of ATIME flags during MS_REMOUNT
42027 The behavior changed in Linux 3.17.
42028 Michael Kerrisk
42029 Clarify that MS_MOVE ignores remaining bits in 'mountflags'
42030 Michael Kerrisk
42031 Note kernel version that added MS_MOVE
42032 Michael Kerrisk
42033 MS_NOSUID also disables file capabilities
42034 Michael Kerrisk
42035 Relocate/demote/rework text on MS_MGC_VAL
42036 The use of this constant has not been needed for 15 years now.
42037 Michael Kerrisk
42038 Clarify that 'source' and 'target' are pathnames, and can refer to files
42039 Michael Kerrisk
42040 Update example list of filesystem types
42041 Put more modern examples in; remove many older examples.
42042 Michael Kerrisk
42043 MS_LAZYTIME and MS_RELATIME can be changed on remount
42044 Michael Kerrisk
42045 Explicitly note that MS_DIRSYNC setting cannot be changed on remount
42046 Michael Kerrisk
42047 Move text describing 'data' argument higher up in page
42048 In preparation for other reworking.
42049 Michael Kerrisk
42050 Since Linux 2.6.26, bind mounts can be made read-only
42051
42052 open.2
42053 Eric Biggers
42054 Refer to correct functions in description of O_TMPFILE
42055
42056 pciconfig_read.2
42057 Michael Kerrisk [Tom Callaway]
42058 Change license to note that page may be modified
42059 Niki Rahimi, the author of this page, has agreed that it's okay
42060 to change the license to note that the page can be modified.
42061
42062 See https://bugzilla.kernel.org/show_bug.cgi?id=118311
42063
42064 perf_event_open.2
42065 Michael Kerrisk
42066 If pid > 0, the operation is governed by PTRACE_MODE_READ_REALCREDS
42067 Jann Horn
42068 Document new perf_event_paranoid default
42069 Keno Fischer [Vince Weaver]
42070 Add a note that dyn_size is omitted if size == 0
42071 The perf_output_sample_ustack in kernel/events/core.c only writes
42072 a single 64 bit word if it can't dump the user registers. From the
42073 current version of the man page, I would have expected two 64 bit
42074 words (one for size, one for dyn_size). Change the man page to
42075 make this behavior explicit.
42076
42077 prctl.2
42078 Michael Kerrisk
42079 Some wording improvements in timer slack description
42080 Michael Kerrisk
42081 Refer reader to discussion of /proc/[pid]/timerslack_ns
42082 Under discussion of PR_SET_TIMERSLACK, refer the reader to
42083 the /proc/[pid]/timerslack_ns file, documented in proc(5).
42084
42085 process_vm_readv.2
42086 Michael Kerrisk
42087 Rephrase permission rules in terms of a ptrace access mode check
42088
42089 ptrace.2
42090 Michael Kerrisk [Jann Horn]
42091 Update Yama ptrace_scope documentation
42092 Reframe the discussion in terms of PTRACE_MODE_ATTACH checks,
42093 and make a few other minor tweaks and additions.
42094 Michael Kerrisk, Jann Horn
42095 Note that user namespaces can be used to bypass Yama protections
42096 Michael Kerrisk
42097 Note that PTRACE_SEIZE is subject to a ptrace access mode check
42098 Michael Kerrisk
42099 Rephrase PTRACE_ATTACH permissions in terms of ptrace access mode check
42100
42101 quotactl.2
42102 Michael Kerrisk [Jacob Willoughby]
42103 'dqb_curspace' is in bytes, not blocks
42104 This error appears to have been injected into glibc
42105 when copying some headers from BSD.
42106
42107 See https://bugs.debian.org/825548
42108
42109 recv.2
42110 Michael Kerrisk [Tom Gundersen]
42111 With pending 0-length datagram read() and recv() with flags == 0 differ
42112
42113 setfsgid.2
42114 setfsuid.2
42115 Jann Horn [Michael Kerrisk]
42116 Fix note about errors from the syscall wrapper
42117 See sysdeps/unix/sysv/linux/i386/setfsuid.c in glibc-2.2.1.
42118 (This code is not present in modern glibc anymore.)
42119 Michael Kerrisk
42120 Move glibc wrapper notes to "C library/kernel differences" subsection
42121
42122 sysinfo.2
42123 Michael Kerrisk
42124 Rewrite and update various pieces
42125
42126 umask.2
42127 Michael Kerrisk
42128 NOTES: Mention /proc/PID/status 'Umask' field
42129
42130 umount.2
42131 Michael Kerrisk
42132 SEE ALSO: add mount_namespaces(7)
42133
42134 unshare.2
42135 Michael Kerrisk
42136 Add reference to mount_namespaces(7) under CLONE_NEWNS description
42137
42138 utimensat.2
42139 Michael Kerrisk [Rob Landley]
42140 Note that the glibc wrapper disallows pathname==NULL
42141
42142 wait.2
42143 Michael Kerrisk
42144 Since Linux 4.7, __WALL is implied if child being ptraced
42145 Michael Kerrisk
42146 waitid() now (since Linux 4.7) also supports __WNOTHREAD/__WCLONE/__WALL
42147
42148 assert.3
42149 Nikos Mavrogiannopoulos
42150 Improved description
42151 Removed text referring to text not being helpful to users. Provide
42152 the error text instead to allow the reader to determine whether it
42153 is helpful. Recommend against using NDEBUG for programs to
42154 exhibit deterministic behavior. Moved description ahead of
42155 recommendations.
42156 Michael Kerrisk
42157 Clarify details of message printed by assert()
42158
42159 fmax.3
42160 fmin.3
42161 Michael Kerrisk
42162 SEE ALSO: add fdim(3)
42163
42164 getauxval.3
42165 Cownie, James H
42166 Correct AT_HWCAP result description
42167
42168 inet_pton.3
42169 Stefan Puiu
42170 Mention byte order
42171
42172 malloc_hook.3
42173 Michael Kerrisk
42174 glibc 2.24 removes __malloc_initialize_hook
42175
42176 memmem.3
42177 Michael Kerrisk [Shawn Landden]
42178 Note that memmem() is present on some other systems
42179
42180 mkdtemp.3
42181 mktemp.3
42182 Michael Kerrisk
42183 SEE ALSO: add mktemp(1)
42184
42185 printf.3
42186 Michael Kerrisk [Shawn Landden]
42187 Note support in other C libraries for %m and %n
42188
42189 strcasecmp.3
42190 Michael Kerrisk [Ori Avtalion]
42191 Make details of strncasecmp() comparison clearer
42192
42193 strcat.3
42194 Michael Kerrisk
42195 Add a program that shows the performance characteristics of strcat()
42196 In honor of Joel Spolksy's visit to Munich, let's start educating
42197 Schlemiel The Painter.
42198
42199 strtoul.3
42200 Michael Kerrisk
42201 SEE ALSO: add a64l(3)
42202
42203 strxfrm.3
42204 Michael Kerrisk [Florian Weimer]
42205 Remove NOTES section
42206 strxfrm() and strncpy() are not precisely equivalent in the
42207 POSIX locale, so this NOTES section was not really correct.
42208
42209 See https://bugzilla.kernel.org/show_bug.cgi?id=104221
42210
42211 console_codes.4
42212 console_ioctl.4
42213 tty.4
42214 vcs.4
42215 charsets.7
42216 Marko Myllynen
42217 Remove console(4) references
42218 0f9e647 removed the obsolete console(4) page but we still have few
42219 references to it. The patch below removes them or converts to refs
42220 to console_ioctl(4) where appropriate.
42221
42222 console_ioctl.4
42223 Michael Kerrisk [Chris Gassib]
42224 The argument to KDGETMODE is an 'int'
42225
42226 lirc.4
42227 Alec Leamas
42228 Update after upstreamed lirc.h, bugfixes.
42229
42230 st.4
42231 Kai Mäkisara
42232 Fix description of read() when block is larger than request
42233 Kai Mäkisara
42234 Update MTMKPART for kernels >= 4.6
42235 Update the description of the MTMKPART operation of MTIOCTOP to match
42236 the changes in kernel version 4.6.
42237
42238 charmap.5
42239 Marko Myllynen
42240 Clarify keyword syntax
42241 Updates charmap(5) to match the syntax all the glibc
42242 charmap files are using currently.
42243
42244 elf.5
42245 Michael Kerrisk
42246 SEE ALSO: add readelf(1)
42247
42248 locale.5
42249 Marko Myllynen
42250 Document missing keywords, minor updates
42251 Marko Myllynen
42252 Clarify keyword syntax
42253 Marko Myllynen
42254 Adjust conformance
42255
42256 proc.5
42257 namespaces.7
42258 Michael Kerrisk
42259 Move /proc/PID/mounts information to proc(5)
42260 There was partial duplication, and some extra information
42261 in namespaces(7). Move everything to proc(5).
42262
42263 proc.5
42264 Michael Kerrisk
42265 /proc/PID/fd/* are governed by PTRACE_MODE_READ_FSCREDS
42266 Permission to dereference/readlink /proc/PID/fd/* symlinks is
42267 governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42268 Michael Kerrisk
42269 /proc/PID/timerslack_ns is governed by PTRACE_MODE_ATTACH_FSCREDS
42270 Permission to access /proc/PID/timerslack_ns is governed by
42271 a PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
42272 Michael Kerrisk
42273 Document /proc/PID/{maps,mem,pagemap} access mode checks
42274 Permission to access /proc/PID/{maps,pagemap} is governed by a
42275 PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42276
42277 Permission to access /proc/PID/mem is governed by a
42278 PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
42279 Michael Kerrisk
42280 Note /proc/PID/stat fields that are governed by PTRACE_MODE_READ_FSCREDS
42281 Michael Kerrisk
42282 /proc/PID/{cwd,exe,root} are governed by PTRACE_MODE_READ_FSCREDS
42283 Permission to dereference/readlink /proc/PID/{cwd,exe,root} is
42284 governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42285 Michael Kerrisk
42286 /proc/PID/io is governed by PTRACE_MODE_READ_FSCREDS
42287 Permission to access /proc/PID/io is governed by
42288 a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42289 Michael Kerrisk
42290 /proc/PID/{personality,stack,syscall} are governed by PTRACE_MODE_ATTACH_FSCREDS
42291 Permission to access /proc/PID/{personality,stack,syscall} is
42292 governed by a PTRACE_MODE_ATTACH_FSCREDS ptrace access mode check.
42293 Michael Kerrisk
42294 /proc/PID/{auxv,environ,wchan} are governed by PTRACE_MODE_READ_FSCREDS
42295 Permission to access /proc/PID/{auxv,environ,wchan} is governed by
42296 a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42297 Michael Kerrisk
42298 Move shared subtree /proc/PID/mountinfo fields to mount_namespaces(7)
42299 Move information on shared subtree fields in /proc/PID/mountinfo
42300 to mount_namespaces(7).
42301 Michael Kerrisk ["Yuming Ma(马玉明)"]
42302 Note that /proc/net is now virtualized per network namespace
42303 Michael Kerrisk
42304 Add references to mount_namespaces(7)
42305
42306 repertoiremap.5
42307 Marko Myllynen
42308 Clarify keyword syntax
42309
42310 utmp.5
42311 Michael Kerrisk
42312 SEE ALSO: add logname(1)
42313
42314 capabilities.7
42315 Michael Kerrisk [Andy Lutomirski]
42316 Note on SECURE_NO_CAP_AMBIENT_RAISE for capabilities-only environment
42317 Michael Kerrisk
42318 Add a detail on use of securebits
42319
42320 cgroup_namespaces.7
42321 Michael Kerrisk
42322 SEE ALSO: add namespaces(7)
42323
42324 cgroups.7
42325 Michael Kerrisk
42326 ERRORS: add mount(2) EBUSY error
42327
42328 cp1251.7
42329 cp1252.7
42330 iso_8859-1.7
42331 iso_8859-15.7
42332 iso_8859-5.7
42333 koi8-r.7
42334 koi8-u.7
42335 Marko Myllynen
42336 Add some charset references
42337 Add some references to related charsets here and there.
42338
42339 credentials.7
42340 Michael Kerrisk
42341 SEE ALSO: add runuser(1)
42342 SEE ALSO: add newgrp(1)
42343 SEE ALSO: add sudo(8)
42344
42345 feature_test_macros.7
42346 Michael Kerrisk
42347 Emphasize that applications should not directly include <features.h>
42348
42349 man-pages.7
42350 Michael Kerrisk
42351 Clarify which sections man-pages provides man pages for
42352 Michael Kerrisk [Josh Triplett]
42353 Add a few more details on formatting conventions
42354 Add some more details for Section 1 and 8 formatting.
42355 Separate out formatting discussion into commands, functions,
42356 and "general".
42357
42358 namespaces.7
42359 Michael Kerrisk
42360 /proc/PID/ns/* are governed by PTRACE_MODE_READ_FSCREDS
42361 Permission to dereference/readlink /proc/PID/ns/* symlinks is
42362 governed by a PTRACE_MODE_READ_FSCREDS ptrace access mode check.
42363 Michael Kerrisk
42364 Nowadays, file changes in /proc/PID/mounts are notified differently
42365 Exceptional condition for select(), (E)POLLPRI for (e)poll
42366 Michael Kerrisk
42367 Remove /proc/PID/mountstats description
42368 This is a duplicate of information in proc(5).
42369 Michael Kerrisk
42370 Refer to new mount_namespaces(7) for information on mount namespaces
42371
42372 netlink.7
42373 Andrey Vagin
42374 Describe netlink socket options
42375 Michael Kerrisk
42376 Rework version information
42377 (No changes in technical details.)
42378
42379 pid_namespaces.7
42380 Michael Kerrisk
42381 SEE ALSO: add namespaces(7)
42382
42383 unix.7
42384 Michael Kerrisk
42385 Move discussion on pathname socket permissions to DESCRIPTION
42386 Michael Kerrisk
42387 Expand discussion of socket permissions
42388 Michael Kerrisk
42389 Fix statement about permissions needed to connect to a UNIX domain socket
42390 Read permission is not required (verified by experiment).
42391 Michael Kerrisk
42392 Clarify ownership and permissions assigned during socket creation
42393 Michael Kerrisk [Carsten Grohmann]
42394 Update text on socket permissions on other systems
42395 At least some of the modern BSDs seem to check for write
42396 permission on a socket. (I tested OpenBSD 5.9.) On Solaris 10,
42397 some light testing suggested that write permission is still
42398 not checked on that system.
42399 Michael Kerrisk
42400 Note that umask / permissions have no effect for abstract sockets
42401 W. Trevor King
42402 Fix example code: 'ret' check after accept populates 'data_socket'
42403 Michael Kerrisk
42404 Move some abstract socket details to a separate subsection
42405 Michael Kerrisk
42406 Note that abstract sockets automatically disappear when FDs are closed
42407
42408 user_namespaces.7
42409 Michael Kerrisk [Michał Zegan]
42410 Clarify meaning of privilege in a user namespace
42411 Having privilege in a user NS only allows privileged
42412 operations on resources governed by that user NS. Many
42413 privileged operations relate to resources that have no
42414 association with any namespace type, and only processes
42415 with privilege in the initial user NS can perform those
42416 operations.
42417
42418 See https://bugzilla.kernel.org/show_bug.cgi?id=120671
42419 Michael Kerrisk [Michał Zegan]
42420 List the mount operations permitted by CAP_SYS_ADMIN
42421 List the mount operations permitted by CAP_SYS_ADMIN in a
42422 noninitial userns.
42423
42424 See https://bugzilla.kernel.org/show_bug.cgi?id=120671
42425 Michael Kerrisk [Michał Zegan]
42426 CAP_SYS_ADMIN allows mounting cgroup filesystems
42427 See https://bugzilla.kernel.org/show_bug.cgi?id=120671
42428 Michael Kerrisk
42429 Clarify details of CAP_SYS_ADMIN and cgroup v1 mounts
42430 With respect to cgroups version 1, CAP_SYS_ADMIN in the user
42431 namespace allows only *named* hierarchies to be mounted (and
42432 not hierarchies that have a controller).
42433 Michael Kerrisk
42434 Clarify CAP_SYS_ADMIN details for mounting FS_USERNS_MOUNT filesystems
42435 Michael Kerrisk
42436 Correct user namespace rules for mounting /proc
42437 Michael Kerrisk
42438 Describe a concrete example of capability checking
42439 Add a concrete example of how the kernel checks capabilities in
42440 an associated user namespace when a process attempts a privileged
42441 operation.
42442 Michael Kerrisk
42443 Correct kernel version where XFS added support for user namespaces
42444 Linux 3.12, not 3.11.
42445 Michael Kerrisk
42446 SEE ALSO: add ptrace(2)
42447 SEE ALSO: add cgroup_namespaces(7)
42448
42449 utf-8.7:
42450 Shawn Landden
42451 Include RFC 3629 and clarify endianness which is left ambiguous
42452 The endianness is suggested by the order the bytes are displayed,
42453 but the text is ambiguous.
42454
42455
42456 ==================== Changes in man-pages-4.08 ====================
42457
42458 Released: 2016-10-08, Munich
42459
42460
42461 Contributors
42462 ------------
42463
42464 The following people contributed patches/fixes or (noted in brackets
42465 in the changelog below) reports, notes, and ideas that have been
42466 incorporated in changes in this release:
42467
42468 Arnaud Gaillard <arnaud.mgaillard@gmail.com>
42469 Bill Pemberton <wfp5p@worldbroken.com>
42470 Carlos O'Donell <carlos@redhat.com>
42471 Christoph Hellwig <hch@lst.de>
42472 David Turner <novalis@novalis.org>
42473 Dr. Tobias Quathamer <toddy@debian.org>
42474 Elliott Hughes <enh@google.com>
42475 Eugene Syromyatnikov <evgsyr@gmail.com>
42476 Heinrich Schuchardt <xypron.glpk@gmx.de>
42477 Hu Keping <hukeping@huawei.com>
42478 Igor Liferenko <igor.liferenko@gmail.com>
42479 Ivan Kharpalev <ivan.kharpalev@gmail.com>
42480 Jakub Wilk <jwilk@jwilk.net>
42481 Jann Horn <jann@thejh.net>
42482 Josh Triplett <josh@joshtriplett.org>
42483 Keno Fischer <keno@juliacomputing.com>
42484 Laurent Georget <laurent.georget@supelec.fr>
42485 Local Lembke <logan@blackhillsinfosec.com>
42486 Mats Wichmann <mats@wichmann.us>
42487 Michael Kerrisk <mtk.manpages@gmail.com>
42488 Mike Crowe <mac@mcrowe.com>
42489 Mike Frysinger <vapier@gentoo.org>
42490 Namhyung Kim <namhyung@gmail.com>
42491 Nikola Forró <nforro@redhat.com>
42492 Patrick McLean <patrickm@gaikai.com>
42493 Peter Wu <peter@lekensteyn.nl>
42494 Petr Cermak <petrcermak@chromium.org>
42495 Quentin Rameau <quinq@fifth.space>
42496 Ray Bellis <ray@isc.org>
42497 Rich Felker <dalias@libc.org>
42498 Ruben Kerkhof <ruben@rubenkerkhof.com>
42499 Sam Varshavchik <mrsam@courier-mta.com>
42500 Sebastian Andrzej Siewior <bigeasy@linutronix.de>
42501 Siward de Groot <siward@wanadoo.nl>
42502 Sloane Bernstein <sloane@cpanel.net>
42503 Stefan Tauner <tauner@technikum-wien.at>
42504 Tim Savannah <kata198@gmail.com>
42505 Ursache Vladimir <f35f22fan@gmail.com>
42506 Zefram <zefram@fysh.org>
42507 王守堰 <wangshouyan@gmail.com>
42508
42509 Apologies if I missed anyone!
42510
42511
42512 New and rewritten pages
42513 -----------------------
42514
42515 quotactl.2
42516 Eugene Syromyatnikov [Michael Kerrisk]
42517 Updated information regarding disk quota flags
42518 Added information regarding DQF_SYS_FILE flag; updated definition
42519 of V1_DQF_RSQUASH, which has been defined privately and defined
42520 publicly as DQF_ROOT_SQUASH.
42521 Eugene Syromyatnikov
42522 Updated information regarding XFS-specific quotactl subcommands
42523 Added information regarding structure definitions used for
42524 XFS-specific subcommands, updated flag constants, added
42525 information regarding ignored syscall arguments, added notes on
42526 usage of kernel UAPI header.
42527 Eugene Syromyatnikov
42528 Additions regarding project quotas
42529 Added information regarding presence of project quotas.
42530
42531 bswap.3
42532 Michael Kerrisk
42533 New page documenting bswap_16(), bswap_32(), and bswap_64()
42534
42535 cgroups.7
42536 Michael Kerrisk
42537 Substantial rewrites, additions, and corrections.
42538
42539
42540 Newly documented interfaces in existing pages
42541 ---------------------------------------------
42542
42543 readv.2
42544 Michael Kerrisk
42545 Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
42546
42547 proc.5
42548 Michael Kerrisk
42549 Document /proc/PID/seccomp
42550 Jann Horn
42551 Document /proc/[pid]/task/[tid]/children
42552 Document the /proc/[pid]/task/[tid]/children interface from
42553 CRIU, and more importantly, document why it's usually not
42554 a good interface.
42555
42556
42557 New and changed links
42558 ---------------------
42559
42560 bswap_16.3
42561 bswap_32.3
42562 bswap_64.3
42563 New link to new bswap.3
42564
42565
42566 Global changes
42567 --------------
42568
42569 Various pages
42570 Michael Kerrisk
42571 Fix section ordering
42572 Various pages had sections in an order different from
42573 that prescribed in man-pages(7).
42574
42575 Various pages
42576 Michael Kerrisk [Mike Frysinger]
42577 Consistently use /proc/[pid] (not /proc/PID)
42578
42579 Various pages
42580 Michael Kerrisk
42581 Fix order of SEE ALSO entries
42582 Entries should be ordered first by section, and then alphabetically
42583 within the section.
42584
42585 Various pages
42586 Michael Kerrisk
42587 Order ERRORS alphabetically
42588
42589 Various pages
42590 Michael Kerrisk
42591 Remove section number from page self reference
42592 Fix places where pages refer to the function that they describe
42593 and include a section number in that reference. Such references
42594 cause some HTML-rendering tools to create self-references in the
42595 page.
42596
42597 A few pages
42598 Michael Kerrisk
42599 Eliminate groff "cannot adjust line" warnings
42600
42601
42602 Changes to individual pages
42603 ---------------------------
42604
42605 pldd.1
42606 Michael Kerrisk [Carlos O'Donell]
42607 Note gdb(1) command that can be used as a replacement for pldd
42608 Taken from Carlos O'Donnell's suggestion in
42609 https://sourceware.org/bugzilla/show_bug.cgi?id=18035#c2
42610 Michael Kerrisk
42611 BUGS: pldd has not worked since glibc 2.19
42612
42613 accept.2
42614 Michael Kerrisk
42615 Mention epoll(7) alongside poll()/select()
42616 Michael Kerrisk
42617 Demote discussion of DECNet to NOTES
42618 DECNet ceased to be important long ago...
42619
42620 adjtimex.2
42621 Nikola Forró
42622 Fix kernel version references
42623
42624 chroot.2
42625 Michael Kerrisk
42626 Note user namespace requirements for CAP_SYS_CHROOT
42627
42628 clone.2
42629 Keno Fischer [Josh Triplett]
42630 Adjust syscall prototype and expand CLONE_SETTLS description
42631 Michael Kerrisk [Josh Triplett, Josh Triplett]
42632 Document raw syscall interfaces on various other architectures
42633 Michael Kerrisk
42634 Change types for 'ptid' and 'ctid' in syscall prototypes
42635 These types changed from 'void *' to 'int *' back in Linux 3.8.
42636 Michael Kerrisk
42637 EINVAL is generated by glibc wrapper for NULL 'fn' or 'child_stack'
42638 Clarify that this error is produced by the wrapper function, not
42639 the underlying system call. In particular, the point is that the
42640 raw system call can accommodate a NULL pointer for 'child_stack'.
42641 Michael Kerrisk [Elliott Hughes]
42642 Make the implications of CLONE_FILES more explicit
42643 If CLONE_FILES is not set, the duplicated FDs nevertheless share
42644 file offset and status flags via the open file description.
42645 Michael Kerrisk
42646 Mention kcmp() under notes
42647
42648 close.2
42649 Michael Kerrisk
42650 Add mention of the close-on-exec flag
42651 Michael Kerrisk
42652 Clarify discussion noting that close() does not flush buffer cache
42653
42654 epoll_wait.2
42655 Mike Crowe
42656 Clarify that the timeout is measured against CLOCK_MONOTONIC
42657
42658 execve.2
42659 Michael Kerrisk
42660 Mention use of 'environ' to access environment list
42661 Michael Kerrisk
42662 Note that real UID, real GID, and supplementary GIDs are unchanged
42663
42664 fanotify_init.2
42665 Heinrich Schuchardt
42666 Update BUGS information
42667
42668 fcntl.2
42669 Michael Kerrisk
42670 Note an important detail of F_SETOWN permission rules for signals
42671 F_SETOWN records the caller's credentials at the time of
42672 the fcntl() call, and it is these saved credentials that
42673 are used for subsequent permission checks.
42674 Michael Kerrisk
42675 Make the description of the effect of close-on-exec a little clearer
42676 Michael Kerrisk
42677 Clarify that F_GETFD and F_GETFL return flags via the function result
42678
42679 fork.2
42680 Michael Kerrisk
42681 PID of new process also does not match any existing session ID
42682
42683 fsync.2
42684 Michael Kerrisk
42685 SEE ALSO: add pwritev(2)
42686 Since Linux 4.7, pwritev() has flags related to I/O
42687 integrity completion.
42688
42689 getdomainname.2
42690 Michael Kerrisk
42691 Note user namespace requirements for CAP_SYS_ADMIN
42692
42693 getgroups.2
42694 Michael Kerrisk
42695 Note user namespace requirements for CAP_SETGID
42696
42697 gethostname.2
42698 Michael Kerrisk
42699 Note user namespace requirements for CAP_SYS_ADMIN
42700
42701 getrlimit.2
42702 Michael Kerrisk
42703 Note user namespace semantics for CAP_SYS_RESOURCE
42704
42705 getsid.2
42706 Michael Kerrisk
42707 Rework description to be somewhat clearer
42708 Michael Kerrisk
42709 Correct the definition of "session ID"
42710
42711 getunwind.2
42712 Michael Kerrisk
42713 Simplify text referring to vdso(7)
42714 The detail given here is redundant, since this info is also
42715 in vdso(7).
42716
42717 kcmp.2
42718 Michael Kerrisk
42719 Add an example program
42720
42721 kill.2
42722 Michael Kerrisk
42723 Note the user namespace requirement for CAP_KILL
42724
42725 killpg.2
42726 Michael Kerrisk
42727 Refer reader to kill(2) for signal permission rules
42728
42729 mlock.2
42730 Sebastian Andrzej Siewior
42731 Document that fork() after mlock() may be a bad idea in a RT process
42732
42733 mmap.2
42734 Jann Horn
42735 Describe treatment of 'offset' for MAP_ANONYMOUS
42736 Michael Kerrisk [Siward de Groot]
42737 Small improvement to description of MAP_SHARED
42738 See https://sourceware.org/bugzilla/show_bug.cgi?id=6887
42739
42740 msgctl.2
42741 msgget.2
42742 msgop.2
42743 semctl.2
42744 semget.2
42745 semop.2
42746 shmctl.2
42747 shmget.2
42748 shmop.2
42749 Michael Kerrisk
42750 Note the user namespace requirements for CAP_IPC_OWNER
42751
42752 open.2
42753 Michael Kerrisk
42754 Clarify user namespace capability requirements for O_NOATIME
42755 Michael Kerrisk
42756 NOTES: kcmp() can be used to test if two FDs refer to the same OFD
42757 Michael Kerrisk
42758 F2FS support for O_TMPFILE was added in Linux 3.16
42759 Michael Kerrisk
42760 Clarify the rules about how the group ID of a new file is determined
42761
42762 prctl.2
42763 Michael Kerrisk
42764 Refer to proc(5) for effects of dumpability on ownership of /proc/PID/*
42765 Michael Kerrisk
42766 ERRORS: Add EACCES error for PR_SET_SECCOMP-SECCOMP_MODE_FILTER
42767 Michael Kerrisk
42768 Simplify list of cases where "dumpable" attribute is reset
42769 Michael Kerrisk
42770 Note user namespace requirements for PR_CAPBSET_DROP CAP_SETPCAP
42771
42772 readlink.2
42773 Michael Kerrisk [Ursache Vladimir]
42774 Make example program handle links that report a size of zero
42775 Some "magic" symlinks created by the kernel (e.g., those under
42776 /proc and /sys) report 'st_size' as zero. Modify the example
42777 program to handle that possibility.
42778 Michael Kerrisk
42779 Emphasize that truncation of returned buffer generates no error
42780
42781 readv.2
42782 Michael Kerrisk [Christoph Hellwig]
42783 Clarify that RWF_DSYNC and RWF_SYNC apply only to data being written
42784 Michael Kerrisk
42785 Add preadv2() and pwritev2() to NAME line
42786
42787 reboot.2
42788 Michael Kerrisk
42789 Note user namespace requirements around CAP_SYS_BOOT
42790
42791 rename.2
42792 Michael Kerrisk [Tim Savannah]
42793 Clarify that ERRORS may cause rename to fail (not to be nonatomic)
42794
42795 sched_setaffinity.2
42796 Michael Kerrisk
42797 Note user namespace requirements for CAP_SYS_NICE
42798
42799 seccomp.2
42800 Michael Kerrisk
42801 CAP_SYS_ADMIN is required only in caller's user namespace
42802
42803 select_tut.2
42804 Peter Wu
42805 Fix various issues in example program
42806
42807 seteuid.2
42808 Michael Kerrisk
42809 Note user namespace requirements for CAP_SETUID and CAP_SETGID
42810
42811 setgid.2
42812 Michael Kerrisk
42813 Note user namespace requirements for CAP_SETGID
42814
42815 setpgid.2
42816 Michael Kerrisk
42817 Add a reference to credentials(7)
42818
42819 setpgid.2
42820 setsid.2
42821 Michael Kerrisk
42822 Relocate some text on sessions and sessions leaders
42823 Some text that was in setpgid(2) is better placed in setsid(2).
42824
42825 setresuid.2
42826 Michael Kerrisk
42827 Note user namespace requirements for CAP_SETUID
42828
42829 setreuid.2
42830 Michael Kerrisk
42831 Note user namespace requirements for CAP_SETUID and CAP_SETGID
42832
42833 setsid.2
42834 Michael Kerrisk
42835 Refer to credentials(7) for details for details on controlling terminal
42836 Refer to credentials(7) for details of how a session obtains
42837 a controlling terminal.
42838
42839 set_thread_area.2
42840 Michael Kerrisk
42841 Add get_thread_area() to NAME
42842
42843 setuid.2
42844 Michael Kerrisk
42845 Note user namespace requirements for CAP_SETUID
42846
42847 sigprocmask.2
42848 Keno Fischer
42849 Expand/clarify libc/kernel sigset_t difference
42850
42851 stat.2
42852 Michael Kerrisk [Ursache Vladimir, Mats Wichmann]
42853 Improve discussion of 'st_size' for /proc and /sys files
42854 Michael Kerrisk
42855 _BSD_SOURCE and _SVID_SOURCE no longer expose nanosecond timestamps
42856
42857 umask.2
42858 Michael Kerrisk
42859 Provide a rationale for the existence of /proc/PID/status 'Umask' field
42860
42861 wait.2
42862 Michael Kerrisk
42863 Remove erroneous statement that waitpid() is implemented via wait4()
42864 There is a fallback to wait4(), but only if the kernel does
42865 not provide a waitpid() system call.
42866
42867 bindresvport.3
42868 rcmd.3
42869 ip.7
42870 Michael Kerrisk
42871 Note user namespace requirements for CAP_NET_BIND_SERVICE
42872
42873 byteorder.3
42874 Michael Kerrisk
42875 SEE ALSO: add bswap(3)
42876
42877 dlopen.3
42878 Michael Kerrisk
42879 dlmopen() is still broken in glibc 2.24
42880
42881 endian.3
42882 Michael Kerrisk
42883 SEE ALSO: add bswap(3)
42884
42885 ffs.3
42886 Michael Kerrisk [Stefan Tauner]
42887 Correct feature test macro requirements
42888
42889 fmemopen.3
42890 Michael Kerrisk [Rich Felker]
42891 Remove bogus suggestion to use setbuffer()
42892
42893 getlogin.3
42894 Michael Kerrisk
42895 Update feature test macro requirements for cuserid()
42896
42897 getumask.3
42898 Michael Kerrisk
42899 Note that getumask() is still unavailable in glibc 2.24
42900 Michael Kerrisk
42901 Point to umask(2) for a thread-safe way to discover process's umask
42902
42903 mkstemp.3
42904 Quentin Rameau
42905 Fix _POSIX_C_SOURCE value for mkstemp()
42906 The correct _POSIX_C_SOURCE value has always been 200809L,
42907 not 200112L.
42908
42909 pthread_join.3
42910 Michael Kerrisk [Mats Wichmann]
42911 Note that the caller might do clean up after joining with a thread
42912 Michael Kerrisk [王守堰]
42913 Clarify use of 'retval' pointer
42914
42915 resolver.3
42916 Ray Bellis
42917 Correct arguments to res_ninit(res_state statep)
42918
42919 strverscmp.3
42920 Michael Kerrisk
42921 Add an example program
42922
42923 wcstombs.3
42924 Michael Kerrisk [Igor Liferenko]
42925 wcsrtombs() does not provide thread-safe interface to same functionality
42926 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
42927
42928 core.5
42929 Mike Frysinger [Michael Kerrisk]
42930 Add more details for output paths and the crash handler
42931 People sometimes assume that the crash handler runs in the same
42932 context as the crashing process. They would be incorrect :).
42933
42934 proc.5
42935 Mike Frysinger
42936 Clarify the root symlink and mount namespaces
42937 If the target process is in a different mount namespace, the root
42938 symlink actually shows that view of the filesystem.
42939 Michael Kerrisk [Mike Frysinger]
42940 Expand discussion of /proc/[pid]/root
42941 Add a shell example showing that /proc/[pid]/root is more
42942 than a symlink. Based on an example provided by Mike Frysinger
42943 in an earlier commit message.
42944 Michael Kerrisk
42945 Explain rules determining ownership of /proc/PID/* files
42946 Describe the effect of the "dumpable" attribute on ownership
42947 of /proc/PID files.
42948 Michael Kerrisk
42949 Note effect of 'suid_dumpable' on ownership of /proc/PID files
42950 Michael Kerrisk
42951 Refer to ptrace(2) for info on effect of suid_dumpable on ptraceability
42952 Michael Kerrisk
42953 Add reference to core(5) in discussion of 'suid_dumpable'
42954 Michael Kerrisk
42955 Note that 'suid_dumpable' mode 1 is insecure
42956 Michael Kerrisk
42957 Document /proc/meminfo '+ShmemHugePages' and 'ShmemPmdMapped' fields
42958 Michael Kerrisk
42959 Document /proc/PID/status 'RssAnon', 'RssFile', and 'RssShmem' fields
42960 Michael Kerrisk
42961 Document /proc/PID/status 'HugetlbPages' field
42962 Michael Kerrisk [Zefram]
42963 Clarify that /proc/PID/statm 'shared' field counts *resident* pages
42964 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=741360
42965 Michael Kerrisk
42966 Add reference to umask(2) in discussion of /proc/PID/status 'Umask'
42967 Michael Kerrisk
42968 Clarify user namespace requirements for /proc/sys/fs/protected_hardlinks
42969 Michael Kerrisk
42970 Note changes to config option governing /proc/[pid]/task/[tid]/children
42971 Michael Kerrisk
42972 Clarify description of /proc/PID/statm 'lib' and 'dt' fields
42973 These fields are always zero since Linux 2.6.
42974 Namhyung Kim [Petr Cermak]
42975 Add description of CLEAR_REFS_MM_HIWATER_RSS
42976 Michael Kerrisk
42977 Update example VM values in /proc/PID/status
42978
42979 capabilities.7
42980 Michael Kerrisk
42981 Add note about nosuid to file capabilities section
42982 Michael Kerrisk
42983 SEE ALSO: add proc(5)
42984 Michael Kerrisk
42985 SEE ALSO: add setsid(2) and setpgid(2)
42986
42987 glob.7
42988 Michael Kerrisk [Arnaud Gaillard]
42989 Clarify that syntactically incorrect patterns are left unchanged
42990
42991 packet.7
42992 Michael Kerrisk
42993 Clarify user namespace requirements for CAP_NET_RAW
42994
42995 pipe.7
42996 Michael Kerrisk [Patrick McLean]
42997 Document FIONREAD
42998
42999 raw.7
43000 Michael Kerrisk
43001 Clarify user namespace requirements for CAP_NET_RAW
43002 Also remove mention of UID 0 as a method or creating
43003 a raw socket. As far as I can tell from reading the
43004 kernel source (net/ipv4/af_inet.c), this is not true.
43005
43006 socket.7
43007 Michael Kerrisk
43008 SIOCSPGRP: refer to fcntl(2) F_SETOWN for correct permission rules
43009 The permission rules described for SIOCCPGRP are wrong. Rather
43010 than repeat the rules here, just refer the reader to fcntl(2),
43011 where the rules are described for F_SETOWN.
43012
43013 unix.7
43014 Michael Kerrisk [Laurent Georget, Ivan Kharpalev]
43015 Remove mention of recvmsg() from discussion of EPIPE error
43016 See https://bugzilla.kernel.org/show_bug.cgi?id=137351
43017
43018 ld.so.8
43019 Michael Kerrisk
43020 Expand description of LD_DEBUG
43021 Provide a list of the categories, and note that multiple
43022 categories can be specified.
43023 Michael Kerrisk
43024 Add glibc version for LD_USE_LOAD_BIAS
43025 Michael Kerrisk
43026 Clarify text describing whether secure-mode programs preload libraries
43027 Michael Kerrisk
43028 Remove discussion of environment variables understood by libc5
43029 libc5 disappeared long ago, so cease cluttering up this page
43030 with those ancient details. Thus, remove discussion of the
43031 following environment variables: LD_AOUT_LIBRARY_PATH,
43032 LD_AOUT_PRELOAD, LD_KEEPDIR, LD_NOWARN, and LDD_ARGV0.
43033 Michael Kerrisk
43034 Remove text with ancient libc4 and Linux libc details
43035 Michael Kerrisk
43036 Remove mention of "ELF only"
43037 Drawing a distinction between ELF-only features versus a,out
43038 ceased to be relevant long ago, so cluttering the page
43039 with "ELF-only" serves no purpose.
43040