]> git.ipfire.org Git - thirdparty/man-pages.git/blame - Changes.old
namespaces.7: ffix
[thirdparty/man-pages.git] / Changes.old
CommitLineData
0680aa5b
MK
1==================== Changes in man-pages-2.00 ====================
2
971b7dbf 3Released: 2004-12-16
0680aa5b
MK
4
5Contributors
6------------
7
8The following people contributed notes, ideas, or patches that have
9been incorporated in changes in this release:
10
11Alberto Bertogli <albertogli@telpin.com.ar>
12Anand Kumria <wildfire@progsoc.org>
13Andrey Kiselev <dron@ak4719.spb.edu>
14Andries Brouwer <Andries.Brouwer@cwi.nl>
15Chris Green <cmg@dok.org>
16Branden Robinson <branden@debian.org>
17Emmanuel Colbus <emmanuel.colbus@ensimag.imag.fr>
18Enrico Zini <enrico@debian.org>
19Eric Estievenart <eric.estievenart@free.fr>
20Fabian Kreutz <kreutz@dbs.uni-hannover.de>
21Florian Weimer <fw@deneb.enyo.de>
22Jan Kuznik <kuznik@gepro.cz>
23Joey (Martin) Schulze <joey@infodrom.org>
24Johannes Berg <johannes@sipsolutions.de>
25John V. Belmonte <jbelmonte@debian.org>
26Karel Kulhavy <clock@twibright.com>
f687d451 27Luis Javier Merino Morán <ljmerino@pandasoftware.es>
0680aa5b
MK
28Martin Pool <mbp@sourcefrog.net>
29Richard Kreckel <Richard.Kreckel@ginac.de>
30Vasya Pupkin <ptushnik@gmail.com>
31
32Apologies if I missed anyone!
33
34Global changes
35--------------
36
8fa20889 37Various pages
28b3a122 38 Fabian Kreutz
752cb57f
MK
39 Many math pages had their synopses compressed, as per suggestion
40 from Fabian Kreutz.
0680aa5b 41
8fa20889
MK
42Various 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.
0680aa5b 48
8fa20889
MK
49Various pages
50 mtk
51 For consistency, all instances of "super-user" were changed
752cb57f 52 to the more common "superuser".
0680aa5b 53
8fa20889
MK
54Various 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.
0680aa5b 58
8fa20889
MK
59 In addition:
60 -- erroneous semicolons at the end of _syscallN() were removed
61 on various pages.
0680aa5b 62
8fa20889
MK
63 -- types such as "uint" in syscallN() declarations were changed
64 to "unsigned int", etc.
0680aa5b 65
8fa20889 66 -- various other minor breakages in the synopses were fixed.
0680aa5b 67
8fa20889 68 The affected pages are:
0680aa5b
MK
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
82Typographical or grammatical errors have been corrected in several
83other places.
84
258755b2
MK
85Changes to individual pages
86---------------------------
0680aa5b
MK
87
88bind.2
89 Florian Weimer
90 Added 'const' to declaration of 'my_addr' in prototype.
8fa20889 91 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762.
0680aa5b
MK
92
93fcntl.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
101getrlimit.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
8fa20889 105 2.6.9 changes.
0680aa5b 106 Added note on RLIMIT_CPU error in older kernels.
8fa20889 107 Added RLIMIT_SIGPENDING.
0680aa5b
MK
108 Also made a few other minor changes.
109
110getrusage.2
111 mtk
112 This page is new(ish) -- it was created by splitting
8fa20889 113 getrlimit.2.
0680aa5b 114
755b5e17 115 Repaired note on SIGCHLD behavior to note that the
8fa20889 116 POSIX non-conformance has been fixed in 2.6.9.
0680aa5b
MK
117
118kill.2
119 Modified after suggestion from Emmanuel Colbus
120 Changed wording of sentence under NOTES describing
8fa20889 121 when signals can be sent to init(1).
0680aa5b 122
8fa20889
MK
123mlock.2
124munlock.2
125mlockall.2
126munlockall.2
0680aa5b
MK
127 These have been consolidated into a single mlock.2 page.
128 In the process, much duplication was eliminated
8fa20889
MK
129 and new information was added about RLIMIT_MEMLOCK
130 and the changes in memory locking in kernel 2.6.9,
0680aa5b
MK
131
132mmap.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
138msgctl.2
8fa20889 139 mtk
0680aa5b
MK
140 Substantial language and formatting clean-ups.
141 Added msqid_ds and ipc_perm structure definitions.
142
143msgget.2
8fa20889 144 mtk
0680aa5b
MK
145 Substantial language and formatting clean-ups.
146 Added notes on /proc files.
147
148msgop.2
8fa20889 149 mtk
0680aa5b
MK
150 Substantial language and formatting clean-ups.
151 Added notes on /proc files.
152
153open.2
154 Martin Pool
155 Added O_NOATIME (new in Linux 2.6.8)
156 mtk
157 Reordered list of 'flags' description alphabetically
158
159personality.2
28b3a122 160 2004-11-03 applied patch from Martin Schulze
0680aa5b
MK
161
162semctl.2
8fa20889 163 mtk
0680aa5b
MK
164 Substantial language and formatting clean-ups.
165 Rewrote semun text.
166 Added semid_ds and ipc_perm structure definitions.
167
168semget.2
8fa20889 169 mtk
0680aa5b
MK
170 Substantial language and formatting clean-ups.
171 Added notes on /proc files.
755b5e17 172 Rewrote BUGS note about semget()'s failure to initialize
8fa20889 173 semaphore values.
0680aa5b
MK
174
175semop.2
8fa20889 176 mtk
0680aa5b
MK
177 Substantial language and formatting clean-ups.
178 Added notes on /proc files.
179
180shmctl.2
8fa20889 181 mtk
0680aa5b
MK
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
8fa20889 186 since kernel 2.6.9.
0680aa5b
MK
187 Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
188 Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
189
190shmget.2
8fa20889 191 mtk
0680aa5b
MK
192 Substantial language and formatting clean-ups.
193 Added notes on /proc files.
194
195shmop.2
8fa20889 196 mtk
0680aa5b
MK
197 Substantial language and formatting clean-ups.
198 Changed wording and placement of sentence regarding attachment
8fa20889 199 of segments marked for destruction.
0680aa5b
MK
200
201sigaction.2
8fa20889 202 mtk
0680aa5b
MK
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
210signal.2
211 mtk
258755b2 212 Removed text on ignoring SIGCHLD; replaced with pointer
8fa20889 213 to sigaction.2.
0680aa5b
MK
214
215sigwaitinfo.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
2ed34e11 220stat.2
0680aa5b 221 Enrico Zini
258755b2 222 Added text to clarify that S_IS*() macros should be applied to
0680aa5b
MK
223 st_mode field.
224 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
225
226swapon.2
cc1d6beb
MK
227 After Debian bug report from Anand Kumria
228 Added "no swap space signature" to EINVAL error.
0680aa5b
MK
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
234times.2
235 mtk
258755b2 236 In Linux 2.6, the return value of times changed; it is no
8fa20889 237 longer time since boot, but rather:
0680aa5b 238
8fa20889 239 boot_time + 2^32 / HZ - 300
0680aa5b 240
755b5e17 241 Repaired note on SIGCHLD behavior to note that the
8fa20889 242 POSIX non-conformance has been fixed in 2.6.9.
0680aa5b
MK
243 Some formatting fixes.
244
245undocumented.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
253wait.2
254 mtk
255 Added waitid(2).
256 Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
257 Added text on SA_NOCLDSTOP.
755b5e17 258 Updated discussion of SA_NOCLDWAIT to reflect 2.6 behavior.
0680aa5b
MK
259 Much other text rewritten.
260
261wait4.2
262 mtk
263 Rewrote this page, removing much duplicated information,
8fa20889 264 and replacing with pointers to wait.2.
f687d451 265 Luis Javier Merino Morán / mtk
0680aa5b
MK
266 CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD"
267
268waitid.2
269 mtk
270 New link to wait.2
271
272assert.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
258755b2 276
0680aa5b
MK
277ctime.3
278 mtk
258755b2 279 Noted that 0 in tm_mday is interpreted to mean the last day
8fa20889 280 of the preceding month.
0680aa5b
MK
281
282getnameinfo.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
289killpg.3
290 mtk
291 Minor changes to SEE ALSO and CONFORMING TO.
292
293lseek64.3
294 aeb
295 New page by Andries Brouwer
296
297tzset.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
302printf.3
258755b2 303 After bug report from Jan Kuznik
0680aa5b
MK
304 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
305 Fixed bad realloc() use in snprintf() example
306
2ed34e11
MK
307realpath.3
308 mtk
309 Added discussion of resolved_path == NULL.
310
0680aa5b
MK
311random.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
317proc.5
318 mtk
319 Updated description of /proc/loadavg to include
8fa20889 320 nr_running(), nr_threads, last_pid.
0680aa5b
MK
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
0680aa5b
MK
326boot.7
327 applied patch from Martin Schulze
328
329capabilities.7
330 mtk
331 Added O_NOATIME for CAP_FOWNER
332
258755b2 333netdevice.7
0680aa5b 334 Karel Kulhavy and AEB
1d924504 335 Formatting fix after note from Karel Kulhavy and AEB, plus a
8fa20889 336 few wording fixes.
258755b2 337
0680aa5b
MK
338signal.7
339 mtk
26785b48 340 /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
8fa20889 341 in kernel 2.6.8.
258755b2 342
0680aa5b 343tcp.7
8fa20889 344 mtk/aeb
0680aa5b 345 Updated details of interaction of TCP_CORK and TCP_NODELAY.
9651df75
MK
346
347==================== Changes in man-pages-2.01 ====================
348
971b7dbf 349Released: 2004-12-20
9651df75
MK
350
351Contributors
352------------
353
354The following people contributed notes, ideas, or patches that have
355been incorporated in changes in this release:
356
357Carsten Hey <c.hey@web.de>
358Johannes Berg <johannes@sipsolutions.de>
359Joshua Kwan <joshk@triplehelix.org>
360Marek Habersack <grendel@debian.org>
361Martin Schulze <joey@infodrom.org>
362Matthew Dempsky <jivera@flame.org>
363Matthew Gregan <kinetik@orcon.net.nz>
364Pedro Zorzenon Neto <pzn@terra.com.br>
365Tony Crawford <tony@klosterdorf.de>
366
367Apologies if I missed anyone!
368
369Global changes
370--------------
371
8fa20889
MK
372accept.2
373close.2
374send.2
375setsid.2
376socket.2
377closedir.3
378initgroups.3
379mkstemp.3
380opendir.3
381readdir.3
382telldir.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.
9651df75
MK
386
387Typographical or grammatical errors have been corrected in several
388other places.
389
258755b2
MK
390Changes to individual pages
391---------------------------
9651df75
MK
392
393sendfile.2
394 mtk
258755b2 395 Adjusted descriptions of argument file types to be closer to
8fa20889
MK
396 2.6 reality.
397 Wording and formatting changes.
9651df75
MK
398
399ctan.3
400ctanh.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
405errno.3
406 Martin Schulze, mtk
407 Removed errno declaration from prototype, added notes
8fa20889 408 on historical need for this declaration.
9651df75
MK
409 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
410
411aio_return.3
8fa20889
MK
412 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
413 Changed erroneous "aio_return(2)" to "aio_return(3)".
9651df75
MK
414
415posix_openpt.3
416 mtk
417 New by mtk
418
419ptsname.3
420 mtk
421 Added description of ptsname_r().
422 Added ERRORS.
423
424ptsname_r.3
425 mtk
e8a09504 426 New link to ptsname.3.
9651df75
MK
427
428shm_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
433strcasecmp.3
40a54b37 434 Marek Habersack
9651df75
MK
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
258755b2 439
9651df75
MK
440strfry.3
441 Joshua Kwan
442 Added _GNU_SOURCE to prototype
443 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
258755b2 444
9651df75
MK
445strftime.3
446 Cartsen Hey
447 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
448
f5fed0f6 449 Changed range for "%S" from 0..61 to 0..60.
9651df75 450
258755b2 451 SUSv3 says 0..60. I think the manual page probably says
9651df75 452 0..61, because that's what SUSv2 said.
258755b2 453 (Some other implementations' man pages also say 0..61 --
9651df75
MK
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
258755b2 458 Given that SUSv3 says 0..60, I've changed the
9651df75
MK
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
465sysconf.3
8fa20889
MK
466 Johannes Berg
467 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
9651df75
MK
468 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
469 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
470
471system.3
258755b2 472 Pedro Zorzenon
9651df75 473 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
e360219d
MK
474 Noted use of _XOPEN_SOURCE to get macros from <stdlib.h>
475 for wait(2).
9651df75
MK
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
755b5e17 481 of the shell if 'command' is NULL, rather than the older behavior
9651df75
MK
482 of assuming the shell exists and always returning 1 if
483 'command' is NULL.
484
485 Other wording and formatting clean-ups.
486
487undocumented.3
488 Remove some functions names that *are* documented.
4667b1b5
MK
489
490
491==================== Changes in man-pages-2.02 ====================
492
493Released: 2005-04-14
494
495Contributors
496------------
497
498The following people contributed notes, ideas, or patches that have
499been incorporated in changes in this release:
500
501Andries Brouwer <Andries.Brouwer@cwi.nl>
502Branden Robinson <branden@debian.org>
503Colin Watson <cjwatson@debian.org>
504David Lloyd <dmlloyd@tds.net>
258755b2 505Gordon Jin <gordon.jin@intel.com>
4667b1b5
MK
506Heikki Orsila <shd@modeemi.cs.tut.fi>
507Jamie Lokier <jamie@shareable.org>
508Johan Walles
509Kai Makisara <Kai.Makisara@kolumbus.fi>
510Marko Kohtala <marko.kohtala@gmail.com>
511Martin Pool <mbp@sourcefrog.net>
512Martin (Joey) Schulze <joey@infodrom.org>
513Matthias Lang <matthias@corelatus.se>
514Michael Haardt <michael@moria.de>
f687d451 515Michael Mühlebach <michael@anduin.ch>
4667b1b5
MK
516Mike Frysinger <vapier@gentoo.org>
517Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
518Serguei Leontiev <leo@sai.msu.ru>
519
520Apologies if I missed anyone!
521
522Global changes
523--------------
524
8fa20889
MK
525ctime.3
526tzselect.8
527zdump.8
528zic.8
529 Martin (Joey) Schulze
58ce1507 530 Removed SEE ALSO reference to nonexistent newctime(3).
4667b1b5
MK
531 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
532
533Typographical or grammatical errors have been corrected in several
534other places.
535
258755b2
MK
536Changes to individual pages
537---------------------------
4667b1b5
MK
538
539clone.2
540 mtk
755b5e17 541 Noted the PID caching behavior of NPTL's getpid()
4667b1b5
MK
542 wrapper under BUGS.
543
258755b2 544 Added futex(2), set_thread_area(2), set_tid_address(2),
4667b1b5
MK
545 tkill(2) under SEE ALSO.
546
547epoll_ctl.2
548epoll_create.2
549 Marko Kohtala / mtk
550 Improved various error descriptions.
551
552epoll_wait.2
553 David Lloyd / Mike Frysinger, Marko Kohtala
554 Added EINTR to errors.
555
556fcntl.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
565link.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
577mincore.2
578 mtk, after note from Gordon Jin
8fa20889 579 Updated ERRORS.
4667b1b5
MK
580
581pipe.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.
258755b2 585 (Pipes are implemented as STREAMS on the former, and
4667b1b5
MK
586 sockets on the latter.)
587
588posix_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
593rename.2
594 Michael Haardt
595 Clarified EXDEV error description: it isn't possible to rename
258755b2 596 a file across mount points, even if the mount points refer to
4667b1b5
MK
597 the same file system.
598
599semop.2
600 mtk
601 Noted kernel version numbers for semtimedop().
602
603setitimer.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
608sigqueue.2
609 Johan Walles, Martin (Joey) Schulze
8fa20889 610 Added sigqueue.2 to SEE ALSO.
4667b1b5
MK
611
612times.2
613 mtk
755b5e17 614 Added notes on non-standard behavior: Linux allows 'buf' to
4667b1b5
MK
615 be NULL, but POSIX.1 doesn't specify this and it's non-portable.
616
617uselib.2
618 Andries Brouwer
619 Improved DESCRIPTION; clarified distinction between
620 EACCES and ENOEXEC.
621
622bcopy.3
623 Heikki Orsila
90369a2c 624 bcopy() handles overlapping case, but memcpy() does not,
4667b1b5
MK
625 so for consistency memmove() should be also mentioned.
626
627getmntent_r.3
628 Martin (Joey) Schulze
629 New link to man3/getmntent.3.
630
631memcpy.3
632 Small wording change after suggestion from Sasa Stevanovic.
633
634strcasestr.3
635 mtk
636 Created as link to strstr.3.
637
638strftime.3
639 mtk
640 Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
641
642strstr.3
643 mtk
644 Added description of strcasestr().
645
646random.4
647 aeb
648 Improved description of read from /dev/urandom.
649
650st.4
651 Kai Makisara
652 Substantial updates.
653
654man.7
40a54b37
MK
655 Martin Schulze
656 Branden Robinson
657 Colin Watson
4667b1b5
MK
658 Mention the .URL macro more verbosely.
659
4e6bd42c 660
9a7957be
MK
661==================== Changes in man-pages-2.03 ====================
662
663Released: 2005-06-02
664
665Contributors
666------------
667
668The following people contributed notes, ideas, or patches that have
669been incorporated in changes in this release:
670
671Andries Brouwer <Andries.Brouwer@cwi.nl>
672Joey (Martin) Schulze <joey@infodrom.org>
673Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
674Justin Pryzby <justinpryzby@users.sourceforge.net>
675Klaus Ethgen <Klaus@Ethgen.de>
676Pavel Heimlich <tropikhajma@seznam.cz>
677Ross Boylan <RossBoylan@stanfordalumni.org>
678Vincent Fourmond <vincent.fourmond@9online.fr>
679
680Apologies if I missed anyone!
681
682Global changes
683--------------
684
8fa20889
MK
685console.4
686console_ioctl.4
687mouse.4
688tty.4
689vcs.4
690 Pavel Heimlich
691 Change `ttys(4)' to `ttyS(4)'.
9a7957be
MK
692
693Typographical or grammatical errors have been corrected in several
694places.
695
258755b2
MK
696Changes to individual pages
697---------------------------
9a7957be
MK
698
699clone.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
707execve.2
708 aeb
4e6bd42c 709 Noted effect of ptracing when execing a set-UID program.
258755b2 710
9a7957be
MK
711fcntl.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
718flock.2
719 mtk
720 Noted that lock conversions are not atomic.
721
722getrusage.2
723 mtk
724 ru_nswap has never contained useful information.
258755b2 725 Kernel 2.6.6 clarified that with a patch
9a7957be
MK
726 ("[PATCH] eliminate nswap and cnswap"). See also:
727 http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
728
729kill.2
730 mtk
731 Clarified wording of the 'pid == -1' case.
732
733mount.2
734 mtk
735 Added MNT_EXPIRE, plus a few other tidy-ups.
736
737sched_setaffinity.2
738 mtk
258755b2 739 Added text to note that sched_setaffinity() will migrate the
9a7957be
MK
740 affected process to one of the specified CPUs if necessary.
741
258755b2
MK
742 Added a NOTE to point out that the affinity mask is actually a
743 per-thread attribute that can be adjusted independently for
9a7957be
MK
744 each thread in a thread group.
745
746shmctl.2
747 mtk
755b5e17 748 Noted aberrant Linux behavior with respect to new attaches to a
9a7957be
MK
749 segment that has already been marked for deletion.
750
751 Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
752
753wait.2
754 mtk
755 Noted that the __W* flags can't be used with waitid().
756
8fa20889 757confstr.3
9a7957be 758 mtk
fe209df6 759 Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
9a7957be 760
258755b2 761hosts.5
9a7957be 762 Ross Boylan / Martin Schulze
258755b2 763 various changes as per
9a7957be
MK
764 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
765
766proc.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
771capabilities.7
772 mtk
773 1,$s/inherited/inheritable/g
774
775regex.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
781tzselect.8
782 Joey (Martin) Schulze / Klaus Ethgen
deea4228 783 The default zoneinfo directory is now /usr/share/zoneinfo.
9a7957be
MK
784 (was: /usr/local/etc/zoneinfo)
785 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
786
4e6bd42c
MK
787
788==================== Changes in man-pages-2.04 ====================
789
790Released: 2005-06-21
791
792Contributors
793------------
794
795The following people contributed notes, ideas, or patches that have
796been incorporated in changes in this release:
797
798Andries Brouwer <Andries.Brouwer@cwi.nl>
799Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
800Dave Love <d.love@dl.ac.uk>
801Dieter Brueggemann <dieter.brueggemann@entitec.de>
802Geoff Clare <gclare@gclare.org.uk>
803Guido Trotter <ultrotter@debian.org>
9fdfa163 804kabloom <kabloom@ucdavis.edu>
4e6bd42c
MK
805Kevin Ryde <user42@zip.com.au>
806Justin Pryzby <justinpryzby@users.sourceforge.net>
807Mike Furr <mfurr@debian.org>
808Olivier Croquette <ocroquette@free.fr>
809Olivier Guilyardi <ylf@xung.org>
810Peter Cordes <peter@llama.nslug.ns.ca>
811Philipp Spitzer <philipp@toastfreeware.priv.at>
812Tanaka Akira <akr@m17n.org>
813Thierry Excoffier <exco@bat710.univ-lyon1.fr>
814Thomas Hood <jdthood@yahoo.co.uk>
815Vincent Lefevre <vincent@vinc17.org>
816Walter Harms <walter.harms@informatik.uni-oldenburg.de>
817
818Apologies if I missed anyone!
819
820Global changes
821--------------
822
8fa20889
MK
823Various pages
824 mtk
825 For consistency across pages:
4e6bd42c 826
8fa20889 827 1,$s/nonzero/non-zero/g
4e6bd42c
MK
828
829Typographical or grammatical errors have been corrected in several
830places.
831
832
833New pages
834---------
835
836pthreads.7
837 mtk
838 An overview of the Linux implementations of POSIX threads.
839
840
841Changes to individual pages
842---------------------------
843
844_exit.2
845 mtk
8fa20889 846 Various minor changes.
4e6bd42c
MK
847
848epoll_ctl.2
40a54b37 849 Mike Furr
4e6bd42c
MK
850 BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
851 'event', even though this argument is ignored.
8fa20889 852 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517
4e6bd42c
MK
853
854flock.2
8fa20889
MK
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
258755b2 859
4e6bd42c
MK
860getitimer.2
861 Olivier Croquette, Thierry Excoffier
862 Noted the existence of the short sleep bug (up to 1 jiffy).
863
864getrlimit.2
865 mtk
866 RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
867
868getrusage.2
869 Geoff Clare
870 Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
871
872nice.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
877open.2
878 Walter Harms
879 O_DIRECT needs _GNU_SOURCE.
880 mtk
8fa20889
MK
881 O_ASYNC works for pipes and FIFOs in Linux 2.6.
882 Various minor fixes.
4e6bd42c
MK
883
884atexit.3
885 mtk
8fa20889 886 Various minor changes.
4e6bd42c
MK
887
888exit.3
889 mtk
8fa20889 890 Various minor changes.
4e6bd42c
MK
891
892getopt.3
8fa20889
MK
893 mtk / Philipp Spitzer
894 Fix description of return value.
895 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
258755b2 896
4e6bd42c
MK
897hsearch.3
898 mtk
899 Changed (char *) to (void *) in example.
900 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
901
902log1p.3
903 Justin Pryzby
8fa20889
MK
904 Make log(3) SEE ALSO log1p(3),
905 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
4e6bd42c
MK
906
907makecontext.3
908 Tanaka Akira
8fa20889
MK
909 Fix description of RETURN VALUE for makecontext(),
910 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
4e6bd42c
MK
911
912on_exit.3
913 mtk
8fa20889 914 Various minor changes.
4e6bd42c
MK
915
916rand.3
8912c1da 917 kabloom
8fa20889
MK
918 Small fix to a code example,
919 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842
4e6bd42c
MK
920
921realpath.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
928rcmd.3
929 Dave Love
8fa20889
MK
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
4e6bd42c
MK
932
933scanf.3
934 Olivier Guilyardi
8fa20889
MK
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
4e6bd42c
MK
937
938stdin.3
939 Vincent Lefevre
940 freopen() can change the descriptors associated with
8fa20889
MK
941 stdin/stdout/stderr, as per
942 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859
4e6bd42c
MK
943
944strerror.3
945 Baurjan Ismagulov
8fa20889
MK
946 strerror_r(3) requires #define _XOPEN_SOURCE 600,
947 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
4e6bd42c
MK
948
949sysconf.3
28b3a122
MK
950 Peter Cordes / mtk
951 Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV".
4e6bd42c
MK
952
953proc.5
954 mtk
8fa20889 955 Added pointers under /proc/sys/net to tcp.7 and ip.7.
4e6bd42c
MK
956
957ip.7
958 mtk
959 Various wording and formatting fixes.
960 Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
961
962tcp.7
963 Dieter Brueggemann / mtk
8fa20889 964 Fixes to the discussion of SIOCATMARK and tcp_stdurg.
4e6bd42c
MK
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.
eb9a3e3c
MK
969
970
971==================== Changes in man-pages-2.05 ====================
972
973Released: 2005-06-27
974
975Contributors
976------------
977
978The following people contributed notes, ideas, or patches that have
979been incorporated in changes in this release:
980
981A Costa <agcosta@gis.net>
982Andries Brouwer <Andries.Brouwer@cwi.nl>
983Bas Zoetekouw <bas@debian.org>
984Dan Jacobson <jidanni@jidanni.org>
985Delian Krustev <krustev@krustev.net>
986Dora Anna Volgyesi <volgyesi@elte.hu>
987Martin (Joey) Schulze <joey@infodrom.org>
988Ove Kaaven <ovek@arcticnet.no>
989
990Apologies if I missed anyone!
991
992Global changes
993--------------
994
995Typographical or grammatical errors have been corrected in several
996places. (Special thanks to A Costa.)
997
998
eb9a3e3c
MK
999Changes to individual pages
1000---------------------------
1001
1002_exit.2
1003 mtk / aeb
1004 Reversed 2.04 introduction of the term "process termination
8fa20889 1005 function".
eb9a3e3c
MK
1006
1007close.2
1008 mtk
1009 Clarified what type of lock close() affects.
1010 Minor formatting changes.
1011
1012dup.2
1013 mtk
1014 Consistent use of terms "open file description",
8fa20889
MK
1015 "file status flags", and "file descriptor flags".
1016 Removed mention of lock sharing -- it was not accurate.
1017 Minor formatting fixes.
eb9a3e3c
MK
1018
1019fcntl.2
1020 mtk
1021 Consistent use of terms "open file description",
8fa20889 1022 "file status flags", and "file descriptor flags".
eb9a3e3c
MK
1023 Some rewriting of discussion of file descriptor flags
1024 Under F_DUPFD, replaced some text duplicated in dup.2
8fa20889
MK
1025 with a cross ref to dup.2
1026 Minor wording and formatting fixes.
eb9a3e3c
MK
1027
1028fpclassify.3
1029 mtk / Martin (Joey) Schulze / Bas Zoetekouw
1030 The return value of isinf() changed in glibc 2.02
26785b48 1031 to differentiate positive and negative infinity.
eb9a3e3c
MK
1032 See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1033
1034getgid.2
1035getuid.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
1040getitimer.2
1041 mtk
8fa20889
MK
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.
eb9a3e3c
MK
1044
1045getpriority.2
8fa20889
MK
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.
eb9a3e3c
MK
1049
1050open.2
1051 mtk / aeb
1052 Clarification of term "open file description" along with
8fa20889
MK
1053 explanation of what information it maintains.
1054 Other wording improvements.
1055 Various minor wording changes.
eb9a3e3c
MK
1056
1057atexit.3
1058 mtk / aeb
1059 Reversed 2.04 introduction of the term "process termination
8fa20889 1060 function".
eb9a3e3c
MK
1061 mtk
1062 Noted use of atexit() for establishing function to be invoked on
8fa20889 1063 shared library unload.
eb9a3e3c 1064 Noted that atexit()-registered functions are not invoked on
8fa20889 1065 abnormal termination.
eb9a3e3c
MK
1066 Formatting fixes.
1067
1068exit.3
1069 mtk / aeb
1070 Reversed 2.04 introduction of the term "process termination
8fa20889 1071 function".
eb9a3e3c
MK
1072 mtk
1073 Minor rewording and formatting changes.
1074
1075getloadavg.3
1076 mtk
8fa20889 1077 Added #define _BSD_SOURCE to prototype.
eb9a3e3c
MK
1078
1079log2.3
1080 Martin (Joey) Schulze
1081 Add ERANGE error.
1082
1083readdir.3
1084 mtk
1085 Added definition of Linux dirent structure.
1086 Some formatting cleanups.
1087
1088strtod.3
cc1d6beb 1089 Dora Anna Volgyesi / mtk
eb9a3e3c
MK
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
1093tdestroy.3
1094 mtk
8fa20889 1095 New link to tsearch.3.
eb9a3e3c
MK
1096
1097tsearch.3
1098 mtk
8fa20889 1099 Added tdestroy to .TH line.
eb9a3e3c
MK
1100
1101mem.4
1102 mtk
8fa20889 1103 Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem".
eb9a3e3c
MK
1104
1105null.4
1106 mtk
1107 Change "chown root:mem /dev/null /dev/zero" to
8fa20889 1108 "chown root:root /dev/null /dev/zero".
eb9a3e3c
MK
1109
1110vcs.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
1115signal.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
1120urn.7
1121 mtk
1122 New link to uri.7
c6e136d5
MK
1123
1124
1125==================== Changes in man-pages-2.06 ====================
1126
1127Released: 2005-07-15
1128
1129Contributors
1130------------
1131
1132The following people contributed notes, ideas, or patches that have
1133been incorporated in changes in this release:
1134
1135Alain Portal <aportal@univ-montp2.fr>
1136Andries Brouwer <Andries.Brouwer@cwi.nl>
1137Bhavesh P Davda <bhavesh@avaya.com>
1138Clau Weber <claus@jambit.com>
1139Dov Murik <dov@dv-networks.com>
1140David Lloyd <dlloyd@microbits.com.au>
1141Frederik Deweerdt <frederik.deweerdt@gmail.com>
1142Justin Pryzby <justinpryzby@users.sourceforge.net>
1143Lars Wirzenius <liw@iki.fi>
1144Martin Pool <mbp@sourcefrog.net>
1145Mike Frysinger <vapier@gentoo.org>
1146Petter Reinholdtsen <pere@hungry.com>
1147Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1148Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1149
1150Apologies if I missed anyone!
1151
1152Global changes
1153--------------
1154
1155Typographical or grammatical errors have been corrected in several
1156places.
1157
1158Many uses of hyphens and dashes were corrected.
1159
1160
1161New pages
1162---------
1163
1164canonicalize_file_name.3
1165 Walter Harms / mtk
1166
1167Removed Pages
1168-------------
1169
1170sstk.2
1171 mtk
26785b48 1172 AFAIK, this system call has never actually done anything (other
8fa20889 1173 than be a stub) on any Unix.
c6e136d5
MK
1174
1175Changes to individual pages
1176---------------------------
1177
1178accept.2
1179 mtk
1180 Various wording and formatting fixes.
1181
1182bind.2
1183 mtk
1184 Minor formatting changes
1185
1186clone.2
1187 mtk
1188 Various minor wording improvements; some formatting fixes
1189
1190connect.2
1191 mtk
1192 Various wording and formatting fixes.
1193
1194epoll_create.2
1195 Bhavesh P Davda
1196 s/positive/non-negative/ [for file descriptor]
1197
1198getrlimit.2
1199 mtk
1200 Documented RLIMIT_MSGQUEUE limit.
1201 RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
8fa20889 1202 (It already didn't have any effect in 2.2.x and 2.6.x.)
c6e136d5
MK
1203 s/MADVISE_WILLNEED/MADV_WILLNEED/
1204
1205listen.2
1206 mtk
1207 Removed historic comment on BSD backlog ceiling.
1208 Minor wording and formatting changes.
1209
1210semop.2
1211 mtk
1212 Added BUG: in some circumstances, a process that is
2beeae40 1213 waiting for a semaphore to become zero is not woken
c6e136d5
MK
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
1218socket.2
1219 mtk
28b3a122 1220 Various minor wording improvements
c6e136d5
MK
1221
1222umask.2
1223 mtk
1224 Added mkdir(2) to discussion, made term "file mode creation
8fa20889 1225 mask" clearer.
c6e136d5
MK
1226 Various, mostly small, wording changes
1227
1228errno.3
1229 Martin Pool
1230 Change description for ESTALE
1231 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1232
1233fgetgrent.3
1234getgrent.3
1235getgrent_r.3
1236 David Lloyd
1237 Added SEE ALSO putgrent(3)
1238 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1239
1240getgrent.3
1241getgrnam.3
1242getpwent.3
1243getpwnam.3
1244 Lars Wirzenius / mtk
fe209df6 1245 Replace mention of /etc/{passwd,group} by references to
8fa20889 1246 "passwd/group database", and LDAP and NIS.
c6e136d5
MK
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
1252getnameinfo.3
8fa20889
MK
1253 mtk
1254 Relocate misplaced text describing gai_strerror().
c6e136d5
MK
1255
1256getnetent.3
1257 Petter Reinholdtsen
1258 s/endservent/endnetent/
8fa20889 1259 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316517
c6e136d5
MK
1260
1261getspnam.3
1262 Lars Wirzenius / mtk
fe209df6 1263 Replace mention of /etc/shadow by references to
8fa20889 1264 "shadow password database", and LDAP and NIS.
c6e136d5
MK
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
1270hsearch.3
1271 Frederik Deweerdt
1272 Fix hsearch_r() prototype
1273
1274scanf.3
1275 Justin Pryzby / mtk
1276 Fix description of RETURN VALUE
8fa20889 1277 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=317037
c6e136d5
MK
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
1283shm_open.3
1284 mtk
1285 Modified details of how user and group ownership of a new
8fa20889 1286 object are set.
c6e136d5
MK
1287 Various minor wording and formatting cleanups.
1288
1289elf.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
1298proc.5
1299 mtk
258755b2 1300 Updated discussion of /proc/stat.
c6e136d5
MK
1301 Added text on the /proc/sys/fs/mqueue/* files.
1302
1303ip.7
1304 Steven Murdoch
1305 Change protocol in UDP prototype.
1306 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1307
1308tcp.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.
3fa70acd
MK
1313
1314
1315==================== Changes in man-pages-2.07 ====================
1316
1317Released: 2005-07-19
1318
1319Contributors
1320------------
1321
1322The following people contributed notes, ideas, or patches that have
1323been incorporated in changes in this release:
1324
1325Andries Brouwer <Andries.Brouwer@cwi.nl>
1326Mike Frysinger <vapier@gentoo.org>
1327
1328Apologies if I missed anyone!
1329
1330Global changes
1331--------------
1332
8fa20889
MK
1333Various pages
1334 mtk
1335 The terms "set-user-ID" and "set-group-ID" are now used
752cb57f 1336 consistently (no abbreviations) across all manual pages.
3fa70acd 1337
8fa20889
MK
1338Various 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",
752cb57f 1342 saved group ID", etc.)
3fa70acd 1343
8fa20889
MK
1344Various pages
1345 mtk
1346 Global fixes in textual descriptions:
3fa70acd 1347
8fa20889
MK
1348 uid --> UID
1349 gid --> GID
1350 pid --> PID
1351 id --> ID
3fa70acd 1352
8fa20889
MK
1353Various pages
1354 mtk
1355 Consistent use of st_atime, st_ctime, st_mtime, with
752cb57f 1356 explanatory text, instead of atime/ctime/mtime.
3fa70acd 1357
8fa20889
MK
1358Various 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).
3fa70acd
MK
1362
1363Typographical or grammatical errors have been corrected in several
1364places.
1365
1366
1367Changes to individual pages
1368---------------------------
1369
1370setresuid.2
1371 mtk
1372 Some rewording.
1373
1374stat.2
1375 Mike Frysinger
1376 Improve description of st_dev and st_rdev.
1377 mtk
1378 Various wording and formatting improvements.
1379
1380truncate.2
1381 mtk
1382 Some formatting fixes
6859d357
MK
1383
1384
1385==================== Changes in man-pages-2.08 ====================
1386
1387Released: 2005-09-21
1388
1389Contributors
1390------------
1391
1392The following people contributed notes, ideas, or patches that have
1393been incorporated in changes in this release:
1394
1395Adrian Bunk <bunk@stusta.de>
1396Alain PORTAL <aportal@univ-montp2.fr>
1397Andrew Pimlott <andrew@pimlott.net>
1398Andries Brouwer <Andries.Brouwer@cwi.nl>
1399Baurzhan Ismagulov <ibr@radix50.net>
1400Bernhard R. Link <brlink@debian.org>
dba4b377 1401Bodo Stroesser <bstroesser@fujitsu-siemens.com>
6859d357
MK
1402David N. Welton <davidw@eidetix.com>
1403Dov Murik <dov@dv-networks.com>
1404Heikki Orsila <shd@modeemi.cs.tut.fi>
1405Hasso Tepper <hasso@estpak.ee>
1406Hrvoje Niksic <hniksic@xemacs.org>
1407Justin Pryzby <justinpryzby@users.sourceforge.net>
1408Ludovic Courtes <ludovic.courtes@laas.fr>
1409Mike Frysinger <vapier@gentoo.org>
33972b0b 1410Nicolas François <nicolas.francois@centraliens.net>
6859d357
MK
1411Norbert Buchmuller <norbi.spam@nix.hu>
1412Paul Brook <paul@nowt.org>
1413Ramiro Aceves <ea1abz@gmail.com>
1414Tommy Pettersson <ptp@lysator.liu.se>
1415Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1416
1417Apologies if I missed anyone!
1418
1419Global changes
1420--------------
1421
8fa20889
MK
1422Various pages
1423 mtk
1424 RFC references are now always written as "RFC\ nnn"
752cb57f 1425 (not "RFC nnn" or "RFCnnn").
6859d357
MK
1426
1427Typographical or grammatical errors have been corrected in several
1428places.
1429
1430
1431Changes to individual pages
1432---------------------------
1433
1434du.1
1435 Mike Frysinger
258755b2 1436 To get an effect like "-h", BLOCKSIZE must start with "human",
8fa20889 1437 not "HUMAN".
6859d357
MK
1438
1439time.1
1440 Mike Frysinger
1441 s/standard output/standard error/
258755b2 1442
6859d357
MK
1443clone.2
1444 Paul Brook / mtk
1445 Fix small error in description of CLONE_PARENT_SETTID
1446
1447connect.2
1448 Heikki Orsila
1449 Add EINTR error
1450 See http://lkml.org/lkml/2005/7/12/254
1451
1452getpriority.2
1453 mtk
258755b2 1454 Expanded discussion of relationship between user and kernel
8fa20889 1455 representations of the nice value.
6859d357 1456
258755b2 1457 Added discussion of RLIMIT_NICE and a cross reference to
8fa20889 1458 getrlimit.2 under the description of the EACCES error.
6859d357
MK
1459
1460 Noted 2.6.12 change in credentials checking for setpriority().
1461
1462getrlimit.2
1463 mtk
1464 Added description of RLIMIT_RTPRIO
1465
1466 Added description of RLIMIT_NICE
1467
1468mmap.2
1469 mtk
1470 Noted bug in MAP_POPULATE for kernels before 2.6.7.
258755b2 1471
6859d357 1472mremap.2
8fa20889 1473 mtk
6859d357
MK
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
1481msgctl.2
1482 mtk
1483 Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1484
1485nanosleep.2
1486 Baurzhan Ismagulov
1487 Add to prototype: define _POSIX_C_SOURCE 199309
8fa20889 1488 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=314435
6859d357
MK
1489
1490nice.2
1491 mtk
258755b2 1492 Added sentence noting that range of the nice value is described
8fa20889 1493 in getpriority.2.
258755b2 1494 Added cross-reference to setrlimit(2) for discussion on
8fa20889 1495 RLIMIT_NICE.
258755b2 1496
6859d357
MK
1497outb.2
1498 David N. Welton / Justin Pryzby / mtk
1499 Clarified the order of value and port arguments;
8fa20889 1500 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263756
6859d357
MK
1501
1502pause.2
1503 mtk
1504 Added SEE ALSO for sigsuspend.2
1505 Some formatting fixes.
1506
1507poll.2
1508 Tommy Pettersson
1509 nfds should be prototyped as nfds_t
8fa20889 1510 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=322934
6859d357
MK
1511
1512 mtk
1513 Some wording and formatting improvements.
1514
1515prctl.2
1516 mtk
1517 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1518
1519rand.3
1520 Hrvoje Niksic / mtk
1521 Remove misleading text describing FreeBSD's sranddev() function.
1522 As per debian bug 328629
258755b2 1523
6859d357
MK
1524readv.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.
258755b2 1530
6859d357
MK
1531remap_file_pages.2
1532 mtk
5fab2e7c 1533 Added text to note that start and size are both rounded downward.
6859d357
MK
1534
1535sched_setparam.2
1536 mtk
8fa20889
MK
1537 Modified discussion of privileges; added pointer to
1538 sched_setscheduler.2 for a discussion of privileges and
1539 resource limits.
6859d357
MK
1540
1541sched_setscheduler.2
8fa20889
MK
1542 mtk
1543 Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
6859d357
MK
1544
1545semctl.2
1546 mtk
1547 Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1548
1549shmctl.2
1550 mtk
1551 Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1552
1553sigaction.2
1554 mtk
1555 Split sigpending(), sigprocmask(), and sigsuspend() out
1556 into separate new pages.
1557
1558 Other minor changes
1559
1560 mtk
258755b2 1561 NOTES: described SA_NODEFER / sa_mask bug which was present in
6859d357
MK
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
1570signal.2
1571 mtk
1572 Updated SEE ALSO to reflect splitting of sigaction.2 into
1573 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1574
1575sigpending.2
1576 mtk
1577 New page created by splitting out from sigaction.2
1578 Changed CONFORMING TO.
1579
1580sigprocmask.2
1581 mtk
1582 New page created by splitting out from sigaction.2
1583 Added text on effect of NULL for 'set' argument.
258755b2 1584 Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
6859d357
MK
1585 and SIGSEGV.
1586 Noted that sigprocmask() can't be used in multithreaded process.
1587 Fixed EINVAL error diagnostic.
1588 Changed CONFORMING TO.
1589
1590sigsuspend.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
1597stat.2
1598 Mike Frysinger
1599 Improve st_blocks description.
1600
258755b2 1601carg.3
6859d357
MK
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
8fa20889 1608 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=326720
258755b2 1609
6859d357
MK
1610cmsg.3
1611 mtk
1612 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1613
1614dlopen.3
1615 Alain Portal
1616 s/-nostartupfiles/-nostartfiles/
1617
1618getaddrinfo.3
1619 mtk
258755b2 1620 Nowadays (since 2.3.4) glibc only sets the first ai_canonname
6859d357
MK
1621 field if AI_CANONNAME was specified (the current behavior
1622 is all that SUSv3 requires).
1623
1624 1,$s/PF_/AF_/g
1625
258755b2 1626 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
6859d357
MK
1627 and AI_NUMERICSERV.
1628
1629 Some wording and formatting fixes.
1630
1631getpwnam.3
1632 Bernhard R. Link / mtk
258755b2 1633 Add NOTES text describing relationship of pw_dir and HOME and
8fa20889 1634 pointing out that applications should preferentially inspect HOME.
6859d357
MK
1635
1636inet.3
1637 Mike Frysinger
1638 Mention "little endian" and "big endian".
258755b2 1639 Added note about octal and hex interpretation of
6859d357
MK
1640 numbers-and-dots notation.
1641
1642rpc.3
258755b2
MK
1643 mtk / Ludovic Courtes
1644 Commented out references to rpc_secure(3) -- we don't currently
8fa20889
MK
1645 have such a page in the man-pages set.
1646 In response to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=325115
6859d357
MK
1647
1648setenv.3
1649 mtk
8fa20889 1650 glibc 2.3.4 fixed the "name contains '='" bug.
6859d357
MK
1651
1652strnlen.3
1653 Mike Frysinger
1654 Added "#define _GNU_SOURCE" to prototype.
258755b2 1655
6859d357
MK
1656initrd.4
1657 Norbert Buchmuller / mtk
258755b2 1658 Added text noting that the use or real-root-dev for changing
755b5e17 1659 the root device is obsolete, in favor of pivot root.
258755b2 1660 (However, the page still needs to be rewritten to actually
6859d357 1661 describe the pivot_root method...)
8fa20889 1662 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=323621
6859d357
MK
1663
1664proc.5
1665 mtk
8fa20889 1666 Improve text describing /proc/sys/fs/mqueue/* files.
258755b2 1667
8fa20889 1668 Describe /proc/sys/fs/suid_dumpable (new in 2.6.13).
6859d357 1669
8fa20889
MK
1670 Added placeholder mention of /proc/zoneinfo (new in 2.6.13).
1671 More needs to be said about this file.
6859d357 1672
258755b2 1673 Repaired earlier cut and paste mistake which resulted
8fa20889 1674 in part of the text of this page being duplicated.
6859d357
MK
1675
1676utmp.5
1677 Mike Frysinger
1678 Added text on biarch details for ut_session and ut_tv.
1679
1680capabilities.7
1681 mtk
1682 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1683
1684ip.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).
258755b2 1688
6859d357
MK
1689 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1690
1691 Hasso Tepper
8fa20889 1692 Fix discussion of IPC_RECVTTL / IP_TTL.
6859d357
MK
1693
1694signal.7
1695 mtk
1696 Updated SEE ALSO to reflect splitting of sigaction.2 into
8fa20889 1697 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2.
6859d357
MK
1698
1699socket.7
1700 mtk
1701 Clarified details of use of SO_PEERCRED.
1702
1703tcp.7
1704 mtk
1705 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1706 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1707
1708udp.7
1709 mtk
8fa20889 1710 Added description of UDP_CORK socket option.
6859d357
MK
1711
1712 s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name)
1713 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
cffe816e
MK
1714
1715
1716==================== Changes in man-pages-2.09 ====================
1717
1718Released: 2005-10-13
1719
1720Contributors
1721------------
1722
1723The following people contributed notes, ideas, or patches that have
1724been incorporated in changes in this release:
1725
1726Justin Pryzby <pryzbyj@justinpryzby.com>
1727Peter Chubb <peterc@gelato.unsw.edu.au>
1728Samuel Thibault <samuel.thibault@ens-lyon.org>
1729Tomas Pospisek <tpo_deb@sourcepole.ch>
1730Trond Myklebust <trond.myklebust@fys.uio.no>
1731
1732Apologies if I missed anyone!
1733
1734Global changes
1735--------------
1736
1737ptsname.3
1738getpt.3
1739unlockpt.3
1740openpty.3
1741posix_openpt.3
1742grantpt.3
1743pts.4
1744tty_ioctl.4
1745 mtk
8fa20889 1746 Added SEE ALSO for new pty.7 page.
cffe816e
MK
1747
1748Typographical or grammatical errors have been corrected in several
1749places.
1750
1751
1752New pages
1753---------
1754
1755pty.7
8fa20889 1756 mtk
28b3a122 1757 Overview of Unix 98 and BSD pseudo-terminals.
cffe816e
MK
1758
1759
1760Changes to individual pages
1761---------------------------
1762
1763ldd.1
8fa20889
MK
1764 mtk
1765 Remove "-V" option (fix from Fedora man-pages-2.07-7).
cffe816e
MK
1766
1767fcntl.2
1768 Peter Chubb / Trond Myklebust / mtk
258755b2 1769 Since kernel 2.6.10, a read lease can only be placed on a
8fa20889 1770 file descriptor that is opened read-only.
258755b2 1771 See the following LKML thread of Aug 2005
cffe816e
MK
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
1778mprotect.2
1779 mtk
8fa20889 1780 Add new text to ENOMEM error.
cffe816e
MK
1781
1782mremap.2
1783 mtk
1784 Added description of MREMAP_FIXED and 'new_address' argument
8fa20889 1785 under NOTES.
cffe816e
MK
1786 Revised text of EINVAL error.
1787
1788read.2
1789 Samuel Thibault / mtk
1790 read() can fail with EINVAL when using O_DIRECT
1791 mtk
8fa20889 1792 Added open(2) to SEE ALSO.
258755b2 1793
cffe816e
MK
1794shmget.2
1795 mtk
258755b2 1796 s/int/size_t/ for type of 'size' argument (fix from
8fa20889 1797 Fedora man-pages-2.07-7).
cffe816e
MK
1798
1799write.2
1800 Samuel Thibault / mtk
1801 write() can fail with EINVAL when using O_DIRECT
258755b2 1802
cffe816e
MK
1803atanh.3
1804 mtk
8fa20889 1805 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7).
cffe816e
MK
1806
1807fopen.3
1808 mtk
1809 Improved "a+" description (fix from Fedora man-pages-2.07-7).
1810
1811getrpcent.3
1812 mtk
1813 s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
258755b2 1814
cffe816e
MK
1815stdio.3
1816 mtk / Justin Pryzby
258755b2 1817 Removed references to fropen() and fwopen(), which are
8fa20889
MK
1818 BSDisms that don't appear in glibc.
1819 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
258755b2 1820
cffe816e
MK
1821strftime.3
1822 mtk
258755b2 1823 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
8fa20889 1824 Fedora man-pages-2.07-7).
cffe816e
MK
1825
1826nsswitch.conf.5
1827 mtk
1828 s/network/networks/ (fix from Fedora man-pages-2.07-7).
1829
1830proc.5
1831 mtk
1832 Added description of /proc/sys/vm/legacy_va_layout.
1833
1834socket.7
258755b2 1835 mtk
cffe816e
MK
1836 Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1837 (fix derived from Fedora man-pages-2.07-7).
d85bdf28
MK
1838
1839
1840==================== Changes in man-pages-2.10 ====================
1841
1842Released: 2005-10-19
1843
1844Global changes
1845--------------
1846
258755b2
MK
1847The changes in this release consist *solely* of formatting fixes, with
1848the aim bringing greater consistency to the manual pages according to
d85bdf28
MK
1849the following rules:
1850
258755b2 1851-- Function name references should *always* be followed by
d85bdf28
MK
1852 parentheses, "()" (possibly containing a manual page section
1853 number).
1854
258755b2 1855-- The parentheses following a function name should *not* be
d85bdf28
MK
1856 formatted. Thus, for example, instead of:
1857
1858 .B name()
1859
1860 one should write:
1861
1862 .BR name ()
1863
258755b2 1864Much of the change was automated using two scripts:
d85bdf28 1865add_parens_for_own_funcs.sh and unformat_parens.sh.
258755b2 1866For the (possible) benefit of downstream manual page maintainers and
d85bdf28
MK
1867translators, I have placed these scripts in a new subdirectory 'scripts'.
1868
1869NOTE 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
258755b2 1873 be scanned by a human. (To see what changes the two scripts
d85bdf28
MK
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
258755b2 1878 to help find remaining instances of function names without
d85bdf28
MK
1879 following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1880
1881The following changes were made:
1882
258755b2 1883-- add_parens_for_own_funcs.sh was applied to the pages in Sections
d85bdf28
MK
1884 2 and 3.
1885
258755b2 1886-- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
d85bdf28
MK
1887 (the only sections where such changes were required).
1888
1889-- further changes (not so very many) were performed by hand.
258755b2 1890 (found places to fix with the assistance of find_dots_no_parens.sh
d85bdf28 1891 and find_slashes_no_parens.sh).
773df4c9
MK
1892
1893
1894==================== Changes in man-pages-2.11 ====================
1895
1896Released: 2005-10-24
1897
1898Contributors
1899------------
1900
1901The following people contributed notes, ideas, or patches that have
1902been incorporated in changes in this release:
1903
1904Alain PORTAL <aportal@univ-montp2.fr>
1905
1906Apologies if I missed anyone!
1907
1908Global changes
1909--------------
1910
dc1ffd77 1911Various pages
8fa20889 1912 mtk
752cb57f
MK
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.
773df4c9 1916
752cb57f 1917 Many minor formatting fixes were made.
773df4c9
MK
1918
1919Typographical or grammatical errors have been corrected in several
1920places.
1921
1922
1923Changes to individual pages
1924---------------------------
1925
1926getrlimit.2
1927 mtk
1928 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1929
1930path_resolution.2
1931 mtk
8ce5e7ac
MK
1932 Repaired discussion of capabilities and file system UID, which
1933 mistakenly had involved exec() in the discussion.
258755b2 1934
773df4c9
MK
1935prctl.2
1936 mtk
258755b2 1937 Removed text saying there is no library interface. There
8ce5e7ac 1938 is nowadays.
773df4c9
MK
1939
1940mkfifo.3
1941 mtk
1942 Minor change to RETURN VALUE text.
1943
1944sk98lin.4
1945 Alain Portal
8fa20889 1946 Formatting fixes.
773df4c9
MK
1947
1948capabilities.7
1949 mtk
8fa20889 1950 Minor changes.
202a8610
MK
1951
1952
1953==================== Changes in man-pages-2.12 ====================
1954
1955Released: 2005-10-31
1956
1957Contributors
1958------------
1959
1960The following people contributed notes, ideas, or patches that have
1961been incorporated in changes in this release:
1962
1963Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1964Andries Brouwer <Andries.Brouwer@cwi.nl>
1965Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
8912c1da 1966herbert <herbert@gondor.apana.org.au>
202a8610
MK
1967Martin Landers <martin.landers@treibgut.net>
1968Michael Benedict <benedict@starbak.net>
1969
1970Apologies if I missed anyone!
1971
1972Global changes
1973--------------
1974
1975Typographical or grammatical errors have been corrected in several
1976places.
1977
1978
1979Changes to individual pages
1980---------------------------
1981
1982mlock.2
1983 mtk
258755b2 1984 Reworded text around PAGESIZE, noting also that
202a8610
MK
1985 sysconf(_SC_PAGESIZE) can be used.
1986
1987path_resolution.2
8fa20889
MK
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.
202a8610 1993
8fa20889
MK
1994 Reworked (cut down) discussion of capabilities, moving part of
1995 it into capabilities.7
202a8610
MK
1996
1997setresuid.2
1998 mtk
258755b2
MK
1999 Add text to note that setresuid() always modifies the file
2000 system UID, and setresgid() likewise always modifies the file
202a8610
MK
2001 system GID.
2002
2003shmget.2
2004 mtk
2005 Added (brief) description of SHM_HUGETLB.
2006
2007sigaltstack.2
2008 mtk / Martin Landers
2009 Noted that ss_sp is automatically aligned by the kernel.
2010
2011byteorder.3
8912c1da 2012 Brian M. Carlson / herbert
258755b2 2013 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
8fa20889
MK
2014 explaining that some systems need the former header.
2015 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=265244
202a8610
MK
2016
2017capabilities.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.
2d4596fc
MK
2022
2023
2024==================== Changes in man-pages-2.13 ====================
2025
2026Released: 2005-11-03
2027
2028This release consists entirely of formatting and typographical fixes.
2029
2030Global changes
2031--------------
2032
2033Typographical or grammatical errors have been corrected in several
2034places.
2035
8fa20889
MK
2036Various 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).
2d4596fc 2041
8fa20889
MK
2042Various pages
2043 mtk
2044 Instances of things like "NULL-terminated string" were changed to
2045 "null-terminated string".
2d4596fc 2046
8fa20889
MK
2047Various pages
2048 mtk
2049 Pathnames, structures, arguments, and <header-files> that were
752cb57f 2050 bold were changed to italics.
2d4596fc 2051
8fa20889
MK
2052Various 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.)
565ecc02
MK
2057
2058
2059==================== Changes in man-pages-2.14 ====================
2060
2061Released: 2005-11-17
2062
2063Contributors
2064------------
2065
2066The following people contributed notes, ideas, or patches that have
2067been incorporated in changes in this release:
2068
2069Angelo <ang3l0@katamail.com>
2070Avery Pennarun <apenwarr@nit.ca>
2071Justin Pryzby <justinpryzby@users.sourceforge.net>
2072Martin (Joey) Schulze <joey@infodrom.org>
f687d451 2073Stefan Brüns <stefan.bruens@rwth-aachen.de>
565ecc02
MK
2074Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2075
2076Apologies if I missed anyone!
2077
2078Global changes
2079--------------
2080
2081Typographical or grammatical errors have been corrected in several
2082places.
2083
2084New pages
2085---------
2086
2087rexec.3
2088 mtk / Justin Pryzby
28b3a122
MK
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
258755b2 2093
565ecc02
MK
2094Changes to individual pages
2095---------------------------
2096
2097arch_prctl.2
2098 mtk
2099 Updated discussion about lack of prototype in glibc.
2100
2101execve.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
2106fcntl.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
8fa20889 2111 lease breaker. In response to
752cb57f 2112 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
565ecc02
MK
2113
2114stat.2
f687d451 2115 mtk / Stefan Brüns
565ecc02
MK
2116 Added LINUX NOTES describing nanosecond timestamps.
2117
2118frexp.3
2119 Volker Reichelt / mtk
b773bb0f 2120 Fixed to point out that frexp() returns a number whose
258755b2 2121 *absolute* value is >= 0.5 and < 1. Amended the example
565ecc02
MK
2122 program to demonstrate this.
2123
258755b2 2124open.2
565ecc02
MK
2125 mtk / Avery Pennarun
2126 Add EWOULDBLOCK error for file leases.
8fa20889 2127 In response to
752cb57f 2128 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=339037
565ecc02
MK
2129
2130putenv.3
2131 mtk
258755b2
MK
2132 Although the glibc implementation returns -1 on error (and some
2133 other man pages (e.g., the BSDs) also document that value for
565ecc02
MK
2134 error returns), SUSv3 merely says "non-zero" (and this is
2135 what manual pages on many implementations also say).
2136
2137posix_memalign.3
2138 mtk
258755b2 2139 Formerly, the page said that all systems declare memalign() in
565ecc02
MK
2140 <malloc.h>. In fact, many declare it in <stdlib.h>.
2141
2142strtok.3
2143 mtk
258755b2 2144 Almost a complete rewrite after Angelo pointed out
565ecc02
MK
2145 that the existing page was deficient.
2146
2147sd.4
258755b2 2148 Martin Schulze
58ce1507 2149 Remove SEE ALSO for nonexistent scsi.4.
565ecc02
MK
2150
2151proc.5
2152 mtk
2153 Updated discussion of /proc/sys/kernel/pid_max.
2154
2155signal.7
2156 mtk
2157 Added pthreads.7 to SEE ALSO.
258755b2 2158
565ecc02
MK
2159ld.so.8
2160 mtk
2161 Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2162
ce9cd1fa
MK
2163
2164==================== Changes in man-pages-2.15 ====================
2165
2166Released: 2005-11-30
2167
2168Contributors
2169------------
2170
2171The following people contributed notes, ideas, or patches that have
2172been incorporated in changes in this release:
2173
2174Andries Brouwer <Andries.Brouwer@cwi.nl>
2175James Vega <jamessan@debian.org>
2176Malcolm Scott <mas90@io.malc.org.uk>
2177Senthil Kumar <senthilkumar_sen@hotpop.com>
2178
2179Apologies if I missed anyone!
2180
2181Global changes
2182--------------
2183
2184Typographical or grammatical errors have been corrected in several
2185places.
2186
2187New pages
2188---------
2189
2190sigvec.3 -- for details, see below.
2191
2192sigset.3 -- for details, see below.
2193
2194Changes to individual pages
2195---------------------------
2196
2197kill.2
2198 mtk
258755b2 2199 Added text describing the 2.6.[0-7] EPERM bug that occurred
ce9cd1fa
MK
2200 when sending signals to a process group.
2201
2202sigaction.2
8fa20889 2203 mtk
28b3a122 2204 Noted that si_signo is unused on Linux.
ce9cd1fa
MK
2205
2206sigpending.2
2207 mtk
2208 Added BUGS noting wrapper function problem that existed
2209 in glibc versions <= 2.2.1.
2210
2211sigpause.2
2212 mtk
2213 Moved to section 3; see also sigpause.3 below.
2214
2215sigsetops.3
2216 mtk
258755b2 2217 Added a GLIBC NOTES section describing sigisemptyset(),
ce9cd1fa
MK
2218 sigandset(), and sigorset().
2219
2220sigvec.2
2221sigblock.2
2222 mtk
258755b2 2223 These pages have been deleted, and replaced by a new sigvec.3
ce9cd1fa
MK
2224 man page that more fully describes the BSD signal API.
2225
2226siggetmask.2
2227sigmask.2
2228sigsetmask.2
2229 mtk
258755b2 2230 These links to the now-deleted sigblock.2 have been also been
ce9cd1fa
MK
2231 deleted. They are replaced by corresponding links in Section 3:
2232 sigmask.3, sigsetmask.3, siggetmask.3.
2233
2234sigvec.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.
258755b2 2239
ce9cd1fa
MK
2240sigblock.3
2241siggetmask.3
2242sigmask.3
2243sigsetmask.3
2244 mtk
2245 Created as links to sigvec.3.
2246
2247sigpause.3
2248 mtk
2249 Moved here from Section 2.
2250
258755b2 2251 Some minor wording fixes; clarified System V origins of
755b5e17 2252 X/Open flavor of this function.
ce9cd1fa
MK
2253
2254sigset.3
2255 mtk
258755b2 2256 New page describing the System V signal API: sigset(), sighold(),
ce9cd1fa
MK
2257 sigrelse(), sigignore().
2258
2259strftime.3
2260 James Vega
258755b2 2261 Add further text clarifying that %+ specifier is not supported in
ce9cd1fa
MK
2262 glibc2.
2263 mtk
258755b2 2264 Added GLIBC NOTES section describing optional 'flag' and 'width'
8fa20889 2265 components of conversion specifiers.
ce9cd1fa
MK
2266 Some wording changes to bring terminology closer to SUSv3.
2267 Added an example program.
2268
2269vm86old.2
8fa20889 2270 mtk / aeb
24fd8070 2271 Add as new link to vm86.2.
ce9cd1fa
MK
2272
2273intro.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
2278signal.7
2279 mtk
2280 Added some SEE ALSO entries.
258755b2 2281
ce9cd1fa
MK
2282socket.7
2283 Senthil Kumar / mtk
2284 Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2285
2286udp.7
2287 Malcolm Scott
8fa20889
MK
2288 s/tcp_socket/udp_socket/ in example
2289 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=340927
67497d82
MK
2290
2291
2292==================== Changes in man-pages-2.16 ====================
2293
2294Released: 2005-12-02
2295
2296Contributors
2297------------
2298
2299The following people contributed notes, ideas, or patches that have
2300been incorporated in changes in this release:
2301
2302Alan Stern <stern@rowland.harvard.edu>
2303Andries Brouwer <Andries.Brouwer@cwi.nl>
2304Urs Thuermann <urs@isnogud.escape.de>
2305
2306Apologies if I missed anyone!
2307
2308Global changes
2309--------------
2310
2311Typographical or grammatical errors have been corrected in several
2312places.
2313
2314
2315Changes to individual pages
2316---------------------------
2317
2318HOWTOHELP
2319 Urs Thuermann
2320 Added instructions for finding maintainer in Debian package.
2321
2322poll.2
8fa20889
MK
2323 mtk
2324 Added NOTES about INFTIM constant provided on some other
2325 implementations.
258755b2 2326
67497d82
MK
2327shmop.2
2328 Alan Stern
2329 The -1 error return of shmat() should be cast "(void *)".
258755b2 2330
8fa20889 2331strftime.3
67497d82 2332 aeb
258755b2 2333 Remove junk text (actually intended as source code comment
67497d82
MK
2334 in page).
2335
2336ip.7
2337 Urs Thuermann
2338 Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2339
2340packet.7
2341 Urs Thuermann
2342 Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2343
9c7e8803
MK
2344
2345==================== Changes in man-pages-2.17 ====================
2346
2347Released: 2005-12-13
2348
2349Contributors
2350------------
2351
2352The following people contributed notes, ideas, or patches that have
2353been incorporated in changes in this release:
2354
2355Justin Pryzby <justinpryzby@users.sourceforge.net>
2356Michael Haardt <michael@moria.de>
2357Urs Thuermann <urs@isnogud.escape.de>
2358Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2359
2360Apologies if I missed anyone!
2361
2362
2363Global changes
2364--------------
2365
2366Typographical or grammatical errors have been corrected in several
2367places.
2368
2369
2370New pages
2371---------
2372
2373fmemopen.3
2374 Walter Harms / mtk
2375 New documentation for the glibc-specific fmemopen() and
2376 open_memstream(). Based on glibc info page.
2377
9c7e8803 2378pipe.7
258755b2 2379 mtk (with prompting and suggestions for improvements by
9c7e8803
MK
2380 Michael Haardt)
2381 New page providing overview of pipes and FIFOs.
258755b2 2382
9c7e8803
MK
2383
2384Changes to individual pages
2385---------------------------
2386
2387HOWTOHELP
2388 mtk
2389 Added notes on how to write example programs for manual pages.
2390
2391fork.2
2392 mtk
2393 Added pointers to examples of fork() in wait.2 and pipe.2.
2394
2395pipe.2
2396 mtk
8fa20889
MK
2397 Added an example program.
2398 Added SEE ALSO for new pipe.7 page.
9c7e8803
MK
2399
2400wait.2
2401 mtk
2402 Added example program demonstrating use of fork() and waitpid().
2403
2404carg.3
2405 Justin Pryzby
258755b2
MK
2406 Delete line that should have been deleted when applying
2407 2.08 fix for this page.
9c7e8803
MK
2408
2409getaddrinfo.3
2410 mtk
2411 Rearranged EAI_* list alphabetically.
2412
2413inet.3
2414 mtk
2415 Added GLIBC NOTES describing feature test macros required
2416 to expose declaration of inet_aton().
2417
258755b2
MK
2418open_memstream.3
2419 mtk
8fa20889 2420 New link to new fmemopen.3.
258755b2 2421
9c7e8803 2422fifo.4
8fa20889
MK
2423 mtk
2424 Added SEE ALSO for new pipe.7 page.
9c7e8803
MK
2425
2426environ.5
2427 mtk
2428 Removed BROWSER, since it seems not in fact to be common.
2429
2430socket.7
2431 Urs Thuermann
2432 Added documentation of SO_TIMESTAMP.
2433
2434tcp.7
2435 mtk
2436 Noted 200 millisecond ceiling imposed on TCP_CORK.
2437
2438udp.7
2439 mtk
2440 Rearranged options into something approximating alphabetical order.
2441
a88415fa
MK
2442
2443==================== Changes in man-pages-2.18 ====================
2444
2445Released: 2005-12-15
2446
2447Contributors
2448------------
2449
2450The following people contributed notes, ideas, or patches that have
2451been incorporated in changes in this release:
2452
2453Justin Pryzby <justinpryzby@users.sf.net>
2454Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2455Martin (Joey) Schulze <joey@infodrom.org>
2456Mike Frysinger <vapier@gentoo.org>
2457Stefan Puiu <stefanpuiuro@yahoo.com>
2458
2459Apologies if I missed anyone!
2460
2461
2462Global changes
2463--------------
2464
2465Typographical or grammatical errors have been corrected in several
2466places.
2467
2468
2469Changes to individual pages
2470---------------------------
2471
2472bind.2
2473 mtk
2474 Added mention of AF_INET6 address family.
258755b2 2475 Added discussion of sockaddr structure and an example in the
a88415fa
MK
2476 Unix domain.
2477
2478recv.2
2479 mtk
2480 Put 'flags' list in alphabetical order.
258755b2 2481
a88415fa
MK
2482send.2
2483 mtk
258755b2 2484 Added cross-reference from discussion of MSG_MORE to UDP_CORK
a88415fa
MK
2485 in udp(7).
2486
2487 Put 'flags' list in alphabetical order.
2488
2489err.3
2490 mtk
258755b2 2491 Added CONFORMING TO section noting that these are
a88415fa 2492 non-standard BSDisms.
258755b2 2493
a88415fa
MK
2494errno.3
2495 Justin Pryzby
8fa20889 2496 Added SEE ALSO for err.3.
752cb57f 2497 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
a88415fa
MK
2498
2499gethostbyname.3
2500 Martin (Joey) Schulze / mtk
258755b2 2501 Added references to nsswitch.conf(5); remove cross references
ff75a911 2502 to resolv+(8).
752cb57f 2503 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308397
258755b2 2504
a88415fa
MK
2505perror.3
2506 Justin Pryzby
8fa20889 2507 Added SEE ALSO for err.3 .
752cb57f 2508 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
a88415fa
MK
2509
2510resolver.3
258755b2
MK
2511 mtk / Martin (Joey) Schulze
2512 Remove cross references to resolv+(8); add cross references to
ff75a911 2513 resolv.conf(5).
752cb57f 2514 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=214892
a88415fa 2515
8fa20889
MK
2516 Added SEE ALSO entry for resolver(5);
2517 see http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=251122
258755b2 2518
a88415fa
MK
2519strerror.3
2520 mtk / Stefan Puiu
755b5e17 2521 Rewrote and extended the discussion of the two flavors of
258755b2 2522 strerror_r(), and added some additional information on
a88415fa
MK
2523 strerror().
2524 Justin Pryzby
8fa20889 2525 Added SEE ALSO for err.3, as per
752cb57f 2526 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306867
a88415fa
MK
2527
2528
2529elf.5
2530 Mike Frysinger
2531 Fix three typos in identifier names.
2532
2533operator.7
2534 Karsten Sperling
2535 The + operator should be in the list of unary operators.
2536
2537raw.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
2543socket.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
aa651b39 2552 Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
a88415fa
MK
2553
2554udp.7
2555 mtk, after a note by Stefan Puiu
2556 Updated discussion of SO_BSDCOMPAT.
a88415fa
MK
2557
2558unix.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
258755b2 2563 Noted details of SO_SNBUF and SO_RCVBUF support for
a88415fa 2564 Unix domain sockets.
12f932b2
MK
2565
2566
2567==================== Changes in man-pages-2.19 ====================
2568
2569Released: 2005-12-23
2570
2571Contributors
2572------------
2573
2574The following people contributed notes, ideas, or patches that have
2575been incorporated in changes in this release:
2576
2577Andries Brouwer <Andries.Brouwer@cwi.nl>
2578Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2579Stefan Puiu <stefanpuiuro@yahoo.com>
2580
2581Apologies if I missed anyone!
2582
2583
2584Global changes
2585--------------
2586
2587Typographical or grammatical errors have been corrected in several
2588places.
2589
2590
2591Changes to individual pages
2592---------------------------
2593
2594HOWTOHELP
2595 mtk
2596 Minor changes.
2597
2598bind.2
2599 Stefan Puiu / mtk
258755b2 2600 Remove text under EINVAL error: "This may change in the future:
755b5e17 2601 see linux/unix/sock.c for details." This behavior has been
12f932b2
MK
2602 unchanged for a long time, and seems unlikely to change.
2603
2604 Add EADDRINUSE to errors.
2605
2606send.2
2607 aeb
2608 Add cmsg(3) to SEE ALSO.
2609
2610fopen.3
2611 Walter Harms / mtk
2612 Added description of 'x' mode character (exclusive open).
2613
2614pipe.7
2615 mtk / aeb
2616 Some wording changes to description of pipes.
2617
2548fb7d
MK
2618
2619==================== Changes in man-pages-2.20 ====================
2620
2621Released: 2006-01-03
2622
2623Global changes
2624--------------
2625
2626Typographical or grammatical errors have been corrected in several
2627places.
2628
2629
2630Changes to individual pages
2631---------------------------
2632
2633sigaltstack.2
2634 mtk
258755b2 2635 Added some text to explain the usual scenario in which
2548fb7d
MK
2636 sigaltstack() is employed.
2637
2638getloadavg.3
2639 mtk
2640 Noted that this function is available since glibc 2.2.
2641
2642strcpy.3
2643 mtk
2644 s/nulls/null bytes/
2645
2646capabilities.7
2647 mtk
2648 Noted that capability bounding set appeared with kernel 2.2.11.
2649
2650arp.7
2651icmp.7
2652ip.7
2653ipv6.7
2654netdevice.7
2655packet.7
2656raw.7
2657rtnetlink.7
2658socket.7
2659tcp.7
2660unix.7
2661udp.7
2662 mtk
2663 The only changes to these pages have been for formatting:
2664 -- Structure definitions were changed to K&R style
258755b2 2665 -- Some long source lines were broken to fit into ~70
2548fb7d
MK
2666 character lines.
2667 No changes were made to the content of these pages (yet...).
2668
93e6d731
MK
2669
2670==================== Changes in man-pages-2.21 ====================
2671
2672Released: 2006-01-16
2673
2674Contributors
2675------------
2676
2677The following people contributed notes, ideas, or patches that have
2678been incorporated in changes in this release:
2679
2680Andries Brouwer <Andries.Brouwer@cwi.nl>
2681Falk Hueffner <falk@debian.org>
2682Mike Frysinger <vapier@gentoo.org>
2683Senthil Kumar <senthilkumar_sen@hotpop.com>
2684Stefan Puiu <stefanpuiuro@yahoo.com>
2685
2686Apologies if I missed anyone!
2687
2688
2689Global changes
2690--------------
2691
258755b2 2692dd.1 cp.1
93e6d731
MK
2693truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2694sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2695argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
258755b2
MK
2696gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2697perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
93e6d731
MK
2698strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2699dsp56k.4 tty_ioctl.4
2700elf.5 proc.5 termcap.5
2701charsets.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
258755b2 2706 To rectify this the following changes were made in the above
93e6d731 2707 pages:
258755b2 2708
93e6d731
MK
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
2718Various pages
2719 mtk
258755b2
MK
2720 Replace "SysV"/"SYSV" by "System V".
2721
93e6d731
MK
2722Typographical or grammatical errors have been corrected in several
2723places.
2724
2725
93e6d731
MK
2726Changes to individual pages
2727---------------------------
2728
2729capget.2
2730 mtk
2731 Noted bug that could wrongly cause EPERM in unprivileged
2732 capset() with 'pid' field == getpid().
258755b2 2733
93e6d731
MK
2734epoll_ctl.2
2735 mtk
2736 Noted that EPOLLONESHOT was added in 2.6.2.
258755b2 2737
93e6d731
MK
2738gethostname.2
2739 mtk
2740 Added GLIBC NOTES describing operation of glibc's
2741 gethostname() wrapper function.
2742
2743mmap.2
2744 mtk / Mike Frysinger
8fa20889 2745 Clarify relationship between mmap2(2) and mmap64(3).
93e6d731
MK
2746 mtk
2747 A few other small rewordings.
2748
258755b2
MK
2749mmap64.3
2750 Mike Frysinger
8fa20889 2751 New link to mmap.2.
258755b2 2752
93e6d731
MK
2753open.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
2758recv.2
2759 Stefan Puiu
2760 Relocate misplaced discussion of MSG_DONTWAIT.
258755b2 2761
93e6d731
MK
2762dlopen.3
2763 mtk
2764 Rewrote discussion of dlopen() 'flag' argument;
258755b2 2765 added descriptions of RTLD_NOLOAD, RTLD_DELETE,
93e6d731
MK
2766 and RTLD_DEEPBIND.
2767
258755b2 2768 Noted use of atexit() to register a function that is
93e6d731
MK
2769 automatically called when a library is unloaded.
2770
2771fmemopen.3
2772 mtk
2773 Rewrote substantial parts of the page, and relicensed under GPL.
2774
2775fseeko.3
2776 Mike Frysinger
2777 Add RETURN VALUE section.
2778
2779getopt.3
2780 mtk
2781 Noted historical use of <stdio.h> to declare getopt().
2782
2783qsort.3
2784 mtk / Falk Hueffner
2785 Clarify how strcmp() should be used as the 'compar'
2786 function by providing an example.
8fa20889 2787 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348072
93e6d731
MK
2788
2789proc.5
2790 mtk
2791 Noted that /proc/mounts is pollable since kernel 2.6.15.
2792
2793 Documented /proc/PID/task.
2794
258755b2 2795 Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
93e6d731 2796 are not available if the main thread has terminated.
258755b2
MK
2797
2798 Senthil Kumar
93e6d731
MK
2799 Add pointer to random(4) for description of files under
2800 /proc/sys/kernel/random.
2801
2802udp.7
2803 Stefan Puiu / mtk
258755b2 2804 Small rewording of discussion of SO_BSDCOMPAT
93e6d731 2805 (add cross-ref to socket(7)).
04a57fff
MK
2806
2807
2808==================== Changes in man-pages-2.22 ====================
2809
2810Released: 2006-02-02
2811
2812Contributors
2813------------
2814
2815The following people contributed notes, ideas, or patches that have
2816been incorporated in changes in this release:
2817
2818Alain Portal <aportal@univ-montp2.fr>
2819Andre Noll <maan@systemlinux.org>
2820Andries Brouwer <Andries.Brouwer@cwi.nl>
2821Colin Tuckley <colin@tuckley.org>
2822Stefan Puiu <stefanpuiuro@yahoo.com>
2823Thomas Hood <jdthood@yahoo.co.uk>
2824Thorsten Kukuk <kukuk@suse.de>
2825Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2826
2827
2828Global changes
2829--------------
2830
2831Typographical or grammatical errors have been corrected in several
2832places.
2833
258755b2
MK
2834Changes to individual pages
2835---------------------------
04a57fff 2836
258755b2 2837mmap.2
cc1d6beb 2838 aeb / mtk
258755b2
MK
2839 Noted that portable applications should specify fd as -1
2840 when using MAP_ANONYMOUS.
2841 Some rewriting of description of MAP_ANONYMOUS.
04a57fff
MK
2842
2843rt_sigreturn.2
2844 Thorsten Kukuk
8fa20889 2845 New link to sigreturn.2.
04a57fff
MK
2846
2847rt_sigsuspend.2
2848 mtk
8fa20889 2849 New link to sigsuspend.2.
04a57fff 2850
04a57fff
MK
2851waitid.2
2852 mtk
2853 Noted that waitid() does not set infop->si_uid field on
2854 most other implementations.
258755b2 2855
04a57fff
MK
2856getopt.3
2857 Walter harms / mtk
258755b2 2858 Make clear that when calling getopt_long() and there are no
04a57fff
MK
2859 short options, then 'optstring' should be "", not NULL.
2860
2861openpty.3
2862 Thomas Hood / mtk
258755b2 2863 In glibc 2.0.92, openpty() was modified to preferably open
04a57fff
MK
2864 Unix 98 ptys instead of BSD ptys.
2865
2866qsort.3
2867 mtk
8fa20889 2868 Small rewording under EXAMPLES.
04a57fff
MK
2869
2870strtol.3
2871strtoul.3
2872 Stefan Puiu
2873 s/string must begin/string may begin/
2874
2875proc.5
2876 mtk
2877 Documented inotify files under /proc/sys/fs/inotify:
2878 max_queued_events, max_user_instances, and max_user_watches.
2879
c9c0d377
MK
2880
2881==================== Changes in man-pages-2.23 ====================
2882
2883Released: 2006-02-10
2884
2885Contributors
2886------------
2887
2888The following people contributed notes, ideas, or patches that have
2889been incorporated in changes in this release:
2890
2891Andi Kleen <ak@muc.de>
2892Britton Leo Kerin <bkerin_rb@letterboxes.org>
2893Dan Jacobson <jidanni@jidanni.org>
2894Justin Pryzby <justinpryzby@users.sourceforge.net>
2895Luc Van Oostenryck <lkml@looxix.net>
2896Kurt Wall <kwall@kurtwerks.com>
2897Martin (Joey) Schulze <joey@infodrom.org>
2898Matthias Andree <matthias.andree@gmx.de>
2899Robert Love <rlove@rlove.org>
2900Samuel Thibault <samuel.thibault@ens-lyon.org>
2901Urs Thuermann <urs@isnogud.escape.de>
2902
2903Apologies if I missed anyone!
2904
2905Global changes
2906--------------
2907
2908Typographical or grammatical errors have been corrected in several
2909places.
2910
2911
2912New pages
2913---------
2914
2915inotify_init.2
2916inotify_add_watch.2
2917inotify_rm_watch.2
2918 Robert Love, with some additions by mtk.
2919 New pages describing the inotify API.
258755b2 2920
c9c0d377
MK
2921mbind.2
2922get_mempolicy.2
2923set_mempolicy.2
2924 Andi Kleen, with additional work by mtk
2925 New pages describing the NUMA memory allocation policy API.
18345720 2926 Drawn from the set at ftp://ftp.suse.com/pub/people/ak/numa.
c9c0d377
MK
2927
2928rtc.4
c533af9d 2929 Urs Thuermann, with additional work by mtk
c9c0d377
MK
2930 New page describing the real-time clock driver.
2931
2932inotify.7
2933 mtk
2934 Overview of the inotify API.
2935
2936Changes to individual pages
2937---------------------------
2938
2939clone.2
2940 Andi Kleen
258755b2 2941 On x86, clone() should not be called through vsyscall,
c9c0d377
MK
2942 but directly through "int $0x80".
2943
2944fcntl.2
2945 mtk
2946 Small wording changes.
2947
2948 Added cross-ref to inotify.7 under the description of dnotify.
2949
2950kill.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.
8fa20889 2954 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350236
258755b2 2955
c9c0d377
MK
2956mlock.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"
258755b2 2963
c9c0d377
MK
2964msgop.2
2965 mtk / Samuel Thibault
2966 Rewrote declaration of 'msgp' to be "void *" in response
8fa20889 2967 to http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=350884
c9c0d377
MK
2968 Various other wording fixes.
2969
2970open.2
2971 mtk
258755b2 2972 Clarify distinction between "file creation flags" and
c9c0d377
MK
2973 "file status flags".
2974
2975read.2
2976 Justin Pryzby
2977 Add SEE ALSO for pread(2).
8fa20889 2978 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351873
258755b2 2979
c9c0d377
MK
2980sched_setaffinity.2
2981 mtk
2982 Major rewrite.
2983
2984select.2
2985 mtk
258755b2 2986 Added return types to prototypes for FD_SET(), FD_CLR(),
c9c0d377
MK
2987 FD_ZERO, and FD_ISSET().
2988 Other minor wording changes.
2989
2990read.2
2991 mtk
2992 Add SEE ALSO for pwrite(2).
2993 (Analogous with read.2 change above.)
258755b2 2994
c9c0d377
MK
2995errno.3
2996 Kurt Wall / mtk
2997 Add Linux specific errors to this page.
2998
2999localeconv.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
8fa20889 3005 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
c9c0d377
MK
3006
3007scanf.3
3008 mtk / Justin Pryzby
3009 Minor formatting & wording fixes.
3010
3011setlocale.3
3012 Martin (Joey) Schulze
3013 Added SEE ALSO refs for nl_langinfo.3
8fa20889 3014 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351831
258755b2 3015
c9c0d377
MK
3016proc.5
3017 mtk
3018 Migrated description of inotify files to the new inotify.7 page.
3019
3020ascii.7
3021 Dan Jacobson / mtk
3022 Add text describing characters 001 to 037.
8fa20889 3023 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=342173
c9c0d377
MK
3024
3025locale.7
3026 mtk
3027 Minor wording and formatting changes.
3028
3029
b8798cc4
MK
3030==================== Changes in man-pages-2.24 ====================
3031
3032Released: 2006-02-17
3033
3034Contributors
3035------------
3036
3037The following people contributed notes, ideas, or patches that have
3038been incorporated in changes in this release:
3039
3040Joerg Habenicht <habenich@planetserver.com>
3041Luc Van Oostenryck <lkml@looxix.net>
3042Mike Frysinger <vapier@gentoo.org>
3043Samuel Thibault <samuel.thibault@ens-lyon.org>
3044
3045Apologies if I missed anyone!
3046
3047
3048New pages
3049---------
3050
258755b2
MK
3051get_kernel_syms.2
3052create_module.2
3053delete_module.2
3054init_module.2
b8798cc4
MK
3055query_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.
258755b2 3061
b8798cc4
MK
3062
3063Global changes
3064--------------
3065
3066various pages
3067 mtk
3068 Change "file name" to "filename"
3069 Change "path name" to "pathname"
3070
3071stpncpy.3
3072strstr.3
3073strcmp.3
3074toupper.3
3075strlen.3
3076stpcpy.3
3077puts.3
3078strdup.3
3079strtok.3
3080isalpha.3
3081strspn.3
3082gets.3
3083strpbrk.3
3084 mtk after a suggestion from Samuel Thibault
3085 Added SEE ALSO pointers to wide character equivalent functions
8fa20889 3086 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=351996
b8798cc4
MK
3087
3088Typographical or grammatical errors have been corrected in several
3089places.
3090
3091
3092Changes to individual pages
3093---------------------------
3094
3095clone.2
3096 mtk
3097 Remove duplicate CLONE_STOPPED text.
3098 Commented out crufty text describing EINVAL error
8fa20889 3099 for the now obsolete CLONE_DETACHED flag.
b8798cc4 3100 Under CLONE_SIGHAND, noted that 'flags' must also include
8fa20889 3101 CLONE_VM if CLONE_SIGHAND is specified.
b8798cc4
MK
3102
3103fcntl.2
3104 mtk
3105 Under ERRORS: Separate out EAGAIN error for locking mmaped files.
258755b2 3106
b8798cc4
MK
3107inotify_add_watch.2
3108 mtk
3109 Minor wording fix.
258755b2 3110
b8798cc4
MK
3111msgop.2
3112 mtk
3113 Documented the EAGAIN error for msgrcv().
258755b2 3114
b8798cc4
MK
3115fnmatch.3
3116 Mike Frysinger / mtk
3117 Expand explanation of FNM_PATHNAME.
3118
3119lockf.3
28b3a122
MK
3120 Joerg Habenicht / mtk
3121 Fix up discussion of EAGAIN/EACCESS errors.
c9c0d377 3122
6ca981dc
MK
3123
3124==================== Changes in man-pages-2.25 ====================
3125
3126Released: 2006-03-02
3127
3128Contributors
3129------------
3130
3131The following people contributed notes, ideas, or patches that have
3132been incorporated in changes in this release:
3133
3134James Peach <jpeach@samba.org>
3135Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3136Marten von Gagern <Martin.vGagern@gmx.net>
3137Michael Haardt <michael@moria.de>
3138Michael Wronksi <michal.wronski@gmail.com>
3139
3140Apologies if I missed anyone!
3141
3142
3143New pages
3144---------
3145
3146mq_close.3
3147mq_getattr.3
3148mq_notify.3
3149mq_open.3
3150mq_receive.3
3151mq_send.3
3152mq_unlink.3
3153 mtk
3154 New pages describing POSIX message queue API.
3155
3156posix_fallocate.3
3157 mtk, after a suggestion by James Peach
3158 New page describing posix_fallocate().
258755b2 3159
6ca981dc
MK
3160mq_overview.7
3161 mtk
3162 New page giving overview of the POSIX message queue API.
3163
3164
3165Changes to individual pages
3166---------------------------
3167
3168lseek.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
3175posix_fadvise.2
3176 mtk
3177 Added "#define _XOPEN_SOURCE 600" to prototype.
3178 Added SEE ALSO referring to new posix_fallocate.3.
3179
3180proc.5
3181 mtk
3182 Migrated information on POSIX message queues to new mqueue.7 page.
3183
3184inotify.7
3185 Marten von Gagern
3186 Fix thinko: s/assuming a non-blocking/assuming a blocking/
d46e2e6a
MK
3187
3188
d1c685f3 3189==================== Changes in man-pages-2.26 ====================
d46e2e6a 3190
d1c685f3 3191Released: 2006-03-21
d46e2e6a
MK
3192
3193Contributors
3194------------
3195
3196The following people contributed notes, ideas, or patches that have
3197been incorporated in changes in this release:
3198
3199Alain Portal <aportal@univ-montp2.fr>
3200Andi Kleen <ak@muc.de>
3201Andries Brouwer <Andries.Brouwer@cwi.nl>
3202Christoph Lameter <clameter@engr.sgi.com>
3203Hasso Tepper <hasso@estpak.ee>
3204Justin Pryzby <justinpryzby@users.sourceforge.net>
3205Martin (Joey) Schulze <joey@infodrom.org>
33972b0b 3206Nicolas François <nicolas.francois@centraliens.net>
d46e2e6a
MK
3207Paul Brook <paul@nowt.org>
3208Siward de Groot <siward@wanadoo.nl>
3209Steve Beattie <sbeattie@suse.de>
3210Walter Harms <walter.harms@informatik.uni-oldenburg.de>
3211
3212Apologies if I missed anyone!
3213
3214Global changes
3215--------------
3216
3217clone.2
3218getdents.2
3219gettid.2
3220llseek.2
3221mmap2.2
3222modify_ldt.2
3223pivot_root.2
3224quotactl.2
3225readdir.2
3226sysctl.2
3227syslog.2
3228tkill.2
3229 mtk, aeb, Steve Beattie
258755b2 3230 Added comment in SYNOPSIS to note that syscall(2) may be
d46e2e6a
MK
3231 preferable over _syscallN (see intro(2)).
3232
258755b2 3233Various minor formatting changes were done on a range of
d46e2e6a
MK
3234pages in Section 7. (No content was changed.)
3235
3236New pages
3237---------
3238
d46e2e6a
MK
3239openat.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
3244mbind.2
3245 Andi Kleen, Christoph Lameter, mtk
8fa20889
MK
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.
d46e2e6a 3249
d46e2e6a
MK
3250fexecve.3
3251 mtk
3252 New page describing fexecve(3).
3253
3254futimes.3
3255 mtk
3256 New page describing futimes(3).
3257
d46e2e6a
MK
3258Changes to individual pages
3259---------------------------
3260
d46e2e6a
MK
3261execve.2
3262 mtk
3263 Added SEE ALSO pointing to new fexecve.3.
3264
d1c685f3
MK
3265intro.2
3266 mtk, aeb, Steve Beattie
3267 Added some notes on syscall(2) versus _syscall.
258755b2 3268
d46e2e6a
MK
3269msgctl.2
3270msgget.2
3271msgop.2
3272 mtk
3273 Added SEE ALSO pointing to mq_overview.7.
3274
3275open.2
3276 mtk
3277 Added SEE ALSO pointing to new openat.2.
258755b2
MK
3278
3279 Split out part of the RETURN VALUE text into separate
d46e2e6a
MK
3280 NOTES section.
3281
d1c685f3 3282 Modified wording referring to raw(8) to
d46e2e6a
MK
3283 indicate that this interface is deprecated.
3284
3285poll.2
3286 mtk
3287 Added discussion of ppoll(2), which is new in 2.6.16.
258755b2 3288
d46e2e6a
MK
3289ppoll.2
3290 mtk
3291 New link to poll.2.
3292
3293recvmsg.2
3294sendmsg.2
3295 mtk / Paul Brook
258755b2 3296 Added text to note that although POSIX says msg_controllen
d46e2e6a 3297 should be socklen_t, glibc actually uses size_t.
8fa20889 3298 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=356502
752cb57f 3299 and the associated glibc bug report.
8fa20889 3300 http://sourceware.org/bugzilla/show_bug.cgi?id=2448
d46e2e6a
MK
3301 mtk
3302 Various formatting fixes.
3303
3304select.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
3311tempnam.3
3312 Justin Pryzby
3313 Clean up description of EEXIST error.
8fa20889 3314 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=357893
d46e2e6a
MK
3315
3316unlink.2
3317 mtk
3318 Added a little extra text to clarify EISDIR vs EPERM.
3319
3320utime.2
3321 mtk
3322 Added new SEE ALSO entry pointing to new futimes.3 page.
3323
3324exec.3
3325 mtk
3326 Added SEE ALSO pointing to new fexecve.3.
3327
3328shm_unlink.3
3329 mtk
3330 New link to shm_open.3 (should have been made when page
3331 was originally written).
3332
3333swab.3
3334 Walter Harms
3335 Add needed "#define _XOPEN_SOURCE".
258755b2 3336
d1c685f3
MK
3337undocumented.3
3338 mtk
3339 Updated to remove a few function names that are now documented.
3340
d46e2e6a
MK
3341capabilities.7
3342 mtk
3343 Various changes to bring this page closer to
3344 current kernel versions.
3345
3346inotify.7
3347 mtk
3348 Noted that glibc 2.4 is required to get glibc support
3349 for inotify.
3350
3351mq_overview.7
3352 mtk
258755b2 3353 Some rewording and added a few words about System V
d46e2e6a
MK
3354 message queues.
3355
3356netlink.7
3357 Hasso Tepper
3358 Substantial updates to various parts of this page.
3359 mtk, Alain Portal
3360 Minor fixes
3361
3362pthreads.7
3363 mtk
258755b2 3364 Updated to reflect that the NPTL limitation that only the main
d46e2e6a
MK
3365 thread could call setsid() and setpgid() was removed in 2.6.16.
3366
3367raw.7
3368 Hasso Tepper
258755b2 3369 Removed text implying that only in kernel 2.2 does IP_HDRINCL
d46e2e6a
MK
3370 prevent datagrams from being fragmented.
3371
3372socket.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.
8beb2f7b
MK
3378
3379
3380==================== Changes in man-pages-2.27 ====================
3381
3382Released: 2006-03-24
3383
3384Contributors
3385------------
3386
3387The following people contributed notes, ideas, or patches that have
3388been incorporated in changes in this release:
3389
3390Andries Brouwer <Andries.Brouwer@cwi.nl>
3391Charles P. Wright <cwright@cs.sunysb.edu>
3392Christoph Lameter <clameter@sgi.com>
3393Chuck Ebbert <76306.1226@compuserve.com>
3394Daniel Jacobowitz <dan@debian.org>
3395Ingo Molnar <mingo@elet.hu>
3396Heiko Carstens <heiko.carstens@de.ibm.com>
3397Janak Desai <janak@us.ibm.com>
3398Paolo (Blaisorblade) Giarrusso <blaisorblade@yahoo.it>
3399Stefan Puiu <stefanpuiuro@yahoo.com>
3400
3401Apologies if I missed anyone!
3402
3403
3404Global changes
3405--------------
3406
8fa20889
MK
3407man7/*
3408 mtk
3409 Various minor formatting changes were done on a range of
3410 pages in Section 7. (No content was changed.)
8beb2f7b
MK
3411
3412
3413New pages
3414---------
3415
5cf12228 3416unshare.2
8beb2f7b
MK
3417 mtk, with reference to documentation by Janak Desai
3418 New page describing unshare(2), added in kernel 2.6.16.
3419
3420
3421Changes to individual pages
3422---------------------------
3423
3424clone.2
3425fork.2
3426vfork.2
3427 mtk
3428 Added SEE ALSO pointing to new unshare.2.
3429
3430mbind.2
3431 Christoph Lameter
3432 MPOL_MF_MOVE_ALL requires CAP_SYS_NICE not CAP_SYS_RESOURCE.
3433
3434mremap.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
3440ptrace.2
258755b2 3441 Chuck Ebbert, with assistance from Daniel Jacobowitz,
8beb2f7b
MK
3442 Paolo (Blaisorblade) Giarrusso, and Charles P. Wright;
3443 after a suggestion from Heiko Carstens.
258755b2 3444 Document the following ptrace requests:
8beb2f7b
MK
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)
258755b2 3459
8beb2f7b
MK
3460sched_get_priority_max.2
3461sched_setscheduler.2
3462sched_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
3472proc.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
3478capabilities.7
3479 mtk
3480 Noted affect of CAP_SYS_NICE for mbind(MPOL_MF_MOVE_ALL).
3481
3482pthreads.7
3483 mtk
755b5e17 3484 Kernel 2.6.16 eliminated buggy behavior with respect to
8beb2f7b 3485 the alternate signal stack.
e47f9a2d
MK
3486
3487
3488==================== Changes in man-pages-2.28 ====================
3489
3490Released: 2006-03-31
3491
3492Contributors
3493------------
3494
3495The following people contributed notes, ideas, or patches that have
3496been incorporated in changes in this release:
3497
3498Aleksandr Blokhin <sass@altlinux.ru>
3499Greg Johnson <gjohnson@lanl.gov>
3500
3501Apologies if I missed anyone!
3502
3503
e47f9a2d
MK
3504New pages
3505---------
3506
3507sem_post.3
3508sem_getvalue.3
3509sem_close.3
3510sem_open.3
3511sem_destroy.3
3512sem_wait.3
3513sem_unlink.3
3514sem_init.3
3515sem_overview.7
3516 mtk
3517 New pages describing the POSIX semaphores API.
3518
2b82fac6 3519 These pages supersede and provide a superset of the information
e47f9a2d
MK
3520 in the glibc (3thr) "semaphores(3)" manual page.
3521
66c4fb12 3522
e47f9a2d
MK
3523Changes to individual pages
3524---------------------------
3525
3526ppoll.2
40a54b37 3527 Aleksandr Blokhin
e47f9a2d
MK
3528 Fix broken link.
3529
3530ptrace.2
3531 mtk
3532 Wrapped long lines (no content changes).
3533
3534semctl.2
3535semget.2
3536semop.2
3537 mtk
3538 Add SEE ALSO pointing to the new sem_overview.7 page.
3539
3540elf.5
3541 Greg Johnson
58ce1507 3542 Removed SEE ALSO reference to nonexistent core(5).
552d2664
MK
3543
3544
3545==================== Changes in man-pages-2.29 ====================
3546
3547Released: 2006-04-06
3548
3549Contributors
3550------------
3551
3552The following people contributed notes, ideas, or patches that have
3553been incorporated in changes in this release:
3554
3555Michael Haardt <michael@moria.de>
3556Roberto Jimenoca <robertojimenoca@terra.es>
3557Stefan Puiu <stefanpuiuro@yahoo.com>
3558
3559Apologies if I missed anyone!
3560
3561
3562Global changes
3563--------------
3564
3565getrlimit.2
3566prctl.2
3567sigaction.2
3568elf.5
3569signal.7
3570 mtk
3571 Added SEE ALSO entry referring to new core.5 page.
3572
3573
3574New pages
3575---------
3576
3577mkdirat.2
3578 mtk
3579 New page describing mkdirat(2), new in 2.6.16.
3580
3581mknodat.2
3582 mtk
3583 New page describing mknodat(2), new in 2.6.16.
3584
3585core.5
3586 mtk
3587 New page describing core dump files.
3588
3589mkfifoat.3
3590 mtk
3591 New page describing mkfifoat(3).
3592
3593
3594Changes to individual pages
3595---------------------------
3596
3597accept.2
3598getpeername.2
3599getsockname.2
3600 Michael Haardt / mtk
3601 Document EINVAL error for 'len' argument < 0.
3602
3603fcntl.2
3604 mtk
3605 Expanded discussion of mandatory locking.
3606
3607getrlimit.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
3613mkdir.2
3614 mtk
28b3a122 3615 Added SEE ALSO entry referring to new mkdirat.2.
552d2664
MK
3616
3617mknod.2
3618 mtk
28b3a122 3619 Added SEE ALSO entry referring to new mknodat.2.
552d2664
MK
3620
3621open.2
3622 mtk / Roberto Jimenoca
3623 Clarified discussion of file types affected by O_NONBLOCK.
8fa20889 3624 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=360243
258755b2 3625
552d2664
MK
3626openat.2
3627 mtk
3628 Rewrote NOTES describing rationale for openat().
3629 Various other minor changes.
3630
3631recv.2
3632 Stefan Puiu
3633 Removed a misleading cross-ref to socket.2.
258755b2 3634
552d2664
MK
3635shmop.2
3636 mtk
8fa20889
MK
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.
552d2664
MK
3639
3640unshare.2
3641 mtk
258755b2
MK
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
552d2664
MK
3645 with a consequent EINVAL error.
3646
3647mkfifo.3
3648 mtk
28b3a122 3649 Added SEE ALSO entry referring to new mkfifoat.3.
552d2664
MK
3650
3651proc.5
3652 mtk
3653 Information on core_pattern and core_uses_pid has
3654 been migrated to the new core.5 page.
3655
3656ip.7
3657 Stefan Puiu
3658 Removed paragraph referring to obsolete ipchains / ipfw(4).
3659
3660sem_overview.7
3661 mtk
3662 Add SEE ALSO entry referring to pthreads.7.
d3fdafe7
MK
3663
3664
3665==================== Changes in man-pages-2.30 ====================
3666
3667Released: 2006-04-17
3668
3669Contributors
3670------------
3671
3672The following people contributed notes, ideas, or patches that have
3673been incorporated in changes in this release:
3674
3675Andre Lehovich <andrel@yahoo.com>
3676Andries Brouwer <Andries.Brouwer@cwi.nl>
3677Karel Kulhavy <clock@twibright.com>
3678Stefan Puiu <stefanpuiuro@yahoo.com>
3679
3680Apologies if I missed anyone!
3681
3682
3683New pages
3684---------
3685
3686linkat.2
3687 mtk
3688 New page describing linkat(), new in kernel 2.6.16
3689
3690renameat.2
3691 mtk
3692 New page describing renameat(), new in kernel 2.6.16
3693
3694symlinkat.2
3695 mtk
3696 New page describing symlinkat(), new in kernel 2.6.16
3697
3698unlinkat.2
3699 mtk
3700 New page describing unlinkat(), new in kernel 2.6.16
3701
3702
3703Changes to individual pages
3704---------------------------
3705
3706link.2
3707 mtk
3708 Added SEE ALSO entry pointing to new linkat.2 page.
3709
3710openat.2
3711 mtk
3712 Added SEE ALSO entries pointing to new *at.2 pages.
3713
3714rename.2
3715 mtk
3716 Added SEE ALSO entry pointing to new renameat.2 page.
3717
3718rmdir.2
3719 mtk
3720 Added SEE ALSO entry pointing to new unlinkat.2 page.
3721
3722symlink.2
3723 mtk
3724 Added SEE ALSO entry pointing to new symlinkat.2 page.
3725
3726unlink.2
3727 mtk
3728 Added SEE ALSO entry pointing to new unlinkat.2 page.
3729
3730termios.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.
258755b2 3740
d3fdafe7
MK
3741full.4
3742 Andre Lehovich
3743 Add a sentence describing the purpose of full(4).
3744
3745core.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.
994ef54b
MK
3754
3755
3756==================== Changes in man-pages-2.31 ====================
3757
3758Released: 2006-05-02
3759
3760Contributors
3761------------
3762
3763The following people contributed notes, ideas, or patches that have
3764been incorporated in changes in this release:
3765
3766Joshua Kwan <joshk@triplehelix.org>
3767Justin Pryzby <justinpryzby@users.sourceforge.net>
3768Karel Kulhavy <clock@twibright.com>
3769Mark Glines <mark@glines.org>
3770Martin (Joey) Schulze <joey@infodrom.org>
3771Nishanth Aravamudan <nacc@us.ibm.com>
3772Reuben Thomas <rrt@sc3d.org>
3773Ryan S. Arnold <rsa@us.ibm.com>
3774Ulrich Drepper <drepper@redhat.com>
3775
3776Apologies if I missed anyone!
3777
3778
3779Page renamings
3780--------------
3781
3782The following pages have been relocated into section 7, since
3783that is their more natural home. SEE ALSO references in various
3784other pages have been adjusted.
3785
3786epoll.4
3787fifo.4
3788futex.4
3789complex.5
8fa20889
MK
3790environ.5
3791 (many pages outside man-pages actually *expect*
3792 'environ' to be in Section 7.)
3793
3794ipc.5
3795 renamed to svipc.7
994ef54b 3796
258755b2
MK
3797".so" link files have been created to link the old file locations to the
3798new file locations. These links are added just to ensure that cross
994ef54b 3799references from any other (non-man-pages) pages will remain valid;
258755b2 3800eventually these links will be removed.
994ef54b
MK
3801
3802
3803New pages
3804---------
3805
3806fstatat.2
3807 mtk
3808 New page for fstatat(2), new in 2.6.16.
3809
3810adjtime.3
3811 mtk
3812 New page for adjtime(3).
258755b2 3813
994ef54b
MK
3814error.3
3815 Justin Pryzby / mtk
3816 New page describing error() and error_at_line()
8fa20889 3817 Fixes http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=186307
994ef54b 3818
994ef54b
MK
3819program_invocation_name.3
3820 mtk
258755b2 3821 New page describing program_invocation_name and
994ef54b 3822 program_invocation_short_name variables.
994ef54b
MK
3823
3824sockatmark.3
3825 mtk
3826 New page for sockatmark(3).
3827
3828ftm.7
3829 mtk
3830 New page describing feature test macros.
3831
3832time.7
3833 mtk
3834 New page giving an overview of "time" on Linux systems.
3835
3836
3837Global changes
3838--------------
3839
3840getgroups.2
3841wait4.2
3842chown.2
3843chdir.2
3844gettimeofday.2
3845initgroups.3
3846dirfd.3
3847 mtk
258755b2 3848 Simplified wording around requirement for _BSD_SOURCE
994ef54b 3849 feature test macro.
258755b2 3850
994ef54b
MK
3851times.2
3852time.2
3853gettimeofday.2
3854getitimer.2
3855nanosleep.2
3856ctime.3
3857rtc.4
3858 mtk
3859 Added SEE ALSO referring to new time.7.
3860
258755b2 3861err.3
994ef54b
MK
3862errno.3
3863perror.3
3864strerror.3
3865 Justin Pryzby / mtk
3866 Add SEE ALSO referring to new error.3.
3867
3868getdate.3
3869printf.3
3870scanf.3
3871 mtk
3872 Added SEE ALSO entry referring to setlocale.3.
3873
3874
3875Changes to individual pages
3876---------------------------
3877
3878accept.2
3879 Mark Glines
258755b2 3880 Remove mention of SOCK_RDM from this page, since this socket
994ef54b
MK
3881 type does not support accept()ing connections.
3882
3883adjtimex.2
3884 mtk
3885 Modified text referring to adjtime(); added SEE ALSO for new
3886 adjtime.3 page.
258755b2 3887
994ef54b
MK
3888fsync.2
3889 mtk, after a note by Karel Kulhavy
258755b2 3890 Rewrote most of the DESCRIPTION, as well as some other parts
994ef54b
MK
3891 the page, to clarify use and operation of, and rationale for,
3892 fsync(2) and fdatasync(2).
3893
3894getitimer.2
8fa20889
MK
3895 mtk
3896 Updated discussion of maximum timer value to reflect the fact
3897 that the default jiffy is now 4 milliseconds.
994ef54b 3898
8fa20889
MK
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.
258755b2 3902
994ef54b
MK
3903gettimeofday.2
3904 Karel Kulhavy
258755b2 3905 Point out more explicitly that 'tz' argument should
994ef54b
MK
3906 normally be NULL.
3907 mtk
3908 Various other minor edits and formatting fixes.
3909
3910mount.2
3911 mtk
258755b2 3912 Since kernel 2.6.16, MS_NOATIME and MS_NODIRATIME are settable
994ef54b
MK
3913 on a per-mount basis.
3914 Detail exactly which mount flags can be changed on MS_REMOUNT.
258755b2 3915
994ef54b
MK
3916nanosleep.2
3917 mtk / Karel Kulhavy
3918 Clarify RETURN VALUE discussion.
3919
3920openat.2
3921 mtk
3922 Add SEE ALSO reference pointing to new fstatat.2.
3923
258755b2
MK
3924program_invocation_short_name.3
3925 mtk
3926 New link to new program_invocation_name.3.
3927
994ef54b
MK
3928recv.2
3929 mtk
3930 Added SEE ALSO for new sockatmark.3.
258755b2 3931
994ef54b
MK
3932rmdir.2
3933 Joshua Kwan / Martin (Joey) Schulze / mtk
3934 Correct wording of EBUSY case.
3935 mtk
3936 Add ".." case to ENOTEMPTY error
258755b2 3937
994ef54b
MK
3938select.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.
258755b2 3945
994ef54b
MK
3946semget.2
3947 mtk / Nishanth Aravamudan
3948 Add text to noting that the initial values of semaphores
3949 in a new set are indeterminate.
258755b2 3950
994ef54b
MK
3951shmget.2
3952 mtk
258755b2 3953 Add text noting that contents of newly created segment are zero
994ef54b 3954 values.
258755b2 3955
994ef54b
MK
3956sigwaitinfo.2
3957 mtk
3958 Noted that all threads should block signal being waited for.
3959
3960stat.2
3961 Nishanth Aravamudan / mtk
258755b2 3962 Added NOTE that st_size is always returned as zero for most
994ef54b
MK
3963 /proc files.
3964 mtk
3965 Add SEE ALSO reference pointing to new fstatat.2.
3966
3967syscall.2
3968 Justin Pryzby / mtk
3969 Remove bogus BUGS text.
3970
3971utime.2
3972 mtk
3973 Various minor changes.
3974
3975confstr.3
3976 mtk
3977 Rewrote RETURN VALUE discussion.
3978 Updated CONFORMING TO.
3979 Removed BUGS.
258755b2 3980
994ef54b
MK
3981ctanh.3
3982 Martin (Joey) Schulze / mtk
3983 Fix errors in DESCRIPTION.
258755b2 3984
994ef54b
MK
3985ctime.3
3986 mtk
3987 The range of tm_sec is 0..60 (not 0..61).
3988
258755b2
MK
3989error_at_line.3
3990error_message_count.3
3991error_on_per_line.3
3992error_print_progname.3
3993 mtk
3994 New links to new error.3.
3995
994ef54b
MK
3996fmemopen.3
3997 mtk / Ryan S. Arnold
258755b2
MK
3998 Add text noting that explicitly controlling output buffering
3999 may be useful to catch errors on output operations on an
994ef54b
MK
4000 fmemopen() stream.
4001
4002getline.3
4003 Justin Pryzby
4004 Add SEE ALSO pointing to getline.3.
8fa20889 4005 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=364772
994ef54b
MK
4006
4007strtod.3
4008strtoul.3
4009 mtk
258755b2 4010 Describe correct handling of errno in order to
994ef54b
MK
4011 distinguish error from success after the call.
4012
258755b2 4013 Added EXAMPLE section which points to strtol.3 which provides
994ef54b
MK
4014 an example of the use of the analogous strtol(3).
4015
4016strtol.3
4017 mtk / Justin Pryzby
4018 Add an example program.
4019 mtk
258755b2 4020 Describe correct handling or errno in order to
994ef54b
MK
4021 distinguish error from success after the call.
4022
4023tmpfile.3
40a54b37 4024 Reuben Thomas
994ef54b 4025 DESCRIPTION does not need to say "temporary file name"
258755b2 4026 just "temporary file", since the name is in any case
994ef54b 4027 unavailable to the user.
8fa20889 4028 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=363518
994ef54b
MK
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
4035ip.7
4036 Karel Kulhavy / mtk
4037 Various wording improvements and clarifications.
4038
4039signal.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
4048time.7
4049 mtk
4050 Added SEE ALSO for new adjtime.3.
4051
4052ld.so.8
4053 Justin Pryzby
4054 Remove bogus duplicate line.
6c0aabc5
MK
4055
4056
4057==================== Changes in man-pages-2.32 ====================
4058
4059Released: 2006-05-13
4060
4061Contributors
4062------------
4063
4064The following people contributed notes, ideas, or patches that have
4065been incorporated in changes in this release:
4066
4067Andries Brouwer <Andries.Brouwer@cwi.nl>
4068Johannes Weiner <root@hnaz.ath.cx>
4069Justin Pryzby <justinpryzby@users.sourceforge.net>
4070Karel Kulhavy <clock@twibright.com>
4071Paul Brook <paul@nowt.org>
4072Pavel Heimlich <tropikhajma@seznam.cz>
4073
4074Apologies if I missed anyone!
4075
4076
4077New pages
4078---------
4079
4080faccessat.2
4081 mtk
4082 New page for faccessat(2), new in 2.6.16.
4083
4084fchmodat.2
4085 mtk
4086 New page for fchmodat(2), new in 2.6.16.
4087
4088fchownat.2
4089 mtk
4090 New page for fchownat(2), new in 2.6.16.
4091
4092futimesat.2
4093 mtk
4094 New page for futimesat(2), new in 2.6.16.
4095
4096
4097Changes to individual pages
4098---------------------------
4099
4100access.2
4101 mtk
4102 Add SEE ALSO reference pointing to new faccessat.2 page.
4103
4104capget.2
4105 mtk
4106 Reworded to reflect that capabilities are per-thread.
258755b2 4107
6c0aabc5
MK
4108chmod.2
4109 mtk
4110 Add SEE ALSO reference pointing to new fchmodat.2 page.
4111
4112chown.2
4113 mtk
4114 Add SEE ALSO reference pointing to new fchownat.2 page.
4115
4116mmap.2
4117 mtk
258755b2 4118 Updated discussion of MAP_NORESERVE since it is no longer
6c0aabc5
MK
4119 restricted to MAP_PRIVATE mappings.
4120 Add reference to discussion of /proc/sys/vm/overcommit_memory
4121 in proc.5.
4122
4123openat.2
4124 mtk
4125 Add SEE ALSO reference pointing to new faccessat.2, fchmodat.2,
4126 fchownat.2, futimesat.2 pages.
4127
4128shmget.2
4129 mtk
4130 Document SHM_NORESERVE flag, new in 2.6.15.
4131
4132truncate.2
4133 Paul Brook / mtk
258755b2 4134 Expand text noting that ftruncate()/truncate() may fail if
6c0aabc5
MK
4135 asked to extend a file beyond its current length.
4136 Add EPERM error.
258755b2 4137
6c0aabc5
MK
4138utime.2
4139 mtk
4140 Add SEE ALSO reference pointing to new futimesat.2 page.
4141
4142fopen.3
4143 Justin Pryzby / mtk
4144 Document 'm' (mmap) flag.
8fa20889 4145 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=365754
6c0aabc5
MK
4146 mtk
4147 Document 'c' (notcancel) flag.
4148
4149futimes.3
4150 mtk
4151 Add SEE ALSO reference pointing to new futimesat.2 page.
4152
4153qsort.3
8fa20889
MK
4154 Johannes Weiner
4155 Add missing "const" qualifies to cast in EXAMPLE.
4156 mtk
4157 Slight rewording of comments in EXAMPLE.
6c0aabc5
MK
4158
4159termios.3
4160 Karel Kulhavy
4161 Clarify meaning of IXANY.
4162 Clarify relationship of MIN with VMIN and TIME with VTIME.
4163 mtk
258755b2 4164 Noted that CIBAUD, OFDEL, and DELECHO are not implemented
6c0aabc5 4165 on Linux.
258755b2 4166 Added explanatory paragraph for phrases "not in POSIX" and
6c0aabc5 4167 "XSI".
258755b2 4168
6c0aabc5
MK
4169capabilities.7
4170 mtk
4171 Reworded to reflect that capabilities are per-thread.
258755b2 4172 Add ioprio_set() to list of operations permitted by
6c0aabc5 4173 CAP_SYS_NICE.
258755b2
MK
4174 Add ioprio_set() IOPRIO_CLASS_RT and IOPRIO_CLASS_IDLE
4175 scheduling classes to list of operations permitted by
6c0aabc5
MK
4176 CAP_SYS_ADMIN.
4177 Note effects of CAP_SYS_NICE for migrate_pages().
885935bf
MK
4178
4179
4180==================== Changes in man-pages-2.33 ====================
4181
4182Released: 2006-05-23
4183
4184Contributors
4185------------
4186
4187The following people contributed notes, ideas, or patches that have
4188been incorporated in changes in this release:
4189
4190Andries Brouwer <Andries.Brouwer@cwi.nl>
4191Justin Pryzby <justinpryzby@users.sourceforge.net>
4192Martin Osvald" <martin.osvald@gmail.com>
4193Stefan Puiu <stefanpuiuro@yahoo.com>
4194
4195Apologies if I missed anyone!
4196
4197
4198Page renamings
4199--------------
4200
8fa20889 4201ftm.7
885935bf 4202 mtk / Stefan Puiu
8fa20889 4203 renamed to the more suggestive feature_test_macros.7
885935bf
MK
4204
4205
4206New pages
4207---------
4208
4209mq_getsetattr.2
8fa20889
MK
4210 mtk
4211 New page briefly describing mq_getsetattr(2), the system
4212 call that underlies mq_setattr(3) and mq_getattr(3).
885935bf 4213
885935bf
MK
4214rpmatch.3
4215 Justin Pryzby / mtk
4216 New page for rpmatch(3).
4217
885935bf
MK
4218
4219Changes to individual pages
4220---------------------------
4221
4222chmod.2
4223 mtk
4224 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4225 POSIX does now document ELOOP.
4226
4227open.2
4228 mtk
4229 Remove mention of non-standard S_IREAD, S_IWRITE, S_IEXEC.
4230
4231mmap.2
4232 Justin Pryzby
4233 Add mincore(2) to SEE ALSO.
8fa20889 4234 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367401
258755b2 4235
885935bf
MK
4236msync.2
4237 Justin Pryzby
258755b2 4238 Note that EINVAL can also be caused by
885935bf 4239 flags == MS_SYNC | MS_ASYNC.
258755b2 4240
885935bf
MK
4241sched_setaffinity.2
4242 mtk
4243 Add CPU_ISSET, CPU_CLR, CPU_SET, CPU_ZERO to NAME section.
4244
4245select.2
4246 mtk
4247 Various minor changes.
4248
4249select_tut.2
4250 mtk
4251 Removed much material that is redundant with select.2.
4252 Various other changes.
4253
4254umask.2
4255 mtk
4256 Substantial rewrite of description of 'mask'.
4257
258755b2
MK
4258CPU_ISSET.3
4259CPU_CLR.3
4260CPU_SET.3
4261CPU_ZERO.3
4262 mtk
4263 New links to sched_setaffinity.2
4264
4265FD_CLR.3
4266FD_ISSET.3
4267FD_SET.3
4268FD_ZERO.3
4269 mtk
4270 New links to select.2.
4271
885935bf
MK
4272fts.3
4273 Justin Pryzby
4274 Add SEE also referring to ftw.3.
4275
4276ftw.3
4277 Justin Pryzby
4278 Add SEE also referring to fts.3.
4279
4280getline.3
4281 Justin Pryzby
4282 Various minor clarifications.
4283
4284mkstemp.3
4285 mtk
4286 Clarify that O_EXCL is an open(2) flag.
4287
4288mq_open.3
4289 Martin Osvald
4290 Fix prototype declaration for 'attr'.
258755b2 4291
885935bf
MK
4292mq_notify.3
4293 Martin Osvald
4294 s/sigev_signal/sigev_signo/
258755b2
MK
4295
4296mq_setattr.3
4297 mtk
4298 New link to mq_getattr.3.
4299
4300mq_timedreceive.3
4301 mtk
4302 New link to mq_receive.3.
4303
4304mq_timedsend.3
4305 mtk
4306 New link to mq_send.3.
4307
885935bf
MK
4308setlocale.3
4309 Justin Pryzby
4310 Added SEE ALSO referring to rpmatch.3.
4311
258755b2
MK
4312sigandset.3
4313sigisemptyset.3
4314sigorset.3
4315 mtk
4316 New links to sigsetops.3.
4317
885935bf
MK
4318stdio.3
4319 Justin Pryzby
4320 Added SEE ALSO referring to unlocked_stdio.3
8fa20889 4321 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
885935bf
MK
4322
4323strchr.3
4324 Justin Pryzby
4325 Add description of strchrnul().
4326
258755b2
MK
4327strchrnul.3
4328 mtk
4329 New link to strchr.3.
4330
885935bf
MK
4331undocumented.3
4332 Justin Pryzby / mtk
258755b2 4333 Updated to remove some functions that don't exist, and
885935bf 4334 therefore don't need to be documented.
8fa20889 4335 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367671
258755b2 4336
885935bf
MK
4337unlocked_stdio.3
4338 Justin Pryzby
4339 Added SEE ALSO referring to stdio.3
8fa20889 4340 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=367667
885935bf
MK
4341
4342mq_overview.7
4343 mtk
258755b2 4344 Added section describing relationship between library
885935bf
MK
4345 interfaces and system calls.
4346 Added SEE ALSO referring to new mq_getsetattr.2.
4347
4348feature_test_macros.7
4349 Stefan Puiu
4350 Fix typo: s/_POSIX_C_SOURCE/_POSIX_SOURCE/
72d247ef
MK
4351
4352
4353==================== Changes in man-pages-2.34 ====================
4354
4355Released: 2006-06-20
4356
4357Contributors
4358------------
4359
4360The following people contributed notes, ideas, or patches that have
4361been incorporated in changes in this release:
4362
4363Aristeu Sergio Rozanski Filho <aris@cathedrallabs.org>
4364bert hubert <bert.hubert@netherlabs.nl>
4365Chris Curtis <chris.curtis@riptidesoftware.com>
4366Eduardo Madeira Fleury <efleury@br.ibm.com>
4367Joerg Scheurich <rusmufti@helpdesk.bera.rus.uni-stuttgart.de>
4368Justin Pryzby <justinpryzby@users.sf.net>
4369Kenichi Okuyama <okuyama.kenichi@oss.ntt.co.jp>
4370Marc Lehmann <debian-reportbug@plan9.de>
4371Martin (Joey) Schulze <joey@infodrom.org>
8912c1da 4372Mats Wichmann <mats.d.wichmann@intel.com>
72d247ef
MK
4373Mike Frysinger <vapier@gentoo.org>
4374Peter Eiserloh <eiserlohpp@yahoo.com>
4375Stefan Puiu <stefanpuiuro@yahoo.com>
4376Thomas Dickey <dickey@radix.net>
4377Walter Harms <wharms@bfs.de>
4378
4379Apologies if I missed anyone!
4380
4381
4382Global changes
4383--------------
4384
4385tzselect.8
4386zdump.8
4387zic.8
4388 mtk, Joey
258755b2 4389 Added header comment noting that these pages are in the public
72d247ef
MK
4390 domain.
4391
4392bindresvport.3
4393getrpcent.3
4394getrpcport.3
4395rpc.3
4396xdr.3
4397rpc.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
4403New pages
4404---------
4405
72d247ef
MK
4406ioprio_set.2
4407 Eduardo Madeira Fleury, with edits by mtk, and review by Jens Axboe
8fa20889 4408 New page for ioprio_get(2) and ioprio_set(2), new in 2.6.13.
72d247ef
MK
4409
4410offsetof.3
4411 Justin Pryzby / mtk
4412 New page describing offsetof() macro.
4413
4414
4415Changes to individual pages
4416---------------------------
4417
4418_exit.2
4419 mtk
4420 Add SEE ALSO referring to exit_group.2.
4421
4422acct.2
4423 mtk
4424 Add SEE ALSO referring to acct.5.
4425
4426fcntl.2
4427 mtk
4428 Explicitly mention term "dnotify" in discussion of F_NOTIFY.
4429
4430inotify_add_watch.2
4431 Aristeu Sergio Rozanski Filho / mtk
4432 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
8fa20889 4433 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
72d247ef
MK
4434 mtk
4435 Renamed argument from 'path' to 'pathname'.
258755b2 4436 Reword introductory paragraph to clarify that
72d247ef
MK
4437 inotify_add_watch() may also modify an existing watch item.
4438 mtk
258755b2 4439 The EINVAL error can also occur if 'fd' is not an inotify
72d247ef
MK
4440 file descriptor.
4441 mtk
4442 Moved BUGS section from this page to inotify.7.
4443
4444inotify_init.2
4445 Aristeu Sergio Rozanski Filho / mtk
4446 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
8fa20889 4447 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
72d247ef
MK
4448
4449inotify_rm_watch.2
4450 Aristeu Sergio Rozanski Filho / mtk
4451 s/<inotify.h>/<sys/inotify.h>/ in prototypes.
8fa20889 4452 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369960
72d247ef 4453 mtk
258755b2 4454 The EINVAL error can also occur if 'fd' is not an inotify
72d247ef
MK
4455 file descriptor.
4456
258755b2
MK
4457ioprio_get.2
4458 mtk
4459 New link to new ioprio_set.2.
4460
72d247ef
MK
4461mmap.2
4462 mtk
4463 Add SEE ALSO referring to remap_file_pages.2.
4464
4465mount.2
4466 Kenichi Okuyama
4467 s/MNT_FORCE/MNT_EXPIRE/ under EINVAL error.
4468
4469mremap.2
4470 Mike Frysinger
4471 s/unsigned long flags/int flags/ in SYNOPSIS.
258755b2 4472
72d247ef
MK
4473pipe.2
4474 mtk
4475 Add SEE ALSO referring to popen.3.
4476
4477posix_fadvise.2
4478 mtk
4479 Add SEE ALSO referring to readahead.2.
4480
4481read.2
4482 mtk
4483 SEE ALSO for readv should refer to Section 2, not 3.
4484
4485readahead.2
4486 mtk
4487 Add SEE ALSO referring to posix_fadvise.2.
4488
4489send.2
4490 Peter Eiserloh
258755b2 4491 Fix missing arguments in statement about equivalent send()
72d247ef
MK
4492 and sendto() calls.
4493
4494setsid.2
4495 mtk
4496 Add SEE ALSO referring to tcgetsid.3.
4497
4498shmctl.2
4499 mtk
4500 Minor wording change at start of DESCRIPTION.
258755b2 4501
72d247ef
MK
4502stat.2
4503 mtk
4504 Add SEE ALSO referring to access.2.
4505
4506statfs.2
4507 mtk
4508 Relocated "Note" about f_fsid.
4509
4510write.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
4519assert_perror.3
4520 Justin Pryzby
4521 Add #define _GNU_SOURCE to prototype
4522
4523difftime.3
4524 Joey
4525 Added note about time_t representation on other systems.
4526 Added CONFORMING TO.
4527
4528ftw.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
4535inet.3
4536 Marc Lehmann
4537 Fixed typo in NOTES.
8fa20889 4538 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=370277
258755b2 4539
72d247ef
MK
4540isalpha.3
4541 Joey
4542 Updated CONFORMING TO.
4543
4544mktemp.3
4545 mtk
4546 Updated CONFORMING TO.
4547
4548printf.3
4549 Walter Harms
4550 Add documentation of %m.
4551
4552readdir.3
4553 mtk
4554 Added SEE ALSO referring to ftw.3.
4555
4556re_comp.3
4557 mtk
755b5e17 4558 Note that these functions are obsolete in favor of regcomp(3).
258755b2 4559 Justin Pryzby
72d247ef
MK
4560 Add SEE ALSO referring to regcomp.3
4561
4562scandir.3
4563 Mats Wichmann
4564 Reworded CONFORMING TO statement on scandir() and alphasort().
4565
4566strchr.3
8fa20889
MK
4567 Stefan Puiu
4568 Fix prototype for strchrnul().
72d247ef
MK
4569
4570strtoul.3
8fa20889
MK
4571 Stefan Puiu
4572 Add text clarifying treatment of strings starting with
4573 minus sign.
72d247ef
MK
4574
4575tmpnam.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.
258755b2 4581
72d247ef
MK
4582tmpfile.3
4583 mtk
4584 Updated CONFORMING TO.
4585
4586tmpnam.3
4587 mtk, after comments by Justin Pryzby
4588 Add text noting the need to use open(O_EXCL).
4589 Updated CONFORMING TO.
4590
4591undocumented.3
4592 mtk
4593 Remove offsetof(), which is now documented.
4594
4595null.4
4596 mtk
4597 Added SEE ALSO referring to full.4.
4598
4599console_codes.4
4600 Thomas Dickey
4601 Various improvements and corrections.
4602
4603epoll.7
4604 mtk
4605 Added CONFORMING TO section mentioning FreeBSD kqueue and
4606 Solaris /dev/poll.
4607
4608feature_test_macros.7
4609 mtk
4610 Added pointer to location of LFS specification.
258755b2 4611
72d247ef
MK
4612futex.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
4619inotify.7
4620 mtk
8fa20889
MK
4621 'path' argument renamed to 'pathname'.
4622 A few minor rewordings.
4623 Added BUGS section describing a couple of bugs.
72d247ef
MK
4624
4625ip.7
4626 mtk
4627 Add SEE ALSO referring to byteorder.3.
4628
4629man.7
4630 Justin Pryzby
4631 Add SEE ALSO referring to groff_man(7).
8fa20889 4632 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=369253
258755b2 4633
512ef447 4634
22b4ce26
MK
4635==================== Changes in man-pages-2.35 ====================
4636
4637Released: 2006-07-06
4638
4639Contributors
4640------------
4641
4642The following people contributed notes, ideas, or patches that have
4643been incorporated in changes in this release:
4644
4645Alain Portal <aportal@univ-montp2.fr>
4646Andi Kleen <ak@suse.de>
4647Andrew Morton <akpm@osdl.org>
4648Bauke Jan Douma <bjdouma@xs4all.nl>
4649Davide Libenzi <davidel@xmailserver.org>
4650Denis Barbier <barbier@linuxfr.org>
4651Horacio Rodriguez Montero <Horacio.Rodriguez.Montero@galinter.com.ar>
4652Johan Lithander <johan.lithander@teligent.se>
4653Justin Pryzby <justinpryzby@users.sourceforge.net>
4654Mike Frysinger <vapier@gentoo.org>
4655Stefan Puiu <stefanpuiuro@yahoo.com>
4656Thorsten Kukuk <kukuk@suse.de>
4657
4658Apologies if I missed anyone!
4659
4660
4661Global changes
4662--------------
4663
4664Typographical or grammatical errors have been corrected in several
4665places.
4666
4667New pages
4668---------
4669
4670sync_file_range.2
8fa20889 4671 Andrew Morton / mtk
28b3a122 4672 New page for sync_file_range(2), new in kernel 2.6.17.
22b4ce26
MK
4673
4674Changes to individual pages
4675---------------------------
4676
4677adjtime.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
4682bind.2
4683 Stefan Puiu
4684 Add EADDRNOTAVAIL error.
4685 Stefan Puiu / mtk
4686 Make example code more complete.
4687
4688epoll_ctl.2
4689 mtk / Davide Libenzi
4690 Added EPOLLRDHUP description.
4691 mtk
4692 Added SEE ALSO referring to poll.2.
4693
4694poll.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
4701readlink.2
4702 mtk
258755b2 4703 Nowadays, readlink() returns 'ssize_t', as required in
22b4ce26 4704 POSIX.1-2001.
258755b2 4705
22b4ce26
MK
4706wavelan.4
4707 mtk
4708 Added license statement.
4709
4710nscd.conf.5
4711 Thorsten Kukuk
4712 Add documentation for various new fields.
4713
4714passwd.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
4720tcp.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
72d247ef 4726
8a70a8ea
MK
4727==================== Changes in man-pages-2.36 ====================
4728
4729Released: 2006-07-11
4730
4731Contributors
4732------------
4733
4734The following people contributed notes, ideas, or patches that have
4735been incorporated in changes in this release:
4736
4737Alain Portal <aportal@univ-montp2.fr>
4738Jens Axboe <jans@suse.de>
4739Justin Pryzby <justinpryzby@users.sourceforge.net>
4740Kyle McMartin <kyle@mcmartin.ca>
4741
4742Apologies if I missed anyone!
4743
4744Global changes
4745--------------
4746
4747Typographical or grammatical errors have been corrected in several
4748places.
4749
4750New pages
4751---------
4752
4753MAINTAINING
4754 mtk
4755 How to maintain man-pages.
4756
4757TODO
4758 mtk
4759 Things that it would be nice to get done for man-pages one day.
4760
4761scripts/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
4766Changes to individual pages
4767---------------------------
4768
4769fdatasync.2
4770fsync.2
4771 mtk
4772 Added SEE ALSO referring to sync_file_range.2.
4773
4774sendfile.2
4775 mtk / Jens Axboe
4776 Fix description of 'offset' argument to explain the case
4777 where 'offset' is NULL.
4778
4779ferror.3
4780 Justin Pryzby
4781 Add SEE ALSO referring to fdopen.3.
4782
4783intro.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
4790tcp.7
4791 Kyle McMartin
4792 Correction: tcp_window_scaling is ENabled by default.
0bc4d7f9
MK
4793
4794
4795==================== Changes in man-pages-2.37 ====================
4796
4797Released: 2006-08-02
4798
4799Contributors
4800------------
4801
4802The following people contributed notes, ideas, or patches that have
4803been incorporated in changes in this release:
4804
4805Alain Portal <aportal@univ-montp2.fr>
4806Dean Gaudet <dean@arctic.org>
4807Frank van Viegen <F.C.vanViegen@UTwente.nl>
4808Helmut Grohne <helmut@subdivi.de>
4809Ivana Varekova <varekova@redhat.com>
4810Thomas Huriaux <thomas.huriaux@gmail.com>
33972b0b 4811Ville Skyttä <ville.skytta@iki.fi>
0bc4d7f9
MK
4812
4813Apologies if I missed anyone!
4814
4815Global changes
4816--------------
4817
4818Thomas Huriaux / mtk
4819
bb98d979 4820 Various formatting problems found as a result of reviewing the
2b82fac6 4821 following command were fixed.
0bc4d7f9 4822
76c1fb55 4823 for a in $(wc -l man?/*.?| awk '$1 > 2 {print $2}' | grep -v total); do
c710d552 4824 echo $a; groff -Tascii -wmac -mman $a > /dev/null;
0bc4d7f9
MK
4825 done 2>&1 | less
4826
8fa20889 4827 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378544
c710d552 4828
0bc4d7f9
MK
4829Typographical or grammatical errors have been corrected in several
4830places.
4831
4832New pages
4833---------
4834
4835readlinkat.2
4836 mtk (after prompting from Ivana Varekova)
4837 New page for readlinkat(2), new in kernel 2.6.16.
c710d552 4838
0bc4d7f9
MK
4839Changes to individual pages
4840---------------------------
4841
4842ldd.1
33972b0b 4843 Ville Skyttä
0bc4d7f9
MK
4844 Document "-u" option.
4845
4846chdir.2
4847 mtk
4848 Noted effect of fork() and execve() on current working directory.
4849
4850chroot.2
4851 mtk
4852 Noted effect of fork() and execve() on root directory.
4853
4854epoll_ctl.2
4855 Frank van Viegen / mtk
4856 Fix description of EBADF error.
4857
4858exevce.2
4859 mtk
c710d552 4860 Add text noting that effective IDs are copied to
0bc4d7f9 4861 saved set-IDs during execve().
8fa20889 4862 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379297
0bc4d7f9
MK
4863
4864getitimer.2
4865 mtk
dd974cbc 4866 Noted effect of fork() and execve() on interval timers.
c710d552 4867
0bc4d7f9
MK
4868getrlimit.2
4869 mtk
4870 Noted effect of fork() and execve() on resource limits.
4871
4872getpriority.2
4873 mtk
4874 Noted effect of fork() and execve().
4875
4876inotify_add_watch.2
4877 mtk
c710d552 4878 Some rewording; included text describing required file
0bc4d7f9
MK
4879 permissions.
4880
4881intro.2
4882 mtk
4883 Revised description of standards under CONFORMING TO.
4884
4885makecontext.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
4892mmap.2
4893 mtk
4894 Expand description of MAP_POPULATE.
16708e16 4895 mtk, after prompting by Dean Gaudet
0bc4d7f9
MK
4896 Expand description MAP_NONBLOCK.
4897 mtk
4898 Various minor formatting fixes.
c710d552 4899
0bc4d7f9
MK
4900openat.2
4901 mtk
4902 Added SEE ALSO linking to readlinkat.2.
4903
4904nanosleep.2
4905 mtk
755b5e17 4906 Noted buggy behavior in Linux 2.4 and earlier when
0bc4d7f9 4907 nanosleep() is restarted after receiving stop+SIGCONT signals.
189d7bdf 4908
0bc4d7f9
MK
4909nice.2
4910 mtk
4911 Very minor rewording.
c710d552 4912
0bc4d7f9
MK
4913readlink.2
4914 mtk
4915 Added SEE ALSO linking to readlinkat.2.
4916
4917sched_setscheduler.2
28b3a122
MK
4918 mtk
4919 Noted preservation of scheduling parameters across execve().
c710d552 4920
0bc4d7f9 4921setpgid.2
28b3a122
MK
4922 mtk
4923 Noted effect of fork() and execve() on process group ID.
c710d552 4924
0bc4d7f9 4925setsid.2
28b3a122
MK
4926 mtk
4927 Noted effect of fork() and execve() on session ID.
c710d552 4928
0bc4d7f9
MK
4929umask.2
4930 mtk
4931 Noted effect of fork() and execve() on umask.
4932
4933atexit.3
4934 mtk
4935 Noted inheritance of registrations across fork().
4936
4937capabilities.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.
189d7bdf
MK
4943
4944
4945==================== Changes in man-pages-2.38 ====================
4946
4947Released: 2006-08-03
4948
4949Contributors
4950------------
4951
4952The following people contributed notes, ideas, or patches that have
4953been incorporated in changes in this release:
4954
4955Alain Portal <aportal@univ-montp2.fr>
4956
4957Apologies if I missed anyone!
4958
4959Global changes
4960--------------
4961
8fa20889
MK
4962Most 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).
ff75a911 4979
8fa20889
MK
4980 * Tried to ensure that those interfaces specified in C99 or
4981 POSIX.1-2001 are marked as such in their manual pages.
ff75a911 4982
189d7bdf
MK
4983intro.1
4984intro.2
4985intro.3
4986intro.4
4987intro.5
4988intro.7
4989feature_test_macros.7
4990 mtk
4991 Added SEE ALSO referring to new standards.7.
4992
8fa20889 4993Various pages
189d7bdf 4994 mtk
8fa20889 4995 Changed instances of "HP UX" to "HP-UX".
189d7bdf 4996
8fa20889 4997Various pages
189d7bdf 4998 mtk
8fa20889 4999 Changed instances of "DG-UX to "DG/UX"
189d7bdf
MK
5000
5001Typographical or grammatical errors have been corrected in several
5002places.
5003
5004New pages
5005---------
5006
5007standards.7
5008 mtk
5009 Based on material taken from intro.2, but expanded to
512ef447
MK
5010 include discussion of many additional standards.
5011
189d7bdf
MK
5012Changes to individual pages
5013---------------------------
5014
5015bind.2
5016 mtk
28b3a122 5017 Minor wording change for ENOTSOCK error.
189d7bdf
MK
5018
5019intro.2
28b3a122
MK
5020 mtk
5021 Removed information on standards to new standards.7.
129660de
MK
5022
5023
5024==================== Changes in man-pages-2.39 ====================
5025
5026Released: 2006-08-05
5027
5028Contributors
5029------------
5030
5031The following people contributed notes, ideas, or patches that have
5032been incorporated in changes in this release:
5033
5034Alain Portal <aportal@univ-montp2.fr>
5035
5036Apologies if I missed anyone!
5037
5038Global changes
5039--------------
5040
8fa20889 5041Various pages
129660de 5042 mtk
8fa20889
MK
5043 Updated CONFORMING TO and/or standards references
5044 in various pages that were missed for 2.38.
129660de
MK
5045
5046Typographical or grammatical errors have been corrected in several
5047places.
5048
5049Changes to individual pages
5050---------------------------
5051
5052
5053chdir.2
5054 mtk
5055 _XOPEN_SOURCE=500 also gets fchdir() prototype.
5056
5057standards.7
5058 mtk
5059 Added a few more standards, and expand some explanations.
a0bb5f7b
MK
5060
5061
5062==================== Changes in man-pages-2.40 ====================
5063
5064Released: 2006-09-04
5065
5066Contributors
5067------------
5068
5069The following people contributed notes, ideas, or patches that have
5070been incorporated in changes in this release:
5071
5072Alain Portal <aportal@univ-montp2.fr>
5073Andi Kleen <ak@suse.de>
5074Andries Brouwer <Andries.Brouwer@cwi.nl>
5075Christoph Hellwig <hch@lst.de>
5076Chuck Ebbert <76306.1226@compuserve.com>
5077Samuel Thibault <samuel.thibault@ens-lyon.org>
33972b0b 5078Toralf Förster <toralf.foerster@gmx.de>
a0bb5f7b
MK
5079
5080Apologies if I missed anyone!
5081
5082Global changes
5083--------------
5084
5085faccessat.2
5086fchmodat.2
5087fchownat.2
5088fstatat.2
5089futimesat.2
5090linkat.2
5091mkdirat.2
5092mknodat.2
5093openat.2
5094readlinkat.2
5095renameat.2
5096symlinkat.2
5097 mtk (after a note by Alain Portal)
5098 Make naming of 'pathname' argument consistent; various
5099 minor rewordings.
5100
5101Typographical or grammatical errors have been corrected in several
5102places.
5103
5104Changes to individual pages
5105---------------------------
5106
5107clone.2
5108 mtk
5109 Reinstate text on CLONE_DETACHED, and add a few words.
5110
5111execve.2
5112 mtk
5113 Added list of process attributes that are not preserved on exec().
5114
5115fork.2
5116 mtk, after a suggestion by Christoph Hellwig
c710d552 5117 Greatly expanded, to describe all attributes that differ
a0bb5f7b
MK
5118 in parent and child.
5119
5120linkat.2
5121 mtk
5122 Document AT_SYMLINK_FOLLOW (new in 2.6.18).
5123
5124set_mempolicy.2
5125 mtk / Andi Kleen
5126 Memory policy is preserved across execve().
c710d552 5127
a0bb5f7b
MK
5128write.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
5133getcwd.3
5134 Samuel Thibault / mtk
c710d552 5135 Fix SYNOPSIS and CONFORMING TO text for getwd() and
a0bb5f7b 5136 get_current_dir().
8fa20889 5137 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=381692
a0bb5f7b
MK
5138
5139proc.5
5140 Chuck Ebbert
5141 Document /proc/PID/auxv.
5142
5143capabilities.7
5144 Alain Portal
5145 Restore text accidentally deleted in 2.39.
c710d552 5146
a0bb5f7b
MK
5147regex.7
5148 mtk / Alain Portal
5149 Change references to "1003.2" to "POSIX.2".
cae2998b
MK
5150
5151
5152==================== Changes in man-pages-2.41 ====================
5153
5154Released: 2006-10-12
5155
5156Contributors
5157------------
5158
5159The following people contributed notes, ideas, or patches that have
5160been incorporated in changes in this release:
5161
5162Andi Kleen <ak@suse.de>
5163Andries Brouwer <Andries.Brouwer@cwi.nl>
5164Andrew Morton <akpm@osdl.org>
5165Britton Leo Kerin <bkerin_rb@letterboxes.org>
5166Dan Jacobson <jidanni@jidanni.org>
5167Guillem Jover <guillem@hadrons.org>
5168Hrvoje Niksic <hniksic@xemacs.org>
5169Jens Axboe <axboe@suse.de>
5170Justin Pryzby <justinpryzby@users.sourceforge.net>
5171Kevin Ryde <user42@zip.com.au>
5172Marcel Holtmann <marcel@holtmann.org>
5173Senthil Kumar <senthilkumar_sen@hotpop.com>
5174Stefan Puiu <stefanpuiuro@yahoo.com>
5175Stuart MacDonald <stuartm@connecttech.com>
5176Trond Myklebust <trond.myklebust@fys.uio.no>
5177
5178Apologies if I missed anyone!
5179
5180
5181Global changes
5182--------------
5183
5184Typographical or grammatical errors have been corrected in several
5185places.
5186
5187
5188New pages
5189---------
5190
5191splice.2
5192tee.2
5193vmsplice.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
5202Changes to individual pages
5203---------------------------
5204
5205ldd.1
5206 Stefan Puiu
5207 Note glibc version where "ldd -u" appeared.
5208
5209execve.2
5210 mtk
5211 The PR_SET_NAME setting is not preserved across an execve().
5212
5213fork.2
5214 mtk
c710d552 5215 Mappings marked with madvise(MADV_DONTFORK) are not inherited
cae2998b
MK
5216 by child.
5217
5218getdtablesize.2
5219 mtk
c710d552 5220 Noted that sysconf(_SC_OPEN_MAX) is preferred in portable
cae2998b 5221 applications.
c710d552 5222
cae2998b
MK
5223getpagesize.2
5224 mtk
c710d552 5225 Noted that sysconf(_SC_PAGE_SIZE) is preferred in portable
cae2998b
MK
5226 applications.
5227 _SC_PAGE_SIZE is available on most systems.
c710d552 5228
cae2998b
MK
5229madvise.2
5230 mtk
5231 Document MADV_REMOVE, new in 2.6.16.
5232 Document MADV_DONTFORK / MADV_DOFORK, new in 2.6.16.
5233
5234mount.2
5235 mtk / Trond Myklebust
5236 MNT_FORCE can cause data loss.
c710d552 5237
cae2998b
MK
5238mmap.2
5239 mtk
c710d552 5240 Added note on Linux's old (pre-2.6.12) buggy treatment of
cae2998b
MK
5241 length==0.
5242 Justin Pryzby / mtk
5243 Added some EINVAL errors.
5244
5245mremap.2
5246 mtk
5247 Remove superfluous "#include <unistd.h>" from SYNOPSIS.
5248
5249msync.2
5250 mtk
c710d552 5251 Added EBUSY error for case where MS_INVALIDATE is applied to
cae2998b
MK
5252 a locked region.
5253
5254posix_fadvise.2
5255 Andrew Morton
5256 Since 2.6.18, POSIX_FADV_NOREUSE is a no-op.
5257
5258prctl.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.
c710d552 5269
cae2998b
MK
5270remap_file_pages.2
5271 mtk
5272 Add "#define _GNU_SOURCE" to SYNOPSIS.
5273
5274sync_file_range.2
5275 mtk
5276 Noted that sync_file_range() appeared in kernel 2.6.17.
5277
5278vfork.2
5279 mtk
5280 Noted interactions with fork handlers in multithreaded programs.
c710d552 5281
cae2998b
MK
5282wait4.2
5283 mtk
5284 Added feature test macros to SYNOPSIS.
c710d552 5285
cae2998b
MK
5286clog2.3
5287 mtk / aeb / Kevin Ryde
5288 Fix broken text in description.
8fa20889 5289 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
cae2998b
MK
5290
5291clog10.3
5292 Kevin Ryde
5293 Fix broken text in description.
8fa20889 5294 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386214
cae2998b
MK
5295
5296mq_receive.3
5297 Britton Leo Kerin
5298 Fix return type in SYNOPSIS; should be "ssize_t" not "mqd_t".
8fa20889 5299 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=387551
cae2998b
MK
5300
5301qsort.2
5302 Hrvoje Niksic
c710d552 5303 Fix wording referring to the use of strcmp() in 'compar'
cae2998b 5304 function.
8fa20889 5305 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=391402
c710d552 5306
cae2998b
MK
5307sendfile.2
5308 mtk
5309 Added SEE ALSO referring to new splice.2 page.
5310
5311termios.3
5312 mtk
5313 Documented IUTF8 (which was new in kernel 2.6.4).
c710d552 5314
cae2998b
MK
5315tzset.3
5316 mtk
5317 Added some TZ examples.
8fa20889 5318 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=386087
cae2998b
MK
5319
5320proc.5
5321 mtk
5322 Added delayacct_blkio_ticks (new in 2.6.18) to /proc/PID/statm.
5323
5324ip.7
5325 Stuart MacDonald / Andi Kleen
5326 Fix discussion for TCP error queue /IP_RECVERR on TCP.
5327
5328pthreads.7
5329 mtk
5330 Noted effect of RLIMIT_STACK resource limit for NPTL.
5331
5332socket.7
5333 Senthil Kumar
5334 Place socket options in alphabetical order.
5335
512ef447 5336
5b68515a
MK
5337==================== Changes in man-pages-2.42 ====================
5338
5339Released: 2006-11-24
5340
5341Contributors
5342------------
5343
5344The following people contributed notes, ideas, or patches that have
5345been incorporated in changes in this release:
5346
5347Andrew Morton <akpm@osdl.org>
5348Chuck Ebbert <76306.1226@compuserve.com>
5349Doug Goldstein <cardoe@gentoo.org>
5350Eduard Bloch <blade@debian.org>
5351Evan Teran <eteran@alum.rit.edu>
5352Pavel Heimlich <tropikhajma@seznam.cz>
5353Petr Baudis <pasky@ucw.cz>
5354Randy Dunlap <rdunlap@xenotime.net>
5355Ulrich Drepper <drepper@redhat.com>
5356
5357Apologies if I missed anyone!
5358
5359
5360Global changes
5361--------------
5362
5363Typographical or grammatical errors have been corrected in several
5364places.
5365
5366
5367Changes to individual pages
5368---------------------------
5369
5370brk.2
5371 Evan Teran / mtk
755b5e17 5372 Add text describing behavior of the Linux brk() system call
c710d552 5373 and point out that the glibc brk() wrapper provides different
755b5e17 5374 behavior.
5b68515a 5375 mtk
c710d552 5376 Note that sbrk() is implemented as a library function in glibc
5b68515a
MK
5377 that calls the brk() system call.
5378
5379futex.2
5380 mtk
5381 FUTEX_FD is scheduled for removal in June 2007.
5382
5383getaddrinfo.3
5384getnameinfo.3
5385 Ulrich Drepper, with edits by mtk
5386 Add text describing Internationalized Domain Name
5387 extensions.
c710d552 5388
5b68515a
MK
5389open.2
5390 mtk / Eduard Bloch
c710d552 5391 Fix description of O_LARGEFILE to mention required feature test
5b68515a
MK
5392 macros.
5393
5394ptrace.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
5399syslog.3
5400 Doug Goldstein
5401 Fix header file required for vsyslog() in SYNOPSIS.
5402
5403wcwidth.3
5404 Petr Baudis
5405 Fix CONFORMING TO.
5406
5407core.5
5408 mtk
5409 Linux 2.4.21 added core_pattern (which was already in 2.6).
c710d552 5410 Noted a few more reasons why a core dump file might not
5b68515a
MK
5411 be produced.
5412
5413
198ee53c
MK
5414==================== Changes in man-pages-2.43 ====================
5415
5416Released: 2006-11-29
5417
5418Contributors
5419------------
5420
5421The following people contributed notes, ideas, or patches that have
5422been incorporated in changes in this release:
5423
5424Andi Kleen <ak@suse.de>
5425David Brownell <david-b@pacbell.net>
5426Eduard Bloch <blade@debian.org>
5427Egmont Koblinger <egmont@uhulinux.hu>
5428Reuben Thomas <rrt@sc3d.org>
5429
5430Apologies if I missed anyone!
5431
5432
5433Global changes
5434--------------
5435
5436Typographical or grammatical errors have been corrected in several
5437places.
5438
5439
5440Changes to individual pages
5441---------------------------
5442
5443ioperm.2
5444 mtk
5445 Clarify discussion of privilege requirements.
5446 Added ENOMEM to ERRORS.
5447
5448open.2
5449 mtk / Eduard Bloch
5450 Clarify description of O_LARGEFILE.
5451
5452crypt.3
5453 Egmont Koblinger
dd974cbc 5454 Make description of MD5 output string less ambiguous.
198ee53c
MK
5455
5456strerror.3
5457 Reuben Thomas
8fa20889 5458 Add C99 to CONFORMING TO; see
752cb57f 5459 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400634
198ee53c
MK
5460
5461rtc.4
5462 David Brownell
c710d552 5463
198ee53c
MK
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
5483proc.5
5484 mtk
5485 s/fseek(3)/lseek(2)/ under /proc/PID/mem entry.
5486
5487feature_test_macros.7
5488 mtk / Eduard Bloch
8fa20889 5489 The LFS spec is now at http://opengroup.org/platform/lfs.html
198ee53c
MK
5490
5491raw.7
5492udp.7
5493 Andi Kleen
5494 Describe the correct default for UDP/RAW path MTU discovery.
5495
4174ff56 5496
46857e10
MK
5497==================== Changes in man-pages-2.44 ====================
5498
5499Released: 2007-04-04
5500
5501Contributors
5502------------
5503
5504The following people contributed notes, ideas, or patches that have
5505been incorporated in changes in this release:
5506
5507Andre Majorel <aym-naideb@teaser.fr>
5508Benjamin Gilbert <bgilbert@cs.cmu.edu>
5509Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
5510Chuck Ebbert <76306.1226@compuserve.com>
5511Ivana Varekova <varekova@redhat.com>
5512Jakub Jelinek <jakub@redhat.com>
5513John Ward <jward@idealcorp.com>
5514Jorge Peixoto de Morais Neto <jorgepeixotomorais@gmail.com>
5515Julien Blache <jblache@debian.org>
5516Julien Cristau <jcristau@debian.org>
5517Justin Pryzby <justinpryzby@users.sourceforge.net>
33972b0b 5518Martín Ferrari <martin.ferrari@gmail.com>
46857e10
MK
5519Mike Frysinger <vapier@gentoo.org>
5520Nick Piggin <npiggin@suse.de>
5521Nick Pollitt <npollitt@mvista.com>
33972b0b
MK
5522Nicolas François <nicolas.francois@centraliens.net>
5523Pádraig Brady <P@draigBrady.com>
46857e10
MK
5524Premysl Hruby <dfenze@gmail.com>
5525Reuben Thomas <rrt@sc3d.org>
5526Samuel Thibault <samuel.thibault@ens-lyon.org>
5527Serge E. Hallyn <serge@hallyn.com>
5528Thomas Huriaux <thomas.huriaux@gmail.com>
5529Timo Sirainen <tss@iki.fi>
c13182ef 5530Val Henson <val_henson@linux.intel.com>
46857e10
MK
5531
5532Apologies if I missed anyone!
5533
5534
5535New pages
5536---------
5537
5538termio.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
5544scripts/find_repeated_words.sh
5545 mtk
5546 Find consecutive duplicate words in a man page, some of
1bb8fbd8 5547 which may be grammar errors.
46857e10
MK
5548
5549Global changes
5550--------------
5551
8fa20889 5552Various pages
2b82fac6 5553 Justin Pryzby / mtk
46857e10
MK
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
8fa20889
MK
5570Various 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
5575Various 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
5581Various pages
5582 mtk
5583 s/Unices/Unix systems/ on the 5 pages where it appears.
5584
5585Various 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
5630Various 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
5635Various 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
5643Various pages
5644 Justin Pryzby / mtk
5645 Fixed consecutive duplicate word typos on a number of pages.
46857e10
MK
5646
5647Typographical or grammatical errors have been corrected in several
33972b0b 5648places. (Special thanks to Nicolas François!)
46857e10
MK
5649
5650
5651Changes to individual pages
5652---------------------------
5653
5654access.2
5655 mtk
755b5e17 5656 Since 2.6.20, access() honors the MS_NOEXEC mount flag.
46857e10
MK
5657 Jorge Peixoto de Morais Neto / mtk
5658 Improve ENOENT description.
5659
5660clone.2
5661 mtk
5662 Added some detail to the prototype.
5663 Added some notes on IA-64's clone2().
5664
5665epoll_ctl.2
5666 mtk
5667 Add text to note that EPOLLRDHUP appeared in kernel 2.6.17.
5668
5669faccessat.2
5670 Justin Pryzby
8fa20889 5671 Various fixes as per
752cb57f 5672 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411177
4174ff56 5673 * s/effective/real/ in description text.
46857e10
MK
5674 * added <fcntl.h> to synopsis.
5675 * various other changes.
5676
5677getrlimit.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
5682io_cancel.2
5683io_destroy.2
5684io_getevents.2
5685io_setup.2
5686io_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
5691mbind.2
5692 Samuel Thibault / mtk
5693 Fix EINVAL description.
8fa20889 5694 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411777
c710d552 5695
46857e10
MK
5696mincore.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
5705mmap.2
5706 mtk
755b5e17 5707 Rewrote and reorganized various parts to be clearer.
46857e10 5708 Taken from Fedora downstream patches; thanks to Ivana Varekova
c710d552 5709 Removed text stating that mmap() never returns 0; that's
46857e10
MK
5710 not true.
5711
5712mount.2
5713 mtk / Val Henson
5714 Document MS_RELATIME, new in Linux 2.6.20.
c710d552 5715
46857e10
MK
5716open.2
5717 Andre Majorel / mtk
c710d552 5718 On Linux, the error returned when opening a large file on a
46857e10
MK
5719 32-bit system is actually EFBIG, not EOVERFLOW.
5720
5721posix_fadvise.2
33972b0b 5722 Pádraig Brady
46857e10
MK
5723 Fix RETURN VALUE description: returns error number of failure.
5724
5725rename.2
5726 mtk / Timo Sirainen
5727 Various improvements to DESCRIPTION.
8fa20889 5728 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416012
46857e10
MK
5729
5730semop.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,
755b5e17 5734 and some Linux applications depend on this behavior. SUSv3
c710d552 5735 made no explicit statement here, but SUSv4 will explicitly
755b5e17 5736 require this behavior.
46857e10
MK
5737 Small rewording of explanation of "atomically".
5738
5739signal.2
33972b0b 5740 Nicolas François
46857e10
MK
5741 Fix incorrect argument name in DESCRIPTION.
5742 mtk
5743 Small wording improvement.
c710d552 5744
46857e10 5745socket.2
33972b0b 5746 Nicolas François
46857e10 5747 Add reference to ipv6.7 page.
c710d552 5748
46857e10 5749socketcall.2
33972b0b 5750 Nicolas François
46857e10
MK
5751 Fix .TH line.
5752
5753splice.2
5754 Benjamin Gilbert
5755 Fix inconsistent argument names in SYNOPSIS and DESCRIPTION.
5756
5757statvfs.2
5758 mtk
5759 Small wording clarification.
5760
5761symlink.2
33972b0b 5762 mtk / Nicolas François
c710d552
MK
5763 Removed cryptic text under CONFORMING to referring to
5764 "open(2) and NFS". There is no relevant text in open.2 as
46857e10
MK
5765 far as I (mtk) can see.
5766
5767time.2
5768 mtk / Reuben Thomas
5769 Remove sentence "gettimeofday() obsoleting time() on 4.3BSD".
5770 This information is old, and probably no longer relevant.
8fa20889 5771 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=403888
46857e10
MK
5772
5773write.2
5774 mtk, after an idea from a downstream Fedora patch.
5775 Clarified discussion of /count == 0/ case.
5776
5777ptrace.2
5778 Chuck Ebbert
c710d552
MK
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
46857e10 5784 of these messages.
c710d552 5785
46857e10
MK
5786sched_setaffinity.2
5787 mtk
4174ff56 5788 Fix glibc version number in description of 'cpusetsize' argument.
c710d552 5789
46857e10
MK
5790vfork.2
5791 mtk
5792 Stripped some excess/outdated text from the BUGS section.
c710d552 5793
46857e10
MK
5794basename.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
5799dlopen.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
5804fclose.3
5805 mtk
5806 Complete rewrite. The existing page was hard to read,
5807 and the RETURN VALUE description seems to be wrong.
5808
5809getopt.3
5810 mtk
5811 Added getopt() example program.
5812 mtk
c710d552
MK
5813 Add a few words to clarify the operation of the GNU-specific
5814 double-colon feature, which allows options to have optional
4174ff56 5815 arguments.
8fa20889 5816 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=352139
46857e10
MK
5817
5818glob.3
33972b0b 5819 Nicolas François
46857e10
MK
5820 Fix PROTOTYPE.
5821
5822inet_network.3
5823 mtk, after an idea from a downstream Fedora patch.
5824 Clarified description of inet_network().
5825
5826log.3
33972b0b 5827 Nicolas François
46857e10
MK
5828 Fix .TH line.
5829
5830log10.3
33972b0b 5831 Nicolas François
46857e10
MK
5832 Fix .TH line.
5833
5834malloc.3
33972b0b 5835 Nicolas François
46857e10 5836 Small rewording to mention calloc().
c710d552 5837
46857e10 5838posix_openpt.3
33972b0b 5839 Martín Ferrari
8fa20889 5840 Fix return type in SYNOPSIS; as per
752cb57f 5841 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400971
8fa20889 5842 Needs _XOPEN_SOURCE == 600; as per
752cb57f 5843 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=400975
46857e10
MK
5844 Julien BLACHE
5845 s/ptsname/posix_openpt/ in RETURN VALUE
c710d552 5846
46857e10
MK
5847re_comp.3
5848 Taken from Fedora downstream patches; thanks to Ivana Varekova
5849 Add "#define _REGEX_RE_COMP" to SYNOPSIS.
c710d552 5850
46857e10 5851regex.3
33972b0b 5852 Nicolas François
46857e10
MK
5853 Fix .TH line.
5854
5855termios.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
5872ualarm.3
5873 mtk
5874 Removed BSD prototype from synopsis.
5875 Various rewordings.
5876
5877usleep.3
5878 mtk
5879 Removed BSD prototype from synopsis.
5880 Various rewordings.
5881
5882termcap.5
5883 Taken from Fedora downstream patches; thanks to Ivana Varekova
5884 s/curses/ncurses/ under SEE ALSO
5885
5886bootparam.7
5887 Taken from Fedora downstream patches; thanks to Ivana Varekova
5888 Documented "mem=nopentium".
5889
5890feature_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
4174ff56 5894 Added some text warning that the "__" macros that
46857e10
MK
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
5903mdoc.7
33972b0b 5904 mtk / Nicolas François
46857e10
MK
5905 Remove CONFIGURATION section, since this does not seem to be
5906 true for Linux.
c710d552 5907
46857e10 5908svipc.7
33972b0b 5909 Nicolas François
c710d552 5910 Fix data types in associated data structures;
58ce1507 5911 remove nonexistent semzcnt and semncnt fields.
46857e10
MK
5912
5913time.7
5914 mtk
5915 Since kernel 2.6.20, the software clock can also be 300 HZ.
c50c88ec
MK
5916
5917
8022b4f5
MK
5918==================== Changes in man-pages-2.45 ====================
5919
5920Released: 2007-04-05
5921
5922Global changes
5923--------------
5924
c710d552 5925This release consists mainly of formatting fixes (to a large
8022b4f5 5926number of pages) to achieve greater consistency across pages.
c710d552 5927With the exception of the few individual changes noted below,
8022b4f5
MK
5928no changes were made to content.
5929
5930Changes to individual pages
5931---------------------------
5932
5933io_destroy.2
5934io_getevents.2
5935io_setup.2
5936io_cancel.2
5937io_submit.2
5938 mtk
5939 Clarified RETURN VALUE text
5940
5941bindresvport.3
5942 mtk
5943 Rewrote prototype using modern C syntax.
9ee19dd5
MK
5944
5945
5946==================== Changes in man-pages-2.46 ====================
5947
5948Released: 2007-04-06
5949
5950Global changes
5951--------------
5952
c710d552 5953This release consists mainly of formatting fixes (to a large
9ee19dd5
MK
5954number of pages) to achieve greater consistency across pages:
5955
c710d552 5956* Most instances of two or more consecutive blank lines in man
9ee19dd5
MK
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.
c710d552 5960* In various places (mainly code examples), the use of tabs was
9ee19dd5
MK
5961 replaced by spaces
5962
c710d552 5963With the exception of the few individual changes noted below,
9ee19dd5
MK
5964no changes were made to content.
5965
5966
5967Changes to individual pages
5968---------------------------
5969
5970bdflush.2
5971 mtk
5972 Add <sys/kdaemon.h> header file to SYNOPSIS.
5973
5974sched_rr_get_interval.2
5975 mtk
5976 Moved timespec definition from SYNOPSIS into description.
5977
5978select_tut.2
5979 mtk
5980 Make SYNOPSIS match select.2.
feda4321
MK
5981
5982
5983==================== Changes in man-pages-2.47 ====================
5984
5985Released: 2007-05-04
5986
5987Contributors
5988------------
5989
5990The following people contributed notes, ideas, or patches that have
5991been incorporated in changes in this release:
5992
5993Andi Kleen <andi@firstfloor.org>
5994John Heffner <jheffner@psc.edu>
5995
5996Apologies if I missed anyone!
5997
5998
5999Global changes
6000--------------
6001
6002This release consists mainly of changes to source file layout
6003(wrapped long lines; stripped trailing white space; started new
6004sentences on new lines).
6005
6006There is very little change to output formatting or content (see the
6007notes below).
6008
6009
6010Changes to individual pages
6011---------------------------
6012
6013sched_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
c710d552 6017 the round-robin quantum.
2b82fac6 6018 Corrected .TH line.
feda4321
MK
6019
6020ip.7
6021 John Heffner / mtk
6022 Document IP_PMTUDISC_PROBE, which will be in 2.6.22.
5840c68b
MK
6023
6024
6025==================== Changes in man-pages-2.48 ====================
6026
6027Released: 2007-05-04
6028
6029Contributors
6030------------
6031
6032The following people contributed notes, ideas, or patches that have
6033been incorporated in changes in this release:
6034
6035Colin Watson <cjwatson@debian.org>
6036Justin Pryzby <justinpryzby@users.sourceforge.net>
6037
6038Apologies if I missed anyone!
6039
6040
6041Global changes
6042--------------
6043
6044This release consists mainly of changes to source file layout
6045(wrapped long lines; stripped trailing white space; started new
6046sentences on new lines).
6047
6048There is very little change to output formatting or content (see the
6049notes below).
6050
8fa20889
MK
6051Various pages
6052 mtk
6053 In various places where it occurred,
6054 s/nonnegative/non-negative/
5840c68b 6055
8fa20889
MK
6056Various pages
6057 mtk
6058 s/wide character/wide-character/ when used attributively.
5840c68b
MK
6059
6060
6061Changes to individual pages
6062---------------------------
6063
6064man.7
6065 Justin Pryzby / Colin Watson / mtk
6066 .SH doesn't require quotes.
8fa20889 6067 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=411303
1421a192
MK
6068
6069
6070==================== Changes in man-pages-2.49 ====================
6071
6072Released: 2007-05-20
6073
6074Contributors
6075------------
6076
6077The following people contributed notes, ideas, or patches that have
6078been incorporated in changes in this release:
6079
6080Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
6081Bruno Haible <bruno@clisp.org>
6082Justin Pryzby <justinpryzby@users.sourceforge.net>
6083
6084Apologies if I missed anyone!
6085
6086
6087New pages
6088---------
6089
6090bsd_signal.3
6091 mtk
6092 Documentation of bsd_signal().
6093
6094euidaccess.3
6095 mtk
6096 Manual page for euidaccess() and eaccess().
6097
6098getsubopt.3
6099 mtk / Justin Pryzby
28b3a122 6100 Documentation of getsubopt().
1421a192
MK
6101
6102sysv_signal.3
6103 mtk
6104 Documentation of sysv_signal().
6105
6106
6107New links
6108---------
6109
6110epoll_pwait.2
6111 mtk
6112 New link to epoll_wait.2.
6113
6114eaccess.3
6115 mtk
6116 New link to new euidaccess.3,
6117
6118sem_timedwait.3
6119 mtk
6120 New link to sem_wait.3.
6121
6122sem_trywait.3
6123 mtk
6124 New link to sem_wait.3.
6125
6126
6127Global changes
6128--------------
6129
6130Typographical or grammatical errors have been corrected in several
6131places.
6132
6133
6134Changes to individual pages
6135---------------------------
6136
6137access.3
6138 mtk
6139 Added SEE ALSO ref to new euidaccess.3 page.
6140
16708e16 6141epoll_wait.2
1421a192
MK
6142 mtk
6143 Added description of epoll_pwait(), new in kernel 2.6.19.
6144
6145execve.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
6172faccessat.3
6173 mtk
6174 Added SEE ALSO ref to new euidaccess.3 page.
6175
6176mmap.2
6177 mtk
6178 Place MAP_* flags list in alphabetical order.
6179
6180readv.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
6187sigaction.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
6193signal.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
6201copysign.3
6202 Bruno Haible
6203 Clarify discussion of negative zero.
6204
1bb8fbd8
MK
6205getopt.3
6206 mtk
6207 Add SEE ALSO ref to new getsubopt.3.
6208
1421a192
MK
6209iconv_open.3
6210 Bruno Haible
6211 Describe the glibc/libiconv //TRANSLIT and //IGNORE extensions
6212 for 'tocode'.
6213
6214iswblank.3
6215 Bruno Haible
6216 Update CONFORMING TO; iswblank() is in POSIX.1-2001.
6217
1421a192
MK
6218inotify.7
6219 mtk
b14aa4ee 6220 Definitions for IN_DONT_FOLLOW, IN_MASK_ADD, and IN_ONLYDIR
1421a192
MK
6221 were added to glibc in version 2.5.
6222
6223signal.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.
49ab5444
MK
6229
6230
6231==================== Changes in man-pages-2.50 ====================
6232
6233Released: 2007-05-21
6234
6235Contributors
6236------------
6237
6238The following people contributed notes, ideas, or patches that have
6239been incorporated in changes in this release:
6240
6241Andreas Halter <halter@google.com>
6242Laird Shaw <netocrat@dodo.com.au>
6243Mike Frysinger <vapier@gentoo.org>
6244
6245Apologies if I missed anyone!
6246
6247Removed pages (!)
6248-----------------
6249
6250Most 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
2b82fac6 6255 distributions. Instead most distributions supply the
49ab5444
MK
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:
40a54b37 6261
49ab5444
MK
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
aae76b9e
MK
6289
6290
6291==================== Changes in man-pages-2.51 ====================
6292
6293Released: 2007-05-28
6294
6295Global changes
6296--------------
6297
8fa20889
MK
6298Various pages
6299 mtk
6300 (Hopefully) all cross references outside a page now include a
6301 section number. This should permit better resulting output
752cb57f 6302 from a man2html-type conversion.
aae76b9e 6303
8fa20889
MK
6304Various pages
6305 mtk
6306 Convert function formatting of the form "\fBname\fP()" to
6307 ".BR name ()".
aae76b9e
MK
6308
6309
6310Changes to individual pages
6311---------------------------
6312
6313futimesat.2
6314 mtk
6315 s/futimes/futimesat/ in .SH NAME line.
6316
6317msgop.2
6318 mtk
6319 Put "msgrcv" and "msgsnd" in .SH NAME line.
6320
6321mount.2
6322 mtk
6323 Add "umount2" to .SH NAME line.
6324
6325wait.2
6326 mtk
6327 Add "waitid" to .SH NAME line.
6328
6329getopt.3
6330 mtk
6331 Add "getopt_long" and "getopt_long_only" in .SH NAME line.
6332
6333sem_wait.3
6334 mtk
6335 Add "sem_timedwait" and "sem_trywait" to .SH NAME line.
6336
6337stdarg.3
6338 mtk
6339 Add "va_start", "va_arg", "va_end", "va_copy" to .SH NAME line.
a1d5f77c
MK
6340
6341
6342==================== Changes in man-pages-2.52 ====================
6343
6344Released: 2007-05-29
6345
2b82fac6 6346 "A foolish consistency is the hobgoblin of little minds, adored by
a1d5f77c
MK
6347 little statesmen and philosophers and divines"
6348
28b3a122 6349 Ralph Waldo Emerson (1803-1882)
a1d5f77c
MK
6350
6351 "But damn it, these man pages are a mess!"
6352
6353
6354Global changes
6355--------------
6356
6357Most of the changes below are about bringing greater consistency
f631e6d3 6358to manual pages, including reducing the wide range of .SH
a1d5f77c
MK
6359Section headings.
6360
6361Typographical or grammatical errors have been corrected in several
6362places.
6363
6364Various pages
6365 mtk
dc1ffd77 6366 Make 'manual' component of .TH line into the string
752cb57f 6367 "Linux Programmer's Manual".
a1d5f77c
MK
6368 Reason: consistency.
6369
6370Various pages
6371 mtk
6372 Changed date in .TH line into form YYYY-DD-MM.
6373 Reason: consistency.
6374
6375Various 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
6380Various 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
6386Various pages
6387 mtk
2b82fac6
MK
6388 Commented out .SH AUTHOR sections; the right place for
6389 documentation authorship sections is usually comments at the
a1d5f77c
MK
6390 top of the page source.
6391
6392Various pages
6393 mtk
6394 Changed .SH HISTORY to .SH VERSIONS.
2b82fac6
MK
6395 Reason: in many cases, HISTORY was being used to describe
6396 Linux/glibc version information, as was already done for
a1d5f77c
MK
6397 VERSIONS sections in other pages.
6398
6399Various pages
6400 mtk
8fa20889
MK
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.
a1d5f77c
MK
6406
6407Various pages
6408 mtk
6409 Moved SEE ALSO section to be last section on the page
7e905579 6410 Reason: consistency -- and this is where SEE ALSO should be!
a1d5f77c
MK
6411
6412Various pages
6413 mtk
6414 Relocated GLIBC NOTES as subsection under NOTES
6415 Reason: reduce number of arbitrary section (.SH) names.
6416
6417Various pages
6418 mtk
6419 Relocated LINUX NOTES as subsection under NOTES
6420 Reason: reduce number of arbitrary section (.SH) names.
6421
6422Various pages
6423 mtk
2b82fac6 6424 Renamed some "AVAILABILITY" sections to "VERSIONS".
a1d5f77c
MK
6425 Reason: consistency.
6426
6427Various pages
6428 mtk
6429 Renamed some "DIAGNOSTICS" sections to "RETURN VALUE".
6430 Reason: consistency.
6431
6432getopt.3
6433tzselect.8
6434 mtk
6435 s/\.SH ENVIRONMENT VARIABLES/.SH ENVIRONMENT/
6436 Reason: consistency.
6437
6438intro.2
6439select.2
6440sysctl.2
6441bsearch.3
6442dlopen.3
6443envz_add.3
6444fmtmsg.3
6445getgrent_r.3
6446getgrouplist.3
6447getpwent_r.3
6448getutent.3
6449hsearch.3
6450rtime.3
6451strptime.3
6452tsearch.3
6453vcs.4
6454wordexp.3
6455 mtk
2b82fac6 6456 s/return 0/exit(EXIT_FAILURE)/ in main() of function example
a1d5f77c
MK
6457 program.
6458 Reason: consistency.
6459
6460mprotect.2
6461select_tut.2
6462dlopen.3
6463getgrent_r.3
6464getopt.3
6465getpwent_r.3
6466hsearch.3
6467select_tut.2
6468tsearch.3
6469 mtk
2b82fac6 6470 Use symbolic constants (EXIT_SUCCESS, EXIT_FAILURE) in calls
a1d5f77c
MK
6471 to exit().
6472 Reason: consistency.
6473
6474access.2
6475chown.2
6476lseek.2
6477open.2
6478read.2
6479utmp.5
6480 mtk
2b82fac6 6481 Renamed RESTRICTIONS section to NOTES, or moved text in a
a1d5f77c
MK
6482 RESTRICTIONS section under existing NOTES section.
6483 Reason: consistency, and reduce number of arbitrary section (.SH)
6484 names.
6485
6486
6487Changes to individual pages
6488---------------------------
6489
6490capget.2
6491 mtk
6492 s/\.SH FURTHER INFORMATION/.SH NOTES/
6493
6494dup.2
6495 mtk
6496 s/\.SH WARNING/.SH NOTES/
6497
6498kill.2
b5f5b525
MK
6499 mtk
6500 Renamed LINUX HISTORY section to LINUX NOTES, and relocated
6501 within page.
a1d5f77c
MK
6502
6503select_tut.2
6504 mtk
6505 Relocated example program and made its .SH title "EXAMPLE".
6506
6507sigaltstack.2
6508 mtk
6516abeb 6509 Move code example into its own EXAMPLE section.
a1d5f77c
MK
6510
6511sigreturn.2
6512 mtk
6513 s/\.SH WARNING/.SH NOTES/
6514
6515setuid.2
6516 mtk
6517 s/\.SH "LINUX-SPECIFIC REMARKS"/.SH LINUX NOTES/
6518
6519shmget.2
6520 mtk
2b82fac6 6521 Remove section about effect of fork()/exec()/exit(); shmop.2
a1d5f77c
MK
6522 contains the same text, and it only needs to be said once.
6523
6524shmop.2
6525 mtk
28b3a122 6526 Minor rewording under DESCRIPTION.
a1d5f77c
MK
6527
6528daemon.3
6529 mtk
6530 Minor wording and formatting changes.
6531
6532encrypt.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
6539mkstemp.3
6540 mtk
6541 Slight rewording.
6542
6543LDP.7
6544 mtk
6545 Minor wording and formatting changes.
6546
6547man.7
6548 mtk
6549 Substantial rewrite, revising and extending the discussion
6550 about desired conventions for writing pages.
2b82fac6 6551 There will be further updates to this page in the next few
a1d5f77c 6552 man-pages releases.
dd884839
MK
6553
6554
6555==================== Changes in man-pages-2.53 ====================
6556
6557Released: 2007-05-30
6558
2b82fac6 6559 "A foolish consistency is the hobgoblin of little minds, adored by
dd884839
MK
6560 little statesmen and philosophers and divines"
6561
28b3a122 6562 Ralph Waldo Emerson (1803-1882)
dd884839
MK
6563
6564 "But damn it, these man pages are a mess!"
6565
6566
6567Global changes
6568--------------
6569
6570Many many pages
6571 mtk
6572 Reordered sections to be more consistent, in some cases renaming
6573 sections or shifting paragraphs between sections.
6574
6575man7/*
6576 mtk
2b82fac6 6577 In various pages in this section, .SH headings were
dd884839
MK
6578 converted to .SS.
6579
9e54f9ab
MK
6580
6581==================== Changes in man-pages-2.54 ====================
6582
6583Released: 2007-06-07
6584
6585Contributors
6586------------
6587
6588The following people contributed notes, ideas, or patches that have
6589been incorporated in changes in this release:
6590
6591Emmanuel Mogenet <emogenet@google.com>
6592Michael Berg <michaeljberg@gmail.com>
6593
6594Apologies if I missed anyone!
6595
6596
6597Global changes
6598--------------
6599
6600Various pages
6601 mtk
2b82fac6 6602 Where there is an instruction in the SYNOPSIS about linking
9e54f9ab
MK
6603 or compiling with a certain option, the option is now
6604 marked up in italics (e.g., "\fI-lm\fP").
6605
6606Various pages
6607 mtk
6608 Added page numbers to page cross references.
6609
6610A few pages
6611 mtk
6612 s/manpage/man page/, for consistency.
6613
6614Typographical or grammatical errors have been corrected in several
6615places.
6616
6617
6618New pages
6619---------
6620
6621man-pages.7
6622 mtk
2b82fac6 6623 A description of the conventions that should be followed
9e54f9ab
MK
6624 when writing pages for the man-pages package.
6625
6626Removed pages
6627-------------
6628
6629man1/README
6630 mtk
6631 Already deleted most of the man1 pages previously, so
6632 this doesn't need to stay.
6633
6634LDP.7
6635 mtk
2b82fac6 6636 Removed this page since it is out of date, and the proper place
8fa20889 6637 to go for up-to-date information is http://www.tldp.org/
9e54f9ab
MK
6638
6639ksoftirq.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
6647Changes to individual pages
6648---------------------------
6649
6650HOWTOHELP
6651 mtk
6652 Moved some material out of here into new man-pages.7.
6653
6654alloc_hugepages.2
6655 mtk
6656 Minor rewrites, eliminating some duplication, and removing
6657 some outdated text.
6658
6659epoll_pwait.2
6660 Michael Berg
8fa20889
MK
6661 Fix broken link path;
6662 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=425570
9e54f9ab
MK
6663
6664fcntl.2
6665 mtk
2b82fac6 6666 Remove misleading text about setting O_ASYNC when calling
9e54f9ab
MK
6667 open(); one must use fcntl() F_SETFL for this task.
6668
6669fdatasync.2
6670 mtk
2b82fac6
MK
6671 Converted outdated BUGS note about fdatasync() being
6672 equivalent to fsync() on Linux 2.2 into a NOTES note
755b5e17 6673 about this historical behavior.
9e54f9ab
MK
6674
6675futex.2
6676 mtk
2b82fac6 6677 Small rewording to fix "fails with the error EWOULDBLOCK"
9e54f9ab
MK
6678 rather than "returns EWOULDBLOCK".
6679 See Red Hat bug 172828.
6680
6681mprotect.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
6687mremap.2
6688 mtk
58ce1507 6689 Remove text about the nonexistent BSD mremap() -- too
9e54f9ab
MK
6690 much information, in my opinion.
6691
6692sched_yield.2
6693 mtk
6694 Added ERRORS section.
6695
6696set_mempolicy.2
6697 mtk
6698 Moved text for "Versions and Library Support".
6699
6700set_tid_address.2
6701 mtk
6702 Small rewording in RETURN VALUE section.
6703
6704sigaction.2
6705 mtk
8fa20889 6706 Add EXAMPLE section with a pointer to example in mprotect.2.
9e54f9ab
MK
6707
6708sync_file_range.2
6709 mtk
6710 Fix return type in SYNOPSIS. Add RETURN VALUE section.
6711
6712atexit.3
6713 mtk
6714 Small rearrangement of text under NOTES.
6715
6716bindresvport.3
6717 mtk
6718 Rewrite and substantial additional text.
6719
6720exec.3
6721 mtk
6722 Minor clarifications for text on execlp() and execvp(). Removed
6723 FILES section, since it provides no useful additional info.
6724
6725fenv.3
6726 mtk
6727 Moved link instructions from NOTES to SYNOPSIS.
6728 Added feenableexcept, fedisableexcept, fegetexcept
6729 to .SH NAME list.
6730
6731fputwc.3
6732 mtk
6733 Added 'putwc' to .SH NAME list.
6734
6735gethostbyname.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
6740login.3
6741 mtk
6742 Removed remark from NOTES about linking with -lutil; add
6743 text on that point to SYNOPSIS.
6744
6745openpty.3
6746 mtk
6747 Removed redundant remark from NOTES about linking with -lutil
6748 since there is text on that point under SYNOPSIS.
6749
6750sysconf.3
6751 mtk
6752 Added SEE ALSO referring to getconf(1).
6753
6754unlocked_stdio.3
6755 mtk
6756 Revised .SH NAME section.
6757
6758ascii.7
6759 mtk
6760 Minor rearrangement of order of text.
6761
7efbf273 6762capabilities.7
9e54f9ab
MK
6763 mtk
6764 s/exec()/execve(2)/ in various places.
6765
6766complex.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
6771rtnetlink.7
6772 mtk
6773 Small restructuring to avoid 'cannot adjust line' from man(1).
6774
6775ldconfig.8
6776 mtk
6777 Removed now very out-of-date sentence about need to link shared
6778 libraries with -lc.
6779
6780man.7
6781 mtk
6782 Various text was moved out of this page into the new man-pages.7.
6783
6784mdoc.7
6785 mtk
28b3a122 6786 Added SEE ALSO referring to new man-pages.7.
9e54f9ab
MK
6787
6788mdoc.samples.7
6789 mtk
28b3a122
MK
6790 A few changes, hopefully done right, to eliminate some
6791 errors to stderr when rendering with man(1).
9e54f9ab
MK
6792
6793rtnetlink.7
6794 mtk
6795 Shorten a line in table so it fits in 80 columns.
6796 Minor rewording under BUGS.
6797
6798tzselect.8
6799 mtk
6800 Moved EXIT STATUS section.
54b09214
MK
6801
6802
6803==================== Changes in man-pages-2.55 ====================
6804
6805Released: 2007-06-10
6806
6807Contributors
6808------------
6809
6810The following people contributed notes, ideas, or patches that have
6811been incorporated in changes in this release:
6812
6813Alexander Taboriskiy <alextab@math-solution.com>
6814Joey Hess <joeyh@debian.org>
87ea2875 6815John Reiser <jreiser@bitwagon.com>
54b09214
MK
6816Julien Cristau <jcristau@debian.org>
6817Justin Pryzby <justinpryzby@users.sourceforge.net>
6818Martin (Joey) Schulze <joey@infodrom.org>
6819Mike Frysinger <vapier@gentoo.org>
6820Serge van den Boom <svdb@stack.nl>
6821Ulrich Drepper <drepper@redhat.com>
6822Xose Vazquez Perez <xose.vazquez@gmail.com>
6823
6824Apologies if I missed anyone!
6825
6826
6827Global changes
6828--------------
6829
6830clone.2
6831getdents.2
6832gettid.2
6833ioprio_set.2
6834llseek.2
6835mmap2.2
6836modify_ldt.2
6837mq_getsetattr.2
6838pivot_root.2
6839quotactl.2
6840readdir.2
6841sysctl.2
6842syslog.2
6843tkill.2
6844 mtk, after a note by Mike Frysinger
6845 Updated to reflect the fact that the _syscallN() macros
6846 have gone away,
6847
6848Several pages
6849 mtk
6850 Change reference to path_resolution.2 to path_resolution.7.
6851
6852Typographical or grammatical errors have been corrected in several
6853places.
6854
6855
6856Moved pages
6857-----------
6858
6859path_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
6865Changes to individual pages
6866---------------------------
6867
6868MAINTAINING
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
6876accept.2
6877 mtk
6878 Add new EXAMPLE section with pointer to example in bind.2.
6879
6880arch_prctl.2
6881 mtk
6882 Added RETURN VALUE section.
6883
6884bind.2
6885 mtk
6886 Expand example program, and move it to new EXAMPLE section.
ad4dd404 6887 Added text pointing to example in getaddrinfo.3.
54b09214
MK
6888
6889cacheflush.2
6890 mtk
6891 Convert NOTES section to CONFORMING TO and note that
6892 this call is Linux-specific.
6893 Other minor rewordings.
6894
6895connect.2
6896 mtk
6897 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6898
6899create_module.2
6900 mtk
6901 Add ENOSYS error.
6902
6903fcntl.2
6904flock.2
6905 mtk
6906 Small rewrite of SEE ALSO text pointing to Documentation/* in
6907 kernel source.
6908
6909get_kernel_syms.2
6910 mtk
6911 Added ERRORS heading
6912 Add ENOSYS error.
6913
6914getdtablesize.2
6915 mtk
6916 Added an ERRORS section.
6917
6918getsid.2
6919 mtk
6920 Added a RETURN VALUE section.
6921
6922getpid.2
6923 mtk
6924 Added an ERRORS section (stating that the calls are
6925 always successful).
6926
6927ioctl_list.2
6928 mtk
6929 Add SEE ALSO reference to ioctl.2.
6930
6931listen.2
6932 mtk
6933 Add new EXAMPLE section with pointer to example in bind.2.
6934
6935query_module.2
6936 Martin (Joey) Schulze
6937 Add ENOSYS error.
6938
6939recv.2
6940 mtk
6941 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6942
6943sched_get_priority_max.2
6944sched_rr_get_interval.2
6945sched_setscheduler.2
6946sched_yield.2
6947 mtk
6948 Modified .TH line
6949
6950send.2
6951 mtk
6952 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6953
6954set_tid_address.2
6955 mtk
6956 Added an ERRORS section (stating that the call is
6957 always successful).
6958
6959signal.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
6966socket.2
6967 mtk
6968 Added new EXAMPLE section pointing to example in getaddrinfo.3.
6969
6970stat.2
6971 mtk
6972 Added EXAMPLE program.
6973
6974syscall.2
6975 mtk
6976 Converted to -man format; some rewrites; added an EXAMPLE.
6977
6978sysctl.2
6979 mtk
6980 Improved the example program.
6981
6982getnameinfo.3
6983 mtk
6984 Add text pointing to example in getaddrinfo.3.
6985
6986getaddrinfo.3
6987 mtk
6988 Add example programs.
6989 Add getnameinfo() to SEE ALSO list.
6990
6991memmove.3
6992 mtk / Serge van den Boom
6993 Clarify discussion of what happens if 'src' and 'dest' overlap.
6994
6995regex.3
6996 Justin Pryzby
6997 Add grep(1) to SEE ALSO list.
6998
6999sigpause.3
7000 mtk after a note from Ulrich Drepper
2b82fac6
MK
7001 Clarify discussion of feature test macros that are needed to
7002 expose System V and BSD versions of this function in glibc.
54b09214
MK
7003
7004undocumented.3
7005 mtk
7006 Removed some functions that have been documented.
7007
7008wprintf.2
7009 Martin (Joey) Schulze
28b3a122 7010 Remove wscanf.3 from SEE ALSO list, since that page does not exist.
54b09214
MK
7011
7012utmp.5
7013 Joey Hess
7014 Removed outdated note on xdm.
8fa20889 7015 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418009
54b09214
MK
7016 Martin (Joey) Schulze
7017 Removed outdated note about Debian and libc5.
7018
7019bootparam.7
7020 Martin (Joey) Schulze
7021 Fix order of commands listed under 'init='.
7022
7023hier.7
7024 Joey Hess
7025 Add /media, remove /dos.
8fa20889 7026 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=418234
54b09214
MK
7027
7028inotify.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,
755b5e17 7032 and noting the behavior change in 2.6.21.
54b09214
MK
7033
7034man-pages.7
7035 mtk
7036 Added text to note that ERRORS list should be in alphabetical order.
7037
7038mdoc.7
7039mdoc.samples.7
7040 mtk
7041 Added SEE ALSO reference to groff_mdoc(7).
7042
7043unix.7
7044 mtk
7045 Added EXAMPLE section with pointer to bind.2 EXAMPLE.
7046
7047ld.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.
35767259
MK
7052
7053
7054==================== Changes in man-pages-2.56 ====================
7055
7056Released: 2007-06-11
7057
7058Global changes
7059--------------
7060
7061Many pages
7062 mtk
7063 Removed version numbers in .TH lines.
2b82fac6
MK
7064 Reason: these were only arbitrarily updated, and so impart no
7065 useful information. Version information goes into a
35767259
MK
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
7070Typographical or grammatical errors have been corrected in several
7071places.
67d0d87d
MK
7072
7073
7074==================== Changes in man-pages-2.57 ====================
7075
7076Released: 2007-06-17
7077
7078Contributors
7079------------
7080
7081The following people contributed notes, ideas, or patches that have
7082been incorporated in changes in this release:
7083
7084Samuel Thibault <samuel.thibault@ens-lyon.org>
7085
7086Apologies if I missed anyone!
7087
7088
7089Global changes
7090--------------
7091
7092Many pages
7093 mtk
8fa20889 7094 Fix section numbers in page cross references.
67d0d87d
MK
7095
7096
7097Changes to individual pages
7098---------------------------
7099
7100access.2
7101 mtk
7102 Minor wording fixes.
7103 Small clarification of description of 'mode'.
7104
7105bind.2
7106 mtk
7107 Small reworking of EXAMPLE program.
7108
7109exit_group.2
7110 mtk
7111 Minor wording fixes.
7112
7113exit.3
7114 mtk
7115 Added more detail on exit handlers.
7116 Minor wording fixes.
7117
7118ioctl.2
7119 mtk
58ce1507 7120 Remove SEE ALSO reference to nonexistent mt.4.
67d0d87d
MK
7121
7122modify_ldt.2
7123 Samuel Thibault / mtk
7124 In Linux 2.6, the 'modify_ldt_ldt_s' structure was renamed
8fa20889 7125 'user_desc'.
752cb57f 7126 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=378668
67d0d87d
MK
7127 mtk
7128 Include definition of 'user_desc' structure.
7129 Minor rewordings.
7130
7131mprotect.2
7132 mtk
7133 Small reworking of EXAMPLE program.
7134
7135sigaction.2
7136 mtk
58ce1507 7137 Removed reference to nonexistent sigsend(2).
67d0d87d
MK
7138
7139a64l.3
7140 mtk
58ce1507 7141 Remove SEE ALSO reference to nonexistent itoa.3.
67d0d87d
MK
7142
7143dysize.3
7144 mtk
58ce1507 7145 Removed SEE ALSO reference to nonexistent time.3.
67d0d87d
MK
7146
7147encrypt.3
7148 mtk
7149 Removed SEE ALSO reference to nonexistent fcrypt.3.
7150
7151fmemopen.3
7152 mtk
7153 Small reworking of EXAMPLE program.
7154
7155fpurge.3
7156 mtk
58ce1507 7157 Remove SEE ALSO reference to nonexistent fclean.3.
67d0d87d
MK
7158
7159getutent.3
7160 mtk
7161 s/ttyname(0)/ttyname(STDIN_FILENO)/ in program example.
7162
7163vcs.4
7164 mtk
7165 s/exit(1)/exit(EXIT_FAILURE)/
7166
7167environ.7
7168 mtk
7169 Correct some section numbers in page cross references.
7170
7171man-pages.7
7172 mtk
7173 Modify requirements for example programs a little.
7174
7175uri.7
7176 mtk
7177 Wrapped long source lines.
21be2ec1
MK
7178
7179
7180==================== Changes in man-pages-2.58 ====================
7181
7182Released: 2007-06-24
7183
7184Contributors
7185------------
7186
7187The following people contributed notes, ideas, or patches that have
7188been incorporated in changes in this release:
7189
7190Marc Boyer <marc.boyer@enseeiht.fr>
7191Mike Frysinger <vapier@gentoo.org>
7192
7193Apologies if I missed anyone!
7194
7195
7196Global changes
7197--------------
7198
7199Various pages, as detailed below
7200 mtk
7201 Added or updated VERSIONS sections.
7202
7203killpg.2
7204setuid.2
7205faccessat.2
7206fork.2
7207setfsuid.2
7208kill.2
7209getsid.2
7210wait.2
7211execve.2
7212getpid.2
7213setgid.2
7214seteuid.2
7215setresuid.2
7216setfsgid.2
7217access.2
7218initgroups.3
7219euidaccess.3
7220tcgetpgrp.3
7221path_resolution.7
7222capabilities.7
7223unix.7
7224 mtk
7225 Add SEE ALSO link to new credentials.7.
7226
7227
7228New pages
7229---------
7230
7231credentials.7
7232 mtk
7233 An overview of Linux process identifiers (PIDs, PPIDs,
7234 PGIDS, SIDs, UIDs, GIDs).
7235
7236
7237Changes to individual pages
7238---------------------------
7239
7240bind.2
7241 mtk
7242 Added some comments to example program.
7243
7244getxattr.2
7245 mtk
7246 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7247
7248listen.2
7249 mtk
7250 Updated discussion of somaxconn limit.
7251
7252listxattr.2
7253 mtk
7254 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7255
7256posix_fadvise.2
7257 mtk
7258 VERSIONS: Glibc support has been provided since version 2.2.
7259
7260readahead.2
7261 mtk
7262 Added VERSIONS section.
7263
8fa20889 7264remap_file_pages.2
21be2ec1
MK
7265 mtk
7266 Updated VERSIONS section with text on glibc support.
7267
7268removexattr.2
7269 mtk
7270 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7271
7272semop.2
7273 mtk
7274 Added VERSIONS section with info on semtimedop().
7275
7276setxattr.2
7277 mtk
7278 VERSIONS: In kernel since 2.4; glibc support since 2.3.
7279
7280dl_iterate_phdr.3
7281 mtk
7282 VERSIONS: Supported since glibc 2.2.4.
7283
7284getloadavg.3
7285 mtk
7286 Added VERSIONS section.
7287
7288posix_openpt.3
7289 mtk
7290 VERSIONS: Supported since glibc 2.2.1.
7291
7292printf.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().
40a54b37 7296
1a8bdc8f 7297shm_open.3
21be2ec1
MK
7298 mtk
7299 Added VERSIONS section; rewrote info about linking with -lrt.
7300
7301strcat.3
7302 Marc Boyer
7303 Improve the discussion of strncat().
7304
7305strcpy.3
7306 Marc Boyer
7307 Improve the discussion of strncpy().
7308
7309proc.5
7310 mtk
7311 Added discussion of /proc/sys/net/core/somaxconn.
f77d3fbc
MK
7312
7313
7314==================== Changes in man-pages-2.59 ====================
7315
7316Released: 2007-06-25
7317
7318Global changes
7319--------------
7320
7321Manual pages are now standardized on American spelling. See
7322http://en.wikipedia.org/wiki/American_and_British_English_spelling_differences
7323for more information on the differences. Formerly, different pages (and
7324sometimes even a single page!) employed American and British spelling
0e52efa8 7325conventions; best to standardize on one spelling, and American English
f77d3fbc
MK
7326is the standard in Computer Science.
7327
7328Changes to individual pages
7329---------------------------
7330
7331man-pages.7
7332 mtk
7333 Note that man-pages has now standardized on American spelling
7334 conventions.
7335
7336execve.2
7337getxattr.2
7338listxattr.2
7339removexattr.2
7340setxattr.2
7341signal.2
7342syscall.2
7343aio_cancel.3
7344bindresvport.3
7345stdarg.3
7346charmap.5
7347bootparam.7
7348ipv6.7
7349man.7
7350path_resolution.7
7351uri.7
7352nscd.8
7353 mtk
7354 Corrected minor spelling/wording mistakes (i.e., changes
7355 independent of fixes for American spelling).
971e01b7
MK
7356
7357
7358==================== Changes in man-pages-2.60 ====================
7359
7360Released: 2007-06-25
7361
7362
7363Global changes
7364--------------
7365
7366Various pages
8fa20889
MK
7367 mtk
7368 Wrapped lines in some files.
971e01b7
MK
7369
7370Various pages
7371 mtk
7372 Change "e.g. " to "e.g., ", or in some cases, "for example, ".
7373
7374Various pages
7375 mtk
ad4dd404 7376 Change "i.e. " to i.e., ", or in some cases, "that is, ".
971e01b7
MK
7377
7378Various pages
7379 mtk
28b3a122 7380 Removed AUTHORS section.
971e01b7
MK
7381
7382Typographical or grammatical errors have been corrected in several
7383places.
7384
7385
7386Changes to individual pages
7387---------------------------
7388
7389vfork.2
7390 mtk
78f3e242 7391 s/w.r.t/with respect to/
971e01b7
MK
7392
7393man-pages.7
7394 mtk
7395 Strengthened warning against use of AUTHORS section.
19936f7d
MK
7396
7397
7398==================== Changes in man-pages-2.61 ====================
7399
7400Released: 2007-07-01
7401
7402
7403Contributors
7404------------
7405
7406The following people contributed notes, ideas, or patches that have
7407been incorporated in changes in this release:
7408
7409Alain Portal <aportal@univ-montp2.fr>
7410Benno Schulenberg <bensberg@justemail.net>
7411Florian Ernst <florian_ernst@gmx.net>
7412Ivana Varekova <varekova@redhat.com>
7413Jeff Schroeder <jeffschroeder@computer.org>
7414Joey (Martin) Schulze <joey@infodrom.org>
7415Justin Pryzby <justinpryzby@users.sourceforge.net>
33972b0b 7416Loïc Minier <lool@dooz.org>
19936f7d
MK
7417Michael Gehring <mg@ebfe.org>
7418Serge van den Boom <svdb@stack.nl>
7419Stefan Puiu <stefanpuiuro@yahoo.com>
7420Stepan Kasal <kasal@ucw.cz>
7421
7422Apologies if I missed anyone!
7423
7424
7425Global changes
7426--------------
7427
7428Various pages
7429 mtk
7430 substitute `\\0' by '\\0'.
7431
7432Various pages
7433 mtk
7434 s/`/'/ when the thing being quoted is a character.
7435
7436accept.2
7437bind.2
7438connect.2
7439getsockopt.2
7440listen.2
7441socket.2
7442socketpair.2
8fa20889 7443 mtk after a note by Martin (Joey) Schulze
19936f7d
MK
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
7447accept.2
7448getsockname.2
7449recv.2
7450vm86.2
7451send.2
7452getgrouplist.3
7453memmem.3
7454nsswitch.conf.5
7455putenv.3
7456wprintf.3
7457 mtk
7458 Replace form `...' with \fI...\fP where the enclosed string
7459 is a pathname, type name, or argument name.
7460
7461A few files
7462 mtk
7463 s/process' /process's/
7464
7465gets.3
7466qsort.3
7467getaddrinfo.3
7468rpc.3
7469ungetwc.3
7470wcsnrtombs.3
7471capabilities.7
7472 mtk
7473 Add section number to page cross references.
7474
7475time.1
7476bind.2
7477pivot_root.2
7478sysctl.2
7479 mtk
7480 Reordered .SH sections.
7481
7482full.4
7483mouse.4
7484random.4
7485sd.4
7486 mtk
7487 Made CONFIG/CONFIGURING heading ==> CONFIGURATION
7488
7489time.1
7490console_codes.4
7491random.4
7492sk98lin.4
7493charmap.5
7494ftpusers.5
7495bootparam.7
7496charsets.7
7497glob.7
7498mq_overview.7
7499unicode.7
7500uri.7
7501utf-8.7
7502 mtk
7503 Reformatted headings
7504
7505
7506New pages
7507---------
7508
7509backtrace.3
7510 mtk, with input from Justin Pryzby and Stefan Puiu
7511 Documents backtrace(), backtrace_symbols(), and
7512 backtrace_symbols_fd().
7513
7514
7515New links
7516---------
7517
7518backtrace_symbols.3
7519backtrace_symbols_fd.3
7520 mtk
7521 Links to backtrace.3.
7522
7523__clone.2
7524 Stepan Kasal
7525 Link to clone.2.
7526
7527
7528Changes to individual pages
7529---------------------------
7530
7531Makefile
7532 Serge van den Boom
7533 Fix setting of 'prefix' macro.
7534
7535eval.1p
7536 Benno Schulenberg
7537 Fix bad text (concatenated line).
7538
7539chdir.2
7540 mtk
7541 Fixed description of EACCES error.
7e3020a9 7542 Added sentence defining "current working directory".
19936f7d
MK
7543 Other minor wording changes.
7544
7545cfree.3
7546 mtk
7547 Added SEE ALSO section.
7548
7549clone.2
7550 mtk
7551 s/clone2/__clone2/.
7552
7553fdatasync.2
7554 mtk
7555 Minor wording changes.
7556
c99ead28 7557fork.2
19936f7d
MK
7558 Alain Portal
7559 Fix small wording error.
7560
7561gethostid.2
7562 Stefan Puiu / mtk
7563 Add NOTES on what happens if gethostid() can't open /etc/hostid.
7564
7565idle.2
7566 mtk
8fa20889
MK
7567 Made NOTES text into a VERSIONS section, since that's what it
7568 really describes.
19936f7d
MK
7569
7570ioperm.2
7571 mtk
7572 Minor wording changes.
7573
19936f7d
MK
7574intro.2
7575 mtk
8fa20889
MK
7576 Rewrite to reflect the fact that the _syscallN
7577 macros are no longer available.
19936f7d
MK
7578
7579io_cancel.2
7580 mtk
7581 Add "Link with -laio" to SYNOPSIS.
7582
7583io_destroy.2
7584 mtk
7585 Add "Link with -laio" to SYNOPSIS.
7586
7587io_getevents.2
7588 mtk
7589 Add "Link with -laio" to SYNOPSIS.
7590
7591io_setup.2
7592 mtk
7593 Add "Link with -laio" to SYNOPSIS.
7594
7595io_submit.2
7596 Ivana Varekova
7597 Fix include in SYNOPSIS.
7598 mtk
7599 Add "Link with -laio" to SYNOPSIS.
7600
7601ipc.2
19936f7d 7602 mtk
14ca79cb 7603 Add semtimedop() to SEE ALSO.
19936f7d
MK
7604 Note that some architectures don't have ipc(2); instead
7605 real system calls are provided for shmctl(), semctl(), etc.
7606
14ca79cb
MK
7607killpg.2
7608 mtk
7609 Minor wording changes.
7610
19936f7d
MK
7611listen.2
7612 mtk
7613 Added <sys/types.h> to SYNOPSIS.
7614
7615sched_setscheduler.2
7616 mtk
7617 Add NOTES para about permissions required to call
7618 sched_setscheduler() on other systems.
7619
7620select.2
7621 mtk
7622 Noted that 'timeout' can also be changed if select() is
7623 interrupted by a signal.
7624
7625setup.2
7626 mtk
7627 Remove reference to _syscall0() macro.
7628
7629shmop.2
7630 mtk
7631 Changed text for EINVAL error.
7632
7633socketcall.2
7634 mtk
14ca79cb 7635 Add recvmsg() and sendmsg() to SEE ALSO.
19936f7d
MK
7636 Note that some architectures don't have socketcall(2); instead
7637 real system calls are provided for socket(), bind(), etc.
7638
7639swapon.2
7640 Ivana Varekova / mtk
7641 Update text for EPERM error describing the maximum number of
7642 swap files. (From downstream Fedora patch.)
7643
7644write.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
7656confstr.3
7657 mtk
7658 Minor rewrites in code example.
7659
7660ctime.3
7661 Justin Pryzby
7662 Make SEE ALSO refer to timegm.3
7663
7664daemon.3
7665 mtk
7666 Small wording change.
7667
7668dl_iterate_phdr.3
7669 Michael Gehring
7670 Comment was missing closing "*/".
7671
7672dlopen.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
7679fpclassify.3
7680 mtk
7681 Add "isinf" to NAME section.
7682
7683getgrouplist.3
7684 mtk
7685 Minor rewording.
7686
7687getline.3
7688 mtk
24fd8070 7689 Minor rewording, and note that '*n* is ignored
19936f7d
MK
7690 if '*lineptr' is NULL.
7691
7692malloc.3
7693 Ivana Varekova / mtk
7694 Update description of MALLOC_CHECK_ to include description
7695 for value 3. (From downstream Fedora patch.)
7e3020a9 7696
19936f7d
MK
7697netlink.3
7698 mtk
7699 Added a CONFORMING TO section; other minor edits.
7700
7701openpty.3
7702 mtk
7703 Minor changes to SYNOPSIS.
7704
7705program_invocation_name.3
7706 mtk
7707 Shortened page title to INVOCATION_NAME.
7708
7709rtnetlink.3
7710 mtk
7711 Added a CONFORMING TO section; other minor edits.
7712
7713scanf.3
7714 Florian Ernst
7715 Fix duplicated word "the".
8fa20889 7716 (Really fix http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=412467 !)
19936f7d
MK
7717
7718select_tut.3
7719 mtk
8fa20889 7720 Small wording change.
19936f7d
MK
7721
7722setnetgrent.3
7723 mtk
7724 Added a CONFORMING TO section.
7725
7726sigpause.3
7727 mtk
7728 Added a CONFORMING TO section.
7729
7730strftime.3
7731 Just Pryzby
7732 Small wording fix.
7733 mtk
7e3020a9 7734 Note use of "gcc -Wno-format-y2k" to avoid the "`%c' yields only
19936f7d
MK
7735 last 2 digits of year in some locales" warning.
7736
7737strstr.3
7738 mtk
7739 Add "strcasestr" to NAME section.
7740
7741syslog.3
7742 mtk
8fa20889 7743 Small wording change.
19936f7d
MK
7744
7745
7746termios.3
7747 mtk
7748 Reformat SYNOPSIS.
7749 Added a CONFORMING TO section.
7750
7751timegm.3
7752 mtk
7753 Small wording changes.
7754
7755ulimit.3
7756 mtk
7e3020a9 7757 Remove erroneous text saying that glibc does not provide
19936f7d
MK
7758 <ulimit.h>; it does.
7759
7760initrd.4
7761 mtk
7762 Various reformattings.
7763
7764core.5
7765 mtk
7766 Added a sentence noting why core dumps named "core.PID" were useful
7767 with LinuxThreads.
7768
7769bootparam.7
7770 mtk
7771 Fix capitalization in .SS headings.
7772
7773epoll.7
7774 mtk
7775 Language clean ups.
7776
7777feature_test_macros.7
7778 mtk
7779 Added SEE ALSO section.
7780
7781mq_overview.7
7782 mtk
7783 Reformatted headings; minor rewrites.
7784
7785sem_overview.7
7786 mtk
7787 Reformatted headings; minor rewrites.
7788
7789socket.7
33972b0b 7790 Loïc Minier <lool@dooz.org>
19936f7d 7791 Document argument type for SO_REUSEADDR.
8fa20889 7792 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=255881
19936f7d
MK
7793
7794uri.7
7795 mtk
7796 Wrap long line in SYNOPSIS.
7797
7798ldconfig.8
7799 mtk
7800 Added SEE ALSO section.
cc49a889
MK
7801
7802
7803==================== Changes in man-pages-2.62 ====================
7804
7805Released: 2007-07-09
7806
7807This release consists solely of formatting fixes. There are no changes
7808to content.
7809
7810Contributors
7811------------
7812
7813The following people contributed notes, ideas, or patches that have
7814been incorporated in changes in this release:
7815
7816Stepan Kasal <kasal@ucw.cz>
7817
7818Apologies if I missed anyone!
7819
7820
7821Global changes
7822--------------
7823
7824Many many pages
7825 mtk
f3247989 7826 Many many formatting fixes.
cc49a889 7827
8fa20889
MK
7828man[013]p/*
7829 Stepan Kasal
7830 Add section number to .TH line for POSIX pages in man[013]p.
479bd65a
MK
7831
7832
7833==================== Changes in man-pages-2.63 ====================
7834
7835Released: 2007-07-16
7836
7837
7838Contributors
7839------------
7840
7841The following people contributed notes, ideas, or patches that have
7842been incorporated in changes in this release:
7843
7844Arnd Bergmann <arndb@de.ibm.com>
7845Eduardo M. Fleury <efleury@br.ibm.com>
7846Ivana Varekova <varekova@redhat.com>
7847Justin Pryzby <justinpryzby@users.sourceforge.net>
7848Marc Boyer <marc.boyer@enseeiht.fr>
7849Martin (Joey) Schulze <joey@infodrom.org>
33972b0b 7850Martin Röhricht <martin@roehricht.info>
479bd65a
MK
7851Patrick Mansfield <patmans@us.ibm.com>
7852Pierre Habouzit <madcoder@debian.org>
7853Stepan Kasal <kasal@ucw.cz>
7854
7855Apologies if I missed anyone!
7856
7857
7858Global changes
7859--------------
7860
7861gettimeofday.2
7862madvise.2
7863msgctl.2
7864select.2
7865semctl.2
7866shmctl.2
7867syslog.2
7868stat.2
7869a64l.3
7870printf.3
7871termios.3
7872xdr.3
7873sd.4
7874 mtk
7875 Minor wording changes.
7876
7877obsolete.2
7878syscall.2
7879unimplemented.2
7880 mtk
7881 Added SEE ALSO reference to syscalls.2.
7882
7883
7884New pages
7885---------
7886
7887sgetmask.2
7888 mtk
7889 A real man page for sgetmask(2) and ssetmask(2).
db7f6ee1 7890 (This page replaces a previous link of the same name, which
18cda976 7891 linked to signal.2.)
479bd65a
MK
7892
7893spu_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
7899spu_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
7905spufs.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
7912Removed 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
7920obsolete.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
7925undocumented.2
7926 mtk
7927 This page is very out of date, and in any case difficult
7928 to maintain. Information about undocumented system calls
18cda976 7929 is maintained in the HOWTOHELP file, and probably in other
479bd65a
MK
7930 places soon.
7931
7932killpg.3
7933 mtk
7934 This rather incomplete page seems unnecessary since there
7935 is a killpg.2.
7936
7937
7938New links
7939---------
7940
7941chown32.2
7942fchown32.2
7943getegid32.2
7944geteuid32.2
7945getgid32.2
7946getgroups32.2
7947getresgid32.2
7948getresuid32.2
7949getuid32.2
7950lchown32.2
7951setfsgid32.2
7952setfsuid32.2
7953setgid32.2
7954setgroups32.2
7955setregid32.2
7956setresgid32.2
7957setresuid32.2
7958setreuid32.2
7959setuid32.2
7960 mtk
7961 Added as link to corresponding page without "32".
7962
7963fcntl64.2
7964fstat64.2
7965fstatat64.2
7966fstatfs64.2
7967ftruncate64.2
7968getdents64.2
7969lstat64.2
7970pread64.2
7971pwrite64.2
7972sendfile64.2
7973stat64.2
7974statfs64.2
7975truncate64.2
7976 mtk
7977 Added as link to corresponding page without "64".
7978
7979__clone2.2
7980clone2.2
7981 mtk
7982 Links to clone.2.
7983
7984ugetrlimit.2
7985 mtk
7986 Link to getrlimit.2.
7987
7988mq_notify.2
7989mq_open.2
7990mq_timedreceive.2
7991mq_timedsend.2
7992mq_unlink.2
7993 mtk
7994 Added as links to corresponding section 3 pages.
7995
7996fadvise64.2
7997fadvise64_64.2
7998 mtk
7999 Links to posix_fadvise.2.
8000
8001rt_sigaction.2
8002rt_sigpending.2
8003rt_sigprocmask.2
8004rt_sigtimedwait.2
8005 mtk
8006 Added as link to corresponding page without "rt_" prefix.
8007
8008rt_sigqueueinfo.2
8009 mtk
8010 Link to sigqueue.2.
8011
8012madvise1.2
8013tuxcall.2
8014vserver.2
8015 mtk / Ivana Varekova
8016 Link to unimplemented.2.
8017
8018
8019Changes to individual pages
8020---------------------------
8021
8022access.2
8023 mtk
8024 Fairly substantial rewrites of various parts,
8025 and a few additions.
8026
8027chmod.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
8032chown.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
8038killpg.2
8039 mtk
8040 Note that killpg() is actually a library function on Linux.
8041
8042mmap.2
8043 mtk
8044 Added note that glibc mmap() wrapper nowadays invokes mmap2().
8045
8046mmap2.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
8056oldfstat.2
8057oldlstat.2
8058oldstat.2
8059 mtk
8060 Changed link to point to stat.2 (instead of obsolete.2).
8061
8062olduname.2
8063oldolduname.2
8064 mtk
8065 Changed link to point to uname.2 (instead of obsolete.2).
8066
8067sched_setaffinity.2
33972b0b 8068 Martin Röhricht
479bd65a
MK
8069 Added _GNU_SOURCE to SYNOPSIS.
8070
8071semctl.2
8072 mtk
8073 Remove reference discussion of ipc(2), since none of the
8074 other System V IPC pages mention ipc(2).
8075
8076semop.2
8077 mtk
8078 Add an example code segment.
8079
8080shmctl.2
8081 mtk
8082 Add svipc(7) to SEE ALSO list.
8083
8084sigaction.2
8085 mtk
8086 Reformatted tables as lists; other minor reformattings and
8087 wording changes.
8088
8089sigqueue.2
8090 mtk
8091 Added info on rt_sigqueueinfo(2).
8092
8093sigwaitinfo.2
8094 mtk
8095 Noted that sigwaitinfo() is a library function implemented on
8096 top of sigtimedwait().
8097
8098ssetmask.2
8099 mtk
8100 Make this link point to new sgetmask.2 instead of signal.2.
8101
8102stat.2
8103 mtk
8104 Add notes on the different system call interfaces that
8105 have appeared over time.
8106
5346e714
MK
8107syscalls.2
8108 mtk
8109 A fairly substantial rewrite of this page,
6bf3770e 8110 bringing it up to date with the current
b0aca9e9
MK
8111 kernel version, and listing all system calls
8112 in tabular form.
5346e714 8113
479bd65a
MK
8114uname.2
8115 mtk
8116 Add notes on the different system call interfaces that
8117 have appeared over time.
8118
8119unimplemented.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
8126mktemp.3
8127 Patrick Mansfield
8128 Fix description of return value.
8129
8130strcat.3
8131 Marc Boyer
8132 Minor fix to example program.
8133
8134undocumented.3
8135 mtk
8136 Add section numbers to function names; remove some functions
8137 since they are documented.
8138
8139proc.5
8140 mtk
8141 Update/correct text on /proc/malloc.
8fa20889 8142 mtk, after a note by Pierre Habouzit, and a few comments by Justin Pryzby
479bd65a 8143 Update description of /proc/PID/stat to match 2.6.21.
8fa20889 8144 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417933
479bd65a
MK
8145
8146inotify.7
8147 mtk
8148 IN_DONT_FOLLOW and IN_ONLYDIR are only available from 2.6.15.
8149
8150signal.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
8157svipc.7
8158 mtk
8159 Add ipc(2) to SEE ALSO.
4c08af27
MK
8160
8161
8162==================== Changes in man-pages-2.64 ====================
8163
8164Released: 2007-07-27
8165
8166
8167Contributors
8168------------
8169
8170The following people contributed notes, ideas, or patches that have
8171been incorporated in changes in this release:
8172
8173Aleksandr Koltsoff <czr@iki.fi>
8174Andries Brouwer <Andries.Brouwer@cwi.nl>
8175Justin Pryzby <justinpryzby@users.sourceforge.net>
8176
8177Apologies if I missed anyone!
8178
8179
8180Global changes
8181--------------
8182
8183INFINITY.3
8184_exit.2
8185a64l.3
8186abs.3
8187acct.2
8188acosh.3
8189addseverity.3
8190adjtime.3
8191asinh.3
8192atanh.3
8193atoi.3
8194brk.2
8195cbrt.3
8196cfree.3
8197chdir.2
8198chmod.2
8199chown.2
8200clearenv.3
8201clock_getres.3
8202clone.2
8203confstr.3
8204copysign.3
8205ctermid.3
8206ctime.3
8207daemon.3
8208dirfd.3
8209div.3
8210drand48.3
8211drand48_r.3
8212dysize.3
8213ecvt.3
8214ecvt_r.3
8215erf.3
8216euidaccess.3
8217exp2.3
8218expm1.3
8219fdatasync.2
8220ferror.3
8221fexecve.3
8222fgetgrent.3
8223fgetpwent.3
8224finite.3
8225flockfile.3
8226fopen.3
8227fpclassify.3
8228fsync.2
8229futimes.3
8230fwide.3
8231gamma.3
8232gcvt.3
8233getcwd.3
8234getdate.3
8235getdirentries.3
8236getdomainname.2
8237getdtablesize.2
8238getgrent.3
8239getgrent_r.3
8240getgrouplist.3
8241getgroups.2
8242gethostbyname.3
8243gethostid.2
8244gethostname.2
8245getlogin.3
8246getmntent.3
8247getpagesize.2
8248getpw.3
8249getpwent.3
8250getpwent_r.3
8251getpwnam.3
8252getsid.2
8253getspnam.3
8254gettimeofday.2
8255getumask.3
8256getusershell.3
8257gsignal.3
8258hypot.3
8259inet.3
8260initgroups.3
8261insque.3
8262isalpha.3
8263iswblank.3
8264j0.3
8265kill.2
8266killpg.2
8267lgamma.3
8268lockf.3
8269log1p.3
8270log2.3
8271logb.3
8272longjmp.3
8273lrint.3
8274lround.3
8275madvise.2
8276mbsnrtowcs.3
8277memfrob.3
8278mincore.2
8279mkdtemp.3
8280mknod.2
8281mkstemp.3
8282mktemp.3
8283nan.3
8284nanosleep.2
8285nextafter.3
8286nice.2
8287on_exit.3
8288perror.3
8289posix_memalign.3
8290posix_openpt.3
8291printf.3
8292profil.3
8293psignal.3
8294putenv.3
8295putpwent.3
8296qecvt.3
8297rand.3
8298random.3
8299rcmd.3
8300readahead.2
8301readlink.2
8302realpath.3
8303remainder.3
8304remquo.3
8305rexec.3
8306rint.3
8307round.3
8308rpmatch.3
8309scalb.3
8310scandir.3
8311scanf.3
8312seekdir.3
8313select.2
8314sem_wait.3
8315semop.2
8316setbuf.3
8317setenv.3
8318seteuid.2
8319setjmp.3
8320setnetgrent.3
8321setpgid.2
8322setresuid.2
8323setreuid.2
8324sigaltstack.2
8325siginterrupt.3
8326significand.3
8327sigqueue.2
8328sigvec.3
8329sigwaitinfo.2
8330sockatmark.3
8331stat.2
8332stime.2
8333strdup.3
8334strerror.3
8335strsep.3
8336strtod.3
8337strtok.3
8338strtol.3
8339strtoul.3
8340symlink.2
8341sync.2
8342syscall.2
8343syslog.3
8344tcgetsid.3
8345telldir.3
8346tempnam.3
8347termios.3
8348tgamma.3
8349timegm.3
8350toascii.3
8351trunc.3
8352truncate.2
8353ttyslot.3
8354tzset.3
8355ualarm.3
8356unlocked_stdio.3
8357unshare.2
8358usleep.3
8359vfork.2
8360vhangup.2
8361wait.2
8362wait4.2
8363wcscasecmp.3
8364wcsncasecmp.3
8365wcsnlen.3
8366wcsnrtombs.3
8367wcswidth.3
8368wordexp.3
8369wprintf.3
8370 mtk
8371 Added/updated feature test macro requirements for
8372 glibc; see feature_test_macros.7 for details.
8373
8374Changes to individual pages
8375---------------------------
8376
8377mq_notify.2
8378mq_open.2
8379mq_timedreceive.2
8380mq_timedsend.2
8381mq_unlink.2
8382 mtk
8383 Fix broken link
8384
8385setpgid.2
8386 mtk
8387 Fairly substantial changes and corrections, including adding
8388 coverage of all of the interfaces that get/set PGIDs.
8389
8390syscalls.2
8391 mtk / aeb
39cf8930 8392 Various rewordings; clear up some imprecisions.
4c08af27
MK
8393
8394lgamma.3
8395 mtk
8396 Added 'signgam' to SYNOPSIS and NAME line.
8397
8398strerror.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
8407man-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
8413feature_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.
60aab175
MK
8419
8420
8421==================== Changes in man-pages-2.65 ====================
8422
8423Released: 2007-09-17
8424
8425
8426Contributors
8427------------
8428
8429The following people contributed notes, ideas, or patches that have
8430been incorporated in changes in this release:
8431
8432Aleksandr Koltsoff <czr@iki.fi>
8433Andi Kleen <ak@suse.de>
8434Anton Blanchard <anton@samba.org>
8435Ari Entlich <lmage11@twcny.rr.com>
8436Carsten Emde <Carsten.Emde@osadl.org>
33972b0b 8437François Diakhate <diakhate@enseirb.fr>
60aab175
MK
8438Geoff Clare <gclare@gclare.org.uk>
8439Jon Burgess <jburgess777@googlemail.com>
8440Julien Cristau <jcristau@debian.org>
8441Lee Schermerhorn <Lee.Schermerhorn@hp.com>
8442Mats Wichmann <mats.d.wichmann@intel.com>
8443Maxime Bizon <mbizon@freebox.fr>
8444Maxime Vaudequin <maxime.vaudequin@gmail.com>
8445Michael Prokop <mika@grml.org>
8446Mike Frysinger <vapier@gentoo.org>
33972b0b 8447Nicolas François <nicolas.francois@centraliens.net>
60aab175
MK
8448Nicolas George <nicolas.george@ens.fr>
8449Paul Brook <paul@nowt.org>
8450Reuben Thomas <rrt@sc3d.org>
8451Sam Varshavchik <mrsam@courier-mta.com>
8452Samuel Thibault <samuel.thibault@ens-lyon.org>
8453Thomas Huriaux <thomas.huriaux@gmail.com>
8454Tolga Dalman <tdalman@project-psi.org>
8455Ulrich Drepper <drepper@redhat.com>
8456Vincent Lefevre <vincent@vinc17.org>
8457
8458Apologies if I missed anyone!
8459
8460
8461Global changes
8462--------------
8463
8464Typographical or grammatical errors have been corrected in several
8465places.
8466
8467Various pages
8468 mtk
8469 Use 'glibc' consistently to refer to GNU C library.
8470
8471Various pages
8472 mtk
8473 Order errors under ERRORS alphabetically.
8474
8475Various pages
33972b0b 8476 Nicolas François
8fa20889 8477 Spelling and formatting fixes, as per
752cb57f 8478 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=439560
60aab175
MK
8479
8480intro.2
8481select.2
8482fmtmsg.3
8483getgrent_r.3
8484envz_add.3
8485rtime.3
8486strptime.3
8487wordexp.3
8488 Maxime Vaudequin
8489 Add "#include <stdlib.h>" (to declare exit(3)) to example program.
8490
8491
8492New pages
8493---------
8494
8495timeradd.3
8496 mtk
8497 Description of timeradd(), timersub(), timerclear(),
8498 timerisset(), timercmp() macros for operating on
8499 struct timeval.
8500
8501
8502Removed pages
8503-------------
8504
8505fdatasync.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
8515New links
8516---------
8517
8518clock_getres.2
8519clock_gettime.2
8520clock_settime.2
8521 mtk
8522 Link to man3/clock_getres.3.
8523
8524fdatasync.2
8525 mtk
8526 Link to fsync.2.
8527
8528fdopendir.3
8529 mtk
8530 Link to opendir.3.
8531
8532gethostbyaddr_r.3
8533 Mats Wichmann
8534 Link to gethostbyaddr.3.
8535
8536timerclear.3
8537timercmp.3
8538timerisset.3
8539timersub.3
8540 mtk
8fa20889 8541 Links to new timeradd.3.
60aab175
MK
8542
8543
8544Changes to individual pages
8545---------------------------
8546
8547Makefile
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
8553get_mempolicy.2
8554 Lee Schermerhorn
60aab175
MK
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
8fa20889 8568 added mmap(2) to SEE ALSO list.
60aab175
MK
8569
8570getitimer.2
8571 mtk
8fa20889
MK
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.
60aab175
MK
8574
8575gettimeofday.2
8576 mtk
8577 Replace discussion of timer* macros with a pointer
8578 to new page timeradd.3.
8579
8580ioctl_list.2
8581 Nicolas George
8582 Fixed argument type for BLKGETSIZE.
8583
8584mbind.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
8fa20889 8608 added mmap(2), shmget(2), shmat(2) to SEE ALSO list.
60aab175
MK
8609
8610mmap.2
8611mprotect.2
33972b0b 8612 François Diakhate
60aab175
MK
8613 Add text noting that PROT_WRITE may (and on x86 does)
8614 imply PROT_READ.
8fa20889 8615 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=441387
60aab175
MK
8616
8617nfsservctl.2
8618 Aleksandr Koltsoff
8619 Fix prototype.
8620
8621oldfstat.2
8622oldlstat.2
8623oldstat.2
8624 mtk
8625 Fix broken link
8626
8627prctl.2
8628 mtk
8629 Update arches/kernel versions for PR_SET_UNALAIGN / PR_GET_UNALIGN.
8630
8631readahead.2
8632 mtk
8633 Removed SEE ALSO reference to nonexistent fadvise.2.
8634
8635reboot.2
8636 mtk
8637 Place SYNOPSIS comments inside C comments (/* ... */).
8638
8639sched_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
8644sched_setscheduler.2
8645 Carsten Emde
8646 Add text on real-time features of mainline Linux kernel.
8647
f631e6d3 8648select_tut.2
60aab175
MK
8649 mtk
8650 sync SYNOPSIS with select.2
8651
8652set_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
8fa20889 8677 added mmap(2) to SEE ALSO list.
60aab175
MK
8678
8679sigaction.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
8685stat.2
8686 mtk
8687 Improve text describing underlying system calls.
8688
8689swapon.2
8690 Michael Prokop
8691 EINVAL also occurs if target path is on tmpfs or similar.
8fa20889 8692 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435885
60aab175
MK
8693
8694sync.2
8695 mtk
8696 Incorporated material from now deleted fdatasync.2.
8697
8698syscall.2
8699 mtk
8700 Small fix in example program.
8701
8702uname.2
8703 mtk
8704 Improve text describing underlying system calls.
8705
8706utime.2
8707 Vincent Lefevre / mtk
8708 Clarify utimes() behaviour when 'times' is NULL.
8fa20889 8709 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=431480
60aab175
MK
8710 mtk
8711 Other minor clarifications of description of utimes().
8712
8713copysign.3
8714 Vincent Lefevre
8715 s/sign/sign bit/ to remove ambiguity in description.
8fa20889 8716 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=435415
60aab175
MK
8717
8718euidaccess.3
8719 mtk
8720 Changed NOTES to VERSIONS.
8721
8722ffsl.3
8723 mtk
8724 Add ffsl and ffsll to NAME line.
8725
8726fts.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
8731ftw.3
8732 mtk / Geoff Clare
8733 Fixes/improvements for example program.
8734
8735getdate.3
8736 mtk
8737 Add getdate_r to NAME section.
8738
8739getaddrinfo.3
8740 mtk / Geoff Clare
8741 Fixes/improvements for example program.
8742
8743gethostbyaddr.3
8744 Mats Wichmann
8745 Add documentation for gethostbyaddr_r().
8746 Plus a few other small fixes.
8747
8748gethostbyname.3
8749 mtk
8750 Add gethostbyname2, gethostbyname2_r, gethostbyname_r,
8751 gethostent_r to NAME line.
8752
8753getmntent.3
8754 mtk
8755 Fix misnamed function references.
8756
8757getopt.3
8758 Jon Burgess
8759 Fix small error in example program.
8760
8761getrpcent.3
8762 mtk
8763 Add setrpcent and endrpcent to NAME line.
8764
8765gsignal.3
8766 Aleksandr Koltsoff
8767 Fix gsignal() prototype.
8768
8769hsearch.3
8770 mtk
8771 Add hcreate_r, hdestroy_r, hsearch_r to NAME line.
8772
8773inet.3
8774 Maxime Bizon
8775 Correct definition of "struct in_addr".
8776
8777isatty.3
8778 mtk
8779 Minor wording fix.
8780
8781isgreater.3
8782 mtk
8783 Add islessequal to NAME line.
8784
8785lgamma.3
8786 Vincent Lefevre
8787 Fix CONFORMING TO section.
8fa20889 8788 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=417592
60aab175
MK
8789
8790log1p.3
8791 mtk
8792 Add log1pf and log1pl to NAME line.
8793
8794longjmp.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
8799makecontext.3
8800 Aleksandr Koltsoff
8801 Fix makecontext() prototype.
8802
8803malloc.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
8812mq_close.3
8813mq_getattr.3
8814mq_notify.3
8815mq_open.3
8816mq_receive.3
8817mq_send.3
8818mq_unlink.3
8819 mtk
8820 Add "Link with -lrt." to SYNOPSIS.
8821
8822opendir.3
8823 Ulrich Drepper; some edits and additional text by mtk
8824 Document fdopendir().
8825
8826readdir.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
8832sem_wait.3
8833 mtk
8834 Minor improvements to example program.
8835
8836syslog.3
8837 mtk
8838 Add vsyslog to NAME section.
8839
8840termios.3
33972b0b 8841 Nicolas François
60aab175
MK
8842 Fix XCASE feature test macro description.
8843
8844wcsspn.3
8845 Aleksandr Koltsoff
8846 Add return type to prototype.
8847
8848proc.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
8886arp.7
8887 Updated BUGS text referring to jiffies; refer to time.7 instead.
8888
8889credentials.7
8890 mtk
8891 Add words to note that file system ID is Linux specific.
8892
8893hier.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:
3fb3dc3c 8900 http://www.pathname.com/fhs/pub/fhs-2.3.html#MNTMOUNTPOINTFORATEMPORARILYMOUNT
60aab175
MK
8901 - s/X-Windows/X-Window/ (3 occurrences)
8902 - section "SEE ALSO": s/mount(1)/mount(8)/
8903
8904man-pages.7
8905man.7
8906mdoc.7
8907mdoc.samples.7
33972b0b 8908 mtk / Nicolas François
60aab175
MK
8909 Nowadays tmac.XXX are called XXX.tmac.
8910
8911pthreads.7
8912 mtk
8913 Update text about modern threading implementations
8914 (NPTL vs LinuxThreads).
8915
8916socket.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
8922time.7
8923 mtk
8924 Add SEE ALSO reference to new timeradd.3.
a16f85f1
MK
8925
8926
8927==================== Changes in man-pages-2.66 ====================
8928
8929Released: 2007-10-01
8930
8931
8932Contributors
8933------------
8934
8935The following people contributed notes, ideas, or patches that have
8936been incorporated in changes in this release:
8937
8938Amit K. Arora <aarora@linux.vnet.ibm.com>
8939David Chinner <dgc@sgi.com>
8940Fredrik Noring <noring@nocrew.org>
8941Mats Wichmann <mats.d.wichmann@intel.com>
8942Maxime Vaudequin <maxime.vaudequin@gmail.com>
8943Ollie Wild <aaw@google.com>
8944Ulrich Drepper <drepper@redhat.com>
8945
8946Apologies if I missed anyone!
8947
8948
8949Global changes
8950--------------
8951
8952Typographical or grammatical errors have been corrected in several
8953places.
8954
8955
8956New pages
8957---------
8958
8959fallocate.2
8960 David Chinner, with some input from Amit Amora and mtk
8fa20889 8961 Describes the fallocate() system call, new in 2.6.23.
a16f85f1
MK
8962
8963
8964Changes to individual pages
8965---------------------------
8966
8967close.2
8968 Fredrik Noring
8969 Add text cautioning about use of close() in
8970 multithreaded programs.
8971
8972execve.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
8979open.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
8984recv.2
8985 mtk
8986 Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
8987
8988sysctl.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
8993rpc.3
8994 Mats Wichmann
8995 Fix type definition for 'protocol' in prototypes of pmap_set()
8996 and pmap_getport().
b0aca9e9
MK
8997
8998
8999==================== Changes in man-pages-2.67 ====================
9000
9001Released: 2007-10-08
9002
9003
9004Contributors
9005------------
9006
9007The following people contributed notes, ideas, or patches that have
9008been incorporated in changes in this release:
9009
9010Andi Kleen <andi@firstfloor.org>
9011Andrew Josey <a.josey@opengroup.org>
9012Maxime Vaudequin <maxime.vaudequin@gmail.com>
9013
9014Apologies if I missed anyone!
9015
9016
9017Global 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
8912c1da 9040 Change all occurrences of my email address in man-pages source
752cb57f 9041 to my new gmail address.
38f76cd2 9042
b0aca9e9
MK
9043Many 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'
1313604d
MK
9060
9061
9062==================== Changes in man-pages-2.68 ====================
9063
9064Released: 2007-11-19
9065
9066
9067Contributors
9068------------
9069
9070The following people contributed notes, ideas, or patches that have
9071been incorporated in changes in this release:
9072
9073A. Costa <agcosta@gis.net>
9074Andrew McDonald <andrew@mcdonald.org.uk>
9075Geoff Clare <gclare@gclare.org.uk>
9076Heikki Orsila <shd@modeemi.cs.tut.fi>
9077Hyokyong Kim <hyokyong@ppj.kr>
9078Ivana Varekova <varekova@redhat.com>
9079Justin Pryzby <jpryzby+d@quoininc.com>
9080Maxime Vaudequin <maxime.vaudequin@gmail.com>
9081Mike Frysinger <vapier@gentoo.org>
33972b0b
MK
9082Nicolas François <nicolas.francois@centraliens.net>
9083Pádraig Brady <P@draigBrady.com>
1313604d
MK
9084Sam Varshavchik <mrsam@courier-mta.com>
9085Timo Juhani Lindfors <timo.lindfors@iki.fi>
9086Ulrich Drepper <drepper@redhat.com>
9087
9088Apologies if I missed anyone!
9089
9090
9091Global changes
9092--------------
9093
9094faccessat.2
9095fchmodat.2
9096fchownat.2
9097fstatat.2
9098futimesat.2
9099linkat.2
9100mkdirat.2
9101mknodat.2
9102readlinkat.2
9103renameat.2
9104symlinkat.2
9105mkfifoat.3
8fa20889
MK
9106 mtk, after http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445436
9107 by Timo Juhani Lindfors
1313604d
MK
9108 Added <fcntl.h> to SYNOPSIS.
9109
9110Typographical or grammatical errors have been corrected in several places.
9111
9112
9113New 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
9122Changes to individual pages
9123---------------------------
9124
9125README
9126 mtk
9127 Brought up to date.
9128
9129man-pages-*-Announce
9130 mtk
9131 Brought the info in here up to date.
9132
9133intro.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
9139get_mempolicy.2
9140 mtk
9141 Reorder ERRORS sections alphabetically
9142
9143intro.2
9144 mtk
9145 Pretty much a complete rewrite, covering some additional topics.
9146 Moved _syscallN() material to new _syscall(2) page.
9147
9148mbind.2
9149 mtk
6516abeb 9150 Reorder ERRORS sections alphabetically
1313604d
MK
9151
9152mmap.2
9153 Maxime Vaudequin
9154 Fix syntax error in example program.
9155
9156prctl.2
9157 mtk
9158 Linux 2.6.22 added support on Alpha for PR_SET_UNALIGN.
9159
9160ptrace.2
33972b0b 9161 Nicolas François / mtk
1313604d
MK
9162 s/PTRACE_POKEUSR/PTRACE_POKEUSER/
9163 s/PTRACE_PEEKUSR/PTRACE_PEEKUSER/
9164
9165read.2
9166 mtk / Geoff Clare
9167 Add text describing timerfd EINVAL error for read(2).
9168
9169set_mempolicy.2
9170 mtk
6516abeb 9171 Reorder ERRORS sections alphabetically
1313604d
MK
9172
9173syscall.2
9174 mtk
9175 Added _syscall(2) and intro(2) to SEE ALSO section.
9176
9177syscalls.2
9178 mtk
9179 Added fallocate(2); removed timerfd(2).
9180
9181sysinfo.2
9182 mtk
9183 Removed reference to example in intro(2).
9184
9185dlopen.3
9186 mtk
9187 Added "Link with -ldl." to SYNOPSIS.
9188
9189getaddrinfo.3
cc1d6beb 9190 Ulrich Drepper / mtk
8fa20889 9191 Remove references to getipnodebyname.3 and getipnodebyaddr.3.
1313604d
MK
9192
9193gethostbyname.3
8fa20889
MK
9194 mtk / Ulrich Drepper
9195 Remove SEE ALSO references to getipnodebyname.3 and
9196 getipnodebyaddr.3.
1313604d 9197
33972b0b 9198 Pádraig Brady / mtk / Ulrich Drepper
8fa20889 9199 Point out that the functions described on this page
2337a1d3 9200 are made obsolete by getaddrinfo(3) and getnameinfo(3).
1313604d
MK
9201
9202getipnodebyname.3
9203 mtk
9204 Clarify that glibc does not implement these functions.
9205
9206glob.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
7cf05c92 9214intro.3
1313604d
MK
9215 mtk
9216 Pretty much a complete rewrite, covering some additional topics.
9217
9218posix_fallocate.3
9219 mtk
9220 Add SEE ALSO referring to fallocate.2.
9221
9222rpc.3
9223 Sam Varshavchik
2337a1d3 9224 Add some arg declarations to prototypes; fix typos.
1313604d
MK
9225
9226setbuf.3
9227 Mike Frysinger
9228 Fix text in BUGS section.
9229
9230sigset.3
9231 mtk
9232 The sigset() bugs were fixed in glibc 2.5.
8fa20889 9233 See http://sourceware.org/bugzilla/show_bug.cgi?id=1951
1313604d
MK
9234
9235intro.4
9236 mtk
9237 Minor rewrites.
9238
9239st.4
9240 Maxime Vaudequin
9241 Various small corrections, formattings and modifications.
9242
9243elf.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
9252intro.5
9253 mtk
6516abeb 9254 Minor rewrites.
1313604d
MK
9255
9256proc.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
9271slabinfo.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
9276intro.6
9277 mtk
6516abeb 9278 Minor rewrites.
1313604d
MK
9279
9280bootparam.7
9281 Maxime Vaudequin
9282 Update references to files in kernel "Documentation" directory.
9283
9284intro.7
9285 mtk
9286 Minor rewrites.
9287
9288ipv6.7
9289 Andrew McDonald
9290 Fix description of IPV6_ROUTER_ALERT option.
9291
9292standards.7
9293 mtk
9294 Note online location of C99 standard.
9295
9296intro.8
9297 mtk
7cf05c92 9298 Some rewrites, plus new paragraph on exit status values.
f0f10f07
MK
9299
9300
9301==================== Changes in man-pages-2.69 ====================
9302
9303Released: 2007-12-03
9304
9305
9306Contributors
9307------------
9308
9309The following people contributed notes, ideas, or patches that have
9310been incorporated in changes in this release:
9311
9312Adam Borowski <kilobyte@angband.pl>
7e59d51f 9313Alain Portal <aportal@univ-montp2.fr>
f0f10f07
MK
9314Andries E. Brouwer <Andries.Brouwer@cwi.nl>
9315J. Bruce Fields <bfields@citi.umich.edu>
33972b0b 9316David Härdeman <david@hardeman.nu>
f0f10f07
MK
9317Jeremy Kerr <jk@ozlabs.org>
9318Luke Browning <lukebr@linux.vnet.ibm.com>
9319Mats Wichmann <mats.d.wichmann@intel.com>
9320Maxime Vaudequin <maxime.vaudequin@gmail.com>
9321Mike Frysinger <vapier@gentoo.org>
9322Reuben Thomas <rrt@sc3d.org>
9323Sam Varshavchik <mrsam@courier-mta.com>
9324
9325Apologies if I missed anyone!
9326
9327
9328Global changes
9329--------------
9330
dc1ffd77 9331*.[013]p
f0f10f07
MK
9332 mtk
9333 Many whitespace clean-ups in formatted output.
9334
9335mprotect.2
9336bind.2
9337mq_notify.3
9338makecontext.3
9339fmemopen.3
33972b0b 9340 David Härdeman / mtk
f0f10f07
MK
9341 Rename error handling function in example program
9342 (s/die/handle_error/).
9343
9344Typographical or grammatical errors have been corrected in several places.
9345
9346
9347Removed pages
9348-------------
9349
9350HOWTOHELP
9351MAINTAINING
9352 mtk
9353 The content of these files is now available in HTML format.
9354
9355New links
9356---------
9357
9358cfsetspeed.3
9359 mtk
9360 Link to termios.3.
9361
9362
9363Changes to individual pages
9364---------------------------
9365
9366time.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
9375fcntl.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.
cc1d6beb 9380 J. Bruce Fields / mtk
f0f10f07
MK
9381 Minor wording edits.
9382 J. Bruce Fields
9383 Add F_GETLEASE under RETURN VALUE.
9384
9385mmap.2
9386 mtk
9387 Handle errors using a custom handle_error() macro.
9388
9389sched_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
9394spu_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
9402spu_run.2
9403 Jeremy Kerr
9404 Various updates and improvements.
9405 mtk
9406 Minor edits.
9407
9408err.3
9409 mtk
9410 Remove HISTORY section.
9411
9412fopen.3
9413 Mike Frysinger
9414 Document 'e' (close-on-exec) option, new in glibc 2.7.
9415
9416getloadavg.3
9417 Alain Portal / mtk
9418 Remove HISTORY section.
9419
9420printf.3
9421 Andries E. Brouwer / mtk
9422 Fix the discussion of stdarg macros in the description of
9423 vprintf() description.
9424
9425sem_wait.3
9426 mtk
9427 Handle errors using a custom handle_error() macro.
9428
9429sigsetops.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
9435termios.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
9440ttyslot.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
9446initrd.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
9451full.4
9452 mtk
9453 Re-ordered CONFIGURATION section to go before DESCRIPTION.
9454
9455sk98lin.4
9456 Maxime Vaudequin
9457 Fix reference to kernel Documentation file.
9458
9459elf.5
9460 mtk
9461 Renamed HISTORY section to NOTES, and removed BSD specific info.
9462
9463proc.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
9470utmp.5
9471 Alain Portal
8fa20889
MK
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.)
f0f10f07
MK
9475
9476iso_8859-2.7
9477 Adam Borowski
ff75a911
MK
9478 Reverse the 2.68 change applied by mtk in response to
9479 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=445085
8fa20889 9480 that replaced "Sorbian" with "Serbian".
f0f10f07
MK
9481 (Sorbian is a language of 50000 people in Brandenburg.)
9482
9483man-pages.7
9484 mtk
9485 Added CONFIGURATION to list of "standard" section names.
9486
9487spufs.7
9488 Jeremy Kerr
9489 Various updates and improvements.
9490 mtk
9491 Minor edits.
9492
9493tcp.7
9494 Maxime Vaudequin
9495 Fix reference to kernel Documentation file.
125baa35
MK
9496
9497
9498==================== Changes in man-pages-2.70 ====================
9499
9500Released: 2007-12-06
9501
9502
9503Global changes
9504--------------
9505
9506Many 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
9512Typographical or grammatical errors have been corrected in several places.
9513
9514
125baa35
MK
9515Changes to individual pages
9516---------------------------
9517
9518get_mempolicy.2
9519 mtk
9520 Add CONFORMING TO section.
9521
9522io_getevents.2
9523 mtk
9524 Remove redundant SEE ALSO entry.
9525
9526mbind.2
9527 mtk
9528 Add CONFORMING TO section.
9529
9530msgop.2
9531 mtk
9532 Remove redundant SEE ALSO entries.
9533
9534sigprocmask.2
9535 mtk
9536 Remove redundant SEE ALSO entry.
9537
9538splice.2
9539 mtk
9540 Remove redundant SEE ALSO entry.
9541 Add SEE ALSO referring to vmsplice(2).
9542
9543csin.3
9544 mtk
9545 Remove redundant SEE ALSO entry.
9546 Add SEE ALSO referring to ccos(3).
9547
9548gethostbyname.3
9549 mtk
9550 Add gethostbyaddr_r to NAME section.
9551
9552rint.3
9553 mtk
9554 Remove redundant SEE ALSO entry.
9555
9556sigsetops.3
9557 mtk
9558 Minor rewording.
9559
9560epoll.7
9561 mtk
9562 Minor rewording.
0cdf139e
MK
9563
9564
9565==================== Changes in man-pages-2.71 ====================
9566
9567Released: 2007-12-14
9568
9569
9570Contributors
9571------------
9572
9573The following people contributed notes, ideas, or patches that have
9574been incorporated in changes in this release:
9575
7e59d51f 9576Alain Portal <aportal@univ-montp2.fr>
0cdf139e
MK
9577John Sigler <linux.kernel@free.fr>
9578Josh Triplett <josh@freedesktop.org>
9579Mats Wichmann <mats.d.wichmann@intel.com>
9580Pascal MALAISE <malaise@magic.fr>
9581Sam Varshavchik <mrsam@courier-mta.com>
9582
9583Apologies if I missed anyone!
9584
9585
9586Global changes
9587--------------
9588
9589err.3
9590fts.3
9591getloadavg.3
9592queue.3
9593rcmd.3
9594rexec.3
9595stdin.3
9596elf.5
9597operator.7
9598 mtk
6bf3770e 9599 Replaced the use of mdoc macros on these pages with man
0cdf139e
MK
9600 macros. The only pages in man-pages that still use
9601 mdoc macros are mdoc.7 and mdoc.samples.7.
9602
9603Typographical or grammatical errors have been corrected in several places.
9604
9605
9606Deleted pages
9607-------------
9608
9609TODO
9610 mtk
9611 This information is now on the website.
9612
9613
9614Changes to individual pages
9615---------------------------
9616
9617Changes.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
9623fcntl.2
9624 mtk
9625 Document the F_DUPFD_CLOEXEC operation, which is
9626 new in kernel 2.6.24.
9627
9628listen.2
9629 Josh Triplett
9630 Fix incorrect path for somaxconn.
9631
9632getpw.3
9633 Alain PORTAL
9634 Add ENOENT error to ERRORS.
9635
9636sysconf.3
9637 Mats Wichmann
9638 Add documentation of _SC_NPROCESSORS_CONF and _SC_NPROCESSORS_ONLN.
9639
9640tty.4
9641 John Sigler
9642 Add tty_ioctl(4) to SEE ALSO list.
9643
9644regex.7
9645 Pascal MALAISE <malaise@magic.fr>
cf1853f4 9646 Separate text on back references from that describing basic regexps,
0cdf139e
MK
9647 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=379829.
9648 mtk
9649 Remove crufty text about word boundaries.
6b9f3d4a
MK
9650
9651
9652==================== Changes in man-pages-2.72 ====================
9653
9654Released: 2007-12-14
9655
9656
9657Contributors
9658------------
9659
9660The following people contributed notes, ideas, or patches that have
9661been incorporated in changes in this release:
9662
7e59d51f 9663Alain Portal <aportal@univ-montp2.fr>
6b9f3d4a
MK
9664Alex Tuninga <atuninga@google.com>
9665Bert Wesarg <bert.wesarg@googlemail.com>
9666Maxime Vaudequin <maxime.vaudequin@gmail.com>
9667Rob Weryk <rjweryk@uwo.ca>
9668Sam Varshavchik <mrsam@courier-mta.com>
9669
9670Apologies if I missed anyone!
9671
9672
9673Global changes
9674--------------
9675
9676Various pages
9677 Alain PORTAL / mtk
9678 Format include files consistently (".I <.*\.h>").
9679
9680Various pages
9681 Alain PORTAL / mtk
9682 Format pathname in italics (.I).
9683
9684dbopen.3
9685mpool.3
9686recno.3
9687 Alain PORTAL
9688 Remove brackets ([]) around error names.
9689
9690console.4
9691tty.4
9692ttyS.4
9693issue.5
9694ttytype.5
9695utmp.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
9701Typographical or grammatical errors have been corrected in several places.
9702
9703
9704Renamed pages
9705-------------
9706
9707filesystems.5
9708 mtk / Alain PORTAL
9709 Was previously fs.5
9710
9711
6b9f3d4a
MK
9712New links
9713---------
9714
9715argz.3
9716 Bert Wesarg / mtk
9717 Link to argz_add.3.
9718
9719envz.3
9720 Bert Wesarg / mtk
9721 Link to envz_add.3.
9722
970a069b
MK
9723fs.5
9724 mtk / Alain PORTAL
9725 Link to filesystems.5.
9726
6b9f3d4a
MK
9727
9728Changes to individual pages
9729---------------------------
9730
9731readahead.2
9732 Rob Weryk
9733 Fix declaration of 'offset' in SYNOPSIS.
9734
9735seteuid.2
9736 mtk
9737 s/SETGUID/SETEUID/ in .TH line.
9738
9739__setfpucw.3
9740 mtk
752cb57f 9741 Fixed include files references / formatting.
6b9f3d4a
MK
9742
9743abort.3
9744 mtk, after a note by Alex Tuninga
9745 A fairly significant rewrite to clarify operation of abort().
9746
9747argz_add.3
9748 Bert Wesarg / mtk
9749 s/envz/envz_add/ in SEE ALSO.
9750
9751basename.3
9752 mtk
9753 s/DIRNAME/BASENAME/ in .TH line, and swap function names
9754 in NAME section.
9755
9756envz_add.3
9757 Bert Wesarg / mtk
9758 s/argz/argz_add/ in SEE ALSO.
9759
9760flockfile.3
9761 mtk
9762 s/LOCKFILE/FLOCKFILE/ in .TH line.
9763
9764getgrent_r.3
9765 mtk
9766 s/GETGRENT/GETGRENT_R/ in .TH line.
9767
9768stdio.3
9769 Sam Varshavchik
9770 Reformat function list at end of page as a proper table.
9771
9772ttyslot.3
9773 Maxime Vaudequin
9774 Revert earlier s/getty/mingetty/. This page talks about
9775 historical behavior, and that means "getty(8)".
9776
9777undocumented.3
9778 mtk
970a069b 9779 Remove reference to "obstack stuff"; it's not clear what
6b9f3d4a
MK
9780 that is about.
9781
9782console_ioctl.4
9783 mtk
9784 s/CONSOLE_IOCTLS/CONSOLE_IOCTL/ in .TH line.
9785
9786proc.5
9787 mtk
9788 s/fs (5)/filesystems (5)/
9789
9790man-pages.7
9791 mtk / Alain PORTAL
9792 Improve discussion of formatting of file names.
8c94ec0a
MK
9793
9794
9795==================== Changes in man-pages-2.73 ====================
9796
9797Released: 2007-12-14
9798
9799
9800Contributors
9801------------
9802
9803The following people contributed notes, ideas, or patches that have
9804been incorporated in changes in this release:
9805
7e59d51f 9806Alain Portal <aportal@univ-montp2.fr>
33972b0b 9807Pádraig Brady <P@draigBrady.com>
8c94ec0a
MK
9808Reuben Thomas <rrt@sc3d.org>
9809
9810Apologies if I missed anyone!
9811
9812
9813Global changes
9814--------------
9815
9816Various pages
9817 Alain PORTAL
9818 Formatting fixes.
9819
9820Typographical or grammatical errors have been corrected in several places.
9821
9822
9823Changes to individual pages
9824---------------------------
9825
9826mknod.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
9831fgetgrent.3
9832 mtk
9833 Small rewording.
9834
9835fgetpwent.3
9836 mtk
9837 Small rewording.
9838
9839rcmd.3
9840 mtk
9841 Noted feature test macro requirements.
9842 BUGS: noted that iruserok() is not declared in glibc headers.
9843
9844filesystems.5
9845 mtk
9846 Added Reiserfs, XFS, JFS to list of file systems.
19975673
MK
9847
9848
9849==================== Changes in man-pages-2.74 ====================
9850
9851Released: 2007-12-20
9852
9853
9854Contributors
9855------------
9856
9857The following people contributed notes, ideas, or patches that have
9858been incorporated in changes in this release:
9859
7e59d51f 9860Alain Portal <aportal@univ-montp2.fr>
19975673
MK
9861Andrew Morton <akpm@linux-foundation.org>
9862David Brown <lkml@davidb.org>
9863Jeremy Kerr <jk@ozlabs.org>
9864Mats Wichmann <mats.d.wichmann@intel.com>
9865Sam Morris <sam@robots.org.uk>
9866Sam Varshavchik <mrsam@courier-mta.com>
9867Samuel Thibault <samuel.thibault@ens-lyon.org>
9868
9869Apologies if I missed anyone!
9870
9871
9872Global changes
9873--------------
9874
9875Various pages
9876 Alain PORTAL
9877 Formatting fixes.
9878
9879Various pages
9880 mtk / Alain Portal
9881 s/``...''/"..."/
9882
9883Various pages
9884 mtk
9885 s/epoch/Epoch/
9886
9887Various pages
9888 mtk
9889 Make the standard indent for code samples, shell session
9890 logs, etc. to be ".in +4n".
9891
9892Typographical or grammatical errors have been corrected in several places.
9893
9894
9895Changes to individual pages
9896---------------------------
9897
9898_syscall.2
9899 mtk
28b3a122 9900 Nowadays there is _syscall6() also.
19975673
MK
9901
9902chroot.2
9903 mtk
9904 Various minor formatting changes.
9905
9906epoll_wait.2
9907 mtk
9908 Fix types in structs.
9909 Formatting fixes.
9910
9911mount.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
9916sched_setaffinity.2
9917 mtk
9918 Minor rearrangement of text.
9919
9920select_tut.2
9921 mtk
9922 Fix (my) typos in argument names.
9923 Formatting fixes.
9924
9925spu_create.2
9926 Jeremy Kerr
9927 We can use context FDs for the dirfd argument to the *at() syscalls.
9928
9929times.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
9942getw.3
9943 Mats Wichmann
9944 CONFORMING TO: getw() and putw() were in SUSv2, but are not
9945 in POSIX.1-2001.
9946
9947hash.3
9948 mtk / Alain Portal
9949 Minor rewordings + formatting fixes.
9950
9951st.4
9952 Alain Portal / mtk
9953 Many formatting fixes.
9954 mtk
9955 Place ERRORS in alphabetical order.
9956
9957vcs.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
9965bootparam.7
9966 Alain PORTAL
9967 Formatting fixes.
9968
9969inotify.7
9970 mtk
752cb57f 9971 Minor heading changes and reformattings.
19975673
MK
9972
9973man-pages.7
9974 mtk
9975 Note that code segments, structure definitions, shell session
9976 logs, should be indented by 4 spaces.
9977
9978spufs.7
9979 Jeremy Kerr
9980 Add a little information about the differences to mbox.
d7b3cba9
MK
9981
9982
9983==================== Changes in man-pages-2.75 ====================
9984
9985Released: 2008-01-08
9986
9987
9988Contributors
9989------------
9990
9991The following people contributed notes, ideas, or patches that have
9992been incorporated in changes in this release:
9993
9994Alain Portal <aportal@univ-montp2.fr>
9995Andi Kleen <ak@suse.de>
9996Andreas Henriksson <andreas@fatal.se>
9997Jeremy Kerr <jk@ozlabs.org>
9998Justin Pryzby <jpryzby+d@quoinic.com>
9999Phil Endecott <spam_from_debian_bugs_4@chezphil.org>
10000Sam Varshavchik <mrsam@courier-mta.com>
10001Thomas Huriaux <thomas.huriaux@gmail.com>
10002Timo Sirainen <tss@iki.fi>
10003Trond Myklebust <trond.myklebust@fys.uio.no>
10004
10005Apologies if I missed anyone!
10006
10007
10008Global changes
10009--------------
10010
10011Various pages
10012 mtk
10013 (Grammatical) hyphenation was fixed in many places.
10014
ccabfaa0 10015epoll_wait.2
d7b3cba9
MK
10016mbind.2
10017spu_run.2
10018ecvt.3
10019fmtmsg.3
10020getnameinfo.3
10021rtc.4
10022proc.5
10023charsets.7
10024ip.7
10025ipv6.7
10026raw.7
10027uri.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
32fc4df2 10040 MANWIDTH=4000 man -l $a 2>/dev/null |
d7b3cba9
MK
10041 egrep '(^| )a [aeiou][a-z]'
10042 done| less
10043
10044err.3
10045fts.3
10046queue.3
10047rcmd.3
10048rexec.3
10049stdin.3
10050elf.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
10055chroot.2
10056getgid.2
10057getpid.2
10058getrusage.2
10059getsid.2
10060gettid.2
10061getuid.2
10062iopl.2
10063kill.2
10064personality.2
10065pivot_root.2
10066ptrace.2
10067sched_setparam.2
10068sched_setscheduler.2
10069sched_yield.2
10070seteuid.2
10071setgid.2
10072setpgid.2
10073setresuid.2
10074setreuid.2
10075setuid.2
10076unlink.2
10077wait.2
10078openpty.3
10079raise.3
10080setlogmask.3
10081sleep.3
10082ttyslot.3
10083ulimit.3
10084tty.4
10085tty_ioctl.4
10086path_resolution.7
10087 mtk
10088 s/current process/calling process/
10089
10090cacheflush.2
10091clone.2
10092fcntl.2
10093getitimer.2
10094getrlimit.2
10095mmap.2
10096mprotect.2
10097times.2
10098adjtime.3
10099byteorder.3
10100inet.3
10101offsetof.3
10102rtc.4
10103icmp.7
10104pipe.7
10105time.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
10112conj.3
10113cacos.3
10114cacosh.3
10115cabs.3
10116carg.3
10117casin.3
10118casinh.3
10119catan.3
10120catanh.3
10121ccos.3
10122ccosh.3
10123cexp.3
10124cimag.3
10125clog.3
10126cosh.3
10127creal.3
10128csin.3
10129csinh.3
10130ctan.3
10131ctanh.3
10132sinh.3
10133tanh.3
10134 mtk
10135 Various reformattings.
10136
10137Various pages
10138 Alain Portal
80e1913a 10139 Formatting fixes.
d7b3cba9
MK
10140
10141mlock.2
10142mprotect.2
10143mpool.3
10144offsetof.3
10145 Alain Portal
10146 Format SYNOPSIS in a manner consistent with other pages.
10147
10148Various 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
10160Various pages
10161 mtk / Alain Portal
10162 Replace "-" by "\-" where a real dash is required.
10163
10164Various 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
10175pciconfig_read.2
10176nfsservctl.2
10177bstring.3
10178cpow.3
10179getipnodebyname.3
10180getpwnam.3
10181getrpcent.3
10182lsearch.3
10183malloc_hook.3
10184mpool.3
10185stdin.3
10186strtol.3
10187strtoul.3
10188unlocked_stdio.3
10189regex.3
10190sd.4
10191resolv.conf.5
10192utmp.5
10193futex.7
10194 mtk
10195 Format SYNOPSIS consistently.
10196
10197drand48.3
10198drand48_r.3
10199flockfile.3
10200erf.3
10201sigvec.3
10202timeradd.3
10203wprintf.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
10208get_kernel_syms.2
10209getdents.2
10210getitimer.2
10211nanosleep.2
10212query_module.2
10213statvfs.2
10214clock_getres.3
10215getaddrinfo.3
10216getgrent.3
10217getipnodebyname.3
10218console_ioctl.4
10219tty_ioctl.4
10220rtnetlink.7
10221 mtk
10222 Indent structure definitions by +4n.
10223
10224recv.2
10225btree.3
10226dbopen.3
10227ether_aton.3
10228fts.3
10229hash.3
10230mpool.3
10231profil.3
10232rcmd.3
10233recno.3
10234rpc.3
10235xdr.3
10236console_ioctl.4
10237ddp.7
10238ip.7
10239ipv6.7
10240svipc.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
10253exit_group.2
10254fallocate.2
10255getdents.2
10256ioctl_list.2
10257nfsservctl.2
10258sched_setaffinity.2
10259set_tid_address.2
10260ustat.2
10261argz_add.3
10262confstr.3
10263envz_add.3
10264getline.3
10265getpwnam.3
10266gets.3
10267getw.3
10268inet_ntop.3
10269inet_pton.3
10270offsetof.3
10271console_ioctl.4
10272termcap.5
10273ascii.7
10274feature_test_macros.7
10275netlink.7
10276operator.7
10277svipc.7
28b3a122 10278 mtk
752cb57f 10279 Fix unbalanced .nf/.fi pairs.
d7b3cba9
MK
10280
10281chmod.2
10282getxattr.2
10283listxattr.2
10284lseek.2
10285removexattr.2
10286setxattr.2
10287stat.2
10288feature_test_macros.7
10289fpathconf.3
10290fopen.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
10296bindresvport.3
10297des_crypt.3
10298getopt.3
10299getrpcent.3
10300realpath.3
10301rpc.3
10302xdr.3
10303 mtk
10304 Removed .SM macros.
10305
10306madvise.2
10307getdirentries.3
10308printf.3
10309sigvec.3
10310 mtk
10311 Remove extraneous .br macro before/after .SH/.SS.
10312
10313_syscall.2
10314lookup_dcookie.2
10315aio_cancel.3
10316aio_error.3
10317aio_fsync.3
10318aio_read.3
10319aio_return.3
10320aio_write.3
10321canonicalize_file_name.3
10322envz_add.3
10323getgrouplist.3
10324getttyent.3
10325key_setsecret.3
10326mtrace.3
10327tcgetpgrp.3
10328tcgetsid.3
10329ttyslot.3
10330tty_ioctl.4
10331 mtk
10332 Remove extraneous .sp macros.
10333
10334fcntl.2
10335outb.2
10336send.2
10337syscalls.2
10338getopt.3
10339proc.5
10340man-pages.7
10341standards.7
10342tcp.7
10343 mtk
10344 Remove/replace extraneous .sp macros.
10345
10346Typographical or grammatical errors have been corrected in several places.
10347
10348
10349Changes to individual pages
10350---------------------------
10351
10352_syscall.2
10353 mtk
28b3a122 10354 Nowadays there are seven macros (see 2.74 change log also).
d7b3cba9
MK
10355
10356arch_prctl.2
10357 mtk, Acked by Andi Kleen
10358 Clarify interpretation of 'addr'; plus a few other minor edits
10359 and updates.
10360
10361bind.2
10362 mtk
10363 Minor rewrites.
10364
10365close.2
10366 mtk
10367 Clarify relationship between file descriptor and open file
10368 description.
10369
10370connect.2
10371 mtk, Acked by Andi Kleen
10372 Since kernel 2.2, AF_UNSPEC for unconnecting a connected
10373 socket *is* supported.
10374
10375execve.2
10376 Alain Portal
10377 Minor rewordings.
10378
10379futimesat.2
10380 Alain Portal
10381 Remove duplicate "#include <fcntl.h>" from SYNOPSIS.
10382
10383getgid.2
10384 mtk
10385 Add getresgid(2) and credentials(7) to SEE ALSO.
10386
10387getpagesize.2
10388 mtk
10389 Small rewording.
10390
10391getresuid.2
10392 mtk
10393 Rewrote various parts.
10394
10395getuid.2
10396 mtk
10397 Add getresuid(2) and credentials(7) to SEE ALSO.
10398
10399ioctl_list.2
10400 Alain Portal
10401 Use proper tables for layout, and various formatting fixes.
10402 mtk
10403 Various formatting fixes.
10404
10405listen.2
10406 mtk
10407 Rewrote various parts.
10408
10409mbind.2
10410 Andi Kleen / mtk / Alain Portal
10411 Modify explanation of EINVAL 'maxnode' error.
10412
10413mmap.2
10414 mtk
10415 Add comma to clarify meaning of a sentence.
10416
10417open.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
10426pipe.2
10427 mtk
10428 Rename 'filedes' argument 'pipefd'.
10429
10430pivot_root.2
10431 mtk
10432 s/cwd/current working directory/
10433
10434seteuid.2
10435 mtk
10436 Minor changes.
10437
10438setpgid.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
10443setsid.2
10444 mtk
10445 Add getsid(2) and credentials(7) to SEE ALSO.
10446
10447spu_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
10453argz_add.3
10454 mtk
10455 Formatting fixes.
10456
10457atexit.3
10458 mtk
10459 Minor changes to example program.
10460
10461cerf.3
10462 mtk
10463 These functions are still not present as at glibc 2.7.
10464
10465dbopen.3
10466 Alain Portal / mtk
10467 Various minor spelling and formatting fixes.
10468
10469envz_add.3
10470 mtk
10471 Formatting fixes.
10472
10473fexecve.3
10474 mtk
10475 Fix placement of feature test macro in SYNOPSIS.
10476
10477fmax.3
10478fmin.3
10479 mtk
10480 Small rewording.
10481
10482getline.3
10483 mtk
10484 Minor changes to example program.
10485
10486getrpcent.3
10487getrpcport.3
10488 mtk
10489 Use modern C prototypes in SYNOPSIS.
10490
10491getutent.3
10492 Alain Portal / mtk
10493 Formatting fixes.
10494
10495mbsnrtowcs.3
10496mbsrtowcs.3
10497mbstowcs.3
10498 mtk
10499 Use .IP tags to create properly formatted lists.
10500
10501rpc.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
10508xdr.3
10509 mtk
10510 Convert function declarations to use modern C prototypes.
10511 Remove crufty "int empty" from xdrrec_eof() description.
10512
10513console_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
10519console_ioctl.4
10520 mtk
10521 Formatting fixes.
10522
10523bootparam.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
10528man-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
10534posixoptions.7
10535 mtk
10536 Minor formatting and wording fixes.
10537
10538rtnetlink.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
10543signal.7
10544 mtk
10545 Minor formatting and wording fixes.
10546
10547socket.7
10548 mtk
10549 Small rewording of discussion of O_ASYNC.
10550
10551spufs.7
10552 mtk / Jeremy Kerr / Alain Portal
10553 s/SPE/SPU/
16594ce5
MK
10554
10555
10556==================== Changes in man-pages-2.76 ====================
10557
10558Released: 2008-01-14
10559
10560
10561Contributors
10562------------
10563
10564The following people contributed notes, ideas, or patches that have
10565been incorporated in changes in this release:
10566
10567Alain Portal <aportal@univ-montp2.fr>
10568Carlo Marcelo Arenas Belon <carenas@sajinet.com.pe>
10569Jeremy Kerr <jk@ozlabs.org>
10570Sam Varshavchik <mrsam@courier-mta.com>
10571Trond Myklebust <trond.myklebust@fys.uio.no>
10572
10573Apologies if I missed anyone!
10574
10575
10576Global changes
10577--------------
10578
10579longjmp.3
10580printf.3
10581scanf.3
10582setbuf.3
10583setjmp.3
10584sk98lin.4
10585environ.7
10586 mtk
10587 Rework/remove use of ".ad" macros.
10588
10589ioctl_list.2
10590mlock.2
10591mprotect.2
10592mremap.2
10593syslog.2
10594cfree.3
10595mpool.3
10596offsetof.3
10597rpc.3
10598stdin.3
10599 mtk
10600 Fix unbalanced quotes in formatting macros.
10601
10602ftok.3
10603 mtk
10604 s/i-node/inode/, for consistency with other pages and POSIX.1-2001.
10605
10606Typographical or grammatical errors have been corrected in several places.
10607
10608
10609Changes to individual pages
10610---------------------------
10611
10612chown.2
10613 mtk
10614 Minor wording change.
10615
10616dup.2
10617 mtk
10618 Reordered text in DESCRIPTION and added some details for dup2().
10619
10620open.2
10621 Trond Myklebust / mtk
10622 Minor fix to O_EXCL changes in previous release.
10623
10624gettid.2
10625 mtk
10626 Rewrote DESCRIPTION; noted that thread ID is not the same
10627 thing as a POSIX thread ID.
10628
10629pipe.2
10630 mtk
10631 Rewrote DESCRIPTION; minor additions to EXAMPLE text.
10632
10633umask.2
10634 mtk
10635 A few rewrites and additions.
10636
10637strptime.3
10638 Carlo Marcelo Arenas Belon / mtk
10639 Add "#define _XOPEN_SOURCE" to example program.
10640
10641initrd.4
10642 mtk
10643 Use quotes more consistently in formatting macros.
10644
10645random.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
10650pthreads.7
10651 mtk
10652 Minor changes.
10653
10654spufs.7
10655 mtk / Jeremy Kerr
2cac6f0b 10656 Define abbreviation "MSS".
b05c61ea
MK
10657
10658
10659==================== Changes in man-pages-2.77 ====================
10660
10661Released: 2008-01-31
10662
10663
10664Contributors
10665------------
10666
10667The following people contributed notes, ideas, or patches that have
10668been incorporated in changes in this release:
10669
10670Pavel Heimlich <tropikhajma@seznam.cz>
10671Phil Endecott <phil_vonar_endecott@chezphil.org>
10672Thomas Huriaux <thomas.huriaux@gmail.com>
10673Vincent Lefevre <vincent@vinc17.org>
10674WANG Cong <xiyou.wangcong@gmail.com>
10675
10676Apologies if I missed anyone!
10677
10678
10679Global changes
10680--------------
10681
10682stdarg.3
10683bootparam.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
10688Typographical or grammatical errors have been corrected in several places.
10689
10690New pages
10691---------
10692
10693remove_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
10702Changes to individual pages
10703---------------------------
10704
10705fcntl.2
10706 mtk
10707 Replace tables with .TP macros.
10708
10709fork.2
10710 mtk
10711 Added discussion of directory streams.
10712 Removed "#include <sys/types>" from SYNOPSIS.
10713 Changed authorship notice.
10714
10715futex.2
10716 mtk
10717 Add ENOSYS error to errors.
10718 Phil Endecott
10719 Explicitly describe return value in the event of an error.
10720
10721inotify_add_watch.2
10722 mtk
10723 Minor wording changes.
10724
10725splice.2
10726 WANG Cong
10727 Fix types for 2 and 4 arguments in splice prototype.
10728
10729wait.2
10730 Phil Endecott
10731 Clarify description of return value for WNOHANG.
10732
10733tkill.2
10734 mtk
10735 Rewrote DESCRIPTION; emphasized that tkill() is obsoleted by
10736 tgkill().
10737
10738alloca.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
10748bootparam.7
10749 Pavel Heimlich
10750 Remove junk line.
10751
10752inotify.7
10753 mtk
10754 Replace tables with .TP macros.
16594ce5 10755 s/MultiSource Synchronization/MultiSource Synchronization (MSS)/
da4a4c18
MK
10756
10757
10758==================== Changes in man-pages-2.78 ====================
10759
10760Released: 2008-02-15
10761
10762
10763Contributors
10764------------
10765
10766The following people contributed notes, ideas, or patches that have
10767been incorporated in changes in this release:
10768
10769Davide Libenzi <davidel@xmailserver.org>
10770Greg Banks <gnb@melbourne.sgi.com>
10771Michael Tokarev <mjt@tls.msk.ru>
10772Phil Endecott <phil_vonar_endecott@chezphil.org>
10773
10774Apologies if I missed anyone!
10775
10776
10777Global changes
10778--------------
10779
10780sigaction.2
10781signal.2
10782sigwaitinfo.2
10783signal.7
10784 mtk
10785 Add SEE ALSO entry referring to new signalfd.2 page.
10786
10787Typographical or grammatical errors have been corrected in several places.
10788
10789
10790New pages
10791---------
10792
10793eventfd.2
10794 mtk, with input and review from Davide Libenzi
10795 Documents the eventfd() system call, new in 2.6.22.
10796
10797signalfd.2
10798 mtk, with input and review from Davide Libenzi
10799 Documents the signalfd() system call, new in 2.6.22.
10800
10801Changes to individual pages
10802---------------------------
10803
10804futex.2
10805 mtk / Phil Endecott
10806 Improve wording describing error returns.
10807
10808open.2
10809 Greg Banks
10810 Greatly expand the detail on O_DIRECT.
10811
10812reboot.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.
87764584
MK
10820
10821
10822==================== Changes in man-pages-2.79 ====================
10823
10824Released: 2008-03-07
10825
10826
10827Contributors
10828------------
10829
10830The following people contributed notes, ideas, or patches that have
10831been incorporated in changes in this release:
10832
10833Andries E. Brouwer <Andries.Brouwer@cwi.nl>
10834Chris Heath <chris@heathens.co.nz>
10835Davide Libenzi <davidel@xmailserver.org>
33972b0b 10836Fernando Luis Vázquez Cao <fernando@oss.ntt.co.jp>
87764584
MK
10837Heikki Orsila <shdl@zakalwe.fi>
10838Jeremy Kerr <jk@ozlabs.org>
10839Justin Pryzby <justinpryzby@users.sourceforge.net>
33972b0b 10840Lasse Kärkkäinen <tronic@trn.iki.fi>
87764584
MK
10841Michael Haardt <michael@moria.de>
10842Mike Frysinger <vapier@gentoo.org>
10843Ron Burk <ronburk@gmail.com>
10844Sam Varshavchik <mrsam@courier-mta.com>
10845Samuel Thibault <samuel.thibault@ens-lyon.org>
10846Walter Harms <WHarms@bfs.de>
10847
10848Apologies if I missed anyone!
10849
10850
10851Global changes
10852--------------
10853
10854Typographical or grammatical errors have been corrected in several places.
10855
10856
10857New pages
10858---------
10859
10860timerfd_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
10866New links
10867---------
10868
10869timerfd_gettime.2
10870timerfd_settime.2
10871 mtk
10872 Links to new timerfd_create.2 page.
10873
10874eventfd_read.3
10875eventfd_write.3
10876 mtk
10877 Links to eventfd.2.
10878
10879
10880Changes to individual pages
10881---------------------------
10882
10883Makefile
10884 aeb
10885 Remove code relating to man1/README, which no longer exists.
10886
10887execve.2
10888 mtk
10889 Clarify detail of RLIMIT_STACK/4 limit for argv+environ.
10890
10891getitimer.2
10892 mtk
10893 Added SEE ALSO entry referring to timerfd_create.2.
10894
10895getrusage.2
10896 mtk
10897 Minor rewordings.
10898
10899open.2
10900 Michael Haardt
10901 Move discussion of 'mode' argument under description of O_CREAT.
10902
10903signalfd.2
10904 mtk
10905 Fix type for 'ssi_ptr' field.
10906 See http://sources.redhat.com/ml/libc-hacker/2008-01/msg00002.html.
10907
10908syscalls.2
10909 mtk
10910 Add timerfd_create(), timerfd_settime(), and timerfd_gettime()
10911 to list.
10912
10913syslog.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
10925ctime.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
10931getaddrinfo.3
10932 mtk
10933 Clarify discussion of NULL 'hints' argument; other minor rewrites.
10934 mtk / Sam Varshavchik
10935 Remove some duplicated text.
10936
10937malloc.3
33972b0b 10938 Lasse Kärkkäinen / Mike Frysinger / mtk
87764584
MK
10939 Clarify description of realloc() behavior for
10940 ((size == 0) && (ptr != NULL)).
10941
10942posix_fallocate.3
10943 Samuel Thibault
10944 s/stdlib.h/fcntl.h/ in SYNOPSIS.
10945
10946proc.5
33972b0b 10947 Fernando Luis Vázquez Cao
87764584
MK
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
10957epoll.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.
4fa455f0 10974 mtk, after comments by Davide Libenzi and Chris Heath
87764584
MK
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
10984posixoptions.7
10985 mtk
10986 Add SEE ALSO entry for standards(7).
10987
10988regex.7
10989 mtk
10990 Add grep(1) to SEE ALSO.
10991 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=348552.
10992
10993standards.7
10994 mtk
10995 Add SEE ALSO entry for posixoptions(7).
10996
10997time.7
10998 mtk
10999 Added SEE ALSO entry referring to timerfd_create.2.
e8131de3
MK
11000
11001
11002==================== Changes in man-pages-2.80 ====================
11003
11004Released: 2008-06-05
11005
11006
11007Contributors
11008------------
11009
11010The following people contributed notes, ideas, or patches that have
11011been incorporated in changes in this release:
11012
11013Adrian Bunk <bunk@kernel.org>
11014Alain Portal <aportal@univ-montp2.fr>
11015Andreas Herrmann <andreas.herrmann3@amd.com>
11016Andrew Morton <akpm@linux-foundation.org>
11017Andries E. Brouwer <Andries.Brouwer@cwi.nl>
11018Anoop <acv@linux.vnet.ibm.com>
11019Aurelien Gerome <ag@roxor.cx>
11020Daniel Burr <dburr@topcon.com>
11021Davide Libenzi <davidel@xmailserver.org>
11022Felix Kater <fkater@googlemail.com>
11023Folkert van Heusden <folkert@vanheusden.com>
09eefc1f 11024Hamaji Shinichiro <shinichiro.hamaji@gmail.com>
e8131de3
MK
11025Heikki Orsila <shd@modeemi.fi>
11026Ingo Molnar <mingo@elte.hu>
11027Justin Pryzby <justinpryzby@users.sourceforge.net>
11028Karsten Weiss <K.Weiss@science-computing.de>
11029Martin Pitt <mpitt@debian.org>
11030Marty Leisner <leisner@rochester.rr.com>
33972b0b 11031Nicolas François <nicolas.francois@trialog.com>
e8131de3
MK
11032Nick Piggin <npiggin@suse.de>
11033Petter Reinholdtsen <pere@hungry.com>
11034Reuben Thomas <rrt@sc3d.org>
11035Sam Varshavchik <mrsam@courier-mta.com>
11036Stuart Brady <sdbrady@ntlworld.com>
11037Theodoros V. Kalamatianos <thkala@softlab.ece.ntua.gr>
11038Thomas Huriaux <thomas.huriaux@gmail.com>
11039Tim Stoakes <tim@stoakes.net>
11040Timothy Baldwin <T.E.Baldwin99@members.leeds.ac.uk>
11041Tolga Dalman <tdalman@project-psi.org>
11042
11043Apologies if I missed anyone!
11044
11045
11046Global changes
11047--------------
11048
11049bdflush.2
11050inotify_add_watch.2
11051mprotect.2
11052sigprocmask.2
11053ctime.3
11054getusershell.3
11055setbuf.3
11056st.4
11057ip.7
11058packet.7
11059 mtk
11060 Replace "(il)legal" by "(not) permitted" or "(in)valid".
11061
11062read.2
11063utime.2
11064filesystems.5
11065packet.7
11066 mtk
11067 s/time stamp/timestamp/, for consistency with majority use
11068 in other pages, and in POSIX.1.
11069
11070madvise.2
11071mbind.2
11072mincore.2
11073mmap.2
11074mmap2.2
11075msync.2
11076remap_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
11084Various pages
11085 mtk
11086 s/filesystem/file system/, for consistency with majority use
11087 in other pages, and in POSIX.1.
11088
11089Various pages
11090 mtk
11091 s/zeroes/zeros/, for consistency with majority use
11092 in other pages, and in POSIX.1.
11093
11094abs.3
11095proc.5
11096 mtk
11097 s/builtin/built-in/, for consistency with majority use
11098 in other pages, and in POSIX.1.
11099
11100mknod.2
11101ftw.3
11102 mtk
11103 s/normal file/regular file/
11104
11105Various pages
11106 mtk
11107 s/nonempty/non-empty/
11108
11109Various pages
11110 mtk
11111 s/nonzero/non-zero/
11112
11113Various pages
11114 mtk
11115 s/realtime/real-time/, for consistency with majority usage.
11116
11117Various pages
11118 mtk
11119 s/command line/command-line/ when used attributively.
11120
11121Various pages
11122 mtk
11123 Use "run time" when non-attributive, "run-time" when attributive.
11124
11125Various 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
11133epoll_ctl.2
11134getitimer.2
11135getrlimit.2
11136unix.7
11137 mtk
11138 s/since kernel x.y.z/since Linux x.y.z/
11139
11140wait.2
11141inotify.7
11142 mtk
11143 Reformat kernel version information for flags.
11144
11145Typographical or grammatical errors have been corrected in several places.
33972b0b 11146(Special thanks to Nicolas François.)
e8131de3
MK
11147
11148
11149New pages
11150---------
11151
11152random_r.3
11153 mtk, after a suggestion by aeb
09eefc1f 11154 Documents random_r(3), srandom_r(3), initstate_r(3), and
e8131de3
MK
11155 setstate_r(3), which are the reentrant equivalents of
11156 random(3), srandom(3), initstate(3), and setstate(3).
11157
11158
11159New links
11160---------
11161
11162lutimes.3
11163 mtk
11164 Link to futimes.3.
11165
11166initstate_r.3
11167setstate_r.3
11168srandom_r.3
11169 mtk
11170 Links to random_r.3.
11171
11172daylight.3
11173timezone.3
11174tzname.3
11175 mtk
11176 Links to tzset.3.
11177
11178isnanf.3
11179isnanl.3
11180 mtk
11181 Links to finite.3.
11182
11183encrypt_r.3
11184setkey_r.3
11185 mtk
11186 Links to encrypt.3.
11187
11188
11189Changes to individual pages
11190---------------------------
11191
11192clone.2
11193 mtk
11194 Added note that CLONE_STOPPED (which no-one uses anyway) is
11195 now deprecated.
11196
11197epoll_create.2
11198 mtk
11199 Add NOTES section pointing out that 'size' argument is unused
11200 since kernel 2.6.8.
11201
11202epoll_ctl.2
11203 mtk
11204 Added portability note to BUGS text for EPOLL_CTL_DEL.
11205
11206epoll_wait.2
11207 mtk
11208 If the 'sigmask' is NULL, then epoll_pwait() is equivalent
11209 to epoll_wait().
11210
11211fork.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
11217futex.2
11218 mtk, after a note from Adrian Bunk
11219 FUTEX_FD has been removed, as of kernel 2.6.26.
11220
11221futimesat.2
11222 mtk
11223 Note that this system call is made obsolete by utimensat(2).
11224
11225getgroups.2
11226 Petter Reinholdtsen
11227 SEE ALSO: Add getgrouplist(3).
11228 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
28b3a122
MK
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.
e8131de3
MK
11239
11240getpriority.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
11246gettid.2
11247 mtk
11248 Added VERSIONS section noting that this system call first
11249 appeared in 2.4.11.
11250
11251kill.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
11258mbind.2
11259 mtk
11260 The location of the numactl package has changed.
11261
11262mmap.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
11274mount.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
11280msgctl.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
11287msgop.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
11293mkdir.2
11294 mtk
11295 Clarify meaning of "BSD group semantics".
11296 SEE ALSO: add chown(2).
11297
11298mknod.2
11299 mtk
11300 SEE ALSO: add chown(2) and chmod(2).
11301
11302mmap.2
11303 mtk
11304 SEE ALSO: add mprotect(2) and shmat(2).
11305
11306mprotect.2
11307 Hamaji Shinichiro
11308 SYNOPSIS: s/size_t \*len/size_t len/
11309
11310open.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
11320poll.2
11321 mtk
11322 If the 'sigmask' is NULL, then ppoll() is equivalent to poll()
11323 with respect to signal mask manipulations.
11324
11325posix_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
11331ptrace.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
11337recv.2
11338 Felix Kater / mtk
11339 Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
11340
11341rmdir.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
11346sched_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
11352select_tut.2
11353 Justin Pryzby
11354 Various wording clean-ups.
11355
11356semctl.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
11362semop.2
11363 Aurelien Gerome
11364 Small fix in example code.
11365
11366setpgid.2
11367 mtk / Karsten Weiss
11368 Clarify description of setpgid() a little.
11369
11370shmctl.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
11376shmop.2
11377 mtk, after a note from Reuben Thomas
11378 Remove "shmop" from NAME section.
11379
11380signalfd.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
11389sigqueue.2
11390 mtk
11391 Added some comments to code in NOTES.
11392
11393stat.2
11394 mtk
11395 Minor wording change.
11396
11397symlink.2
11398 mtk
11399 SEE ALSO: add lchown(2).
11400
11401sync_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
11409syscalls.2
11410 mtk
11411 This page is now up to date as at kernel 2.6.25.
11412
11413syslog.2
11414 mtk
11415 Small tidy up of language relating to permissions/capabilities.
11416
11417timerfd_create.2
11418 mtk
11419 Minor change to example program.
11420 Minor wording change.
11421
11422utime.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
11439wait.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
11445aio_cancel.3
11446aio_error.3
11447aio_fsync.3
11448aio_read.3
11449aio_return.3
11450aio_suspend.3
11451aio_write.3
11452 Kevin O'Gorman <kogorman@csc.calpoly.edu>
11453 Add "Link with -lrt" to SYNOPSIS.
11454
11455backtrace.3
33972b0b 11456 Nicolas François
e8131de3
MK
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
11462ctime.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
11469dlopen.3
11470 mtk
11471 Add more detail to the description of the fields in the
11472 structure returned by dladdr().
11473
11474fexecve.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
11479futimes.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
11488getenv.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
11496getgrent.3
11497 Petter Reinholdtsen
11498 SEE ALSO: Add getgrouplist(3).
11499 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=479284.
11500
11501gethostbyname.3
11502 mtk
11503 Add 'h_errno' to NAME list.
11504
11505getopt.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
11511getpt.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
11517getsubopt.3
11518 Daniel Burr
11519 SYNOPSIS: Fix declaration of valuep.
11520 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=476672.
11521
11522malloc.3
11523 mtk
11524 RETURN VALUE: Note circumstances in which successful malloc() and
11525 calloc() can return NULL.
11526
11527mq_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
11532opendir.3
11533 mtk
11534 Describe treatment of close-on-exec flag by opendir() and
11535 fdopendir().
11536
11537openpty.3
11538 mtk
11539 SEE ALSO: add ttyname(3).
11540
11541raise.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
11549rand.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
11556random.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
11566regex.3
11567 Heikki Orsila
11568 Clarify description of 'rm_eo' field.
11569
11570sem_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
11575sem_post.3
11576 mtk
11577 Added pointer to example in sem_wait(3).
11578
11579sem_close.3
11580sem_destroy.3
11581sem_getvalue.3
11582sem_init.3
11583sem_open.3
11584sem_post.3
11585sem_unlink.3
11586sem_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
11591setenv.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
11598shm_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
11603undocumented.3
11604 mtk
11605 initstate_r(3), setkey_r(3), setstate_r(3) are now documented.
11606
11607utmp.5
33972b0b 11608 Nicolas François
e8131de3
MK
11609 Small rewording.
11610
11611resolv.conf.5
33972b0b 11612 Nicolas François
e8131de3
MK
11613 gethostname() is in Section 2, not section 3.
11614
11615ascii.7
11616 Stuart Brady
11617 Fix rendering of ' (backtick) and apostrophe (') in tables
11618
11619charsets.7
33972b0b 11620 Nicolas François
e8131de3
MK
11621 s/unicode.com/unicode.org/
11622
11623credentials.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
11635epoll.7
11636 mtk, after a note from Sam Varshavchik
11637 For answer A2, change "not recommended" to "careful programming
11638 may be required".
11639
11640inotify.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
11649pthreads.7
11650 Justin Pryzby
11651 Grammar fix, plus fix typo in script.
11652 mtk
11653 Add list of thread-safe functions.
11654
11655standards.7
11656 mtk
11657 Add a section on the upcoming POSIX revision.
11658
11659ld.so.8
11660 Justin Pryzby / mtk
11661 Various wording improvements.
09eefc1f
MK
11662
11663
11664==================== Changes in man-pages-3.00 ====================
11665
11666Released: 2008-06-12, Konolfingen
11667
11668
11669Contributors
11670------------
11671
11672The following people contributed notes, ideas, or patches that have
11673been incorporated in changes in this release:
11674
11675Andries Brouwer <Andries.Brouwer@cwi.nl>
11676Stuart Brady <sdbrady@ntlworld.com>
11677
11678Apologies if I missed anyone!
11679
11680
11681Global changes
11682--------------
11683
11684The POSIX.1 man pages (sections 0p, 1p, 3p) have been moved out
11685of this package into the separate man-pages-posix package.
11686This made sense because those pages are seldom changed (only formatting
11687fixes, etc.) so that it was unnecessary to redistribute them with each
11688man-pages release.
11689
11690
11691console_codes.4
11692random.4
11693dir_colors.5
11694proc.5
11695glob.7
11696 Stuart Brady
11697 s/`/\`/ for backquotes used in command substitution, for
11698 proper rendering in UTF-8.
11699
11700Various 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
11712Various pages
11713 mtk
11714 Replace form /`string'/ by /"string"/, since the former renders
11715 poorly in ASCII.
11716
11717termios.3
11718console_codes.4
11719tty_ioctl.4
11720termcap.5
11721charsets.7
11722 mtk
11723 Control character names (^X) are written boldface, without
11724 quotes.
11725
11726printf.3
11727scanf.3
11728proc.5
11729glob.7
11730regex.7
11731 mtk
11732 Various edits to try and bring some consistency to the use of
11733 quotes.
11734
11735
11736Changes to individual pages
11737---------------------------
11738
11739tty_ioctl.4
11740 mtk
11741 Small rewordings in description of packet mode.
11742
11743locale.7
11744 mtk
11745 Minor formatting fixes.
419f5a4c
MK
11746
11747
11748==================== Changes in man-pages-3.01 ====================
11749
11750Released: 2008-06-25, Munich
11751
11752
11753Contributors
11754------------
11755
11756The following people contributed notes, ideas, or patches that have
11757been incorporated in changes in this release:
11758
11759Alain Portal <aportal@univ-montp2.fr>
11760Andreas Herrmann <andreas.herrmann3@amd.comm>
11761Andrew P <ap@zip.com.au>
11762Andrew Clayton <andrew@digital-domain.net>
11763Bart Van Assche <bart.vanassche@gmail.com>
11764Christian Borntraeger <borntraeger@de.ib.com>
11765Christoph Hellwig <hch@infradead.org>
11766Daniele Giacomini <appunti2@gmail.com>
11767Dorin Lazar <dorin.lazar@gmail.com>
11768George Spelvin <linux@horizon.com>
11769Jason Englander <jason@englanders.cc>
11770Jeff Moyer <jmoyer@redhat.com>
11771Laurent Vivier <laurent.vivier@bull.net>
11772Masatake YAMOTO <yamoto@redhat.com>
11773Matt Mackall <mpm@selenic.com>
11774Neil Horman <nhorman@tuxdriver.com>
11775Pavel Machek <pavel@suse.cz>
11776Peter Zijlstra <a.p.zijlstra@chello.nl>
11777Petr Baudis <pasky@suse.cz>
11778Petr Gajdos <pgajdos@suse.cz>
11779Roman Zippel <zippel@linux-m68k.org>
11780Sam Varshavchik <mrsam@courier-mta.com>
11781Samuel Thibault <samuel.thibault@ens-lyon.org>
11782Stephane Chazelas <stephane_chazelas@yahoo.fr>
11783Stuart Cunningham <stuartc@rd.bbc.co.uk>
11784Thomas Gleixner <tglx@linutronix.de>
11785Tolga Dalman <tdalman@project-psi.org>
11786Yao Zhao <dragonlinux@gmail.com>
11787WANG Cong <wcong@critical-links.com>
11788
11789Apologies if I missed anyone!
11790
11791
11792New and rewritten pages
11793-----------------------
11794
11795acct.5
11796 mtk
11797 A complete rewrite of this page, now with much more detail.
11798
11799hostname.7
11800 mtk
11801 A description of hostname resolution. Taken from FreeBSD 6.2,
11802 and lightly edited for man-pages style.
11803
11804symlink.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
11811Newly documented interfaces in existing pages
11812---------------------------------------------
11813
11814getrlimit.2
11815 mtk / Peter Zijlstra
11816 Add description of RLIMIT_RTTIME limit, new in 2.6.25.
11817
11818mkstemp.3
11819 mtk
11820 Add description of mkostemp(), new in glibc 2.7.
11821
11822core.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
11834proc.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
11865New links
11866---------
11867
11868mkostemp.3
11869 mtk
11870 Link to mkstemp.3.
11871
11872getcwd.2
11873 mtk
11874 Link to getcwd.3, which describes several interfaces, among
11875 them getcwd(), which is in fact a system call.
11876
42e2d160
MK
11877
11878Global changes
11879--------------
11880
419f5a4c
MK
11881sched_setaffinity.2
11882sched_setscheduler.2
11883set_mempolicy.2
11884mbind.2
11885 mtk
11886 SEE ALSO: Add cpuset(7).
11887
419f5a4c
MK
11888chown.2
11889faccessat.2
11890fchmodat.2
11891fchownat.2
11892fstatat.2
11893getxattr.2
11894link.2
11895linkat.2
11896listxattr.2
11897open.2
11898readlink.2
11899removexattr.2
11900rename.2
11901setxattr.2
11902stat.2
11903symlink.2
11904symlinkat.2
11905unlink.2
11906futimes.3
11907remove.3
11908path_resolution.7
11909 mtk
11910 SEE ALSO: Add symlink(7).
11911
11912intro.1
11913time.1
11914fcntl.2
11915gethostbyname.3
11916ioctl_list.2
11917 mtk
11918 Wrap source lines so that new sentence starts on new line.
11919
11920addseverity.3
11921backtrace.3
11922dlopen.3
11923fmtmsg.3
11924getnameinfo.3
11925getpt.3
11926grantpt.3
11927makecontext.3
11928ptsname.3
11929tcgetsid.3
11930unlockpt.3
11931wordexp.3
11932 mtk
11933 Added VERSIONS section.
11934
11935msgctl.2
11936msgget.2
11937semget.2
11938semop.2
11939pciconfig_read.2
11940basename.3
11941cmsg.3
11942ftok.3
11943console_ioctl.4
11944tzfile.5
11945mq_overview.7
11946pty.7
11947 mtk
11948 For consistency, "fix" cases where argument of .B or .I was
11949 on the following source line.
11950
11951adjtimex.2
11952getrusage.2
11953io_getevents.2
11954poll.2
11955select.2
11956semop.2
11957sigwaitinfo.2
11958aio_suspend.3
11959clock_getres.3
11960mq_receive.3
11961mq_send.3
11962sem_wait.3
11963proc.5
11964 mtk
11965 SEE ALSO: add time(7)
11966
11967Typographical or grammatical errors have been corrected in several places.
33972b0b 11968(Special thanks to Nicolas François and Alain Portal.)
419f5a4c
MK
11969
11970
11971Changes to individual pages
11972---------------------------
11973
11974acct.2
11975 mtk
11976 Add a few more words to DESCRIPTION.
11977 NOTES: Add pointer to acct(5).
11978
11979alarm.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
11984brk.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
12000chmod.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
12006chown.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
12012chroot.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
12018execve.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
12026getdents.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
12031getitimer.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
12039io_cancel.2
12040io_destroy.2
12041io_getevents.2
12042io_setup.2
12043io_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
12052io_getevents.2
12053 Alain Portal
12054 Small wording fix.
12055
12056io_submit.2
12057 Jeff Moyer
12058 s/AIO request blocks/AIO control blocks/
12059
12060mknod.2
12061 mtk
12062 Note that EEXIST applies, even if the pathname is a
12063 (possibly dangling) symbolic link.
12064
12065nanosleep.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
12079open.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
12085readdir.2
28b3a122 12086 mtk
419f5a4c
MK
12087 Minor wording fixes.
12088
12089recv.2
12090 Alain Portal
12091 Add comment to 'ee_pad' field in structure definition.
12092
12093sched_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
12105sync_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
12111syscalls.2
12112 mtk
12113 Added system call history back to version 1.2.
12114 Fix typo on kernel version for pivot_root().
12115
12116syslog.2
12117 WANG Cong
12118 Document ENOSYS error, which can occur if kernel was built without
12119 CONFIG_PRINTK.
12120
12121utime.2
33972b0b 12122 Nicolas François
419f5a4c
MK
12123 Clarify description of 'times' array for utimes().
12124
12125adjtime.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
12133dprintf.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
12139ftime.3
12140 mtk
12141 Rewrote various pieces, and added some details.
12142
12143getaddrinfo.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
12151gethostbyname.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
12160getmntent.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().)
3fb3dc3c 12170 See also https://lists.linux-foundation.org/pipermail/lsb-discuss/2006-October/003078.html
419f5a4c
MK
12171
12172getnameinfo.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
12179inet.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
12197inet_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
12205inet_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
12222mkfifo.3
12223 mtk
12224 Note that EEXIST applies, even if the pathname is a
12225 (possibly dangling) symbolic link.
12226
12227mkstemp.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
12234readdir.3
12235 mtk
12236 Document DT_LNK (symbolic link) for d_type field.
12237 Reorder DT_ entries alphabetically.
12238
12239remainder.3
12240 mtk
12241 Recommend against drem(), in favor of remainder().
12242
12243scanf.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
12253strcat.3
12254 Andreas Herrmann
12255 s/strcat/strncat/ (a typo that changed the semantics in
12256 DESCRIPTION).
12257
12258strerror.3
12259 mtk, after a note from Daniele Giacomini
80e1913a 12260 Modify SYNOPSIS to show prototypes of both versions of strerror_r(),
419f5a4c
MK
12261 and make other small clarifications of the description regarding
12262 the two versions.
12263
12264random.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
12271locale.5
12272 Petr Baudis <pasky@suse.cz>
12273 LC_TIME: Describe first_weekday and first_workday.
12274
12275proc.5
12276 mtk
80e1913a 12277 The various CPU time fields in /proc/stat and /proc/PID/stat
419f5a4c
MK
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
12291man-pages.7
12292 mtk
12293 Enhanced description of VERSIONS section.
12294
12295mq_overview.7
28b3a122 12296 mtk
419f5a4c
MK
12297 Note that Linux does not currently support ACLs for POSIX
12298 message queues.
12299
12300sem_overview.7
12301 mtk
12302 Note that Linux supports ACLs on POSIX named semaphores
12303 since 2.6.19.
12304
12305time.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
12313unix.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.
4f66289b
MK
12318
12319
12320==================== Changes in man-pages-3.02 ====================
12321
12322Released: 2008-07-02, Konolfingen
12323
12324
12325Contributors
12326------------
12327
12328The following people contributed notes, ideas, or patches that have
12329been incorporated in changes in this release:
12330
12331Alain Portal <aportal@univ-montp2.fr>
12332Andries Brouwer <Andries.Brouwer@cwi.nl>
12333Reuben Thomas <rrt@sc3d.org>
12334Sam Varshavchik <mrsam@courier-mta.com>
12335Stephane Chazelas <stephane_chazelas@yahoo.fr>
12336WANG Cong <xiyou.wangcong@gmail.com>
12337
12338Apologies if I missed anyone!
12339
12340
12341New and rewritten pages
12342-----------------------
12343
12344clock_nanosleep.2
12345 mtk
12346 A description of the clock_nanosleep() system call,
12347 which was added in kernel 2.6.
12348
12349getgrouplist.3
12350 mtk
12351 A near complete rewrite, including additional information and
12352 a new example program.
12353
12354getutmp.3
12355 mtk
12356 Documents getutmp(3) and getutmpx(3).
12357
12358gnu_get_libc_version.3
12359 mtk
12360 Documents gnu_get_libc_version(3) and gnu_get_libc_release(3).
12361
12362sigwait.3
12363 mtk
12364 Documents sigwait(3).
12365
12366shm_overview.7
12367 mtk
12368 An overview of the POSIX shared memory API.
12369
12370
12371Newly documented interfaces in existing pages
12372---------------------------------------------
12373
12374updwtmp.3
12375 mtk
12376 Document updwtmpx(3).
12377
12378
12379New links
12380---------
12381
12382getutmpx.3
12383 mtk
12384 Link to getutmp.3.
12385
12386gnu_get_libc_release.3
12387 mtk
12388 Link to gnu_get_libc_version.3
12389
12390updwtmpx.3
12391 mtk
12392 Link to updwtmp.3
12393
12394utmpxname.3
12395 mtk
12396 Link to getutent.3.
12397
12398utmpx.5
12399 mtk
12400 Link to utmp.5.
12401
12402
12403Global changes
12404--------------
12405
12406Various pages
12407 mtk
12408 s/user name/username/
12409
12410Various pages
12411 mtk
12412 s/host name/hostname/
12413
12414
12415Changes to individual pages
12416---------------------------
12417
12418fchmodat.2
12419 Alain Portal
12420 SEE ALSO: add symlink.7. (3.01 changelog wrongly said this
12421 had been done.)
12422
12423io_setup.2
12424 Alain Portal
12425 Remove superfluous text from RETURN VALUE.
12426
12427mmap.2
12428 mtk
12429 SEE ALSO: Add mmap(2), shm_overview(7).
12430
12431shmget.2
12432shmop.2
12433 mtk
12434 SEE ALSO: add shm_overview(7).
12435
12436sigreturn.2
12437 mtk
12438 Added a bit more detail on what sigreturn() actually does.
12439
12440signalfd.2
12441sigsuspend.2
12442 mtk
12443 SEE ALSO: Add sigwait(3).
12444
12445sigwaitinfo.2
12446 mtk
12447 Describe behavior when multiple threads are blocked in
12448 sigwaitinfo()/sigtimedwait().
12449 SEE ALSO: Add sigwait(3).
12450
12451dirfd.3
12452 mtk
12453 RETURN VALUE: describe return value on success.
12454 Add an ERRORS section documenting POSIX.1-specified errors.
12455
12456getaddrinfo.3
12457 mtk, after a note by Stephane Chazelas
12458 getaddrinfo() supports specifying IPv6 scope-IDs.
12459
12460getlogin.3
12461 mtk
12462 ERRORS: add ENOTTY.
12463 SEE ALSO: add utmp(5).
12464
12465getutent.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
12479getutent.3
12480 mtk
12481 SEE ALSO: add getutmp(3)
12482
12483inet_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
12488setbuf.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
12495shm_open.3
12496 mtk
12497 SEE ALSO: add shm_overview(7).
12498
12499random.4
12500 mtk, after a note by Alain Portal
12501 Slight rewording to make life easier for non-native English
12502 speakers.
12503
12504utmp.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
12521man-pages.7
12522 mtk
12523 Enhanced the discussion of font conventions.
12524
12525signal.7
12526 mtk
12527 Note that the delivery order of multiple pending standard
12528 signals is unspecified.
12529 SEE ALSO: Add sigwait(3).
cf2a0c4d
MK
12530
12531
12532==================== Changes in man-pages-3.03 ====================
12533
12534Released: 2008-07-08, Konolfingen
12535
12536
12537Contributors
12538------------
12539
12540The following people contributed notes, ideas, or patches that have
12541been incorporated in changes in this release:
12542
12543Alain Portal <aportal@univ-montp2.fr>
12544Andi Kleen <ak@muc.de>
12545Hidetoshi Seto <seto.hidetoshi@jp.fujitsu.com>
12546Li Zefan <lizf@cn.fujitsu.com>
12547Paul Jackson <pj@sgi.com>
12548Sam Varshavchik <mrsam@courier-mta.com>
12549
12550Apologies if I missed anyone!
12551
12552
12553New and rewritten pages
12554-----------------------
12555
12556getcpu.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
12560sched_getcpu.3
12561 mtk
12562 Documents sched_getcpu(3), a wrapper for getcpu(2), provided
12563 since glibc 2.6.
12564
12565cpuset.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
12573Newly documented interfaces in existing pages
12574---------------------------------------------
12575
12576readdir.3
12577 mtk
12578 Add documentation of readdir_r().
12579
12580
12581New links
12582---------
12583
12584updwtmpx.3
12585 Alain Portal
12586 Link to updwtmp.3 (3.02 changelog wrongly said this had been done).
12587
12588readdir_r.3
12589 mtk
12590 Link to readdir.3.
12591
12592
12593Global changes
12594--------------
12595
12596get_mempolicy.2
12597mbind.2
12598sched_setaffinity.2
12599set_mempolicy.2
12600 mtk
12601 SEE ALSO: Add getcpu(2).
12602
12603accept.2
12604close.2
12605connect.2
12606dup.2
12607epoll_wait.2
12608fcntl.2
12609flock.2
12610futex.2
12611msgop.2
12612poll.2
12613read.2
12614recv.2
12615select.2
12616semop.2
12617send.2
12618sigwaitinfo.2
12619spu_run.2
12620wait.2
12621write.2
12622aio_suspend.3
12623mq_receive.3
12624mq_send.3
12625scanf.3
12626sem_wait.3
12627usleep.3
12628inotify.7
12629 mtk
12630 ERRORS: Added reference to signal(7) in discussion of EINTR.
12631
12632Various pages
12633 mtk
12634 Wrapped very long source lines.
12635
12636
12637Changes to individual pages
12638---------------------------
12639
12640accept.2
12641 mtk
12642 Small wording change.
12643
12644io_getevents.2
12645 mtk
12646 ERRORS: Add EINTR error.
12647
12648open.2
12649 mtk
12650 ERRORS: Add EINTR error.
12651
12652sigaction.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
12664truncate.2
12665 mtk
12666 ERRORS: Added EINTR error.
12667 A few minor rewordings.
12668
12669wait.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
12674errno.3
12675 mtk
12676 Add a pointer to signal(7) for further explanation of EINTR.
12677
12678getgrouplist.3
12679 mtk
12680 SEE ALSO: Add passwd(5).
12681
12682readdir.3
12683 mtk
12684 Remove <sys/types.h> from SYNOPSIS; POSIX.1-2001 does not
12685 require it.
12686 Some minor rewordings.
12687
12688sleep.3
12689 mtk
12690 RETURN VALUE: explicitly mention interruption by signal handler.
12691 SEE ALSO: add signal(7).
12692
12693usleep.3
12694 mtk
b11cfa96 12695 POSIX.1-2001 also only documents EINVAL.
cf2a0c4d
MK
12696
12697group.5
12698 mtk
12699 SEE ALSO: Add getgrent(3), getgrnam(3).
12700
12701passwd.5
12702 mtk
12703 SEE ALSO: Add getpwent(3), getpwnam(3).
12704
12705proc.5
12706 mtk
12707 Add pointer to description of /proc/PID/cpuset in cpuset(7).
12708
12709signal.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()).
cf2aa9dd
MK
12725
12726
12727==================== Changes in man-pages-3.04 ====================
12728
12729Released: 2008-07-15, Konolfingen
12730
12731
12732Contributors
12733------------
12734
12735The following people contributed notes, ideas, or patches that have
12736been incorporated in changes in this release:
12737
12738Alain Portal <aportal@univ-montp2.fr>
12739Andrea Arcangeli <andrea@cpushare.com>
12740Andreas Mohr <andi@lisas.de>
12741Andrew Morgan <morgan@kernel.org>
12742Erik Bosman <ejbosman@cs.vu.nl>
12743John Brooks <aspecialj@gmail.com>
12744Nikanth Karthikesan <knikanth@suse.de>
12745Pavel Heimlich <tropikhajma@seznam.cz>
12746Petr Gajdos <pgajdos@suse.cz>
12747Sam Varshavchik <mrsam@courier-mta.com>
12748Serge Hallyn <serue@us.ibm.com>
12749Sripathi Kodi <sripathik@in.ibm.com>
12750Vincent Lefevre <vincent@vinc17.org>
12751
12752Apologies if I missed anyone!
12753
12754
12755Web site
12756--------
12757
12758licenses.html
12759 mtk
12760 A page describing the preferred licenses for new pages that
12761 are contributed to man-pages.
12762
12763
12764New and rewritten pages
12765-----------------------
12766
12767utimensat.2
12768 mtk
12769 New page documenting the utimensat() system call, new in 2.6.22,
12770 and futimens() library function.
12771
12772end.3
12773 mtk
12774 Documents etext, edata, and end symbols.
12775
12776
12777Newly documented interfaces in existing pages
12778---------------------------------------------
12779
12780memchr.3
12781 mtk
12782 Add description of rawmemchr().
12783
12784proc.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
12796New links
12797---------
12798
12799edata.3
12800etext.3
12801 mtk
12802 Links to end.3.
12803
12804futimens.3
12805 mtk
12806 Link to new utimensat.2.
12807
12808getdate_err.3
12809 mtk
12810 Link to getdate.3.
12811
12812h_errno.3
12813 mtk
12814 Link to gethostbyname.3.
12815
12816optarg.3
12817opterr.3
12818optind.3
12819optopt.3
12820 mtk
12821 Links to getopt.3.
12822
12823rawmemchr.3
12824 mtk
12825 Link to memchr.3.
12826
12827sys_errlist.3
12828sys_nerr.3
12829 mtk
12830 Links to perror.3.
12831
12832
12833Global changes
12834--------------
12835
12836Various pages
12837 mtk
12838 s/parameter/argument/ when talking about the things given
12839 to a function call, for consistency with majority usage.
12840
12841Various pages
12842 mtk
12843 s/UNIX/Unix/, when not used as part of a trademark,
12844 for consistency with majority usage in pages.
12845
12846Various pages
12847 mtk, after a note from Alain Portal
12848 Put SEE ALSO entries into alphabetical order.
12849
12850Various pages
12851 mtk
12852 Remove period at end of SEE ALSO list.
12853
12854Various 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
12859getpriority.2
12860MB_LEN_MAX.3
12861MB_CUR_MAX.3
12862fwide.3
12863mblen.3
12864rtime.3
12865st.4
12866proc.5
12867bootparam.7
12868man-pages.7
12869utf-8.7
12870tcp.5
12871 mtk / Alain Portal
12872 Small wording fixes -- express <=, <, >=, > in words when in
12873 running text.
12874
12875sched_setparam.2
12876sched_setscheduler.2
12877getgrent_r.3
12878hash.3
12879 mtk
12880 Minor rewording w.r.t. use of the term "parameter".
12881
12882Typographical or grammatical errors have been corrected in several
12883other places. (Many, many thanks to Alain Portal!)
12884
12885
12886Changes to individual pages
12887---------------------------
12888
12889capget.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
12894clock_nanosleep.2
12895 mtk
12896 Add "Link with -lrt" to SYNOPSIS.
12897
12898getrusage.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
12906ioprio_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
12911mount.2
12912 mtk
12913 Since Linux 2.6.26, MS_RDONLY honors bind mounts.
12914
12915openat.2
12916 mtk
12917 SEE ALSO: add utimensat(3).
12918
12919prctl.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
12953readlinkat.2
12954 John Brooks / mtk
12955 Fix and reword erroneous RETURN VALUE text.
12956
12957recv.2
12958 mtk
12959 Noted which flags appeared in Linux 2.2.
12960
12961sched_setaffinity.2
12962 mtk, after a Fedora downstream patch
12963 Update type used for cpusetsize argument in SYNOPSIS.
12964
12965select.2
12966 Andreas Mohr / mtk
12967 Clarify "zero timeout" case.
12968 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=490868.
12969
12970send.2
12971 mtk
12972 Noted which flags appeared in Linux 2.2.
12973
12974sigaction.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
12982signal.2
12983 mtk
12984 Rewrote and expanded portability discussion.
12985 NOTES: Show the raw prototype of signal() (without use of
12986 sighandler_t).
12987
12988signalfd.2
12989 mtk
12990 Modify description of ssi_trapno field.
12991
12992swapon.2
12993 mtk
12994 Fix two version number typos for MAX_SWAPFILES discussion:
12995 s/2.6.10/2.4.10/
12996
12997utime.2
12998 mtk
12999 SEE ALSO: add utimensat(2), futimens(3).
13000
13001dl_iterate_phdr.3
13002 Alain Portal
13003 SEE ALSO: Add elf(5).
13004
13005crypt.3
13006 mtk, after a Fedora downstream patch
13007 Describe additional encryption algorithms.
c20fd28b 13008 See also: https://bugzilla.redhat.com/show_bug.cgi?id=428280.
cf2aa9dd
MK
13009
13010errno.3
13011 mtk
13012 Small rewrites in DESCRIPTION.
13013
13014exec.3
13015 mtk, after a note from Alain Portal
13016 Small rewording.
13017
13018exp10.3
13019 Alain Portal
13020 SEE ALSO: Add log10(3).
13021
13022exp2.3
13023 Alain Portal
13024 Add C99 to CONFORMING TO.
13025
13026fgetgrent.3
13027 Alain Portal
13028 Add references to group(5).
13029 mtk
13030 Minor rewordings.
13031 SEE ALSO: add fopen(3).
13032
13033fgetpwent.3
13034 Alain Portal
13035 Add reference to passwd(5).
13036 mtk
13037 Minor rewordings.
13038 SEE ALSO: add fopen(3).
13039
13040frexp.3
13041 Alain Portal
13042 Add C99 to CONFORMING TO.
13043
13044futimes.3
13045 mtk
13046 SEE ALSO: remove futimesat(2); add utimensat(2).
13047
13048getopt.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
13058getspnam.3
13059 mtk
13060 Improve comments on struct spwd.
13061
13062getpw.3
13063 Alain Portal
13064 RETURN VALUE: note that errno is set on error.
13065 mtk
13066 Add EINVAL error.
13067
13068insque.3
13069 mtk / Alain Portal
13070 Minor rewordings.
13071
13072log.3
13073 Alain Portal
13074 Remove unnecessary sentence in ERRORS.
13075
13076log10.3
13077 mtk
13078 SEE ALSO: Add exp10(3).
13079
13080offsetof.3
13081 Alain Portal
13082 Small wording improvement.
13083
13084pow.3
13085 Alain Portal
13086 Remove unnecessary sentence in ERRORS.
13087
13088printf.3
13089 mtk / Alain Portal
13090 Many small formatting fixes.
13091
13092proc.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
13101profil.3
13102 mtk / Alain Portal
13103 Small wording improvement.
13104
13105rtime.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
13112scanf.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
13120stdin.3
13121 Alain Portal
13122 Rename CONSIDERATIONS section to NOTES, and relocate
13123 to appropriate place on page.
13124
13125tmpfile.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
13131ttyname.3
13132 Alain Portal
13133 Remove unnecessary sentence in ERRORS.
13134
13135wcsdup.3
13136 Alain Portal
13137 Make wording more precise: the memory allocated by wcsdup(3)
13138 *should* be freed with free(3).
13139
13140wordexp.3
13141 Alain Portal / mtk
13142 Move example into proper EXAMPLE section.
13143
13144tty_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
13149capabilities.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
13178man-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
13185tcp.7
13186 mtk
13187 Correct a detail for sysctl_tcp_adv_win_scale.
13188 Formatting fixes.
f5e56b01
MK
13189
13190
13191==================== Changes in man-pages-3.05 ====================
13192
13193Released: 2008-07-23, Konolfingen
13194
13195
13196Contributors
13197------------
13198
13199The following people contributed notes, ideas, or patches that have
13200been incorporated in changes in this release:
13201
13202Alain Portal <aportal@univ-montp2.fr>
13203Andries Brouwer <Andries.Brouwer@cwi.nl>
13204Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
13205Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13206Franck Jousseaume <franck.jousseaume@gmail.com>
13207Sam Varshavchik <mrsam@courier-mta.com>
13208Uli Schlacter <psychon@znc.in>
13209
13210Apologies if I missed anyone!
13211
13212
13213New and rewritten pages
13214-----------------------
13215
13216matherr.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
13222math_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
13228Global changes
13229--------------
13230
13231Various pages
13232 mtk
13233 s/floating point/floating-point/ when used attributively.
13234
13235Various pages
13236 mtk
13237 For consistency with majority usage:
13238 s/plus infinity/positive infinity/
13239 s/minus infinity/negative infinity/
13240
13241Typographical or grammatical errors have been corrected in several
13242other places.
13243
13244
13245Changes to individual pages
13246---------------------------
13247
13248brk.2
13249 mtk
13250 SEE ALSO: add end(3).
13251
13252open.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
13257prctl.2
13258 mtk
13259 Place options in some semblance of alphabetical order.
13260 (No content or formatting changes were made.)
13261
13262cerf.3
13263 mtk
13264 Bump version number: these functions are still missing in
13265 glibc 2.8.
13266
13267fenv.3
13268 mtk
13269 SEE ALSO: Add math_error(7).
13270
13271INFINITY.3
13272 mtk
13273 SEE ALSO: Add math_error(7).
13274
13275nan.3
13276 mtk
13277 Remove unneeded "Compile with" piece in SYNOPSIS.
13278 SEE ALSO: Add math_error(7).
13279
13280rpc.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
f183f968 13285ipv6.7
f5e56b01
MK
13286 mtk, after a report from Uli Schlacter
13287 Document the IPV6_V6ONLY flag.
6d8531b1
MK
13288
13289
13290==================== Changes in man-pages-3.06 ====================
13291
13292Released: 2008-08-05, Konolfingen
13293
13294
13295Contributors
13296------------
13297
13298The following people contributed notes, ideas, or patches that have
13299been incorporated in changes in this release:
13300
13301Andreas Jaeger <aj@novell.com>
13302Andries Brouwer <Andries.Brouwer@cwi.nl>
c0d9e15a 13303Fabian Kreutz <kreutz@dbs.uni-hannover.de>
6d8531b1
MK
13304Gernot Tenchio <g.tenchio@telco-tech.de>
13305Sam Varshavchik <mrsam@courier-mta.com>
13306Tolga Dalman <tdalman@project-psi.org>
13307
13308Apologies if I missed anyone!
13309
13310
13311New and rewritten pages
13312-----------------------
13313
13314erfc.3
13315 mtk
13316 Created after removing the erfc() material from erf.3.
13317 Documents the complementary error function.
13318
13319y0.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
13332scalbln.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
13340New and changed links
13341---------------------
13342
13343erfcf.3
13344erfcl.3
13345 mtk
13346 Changed these links to point to new erfc.3 page.
13347
13348scalblnf.3
13349scalblnl.3
13350scalbn.3
13351scalbnf.3
13352scalbnl.3
13353 mtk
13354 Changed these links to point to new scalbln.3 page.
13355
13356y0f.3
13357y0l.3
13358y1.3
13359y1f.3
13360y1l.3
13361yn.3
13362ynf.3
13363ynl.3
13364 mtk
13365 Changed these links to point to new y0.3 page.
13366
13367
13368Global changes
13369--------------
13370
13371Various pages
13372 mtk
13373 s/floating point/floating-point/ when used attributively.
13374
13375Typographical or grammatical errors have been corrected in several
13376other places.
13377
13378
13379Changes to individual pages
13380---------------------------
13381
13382crypt.3
13383 mtk
13384 Tweak discuss text describing support for Blowfish.
13385
13386ctime.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
13391math_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
13399Changes to individual pages (math functions)
13400--------------------------------------------
13401
13402Almost all of the changes in this release relate to math man pages.
13403Very 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
dd4772e2 13407 different from the requirements for the "double" version. Each math
6d8531b1
MK
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
13444acos.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
13451acosh.3
13452 mtk
13453 SYNOPSIS: Fixed feature test macro requirements.
13454 Added RETURN VALUE section.
13455 Rewrote ERRORS section.
13456 Updated CONFORMING TO.
13457
13458asin.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
13465asinh.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
13473atan.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
13481atan2.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
13489atanh.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
13499cbrt.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
13506ceil.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
13515copysign.3
13516 mtk
13517 Added RETURN VALUE section.
13518 Updated CONFORMING TO.
13519
13520cos.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
13528cosh.3
13529 mtk
13530 SYNOPSIS: Added feature test macro requirements.
13531 Added RETURN VALUE section.
13532 Added ERRORS section.
13533 Updated CONFORMING TO.
13534
13535erf.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
13547exp.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
13555exp10.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
13562exp2.3
13563 mtk
13564 Added RETURN VALUE and ERRORS sections.
13565 Updated CONFORMING TO.
13566
13567expm1.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
13579fabs.3
13580 mtk
13581 SYNOPSIS: Added feature test macro requirements.
13582 Added RETURN VALUE section.
13583 Updated CONFORMING TO.
13584
13585fdim.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
13594fenv.3
13595 mtk
13596 Make style of writing exception names consistent with other
13597 pages and POSIX.1-2001.
13598 Updated CONFORMING TO.
13599
13600finite.3
13601 mtk
13602 SYNOPSIS: Fixed feature test macro requirements.
13603
13604floor.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
13612fma.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
13621fmax.3
13622fmin.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
13630fmod.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
13638fpclassify.3
13639 mtk
13640 Minor wording changes.
13641 CONFORMING TO: Added POSIX.1-2001.
13642 SEE ALSO: Add signbit(3).
13643
13644frexp.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
13651gamma.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
13658hypot.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
13668ilogb.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
13677isgreater.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
13685j0.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
13694ldexp.3
13695 mtk
13696 SYNOPSIS: Added feature test macro requirements.
13697 Added RETURN VALUE and ERRORS sections.
13698 Updated CONFORMING TO.
13699
13700lgamma.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
13709log.3
13710 mtk
13711 SYNOPSIS: Added feature test macro requirements.
13712 Added RETURN VALUE section.
13713 Rewrote ERRORS section.
13714 Updated CONFORMING TO.
13715
13716log10.3
13717 mtk
13718 SYNOPSIS: Added feature test macro requirements.
13719 Added RETURN VALUE section.
13720 Rewrote ERRORS section.
13721 Updated CONFORMING TO.
13722
13723log1p.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
13731log2.3
13732 mtk
13733 Added RETURN VALUE section.
13734 Rewrote ERRORS section.
13735 Updated CONFORMING TO.
13736
13737logb.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
13746lrint.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
13754lround.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
13761modf.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
13768nan.3
13769 mtk
13770 Small wording changes.
13771 CONFORMING TO: Added POSIX.1-2001.
13772
13773nextafter.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
13781pow.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
13791remainder.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
13803remquo.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
13810fmax.3
13811fmin.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
13819fmod.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
13827fpclassify.3
13828 CONFORMING TO: Added POSIX.1-2001.
13829
13830rint.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
13839round.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
13847scalb.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
13861signbit.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
13869sin.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
13877sincos.3
13878 mtk
13879 DESCRIPTION: Added details for special argument cases.
13880 Added (null) RETURN VALUE section.
13881 Added ERRORS section.
13882
13883sinh.3
13884 mtk
13885 SYNOPSIS: Added feature test macro requirements.
13886 Added RETURN VALUE section.
13887 Added ERRORS section.
13888 Updated CONFORMING TO.
13889
13890sqrt.3
13891 mtk
13892 SYNOPSIS: Added feature test macro requirements.
13893 Added RETURN VALUE section.
13894 Rewrote ERRORS section.
13895 Updated CONFORMING TO.
13896
13897tan.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
13906tanh.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
13913tgamma.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
13923trunc.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.
ed2d26a8
MK
13929
13930
13931==================== Changes in man-pages-3.07 ====================
13932
13933Released: 2008-08-12, Konolfingen
13934
13935
13936Contributors
13937------------
13938
13939The following people contributed notes, ideas, or patches that have
13940been incorporated in changes in this release:
13941
13942Alain Portal <aportal@univ-montp2.fr>
13943Andries Brouwer <Andries.Brouwer@cwi.nl>
13944Christoph Lameter <cl@linux-foundation.org>
13945Cliff Wickman <cpw@sgi.com>
13946Fabian Kreutz <kreutz@dbs.uni-hannover.de>
13947Filippo Santovito <filippo.santovito@email.it>
13948Gerrit Renker <gerrit@erg.abdn.ac.uk>
13949Heikki Orsila <shd@modeemi.cs.tut.fi>
13950Khalil GHORBAL <khalil.ghorbal@cea.fr>
13951Lee Schermerhorn <lee.schermerhorn@hp.com>
13952Maxin John <maxin.john@gmail.com>
13953Reuben Thomas <rrt@sc3d.org>
13954Samuel Thibault <samuel.thibault@ens-lyon.org>
13955Sam Varshavchik <mrsam@courier-mta.com>
13956Soh Kam Yung <sohkamyung@gmail.com>
13957Stephane Chazelas <stephane_chazelas@yahoo.fr>
13958Pavel Heimlich <tropikhajma@seznam.cz>
13959Reuben Thomas <rrt@sc3d.org>
13960
13961Apologies if I missed anyone!
13962
13963
13964New and rewritten pages
13965-----------------------
13966
13967move_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
13973clock_getcpuclockid.3
13974 mtk
13975 New page documenting the clock_getcpuclockid() library function,
13976 available since glibc 2.2.
13977
13978udplite.7
13979 Gerrit Renker
13980 Document the Linux implementation of the UDP-Lite protocol,
13981 new in Linux 2.6.20.
13982
13983
13984Newly documented interfaces in existing pages
13985---------------------------------------------
13986
13987proc.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
13995Global changes
13996--------------
13997
13998nanosleep.2
13999inet_ntop.3
14000inet_pton.3
14001scanf.3
14002initrd.4
14003 mtk
14004 Fix mis-ordered (.SH) sections.
14005
14006connect.2
14007socket.2
14008rtnetlink.3
14009arp.7
14010ddp.7
14011ip.7
14012ipv6.7
14013netlink.7
14014packet.7
14015raw.7
14016rtnetlink.7
14017socket.7
14018tcp.7
14019udp.7
14020unix.7
14021x25.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
14028Typographical or grammatical errors have been corrected in several
14029other places.
14030
14031
14032Changes to individual pages
14033---------------------------
14034
14035execve.2
14036 mtk
14037 The floating-point environment is reset to the default
14038 during an execve().
14039
ed2d26a8
MK
14040get_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
2a4c23e2
MK
14055getitimer.2
14056 mtk
14057 CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
14058 obsolete.
14059
ed2d26a8
MK
14060mbind.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
14075mprotect.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
14081msgctl.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
14086set_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
14108setpgid.2
14109 mtk
14110 CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
14111
14112semctl.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
14117shmctl.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
14122utime.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
14129vfork.2
14130 mtk
14131 CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
14132
14133atan2.3
14134 Fabian Kreutz
14135 SEE ALSO Add carg(3).
14136
14137bcmp.3
14138 mtk
14139 CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
14140
14141bsd_signal.3
14142 mtk
14143 CONFORMING TO: POSIX.1-2008 removes the specification ofcw
14144 bsd_signal().
14145
14146bzero.3
14147 mtk
14148 CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
14149
14150cexp2.3
14151 mtk
14152 AVAILABILITY: These functions are still not in glibc
14153 as at version 2.8.
14154
14155clock_getres.3
14156 mtk
14157 SEE ALSO: Add clock_getcpuclockid(3).
14158
14159clog2.3
14160 mtk
14161 AVAILABILITY: These functions are still not in glibc
14162 as at version 2.8.
14163
14164ctime.3
14165 mtk
14166 POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
14167 as obsolete.
14168
14169dprintf.3
14170 mtk
14171 CONFORMING TO: These functions are nowadays in POSIX.1-2008.
14172
14173ecvt.3
14174 mtk
14175 CONFORMING TO: POSIX.1-2008 removes the specifications of
14176 ecvt() and fcvt().
14177
14178ftime.3
14179 mtk
14180 CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
14181
14182ftw.3
14183 mtk
14184 CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
14185
14186gcvt.3
14187 mtk
14188 CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
14189
14190getcwd.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
14208gethostbyname.3
14209 mtk
14210 CONFORMING TO: POSIX.1-2008 removes the specifications of
14211 gethostbyname(), gethostbyaddr(), and h_errno.
14212
14213gets.3
14214 mtk
14215 CONFORMING TO: POSIX.1-2008 removes the specification of gets().
14216
14217iconv.3
14218iconv_close.3
14219iconv_open.3
14220 mtk
14221 VERSIONS: These functions are available in glibc since version 2.1.
14222
14223index.3
14224 mtk
14225 CONFORMING TO: POSIX.1-2008 removes the specifications of
14226 index() and rindex().
14227
14228isalpha.3
14229 mtk
14230 CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
14231
14232makecontext.3
14233 mtk
14234 CONFORMING TO: POSIX.1-2008 removes the specifications of
14235 makecontext() and swapcontext().
14236
14237memchr.3
14238 mtk
14239 VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
14240
14241mempcpy.3
14242 mtk
14243 VERSIONS: mempcpy() since glibc 2.1.
14244
14245mktemp.3
14246 mtk
14247 CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
14248
14249opendir.3
14250 mtk
14251 CONFORMING TO: POSIX.1-2008 specifies fdopendir().
14252
14253rand.3
14254 mtk
14255 CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
14256
14257siginterrupt.3
14258 mtk
14259 CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
14260
14261sigset.3
14262 mtk
14263 CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
14264 sigpause(), sigrelse(), and sigset() as obsolete.
14265
14266strchr.3
14267 mtk
14268 VERSIONS: strchrnul() since glibc 2.1.1.
14269
14270tempnam.3
14271 mtk
14272 CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
14273
14274tmpnam.3
14275 mtk
14276 CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
14277
14278toascii.3
14279 mtk
14280 CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
14281
14282ualarm.3
14283 mtk
14284 CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
14285
14286ulimit.3
14287 mtk
14288 CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
14289
14290usleep.3
14291 mtk
14292 CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
14293
14294standards.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
14301time.7
14302 mtk
14303 SEE ALSO: Add clock_getcpuclockid(3).
14304
14305udp.7
14306 mtk
14307 SEE ALSO: add udplite(7).
14308
14309
14310Changes to individual pages (math functions)
14311--------------------------------------------
14312
14313Various changes here following on from the big update to the
14314math pages in the previous release. Test results going back
14315glibc 2.3.2 (so far) allowed updates to various pages to note
14316changes in historical behavior for error reporting by math
14317functions. Thanks to the following people for providing me
14318with test results on various distributions and glibc versions:
14319Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
14320Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
14321Soh Kam Yung, and Stephane Chazelas
14322
14323cabs.3
14324cacos.3
14325cacosh.3
14326carg.3
14327casin.3
14328casinh.3
14329catan.3
14330catanh.3
14331ccos.3
14332ccosh.3
14333cexp.3
14334cimag.3
14335clog.3
14336clog10.3
14337conj.3
14338cpow.3
14339cproj.3
14340creal.3
14341csin.3
14342csinh.3
14343csqrt.3
14344ctan.3
14345ctanh.3
14346exp10.3
14347exp2.3
14348fdim.3
14349fenv.3
14350fma.3
14351fmax.3
14352fmin.3
14353log2.3
14354lrint.3
14355lround.3
14356nan.3
14357pow10.3
14358remquo.3
14359round.3
14360scalbln.3
14361sincos.3
14362tgamma.3
14363trunc.3
14364 mtk
14365 Added VERSIONS section noting that these functions first
14366 appeared in glibc in version 2.1.
14367
14368cosh.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
14373fenv.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
14380fma.3
14381 mtk
14382 Remove text about FLT_ROUNDS, replacing with a cross-reference
14383 to fenv(3).
14384
14385fpclassify.3
14386 mtk
14387 CONFORMING TO: Note that the standards provide a weaker guarantee
14388 for the return value of isinf().
14389
14390log.3
14391 mtk
14392 BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
14393 FE_INVALID exception.
14394
14395lround.3
14396 mtk
14397 Add reference to fenv(3) for discussion of current rounding mode.
14398
14399nextafter.3
14400 mtk
14401 BUGS: In glibc 2.5 and earlier these functions do not raise an
14402 FE_UNDERFLOW exception on underflow.
14403
14404pow.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
14411remainder.3
14412 mtk
14413 Add reference to fenv(3) for discussion of current rounding mode.
14414
14415round.3
14416 mtk
14417 Add reference to fenv(3) for discussion of current rounding mode.
14418
14419scalb.3
14420 mtk
14421 CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
14422
14423tgamma.3
14424 mtk
14425 BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
14426 instead of a pole error.
14427
14428y0.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
14433math_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.
c624eb7d
MK
14438
14439
14440==================== Changes in man-pages-3.08 ====================
14441
14442Released: 2008-08-27, Zurich
14443
14444
14445Contributors
14446------------
14447
14448The following people contributed notes, ideas, or patches that have
14449been incorporated in changes in this release:
14450
14451Gerrit Renker <gerrit@erg.abdn.ac.uk>
14452Li Zefan <lizf@cn.fujitsu.com>
14453Mike Bianchi <MBianchi@foveal.com>
14454Sam Varshavchik <mrsam@courier-mta.com>
14455Venkatesh Srinivas <me@acm.jhu.edu>
14456Vijay Kumar <vijaykumar@bravegnu.org>
14457
14458Apologies if I missed anyone!
14459
14460
14461New and rewritten pages
14462-----------------------
14463
14464getnetent_r.3
14465 mtk
14466 Documents getnetent_r(), getnetbyname_r(),
14467 and getnetbyaddr_r(), the reentrant equivalents of
14468 getnetent(), getnetbyname(), and getnetbyaddr().
14469
14470getprotoent_r.3
14471 mtk
14472 Documents getprotoent_r(), getprotobyname_r(), and
14473 getprotobynumber_r(), the reentrant equivalents of
14474 getprotoent(), getprotobyname(), and getprotobynumber().
14475
14476getrpcent_r.3
14477 mtk
14478 Documents getrpcent_r(), getrpcbyname_r(), and
14479 getrpcbynumber_r(), the reentrant equivalents of
14480 getrpcent(), getrpcbyname(), and getrpcbynumber().
14481
14482getservent_r.3
14483 mtk
14484 Documents getservent_r(), getservbyname_r(), and
14485 getservbyport_r(), the reentrant equivalents of
14486 getservent(), getservbyname(), and getservbyport().
14487
14488numa.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
14495Newly documented interfaces in existing pages
14496---------------------------------------------
14497
14498crypt.3
14499 mtk
14500 Add description of crypt_r().
14501
14502
14503New and changed links
14504---------------------
14505
14506crypt.3
14507 mtk
14508 New link to crypt.3.
14509
14510getnetbyname_r.3
14511getnetbyaddr_r.3
14512 mtk
14513 New links to new getnetent_r.3.
14514
14515getprotobyname_r.3
14516getprotobynumber_r.3
14517 mtk
14518 New links to new getprotoent_r.3.
14519
14520getrpcbyname_r.3
14521getrpcbynumber_r.3
14522 mtk
14523 New links to new getrpcent_r.3.
14524
14525getservbyname_r.3
14526getservbyport_r.3
14527 mtk
14528 New links to new getservent_r.3.
14529
14530numa_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
14540Global changes
14541--------------
14542
14543get_mempolicy.2
14544mbind.2
14545move_pages.2
14546set_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
14552faccessat.2
14553fchmodat.2
14554fchownat.2
14555fstatat.2
14556mkdirat.2
14557mknodat.2
14558linkat.2
14559openat.2
14560readlinkat.2
14561renameat.2
14562symlinkat.2
14563unlinkat.2
14564mkfifoat.3
14565psignal.3
14566strsignal.3
14567 mtk
14568 These interfaces are specified in POSIX.1-2008.
14569
14570
14571Changes to individual pages
14572---------------------------
14573
14574eventfd.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
14579fcntl.2
14580 mtk
14581 F_DUPFD_CLOEXEC is specified in POSIX.1-2008.
14582
14583getrlimit.2
14584 mtk
ae7a272c 14585 NOTES: Add text mentioning the shell 'ulimit' (or 'limit')
c624eb7d
MK
14586 built-in command for setting resource limits.
14587
14588gettimeofday.2
14589 mtk
14590 CONFORMING TO: POSIX.1-2008 marks gettimeofday() as obsolete.
14591
14592link.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
14601mbind.2
14602 mtk
14603 Remove material on library support and numactl; that material
14604 is now in numactl.7.
14605
14606mmap.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
14611move_pages.2
14612 mtk
14613 Added VERSIONS (from kernel 2.6.18) and CONFORMING TO sections.
14614
14615open.2
14616 mtk
14617 O_CLOEXEC is specified in POSIX.1-2008.
14618
14619socket.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
14625utimensat.2
14626 mtk
14627 CONFORMING TO: POSIX.1-2008 specifies utimensat() and futimens().
14628
14629dirfd.3
14630 mtk
14631 CONFORMING TO: Add POSIX.1-2008; other minor changes.
14632
14633exec.3
14634 mtk
14635 Small rewording: "s/returned/failed with/ [an error]".
14636
14637fmemopen.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
14643gethostbyname.3
14644 mtk
14645 Clarify exactly which functions are obsoleted by getnameinfo()
14646 and getaddrinfo().
14647
14648getnetent.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
14666getprotoent.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
14679getrpcent.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
14691getservent.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
14704mkdtemp.3
14705 mtk
14706 CONFORMING TO: this function is specified in POSIX.1-2008.
14707
14708mq_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
14713realpath.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
14720sem_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
14725core.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
14734proc.5
14735 mtk
14736 Remove /proc/PID/numa_maps material (it is now in numa(7)).
14737
14738cpuset.7
14739 mtk
14740 SEE ALSO: Add numa(7).
14741
14742inotify.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
14749pthreads.7
14750 mtk
14751 Update thread-safe functions list with changes in POSIX.1-2008.
14752 SEE ALSO: add proc(5).
14753
14754signal.7
14755 mtk
0743fbda 14756 Update list of async-signal-safe functions for POSIX.1-2008.
5071e2eb
MK
14757
14758
14759==================== Changes in man-pages-3.09 ====================
14760
14761Released: 2008-09-10, Munich
14762
14763
14764Contributors
14765------------
14766
14767The following people contributed notes, ideas, or patches that have
14768been incorporated in changes in this release:
14769
14770Bernd Eckenfels <be-mail2006@lina.inka.de>
14771Bruno Haible <bruno@clisp.org>
14772Carsten Emde <Carsten.Emde@osadl.org>
14773Christopher Head <chead@telus.net>
14774H. Peter Anvin <hpa@zytor.com>
14775Jan Engelhardt <jengelh@medozas.de>
14776Joe Korty <joe.korty@ccur.com>
14777Marko Kreen <markokr@gmail.com>
14778Martin (Joey) Schulze <joey@infodrom.org>
14779Mats Wichmann <mats.d.wichmann@intel.com>
14780Michael Schurter <michael@susens-schurter.com>
14781Mike Bianchi <MBianchi@foveal.com>
14782Mike Frysinger <vapier@gentoo.org>
14783Sam Varshavchik <mrsam@courier-mta.com>
14784Suka <sukadev@us.ibm.com>
14785Timothy S. Nelson <wayland@wayland.id.au>
14786Tolga Dalman <tdalman@project-psi.org>
33972b0b 14787Török Edwin <edwintorok@gmail.com>
5071e2eb
MK
14788
14789Apologies if I missed anyone!
14790
14791
14792New and rewritten pages
14793-----------------------
14794
14795fopencookie.3
14796 mtk
14797 Document fopencookie(3), a library function that allows
14798 custom implementation of a stdio stream.
14799
14800networks.5
14801 Martin (Joey) Schulze, with a few light edits by mtk
14802 Documents the /etc/networks file.
14803
14804
14805Global changes
14806--------------
14807
14808Various pages
14809 mtk
14810 s/time zone/timezone/ for consistency across pages and
14811 with POSIX.1.
14812
14813kill.2
14814sigaction.2
14815sigpending.2
14816sigprocmask.2
14817sigsuspend.2
14818confstr.3
14819ctermid.3
14820ctime.3
14821ferror.3
14822flockfile.3
14823fopen.3
14824getaddrinfo.3
14825getgrnam.3
14826getnameinfo.3
14827getopt.3
14828getpwnam.3
14829longjmp.3
14830popen.3
14831rand.3
14832readdir.3
14833setjmp.3
14834sigsetops.3
14835sigwait.3
14836strtok.3
14837tzset.3
14838unlocked_stdio.3
14839 mtk
14840 Add/fix feature test macro requirements.
14841
14842
14843Changes to individual pages
14844---------------------------
14845
14846fcntl.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
14856getrusage.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
14861ioctl_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
14866sched_setscheduler.2
14867 Carsten Emde
14868 Update kernel version numbers relating to real-time support.
14869
14870stat.2
14871 H. Peter Anvin
14872 Note that lstat() will generally not trigger automounter
14873 action, whereas stat() will.
14874
14875clock.3
14876 Bernd Eckenfels
14877 SEE ALSO: Add clock_gettime(3).
14878 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=353475
14879
14880clock_getres.3
14881 Tolga Dalman / mtk
14882 Add "Link with -lrt" to SYNOPSIS; remove now redundant
14883 sentence mentioning librt from NOTES.
14884
14885getdate.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
14894hsearch.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/.
59bf85df 14907 mtk, after a suggestion by Timothy S. Nelson
5071e2eb
MK
14908 Integrate discussion of reentrant functions into main discussion
14909 (rather than as a short paragraph at the end).
14910
14911iconv.3
14912 Bruno Haible
14913 Describe "shift sequence" input.
14914
14915ptsname.3
14916 sukadev
14917 Fix return type of ptsname_r() in SYNOPSIS.
14918
14919readdir.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
14925sigsetops.3
14926 Chris Head, signed-off-by: Mike Frysinger
14927 Fix typo: s/sigdelset/sigorset/
14928
14929proc.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
14948unix.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>.
6fcbd98a
MK
14952
14953
14954==================== Changes in man-pages-3.10 ====================
14955
14956Released: 2008-09-23, Munich
14957
14958
14959Contributors
14960------------
14961
14962The following people contributed notes, ideas, or patches that have
14963been incorporated in changes in this release:
14964
33972b0b 14965André Goddard Rosa <andre.goddard@gmail.com>
6fcbd98a
MK
14966George Spelvin <linux@horizon.com>
14967Pavel Heimlich <tropikhajma@seznam.cz>
14968Sam Varshavchik <mrsam@courier-mta.com>
14969John Reiser <jreiser@bitwagon.com>
14970
14971Apologies if I missed anyone!
14972
14973
14974Global changes
14975--------------
14976
14977closedir.3
14978dirfd.3
14979readdir.3
14980rewinddir.3
14981scandir.3
14982seekdir.3
14983telldir.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
14990Changes to individual pages
14991---------------------------
14992
14993clone.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
15000getpid.2
15001 mtk, after a comment by John Reiser
15002 Describe getpid()'s PID caching and its consequences.
15003
15004timerfd_create.2
15005 Sam Varshavchik
15006 s/it_interval/it_value/ when talking about TIMERFD_ABSTIME.
15007
15008closedir.3
15009 George Spelvin
15010 Clarify closedir()'s treatment of underlying file descriptor.
15011
15012tsearch.3
33972b0b 15013 André Goddard Rosa
6fcbd98a
MK
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
15019protocols.5
15020 mtk, after a note from Pavel Heimlich
15021 Remove SEE ALSO references to nonexistent Guides to Yellow Pages
15022
15023services.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.
0c847271
MK
15032
15033
15034==================== Changes in man-pages-3.11 ====================
15035
15036Released: 2008-10-07, Munich
15037
15038
15039Contributors
15040------------
15041
15042The following people contributed notes, ideas, or patches that have
15043been incorporated in changes in this release:
15044
33972b0b 15045André Goddard Rosa <andre.goddard@gmail.com>
0c847271
MK
15046Eugene V. Lyubimkin <jackyf.devel@gmail.com>
15047Gergely Soos <sogerc1@gmail.com>
15048Kirill A. Shutemov <kirill@shutemov.name>
15049Marko Kreen <markokr@gmail.com>
15050Maxin B. John <maxin.john@ap.sony.com>
15051Maxin John <maxin.john@gmail.com>
15052Michael Kerrisk <mtk.manpages@gmail.com>
33972b0b 15053Nicolas François <nicolas.francois@centraliens.net>
0c847271 15054Pavel Heimlich <tropikhajma@seznam.cz>
33972b0b 15055Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
0c847271
MK
15056Sam Varshavchik <mrsam@courier-mta.com>
15057
15058Apologies if I missed anyone!
15059
15060
15061New and rewritten pages
15062-----------------------
15063
15064umount.2
15065 Michael Kerrisk
15066 Create a new page for umount() and umount2() by extracting
15067 existing material from mount.2 page.
15068
15069
15070New and changed links
15071---------------------
15072
15073umount2.2
15074 Michael Kerrisk
dd68f564
MK
15075 Change link to point to new umount.2
15076 The umount2() material migrated from mount.2 to umount.2
0c847271
MK
15077
15078
15079Changes to individual pages
15080---------------------------
15081
15082execve.2
15083 Michael Kerrisk
dd68f564
MK
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().
0c847271 15090 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15108
15109fallocate.2
15110 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15117
15118 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15123
15124getdents.2
15125readdir.3
15126 Michael Kerrisk
dd68f564
MK
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).
0c847271
MK
15130
15131getdents.2
15132 Michael Kerrisk
dd68f564 15133 Add an example program
0c847271 15134 Michael Kerrisk
dd68f564
MK
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.
0c847271 15139 Michael Kerrisk
dd68f564 15140 The DT_* constants are defined in <dirent.h>
0c847271 15141 Michael Kerrisk
dd68f564
MK
15142 Remove header files from SYNOPSIS
15143 None of the header files provides what is needed.
15144 Calls are made via syscall(2).
0c847271 15145 Michael Kerrisk
dd68f564
MK
15146 The programmer must define the linux_dirent structure
15147 Point out that this structure is not defined in glibc headers.
0c847271 15148 Michael Kerrisk
dd68f564
MK
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).
0c847271
MK
15153
15154getrlimit.2
15155 Michael Kerrisk
dd68f564
MK
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.
0c847271 15159 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15163
15164getrusage.2
15165 Michael Kerrisk
dd68f564 15166 Rusage measures are preserved across execve(2)
0c847271
MK
15167
15168mlock.2
15169 Maxin John
dd68f564 15170 Add EAGAIN error.
0c847271
MK
15171
15172move_pages.2
33972b0b 15173 Nicolas François
dd68f564 15174 Make a detail of EPERM error more precise
0c847271
MK
15175
15176mount.2
15177 Michael Kerrisk
dd68f564
MK
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.
0c847271 15181 Michael Kerrisk
dd68f564
MK
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).
0c847271 15185 Michael Kerrisk
dd68f564 15186 Document MS_SILENT (and MS_VERBOSE)
0c847271
MK
15187
15188mount.2
15189umount.2
15190 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15196
15197pause.2
15198 Michael Kerrisk
dd68f564
MK
15199 Remove mention of words "library function"
15200 This really is a system call.
0c847271
MK
15201
15202readdir.2
15203 Michael Kerrisk
dd68f564
MK
15204 The programmer must declare the old_linux_dirent structure
15205 Glibc does not provide a definition of this structure.
0c847271 15206 Michael Kerrisk
dd68f564
MK
15207 s/dirent/old_linux_dirent/
15208 Nowadays, this is the name of the structure in the
15209 kernel sources.
0c847271 15210 Michael Kerrisk
dd68f564
MK
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.
0c847271 15215 Michael Kerrisk
dd68f564
MK
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).
0c847271
MK
15220
15221recv.2
33972b0b 15222 Nicolas François
dd68f564 15223 Move kernel version number to first mention to MSG_ERRQUEUE.
0c847271
MK
15224
15225semop.2
15226 Kirill A. Shutemov
dd68f564
MK
15227 Fix typo in example
15228 (The '&' before sop in the semop() call is unneeded.)
0c847271
MK
15229
15230send.2
15231 Michael Kerrisk
dd68f564
MK
15232 Make kernel version for MSG_CONFIRM more precise
15233 s/2.3+ only/Since Linux 2.3.15/
0c847271
MK
15234
15235sigaction.2
15236 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15240
15241sigaltstack.2
15242 Michael Kerrisk
dd68f564 15243 Explain inheritance of alternate signal stack across fork(2)
0c847271
MK
15244
15245sigwaitinfo.2
15246 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15250
15251 Michael Kerrisk
dd68f564
MK
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.)
0c847271
MK
15257
15258sigpending.2
15259 Michael Kerrisk
dd68f564 15260 Explain effect of fork() and execve() for pending signal set
0c847271 15261 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15265
15266sigprocmask.2
15267 Michael Kerrisk
dd68f564 15268 Explain effects of fork() and execve() for signal mask
0c847271
MK
15269
15270splice.2
15271 Michael Kerrisk
dd68f564 15272 Note that SPLICE_F_MOVE is a no-op since kernel 2.6.21
0c847271
MK
15273
15274syscall.2
15275 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15279
15280tkill.2
15281 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15285
15286utimensat.2
15287 Michael Kerrisk
dd68f564
MK
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.
33972b0b 15292 Nicolas François
dd68f564
MK
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.
0c847271
MK
15296
15297wait4.2
15298 Michael Kerrisk
dd68f564
MK
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.)
0c847271
MK
15303
15304atan2.3
33972b0b 15305 Nicolas François
dd68f564
MK
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.
0c847271
MK
15310
15311cmsg.3
33972b0b 15312 Nicolas François
dd68f564 15313 Add parentheses after macro names.
0c847271
MK
15314
15315ctime.3
15316 Michael Kerrisk
dd68f564
MK
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.)
0c847271 15321
dd68f564 15322 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=500178
0c847271
MK
15323 Michael Kerrisk
15324 Clarify wording for ctime_r() and asctime_r() to indicate that
15325 the buffer must be at least 26 *bytes*.
0c847271 15326 Michael Kerrisk
dd68f564 15327 Minor rewording of mktime() description.
0c847271
MK
15328
15329floor.3
33972b0b 15330 Nicolas François
0c847271
MK
15331 floor.3: Fix error in description: s/smallest/largest/
15332
15333hsearch.3
33972b0b 15334 André Goddard Rosa
dd68f564
MK
15335 Call hdestroy() after using hash table created by hcreate(),
15336 for the sake of completeness
0c847271
MK
15337
15338mq_getattr.3
15339 Michael Kerrisk
dd68f564
MK
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).)
0c847271
MK
15344
15345mq_receive.3
15346 Michael Kerrisk
dd68f564
MK
15347 mq_send() is a library function layered on mq_timedreceive() syscall
15348 This info is useful for users of strace(1).
0c847271
MK
15349
15350mq_send.3
15351 Michael Kerrisk
dd68f564
MK
15352 mq_send() is a library function layered on mq_timedsend() syscall
15353 This info is useful for users of strace(1).
0c847271
MK
15354
15355nextafter.3
33972b0b 15356 Nicolas François
dd68f564 15357 Make description more precise: s/next/largest/
0c847271
MK
15358
15359readdir.3
15360 Michael Kerrisk
dd68f564
MK
15361 SEE ALSO: add getdents(2)
15362 Because readdir() is implemented on top of getdents(2).
0c847271
MK
15363
15364realpath.3
15365 Michael Kerrisk
dd68f564
MK
15366 Clarify that returned pathname is NULL terminated
15367 Also clarify that null-byte is included in PATH_MAX limit.
0c847271
MK
15368
15369proc.5
15370 Michael Kerrisk
dd68f564
MK
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.
0c847271 15376 Michael Kerrisk
dd68f564
MK
15377 Add description of /proc/PID/mounts
15378 Largely cribbed from existing /proc/mounts discussion, which is
15379 about to be rewritten.
0c847271
MK
15380
15381mq_overview.7
15382 Michael Kerrisk
dd68f564 15383 Add mq_notify() to list of lib. functions and syscalls in MQ API
0c847271
MK
15384
15385signal.7
15386 Michael Kerrisk
dd68f564
MK
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.
0c847271
MK
15392
15393 Michael Kerrisk
dd68f564
MK
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.
cac193ff
MK
15397
15398
15399==================== Changes in man-pages-3.12 ====================
15400
15401Released: 2008-10-29, Bucaramanga
15402
15403
15404Contributors
15405------------
15406
15407The following people contributed notes, ideas, or patches that have
15408been incorporated in changes in this release:
15409
9ee629ff
MK
15410Bert Wesarg <bert.wesarg@googlemail.com>
15411Christian Grigis <glove@earthling.net>
15412Christoph Hellwig <hch@infradead.org>
15413Didier <did447@gmail.com>
15414Halesh S <halesh.s@india.com>
15415J.H.M. Dassen (Ray) <fsmla@xinara.org>
15416Jason Spiro <jasonspiro4@gmail.com>
15417Lefteris Dimitroulakis <edimitro@tee.gr>
15418Michael B. Trausch <mike@trausch.us>
15419Pierre Cazenave <pwc101@noc.soton.ac.uk>
15420Stefan Puiu <stefan.puiu@gmail.com>
cac193ff
MK
15421
15422Apologies if I missed anyone!
15423
15424
15425New and rewritten pages
15426-----------------------
15427
15428pthread_attr_init.3
15429 Michael Kerrisk
15430 New page for pthread_attr_init(3) and pthread_attr_destroy(3)
15431
15432pthread_attr_setdetachstate.3
15433 Michael Kerrisk
15434 New page for pthread_attr_setdetachstate(3) and
15435 pthread_attr_getdetachstate(3)
15436
15437pthread_attr_setguardsize.3
15438 Michael Kerrisk
15439 New page for pthread_attr_setguardsize(3) and
15440 pthread_attr_getguardsize(3)
15441
15442pthread_attr_setscope.3
15443 Michael Kerrisk
15444 New page for pthread_attr_setscope(3) and pthread_attr_getscope(3)
15445
15446pthread_attr_setstack.3
15447 Michael Kerrisk
15448 New page for pthread_attr_setstack(3) and pthread_attr_getstack(3)
15449
15450pthread_attr_setstackaddr.3
15451 Michael Kerrisk
15452 New page for pthread_attr_setstackaddr(3) and
15453 pthread_attr_getstackaddr(3)
15454
15455pthread_attr_setstacksize.3
15456 Michael Kerrisk
15457 New page for pthread_attr_setstacksize(3) and
15458 pthread_attr_getstacksize(3)
15459
15460pthread_create.3
15461 Michael Kerrisk
15462 New page describing pthread_create(3)
15463
15464pthread_detach.3
15465 Michael Kerrisk
15466 New page for pthread_detach(3)
15467
15468pthread_equal.3
15469 Michael Kerrisk
15470 New page for pthread_equal(3)
15471
15472pthread_exit.3
15473 Michael Kerrisk
15474 New page describing pthread_exit(3)
15475
15476pthread_getattr_np.3
15477 Michael Kerrisk
15478 New page for pthread_getattr_np(3)
15479
15480pthread_join.3
15481 Michael Kerrisk
15482 New page for pthread_join(3)
15483
15484pthread_self.3
15485 Michael Kerrisk
15486 New page for pthread_self(3)
15487
15488pthread_tryjoin_np.3
15489 Michael Kerrisk
15490 New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3)
15491
15492
15493Newly documented interfaces in existing pages
15494---------------------------------------------
15495
15496dup.2
15497 Michael Kerrisk
15498 Add description of dup3()
15499 dup3() was added in kernel 2.6.27.
15500
15501epoll_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.
cc378aa6 15505
cac193ff
MK
15506eventfd.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
15513inotify_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
15518pipe.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
15524signalfd.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
15532New and changed links
15533---------------------
15534
15535dup3.2
15536 Michael Kerrisk
15537 New link to dup.2
15538 dup.2 now contains the description of the new dup3() syscall.
15539
15540epoll_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
15546eventfd2.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
15552inotify_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
15558pipe2.2
15559 Michael Kerrisk
15560 New link to pipe.2
15561 pipe(2) now contains a description of the new pipe2() syscall.
15562
15563pthread_attr_destroy.3
15564 Michael Kerrisk
15565 New link to new pthread_attr_init.3
15566
15567pthread_attr_getdetachstate.3
15568 Michael Kerrisk
15569 New link to new pthread_attr_setdetachstate.3
15570
15571pthread_attr_getguardsize.3
15572 Michael Kerrisk
15573 New link to new pthread_attr_setguardsize.3
15574
15575pthread_attr_getscope.3
15576 Michael Kerrisk
15577 New link to new pthread_attr_setscope.3
15578
15579pthread_attr_getstack.3
15580 Michael Kerrisk
15581 New link to new pthread_attr_setstack.3
15582
15583pthread_attr_getstackaddr.3
15584 Michael Kerrisk
15585 New link to new pthread_attr_setstackaddr.3
15586
15587pthread_attr_getstacksize.3
15588 Michael Kerrisk
15589 New link to new pthread_attr_setstacksize.3
15590
15591pthread_timedjoin_np.3
15592 Michael Kerrisk
15593 New link to new pthread_tryjoin_np.3
15594
15595signalfd4.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
15602Global changes
15603--------------
15604
15605eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2,
15606wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3,
15607fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3,
15608getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3,
15609makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3,
15610pthread_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
15616eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2,
15617signalfd.2, timerfd_create.2, wait.2, backtrace.3,
15618clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3,
15619getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3,
15620gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3,
15621malloc.3, matherr.3, offsetof.3, pthread_attr_init.3,
15622pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3,
15623strtok.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
15627frexp.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
15636Changes to individual pages
15637---------------------------
15638
15639epoll_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
15645eventfd.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.
15651getdents.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
15659getpeername.2, getsockname.2
15660 Michael Kerrisk
15661 SEE ALSO: add ip(7) and unix(7)
15662
15663getsockopt.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
4f6e9f03
MK
15671inotify_init.2
15672pipe.2
15673timerfd_create.2
cac193ff
MK
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
15679sched_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
15689sigaction.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
15695signalfd.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
15702sigprocmask.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
15710socket.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
15716socketpair.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
15723syscalls.2
15724 Michael Kerrisk
15725 Add new 2.6.27 system calls
15726 Add pipe2(), dup3(), epoll_create1(), inotify_init1(),
15727 eventfd2(), signalfd4().
15728
15729timerfd_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
15734vfork.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
15740ctime.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
15749dlopen.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
15755fmemopen.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
15762getaddrinfo.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
15771gethostbyname.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
15779popen.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
15788raise.3
15789 Michael Kerrisk
15790 SEE ALSO: add pthread_kill(3)
15791
15792readdir.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
15801strcpy.3
15802 Jason Spiro
15803 Strengthen warning about checking against buffer overruns
15804 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940
15805
15806tty_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
15817proc.5
15818 Michael Kerrisk
15819 Document /proc/sys/kernel/threads-max
15820 Defines the system-wide limit on the number of threads (tasks).
15821
15822utmp.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
15829epoll.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
15835inotify.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
15841ip.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
15847iso_8859-7.7
15848 Lefteris Dimitroulakis
15849 Add Drachma, Euro, and Greek Ypogegrammeni
15850 Also, amend description of characters 0241 and 0242.
15851
15852man-pages.7
15853 Michael Kerrisk
15854 Example shell sessions should have user input boldfaced
15855
15856pthreads.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
15863signal.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
15872socket.7
15873 Michael Kerrisk
15874 SEE ALSO: add unix(7)
15875
15876ld.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
b7170be2
MK
15901
15902
15903==================== Changes in man-pages-3.13 ====================
15904
15905Released: 2008-11-07, Bucaramanga
15906
15907
15908Contributors
15909------------
15910
15911The following people contributed notes, ideas, or patches that have
15912been incorporated in changes in this release:
15913
15914Bert Wesarg <bert.wesarg@googlemail.com>
15915Karsten Weiss <knweiss@gmail.com>
15916Lefteris Dimitroulakis <edimitro@tee.gr>
15917Olaf van der Spek <olafvdspek@gmail.com>
15918Sam Varshavchik <mrsam@courier-mta.com>
33972b0b 15919Török Edwin <edwintorok@gmail.com>
b7170be2
MK
15920Ulrich Mueller <ulm@gentoo.org>
15921Valdis Kletnieks <Valdis.Kletnieks@vt.edu>
15922
15923Apologies if I missed anyone!
15924
15925
15926New and rewritten pages
15927-----------------------
15928
15929pthread_attr_setaffinity_np.3
15930 Michael Kerrisk
15931 New page for pthread_attr_setaffinity_np(3) and
15932 pthread_attr_getaffinity_np(3)
15933
15934pthread_attr_setschedparam.3
15935 Michael Kerrisk
15936 New page for pthread_attr_setschedparam(3) and
15937 pthread_attr_getschedparam(3)
15938
15939pthread_attr_setschedpolicy.3
15940 Michael Kerrisk
15941 New page for pthread_attr_setschedpolicy(3) and
15942 pthread_attr_getschedpolicy(3)
15943
15944pthread_setaffinity_np.3
15945 Michael Kerrisk
15946 New page for pthread_setaffinity_np(3) and pthread_getaffinity_np(3)
15947
15948pthread_setschedparam.3
15949 Michael Kerrisk
15950 New page for pthread_setschedparam(3) and pthread_getschedparam(3)
15951
15952pthread_setschedprio.3
15953 Michael Kerrisk
15954 New page for pthread_setschedprio(3)
15955
15956
15957New and changed links
15958---------------------
15959
15960pthread_attr_getaffinity_np.3
15961 Michael Kerrisk
15962 New link to new pthread_attr_setaffinity_np.3
15963
15964pthread_attr_getschedparam.3
15965 Michael Kerrisk
15966 New link to new pthread_attr_setschedparam.3
15967
15968pthread_attr_getschedpolicy.3
15969 Michael Kerrisk
15970 New link to new pthread_attr_setschedpolicy.3
15971
15972pthread_getaffinity_np.3
15973 Michael Kerrisk
15974 New link to new pthread_setaffinity_np.3
15975
15976pthread_getschedparam.3
15977 Michael Kerrisk
15978 New link to new pthread_setschedparam.3
15979
15980
15981Global changes
15982--------------
15983
15984pthread_attr_setaffinity_np.3
15985pthread_getattr_np.3
15986pthread_setaffinity_np.3
15987pthread_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
15994Changes to individual pages
15995---------------------------
15996
15997sched_setaffinity.2
15998 Michael Kerrisk
15999 SEE ALSO: add sched_getcpu(3)
16000
16001sched_setaffinity.2
16002 Michael Kerrisk
16003 SEE ALSO: Add pthread_setaffinity_np(3)
16004
16005sched_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
16012vfork.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
16021clock_getres.3
16022 Michael Kerrisk
c57f55ec 16023 CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable
b7170be2
MK
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
16028pthread_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
16036pthread_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
16043pthread_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
16051resolver.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
16057epoll.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
16065epoll.7
16066 Michael Kerrisk
16067 Add error handling for epoll_wait() call in example code
16068
16069epoll.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
16078iso_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
16085pthreads.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.
1cba1636
MK
16091
16092
16093==================== Changes in man-pages-3.14 ====================
16094
16095Released: 2008-11-25, Bucaramanga
16096
16097
16098Contributors
16099------------
16100
16101The following people contributed notes, ideas, or patches that have
16102been incorporated in changes in this release:
16103
16104Andreas Henriksson <andreas@fatal.se>
16105Bert Wesarg <bert.wesarg@googlemail.com>
16106Cedric Le Goater <clg@fr.ibm.com>
16107Chris Heath <chris@heathens.co.nz>
16108Eric Biederman <ebiederm@xmission.com>
16109Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
16110Ivana Varekova <varekova@redhat.com>
16111Jen Axboe <jens.axboe@oracle.com>
16112Jens Axboe <jens.axboe@oracle.com>
33972b0b 16113Loïc Domaigne <tech@domaigne.com>
1cba1636
MK
16114Masanari Iida <masanari.iida@hp.com>
16115Paul Evans <leonerd@leonerd.org.uk>
16116Pavel Emelyanov <xemul@openvz.org>
16117Pierre-Paul Paquin <pierrepaulpaquin@gmail.com>
16118Serge E. Hallyn <serge@hallyn.com>
16119Stefano Teso <teso@disi.unitn.it>
16120Stew Benedict <stewb@linux-foundation.org>
16121Vegard Nossum <vegard.nossum@gmail.com>
16122
16123Apologies if I missed anyone!
16124
16125
16126New and rewritten pages
16127-----------------------
16128
16129CPU_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
16165pthread_attr_setinheritsched.3
16166 Michael Kerrisk
16167 New page for pthread_attr_setinheritsched(3) and
16168 pthread_attr_getinheritsched(3)
16169
16170pthread_cancel.3
16171 Michael Kerrisk
16172 New page for pthread_cancel(3)
16173
16174pthread_cleanup_push.3
16175 Michael Kerrisk
16176 New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3)
16177
16178pthread_setcancelstate.3
16179 Michael Kerrisk
16180 New page for pthread_setcancelstate(3) and pthread_setcanceltype(3)
16181
16182pthread_testcancel.3
16183 Michael Kerrisk
16184 New page for pthread_testcancel(3)
16185
16186
16187Newly documented interfaces in existing pages
16188---------------------------------------------
16189
16190clone.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
16203mmap.2
16204 Michael Kerrisk
16205 Document MAP_STACK flag (new in Linux 2.6.27)
16206
16207arp.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
16213icmp.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
16224tcp.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
16265udp.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
16271New and changed links
16272---------------------
16273
16274CPU_ALLOC.3
16275CPU_ALLOC_SIZE.3
16276CPU_AND.3
16277CPU_AND_S.3
16278CPU_CLR_S.3
16279CPU_COUNT.3
16280CPU_COUNT_S.3
16281CPU_EQUAL.3
16282CPU_EQUAL_S.3
16283CPU_FREE.3
16284CPU_ISSET_S.3
16285CPU_OR.3
16286CPU_OR_S.3
16287CPU_SET_S.3
16288CPU_XOR.3
16289CPU_XOR_S.3
16290CPU_ZERO_S.3
16291 Michael Kerrisk
16292 New link to new CPU_SET.3
16293
16294CPU_CLR.3
16295CPU_ISSET.3
16296CPU_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
16302pthread_attr_getinheritsched.3
16303 Michael Kerrisk
16304 New link to new pthread_attr_setinheritsched.3
16305
16306pthread_cleanup_pop.3
16307 Michael Kerrisk
16308 New link to new pthread_cleanup_push.3
16309
16310pthread_setcanceltype.3
16311 Michael Kerrisk
16312 New link to new pthread_setcancelstate.3
16313
16314
16315Global changes
16316--------------
16317
16318clone.2
16319mount.2
16320unshare.2
16321proc.5
16322path_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
2beeae40 16334 and checkpoint/restart in mainstream Linux".
1cba1636
MK
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
16339connect.2
16340listen.2
16341send.2
16342uname.2
16343cmsg.3
16344proc.5
16345arp.7
16346ddp.7
16347icmp.7
16348ip.7
16349raw.7
16350socket.7
16351tcp.7
16352udp.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
16359fcntl.2
16360signal.2
16361mbsnrtowcs.3
16362mbsrtowcs.3
16363mbtowc.3
16364wcrtomb.3
16365wcsnrtombs.3
16366wcsrtombs.3
16367wctomb.3
16368 Michael Kerrisk
16369 Global fix: s/multi-thread/multithread/
16370
16371getdents.2
16372pthread_attr_init.3
16373pthread_create.3
16374pthread_getattr_np.3
16375pthread_setaffinity_np.3
16376pthread_setschedparam.3
16377pthread_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
16385Changes to individual pages
16386---------------------------
16387
16388time.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
16394clone.2
16395 Michael Kerrisk
16396 Place list of CLONE_* flags in alphabetical order
16397 (No content changes.)
16398fsync.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
16404sched_setaffinity.2
16405 Michael Kerrisk
16406 Add note on system-imposed restrictions on CPUs actually used
33972b0b 16407 After Loïc Domaigne's suggestion for pthread_setaffinity_np(3), add
1cba1636
MK
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
16413sched_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
16422sysctl.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
16428uname.2
16429 Michael Kerrisk
16430 Add C comments describing fields in utsname structure
16431
16432atan2.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
33972b0b 16437 (mtk: This error was reported by Nicolas François, and
1cba1636
MK
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
16443bindresvport.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
16451clock_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
16458getgrnam.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
16480getpwnam.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
16495inet_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
16505makecontext.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
16514pthread_attr_setaffinity_np.3
16515 Michael Kerrisk
33972b0b
MK
16516 Various fixes after review by Loïc Domaigne
16517 Reviewed-by: Loïc Domaigne
1cba1636
MK
16518
16519pthread_attr_setaffinity_np.3
16520pthread_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
16530pthread_attr_setschedparam.3
16531pthread_setschedparam.3
16532 Michael Kerrisk
16533 Remove text saying that only sched_priority is required by POSIX.1
33972b0b 16534 Loïc Domaigne points out that if a system implements
1cba1636
MK
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
16540pthread_cancel.3
16541pthread_detach.3
16542pthread_join.3
16543pthread_setaffinity_np.3
16544 Michael Kerrisk
16545 Make text of ESRCH error consistent
16546
16547pthread_setaffinity_np.3
16548 Michael Kerrisk
16549 Add text to EINVAL error mentioning cpuset(7)
16550 Michael Kerrisk
33972b0b
MK
16551 Various improvements after review by Loïc Domaigne
16552 Various fix-ups after Loïc's review.
1cba1636 16553
33972b0b 16554 Reviewed-by: Loïc Domaigne
1cba1636
MK
16555
16556pthread_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
2beeae40 16560 the inherit scheduler attribute.
1cba1636
MK
16561
16562syslog.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
16572proc.5
16573 Ivana Varekova
16574 Fix reference to kernel source file
16575 Use relative reference to Documentation/mtrr.txt.
16576
16577arp.7
16578 Michael Kerrisk
16579 Add kernel version numbers for /proc interfaces
16580
16581cpuset.7
16582 Michael Kerrisk
16583 SEE ALSO: add CPU_SET(3)
16584
16585epoll.7
16586 Michael Kerrisk
16587 Note glibc version that added epoll support
16588
16589icmp.7
16590 Michael Kerrisk
16591 Add kernel version numbers to /proc file descriptions
16592
16593inotify.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
16608ip.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
16627netlink.7
16628 Vegard Nossum
16629 Fix incorrect variable names in example code
16630 s/snl/sa/ * 2
16631
16632pthreads.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
16657tcp.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
7d29a946
MK
16692
16693
16694==================== Changes in man-pages-3.15 ====================
16695
16696Released: 2008-12-05, Bucaramanga
16697
16698
16699Contributors
16700------------
16701
16702The following people contributed notes, ideas, or patches that have
16703been incorporated in changes in this release:
16704
16705Andre Majorel <aym-xunil@teaser.fr>
16706Andries E. Brouwer <Andries.Brouwer@cwi.nl>
16707Chris Heath <chris@heathens.co.nz>
16708Drake Wilson <drake@begriffli.ch>
16709Mats Wichmann <mats.d.wichmann@intel.com>
16710Mel Gorman <mel@csn.ul.ie>
16711Michael Kerrisk <mtk.manpages@gmail.com>
16712Mike Fedyk <mfedyk@mikefedyk.com>
16713Pavel Machek <pavel@suse.cz>
16714Petr Baudis <pasky@suse.cz>
16715Phil Endecott <phil_vonar_endecott@chezphil.org>
16716Rob Landley <rob@landley.net>
16717Sam Varshavchik <mrsam@courier-mta.com>
16718
16719Apologies if I missed anyone!
16720
16721
16722New and rewritten pages
16723-----------------------
16724
16725makedev.3
16726 Michael Kerrisk
16727 New page for makedev(), major(), and minor() macros
16728
16729pthread_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
16735Newly documented interfaces in existing pages
16736---------------------------------------------
16737
16738accept.2
16739 Michael Kerrisk
16740 Document accept4() system call, new in Linux 2.6.28
16741
16742fmemopen.3
16743 Petr Baudis
16744 Add description of open_wmemstream(3)
16745
16746tcp.7
16747 Michael Kerrisk
16748 Document MSG_TRUNC flag for TCP sockets
16749
16750New and changed links
16751---------------------
16752
16753accept4.2
16754 Michael Kerrisk
16755 New link to accept.2
16756 accept.2 now documents the new accept4() system call.
16757
16758open_wmemstream.3
16759 Petr Baudis
16760 New link to fmemopen.3
16761 fmemopen.3 now documents open_wmemstream().
16762pthread_cleanup_pop_restore_np.3
16763 Michael Kerrisk
16764 New link to new pthread_cleanup_push_defer_np.3
16765
16766
16767Global changes
16768--------------
16769
16770accept.2
16771listen.2
16772recv.2
16773getpeername.2
16774getsockname.2
16775shutdown.2
16776socketpair.2
16777 Michael Kerrisk
16778 Global fix: SEE ALSO: add socket(7)
16779
16780bind.2
16781rcmd.3
16782capabilities.7
16783ip.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
16789connect.2
16790getpeername.2
16791getsockname.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
16797getpeername.2
16798getsockname.2
16799getsockopt.2
16800recv.2
16801send.2
16802shutdown.2
16803sockatmark.3
16804socket.7
16805udplite.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
16811gnu_dev_major.3
16812gnu_dev_makedev.3
16813gnu_dev_minor.3
16814major.3
16815minor.3
16816 Michael Kerrisk
16817 New links to new makedev(3) page
16818
16819
16820Changes 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
16828accept.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
16843exit_group.2
16844 Michael Kerrisk
16845 Note that since glibc 2.3, exit(2) invokes exit_group()
16846
16847futex.2
16848 Michael Kerrisk
16849 Mention that glibc provides no wrapper function for futex()
16850
16851get_thread_area.2
16852 Michael Kerrisk
16853 Note that glibc provides no wrapper for this system call
16854
16855getdomainname.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
16864gethostname.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
16872gethostname.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
16878getpeername.2
16879 Michael Kerrisk
16880 Note that returned address may be truncated if buffer is too small
16881
16882getsid.2
16883 Michael Kerrisk
16884 Simplified version information and moved to a new VERSIONS section
16885
16886getsockname.2
16887 Michael Kerrisk
16888 Note that returned address is truncated if buffer is too small
16889
16890mknod.2
16891 Michael Kerrisk
16892 Refer reader to makedev(3) to build a device ID
16893
16894mmap.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
16906open.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
16916pread.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
16921recv.2
16922send.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
16928recv.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
16943select.2
16944 Michael Kerrisk
16945 Rewrote text describing feature test macros requirement for pselect()
16946
16947select_tut.2
16948 Michael Kerrisk
16949 Fix SHUT_FD* macros in example program
16950 Add "do {} while (0)"
16951
16952set_thread_area.2
16953 Michael Kerrisk
16954 Note that glibc provides no wrapper for this system call
16955
16956setfsgid.2
16957setfsuid.2
16958 Michael Kerrisk
16959 Simplify version information and move to a VERSIONS section
16960
16961setsid.2
16962 Michael Kerrisk
16963 Rework RETURN VALUE section; add an ERRORS section
16964
16965setup.2
16966 Michael Kerrisk
16967 Relocate some CONFORMING TO text to VERSIONS and NOTES
16968
16969stat.2
16970 Michael Kerrisk
16971 Document EOVERFLOW error
16972 Michael Kerrisk
16973 Refer reader to major() and minor() to decompose a device ID
16974
16975syscalls.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
16981uname.2
16982 Michael Kerrisk
16983 DESCRIPTION: Point reader at NOTES for further info on field lengths
16984
16985atan.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
33972b0b 16990 a botch-up of a (correct) suggestion by Nicolas François.)
7d29a946
MK
16991
16992atexit.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
17012bindresvport.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
ebfa6f28
MK
17030 Reviewed-by: Mats Wichmann
17031 Reviewed-by: Petr Baudis
7d29a946
MK
17032
17033dlopen.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
17039fmemopen.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
17046fopen.3
17047 Petr Baudis
17048 SEE ALSO: Add fmemopen(3) and fopencookie(3)
17049
17050fopencookie.3
17051 Petr Baudis
17052 fopencookie() needs _GNU_SOURCE feature test macro
17053
17054getaddrinfo.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
17065isatty.3
17066 Michael Kerrisk
17067 Complete rewrite of this page, with rather more detail
17068
17069memmem.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
17074on_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
17087setlocale.3
17088locale.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
17102proc.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
17107capabilities.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
17126socket.7
17127 Michael Kerrisk
17128 SEE ALSO: add tcp(7) and udp(7)
17129
17130tcp.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
17137time.7
17138 Michael Kerrisk
17139 SEE ALSO: add clock_gettime(3)
17140
17141unix.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
364d1652
MK
17148
17149
17150==================== Changes in man-pages-3.16 ====================
17151
17152Released: 2009-01-13, Christchurch
17153
17154
17155Contributors
17156------------
17157
17158The following people contributed notes, ideas, or patches that have
17159been incorporated in changes in this release:
17160
17161Colin Watson <cjwatson@ubuntu.com>
17162Florentin Duneau <fduneau@gmail.com>
17163Petr Baudis <pasky@suse.cz>
17164
17165Apologies if I missed anyone!
17166
17167
17168New and rewritten pages
17169-----------------------
17170
17171pthread_getcpuclockid.3
17172 Michael Kerrisk
17173 New page documenting pthread_getcpuclockid(3)
17174
17175libc.7
17176 Michael Kerrisk
17177 New page giving brief overview of C libraries on Linux
17178
17179rtld-audit.7
17180 Michael Kerrisk
7fa83c3a 17181 New page documenting dynamic linker auditing API
364d1652
MK
17182
17183
17184Newly documented interfaces in existing pages
17185---------------------------------------------
17186
17187ld.so.8
17188 Petr Baudis
17189 Document LD_AUDIT
17190 Petr Baudis
17191 Document LD_POINTER_GUARD
17192
17193
17194New and changed links
17195---------------------
17196
17197gethostid.2
17198 Michael Kerrisk
17199 New link to new page location in Section 3
17200
17201sethostid.2
17202 Michael Kerrisk
17203 Change link to point to new page location in Section 3
17204
17205sethostid.3
17206 Michael Kerrisk
17207 New link to relocated page in Section 3
17208
17209glibc.7
17210 Michael Kerrisk
17211 New link to new libc.7
17212
17213
17214Global changes
17215--------------
17216
17217syscalls.2
17218feature_test_macros.7
17219standards.7
17220 Michael Kerrisk
17221 SEE ALSO: add libc(7)
17222
17223dlopen.3
17224ld.so.8
17225 Michael Kerrisk
17226 SEE ALSO: add rtld-audit(7)
17227
17228
17229Changes to individual pages
17230---------------------------
17231
17232gethostid.2
17233 Michael Kerrisk
17234 Move to Section 3
17235 The interfaces documented in this page are purely glibc.
17236
17237syscalls.2
17238 Michael Kerrisk
17239 Kernel 2.6.28 adds accept4()
17240
17241clock_getres.3
17242 Michael Kerrisk
17243 SEE ALSO: Add pthread_getcpuclockid(3)
17244
17245fmemopen.3
17246 Michael Kerrisk
17247 Fix VERSIONS information
17248
17249gethostid.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
17263printf.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
17295readdir.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
17301nscd.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.
32e2ca46
MK
17311
17312
17313==================== Changes in man-pages-3.17 ====================
17314
17315Released: 2009-01-19, Hobart
17316
17317
17318Contributors
17319------------
17320
17321The following people contributed notes, ideas, or patches that have
17322been incorporated in changes in this release:
17323
33972b0b 17324Adeodato Simó <dato@net.com.org.es>
32e2ca46
MK
17325Bastien ROUCARIES <roucaries.bastien@gmail.com>
17326Davide Libenzi <davidel@xmailserver.org>
17327Lefteris Dimitroulakis <edimitro@tee.gr>
17328Mads Martin Joergensen <mmj@mmj.dk>
17329Marc Lehmann <schmorp@schmorp.de>
17330Martin (Joey) Schulze <joey@infodrom.org>
17331Michael Kerrisk <mtk.manpages@gmail.com>
17332Petr Baudis <pasky@suse.cz>
17333Sam Varshavchik <mrsam@courier-mta.com>
17334Vegard Nossum <vegard.nossum@gmail.com>
17335
17336Apologies if I missed anyone!
17337
17338
17339New and rewritten pages
17340-----------------------
17341
17342endian.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
17351getifaddrs.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
32e2ca46
MK
17356cp1251.7
17357 Lefteris Dimitroulakis
17358 New page documenting CP 1251 (Windows Cyrillic) character set
17359
17360iso-8859-10.7
17361 Lefteris Dimitroulakis
17362 New page documenting ISO 8859-10 character set
17363
17364iso_8859-13.7
17365 Lefteris Dimitroulakis
17366 New page documenting ISO 8859-13 character set
17367
17368iso_8859-14.7
17369 Lefteris Dimitroulakis
17370 New page documenting ISO 8859-14 character set
17371
17372iso_8859-3.7
17373 Lefteris Dimitroulakis
17374 New page documenting ISO 8859-3 character set
17375
17376iso_8859-5.7
17377 Lefteris Dimitroulakis
17378 New page documenting ISO 8859-5 character set
17379
17380iso_8859-8.7
17381 Lefteris Dimitroulakis
17382 New page documenting ISO 8859-8 character set
17383
17384koi8-u.7
17385 Lefteris Dimitroulakis
17386 New page documenting KOI8-U character set
17387
17388
17389Newly documented interfaces in existing pages
17390---------------------------------------------
17391
491dc711
MK
17392epoll.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
32e2ca46
MK
17400netdevice.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
17410New and changed links
17411---------------------
17412
17413freeifaddrs.3
17414 Michael Kerrisk
17415 New link to new getifaddrs.3
17416
6caeab7d
MK
17417htobe16.3
17418htole16.3
17419be16toh.3
17420le16toh.3
17421htobe32.3
17422htole32.3
17423be32toh.3
17424le32toh.3
17425htobe64.3
17426htole64.3
17427be64toh.3
17428le64toh.3
17429 Michael Kerrisk
17430 New links to new endian.3
17431
32e2ca46
MK
17432iso-8859-10.7
17433iso_8859_10.7
17434latin6.7
17435 Michael Kerrisk
17436 New links to new iso_8859-10.7
17437
17438iso-8859-13.7
17439iso_8859_13.7
17440latin7.7
17441 Michael Kerrisk
17442 New links to new iso_8859-13.7
17443
17444iso-8859-14.7
17445iso_8859_14.7
17446latin8.7
17447 Michael Kerrisk
17448 New links to new iso_8859-14.7
17449
17450iso-8859-3.7
17451iso_8859_3.7
17452latin3.7
17453 Michael Kerrisk
17454 New links to new iso_8859-3.7
17455
17456iso-8859-5.7
17457iso_8859_5.7
17458 Michael Kerrisk
17459 New links to new iso_8859-5.7
17460
17461iso-8859-8.7
17462iso_8859_8.7
17463 Michael Kerrisk
17464 New links to new iso_8859-8.7
17465
17466
17467Changes to individual pages
17468---------------------------
17469
17470bind.2
17471 Michael Kerrisk
17472 SEE ALSO: Add getifaddrs(3)
17473
17474epoll_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
17485epoll_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
17497epoll_wait.2
17498 Michael Kerrisk
17499 Introduce the notion of an epoll instance into text
17500
17501getdents.2
17502 Michael Kerrisk
17503 Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN
17504
17505gethostid.2
17506 Michael Kerrisk
17507 Rename file (was misnamed gethostd.2 in previous release)
17508
17509getsockname.2
17510 Michael Kerrisk
17511 SEE ALSO: Add getifaddrs(3)
17512
17513signalfd.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
17520byteorder.3
17521 Michael Kerrisk
17522 SEE ALSO: add endian(3)
17523
17524longjmp.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
17533memccpy.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
17539sethostid.3
17540 Michael Kerrisk
17541 Rename file (was misnamed sethostd.3 in previous release)
17542
17543setjmp.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
17549strsep.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
17557proc.5
17558 Michael Kerrisk
17559 Add pointer to epoll(7) for description of epoll /proc files
17560
17561epoll.7
32e2ca46
MK
17562 Michael Kerrisk
17563 Various wording changes to improve clarity and consistency
0c094170
MK
17564
17565
17566==================== Changes in man-pages-3.18 ====================
17567
17568Released: 2009-02-10, Christchurch
17569
17570
17571Contributors
17572------------
17573
17574The following people contributed notes, ideas, or patches that have
17575been incorporated in changes in this release:
17576
17577Andi Kleen <andi@firstfloor.org>
17578Bastien ROUCARIES <roucaries.bastien@gmail.com>
17579Christian Siebert <christian.siebert@s2000.tu-chemnitz.de>
17580Christopher Head <chead@telus.net>
17581Florentin Duneau <fduneau@gmail.com>
17582Guillem Jover <guillem@debian.org>
17583Lefteris Dimitroulakis <edimitro@tee.gr>
17584Lucio Maciel <luciofm@gmail.com>
17585Michael Kerrisk <mtk.manpages@gmail.com>
17586Mike Frysinger <vapier@gentoo.org>
17587Peter Zijlstra <peterz@infradead.org>
17588Petr Baudis <pasky@suse.cz>
17589Sam Varshavchik <mrsam@courier-mta.com>
17590Satyam Sharma <ssatyam@cse.iitk.ac.in>
17591Sebastian Kienzl <seb@riot.org>
17592Timo Sirainen <tss@iki.fi>
17593Vegard Nossum <vegard.nossum@gmail.com>
17594
17595Apologies if I missed anyone!
17596
17597
17598New and rewritten pages
17599-----------------------
17600
17601armscii-8.7
17602 Lefteris Dimitroulakis
17603 New page documenting ArmSCII-8 character set
17604
17605iso_8859-11.7
17606 Lefteris Dimitroulakis
17607 New page documenting ISO 8859-11 character set
17608
17609iso_8859-4.7
17610 Lefteris Dimitroulakis
17611 New page documenting ISO 8859-4 character set
17612
17613iso_8859-6.7
17614 Lefteris Dimitroulakis
17615 New page describing ISO 8859-6 character set
17616
17617pthread_kill.3
17618 Michael Kerrisk
17619 New page documenting pthread_kill(3)
17620
17621pthread_kill_other_threads_np.3
17622 Michael Kerrisk
17623 New page documenting pthread_kill_other_threads_np(3)
17624
17625pthread_sigmask.3
17626 Michael Kerrisk
17627 New page documenting pthread_sigmask(3)
17628
17629
17630Newly documented interfaces in existing pages
17631---------------------------------------------
17632
17633clock_getres.3
17634 Michael Kerrisk
17635 Document CLOCK_MONOTONIC_RAW, new in 2.6.28
17636
17637
17638New and changed links
17639---------------------
17640
17641clock_gettime.2
17642clock_settime.2
17643clock_getres.3
17644clock_gettime.3
17645clock_settime.3
17646 Michael Kerrisk
17647 Update links to reflect the fact that clock_* pages are now in
17648 Section 2
17649
17650iso-8859-11.7
17651iso_8859_11.7
17652 Michael Kerrisk
17653 New links to new iso_8859-11.7
17654
17655iso-8859-4.7
17656iso_8859_4.7
17657latin4.7
17658 Michael Kerrisk
17659 New links to new iso_8859-4.7
17660
17661iso-8859-6.7
17662iso_8859_6.7
17663 Michael Kerrisk
17664 New links to new iso_8859-6.7
17665
17666tis-620.7
17667 Michael Kerrisk
17668 New link to new iso_8859-11.7
17669
17670
17671Global changes
17672--------------
17673
17674clock_nanosleep.2
17675getrusage.2
17676timerfd_create.2
17677clock.3
17678clock_getcpuclockid.3
17679ftime.3
17680pthread_create.3
17681pthread_getcpuclockid.3
17682pthread_tryjoin_np.3
17683sem_wait.3
17684time.7
17685 Michael Kerrisk
17686 Global fix: Fix xrefs to clock_*.? pages to reflect move to section 2
17687
17688clock_nanosleep.2
17689execve.2
17690fork.2
17691nanosleep.2
17692sigaction.2
17693timerfd_create.2
17694pthread_getcpuclockid.3
17695ualarm.3
17696usleep.3
17697pthreads.7
17698time.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,
80e1913a 17702 so these interfaces are system calls. Although there are as yet
0c094170
MK
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
17708Changes to individual pages
17709---------------------------
17710
17711capget.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
17721clock_getres.2
17722 Michael Kerrisk
17723 Move page from Section 3 to Section 2
17724
17725eventfd.2
17726 Michael Kerrisk
17727 glibc eventfd() supports the use of eventfd2() since version 2.9
17728
17729fork.2
17730 Michael Kerrisk
17731 SEE ALSO: add daemon(3)
17732
17733getdents.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
17740nanosleep.2
17741 Michael Kerrisk
17742 Relocated misplaced BUGS heading
17743
17744select_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
17757socket.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
17763stat.2
17764 Michael Kerrisk
17765 Note that open(O_NOATIME) also causes st_atime not to be updated
17766
17767timerfd_create.2
17768 Michael Kerrisk
17769 Add BUGS noting that timerfd supports fewer clock types than
17770 timer_create()
17771
17772btowc.3
17773 Michael Kerrisk
17774 SEE ALSO: add wctob(3)
17775
17776clock_getcpuclockid.3
17777 Michael Kerrisk
17778 SEE ALSO: add pthread_getcpuclockid(3)
17779
17780cos.3
17781 Michael Kerrisk
17782 SEE ALSO: add sincos(3)
17783
17784fexecve.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
17793fmemopen.3
17794 Michael Kerrisk
17795 CONFORMING TO: note that these functions are in POSIX.1-2008
17796
17797getifaddrs.3
17798 Lucio Maciel
17799 Fix memory leak in example program
17800 Petr Baudis
17801 Various small fixes
17802
17803getpwnam.3
17804 Michael Kerrisk
17805 SEE ALSO: add getspnam(3)
17806
17807getumask.3
17808 Michael Kerrisk
17809 Updated glibc version number in NOTES
17810
17811ilogb.3
17812 Michael Kerrisk
17813 SEE ALSO: add significand(3)
17814
17815intro.3
17816 Michael Kerrisk
17817 SEE ALSO: add libc(7)
17818
17819isalpha.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
17826mq_notify.3
17827 Michael Kerrisk
17828 Add cross reference to pthread_attr_init(3)
17829
17830pthread_attr_setaffinity_np.3
17831 Michael Kerrisk
17832 SYNOPSIS: Fix declaration of 'attr'
17833
17834pthread_getcpuclockid.3
17835 Michael Kerrisk
17836 SYNOPSIS: fix type of 'thread'
17837
17838qsort.3
17839 Michael Kerrisk
4e434fc1 17840 EXAMPLE: remove unnecessary "#include <unistd.h>"
0c094170
MK
17841
17842random.3
17843 Michael Kerrisk
17844 SEE ALSO: add random_r(3)
17845
17846remainder.3
17847 Michael Kerrisk
17848 SEE ALSO: add div(3)
17849
17850scandir.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
17857sem_wait.3
17858 Michael Kerrisk
1fa67ee4 17859 SEE ALSO: add clock_gettime(2)
0c094170
MK
17860
17861significand.3
17862 Michael Kerrisk
17863 Add CONFORMING TO noting that this function is unstandardized
17864
17865sigwait.3
17866 Michael Kerrisk
17867 Add EXAMPLES section referring to pthread_sigmask(3)
17868
17869sin.3
17870 Michael Kerrisk
17871 SEE ALSO: add sincos(3)
17872
17873stpcpy.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
0c094170
MK
17880 Michael Kerrisk
17881 SEE ALSO: add stpcpy.3
17882
17883wcscasecmp.3
17884 Michael Kerrisk
17885 CONFORMING TO: note that this function is added in POSIX.1-2008
17886
17887wcsdup.3
17888 Michael Kerrisk
17889 CONFORMING TO: note that this function was added in POSIX.1-2008
17890
17891wcsncasecmp.3
17892 Michael Kerrisk
17893 CONFORMING TO: note that this function is added in POSIX.1-2008
17894
17895wctob.3
17896 Michael Kerrisk
17897 SEE ALSO: add btowc(3)
17898
17899proc.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
17905ascii.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
17911epoll.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
17921koi8-r.7
17922 Michael Kerrisk
17923 SEE ALSO: add koi8-u(7); remove crufty text
17924
17925standards.7
17926 Michael Kerrisk
17927 Update to note that latest POSIX/SUS was ratified in 2008
17928
17929time.7
17930 Michael Kerrisk
17931 SEE ALSO: add pthread_getcpuclockid(3)
d1d32957
MK
17932
17933
17934==================== Changes in man-pages-3.19 ====================
17935
17936Released: 2009-02-20, Putaruru
17937
17938
17939Contributors
17940------------
17941
17942The following people contributed notes, ideas, or patches that have
17943been incorporated in changes in this release:
17944
17945Christian Siebert <christian.siebert@gmail.com>
17946Jan Engelhardt <jengelh@medozas.de>
17947Jens Thoms Toerring <jt@toerring.de>
17948Kir Kolyshkin <kir@openvz.org>
17949Mark Hills <mark@pogo.org.uk>
17950Michael Kerrisk <mtk.manpages@gmail.com>
17951Parag Warudkar <parag.lkml@gmail.com>
17952Peter Zijlstra <a.p.zijlstra@chello.nl>
17953Sami Liedes <sliedes@cc.hut.fi>
17954
17955Apologies if I missed anyone!
17956
17957
17958New and rewritten pages
17959-----------------------
17960
17961timer_create.2
17962 Michael Kerrisk
17963 New page documenting timer_create(2)
17964
17965timer_delete.2
17966 Michael Kerrisk
17967 New page documenting timer_delete(2)
17968
17969timer_getoverrun.2
17970 Michael Kerrisk
17971 New page documenting timer_getoverrun(2)
17972
17973timer_settime.2
17974 Michael Kerrisk
17975 New page documenting timer_settime(2) and timer_gettime(2)
17976
17977
17978New and changed links
17979---------------------
17980
17981timer_gettime.2
17982 Michael Kerrisk
17983 New link to new timer_settime.2
17984
17985
17986Global changes
17987--------------
17988
17989Various 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
18034Changes to individual pages
18035---------------------------
18036
4f6e9f03
MK
18037getitimer.2
18038clock_getcpuclockid.3
18039time.7
d1d32957
MK
18040 Michael Kerrisk
18041 SEE ALSO: add timer_create(2)
18042
18043getitimer.2
18044 Michael Kerrisk
18045 Rename arguments for consistency with other timer pages
18046 Also some other minor wording improvements
18047
18048splice.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
18060syscalls.2
18061 Michael Kerrisk
18062 Note that getpmsg(2) and putmsg(2) are unimplemented
2beeae40 18063 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=514771
d1d32957
MK
18064
18065timerfd_create.2
18066 Michael Kerrisk
18067 ERRORS: add EFAULT
18068
18069timerfd_create.2
18070 Michael Kerrisk
18071 Rename timerfd_settime() 'curr_value' arg to 'old_value'
18072 For consistency with related pages.
18073
18074vm86.2
18075 Parag Warudkar
18076 CONFORMING TO: Add 32-bit specific
18077 Note that this call is only on *32-bit* Intel
18078
18079mq_open.3
18080 Michael Kerrisk
18081 ERRORS: add ENOENT error for name == "/"
18082
18083mq_open.3
18084 Michael Kerrisk
18085 ERRORS: Add EACCES error for name containing > 1 slash
18086
18087sem_open.3
18088 Michael Kerrisk
18089 ERRORS: add EINVAL error where name == "/"
18090
18091sem_open.3
18092 Jens Thoms Toerring
18093 Add case of non-well-formed name to ENOENT
18094
18095shm_open.3
18096 Michael Kerrisk
18097 Clarify rules for construction of shared memory object names
18098
18099proc.5
18100 Michael Kerrisk
18101 Add description of /proc/sys/kernel/sysrq
18102 Reported by: Goerghe Cosorea <gheorghe.coserea@gmail.com>
18103
18104proc.5
18105 Michael Kerrisk
18106 Put /proc/modules entry in correct alphabetical order
18107
18108ascii.7
18109 Kir Kolyshkin
18110 Fix formatting of tables on second page to use monospaced font
18111
18112mq_overview.7
18113 Michael Kerrisk
18114 Clarify construction rules for message queue object names
18115
18116sem_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
7650b3fb
MK
18121
18122
18123==================== Changes in man-pages-3.20 ====================
18124
18125Released: 2009-03-31, Christchurch
18126
18127
18128Contributors
18129------------
18130
18131The following people contributed notes, ideas, or patches that have
18132been incorporated in changes in this release:
18133
18134Alan Curry <pacman@kosh.dhis.org>
33972b0b 18135Américo Wang <xiyou.wangcong@gmail.com>
7650b3fb
MK
18136Andi Kleen <andi@firstfloor.org>
18137Carlos O'Donell <carlos@systemhalted.org>
18138Chunming Chang <cchang@aerohive.com>
18139Colin Watson <cjwatson@debian.org>
a0797331 18140Eelco Dolstra <e.dolstra@tudelft.nl>
7650b3fb
MK
18141Jan Engelhardt <jengelh@medozas.de>
18142Jens Thoms Toerring <jt@toerring.de>
18143Johannes Stezenbach <js@sig21.net>
18144Leandro A. F. Pereira <leandro@tia.mat.br>
18145Martin Gebert <martin.gebert@alpha-bit.de>
18146Michael Kerrisk <mtk.manpages@gmail.com>
459c4286 18147Mike O'Connor <stew@vireo.org>
7650b3fb
MK
18148Mike Frysinger <vapier@gentoo.org>
18149Nikanth Karthikesan <knikanth@suse.de>
18150Reuben Thomas <rrt@femur.dyndns.org>
18151Reuben Thomas <rrt@sc3d.org>
18152Roland McGrath <roland@redhat.com>
18153Sam Varshavchik <mrsam@courier-mta.com>
18154Simon Gomizelj <simongmzlg@gmail.com>
18155Tanaka Akira <akr@fsij.org>
18156Teddy Hogeborn <teddy@fukt.bsnet.se>
18157Walter Jontofsohn <wjontofs@atriumberlin.de>
18158
18159Apologies if I missed anyone!
18160
18161
18162New and rewritten pages
18163-----------------------
18164
18165cpuid.4
18166 Andi Kleen
18167 New page for cpuid access device
18168
18169msr.4
18170 Andi Kleen
18171 New page documenting x86 CPU MSR access device
18172
18173
18174Newly documented interfaces in existing pages
18175---------------------------------------------
18176
18177proc.5
33972b0b 18178 Américo Wang
7650b3fb
MK
18179 Document /proc/sys/vm/swappiness
18180 Michael Kerrisk
18181 Document /proc/sysrq-trigger
18182
18183
18184Global changes
18185--------------
18186
18187timer_create.2
18188timer_delete.2
18189timer_getoverrun.2
18190timer_settime.2
18191numa.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
18197mempcpy.3
18198signbit.3
18199significand.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
c89b11cc 18204 did not acknowledge the FSF copyright on the original material.
7650b3fb
MK
18205 Fix that.
18206
18207accept.2
18208read.2
18209recv.2
18210send.2
18211write.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
18230basename.3
18231getgrent.3
18232getgrnam.3
18233getpwent.3
18234getpwnam.3
18235readdir.3
18236 Michael Kerrisk
18237 Note that returned pointer should not be given to free()
18238
18239armscii-8.7
18240cp1251.7
18241iso_8859-10.7
18242iso_8859-11.7
18243iso_8859-13.7
18244iso_8859-14.7
18245iso_8859-15.7
18246iso_8859-16.7
18247iso_8859-2.7
18248iso_8859-3.7
18249iso_8859-4.7
18250iso_8859-5.7
18251iso_8859-6.7
18252iso_8859-7.7
18253iso_8859-8.7
18254iso_8859-9.7
18255koi8-r.7
18256koi8-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
18273Changes to individual pages
18274---------------------------
18275
18276fallocate.2
18277 Michael Kerrisk
18278 VERSIONS: glibc support is provided since version 2.10
18279
18280fcntl.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
18288getcontext.2
18289 Michael Kerrisk
18290 Note that POSIX.1-2008 removes the specification of getcontext()
18291
18292getitimer.2
18293 Michael Kerrisk
18294 Note that POSIX.1-2008 recommends POSIX timers API instead of this API
18295
18296gettimeofday.2
18297 Michael Kerrisk
18298 Note that POSIX.1-2008 recommends clock_gettime() instead of this API
18299
18300ptrace.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
18306ptrace.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
18312recv.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
18318rename.2
18319 Michael Kerrisk
18320 Make ENOENT description consistent with POSIX.1-2008
18321
18322timerfd_create.2
18323 Michael Kerrisk
18324 ERRORS: add EINVAL for invalid 'flags' for timer_settime()
18325
18326truncate.2
18327 Michael Kerrisk
18328 SYNOPSIS: Fix description of feature test macro requirements
18329 After a report by Arvid Norlander.
18330
18331bcopy.3
18332 Michael Kerrisk
18333 Note that POSIX.1-2008 removes specification of bcopy()
18334
18335bsd_signal.3
18336 Michael Kerrisk
18337 Note that POSIX.1-2008 recommends sigaction(2) instead of this API
18338
18339ctime.3
18340 Michael Kerrisk
18341 Note that POSIX.1-2008 recommends strftime(3) instead of these functions
18342
18343ecvt.3
18344 Michael Kerrisk
18345 Note that POSIX.1-2008 recommends sprintf(3) instead of these functions
18346
18347gcvt.3
18348 Michael Kerrisk
18349 Note that POSIX.1-2008 recommends sprintf(3) instead of this function
18350
18351getcwd.3
18352 Michael Kerrisk
18353 Note that getcwd() should be used instead of the obsolete getwd()
18354
18355getgrent.3
18356 Michael Kerrisk
18357 Returned buffer may be statically allocated and overwritten by
18358 later calls
18359
18360gethostbyname.3
18361 Michael Kerrisk
18362 POSIX.1-2008 recommends getaddrinfo(3) and getnameinfo(3) instead
18363
18364getnetent_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
18371getpwent.3
18372 Michael Kerrisk
18373 Returned buffer may be statically allocated and overwritten by
18374 later calls
18375
18376index.3
18377 Michael Kerrisk
18378 Note that POSIX.1-2008 recommends strchr(3) and strrchr(3) instead
18379
18380isalpha.3
18381 Michael Kerrisk
18382 Explain why POSIX.1-2008 marks isascii(3) obsolete
18383
18384lockf.3
18385 Nikanth Karthikesan
18386 Update pointer to documentation in kernel source
18387
18388makecontext.3
18389 Michael Kerrisk
18390 Note that POSIX.1-2008 recommends the use of POSIX threads instead
18391
18392mq_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
18399posix_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
18404posix_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
18409posix_memalign.3
18410 Michael Kerrisk
18411 Document handling of size==0 case for posix_memalign()
18412
18413pthread_exit.3
18414 Michael Kerrisk
18415 Fix error in DESCRIPTION: s/pthread_create/pthread_exit/
18416
18417realpath.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
18427scalb.3
18428 Michael Kerrisk
18429 Note that POSIX.1-2008 recommends scalbln*(3) instead
18430
18431seekdir.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
18438sem_post.3
18439 Michael Kerrisk
18440 Document EOVERFLOW error
18441
18442shm_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
18448siginterrupt.3
18449 Michael Kerrisk
18450 Note that POSIX.1-2008 recommends sigaction() instead
18451
18452sigset.3
18453 Michael Kerrisk
18454 Note APIs that POSIX.1-2008 recommends instead of these obsolete APIs
18455
18456strftime.3
18457 Michael Kerrisk
18458 Small fix to description of %G
18459 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=516677
18460
18461strftime.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
18467strftime.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
18474telldir.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
18481timeradd.3
18482 Michael Kerrisk
18483 Note that on some systems, <=, >=, == don't work for timercmp()
18484
18485timeradd.3
18486 Michael Kerrisk
18487 SYNOPSIS: Fix return types of timerisset() and timercmp()
18488
18489toascii.3
18490 Michael Kerrisk
18491 Note why POSIX.1-2008 marks this function obsolete
18492
18493console_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
18498group.5
18499 Michael Kerrisk
18500 Various minor rewordings and improvements
18501
18502resolv.conf.5
18503 Michael Kerrisk
18504 Document 'ip6-bytestring' option
18505
18506resolv.conf.5
18507 Michael Kerrisk
18508 Document 'edns0' option
18509
18510resolv.conf.5
18511 Michael Kerrisk
18512 Document 'ip6-dotint' / 'no-ip6-dotint' option
18513
18514resolv.conf.5
18515 Michael Kerrisk
18516 Note that maximum value of 'ndots' option is capped to 15
18517
18518resolv.conf.5
18519 Michael Kerrisk
18520 Note that maximum value of 'timeout' option is capped to 30
18521
18522hier.7
18523 Michael Kerrisk
18524 Add description of /srv
18525 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=520904
18526
18527ip.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
18533ipv6.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
18541mq_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
18547rtld-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
18553sem_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.
2ebad1b1
MK
18559
18560
18561==================== Changes in man-pages-3.21 ====================
18562
18563Released: 2009-04-15, Los Gatos
18564
18565
18566Contributors
18567------------
18568
18569The following people contributed notes, ideas, or patches that have
18570been incorporated in changes in this release:
18571
18572Frank Dana <ferdnyc@gmail.com>
18573Michael Kerrisk <mtk.manpages@gmail.com>
18574Roman Byshko <rbyshko@gmail.com>
18575
18576Apologies if I missed anyone!
18577
18578
18579New and rewritten pages
18580-----------------------
18581
18582pthread_setconcurrency.3
18583 Michael Kerrisk
18584 New page documenting pthread_setconcurrency(3) and
18585 pthread_getconcurrency(3)
18586
18587pthread_yield.3
18588 Michael Kerrisk
18589 New page documenting pthread_yield(3)
18590
18591
18592New and changed links
18593---------------------
18594
18595pthread_getconcurrency.3
18596 Michael Kerrisk
18597 New link to new pthread_setconcurrency(3)
18598
18599Changes to individual pages
18600---------------------------
18601
18602initrd.4
18603 Michael Kerrisk
18604 Various minor wording improvements
18605
18606initrd.4
18607 Frank Dana
18608 Add missing word in description
18609
18610feature_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
18622ldconfig.8
18623 Michael Kerrisk
18624 /etc/ld.so.conf also include libraries found in /lib and /usr/lib
d916780f
MK
18625
18626
18627==================== Changes in man-pages-3.22 ====================
18628
18629Released: 2009-07-25, Munich
18630
18631
18632Contributors
18633------------
18634
18635The following people contributed notes, ideas, or patches that have
18636been incorporated in changes in this release:
18637
18638Adrian Dewhurst <sailor@sailorfrag.net>
18639Alexander Lamaison <awl03@doc.ic.ac.uk>
33972b0b 18640Bryan Østergaard <kloeri@exherbo.org>
d916780f
MK
18641Christopher Head <chead@telus.net>
18642Doug Goldstein <cardoe@gentoo.org>
18643Florentin Duneau <fduneau@gmail.com>
18644Gokdeniz Karadag <gokdenizk@gmail.com>
18645Jeff Moyer <jmoyer@redhat.com>
18646KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
18647Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
18648Mark Hills <mark@pogo.org.uk>
18649Michael Kerrisk <mtk.manpages@gmail.com>
18650Mike Frysinger <vapier@gentoo.org>
18651Petr Baudis <pasky@suse.cz>
33972b0b 18652Reimar Döffinger <Reimar.Doeffinger@gmx.de>
d916780f
MK
18653Ricardo Garcia <rg3.zeluan@gmail.com>
18654Rui Rlex <rui.rlex@gmail.com>
18655Shachar Shemesh <shachar@debian.org>
18656Tolga Dalman <tdalman@project-psi.org>
18657ku roi <kuroibox@yahoo.de>
18658sobtwmxt <sobtwmxt@sdf.lonestar.org>
18659
18660Apologies if I missed anyone!
18661
18662
18663Changes to individual pages
18664---------------------------
18665
18666clone.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
18681execve.2
18682 Mike Frysinger
18683 Remove erroneous statement that pending signal set is cleared
18684 on execve(2).
18685
18686fcntl.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
18692flock.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
18699fork.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
18712getdents.2
18713 Michael Kerrisk
18714 The d_type field is fully supported on Btrfs
18715
18716mount.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
18723poll.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
18755sigaction.2
18756 Michael Kerrisk
1f9b0839 18757 Expand description of si_utime and si_stime fields of siginfo_t
d916780f
MK
18758
18759stat.2
18760 Michael Kerrisk
18761 Improve wording of ENOTDIR error
18762
18763syscalls.2
18764 Michael Kerrisk
1f9b0839 18765 Add preadv() and pwritev(), new in kernel 2.6.30
d916780f
MK
18766
18767wait.2
18768 Gokdeniz Karadag
18769 Document CLD_DUMPED and CLD_TRAPPED si_code values
18770
18771daemon.3
18772 Michael Kerrisk
18773 Clarify discussion of 'noclose' and 'nochdir' arguments
18774
18775ffs.3
18776 Petr Baudis
18777 SEE ALSO: add memchr(3)
18778
18779fmemopen.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
18793lockf.3
18794 Michael Kerrisk
18795 Clarify relationship between fcntl() and lockf() locking
18796
18797memchr.3
18798 Petr Baudis
18799 SEE ALSO: add ffs(3)
18800
18801readdir.3
18802 Michael Kerrisk
18803 The d_type field is fully supported on Btrfs
18804
18805setjmp.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
18812strcmp.3
18813 Petr Baudis
18814 SEE ALSO: add strverscmp(3)
18815
18816strcpy.3
18817 Mark Hills
18818 SEE ALSO: Add strdup(3)
18819
18820complex.7
18821 Michael Kerrisk
18822 Add missing header file for example program
33972b0b 18823 Reimar Döffinger
d916780f
MK
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
18832environ.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
18839mq_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
18845standards.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.
52725cd9
MK
18851
18852
18853==================== Changes in man-pages-3.23 ====================
18854
18855Released: 2009-09-30, Munich
18856
18857
18858Contributors
18859------------
18860
18861The following people contributed notes, ideas, or patches that have
18862been incorporated in changes in this release:
18863
18864Aaron Gardner <aaron.j.gardner@gmail.com>
18865Andrey Vihrov <vihrov@gmail.com>
18866Christoph Hellwig <hch@lst.de>
18867Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
18868Leslie P. Polzer <sky@viridian-project.de>
18869Marc Lehmann <debian-reportbug@plan9.de>
18870Mark Hills <mark@pogo.org.uk>
18871Michael Kerrisk <mtk.manpages@gmail.com>
18872Mike Frysinger <vapier@gentoo.org>
33972b0b 18873Nicolas François <nicolas.francois@centraliens.net>
52725cd9
MK
18874Serge Hallyn <serue@us.ibm.com>
18875Siward de Groot <siward@ziggo.nl>
18876rui rlex <rui.rlex@gmail.com>
18877
18878Apologies if I missed anyone!
18879
18880
18881Changes to individual pages
18882---------------------------
18883
18884execve.2
18885pipe.2
18886tee.2
18887fmemopen.3
18888mq_notify.3
18889qsort.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
18912getrusage.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
18918mmap.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
18924open.2
18925 Christoph Hellwig
18926 add some comments on O_SYNC and friends
18927
18928poll.2
18929 Michael Kerrisk
18930 Clarify wording describing of 'nfds' argument.
18931 reported by: rui rlex <rui.rlex@gmail.com>
18932
18933semctl.2
33972b0b 18934 Nicolas François
52725cd9
MK
18935 Remove some redundant words
18936
18937setpgid.2
18938 Michael Kerrisk
18939 Add an explanation of orphaned process groups
18940
18941splice.2
18942tee.2
18943vmsplice.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
18949stat.2
33972b0b 18950 Nicolas François
52725cd9
MK
18951 Fix small bug in example program
18952 Since it is a failure, EXIT_FAILURE looks more appropriate
18953 than EXIT_SUCCESS.
18954
18955umount.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
18960exit.3
18961 Michael Kerrisk
18962 Add a pointer to explanation of orphaned process groups in setpgid(2)
18963
18964fflush.3
18965 Michael Kerrisk
18966 fflush() discards buffered input
18967
18968ffs.3
18969 Michael Kerrisk
18970 Clarify that ffsl() and ffsll() are GNU extensions
18971
18972getaddrinfo.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
18979getmntent.3
18980 Mike Frysinger
18981 setmntent() argument is 'filename' not 'fp'
18982 The description of setmntent() formerly used the wrong
18983 argument name.
18984
18985posix_fallocate.3
33972b0b 18986 Nicolas François
52725cd9
MK
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
18992setenv.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
18999strftime.3
33972b0b 19000 Nicolas François
52725cd9
MK
19001 Fix error in description: s/Monday/Thursday/
19002
19003proc.5
33972b0b 19004 Nicolas François
52725cd9
MK
19005 Fix page cross reference
19006 max_user_watches is better explained in epoll(7) than inotify(7).
19007
19008proc.5
19009 Michael Kerrisk
19010 dmesg is in section 1, not section 8
19011
19012capabilities.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
19018capabilities.7
19019 Michael Kerrisk
4c88340a 19020 Fix version number for CAP_MKNOD in FS UID manipulations
52725cd9
MK
19021 A recent patch said "since 2.6.29". It should have
19022 been "since 2.6.30".
19023
19024capabilities.7
33972b0b 19025 Nicolas François
52725cd9
MK
19026 Reword a bad sentence in description of capability bounding set.
19027
19028mq_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
19034tcp.7
19035udp.7
33972b0b 19036 Nicolas François
52725cd9 19037 Replace references to syctl interfaces with /proc
257c8284
MK
19038
19039
19040==================== Changes in man-pages-3.24 ====================
19041
19042Released: 2010-02-25, Munich
19043
19044
19045Contributors
19046------------
19047
19048The following people contributed notes, ideas, or patches that have
19049been incorporated in changes in this release:
19050
19051Andi Kleen <andi@firstfloor.org>
19052Andries E. Brouwer <Andries.Brouwer@cwi.nl>
19053Ansgar Burchardt <ansgar@2008.43-1.org>
84a589d2 19054Bela Lubkin <filbo@armory.com>
257c8284
MK
19055Bill O. Gallmeister <bog.kernel@gmail.com>
19056Christoph Hellwig <hch@lst.de>
19057Colin Watson <cjwatson@debian.org>
19058Dan Jacobson <jidanni@jidanni.org>
19059David Howells <dhowells@redhat.com>
19060Denis Barbier <bouzim@gmail.com>
19061Doug Manley <doug.manley@gmail.com>
19062Edward Welbourne <eddy@opera.com>
19063Fang Wenqi <anton.fang@gmail.com>
33972b0b 19064Frédéric Brière <fbriere@fbriere.net>
257c8284 19065Garrett Cooper <yaneurabeya@yahoo.com>
84a589d2 19066Ihar Hrachyshka <ihar.hrachyshka@gmail.com>
257c8284
MK
19067Jann Poppinga <jann.poppinga@gmx.de>
19068Jason Goldfine-Middleton <jasonwoodfine@gmail.com>
19069Jason Noakes <jjnoakes@gmail.com>
19070Jonathan Nieder <jrnieder@gmail.com>
19071Kevin <tsubasa.xw@gmail.com>
19072Mark Hills <mark@pogo.org.uk>
19073Markus Peuhkuri <puhuri@iki.fi>
19074Michael Kerrisk <mtk.manpages@gmail.com>
19075Michael Witten <mfwitten@gmail.com>
19076Mike Frysinger <vapier@gentoo.org>
19077Sam Liao <phyomh@gmail.com>
19078Samy Al Bahra <sbahra@repnop.org>
19079Stuart Kemp <skemp@alertlogic.com>
19080sunjiangangok <sunjiangangok@gmail.com>
19081Tobias Stoeckmann <tobias@bugol.de>
19082Vlastimil Babka <caster@gentoo.org>
19083Yuri Kozlov <yuray@komyakino.ru>
19084
19085Apologies if I missed anyone!
19086
19087
19088New and rewritten pages
19089-----------------------
19090
19091add_key.2
19092 David Howells
19093 New page documenting add_key(2)
19094 Taken from keyutils-1.1 package.
19095
19096keyctl.2
19097 David Howells
19098 New page documenting keyctl(2)
19099 Taken from keyutils-1.1 package.
19100
19101request_key.2
19102 David Howells
19103 New page documenting request_key(2)
19104 Taken from keyutils-1.1 package.
19105
19106
19107Global changes
19108--------------
19109
19110Various pages
19111 Michael Kerrisk
19112 Global fix: s/non-root/unprivileged/
19113
19114Various pages
19115 Michael Kerrisk
19116 Global fix: s/non-privileged/unprivileged/
19117
19118Various pages
19119 Michael Kerrisk
19120 Global fix: /non-superuser/unprivileged user/
19121
19122Various pages
19123 Michael Kerrisk
19124 s/non-/non/
19125 The tendency in English, as prescribed in style guides like
5fab2e7c 19126 Chicago MoS, is toward removing hyphens after prefixes
257c8284
MK
19127 like "non-" etc.
19128
19129Various pages
19130 Michael Kerrisk
19131 Global fix: s/re-/re/
19132 The tendency in English, as prescribed in style guides like
5fab2e7c 19133 Chicago MoS, is toward removing hyphens after prefixes
257c8284
MK
19134 like "re-" etc.
19135
19136Various pages
19137 Michael Kerrisk
19138 Global fix: s/multi-/multi/
19139 The tendency in English, as prescribed in style guides like
5fab2e7c 19140 Chicago MoS, is toward removing hyphens after prefixes
257c8284
MK
19141 like "multi-" etc.
19142
19143Various pages
19144 Michael Kerrisk
19145 Global fix: s/pre-/pre/
19146 The tendency in English, as prescribed in style guides like
5fab2e7c 19147 Chicago MoS, is toward removing hyphens after prefixes
257c8284
MK
19148 like "pre-" etc.
19149
19150Various pages
19151 Michael Kerrisk
19152 Global fix: s/sub-/sub/
19153 The tendency in English, as prescribed in style guides like
5fab2e7c 19154 Chicago MoS, is toward removing hyphens after prefixes
257c8284
MK
19155 like "sub-" etc.
19156
19157stime.2
19158time.2
19159utimensat.2
19160ctime.3
19161difftime.3
19162ftime.3
19163getspnam.3
19164mq_receive.3
19165mq_send.3
19166rtime.3
19167sem_wait.3
19168strftime.3
19169strptime.3
19170timeradd.3
19171rtc.4
19172core.5
19173proc.5
19174icmp.7
19175time.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
19187spu_create.2
19188getopt.3
19189passwd.5
19190 Michael Kerrisk
19191 Global fix: s/non-existing/nonexistent/
19192
19193faccessat.2
19194fchmodat.2
19195fchownat.2
19196fstatat.2
19197futimesat.2
19198linkat.2
19199mkdirat.2
19200mknodat.2
19201openat.2
19202readlinkat.2
19203renameat.2
19204symlinkat.2
19205unlinkat.2
19206utimensat.2
19207mkfifoat.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
19215Changes to individual pages
19216---------------------------
19217
19218clock_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
19225execve.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
19231fcntl.2
19232 Michael Kerrisk
19233 s/F_OWNER_GID/F_OWNER_PGRP/
19234 Peter Zijlstra took the name change I suggested.
257c8284
MK
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
f9ea407c
MK
19241intro.2
19242intro.3
257c8284
MK
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
19248sendfile.2
19249 Michael Kerrisk
e39f6d0a 19250 Clarify behavior when 'offset' is NULL
257c8284
MK
19251
19252seteuid.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
19260setgid.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
19268setreuid.2
19269 Michael Kerrisk
19270 Add more detail on POSIX.1 specification for these syscalls
19271
19272setuid.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
f9ea407c
MK
19277stime.2
19278strftime.3
19279tzset.3
19280zic.8
257c8284
MK
19281 Michael Witten
19282 GMT -> UTC (where appropriate)
19283
19284sync_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
19290CPU_SET.3
19291 Vlastimil Babka
19292 SYNOPSIS: Fix return types for CPU_COUNT_*()
19293 These functions return 'int' not void'.
19294
19295confstr.3
19296 Michael Kerrisk
19297 Fix feature test macro requirements
19298
19299daemon.3
19300 Michael Kerrisk
19301 Fix description of 'nochdir' argument.
19302 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=554819
19303
19304gethostbyname.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
19310getline.3
19311 Michael Kerrisk
19312 Update to reflect that these functions were standardized in POSIX.1-2008
19313
19314getnameinfo.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
19320getopt.3
19321 Jonathan Nieder
19322 Fix feature test macro requirements
19323
19324memchr.3
19325 Michael Kerrisk
19326 Add feature text macro requirements for memrchr()
19327
19328nextafter.3
19329 Michael Kerrisk
19330 Fix notable error in DESCRIPTION.
19331 "less than y" should be "less than x".
19332
19333popen.3
19334 Michael Kerrisk
19335 Fix feature test macro requirements
19336
4f6e9f03
MK
19337pthread_attr_setdetachstate.3
19338pthread_attr_setschedparam.3
19339pthread_attr_setschedpolicy.3
257c8284
MK
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
19345rtnetlink.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
19353sched_getcpu.3
19354 Michael Kerrisk
19355 Place correct header file in SYNOPSIS
19356
19357sleep.3
19358 Bill O. Gallmeister
19359 sleep() puts calling *thread* to sleep (not calling *process*)
19360
19361sleep.3
19362 Bill O. Gallmeister
19363 Add nanosleep(2) to SEE ALSO
19364
19365strftime.3
19366 Michael Kerrisk
19367 %z is defined in SUSv3
e39f6d0a 19368 So, substitute "GNU" tag in man page by "SU".
257c8284
MK
19369
19370strftime.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
19385strftime.3
19386 Michael Witten
19387 Expand introductory text
19388
19389strftime.3
19390 Michael Witten
19391 Clarification of %z specifier
19392
19393string.3
19394 Mark Hills
19395 Add stpcpy() to this list of string functions
19396
19397strptime.3
19398 Michael Kerrisk
19399 Initialize tm structure in example program
19400
19401undocumented.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
19416group.5
19417 Michael Kerrisk
19418 s/passwd/password/
19419 The page inconsistently used "passwd" and "password"
19420 to refer to the same field.
19421
19422capabilities.7
19423 Michael Kerrisk
19424 Update securebits discussion to use SECBIT_* flags
19425
19426feature_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
19431path_resolution.7
19432 Michael Kerrisk
19433 Add readlink(2) to SEE ALSO
257c8284
MK
19434 Michael Kerrisk
19435 Fix NAME line
e39f6d0a 19436 The poorly constructed part preceding "\-" causes apropos
257c8284
MK
19437 not to be able to find the subject.
19438
19439 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=558300
19440
19441signal.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
a8a9768e
MK
19446
19447
19448==================== Changes in man-pages-3.25 ====================
19449
19450Released: 2010-06-20, Munich
19451
19452
19453Contributors
19454------------
19455
19456The following people contributed notes, ideas, or patches that have
19457been incorporated in changes in this release:
19458
19459Alexander E. Patrakov <patrakov@gmail.com>
19460Andi Kleen <andi@firstfloor.org>
19461Andrew Klossner <andrew@cesa.opbu.xerox.com>
33972b0b 19462André Goddard Rosa <andre.goddard@gmail.com>
a8a9768e
MK
19463Bo Borgerson <gigabo@gmail.com>
19464Christian Franke <nobody@nowhere.ws>
19465Daisuke HATAYAMA <d.hatayama@jp.fujitsu.com>
19466David Sommerseth <davids@redhat.com>
19467Denis Barbier <bouzim@gmail.com>
19468Eric Blake <ebb9@byu.net>
19469Fang Wenqi <anton.fang@gmail.com>
19470Francesco Cosoleto <cosoleto@gmail.com>
19471Gernot Tenchio <gernot@tenchio.de>
19472Hugh Dickins <hughd@google.com>
19473Ivana Hutarova Varekova <varekova@redhat.com>
19474Jan Blunck <jblunck@novell.com>
19475Jan Engelhardt <jengelh@medozas.de>
19476Jan Kara <jack@suse.cz>
19477Jeff Barry <JeffBatHome@myletters.us>
19478Manfred Schwarb <manfred99@gmx.ch>
19479Mark Hills <mark@pogo.org.uk>
19480Martin (Joey) Schulze <joey@infodrom.org>
19481Michael Kerrisk <mtk.manpages@gmail.com>
19482Mihai Paraschivescu <paraschivescu_mihail@yahoo.com>
19483Mike Frysinger <vapier@gentoo.org>
19484Miklos Szeredi <miklos@szeredi.hu>
19485Petr Baudis <pasky@suse.cz>
19486Petr Gajdos <pgajdos@suse.cz>
19487Petr Uzel <petr.uzel@suse.cz>
19488Pierre Habouzit <madcoder@madism.org>
19489Reuben Thomas <rrt@sc3d.org>
19490Rob Landley <rob@landley.net>
19491Robert Wohlrab <robert.wohlrab@gmx.de>
19492Serge E. Hallyn <serge@hallyn.com>
19493Tolga Dalman <tdalman@project-psi.org>
19494Tom Swigg <swiggtc@lsbu.ac.uk>
19495Walter Harms <wharms@bfs.de>
19496Yuri Kozlov <yuray@komyakino.ru>
19497
19498Apologies if I missed anyone!
19499
19500
19501New and rewritten pages
19502-----------------------
19503
19504migrate_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
19511quotactl.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
80e1913a 19516 page in the "quota-tools" package. The page in "quota-tools"
a8a9768e
MK
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
19523Newly documented interfaces in existing pages
19524---------------------------------------------
19525
19526fcntl.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
19532madvise.2
19533 Andi Kleen
19534 Document MADV_HWPOISON
19535 Michael Kerrisk
19536 Added documentation of MADV_MERGEABLE and MADV_UNMERGEABLE
acf73593 19537 These flags (used for Kernel Samepage Merging, KSM)
a8a9768e
MK
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
19543mmap.2
19544 Michael Kerrisk
19545 Document MAP_UNINITIALIZED flag
19546 New in Linux 2.6.33.
19547
19548prctl.2
19549 Andi Kleen
19550 Document the hwpoison prctls in 2.6.32
19551
19552sched_setscheduler.2
19553 Michael Kerrisk
19554 Document SCHED_RESET_ON_FORK
19555 New in Linux 2.6.32
19556
19557umount.2
19558 Michael Kerrisk
19559 Document UMOUNT_NOFOLLOW
19560 New in Linux 2.6.34.
19561
19562mkstemp.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
19568proc.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
19580socket.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
19586New and changed links
19587---------------------
19588
19589fstatvfs.2
19590 Michael Kerrisk
19591 Adjust link to point to Section 3
19592
19593fstatvfs.3
19594statvfs.2
19595 Michael Kerrisk
19596 New link to page relocated to Section 3
19597
19598mkstemps.3
19599mkostemps.3
19600 Michael Kerrisk
19601 New links to mkstemp.3
19602 mkstemp.3 now describes mkstemps(3) and mkostemps(3).
19603
19604timer_create.2
19605timer_delete.2
19606timer_getoverrun.2
19607timer_settime.2
19608getline.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
19614Global changes
19615--------------
19616
19617open.2
19618sync_file_range.2
19619umount.2
19620 Michael Kerrisk
19621 Global fix: s/filesystem/file system/
19622
19623
19624Changes to individual pages
19625---------------------------
19626
19627fcntl.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
19633futex.2
19634 Michael Kerrisk
19635 Various fixes in SEE ALSO
19636
19637getpriority.2
19638nice.2
19639 Francesco Cosoleto
19640 Move renice from section 8 to section 1
19641
19642getrusage.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
19652mlock.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
19657mount.2
19658 Petr Uzel
19659 Fix incorrect path
19660
19661move_pages.2
19662 Andi Kleen
19663 Clarify includes/libraries
19664
19665mremap.2
19666 Michael Kerrisk
19667 Clarify existence of fifth argument.
19668
19669msgctl.2
19670semctl.2
19671shmctl.2
19672 Francesco Cosoleto
19673 Move ipcs from section 8 to section 1
19674
19675open.2
19676 Michael Kerrisk
19677 Remove ambiguity in text on NFS and O_EXCL.
19678
19679poll.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
19687posix_fadvise.2
19688 Michael Kerrisk
19689 Add sync_file_range(2) under SEE ALSO
19690
19691prctl.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
19698select_tut.2
19699 Michael Kerrisk
19700 Fix bug in example program
19701
19702sigaction.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
19716statfs.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
19724statvfs.2
19725 Michael Kerrisk
19726 Move this page to section 3 (since it's a library call)
19727
19728swapon.2
19729 Ivana Hutarova Varekova
c83dec45 19730 Note effect of CONFIG_MEMORY_FAILURE on MAX_SWAPFILES
a8a9768e
MK
19731 From 2.6.32, MAX_SWAPFILES is decreased by 1 if the kernel is
19732 built with CONFIG_MEMORY_FAILURE.
19733
19734syscalls.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
19740cproj.3
19741 Michael Kerrisk
19742 Note fix for C99 conformance in glibc 2.12.
19743
19744crypt.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
19761fmemopen.3
19762 Michael Kerrisk
19763 Bug fix in example program
19764
19765ftw.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
19775getaddrinfo.3
19776 Christian Franke
19777 Fix a field name mixup: s/ai_family/ai_flags/
19778
19779getline.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
19791log.3
19792log10.3
19793log2.3
19794 Jan Engelhardt
19795 Add cross-references to other-base logarithmic functions
19796
19797opendir.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
19803openpty.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
19811resolver.3
19812 Michael Kerrisk
19813 Fix declaration of dn_comp() in SYNOPSIS
19814 Remove the second 'exp_dn' from the calling signature.
19815
19816termios.3
19817 Michael Kerrisk
19818 Change NOFLSH text to speak of characters, not signals
19819
19820core.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
19827elf.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
19856filesystems.5
19857 Jeff Barry
19858 Add discussion of ntfs and ext4
19859
19860proc.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
19867services.5
19868 Yuri Kozlov
19869 Remove crufty reference to nonexistent BUGS section
19870
19871capabilities.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
19881signal.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
19887socket.7
19888 Michael Kerrisk
19889 Use consistent language to describe read-only socket options
19890
19891udp.7
19892 Michael Kerrisk
19893 Add FIONREAD warning.
2beeae40 19894 Warn that FIONREAD can't distinguish case of a zero-length
a8a9768e 19895 datagram from the case where no datagrams are available.
5ce60200
MK
19896
19897
19898==================== Changes in man-pages-3.26 ====================
19899
19900Released: 2010-09-04, Munich
19901
19902
19903Contributors
19904------------
19905
19906The following people contributed notes, ideas, or patches that have
19907been incorporated in changes in this release:
19908
19909Alexander Shishkin <virtuoso@slind.org>
19910Brian Sutin <Brian.Sutin@hs.utc.com>
19911Denis Barbier <bouzim@gmail.com>
19912Guillem Jover <guillem@hadrons.org>
19913Jianhua Li <jhlicc@gmail.com>
19914Linus Nilsson <lajnold@gmail.com>
19915Lenaic Huard <lenaic.huard@laposte.net>
fd2799f6 19916Mac <mac@mcrowe.com>
5ce60200
MK
19917Martin Schulze <joey@infodrom.org>
19918Maxin John <maxin.john@gmail.com>
19919Michael Kerrisk <mtk.manpages@gmail.com>
19920Nicholas Hunt <nhunt@cs.washington.edu>
19921Peng Haitao <penght@cn.fujitsu.com>
19922Peter Stuge <peter@stuge.se>
19923Przemyslaw Szczepaniak <Przemyslaw.Szczepaniak@imgtec.com>
19924Scott Walls <sawalls@umich.edu>
19925TAN Yee Fan <tanyeefa@comp.nus.edu.sg>
19926Wu Fengguang <fengguang.wu@intel.com>
19927Yitzchak Gale <gale@sefer.org>
19928Yuri Kozlov <yuray@komyakino.ru>
19929
19930Apologies if I missed anyone!
19931
19932Newly documented interfaces in existing pages
19933---------------------------------------------
19934
19935eventfd.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
19943Global changes
19944--------------
19945
19946getaddrinfo.3
19947getipnodebyname.3
19948st.4
19949 Michael Kerrisk
19950 s/logical OR/bitwise OR/
19951
19952
19953Changes to individual pages
19954---------------------------
19955
19956clock_nanosleep.2
19957 Michael Kerrisk
19958 Fix discussion of return value when interrupted by a signal
19959
19960epoll_ctl.2
19961 Yuri Kozlov
19962 Small fix to types in data structures
19963
19964eventfd.2
19965 Alexander Shishkin
19966 Clarified close-on-exec behavior
19967
19968madvise.2
19969 Michael Kerrisk
19970 Improve discussion of MADV_SOFT_OFFLINE
19971
19972mkdir.2
19973 Michael Kerrisk
19974 Add EMLINK error to ERRORS
19975
19976mq_getsetattr.2
19977mq_close.3
19978mq_getattr.3
19979mq_notify.3
19980mq_send.3
19981mq_unlink.3
19982 Lnac Huard
19983 Fix return type in SYNOPSIS (s/mqd_t/int/)
19984
19985recv.2
19986send.2
19987 Michael Kerrisk
19988 Remove obsolete reference to glibc version in NOTES
19989
19990recv.2
19991send.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
19998select.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
20005statfs.2
20006 Guillem Jover
20007 Fix copy & paste error for __SWORD_TYPE definition
20008
20009sysfs.2
20010 Michael Kerrisk
20011 Clarify that this syscall is obsolete.
20012 And strengthen recommendation to use /proc/filesystems instead.
20013
20014write.2
20015 Michael Kerrisk
20016 Add EDESTADDRREQ error
20017
20018a64l.3
20019 Peng Haitao
20020 Fix error in NOTES, s/a64l/l64a/
20021
20022error.3
20023 Linus Nilsson
20024 Change "perror" to "strerror" in DESCRIPTION of error()
20025
20026mq_send.3
20027 Michael Kerrisk
20028 Fix EAGAIN description (s/empty/full)
20029
20030initrd.4
20031 Yuri Kozlov
20032 Fix IP address in explanation of NFS example
20033
20034tzfile.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
f2f16c27
MK
20046
20047
20048==================== Changes in man-pages-3.27 ====================
20049
20050Released: 2010-09-22, Nuernberg
20051
20052
20053Contributors
20054------------
20055
20056The following people contributed notes, ideas, or patches that have
20057been incorporated in changes in this release:
20058
fd2799f6 20059caishuxian <caishuxian@gmail.com>
f2f16c27
MK
20060Denis Barbier <bouzim@gmail.com>
20061Denis Silakov <silakov@ispras.ru>
20062der Mouse <mouse@rodents-montreal.org>
20063Jan Kratochvil <jan.kratochvil@redhat.com>
20064Jim Belton <jim.belton@gmail.com>
20065Jiri Olsa <jolsa@redhat.com>
20066KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
20067Mark Hills <mark@pogo.org.uk>
20068Matthew Flaschen <matthew.flaschen@gatech.edu>
20069Michael Kerrisk <mtk.manpages@gmail.com>
20070Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
20071Petr Baudis <pasky@suse.cz>
20072Remi Denis-Courmont <remi@remlab.net>
20073Tanaka Akira <akr@fsij.org>
20074Tim Stoakes <tim@stoakes.net>
20075W. Trevor King <wking@drexel.edu>
20076Yuri Kozlov <yuray@komyakino.ru>
20077
20078Apologies if I missed anyone!
20079
20080
20081New and rewritten pages
20082-----------------------
20083
20084sigevent.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
20093Newly documented interfaces in existing pages
20094---------------------------------------------
20095
9de5210b
MK
20096ip.7
20097 Jiri Olsa
20098 Document IP_NODEFRAG
20099 This option is new in Linux 2.6.36
20100
20101unix.7
20102 Michael Kerrisk
20103 Document SIOCINQ ioctl() operation
20104
f2f16c27
MK
20105
20106Global changes
20107--------------
20108
20109_exit.2
20110brk.2
20111chdir.2
20112chmod.2
20113chown.2
20114chroot.2
20115clock_nanosleep.2
20116getdtablesize.2
20117gethostname.2
20118getpagesize.2
20119getsid.2
20120killpg.2
20121mknod.2
20122mknodat.2
20123posix_fadvise.2
20124pread.2
20125readlink.2
20126setpgid.2
f2f16c27
MK
20127setreuid.2
20128sigaltstack.2
20129stat.2
20130symlink.2
20131sync.2
20132truncate.2
20133vfork.2
20134wait.2
20135wait4.2
20136a64l.3
20137abs.3
20138acos.3
20139acosh.3
20140asin.3
20141asinh.3
20142atan.3
20143atan2.3
20144atanh.3
20145atoi.3
20146cbrt.3
20147ceil.3
20148clock_getcpuclockid.3
20149copysign.3
20150cos.3
20151cosh.3
20152dirfd.3
20153div.3
20154dprintf.3
20155ecvt.3
20156erf.3
20157erfc.3
20158exp.3
20159exp2.3
20160expm1.3
20161fabs.3
20162fdim.3
20163fexecve.3
20164ffs.3
20165floor.3
20166fma.3
20167fmax.3
20168fmemopen.3
20169fmin.3
20170fmod.3
20171fpclassify.3
20172frexp.3
20173fwide.3
20174gamma.3
20175gcvt.3
20176getcwd.3
20177getdate.3
20178getgrent.3
20179gethostid.3
20180getpass.3
20181getpwent.3
20182getsubopt.3
20183getw.3
20184hypot.3
20185ilogb.3
20186insque.3
20187isalpha.3
20188isgreater.3
20189iswblank.3
20190j0.3
20191j0.3
20192ldexp.3
20193lockf.3
20194log.3
20195log10.3
20196log1p.3
20197log2.3
20198logb.3
20199lrint.3
20200lround.3
20201mbsnrtowcs.3
20202mkdtemp.3
20203mkstemp.3
20204mktemp.3
20205modf.3
20206mq_receive.3
20207mq_send.3
20208nan.3
20209nextafter.3
20210posix_fallocate.3
20211posix_memalign.3
20212pow.3
20213printf.3
20214qecvt.3
20215random.3
20216realpath.3
20217remainder.3
20218remquo.3
20219rint.3
20220rint.3
20221round.3
20222scalb.3
20223scalbln.3
20224scanf.3
20225siginterrupt.3
20226signbit.3
20227sigset.3
20228sin.3
20229sinh.3
20230sqrt.3
20231stpcpy.3
20232stpncpy.3
20233strdup.3
20234strdup.3
20235strnlen.3
20236strsignal.3
20237strtod.3
20238strtol.3
20239strtoul.3
20240tan.3
20241tanh.3
20242tgamma.3
20243trunc.3
20244ttyslot.3
20245ualarm.3
20246usleep.3
20247wcpcpy.3
20248wcpncpy.3
20249wcscasecmp.3
20250wcsdup.3
20251wcsncasecmp.3
20252wcsnlen.3
20253wcsnrtombs.3
20254wprintf.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
20264accept.2
20265clone.2
20266dup.2
20267fallocate.2
20268pipe.2
20269readahead.2
20270sched_setaffinity.2
20271unshare.2
20272CPU_SET.3
20273endian.3
20274euidaccess.3
20275fexecve.3
20276getpt.3
20277getpw.3
20278getumask.3
20279getutmp.3
20280gnu_get_libc_version.3
20281makedev.3
20282matherr.3
20283mbsnrtowcs.3
20284memfrob.3
20285pthread_attr_setaffinity_np.3
20286pthread_getattr_np.3
20287pthread_setaffinity_np.3
20288pthread_tryjoin_np.3
20289tcgetsid.3
20290wcscasecmp.3
20291wcsncasecmp.3
20292wcsnlen.3
20293wcsnrtombs.3
20294wcswidth.3
20295rtld-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
20304clock_nanosleep.2
20305clock_getcpuclockid.3
20306getnetent_r.3
20307getprotoent_r.3
20308getrpcent_r.3
20309getservent_r.3
20310sigwait.3
20311 Michael Kerrisk
20312 RETURN VALUE: Note that "positive error numbers" are listed in ERRORS
20313
20314fcntl.2
20315intro.2
20316open.2
20317poll.2
20318ftw.3
20319intro.3
20320matherr.3
20321system.3
20322tmpnam.3
20323unix.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
20331index.3
20332stpcpy.3
20333strcasecmp.3
20334strcat.3
20335strchr.3
20336strcmp.3
20337strcoll.3
20338strcpy.3
20339strdup.3
20340strfry.3
20341strpbrk.3
20342strsep.3
20343strspn.3
20344strstr.3
20345strtok.3
20346strxfrm.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
20352armscii-8.7
20353cp1251.7
20354iso_8859-3.7
20355iso_8859-5.7
20356iso_8859-6.7
20357iso_8859-8.7
20358iso_8859-10.7
20359iso_8859-11.7
20360iso_8859-13.7
20361iso_8859-14.7
20362koi8-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
20373Changes to individual pages
20374---------------------------
20375
20376capget.2
20377 Michael Kerrisk
20378 SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE"
20379
20380fcntl.2
20381 Michael Kerrisk
20382 Add feature test macro requirements for F_GETOWN and F_SETOWN
20383
20384fcntl.2
20385 Michael Kerrisk
20386 Note feature test macro requirements for F_DUPFD_CLOEXEC
20387
20388getrlimit.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
20395lseek.2
20396 Michael Kerrisk
20397 Removed note about return type on ancient systems
20398
20399mount.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
20404stat.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
20410timer_create.2
20411 Michael Kerrisk
20412 Factor out generic material that was moved to new sigevent(7) page
20413
20414aio_fsync.3
20415 Michael Kerrisk
20416 Add reference to new sigevent(7) page
20417
20418atanh.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
20424cerf.3
20425 Michael Kerrisk
20426 Make it clearer that this function is unimplemented
20427
20428cos.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
20434expm1.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
20440fmod.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
20446insque.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
f2f16c27
MK
20455 Michael Kerrisk
20456 Added info on circular lists, and initializing circular lists
20457 Michael Kerrisk
20458 Added example program
20459
20460lgamma.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
20466log2.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
20473mq_notify.3
20474 Michael Kerrisk
20475 Factor out generic material that was moved to new sigevent(7) page
20476
20477pow.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
20483pthread_kill_other_threads_np.3
20484 Michael Kerrisk
20485 CONFORMING TO: Note meaning of "_np" suffix
20486
20487rand.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
20495random.3
20496 W. Trevor King
20497 Update initstate() return value description to match glibc
20498
20499readdir.3
20500 Michael Kerrisk
20501 Clarify that "positive error numbers" are listed in ERRORS
f2f16c27
MK
20502
20503rexec.3
20504 Michael Kerrisk
20505 SYNOPSIS: Add header file and feature test macro requirements
20506
20507sigpause.3
20508 Michael Kerrisk
20509 Correct discussion of when BSD vs SysV version is used in glibc
20510
20511sin.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
20517tan.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
20523wcscasecmp.3
20524wcsncasecmp.3
20525wcsnlen.3
20526 Michael Kerrisk
20527 Added VERSIONS section
20528
20529boot.7
20530 Yuri Kozlov
20531 Update list of major Linux distributions
20532
20533feature_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
f2f16c27
MK
20541pthreads.7
20542signal.7
20543 Michael Kerrisk
20544 Add SEE ALSO reference to new sigevent(7) page
20545
20546tcp.7
20547 Michael Kerrisk
20548 Clarify header file details for SIOCINQ and SIOCOUTQ
20549 Also note synonymous FIONREAD and TIOCOUTQ.
c04efb3a
MK
20550
20551
20552==================== Changes in man-pages-3.28 ====================
20553
20554Released: 2010-10-04, Munich
20555
20556
20557Contributors
20558------------
20559
20560The following people contributed notes, ideas, or patches that have
20561been incorporated in changes in this release:
20562
20563Andries E. Brouwer <Andries.Brouwer@cwi.nl>
20564Denis Barbier <bouzim@gmail.com>
20565Jan Kara <jack@suse.cz>
20566Landijk <landijk-user@yahoo.com>
20567Lennart Poettering <mzjro@0pointer.net>
20568Michael Haardt <michael@moria.de>
20569Michael Kerrisk <mtk.manpages@gmail.com>
20570Petr Baudis <pasky@suse.cz>
20571Sam Varshavchik <mrsam@courier-mta.com>
20572
20573Apologies if I missed anyone!
20574
20575
20576New and rewritten pages
20577-----------------------
20578
20579getaddrinfo_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
20585aio.7
20586 Michael Kerrisk
20587 New page providing an overview of POSIX asynchronous I/O
20588
20589
20590Newly documented interfaces in existing pages
20591---------------------------------------------
20592
20593exec.3
20594 Michael Kerrisk
a9281449 20595 Document execvpe()
c04efb3a
MK
20596 This function was added to glibc in version 2.11.
20597 Also various other small rewrites in the page.
20598
20599
20600New and changed links
20601---------------------
20602
20603gai_cancel.3
20604gai_error.3
20605gai_suspend.3
20606 Petr Baudis
20607 New links to new getaddrinfo_a.3 page
20608
20609error_one_per_line.3
20610 Michael Kerrisk
20611 Fix misnamed link file (was error_on_per_line.3)
20612
20613execvpe.3
20614 Michael Kerrisk
20615 New link to exec.3
20616
20617sigstack.3
20618 Michael Kerrisk
20619 New link to sigaltstack.2
20620 No new programs should use sigstack(3). Point the user to the
c57f55ec 20621 better sigaltstack(2), whose man page briefly mentions sigstack(3).
c04efb3a
MK
20622
20623vlimit.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
20629vtimes.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
20636Global changes
20637--------------
20638
20639Various 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
20645chdir.2
20646chmod.2
20647chown.2
20648gethostname.2
20649getsid.2
20650pread.2
20651setpgid.2
20652sigaltstack.2
20653stat.2
20654truncate.2
20655wait.2
20656dirfd.3
20657getsubopt.3
20658mkdtemp.3
20659mkstemp.3
20660siginterrupt.3
20661strdup.3
20662 Michael Kerrisk
20663 Simplify feature test macro requirements
20664
20665
20666Changes to individual pages
20667---------------------------
20668
20669getrlimit.2
20670 Michael Kerrisk
20671 Add mention of the ancient vlimit() function
20672
20673getrusage.2
20674 Michael Kerrisk
20675 Add mention of the ancient vtimes() function
20676
20677io_cancel.2
20678io_destroy.2
20679io_getevents.2
20680io_setup.2
20681io_submit.2
20682 Michael Kerrisk
20683 SEE ALSO: add aio(7)
20684
20685sched_setscheduler.2
20686 Michael Kerrisk
20687 ERRORS: note that NULL 'param' yields EINVAL
20688
20689stat.2
20690 Michael Kerrisk
20691 Note feature test macro requirements for blkcnt_t and blksize_t
20692
20693timer_create.2
20694 Michael Kerrisk
20695 Standardize on name 'sevp' for sigevent argument
20696
20697truncate.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
20705aio_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
20711aio_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
20718aio_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
20723aio_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
20731aio_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
20738aio_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
20752aio_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
20759clearenv.3
20760 Michael Kerrisk
20761 Fix error in feature test macro requirements
20762
20763dysize.3
20764 Michael Kerrisk
20765 Remove crufty statement about old SCO bug
20766
20767exec.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
20773getaddrinfo.3
20774 Michael Kerrisk
20775 Add SEE ALSO reference to new getaddrinfo_a.3 page
20776
20777gethostbyname.3
20778 Michael Kerrisk
20779 Fix formatting of feature test macros
20780
20781getw.3
20782 Michael Kerrisk
20783 Fix feature test macros
20784
20785malloc.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
20792mq_notify.3
20793 Michael Kerrisk
20794 Standardize on name 'sevp' for sigevent argument
20795
20796nl_langinfo.3
20797 Michael Haardt
20798 Make it clear that nl_langinfo() interacts with setlocale()
20799 Add an example program
20800
20801posix_openpt.3
20802 Michael Kerrisk
20803 Fix feature test macro requirements
20804
20805rand.3
20806 Michael Kerrisk
20807 Remove duplicate #include in example program
20808
20809strtok.3
20810 Petr Baudis
20811 Add reference to strtok() example in getaddrinfo(3)
20812
20813inotify.7
20814 Michael Kerrisk
20815 Added section noting limitations and caveats of inotify
20816
20817sigevent.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
20822suffixes.7
20823 Michael Kerrisk
20824 Change explanation of ".rpm" to "RPM software package"
68e1e8a8
MK
20825
20826
20827==================== Changes in man-pages-3.29 ====================
20828
20829Released: 2010-10-19, Detroit
20830
20831
20832Contributors
20833------------
20834
20835The following people contributed notes, ideas, or patches that have
20836been incorporated in changes in this release:
20837
20838Balazs Scheidler <bazsi@balabit.hu>
20839David Prevot <davidp@altern.org>
20840Denis Barbier <bouzim@gmail.com>
20841Guillem Jover <guillem@hadrons.org>
20842Ivana Varekova <varekova@redhat.com>
20843Lennart Poettering <mzxreary@0pointer.de>
20844Michael Kerrisk <mtk.manpages@gmail.com>
20845Sam Varshavchik <mrsam@courier-mta.com>
20846Simon Paillard <simon.paillard@resel.enst-bretagne.fr>
20847Stephan Mueller <stephan.mueller@atsec.com>
20848Thomas Jarosch <thomas.jarosch@intra2net.com>
20849Yuri Kozlov <yuray@komyakino.ru>
20850
20851Apologies if I missed anyone!
20852
20853
20854New and rewritten pages
20855-----------------------
20856
20857subpage_prot.2
20858 Michael Kerrisk
20859 New page documenting the PowerPC-specific subpage_prot(2)
20860
20861aio_init.3
20862 Michael Kerrisk
20863 New page documenting aio_init(3)
20864
20865
20866Newly documented interfaces in existing pages
20867---------------------------------------------
20868
20869posix_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
20875sync_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
20883psignal.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
20890ip.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
20900New and changed links
20901---------------------
20902
20903arm_fadvise64_64.2
20904 Michael Kerrisk
20905 New link to posix_fadvise.2
20906
20907arm_sync_file_range.2, sync_file_range2.2
20908 Michael Kerrisk
20909 New links to sync_file_range.2
20910
20911arrm_fadvise.2
20912 Michael Kerrisk
20913 New link to posix_fadvise.2
20914
20915psiginfo.3
20916 Guillem Jover
20917 New link to psignal.3
20918
20919
20920Global changes
20921--------------
20922
20923Many 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
20929Various pages
20930 Michael Kerrisk
20931 Global fix: s/pseudo-terminal/pseudoterminal/
20932
20933grantpt.3, ptsname.3, unlockpt.3, pts.4
20934 Michael Kerrisk
20935 Global fix: s/pty/pseudoterminal/
20936
20937recv.2, cmsg.3, unix.7
20938 Michael Kerrisk
20939 global fix: s/UNIX socket/UNIX domain socket/
20940
20941fmtmsg.3, gethostbyname.3, termios.3
20942 Michael Kerrisk
20943 Global fix: s/Unixware/UnixWare/
20944
20945
20946Changes to individual pages
20947---------------------------
20948
20949inotify_rm_watch.2
20950 Michael Kerrisk
20951 SYNOPSIS: fix type of 'wd' argument
20952
20953posix_fadvise.2
20954 Michael Kerrisk
20955 Rewrite VERSIONS, noting that the system call is fadvise64()
20956
20957syscalls.2
20958 Michael Kerrisk
20959 Add the PowerPC-specific subpage_prot() system call
20960 Add sync_file_range2()
20961
20962truncate.2
20963 Michael Kerrisk
20964 Fix feature test macros
20965
20966aio_cancel.3
20967aio_error.3
20968aio_fsync.3
20969aio_read.3
20970aio_return.3
20971aio_suspend.3
20972aio_write.3
20973 Michael Kerrisk
20974 SEE ALSO: Add lio_listio(3)
20975
20976gai_cancel.3
20977gai_error.3
20978gai_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
20984getifaddrs.3
20985 Thomas Jarosch
20986 Prevent possible NULL pointer access in example program
20987
20988malloc.3
20989 Michael Kerrisk
20990 Emphasize that malloc() and realloc() do not initialize allocated memory
20991
20992malloc_hook.3
20993 Ivana Varekova
20994 Warn that these functions are deprecated
20995
20996strcpy.3
20997 Michael Kerrisk
20998 Formatting fixes in strncpy() example implementation code
20999
21000ip.7
21001 Michael Kerrisk
21002 Reword NOTES on Linux-specific options
21003
21004sigevent.7
21005 Michael Kerrisk
21006 SEE ALSO: Add aio_read(3), aio_write(3), and lio_listio(3)
21007
21008unix.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
d84f58c9
MK
21032
21033
21034==================== Changes in man-pages-3.30 ====================
21035
21036Released: 2010-11-01, Munich
21037
21038
21039Contributors
21040------------
21041
21042The following people contributed notes, ideas, or patches that have
21043been incorporated in changes in this release:
21044
21045Andi Kleen <andi@firstfloor.org>
21046Bernhard Walle <bernhard@bwalle.de>
21047David Prevot <davidp@altern.org>
21048Eric W. Biederman <ebiederm@xmission.com>
21049Florian Lehmann <flo.lehmann@googlemail.com>
21050Jan Engelhardt <jengelh@medozas.de>
21051Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
21052Michael Kerrisk <mtk.manpages@gmail.com>
21053Paul Mackerras <paulus@samba.org>
f687d451 21054Pádraig Brady <P@draigbrady.com>
d84f58c9
MK
21055Reuben Thomas <rrt@sc3d.org>
21056scarlettsp <scarlettsp@gmail.com>
21057Yuri Kozlov <yuray@komyakino.ru>
21058
21059Apologies if I missed anyone!
21060
21061
21062New and rewritten pages
21063-----------------------
21064
d84f58c9
MK
21065kexec_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
5245b904
MK
21093lio_listio.3
21094 Michael Kerrisk
21095 New page documenting lio_listio(3)
21096
d84f58c9
MK
21097
21098Newly documented interfaces in existing pages
21099---------------------------------------------
21100
21101reboot.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
21108unshare.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
21128Global changes
21129--------------
21130
21131Various 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
21143Various pages
21144 Michael Kerrisk
21145 SEE ALSO: Remove redundant reference to feature_test_macros(7)
21146
21147Various pages
21148 David Prevot
21149 Use greater consistency in NAME line
24dd815c 21150 (Remove definite article at start of descriptive clause.)
d84f58c9
MK
21151
21152Various pages
21153 Michael Kerrisk
21154 SEE ALSO: Place entries in correct order
21155
21156Various pages
21157 Michael Kerrisk
22ee66b8 21158 ERRORS: Place entries in correct order
d84f58c9
MK
21159
21160Various pages
21161 Michael Kerrisk
21162 Add section number to references to functions documented in other pages
21163
21164Various 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
21170armscii-8.7
21171iso_8859-3.7
21172iso_8859-4.7
21173iso_8859-5.7
21174iso_8859-6.7
21175iso_8859-10.7
21176iso_8859-11.7
21177iso_8859-13.7
21178iso_8859-14.7
21179koi8-u.7
21180 David Prevot
21181 Capitalize hexadecimal numbers
21182
21183
21184Changes to individual pages
21185---------------------------
21186
21187access.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
21193clone.2
21194 Michael Kerrisk
21195 Clarify when CLONE_NEWNET implementation was completed
21196
21197faccessat.2
21198 Michael Kerrisk
21199 Note that faccessat() is racy
21200
21201fcntl.2
21202 Michael Kerrisk
21203 RETURN VALUE: Improve description of F_GETFD and F_GETFL
21204
21205inotify_add_watch.2
21206 Michael Kerrisk
21207 Document ENOENT error
21208
21209mlock.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
21215reboot.2
21216 Michael Kerrisk
21217 Place 'cmd' values in alphabetical order
21218
21219subpage_prot.2
21220 Michael Kerrisk
21221 Change 1-line page description
21222 Michael Kerrisk
21223 Improvements after review by Paul Mackerras
21224
21225timer_settime.3
21226 Michael Kerrisk
21227 Remove redundant SEE ALSO reference
21228
21229euidaccess.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
21235fenv.3
21236 Michael Kerrisk
21237 Clarify wording relating to glibc version
21238
21239getgrent.3
21240getgrent_r.3
21241getgrnam.3
21242 Michael Kerrisk
21243 Refer reader for group(5) for more info on group structure
21244
21245getopt.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
21252getpw.3
21253 Michael Kerrisk
21254 Change comment describing pw_gecos
21255
21256getpw.3
21257getpwent.3
21258getpwent_r.3
21259 Michael Kerrisk
21260 Refer reader to passwd(5) for more info on the passwd structure
21261
21262getpwent.3
21263getpwnam.3
21264 Michael Kerrisk
21265 Note that pw_gecos is not in POSIX
21266 And change the comment describing this field
21267
21268getpwent_r.3
21269 Michael Kerrisk
21270 Change comment describing pw_gecos
21271
21272getpwnam.3
21273 Michael Kerrisk
21274 Some rewording and restructuring
21275
21276sched_getcpu.3
21277 Michael Kerrisk
21278 Fix feature test macro requirements
21279
21280strnlen.3
21281 Michael Kerrisk
21282 Fix feature test macro requirements
21283
21284group.5
21285 Michael Kerrisk
21286 Various minor rewordings
21287
21288hosts.5
21289protocols.5
21290spufs.7
21291termio.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
21298passwd.5
21299 Michael Kerrisk
21300 Various minor rewordings
21301
21302proc.5
21303 Michael Kerrisk
21304 Add reference to mlock(2) for further info on /proc/PID/status VmLck
21305
21306armscii-8.7
21307 David Prevot
21308 Write the character set name as ArmSCII
21309
21310cp1251.7
21311 David Prevot
21312 Capitalize hexadecimal numbers
21313
21314ip.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
21320koi8-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
21346man-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).
3afb94ab
MK
21354
21355
21356==================== Changes in man-pages-3.31 ====================
21357
21358Released: 2010-11-12, Munich
21359
21360
21361Contributors
21362------------
21363
21364The following people contributed notes, ideas, or patches that have
21365been incorporated in changes in this release:
21366
21367Andi Kleen <andi@firstfloor.org>
21368David Prevot <davidp@altern.org>
21369Denis Barbier <bouzim@gmail.com>
f687d451 21370Krzysztof Żelechowski <giecrilj@stegny.2a.pl>
3afb94ab
MK
21371Michael Kerrisk <mtk.manpages@gmail.com>
21372Yuri Kozlov <yuray@komyakino.ru>
21373
21374Apologies if I missed anyone!
21375
21376
21377Newly documented interfaces in existing pages
21378---------------------------------------------
21379
21380getrlimit.2
21381 Michael Kerrisk
21382 Added documentation of prlimit()
21383 prlimit() is new in kernel 2.6.36.
21384
21385inotify.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
21392New and changed links
21393---------------------
21394
21395prlimit.2
21396 Michael Kerrisk
21397 New link to getrlimit.2
21398
21399
21400Changes to individual pages
21401---------------------------
21402
21403getrlimit.2
21404 Michael Kerrisk
21405 Remove unneeded text in DESCRIPTION
21406
21407intro.2
21408 Michael Kerrisk
21409 Added various pages to SEE ALSO
21410
21411kexec_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
21421migrate_pages.2
21422 Michael Kerrisk
21423 SEE ALSO: Add reference to Documentation/vm/page_migration
21424
21425sched_setaffinity.2
21426 Michael Kerrisk
21427 Add missing word "real" to "user ID"
21428
21429syscalls.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
21437intro.3
21438 Michael Kerrisk
21439 Added various pages to SEE ALSO
21440
21441printf.3
21442 Michael Kerrisk
21443 Formatting fixes in example code
21444
21445hostname.7
21446 Michael Kerrisk
21447 Small improvement to description of domains
21448 See: https://bugzilla.novell.com/show_bug.cgi?id=651900
35fe3d9e
MK
21449
21450
21451==================== Changes in man-pages-3.32 ====================
21452
21453Released: 2010-12-03, Munich
21454
21455
21456Contributors
21457------------
21458
21459The following people contributed notes, ideas, or patches that have
21460been incorporated in changes in this release:
21461
21462A. Costa <agcosta@gis.net>
21463Denis Barbier <bouzim@gmail.com>
21464Emil Mikulic <emikulic@gmail.com>
21465Eugene Kapun <abacabadabacaba@gmail.com>
21466Hugh Dickins <hughd@google.com>
21467Ivana Hutarova Varekova <varekova@redhat.com>
21468Joern Heissler <kernelbugs@joern.heissler.de>
21469Lars Wirzenius <liw@liw.fi>
21470Martin Eberhard Schauer <Martin.E.Schauer@gmx.de>
21471Michael Kerrisk <mtk.manpages@gmail.com>
21472Petr Uzel <petr.uzel@suse.cz>
21473Roger Pate <roger@qxxy.com>
33972b0b 21474Török Edwin <edwintorok@gmail.com>
35fe3d9e
MK
21475Yuri Kozlov <yuray@komyakino.ru>
21476
21477Apologies if I missed anyone!
21478
21479
21480New and rewritten pages
21481-----------------------
21482
21483pthread_sigqueue.3
21484 Michael Kerrisk
504f97ae 21485 New page documenting pthread_sigqueue()
35fe3d9e
MK
21486 pthread_sigqueue() is new in glibc 2.11 (requires a kernel with
21487 rt_tgsigqueinfo(), added in Linux 2.6.31).
21488
21489
21490Newly documented interfaces in existing pages
21491---------------------------------------------
21492
21493readv.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
21500New and changed links
21501---------------------
21502
21503preadv.2
21504 Michael Kerrisk
21505 New link to readv.2
21506
21507pwritev.2
21508 Michael Kerrisk
21509 New link to readv.2
21510
21511
21512Changes to individual pages
21513---------------------------
21514
21515chdir.2
21516 Michael Kerrisk
21517 Remove redundant and incorrect info on FTMs from NOTES
21518
21519chown.2
21520 Michael Kerrisk
21521 Add NOTES explaining 32-bit system calls added in Linux 2.4
21522
21523clock_nanosleep.2
21524 Michael Kerrisk
21525 Clarify that clock_nanosleep() suspends the calling *thread*
21526
21527epoll_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
21534epoll_ctl.2
21535 Michael Kerrisk
21536 Added VERSIONS section
21537
21538epoll_wait.2
21539 Michael Kerrisk
21540 Updated VERSIONS section
21541
21542fcntl.2
21543 Michael Kerrisk
21544 Add notes on fcntl64()
21545
21546fstatat.2
21547 Michael Kerrisk
21548 Add NOTES on fstatat64(), the name of the underlying system call
21549
21550getdents.2
21551 Michael Kerrisk
21552 Added notes on getdents64()
21553
21554getgid.2
21555 Michael Kerrisk
21556 Add NOTES explaining 32-bit system calls added in Linux 2.4
21557
21558getgroups.2
21559 Michael Kerrisk
21560 Add NOTES explaining 32-bit system calls added in Linux 2.4
21561
21562getpagesize.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
21571getresuid.2
21572 Michael Kerrisk
21573 Add NOTES explaining 32-bit system calls added in Linux 2.4
21574
21575getrlimit.2
21576 Michael Kerrisk
21577 Add example program for prlimit()
21578
21579getuid.2
21580 Michael Kerrisk
21581 Add NOTES explaining 32-bit system calls added in Linux 2.4
21582
21583open.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
21589pread.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
21596readv.2
21597 Michael Kerrisk
21598 Wording fix: readv() and writev() are system calls, not functions
21599
21600sendfile.2
21601 Michael Kerrisk
21602 Add notes on sendfile64()
21603
21604setfsgid.2
21605 Michael Kerrisk
21606 Add NOTES explaining 32-bit system calls added in Linux 2.4
21607
21608setfsuid.2
21609 Michael Kerrisk
21610 Add NOTES explaining 32-bit system calls added in Linux 2.4
21611
21612setgid.2
21613 Michael Kerrisk
21614 Add NOTES explaining 32-bit system calls added in Linux 2.4
21615
21616setresuid.2
21617 Michael Kerrisk
21618 Add NOTES explaining 32-bit system calls added in Linux 2.4
21619
21620setreuid.2
21621 Michael Kerrisk
21622 Add NOTES explaining 32-bit system calls added in Linux 2.4
21623
21624setuid.2
21625 Michael Kerrisk
21626 Add NOTES explaining 32-bit system calls added in Linux 2.4
21627
21628sigqueue.2
21629pthreads.7
21630signal.7
21631 Michael Kerrisk
21632 SEE ALSO: Add pthread_sigqueue(3)
21633
21634stat.2
21635 Michael Kerrisk
21636 Fix EOVERFLOW error description
21637 2<<31 should read 1<<31 (which equals 2^31).
21638
21639statfs.2
21640 Michael Kerrisk
21641 Add notes on statfs64() and fstatfs64()
21642
21643swapon.2
21644 Hugh Dickins
21645 Document SWAP_FLAG_DISCARD and discarding of swap pages
21646
21647truncate.2
21648 Michael Kerrisk
21649 Add notes on truncate64() and ftruncate64()
21650
21651memcpy.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
80e1913a 21656 long said that the behaviors is undefined if the memory areas
35fe3d9e
MK
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
21663usleep.3
21664 Petr Uzel
21665 usleep() suspends calling thread, not process
21666
21667core.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
21677pthreads.7
21678 Michael Kerrisk
21679 Added description of async-cancel-safe functions
21680
21681unix.7
21682 Michael Kerrisk
21683 Reworded the text of various errors
21684 Michael Kerrisk
21685 Added ENOENT error
f498fac3
MK
21686
21687
21688==================== Changes in man-pages-3.33 ====================
21689
21690Released: 2011-09-16, Munich
21691
21692
21693Contributors
21694------------
21695
21696The following people contributed patches/fixes or (noted in brackets
21697in the changelog below) reports, notes and ideas that have been
21698incorporated in changes in this release:
21699
21700Akira Fujita <a-fujita@rs.jp.nec.com>
21701Alexander Schuch <Alex.Schuch@gmx.de>
21702Andries Brouwer <Andries.Brouwer@cwi.nl>
21703Brian M. Carlson <sandals@crustytoothpaste.net>
21704Dan Jacobson <jidanni@jidanni.org>
21705Folkert van Heusden <folkert.mobiel@gmail.com>
21706Graham Gower <graham.gower@gmail.com>
21707Hendrik Jan Thomassen <hjt@atcomputing.nl>
21708Jan Engelhardt <jengelh@medozas.de>
21709Joey Adams <joeyadams3.14159@gmail.com>
21710Johannes Laire <johannes@laire.fi>
21711Jon Grant <jg@jguk.org>
21712Josh Triplett <josh@joshtriplett.org>
21713Konstantin Ritt <ritt.ks@gmail.com>
21714Luis Javier Merino <ninjalj@gmail.com>
21715Michael Kerrisk <mtk.manpages@gmail.com>
21716Mike Frysinger <vapier@gentoo.org>
21717Mikel Ward <mikel@mikelward.com>
21718Nick Black <dankamongmen@gmail.com>
21719Paul Evans <leonerd@leonerd.org.uk>
21720Petr Pisar <ppisar@redhat.com>
21721Przemyslaw Pawelczyk <przemyslaw@pawelczyk.it>
21722Regid Ichira <regid23@yahoo.com>
21723Reuben Thomas <rrt@sc3d.org>
21724Richard B. Kreckel <kreckel@ginac.de>
21725Ryan Mullen <rmmullen@gmail.com>
21726Sebastian Geiger <sbastig@gmx.net>
21727Sebastian Unger <sebunger@gmx.net>
21728Seonghun Lim <wariua@gmail.com>
21729Serge E. Hallyn <serge.hallyn@canonical.com>
21730Simon Cross <hodgestar@gmail.com>
21731Simon Paillard <spaillard@debian.org>
21732Stan Sieler <sieler@me.com>
21733Timmy Lee <scuttimmy@gmail.com>
21734Tolga Dalman <tolga.dalman@googlemail.com>
21735Tomislav Jonjic <jonjic@cs.unibo.it>
21736Yuri Kozlov <yuray@komyakino.ru>
21737Wei Luosheng <weiluosheng001@gmail.com>
21738
21739Apologies if I missed anyone!
21740
21741
21742Newly documented interfaces in existing pages
21743---------------------------------------------
21744
21745sync.2
21746 Michael Kerrisk
21747 Added new syncfs() system call
21748 syncfs() was added in Linux 2.6.39.
21749
21750
21751New and changed links
21752---------------------
21753
21754syncfs.2
21755 Michael Kerrisk
21756 New link for sync(2).
21757
21758
21759Global changes
21760--------------
21761
21762Various pages
21763 Simon Paillard
21764 Global fix: properly escape minus sign
21765
21766
21767Changes to individual pages
21768---------------------------
21769
21770clone.2
21771 Michael Kerrisk
21772 Note that CLONE_STOPPED was removed in 2.6.38
21773
21774execve.2
21775 Michael Kerrisk [Sebastian Geiger]
21776 Note that the first argv[] value should contain name of executable
21777
21778fcntl.2
21779 Michael Kerrisk [Reuben Thomas]
21780 Note that F_GETFL also retrieves file access mode
21781
21782getrlimit.2
21783 Michael Kerrisk [Ryan Mullen]
377c74db 21784 Remove mention of kernel versions in discussion of RLIMIT_CPU
f498fac3
MK
21785 Michael Kerrisk [Seonghun Lim]
21786 Fix example program and add _FILE_OFFSET_BITS requirement
21787
21788mlock.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
21795mprotect.2
21796 Seonghun Lim
c0604aba 21797 Fix off-by-one error in a memory range
f498fac3
MK
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
21803open.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
21809readlink.2
21810 Michael Kerrisk [Dan Jacobson]
21811 SEE ALSO: Add readlink(1)
21812
21813sendfile.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
21827sigaction.2
21828 Michael Kerrisk [Tolga Dalman]
21829 Add a little info about ucontext_t
21830
21831stat.2
21832 Michael Kerrisk [Jon Grant]
21833 Small rewording of ENAMETOOLONG error
21834
21835sync.2
21836 Michael Kerrisk
21837 Some rewrites to description of sync()
21838
21839syscalls.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
21851syslog.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
21857time.2
21858 Michael Kerrisk [Alexander Schuch]
21859 NOTES: Fix description of "Seconds since the Epoch"
21860
21861timerfd_create.2
21862 Michael Kerrisk [Josh Triplett]
b530a074 21863 Note behavior when timerfd_settime() old_value is NULL
f498fac3
MK
21864 See http://bugs.debian.org/cgi-bin/bugreport.cgi?641513
21865 Tomislav Jonjic
21866 Fix small error in description of timerfd_settime()
21867
21868truncate.2
21869 Seonghun Lim
21870 Remove redundant EINTR description
21871
21872unlink.2
21873 Hendrik Jan Thomassen
21874 Improve EBUSY description
21875
21876cacos.3
21877cacosh.3
21878catan.3
21879catanh.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
21885cacos.3
21886 Michael Kerrisk
21887 Add example program
21888
21889cacosh.3
21890 Michael Kerrisk
21891 Add example program
21892
21893cacosh.3
21894casinh.3
21895catan.3
21896catanh.3
21897 Michael Kerrisk
21898 SEE ALSO: Add reference to inverse function
21899
21900catan.3
21901 Michael Kerrisk
21902 Add example program
21903
21904catanh.3
21905 Michael Kerrisk
21906 Add example program
21907
21908ccos.3
21909ccosh.3
21910csin.3
21911csinh.3
21912ctan.3
21913ctanh.3
21914 Michael Kerrisk
21915 SEE ALSO Add reference to "arc" inverse function
21916
21917cexp.3
21918 Michael Kerrisk
21919 SEE ALSO: add cexp(3)
21920
21921clog.3
21922 Michael Kerrisk
21923 SEE ALSO: Add reference to clog(2)
21924
21925crypt.3
21926 Michael Kerrisk [Jan Engelhardt]
21927 Fix header file and feature test macro requirements for crypt_r()
21928
21929err.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
21940fflush.3
21941 Regid Ichira
21942 Fix wording error
21943 See http://bugs.debian.org/cgi-bin/bugreport.cgi?614021
21944
21945hsearch.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
21952lockf.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
21958malloc.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
21964mbstowcs.3
21965 Michael Kerrisk
21966 SEE ALSO: add reference to wcstombs(3)
21967
21968memcmp.3
21969 Michael Kerrisk [Sebastian Unger]
21970 Clarify that comparison interprets bytes as "unsigned char"
21971
21972realpath.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
21978scandir(3)
21979 Mike Frysinger
21980 Add ENOENT/ENOTDIR errors
21981
21982siginterrupt.3
21983 Michael Kerrisk [Luis Javier Merino]
21984 Remove misleading sentence about signal(2) and system call interruption
21985
21986strlen.3
21987 Michael Kerrisk [Jon Grant]
21988 SEE ALSO: Add strnlen(3)
21989
21990strnlen.3
21991 Michael Kerrisk [Jon Grant]
21992 CONFORMING TO: Note that strnlen() is in POSIX.1-2008
21993
21994strtoul.3
21995 Michael Kerrisk [Tolga Dalman]
21996 Fix NOTES section constants
21997
21998termios.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
22013wcstombs.3
22014 Michael Kerrisk
22015 SEE ALSO: add mbstowcs(3)
22016
22017console_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
22025proc.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
22031capabilities.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
22040complex.7
22041 Michael Kerrisk
22042 Updated SEE ALSO list to include all complex math functions
22043
22044ipv6.7
22045 Michael Kerrisk [Simon Cross]
22046 Fix description of address notation: "8 4-digit hexadecimal numbers"
22047
22048signal.7
22049 Seonghun Lim
22050 Remove crufty repeated info about LinuxThreads
22051
22052unix.7
22053 Michael Kerrisk
187b24f0 22054 Add pointer to cmsg(3) for an example of the use of SCM_RIGHTS
fc60dabe
MK
22055
22056
22057==================== Changes in man-pages-3.34 ====================
22058
22059Released: 2011-09-23, Munich
22060
22061
22062Contributors
22063------------
22064
22065The following people contributed patches/fixes or (noted in brackets
22066in the changelog below) reports, notes and ideas that have been
22067incorporated in changes in this release:
22068
22069Alan Curry <pacman@kosh.dhis.org>
22070Benjamin Poirier <benjamin.poirier@gmail.com>
22071Brian M. Carlson <sandals@crustytoothpaste.net>
22072David Howells <dhowells@redhat.com>
f687d451 22073David Prévot <taffit@debian.org>
fc60dabe
MK
22074Denis Barbier <bouzim@gmail.com>
22075Doug Goldstein <cardoe@cardoe.com>
22076Eric Blake <eblake@redhat.com>
22077Guillem Jover <guillem@hadrons.org>
22078Jon Grant <jg@jguk.org>
22079Michael Kerrisk <mtk.manpages@gmail.com>
22080Neil Horman <nhorman@tuxdriver.com>
22081Paul Pluzhnikov <ppluzhnikov@google.com>
22082Reuben Thomas <rrt@sc3d.org>
22083Stefan Puiu <stefan.puiu@gmail.com>
22084Stephan Mueller <stephan.mueller@atsec.com>
22085Stephen Cameron <scameron@beardog.cce.hp.com>
22086Sunil Mushran <sunil.mushran@oracle.com>
22087
22088Apologies if I missed anyone!
22089
22090
22091New and rewritten pages
22092-----------------------
22093
22094rt_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
22100cciss.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
22109hpsa.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
61f69ce6 22113 of being the main author of the hpsa driver.
fc60dabe
MK
22114 Michael Kerrisk
22115 Copyedits my mtk
22116
22117
22118Newly documented interfaces in existing pages
22119---------------------------------------------
22120
22121fstatat.2
22122 Michael Kerrisk [David Howells]
22123 Document AT_NO_AUTOMOUNT
61f69ce6 22124 This flag was added in Linux 2.6.38.
fc60dabe
MK
22125
22126lseek.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
22133madvise.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
22140New and changed links
22141---------------------
22142
22143rt_tgsigqueueinfo.2
22144 Michael Kerrisk
22145 New link to new rt_sigqueueinfo.2 page
22146
22147sigqueue.2
22148 Michael Kerrisk
22149 Create link to page that was relocated to section 3
22150
22151
22152Global changes
22153--------------
22154
22155Various pages
22156 Michael Kerrisk
22157 Change reference to "sigqueue(2)" to "sigqueue(3)"
22158
22159
22160Changes to individual pages
22161---------------------------
22162
22163fallocate.2
22164 Michael Kerrisk
22165 ERRORS: Add EPERM and ESPIPE errors
22166
22167lseek.2
22168 Michael Kerrisk [Alan Curry, Reuben Thomas]
61f69ce6 22169 Remove suspect note about 'whence' being incorrect English
fc60dabe
MK
22170
22171prctl.2
22172 Paul Pluzhnikov
22173 PR_SET_DUMPABLE makes process non-ptrace-attachable
22174
22175readlink.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
22181sched_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
22189tkill.2
22190 Michael Kerrisk
22191 SEE ALSO: Add rt_sigqueueinfo (2)
22192
22193btowc.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
22198fwide.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
22204index.3
22205 Michael Kerrisk [Jon Grant]
22206 Fix text mentioning terminating null
22207
22208pthread_sigqueue.3
22209 Michael Kerrisk
22210 Replace explicit mention of rt_tgsigqueueinfo() with SEE ALSO reference
22211
22212sigqueue.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
22221wcsnlen.3
22222 Jon Grant
22223 Improve description of 'maxlen' argument
22224 It's worth clarifying 'maxlen' is in wide-char units, not bytes.
22225
22226wprintf.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
22232feature_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
22238ip.7
22239 Benjamin Poirier [Neil Horman]
22240 Improve description of IP_MTU_DISCOVER
22241
22242signal.7
22243 Michael Kerrisk
22244 SEE ALSO: Add rt_sigqueueinfo(2)
321695ec
MK
22245
22246
22247==================== Changes in man-pages-3.35 ====================
22248
22249Released: 2011-10-04, Munich
22250
22251
22252Contributors
22253------------
22254
22255The following people contributed patches/fixes or (noted in brackets
22256in the changelog below) reports, notes and ideas that have been
22257incorporated in changes in this release:
22258
22259Andi Kleen <andi@firstfloor.org>
f687d451 22260David Prévot <taffit@debian.org>
321695ec
MK
22261Denis Barbier <bouzim@gmail.com>
22262Eric W. Biederman <ebiederm@xmission.com>
22263Guillem Jover <guillem@hadrons.org>
22264Jon Grant <jg@jguk.org>
22265Kevin Lyda <kevin@ie.suberic.net>
22266Michael Kerrisk <mtk.manpages@gmail.com>
22267Mike Frysinger <vapier@gentoo.org>
22268Reuben Thomas <rrt@sc3d.org>
22269
22270Apologies if I missed anyone!
22271
22272
22273New and rewritten pages
22274-----------------------
22275
22276recvmmsg.2
22277 Andi Kleen, Michael Kerrisk
22278 New man page for recvmmsg(2)
22279
22280setns.2
22281 Eric W. Biederman
22282 New manual page for setns(2)
22283 Michael Kerrisk
22284 Various improvements
22285
22286
22287Global changes
22288--------------
22289
22290Various 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
22296Various pages
22297 Michael Kerrisk
22298 Global fix: s/null pointer/NULL pointer/
22299
22300Various pages
22301 Michael Kerrisk
22302 Global fix: use ORing
22303 Use "ORing", not "OR'ing", nor an italic ".IR OR ing".
22304
22305Various 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
22313Various 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
22321mount.2, prctl.2
22322 Michael Kerrisk
22323 s/task/thread/ for consistency with other pages
22324
22325
22326Changes to individual pages
22327---------------------------
22328
22329lseek.2
22330 Guillem Jover
22331 CONFORMING TO: Note other systems that have SEEK_HOLE+SEEK_DATA
22332
22333recv.2
22334 Michael Kerrisk
22335 Add mention of recvmmsg(2)
22336
22337recvmmsg.2
22338 Michael Kerrisk
22339 SEE ALSO: add sendmmsg(2)
22340
22341send.2
22342 Michael Kerrisk
22343 CONFORMING TO: POSIX.1-2008 adds MSG_NOSIGNAL
22344
22345sigwaitinfo.2
22346 Michael Kerrisk
22347 Note that attempts to wait for SIGKILL and SIGSTOP are silently ignored
22348
22349stat.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
22357aio_cancel.3
22358 Michael Kerrisk [Jon Grant]
22359 Clarify meaning of "return status" and "error status"
22360
22361gets.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
22367mbsnrtowcs.3
22368 Michael Kerrisk
22369 CONFORMING TO: Add POSIX.1-2008
22370 This function is specified in the POSIX.1-2008 revision.
c1850d99 22371
321695ec
MK
22372regex.3
22373 Michael Kerrisk [Reuben Thomas]
22374 Change "terminating null" to "terminating null byte"
22375
22376stpcpy.3
22377stpncpy.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
22383stpncpy.3
22384 Michael Kerrisk
22385 Change "terminating null" to "terminating null byte"
22386
22387strcpy.3
22388 Mike Frysinger
22389 SEE ALSO: Add stpncpy(3)
22390
22391strdup.3
22392 Michael Kerrisk
22393 CONFORMING TO: strndup() is in POSIX.1-2008
22394
22395wcpcpy.3
22396wcpncpy.3
22397wcsnlen.3
22398wcsnrtombs.3
22399 Michael Kerrisk
22400 CONFORMING TO: Add POSIX.1-2008
22401 These functions are specified in the POSIX.1-2008 revision.
22402
22403proc.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
22409capabilities.7
22410 Michael Kerrisk
22411 List setns(2) as an operation allowed by CAP_SYS_ADMIN
db8e5ab1
MK
22412
22413
22414==================== Changes in man-pages-3.36 ====================
22415
22416Released: 2012-02-27, Christchurch
22417
22418
22419Contributors
22420------------
22421
22422The following people contributed patches/fixes or (noted in brackets
22423in the changelog below) reports, notes and ideas that have been
22424incorporated in changes in this release:
22425
22426Alain Benedetti <alainb06@free.fr>
22427carado <carado@savhon.org>
22428Christoph Hellwig <hch@lst.de>
22429Clemens Ladisch <clemens@ladisch.de>
f687d451 22430David Prévot <taffit@debian.org>
db8e5ab1
MK
22431Elie De Brauwer <eliedebrauwer@gmail.com>
22432Guillem Jover <guillem@hadrons.org>
22433Jessica McKellar <jesstess@mit.edu>
22434Josef Bacik <josef@redhat.com>
22435Junjiro Okajima <jro@mx3.ttcn.ne.jp>
22436Lucian Adrian Grijincu <lucian.grijincu@gmail.com>
22437Michael Kerrisk <mtk.manpages@gmail.com>
22438Mike Frysinger <vapier@gentoo.org>
22439Pat Pannuto <pat.pannuto@gmail.com>
22440Salvo Tomaselli <tiposchi@tiscali.it>
22441Simone Piccardi <piccardi@truelite.it>
22442Slaven Rezic <srezic@iconmobile.com>
fd2799f6 22443starlight <starlight@binnacle.cx>
db8e5ab1
MK
22444Stephan Mueller <stephan.mueller@atsec.com>
22445Vijay Rao <vijay@portuosus.com>
22446Walter Haidinger <walter.haidinger@gmx.at>
22447Walter Harms <wharms@bfs.de>
22448Yang Yang <wdscxsj@gmail.com>
22449
22450Apologies if I missed anyone!
22451
22452
22453New and rewritten pages
22454-----------------------
22455
22456sendmmsg.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
22462Newly documented interfaces in existing pages
22463---------------------------------------------
22464
22465fallocate.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
22472Changes to individual pages
22473---------------------------
22474
22475dup.2
22476 Michael Kerrisk
47edb99a 22477 SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
db8e5ab1
MK
22478
22479fallocate.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
22491fork.2
22492 Michael Kerrisk
22493 NOTES: Describe clone() call equivalent to fork()
22494
22495fsync.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
22515mount.2
22516 Michael Kerrisk [Junjiro Okajima]
22517 Removed erroneous statement about MS_RDONLY and bind mounts
22518
22519open.2
22520 Jessica McKellar
22521 Fix grammar in O_DIRECT description
22522 Some small grammar fixes to the O_DIRECT description.
22523
22524pipe.2
22525 Michael Kerrisk [Salvo Tomaselli]
47edb99a 22526 SYNOPSIS: Add "#include <fcntl.h>" for O_* constants
db8e5ab1
MK
22527 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750
22528
22529sched_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
22540send.2
22541 Michael Kerrisk
22542 Add mention of sendmmsg(2)
22543
22544sync.2
22545 Michael Kerrisk [Simone Piccardi]
22546 PROTOTYPE: Fix return type of syncfs()
22547
22548vfork.2
fd2799f6 22549 Michael Kerrisk [starlight]
db8e5ab1
MK
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()
fd2799f6 22556 Michael Kerrisk [starlight, Mike Frysinger]
db8e5ab1 22557 Add some notes on reasons why vfork() still exists
fd2799f6 22558 Michael Kerrisk [starlight]
db8e5ab1
MK
22559 Clarify that calling *thread* is suspended during vfork()
22560 Michael Kerrisk
22561 CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete
22562
22563gets.3
22564 Michael Kerrisk
22565 Document C11 and glibc 2.16 changes affecting gets()
22566
22567pthread_sigmask.3
22568 Michael Kerrisk [Pat Pannuto]
22569 Fix comment that was inconsistent with code in example program
22570
22571sem_wait.3
22572 Walter Harms
22573 EXAMPLE: Remove extraneous line of output from shell session
22574
22575wcsnrtombs.3
22576wcsrtombs.3
22577wcstombs.3
22578 Michael Kerrisk
22579 Fix-ups for e9c23bc636426366d659809bc99cd84661e86464
22580
22581core.5
22582 Michael Kerrisk [Junjiro Okajima]
22583 Document %E specifier for core_pattern
22584
22585passwd.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
4b295d68 22591 contains an 'x' (not "*').
db8e5ab1
MK
22592
22593proc.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
22598resolv.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
22603feature_test_macros.7
22604 Michael Kerrisk
22605 Document _ISOC11_SOURCE
22606
22607inotify.7
22608 Michael Kerrisk [Yang Yang]
22609 Note that 'cookie' field is set to zero when unused
22610
22611man.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.
808daa68
MK
22623
22624
22625==================== Changes in man-pages-3.37 ====================
22626
22627Released: 2012-03-06, Christchurch
22628
22629
22630Contributors
22631------------
22632
22633The following people contributed patches/fixes or (noted in brackets
22634in the changelog below) reports, notes and ideas that have been
22635incorporated in changes in this release:
22636
22637Denys Vlasenko <dvlasenk@redhat.com>
808daa68
MK
22638Mark R. Bannister <cambridge@users.sourceforge.net>
22639Michael Kerrisk <mtk.manpages@gmail.com>
22640Oleg Nesterov <oleg@redhat.com>
22641Tejun Heo <tj@kernel.org>
22642
22643Apologies if I missed anyone!
22644
22645
22646New and rewritten pages
22647-----------------------
22648
22649getent.1
22650 Mark R. Bannister
22651 New page to document 'getent' binary provided by glibc
22652
22653
22654Changes to individual pages
22655---------------------------
22656
22657bdflush.2
22658 Michael Kerrisk
22659 Note that bdflush() is deprecated, and does nothing
22660
22661nfsservctl.2
22662 Michael Kerrisk
22663 Note that this system call was removed in Linux 3.1
22664
22665ptrace.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
22702syscalls.2
22703 Michael Kerrisk
22704 Note that nfsservctl(2) was removed in Linux 3.1
22705 Note that bdflush(2) is deprecated
22706
22707capabilities.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
22729ld.so.8
22730 Michael Kerrisk
6a7df894 22731 Add --audit command-line option
4ca9c752
MK
22732
22733
22734==================== Changes in man-pages-3.38 ====================
22735
22736Released: 2012-03-25, Christchurch
22737
22738
22739Contributors
22740------------
22741
22742The following people contributed patches/fixes or (noted in brackets
22743in the changelog below) reports, notes, and ideas that have been
22744incorporated in changes in this release:
22745
22746Akihiro MOTOKI <amotoki@gmail.com>
22747Artyom Pervukhin <artyom@evasive.ru>
f687d451 22748Beňas Petr <xbenas00@stud.fit.vutbr.cz>
4ca9c752
MK
22749Ben Bacarisse <software@bsb.me.uk>
22750Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
f687d451 22751David Prévot <david@tilapin.org>
4ca9c752
MK
22752Denis Barbier <bouzim@gmail.com>
22753Denys Vlasenko <vda.linux@googlemail.com>
22754Eric Blake <ebb9@byu.net>
22755Iain Fraser <iainkfraser@gmail.com>
22756Justin T Pryzby <justinp@norchemlab.com>
22757Kirill Brilliantov <brilliantov@inbox.ru>
22758Mark R Bannister <mark@proseconsulting.co.uk>
22759Matthew Gregan <kinetik@flim.org>
22760Michael Kerrisk <mtk.manpages@gmail.com>
22761Nix <nix@esperi.org.uk>
22762Peter Schiffer <pschiffe@redhat.com>
22763Sergei Zhirikov <sfzhi@yahoo.com>
22764
22765Apologies if I missed anyone!
22766
22767
22768New and rewritten pages
22769-----------------------
22770
22771get_nprocs_conf.3
f687d451 22772 Beňas Petr
4ca9c752
MK
22773 New page documenting get_nprocs_conf(3) and get_nprocs(3)
22774 Michael Kerrisk
22775 Some additions and improvements
22776
22777malloc_get_state.3
22778 Michael Kerrisk
22779 New page documenting malloc_get_state(3) and malloc_set_state(3)
22780
22781mallopt.3
22782 Michael Kerrisk
22783 New man page for mallopt(3)
22784
22785mtrace.3
22786 Michael Kerrisk
22787 Complete rewrite of page, adding much more detail
22788
22789scandirat.3
22790 Mark R Bannister
22791 New page for scandirat(3) (new in glibc 2.15)
22792
22793
22794Newly documented interfaces in existing pages
22795---------------------------------------------
22796
22797posix_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
22804qsort.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
22813New and changed links
22814---------------------
22815
22816aligned_alloc.3
22817 Michael Kerrisk
22818 New link to posix_memalign.3
22819
22820get_nprocs.3
f687d451 22821 Beňas Petr
4ca9c752
MK
22822 Link to new get_nprocs_conf.3 page
22823
22824malloc_set_state.3
22825 Michael Kerrisk
22826 Link to new malloc_get_state.3 page
22827
22828pvalloc.3
22829 Michael Kerrisk
22830 New link to posix_memalign.3
22831
22832
22833Global changes
22834--------------
22835
22836Various pages
22837 Michael Kerrisk
22838 Global formatting fix: balance .nf/.fi pairs
22839
22840Various pages
22841 Michael Kerrisk
22842 Global fix: place sections in correct order
22843
22844Various 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
22855Various pages
22856 Michael Kerrisk
22857 Correct order of SEE ALSO entries
22858
22859
22860Changes to individual pages
22861---------------------------
22862
22863futimesat.2
22864 Michael Kerrisk
22865 PROTOTYPE: Correct header file and feature test macro requirements
22866
22867keyctl.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
22872ptrace.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
22878symlinkat.2
22879 Michael Kerrisk [Eric Blake]
22880 PROTOTYPE: Correct header file
22881
22882syscalls.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
22893unlinkat.2
22894 Michael Kerrisk [Eric Blake]
22895 PROTOTYPE: Correct header file
22896 Michael Kerrisk
22897 PROTOTYPE: Add <fcntl.h> for AT_* constants
22898
22899utimensat.2
22900 Michael Kerrisk
22901 PROTOTYPE: Add <fcntl.h> for AT_* constants
22902
22903copysign.3
22904 Michael Kerrisk [Tolga Dalman]
22905 DESCRIPTION: Add a couple of examples
22906
22907malloc.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
22916posix_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
22924rtnetlink.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
22929scandir.3
22930 Mark R Bannister
22931 SEE ALSO: Add scandirat(3)
22932
22933sigqueue.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
22939tzset.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
22946packet.7
22947 Michael Kerrisk [Iain Fraser]
22948 Fix comment on 'sll_hatype' field
22949
22950tcp.7
22951 Michael Kerrisk [Artyom Pervukhin]
22952 Correct RFC for TIME_WAIT assassination hazards
ad9345dd
MK
22953
22954
22955==================== Changes in man-pages-3.39 ====================
22956
22957Released: 2012-04-17, Christchurch
22958
22959
22960Contributors
22961------------
22962
22963The following people contributed patches/fixes or (noted in brackets
22964in the changelog below) reports, notes, and ideas that have been
22965incorporated in changes in this release:
22966
22967Abhijith Das <adas@redhat.com>
22968Alexander Kruppa <akruppa@gmail.com>
22969Andreas Jaeger <aj@suse.com>
22970Armin Rigo <arigo@tunes.org>
22971Cyrill Gorcunov <gorcunov@openvz.org>
22972Denys Vlasenko <vda.linux@googlemail.com>
22973Eric Blake <ebb9@byu.net>
22974Felix <fkater@googlemail.com>
22975Jak <jak@gmx.ca>
22976Jeff Mahoney <jeffm@suse.com>
22977Jesus Otero <jesus.otero@rysg.es>
22978Jonathan Nieder <jrnieder@gmail.com>
22979Kevin O'Gorman <kevinogorman4@gmail.com>
22980Mark R Bannister <mark@proseconsulting.co.uk>
22981Michael Kerrisk <mtk.manpages@gmail.com>
22982Michael Welsh Duggan <mwd@cert.org>
22983Mike Frysinger <vapier@gentoo.org>
22984Petr Gajdos <pgajdos@suse.cz>
22985Regid Ichira <regid23@yahoo.com>
22986Reuben Thomas <rrt@sc3d.org>
f687d451 22987Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
ad9345dd
MK
22988Simone Piccardi <piccardi@truelite.it>
22989Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
22990<who@connect.carleton.ca>
22991
22992Apologies if I missed anyone!
22993
22994
22995New and rewritten pages
22996-----------------------
22997
22998malloc_trim.3
22999 Michael Kerrisk
23000 New man page for malloc_trim(3)
23001
23002malloc_usable_size.3
23003 Michael Kerrisk
23004 New man page for malloc_usable_size(3)
23005
23006
23007Newly documented interfaces in existing pages
23008---------------------------------------------
23009
23010prctl.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
23017Changes to individual pages
23018---------------------------
23019
23020epoll_create.2
23021 Michael Kerrisk
23022 Rework discussion of 'size' argument
23023 Michael Kerrisk
23024 Add .SS for description of epoll_create1()
23025
23026epoll_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
23034fchmodat.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
23040fcntl.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
23054gettimeofday.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
23062mmap.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
23069poll.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
23075ptrace.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
23093sigaction.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
23098sigprocmask.2
23099 Mike Frysinger
23100 ERRORS: add EFAULT
23101
23102times.2
23103 Michael Kerrisk [Simone Piccardi]
23104 ERRORS: Add EFAULT
23105
23106div.3
23107 Michael Kerrisk [Reuben Thomas]
23108 CONFORMING TO: Add C99
23109
23110fread.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
23115getaddrinfo.3
23116 Michael Kerrisk [Jak]
23117 Correct type of ai_addrlen field
23118
23119malloc.3
23120 Michael Kerrisk
23121 SEE ALSO: add malloc_usable_size(3)
23122 SEE ALSO: Add malloc_trim(3)
23123
23124mallopt.3
23125 Michael Kerrisk
23126 Fix text describing M_PERTURB and free()
23127 SEE ALSO: Add malloc_trim(3)
23128
23129memchr.3
23130 Michael Kerrisk [Reuben Thomas]
23131 Remove mention of terminating null in description of rawmemchr()
23132
23133perror.3
23134 Michael Kerrisk [Jesus Otero]
23135 Note that use of 'sys_errlist' is deprecated
23136
23137rcmd.3
23138 Michael Kerrisk
23139 glibc eventually added a declaration of iruserok() in version 2.12
23140
23141sysconf.3
f687d451 23142 Michael Kerrisk [Ricardo Catalinas Jiménez]
ad9345dd
MK
23143 Add mention of _SC_SYMLOOP_MAX
23144
23145nologin.5
23146 Michael Kerrisk [Tetsuo Handa]
23147 nologin must not only exist, but *be readable* to be effective
23148
23149nsswitch.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
23167capabilities.7
23168 Michael Kerrisk
23169 Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
23170
23171epoll.7
23172 Michael Kerrisk
23173 Some minor clarifications at start of DESCRIPTION
23174
23175netlink.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
23180unix.7
23181 Michael Kerrisk [Tetsuo Handa]
23182 Add a detail on autobind feature
23183
23184ld.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
b8122672
MK
23190
23191
23192==================== Changes in man-pages-3.40 ====================
23193
23194Released: 2012-04-27, Christchurch
23195
23196
23197Contributors
23198------------
23199
23200The following people contributed patches/fixes or (noted in brackets
23201in the changelog below) reports, notes, and ideas that have been
23202incorporated in changes in this release:
23203
23204Alexey Toptygin <alexeyt@freeshell.org>
23205Bernhard Walle <bernhard@bwalle.de>
23206Brian F. G. Bidulock <bidulock@openss7.org>
23207Brian M. Carlson <sandals@crustytoothpaste.net>
23208Christopher Yeoh <cyeoh@au1.ibm.com>
23209Daniel J Blueman <daniel@quora.org>
23210Eric Blake <eblake@redhat.com>
23211Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
23212James Hunt <james.hunt@ubuntu.com>
23213John Sullivan <jsrhbz@kanargh.force9.co.uk>
23214Jon Grant <jg@jguk.org>
23215lepton <ytht.net@gmail.com>
23216Marcel Holtmann <marcel@holtmann.org>
23217Michael Kerrisk <mtk.manpages@gmail.com>
23218Mike Frysinger <vapier@gentoo.org>
23219Petr Baudis <pasky@ucw.cz>
23220Simon Paillard <spaillard@debian.org>
23221Stefan Puiu <stefan.puiu@gmail.com>
23222Ulrich Drepper <drepper@gmail.com>
23223Vadim Mikhailov <vadim.mikhailov@gmail.com>
23224
23225Apologies if I missed anyone!
23226
23227
23228New and rewritten pages
23229-----------------------
23230
23231process_vm_readv.2
23232 Mike Frysinger, Christopher Yeoh, Michael Kerrisk
23233 New page for process_vm_readv(2) and process_vm_writev(2)
23234
23235mcheck.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
23242Newly documented interfaces in existing pages
23243---------------------------------------------
23244
23245rcmd.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
23251rexec.3
23252 Michael Kerrisk
23253 Document rexec_af()
23254
23255
23256New and changed links
23257---------------------
23258
23259iruserok_af.3
23260rcmd_af.3
23261rresvport_af.3
23262ruserok_af.3
23263 Michael Kerrisk
23264 New links to rcmd.3
23265
23266rexec_af.3
23267 Michael Kerrisk
23268 New link to rexec.3
23269
23270
23271Changes to individual pages
23272---------------------------
23273
23274clock_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
23280fallocate.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
23285fchmodat.2
23286 Michael Kerrisk [Mike Frysinger]
23287 Improve discussion of difference between wrapper and underlying syscall
23288
23289gettimeofday.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
23297prctl.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
23305ptrace.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
23312send.2
23313 Stefan Puiu
23314 Document EACCES error case for UDP
23315
23316sigaction.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
23324aio_cancel.3
23325 Michael Kerrisk [Jon Grant]
23326 Rewrite RETURN VALUE section to be clearer
23327
23328aio_init.3
23329 Michael Kerrisk [Jon Grant]
23330 Remove extraneous "POSIX" from NAME section
23331
23332btree.3
23333dbopen.3
23334hash.3
23335mpool.3
23336recno.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
23345fopen.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
23354getgrnam.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
23361getpwnam.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
23368malloc.3
23369mallopt.3
23370mtrace.3
23371 Michael Kerrisk
23372 SEE ALSO: add mcheck(3)
23373
23374memchr.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
23384mkstemp.3
23385 Michael Kerrisk
23386 Add "mkstemps" and "mkostemps" to NAME line
23387
23388posix_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
23395raise.3
23396 Michael Kerrisk
23397 Add some notes on underlying system call that is used
23398
23399rcmd.3
23400 Michael Kerrisk
23401 Add some details of the rresvport() 'port' argument
23402
23403resolver.3
23404 Petr Baudis
23405 Note that many options are documented in resolv.conf(5)
23406
23407scandir.3
23408 Michael Kerrisk [Daniel J Blueman]
23409 Improve EXAMPLE source code: s/0/NULL/ in scandir() call
23410
23411strchr.3
23412 James Hunt
23413 Explain behavior when searching for '\0'
23414
23415strerror.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
23438resolv.conf.5
23439 Petr Baudis
23440 Document "single-request" option
23441
23442inotify.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
23448iso_8859-1.7
23449 Eugen Dedu
23450 Add "-" for SOFT HYPHEN
23451 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=156154
23452
23453netdevice.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
23464socket.7
23465 Michael Kerrisk [Alexey Toptygin]
23466 Correct description of SO_BROADCAST
23467
23468tcp.7
23469 lepton
23470 Correct description for TCP_MAXSEG on modern kernel
2ce31511
MK
23471
23472
23473==================== Changes in man-pages-3.41 ====================
23474
125b4dac 23475Released: 2012-05-11, Christchurch
2ce31511
MK
23476
23477
23478Contributors
23479------------
23480
23481The following people contributed patches/fixes or (noted in brackets
23482in the changelog below) reports, notes, and ideas that have been
23483incorporated in changes in this release:
23484
23485Akihiro MOTOKI <amotoki@gmail.com>
23486Andries E. Brouwer <Andries.Brouwer@cwi.nl>
18c410ba 23487Angelo Borsotti <angelo.borsotti@gmail.com>
2ce31511
MK
23488Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
23489Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
650d4309 23490Casper Dik <Casper.Dik@oracle.com>
f687d451 23491David Prévot <taffit@debian.org>
2ce31511
MK
23492D. Barbier <bouzim@gmail.com>
23493Eric Blake <eblake@redhat.com>
23494Hugh Dickins <hughd@google.com>
23495Ivana Varekova <varekova@redhat.com>
23496Jakub Jelinek <jakub@redhat.com>
23497Jan Kara <jack@suse.cz>
23498Jason Baron <jbaron@redhat.com>
f687d451 23499Jean-Michel Vourgère <jmv_deb@nirgal.com>
2ce31511
MK
23500Jeff Moyer <jmoyer@redhat.com>
23501Josh Triplett <josh@joshtriplett.org>
23502Kasper Dupont <kasperd@gmail.com>
23503KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
23504Lauri Kasanen <curaga@operamail.com>
23505Mel Gorman <mgorman@suse.de>
23506Michael Kerrisk <mtk.manpages@gmail.com>
23507Mike Frysinger <vapier@gentoo.org>
23508Nick Piggin <npiggin@gmail.com>
23509Paul Pluzhnikov <ppluzhnikov@google.com>
23510Petr Baudis <pasky@ucw.cz>
18c410ba 23511Ralph Corderoy <ralph@inputplus.co.uk>
2ce31511
MK
23512Rich Felker <bugdal@aerifal.cx>
23513Simone Piccardi <piccardi@truelite.it>
23514Simon Paillard <spaillard@debian.org>
23515Stefan Puiu <stefan.puiu@gmail.com>
23516Stephen Hemminger <shemminger@vyatta.com>
23517Vincent Lefevre <vincent@vinc17.net>
23518Yuri Kozlov <yuray@komyakino.ru>
23519
23520Apologies if I missed anyone!
23521
23522
23523New and rewritten pages
23524-----------------------
23525
23526get_robust_list.2
23527 Ivana Varekova [Michael Kerrisk]
23528 New page documenting get_robust_list(2) and set_robust_list(2)
23529
23530mallinfo.3
23531 Michael Kerrisk [KOSAKI Motohiro, Paul Pluzhnikov]
23532 New page for mallinfo(3)
23533
23534malloc_info.3
23535 Michael Kerrisk [Jakub Jelinek]
23536 New page for malloc_info(3)
23537
23538malloc_stats.3
23539 Michael Kerrisk [KOSAKI Motohiro]
23540 New man page for malloc_stats(3)
23541
23542
23543Newly documented interfaces in existing pages
23544---------------------------------------------
23545
23546madvise.2
23547 Jason Baron
23548 Document MADV_DONTDUMP and MADV_DODUMP
23549
23550
23551New and changed links
23552---------------------
23553
23554set_robust_list.2
23555 Michael Kerrisk
23556 New link to new get_robust_list.2 page
23557
23558LIST_ENTRY.3
23559LIST_HEAD.3
23560LIST_INIT.3
23561LIST_INSERT_AFTER.3
23562LIST_INSERT_HEAD.3
23563LIST_REMOVE.3
23564TAILQ_ENTRY.3
23565TAILQ_HEAD.3
23566TAILQ_INIT.3
23567TAILQ_INSERT_AFTER.3
23568TAILQ_INSERT_HEAD.3
23569TAILQ_INSERT_TAIL.3
23570TAILQ_REMOVE.3
23571CIRCLEQ_ENTRY.3
23572CIRCLEQ_HEAD.3
23573CIRCLEQ_INIT.3
23574CIRCLEQ_INSERT_AFTER.3
23575CIRCLEQ_INSERT_BEFORE.3
23576CIRCLEQ_INSERT_HEAD.3
23577CIRCLEQ_INSERT_TAIL.3
23578CIRCLEQ_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
23584DES_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
23590qsort_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
23597Global changes
23598--------------
23599
23600faccessat.2
23601fchmodat.2
23602fchownat.2
23603fstatat.2
23604futimesat.2
23605inotify_init.2
23606linkat.2
23607mkdirat.2
23608mknodat.2
23609openat.2
23610readlinkat.2
23611renameat.2
23612setns.2
23613splice.2
23614symlinkat.2
23615sync.2
23616tee.2
23617unlinkat.2
23618vmsplice.2
23619 Michael Kerrisk [Lauri Kasanen]
23620 Global fix: note glibc version that added library support
23621
23622confstr.3
23623strcasecmp.3
23624strcat.3
23625strcmp.3
23626strcpy.3
23627strdup.3
23628strftime.3
23629strlen.3
23630strnlen.3
23631strpbrk.3
23632strspn.3
23633strtok.3
23634strxfrm.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
23641icmp.7
23642ipv6.7
23643packet.7
23644raw.7
23645rtnetlink.7
23646unix.7
23647x25.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
23658Changes to individual pages
23659---------------------------
23660
23661clock_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
23669epoll_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
23676execve.2
23677 Michael Kerrisk
23678 Rewording to deemphasize libc5 details
23679
23680fork.2
23681 Mike Frysinger
23682 ERRORS: add ENOSYS
23683 Can occur on, for example, non-MMU hardware.
23684
23685getcpu.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
23693io_cancel.2
23694io_destroy.2
23695io_getevents.2
23696io_setup.2
23697io_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:
fd2799f6 23703 2012-05-07 "aio manuals", linux-man@vger
2ce31511
MK
23704 http://thread.gmane.org/gmane.linux.man/1935/focus=2910
23705
23706 Other minor rewrites.
23707
23708mount.2
23709 Michael Kerrisk
23710 Comment out an old Linux libc detail
23711
23712open.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
23720poll.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
23736pread.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
23741recvmmsg.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
23748select.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
23759semop.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
23766signal.2
23767 Michael Kerrisk
23768 Note that 'sig_t' requires _BSD_SOURCE
23769 Also remove some old Linux libc details
23770
23771sigwaitinfo.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
23778stat.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
23790syscalls.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
23800sysinfo.2
23801 Michael Kerrisk
23802 Remove reference to obsolete libc5
23803
23804syslog.2
23805 Michael Kerrisk
23806 Remove some details about obsolete Linux libc
23807
23808aio_cancel.3
23809aio_error.3
23810aio_fsync.3
23811aio_read.3
23812aio_return.3
23813aio_suspend.3
23814aio_write.3
23815 Michael Kerrisk
23816 ERRORS: Add/update ENOSYS error
23817
23818aio_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
23824dbopen.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
23830fmemopen.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
23864fopencookie.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
23869getaddrinfo.3
f687d451 23870 Jean-Michel Vourgère
2ce31511
MK
23871 Note that AI_ADDRCONFIG is not affected by loopback addresses
23872 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479
23873
23874iconv.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
23883isgreater.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
23888lio_listio.3
23889 Michael Kerrisk
23890 Clarify that async notification occurs when *all* I/Os complete
23891
23892makedev.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
23899malloc.3
23900 Michael Kerrisk
23901 SEE ALSO: Add malloc_info(3)
23902
23903malloc_get_state.3
23904 Michael Kerrisk
23905 Fix wordos in function names in NAME line
23906
23907mallopt.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
23919mmap64.3
23920 Michael Kerrisk
23921 Change target of link to mmap.2 (was mmap2.2)
23922 Upstreamed from Red Hat / Fedora
23923
23924realpath.3
fd2799f6 23925 Michael Kerrisk [Casper Dik]
2ce31511
MK
23926 Remove note about Solaris possibly returning a relative path
23927
23928syslog.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
23937undocumented.3
23938 Michael Kerrisk
23939 Remove some functions that have been documented
23940
23941sd.4
23942 Michael Kerrisk
23943 Remove reference to nonexistent scsi(4) page
23944 Upstreamed from RedHat / Fedora
23945
23946sk98lin.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
23951passwd.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
23959proc.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
23967resolv.conf.5
23968 Michael Kerrisk
23969 Take a Debian improvement into upstream
23970
23971tzfile.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
23984ascii.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
23994cp1251.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
24003ipv6.7
24004 Stefan Puiu
24005 Add ENODEV error for bind() to link-local IPv6 address
24006
24007signal.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
24018utf-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
24031ldconfig.8
24032nscd.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.
e82600ef
MK
24037
24038
24039==================== Changes in man-pages-3.42 ====================
24040
24041Released: 2012-08-14, Konolfingen
24042
24043
24044Contributors
24045------------
24046
24047The following people contributed patches/fixes or (noted in brackets
24048in the changelog below) reports, notes, and ideas that have been
24049incorporated in changes in this release:
24050
24051Aaron Peschel <aaron.peschel@gmail.com>
24052Adrian Dabrowski <atrox@seclab.tuwien.ac.at>
24053Akihiro MOTOKI <amotoki@gmail.com>
24054Alan Curry <pacman@kosh.dhis.org>
24055Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
24056Christoph Lameter <cl@linux.com>
24057Colin McCabe <cmccabe@alumni.cmu.edu>
24058Daniel Zingaro <daniel.zingaro@utoronto.ca>
f687d451 24059David Prévot <taffit@debian.org>
e82600ef
MK
24060Denys Vlasenko <vda.linux@gmail.com>
24061Henry Hu <henry.hu.sh@gmail.com>
24062Herbert Xu <herbert@gondor.apana.org.au>
24063Jan Engelhardt <jengelh@medozas.de>
24064Jim Hill <gjthill@gmail.com>
24065JoonSoo Kim <js1304@gmail.com>
24066Kalle Olavi Niemitalo <kon@iki.fi>
24067Martin H <textshell-tSIEzQ@neutronstar.dyndns.org>
24068Michael Kerrisk <mtk.manpages@gmail.com>
24069Michael S. Tsirkin <mst@redhat.com>
24070Rasmus Villemoes <Rasmus.Villemoes@decode.is>
24071Sami Kerola <kerolasa@iki.fi>
24072Sam Varshavchik <mrsam@courier-mta.com>
24073Shawn Landden <shawnlandden@gmail.com>
24074Simon Paillard <spaillard@debian.org>
24075Tolga Dalman <tolga.dalman@googlemail.com>
24076Ulrich Drepper <drepper@gmail.com>
f687d451 24077Марк Коренберг <socketpair@gmail.com>
e82600ef
MK
24078
24079Apologies if I missed anyone!
24080
24081
24082Global changes
24083--------------
24084
24085Various 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
24098Changes to individual pages
24099---------------------------
24100
24101ldd.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
24108clone.2
24109 Michael Kerrisk
24110 Rewrite discussion of sys_clone
24111
24112futex.2
f687d451 24113 Марк Коренберг
e82600ef
MK
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
24122getdents.2
24123select_tut.2
24124atof.3
24125atoi.3
24126pthread_create.3
24127pthread_sigmask.3
24128rtime.3
24129setbuf.3
24130tsearch.3
24131netlink.7
24132 Michael Kerrisk [Jan Engelhardt]
24133 Remove unneeded casts
24134
24135get_robust_list.2
24136get_thread_area.2
24137getcpu.2
24138getdents.2
24139gettid.2
24140io_cancel.2
24141io_destroy.2
24142io_getevents.2
24143io_setup.2
24144io_submit.2
24145ioprio_set.2
24146kexec_load.2
24147llseek.2
24148modify_ldt.2
24149mq_getsetattr.2
24150pivot_root.2
24151readdir.2
24152rt_sigqueueinfo.2
24153set_thread_area.2
24154sgetmask.2
24155spu_create.2
24156spu_run.2
24157subpage_prot.2
24158sysctl.2
24159tkill.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
24167ioprio_set.2
24168 Colin McCabe
24169 Clarify the multithreaded behavior of ioprio_set(2)
f687d451 24170 Michael Kerrisk [Марк Коренберг, Kalle Olavi Niemitalo]
e82600ef
MK
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
24178migrate_pages.2
24179 Michael Kerrisk [Christoph Lameter, JoonSoo Kim]
24180 Fix description of return value
24181
24182mount.2
24183 Michael Kerrisk
24184 For MS_REMOUNT, source is ignored
24185
24186mprotect.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
24200msgctl.2
24201semctl.2
24202shmctl.2
24203svipc.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
24214msgctl.2
24215msgget.2
24216msgop.2
24217semctl.2
24218semget.2
24219semop.2
24220shmctl.2
24221shmget.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
24228ptrace.2
24229 Denys Vlasenko
24230 Explain WNOHANG behavior and EINTR bug
5484b544 24231 I didn't like the "SIGKILL operates similarly, with exceptions"
e82600ef
MK
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
24255seteuid.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
24260set_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
24266sigwaitinfo.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
24272syscall.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
24277syscalls.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
24286getifaddrs.3
24287 Michael Kerrisk [Adrian Dabrowski]
24288 Note that ifa_addr and ifa_netmask can be NULL
24289
24290readdir.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
24298realpath.3
24299 Shawn Landden
24300 Use past tense with ancient history (libc4, libc5)
24301
24302regex.3
24303 Michael Kerrisk
24304 Correct SEE ALSO reference to glibc manual "regex" section
24305
24306rtime.3
24307 Michael Kerrisk [Jan Engelhardt]
24308 Fix broken pointer cast in example code
24309
24310sem_close.3
24311sem_destroy.3
24312sem_getvalue.3
24313sem_init.3
24314sem_open.3
24315sem_post.3
24316sem_unlink.3
24317sem_wait.3
24318sem_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
24323sigwait.3
24324 Michael Kerrisk
24325 Reword "is delivered" to "becomes pending"
24326
24327strcat.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
24333strcpy.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
24344tsearch.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
24356core.5
24357 Michael Kerrisk
24358 Note effect of madvise(2) MADV_DONTDUMP flag
24359
24360capabilities.7
24361 Michael Kerrisk
24362 Document CAP_BLOCK_SUSPEND
24363
24364glob.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
24372iso_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
24390mdoc.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
24401mdoc.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
24419netdevice.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
24431netlink.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
24449rtnetlink.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
24464socket.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
24474svipc.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.
9a53cb84
MK
24479
24480
24481==================== Changes in man-pages-3.43 ====================
24482
24483Released: 2012-10-05, Munich
24484
24485
24486Contributors
24487------------
24488
24489The following people contributed patches/fixes or (noted in brackets
24490in the changelog below) reports, notes, and ideas that have been
24491incorporated in changes in this release:
24492
24493Adrian Bunk <bunk@kernel.org>
24494Anatoli Klassen <anatoli@aksoft.net>
24495Andreas Schwab <schwab@linux-m68k.org>
24496Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
f687d451 24497David Prévot <taffit@debian.org>
9a53cb84
MK
24498Eric Dumazet <edumazet@google.com>
24499Florian Weimer <fweimer@redhat.com>
f687d451 24500Frédéric Brière <fbriere@fbriere.net>
9a53cb84
MK
24501Fredrik Arnerup <arnerup@kth.se>
24502Guillem Jover <guillem@hadrons.org>
24503Jan Engelhardt <jengelh@inai.de>
24504Michael Kerrisk <mtk.manpages@gmail.com>
24505Simon Josefsson <simon@josefsson.org>
24506Stephane Fillod <fillods@users.sf.net>
24507Trevor Woerner <twoerner@gmail.com>
24508Yuri Kozlov <yuray@komyakino.ru>
24509
24510Apologies if I missed anyone!
24511
24512
24513Newly documented interfaces in existing pages
24514---------------------------------------------
24515
24516getenv.3
24517 Michael Kerrisk [Florian Weimer, Andreas Schwab]
24518 Document secure_getenv(3)
24519
24520
24521New and changed links
24522---------------------
24523
24524phys.2
24525 Michael Kerrisk
24526 New link to unimplemented.2
24527
24528secure_getenv.3
24529 Michael Kerrisk
24530 New link to getenv.3
24531
24532
24533Global changes
24534--------------
24535
24536Various pages
24537 Michael Kerrisk
24538 Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
24539
24540Various pages
f687d451 24541 David Prévot [Michael Kerrisk]
9a53cb84
MK
24542 Global fix: Various consistency fixes for SEE ALSO
24543
24544Various pages
24545 Michael Kerrisk
24546 Global fix: use "Linux kernel source" consistently
24547 Rather than "kernel source".
24548
24549Various 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
63365c62
MK
24555syscalls.2
24556uname.2
24557boot.7
24558 Michael Kerrisk
24559 Global fix: s/OS/operating system/
24560
9a53cb84
MK
24561
24562Changes to individual pages
24563---------------------------
24564
24565epoll_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
1966fc7b 24579 frequency. Assuming the long is never smaller than 32 bits
9a53cb84
MK
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
24592getitimer.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
24598keyctl.2
f687d451 24599 David Prévot
9a53cb84
MK
24600 Reorder SEE ALSO, without .br
24601
24602poll.2
24603 Michael Kerrisk
24604 Add pointer to select(2) for discussion of close in another thread
24605
24606select.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
24618semop.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
24626shutdown.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
24633sigaction.2
24634 Michael Kerrisk
24635 Tweak SA_RESETHAND description
24636
9a53cb84
MK
24637timer_settime.2
24638 Michael Kerrisk
24639 Small rewording around discussion of pointer arguments
24640
24641wait4.2
24642 Adrian Bunk
24643 Note that these functions are nonstandard and recommend alternatives
a9c1e097 24644 Some edits to Adrian's patch by mtk.
9a53cb84
MK
24645 Michael Kerrisk
24646 CONFORMING TO: Note SUS details for wait3()
24647
24648gnu_get_libc_version.3
24649 Michael Kerrisk
24650 Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
24651
63365c62
MK
24652pthread_kill.3
24653pthread_sigqueue.3
9a53cb84
MK
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
24660sigvec.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
24669syslog.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
24687ttyname.3
24688 Michael Kerrisk
24689 SEE ALSO: Add ctermid(3)
24690
24691proc.5
24692 Michael Kerrisk
24693 Clarify header file related to 'flags' field of /proc/PID/stat
f687d451 24694 Michael Kerrisk [Frédéric Brière]
9a53cb84
MK
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
24709capabilities.7
24710 Michael Kerrisk
24711 Document interaction of CAP_SYSLOG and /proc/sys/kernel/kptr_restrict
24712
24713ip.7
24714 Michael Kerrisk
24715 SEE ALSO: Add ipv6(7)
24716 SEE ALSO: Add icmp(7)
24717
24718man-pages.7
24719 Michael Kerrisk
24720 Add some advice about disabling hyphenation in SEE ALSO
24721
24722ld.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
04324dee
MK
24733
24734
24735==================== Changes in man-pages-3.44 ====================
24736
24737Released: 2012-11-07, Barcelona
24738
24739
24740Contributors
24741------------
24742
24743The following people contributed patches/fixes or (noted in brackets
24744in the changelog below) reports, notes, and ideas that have been
24745incorporated in changes in this release:
24746
24747Bert Hubert <bert.hubert@netherlabs.nl>
f687d451 24748David Prévot <taffit@debian.org>
04324dee
MK
24749James Youngman <jay@gnu.org>
24750Kees Cook <keescook@chromium.org>
24751Lars Wirzenius <liw@iki.fi>
24752Lucas De Marchi <lucas.de.marchi@gmail.com>
24753Michael Kerrisk <mtk.manpages@gmail.com>
24754Rusty Russell <rusty@rustcorp.com.au>
24755Simon Paillard <spaillard@debian.org>
24756Thomas Habets <thomas@habets.se>
24757
24758Apologies if I missed anyone!
24759
24760
24761New and rewritten pages
24762-----------------------
24763
24764delete_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
24777init_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
24790getauxval.3
24791 Michael Kerrisk
24792 Document getauxval() function added in glibc 2.16
24793
24794
24795Global changes
24796--------------
24797
24798Various 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
24805Various 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
24814Changes to individual pages
24815---------------------------
24816
24817clock_getres.2
24818clock_nanosleep.2
24819 Michael Kerrisk
24820 Linking with -lrt is no longer needed from glibc 2.17 onward
24821
24822create_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
24828execve.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
24834fork.2
24835 Michael Kerrisk
24836 Note treatment of default timer slack value on fork()
24837
24838getdomainname.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
24843get_kernel_syms.2
24844 Michael Kerrisk
24845 Note that this system call is present only in kernels before 2.6
24846
24847ipc.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
24852link.2
24853 Michael Kerrisk
24854 Add EPERM error triggered by /proc/sys/fs/protected_hardlink
24855
24856prctl.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
24879ptrace.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
24889query_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
24901socketcall.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
24906times.2
24907 Thomas Habets
24908 Recommend clock_gettime(2) as alternative to times(2)
24909
24910clock_getcpuclockid.3
24911 Michael Kerrisk
24912 Linking with -lrt is no longer needed from glibc 2.17 onward
24913
24914fts.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
24919getenv.3
24920 Michael Kerrisk
24921 SEE ALSO: add getauxval(3)
24922
24923proc.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
24940ipv6.7
24941 Bert Hubert
24942 Document IPV6_RECVPKTINFO
24943
24944man-pages.7
24945 Michael Kerrisk
24946 Note rules for capitalization in NAME section
24947
24948time.7
24949 Michael Kerrisk
24950 Add a subsection on timer slack
24951
24952ld.so.8
24953 Michael Kerrisk
24954 SEE ALSO: add getauxval(3)
60224140
MK
24955
24956
24957==================== Changes in man-pages-3.45 ====================
24958
24959Released: 2012-12-21, Christchurch
24960
24961
24962Contributors
24963------------
24964
24965The following people contributed patches/fixes or (noted in brackets
24966in the changelog below) reports, notes, and ideas that have been
24967incorporated in changes in this release:
24968
24969Andi Kleen <andi@firstfloor.org>
24970Cyril Hrubis <chrubis@suse.cz>
f687d451 24971David Prévot <taffit@debian.org>
60224140
MK
24972Elie De Brauwer <eliedebrauwer@gmail.com>
24973Eric Dumazet <eric.dumazet@gmail.com>
24974Felipe Pena <felipensp@gmail.com>
24975Florian Weimer <fweimer@redhat.com>
24976Gao Feng <gaofeng@cn.fujitsu.com>
24977Jan Glauber <jang@linux.vnet.ibm.com>
24978Jim Paris <jim@jtan.com>
24979Jon Grant <jg@jguk.org>
24980Julien Cristau <jcristau@debian.org>
24981Michael Kerrisk <mtk.manpages@gmail.com>
24982Mike Frysinger <vapier@gentoo.org>
24983Rens van der Heijden <rens.vanderheijden@uni-ulm.de>
24984Simon Paillard <spaillard@debian.org>
24985Thierry Vignaud <thierry.vignaud@gmail.com>
24986Trevor Woerner <twoerner@gmail.com>
24987YOSHIFUJI Hideaki <yoshfuji@linux-ipv6.org>
24988
24989Apologies if I missed anyone!
24990
24991
24992New and rewritten pages
24993-----------------------
24994
24995s390_runtime_instr.2
24996 Jan Glauber
24997 New page for s390-specific s390_runtime_instr(2)
24998
24999if_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
25007if_nametoindex.3
25008 YOSHIFUJI Hideaki
25009 New page documenting if_nametoindex(3) and if_indextoname(3)
25010
25011
60224140
MK
25012New and changed links
25013---------------------
25014
25015if_freenameindex.3
25016 Michael Kerrisk
25017 New link to if_nameindex.3
25018
25019if_indextoname.3
25020 Michael Kerrisk
25021 New link to if_nametoindex.3
25022
25023
25024Global changes
25025--------------
25026
25027sysconf.3
25028cciss.4
25029 Michael Kerrisk
25030 Global fix: s/runtime/run time/
25031
25032
25033Changes to individual pages
25034---------------------------
25035
25036clone.2
25037 Michael Kerrisk
25038 Since 2.6.30, CLONE_NEWIPC also supports POSIX message queues
25039
25040delete_module.2
25041 Michael Kerrisk
25042 Small rewording of description of effect of O_TRUNC
25043
25044getrlimit.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
25057io_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
25062recv.2
25063 Michael Kerrisk [Eric Dumazet]
25064 UNIX domain sockets support MSG_TRUNC since 3.4
25065
25066sendmmsg.2
25067 Elie De Brauwer
25068 Add example program for sendmmsg()
25069
25070stat.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
25079syscalls.2
25080 Michael Kerrisk
25081 Update various references to "i386" to "x86"
25082 Michael Kerrisk
25083 Add s390_runtime_instr(2)
25084
25085sysctl.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
25091syslog.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
25115wait.2
25116 Michael Kerrisk
25117 BUGS: Document odd waitid() behavior when 'infop' is NULL
25118
25119getifaddrs.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
25124memcmp.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
25130mkstemp.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
25139strcmp.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
25145ttyname.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
25152undocumented.3
25153 Michael Kerrisk
25154 Remove some now documented functions
25155
25156proc.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
25162resolv.conf.5
25163 Simon Paillard
25164 Document IPv6 format for nameserver
25165 See: http://bugs.debian.org/610036
25166
25167capabilities.7
25168 Michael Kerrisk [Rens van der Heijden]
25169 Correct URL for POSIX.1e draft
25170
25171ipv6.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
25178rtnetlink.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
25183socket.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.
5258c28f
MK
25190
25191
25192==================== Changes in man-pages-3.46 ====================
25193
25194Released: 2013-01-27, Canberra
25195
25196
25197Contributors
25198------------
25199
25200The following people contributed patches/fixes or (noted in brackets
25201in the changelog below) reports, notes, and ideas that have been
25202incorporated in changes in this release:
25203
25204Andrew Perepechko <andrew_perepechko@xyratex.com>
f687d451 25205Cédric Boutillier <cedric.boutillier@gmail.com>
5258c28f
MK
25206Cyrill Gorcunov <gorcunov@openvz.org>
25207Daan Spitz <daan.f.spitz@gmail.com>
f687d451 25208David Prévot <taffit@debian.org>
5258c28f
MK
25209Elie De Brauwer <eliedebrauwer@gmail.com>
25210Garrett Cooper <yanegomi@gmail.com>
25211James Noble <James.Noble@daktronics.com>
25212Justin Lebar <justin.lebar@gmail.com>
25213Kees Cook <keescook@chromium.org>
25214Lucas De Marchi <lucas.demarchi@profusion.mobi>
25215Mark Hills <mark@pogo.org.uk>
25216Maxin B. John <maxin.john@gmail.com>
25217Michael Kerrisk <mtk.manpages@gmail.com>
25218Michal Gorny <mgorny@gentoo.org>
25219Peter Budny <bigpeteb@gmail.com>
25220Peter Lekeynstein <lekensteyn@gmail.com>
25221Rusty Russell <rusty@rustcorp.com.au>
25222Samuel Thibault <sthibault@debian.org>
25223Sam Varshavchik <mrsam@courier-mta.com>
25224Shawn Landden <shawnlandden@gmail.com>
25225Simon Paillard <spaillard@debian.org>
25226Starlight <starlight.2013q1@binnacle.cx>
25227Theodore Ts'o <tytso@mit.edu>
25228Wolfgang Rohdewald <wolfgang@rohdewald.de>
f687d451 25229Zsbán Ambrus <ambrus@math.bme.hu>
5258c28f
MK
25230
25231Apologies if I missed anyone!
25232
25233
25234New and rewritten pages
25235-----------------------
25236
25237kcmp.2
25238 Cyrill Gorcunov, Michael Kerrisk
25239 New page for kcmp(2)
25240
25241
25242Newly documented interfaces in existing pages
25243---------------------------------------------
25244
25245init_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
25254New and changed links
25255---------------------
25256
25257finit_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
25270Global changes
25271--------------
25272
25273Various pages
25274 Michael Kerrisk
25275 Global fix: s/tty/terminal/
25276
25277
25278Changes to individual pages
25279---------------------------
25280
25281clone.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
25297fallocate.2
25298 Michael Kerrisk
25299 FALLOC_FL_* flags are defined in glibc only since 2.18
25300
25301getxattr.2
25302removexattr.2
25303setxattr.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
25314getxattr.2
25315listxattr.2
25316removexattr.2
25317setxattr.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
25323init_module.2
25324 Michael Kerrisk [Rusty Russell]
25325 ERRORS: Add errors for module signatures (EBADMSG, ENOKEY)
25326
25327link.2
25328mkdir.2
25329mknod.2
25330open.2
25331rename.2
25332symlink.2
25333write.2
25334mkfifo.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
25345listxattr.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
25351outb.2
25352 Michael Kerrisk
25353 Add SYNOPSIS
25354
25355prctl.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
25369ptrace.2
25370 Michael Kerrisk
25371 Document PTRACE_O_EXITKILL
25372 Michael Kerrisk
25373 Place PTRACE_SETOPTIONS list in alphabetical order
25374
25375query_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
25381recvmmsg.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
25393setns.2
25394 Michael Kerrisk
25395 Add example program
25396
25397sigaction.2
f687d451 25398 Michael Kerrisk [Zsbán Ambrus]
5258c28f
MK
25399 Note feature test macro requirements for 'siginfo_t'
25400 See https://bugzilla.kernel.org/show_bug.cgi?id=52931
25401
25402syscalls.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
25411sysctl.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
25421unshare.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
25432difftime.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
25440getaddrinfo.3
25441getnameinfo.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
25446getspnam.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
25455core.5
25456proc.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.
5258c28f
MK
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
25484proc.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
25513shells.5
25514 Michael Kerrisk
25515 Add /etc/bash to list of example shells
25516
25517ttytype.5
25518 Michael Kerrisk
25519 Add proper xref for termcap and terminfo pages
25520
25521capabilities.7
25522 Michael Kerrisk
25523 Add kcmp(2) under CAP_SYS_PTRACE
25524
25525man-pages.7
25526 Michael Kerrisk
25527 Update description of Section 7
d7fd3ad1
MK
25528
25529
25530==================== Changes in man-pages-3.47 ====================
25531
25532Released: 2013-02-12, Christchurch
25533
26f24c26
MK
25534
25535Contributors
25536------------
25537
25538The following people contributed patches/fixes or (noted in brackets
25539in the changelog below) reports, notes, and ideas that have been
25540incorporated in changes in this release:
25541
f687d451 25542David Prévot <taffit@debian.org>
d7fd3ad1
MK
25543D. Barbier <bouzim@gmail.com>
25544Lennart Poettering <lennart@poettering.net>
25545Michael Kerrisk <mtk.manpages@gmail.com>
25546Mike Frysinger <vapier@gentoo.org>
25547Peter Schiffer <pschiffe@redhat.com>
25548Radek Pazdera <rpazdera@redhat.com>
25549Reuben Thomas <rrt@sc3d.org>
25550Shawn Landden <shawnlandden@gmail.com>
25551Simon Paillard <spaillard@debian.org>
c1c1f8a3 25552Vince Weaver <vweaver1@eecs.utk.edu>
d7fd3ad1 25553
d7fd3ad1
MK
25554Apologies if I missed anyone!
25555
25556
25557New and rewritten pages
25558-----------------------
25559
25560perf_event_open.2
d13e20c2 25561 Vincent Weaver
d7fd3ad1
MK
25562 New page documenting perf_event_open(2)
25563
25564pthread_setname_np.3
25565 Chandan Apsangi, Michael Kerrisk
25566 New page for pthread_setname_np(3) and pthread_getname_np(3)
25567
d13e20c2
MK
25568sln.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
d7fd3ad1
MK
25574
25575Newly documented interfaces in existing pages
25576---------------------------------------------
25577
25578prctl.2
25579 Michael Kerrisk [Shawn Landden, Lennart Poettering]
25580 Document PR_SET_CHILD_SUBREAPER and PR_GET_CHILD_SUBREAPER
25581
25582ip.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
25597Pages moved across sections
25598---------------------------
25599
25600getcontext.3
25601 Michael Kerrisk
25602 This page really belongs in Section 3 (moved from Section 2)
25603
25604getdtablesize.3
25605 Michael Kerrisk
25606 Move from Section 2
25607
d7fd3ad1
MK
25608
25609New and changed links
25610---------------------
25611
25612getcontext.2
25613 Michael Kerrisk
25614 Make link to page moved into Section 3
25615
25616getdtablesize.2
25617 Michael Kerrisk
25618 Link to renamed getdtablesize.3
25619
25620setcontext.2
25621 Michael Kerrisk
25622 Modify link to point to Section 3
25623
25624pthread_getname_np.3
25625 Michael Kerrisk
25626 New link to new pthread_setname_np.3
25627
25628setcontext.3
25629 Michael Kerrisk
25630 Link to getcontext page renamed into Section 3
25631
25632
d7fd3ad1
MK
25633Changes to individual pages
25634---------------------------
25635
25636fallocate.2
25637 Michael Kerrisk
25638 SEE ALSO: add fallocate(1)
25639
25640flock.2
25641 Michael Kerrisk
25642 SEE ALSO: add flock(1)
25643
25644fork.2
25645 Michael Kerrisk
25646 SEE ALSO: add exit(2)
25647
25648getpriority.2
25649 Michael Kerrisk
25650 BUGS: note that nice value is per-thread on Linux
25651
25652getrlimit.2
25653 Michael Kerrisk
25654 SEE ALSO: add prlimit(1)
25655
25656gettid.2
25657 Michael Kerrisk
25658 SEE ALSO: add various system calls that use thread IDs
25659
25660ioprio_set.2
25661 Michael Kerrisk
25662 SEE ALSO: add ionice(1)
25663
25664sched_setaffinity.2
25665 Michael Kerrisk
25666 SEE ALSO: add taskset(1)
25667
25668sched_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
25673sched_setscheduler.2
25674 Michael Kerrisk
25675 Scheduling policy and parameters are per-thread on Linux
d7fd3ad1
MK
25676 Michael Kerrisk
25677 SEE ALSO: add chrt(1)
25678
25679setsid.2
25680 Michael Kerrisk
25681 SEE ALSO: add setsid(1)
25682
25683shmop.2
25684 Michael Kerrisk [Peter Schiffer]
25685 ERRORS: Add EIDRM
25686 Taken from Red Hat downstream patch
25687
25688sigaction.2
25689makecontext.3
25690 Michael Kerrisk
25691 Change getcontext/setcontext page ref to Section 3
25692
25693signal.2
25694 Michael Kerrisk [Reuben Thomas]
25695 Clarify System V vs BSD semantics for signal()
25696
25697syscalls.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
25706unimplemented.2
25707 Michael Kerrisk [Peter Schiffer]
25708 Remove mention of kernel version number in DESCRIPTION
25709
25710inet.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
25716posix_fallocate.3
25717 Michael Kerrisk
25718 SEE ALSO: add fallocate(1)
25719
25720regex.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
25730scanf.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
25739strtol.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
25744sysconf.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
25750nscd.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
25759nsswitch.conf.5
25760 Peter Schiffer
25761 Mention initgroups db
25762
25763proc.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
25778resolv.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
25786utmp.5
25787 Michael Kerrisk
25788 SEE ALSO: add utmpdump(1)
25789
25790cpuset.7
25791 Simon Paillard
25792 Add missing 'cpuset.' prefix for some flags
25793 See kernel commit e21a05cb408bb9f244f11a0813d4b355dad0822e
25794
25795svipc.7
25796 Michael Kerrisk
25797 SEE ALSO: add ipcmk(1), ipcrm(1), ipcs(1)
25798
25799termio.7
25800 Michael Kerrisk
25801 SEE ALSO: add reset(1), setterm(1), stty(1), tty(4)
25802
25803ld.so.8
25804 Michael Kerrisk [Peter Schiffer]
25805 LD_VERBOSE does not work with ld.so --list and --verify
26f24c26 25806 From Red Hat downstream patch
d7fd3ad1
MK
25807
25808 See https://bugzilla.redhat.com/show_bug.cgi?id=532629
25809 Michael Kerrisk
25810 SEE ALSO: add sln(8)
25811
25812zdump.8
25813 Michael Kerrisk [Peter Schiffer]
25814 Bring up to date with zdump --help
25815 Patch taken from Red Hat downstream.
f82bd24e
MK
25816
25817
25818==================== Changes in man-pages-3.48 ====================
25819
25820Released: 2013-03-05, Munich
25821
25822
25823Contributors
25824------------
25825
25826The following people contributed patches/fixes or (noted in brackets
25827in the changelog below) reports, notes, and ideas that have been
25828incorporated in changes in this release:
25829
25830Andrey Vagin <avagin@openvz.org>
25831Aristeu Rozanski <aris@ruivo.org>
25832Colin Walters <walters@verbum.org>
25833Cyril Hrubis <chrubis@suse.cz>
25834Cyrill Gorcunov <gorcunov@openvz.org>
25835Daniel P. Berrange <berrange@redhat.com>
f687d451 25836David Prévot <taffit@debian.org>
f82bd24e
MK
25837D. Barbier <bouzim@gmail.com>
25838Denys Vlasenko <vda.linux@googlemail.com>
25839Flavio Leitner <fbl@redhat.com>
25840Graham Gower <graham.gower@gmail.com>
25841Ivana Varekova <varekova@redhat.com>
25842Kai Kunschke <kai@kunfoo.org>
25843Marcela Maslanova <mmaslano@redhat.com>
25844Marc Lehmann <debian-reportbug@plan9.de>
25845Marshel Abraham <Marshel.Abraham@in.bosch.com>
25846Michael Kerrisk <mtk.manpages@gmail.com>
25847Nathan Stratton Treadway <kernelbugs@nathanst.com>
25848Pavel Emelyanov <xemul@parallels.com>
25849Peter Schiffer <pschiffe@redhat.com>
25850Simon Heimberg <simohe@besonet.ch>
25851Simon Paillard <spaillard@debian.org>
f687d451 25852Török Edwin <edwintorok@gmail.com>
f82bd24e
MK
25853Ulrich Drepper <drepper@redhat.com>
25854Zack Weinberg <zackw@panix.com>
25855
25856Apologies if I missed anyone!
25857
25858
25859New and rewritten pages
25860-----------------------
25861
25862getunwind.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
25870perfmonctl.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
25884gai.conf.5
25885 Ulrich Drepper
25886 New page documenting gai.conf
25887 Taken from Red Hat downstream pages
25888
5598506f 25889nss.5
f82bd24e
MK
25890 Ulrich Drepper
25891 New page describing nss.conf
25892
25893
25894Newly documented interfaces in existing pages
25895---------------------------------------------
25896
25897clock_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
25905ptrace.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
25912New and changed links
25913---------------------
25914
25915fattach.2
25916fdetach.2
25917getmsg.2
25918isastream.2
25919putmsg.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
25927Global changes
25928--------------
25929
25930Many pages
25931 Michael Kerrisk
25932 Global fix: remove unneeded double quotes in .SH headings
25933
25934Many pages
25935 Michael Kerrisk
25936 Global fix: remove unneeded double quotes in .SS headings
25937
25938Many 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.
2e55bcae 25946
f82bd24e
MK
25947Many pages
25948 Michael Kerrisk [Denys Vlasenko]
25949 Remove double blank lines in output
25950
25951Various pages
25952 Michael Kerrisk
25953 Fix order of SH sections
25954
25955
25956Changes to individual pages
25957---------------------------
25958
25959accept.2
25960 Michael Kerrisk
25961 NAME: Add "accept4"
25962
25963access.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
25971getpeername.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
25976getuid.2
25977 Michael Kerrisk
25978 Remove duplicate section heading
25979
25980mmap.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.
f687d451 25989 Michael Kerrisk [Török Edwin]
f82bd24e
MK
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
25997open.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
26003prctl.2
26004 Cyrill Gorcunov
26005 Add some details for PR_GET_TID_ADDRESS
26006
26007read.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
26020unimplemented.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
26027cexp2.3
26028 Michael Kerrisk
26029 Still does not exist in glibc 2.17
26030
26031exit.3
26032 Michael Kerrisk
26033 Note that a call to execve() clears exit handler registrations
26034
26035getaddrinfo.3
26036 Michael Kerrisk
26037 SEE ALSO: Add gai.conf(5)
26038
26039malloc_trim.3
26040 Michael Kerrisk
26041 Remove duplicate section title
26042
26043printf.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
26048pthread_yield.3
26049 Michael Kerrisk [Aristeu Rozanski]
26050 Add _GNU_SOURCE feature test macro to SYNOPSIS
26051
26052resolver.3
26053resolv.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
26059strtol.3
26060 Michael Kerrisk [Peter Schiffer]
26061 Remove crufty text from previous fix
26062
26063core.5
26064 Michael Kerrisk
26065 Document CONFIG_COREDUMP
26066
26067capabilities.7
26068 Andrey Vagin
26069 Nonexistent bits are no longer shown as set in /proc/PID/status Cap*
26070
26071inotify.7
26072 Michael Kerrisk
26073 A monitoring process can't easily distinguish events triggered by itself
26074
26075ip.7
26076 Flavio Leitner [Peter Schiffer]
26077 Improve explanation about calling listen() or connect()
26078
26079man-pages.7
26080 Michael Kerrisk
26081 Describe rules for capitalization in .SS headings
26082
26083rtnetlink.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
26090socket.7
26091 Pavel Emelyanov
26092 SO_BINDTODEVICE is now readable
2beeae40 26093 SO_BINDTODEVICE is readable since kernel 3.8.
b3206068
MK
26094
26095
26096==================== Changes in man-pages-3.49 ====================
26097
26098Released: 2013-03-10, Munich
26099
26100
26101Contributors
26102------------
26103
26104The following people contributed patches/fixes or (noted in brackets
26105in the changelog below) reports, notes, and ideas that have been
26106incorporated in changes in this release:
26107
26108Michael Kerrisk <mtk.manpages@gmail.com>
26109
26110
26111Global changes
26112--------------
26113
26114The goal of the changes below to consistently format copyright
26115and license information in the comments in the page source
26116at the top of each page. This allows for easy scripting to
26117extract that information. Following these changes the comments
26118the 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
26127Note that the 'license-type' is merely descriptive. Its purpose is
26128to simplify scripting for the purpose of gathering statistics on
26129types of licenses used in man-pages. It is NOT a statement about
26130the actual licensing of the page; that license is contain INSIDE the
26131LICENSE_START...LICENSE_END clause.
26132
b3206068
MK
26133All 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
26140Various pages
26141 Michael Kerrisk
26142 Update info in source comments on where to get a copy of the GPL
26143
26144Various 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
ac9074cb
MK
26151
26152
26153==================== Changes in man-pages-3.50 ====================
26154
26155Released: 2013-03-15, Munich
26156
26157
26158Contributors
26159------------
26160
26161The following people contributed patches/fixes or (noted in brackets
26162in the changelog below) reports, notes, and ideas that have been
26163incorporated in changes in this release:
26164
26165Andrey Vagin <avagin@openvz.org>
26166Bernhard Kuemel <bernhard@bksys.at>
26167Elie De Brauwer <eliedebrauwer@gmail.com>
26168Erik Saule <erik.saule@bmi.osu.edu>
26169Florian Weimer <fweimer@bfk.de>
26170Friedrich Delgado Friedrichs <friedel@nomaden.org>
26171Jonathan Nieder <jrnieder@gmail.com>
26172Jose Luis Domingo Lopez <debian@24x7linux.com>
26173Mark R Bannister <mark@proseconsulting.co.uk>
26174Michael Kerrisk <mtk.manpages@gmail.com>
26175Sam Varshavchik <mrsam@courier-mta.com>
26176Simon Paillard <spaillard@debian.org>
26177
26178Apologies if I missed anyone!
26179
26180
26181New and rewritten pages
26182-----------------------
26183
26184canonicalize_file_name.3
26185 Michael Kerrisk
26186 Rewrite page, adding much more detail
26187
26188
26189Global changes
26190--------------
26191
26192Various pages
26193 Michael Kerrisk
26194 Global fix: s/END_LICENSE/LICENSE_END/
26195
26196Various pages
26197 Michael Kerrisk
26198 Global fix: s/bitmask/bit mask/
26199
26200
26201Changes to individual pages
26202---------------------------
26203
26204getent.1
26205 Mark R Bannister
26206 netgroup description incorrectly refers to initgroups
26207
26208capget.2
26209 Michael Kerrisk
26210 Update URL for libcap
26211
26212fork.2
26213 Michael Kerrisk
26214 Port access permission bits (ioperm()) are turned off in the child
26215
26216futex.2
26217 Michael Kerrisk
26218 'timeout' is a minimum duration that the call will wait, not a maximum
26219
26220ioperm.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
26243iopl.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
26251syscalls.2
26252 Michael Kerrisk
26253 Add version information for all (other) syscalls
26254 Michael Kerrisk
26255 Add perfmonctl(2)
26256
26257futimes.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
26262getpass.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
26267realpath.3
26268 Michael Kerrisk
26269 Document GNU extensions for EACCES and ENOENT errors
26270
26271stdarg.3
26272 Michael Kerrisk [Friedrich Delgado Friedrichs]
26273 Describe va_copy()
26274 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=575077
26275
26276termios.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
26281random.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
26304bootparam.7
26305 Jose Luis Domingo Lopez
26306 Document 'rootfstype' option
26307 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182014
26308
26309capabilities.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
26316netlink.7
26317 Andrey Vagin
26318 Add a note about broadcast messages to multiple groups
26319
26320socket.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
e59de0ae
MK
26324
26325
26326==================== Changes in man-pages-3.51 ====================
26327
26328Released: 2013-04-17, Munich
26329
26330
26331Contributors
26332------------
26333
26334The following people contributed patches/fixes or (noted in brackets
26335in the changelog below) reports, notes, and ideas that have been
26336incorporated in changes in this release:
26337
26338Andreas Jaeger <aj@suse.de>
26339Andrew Clayton <andrew@digital-domain.net>
26340Brian M. Carlson <sandals@crustytoothpaste.net>
26341Changhee Han <ch0.han@lge.com>
26342Cyril Hrubis <chrubis@suse.cz>
26343Damien Grassart <damien@grassart.com>
f687d451 26344David Prévot <taffit@debian.org>
e59de0ae
MK
26345Denis Barbier <bouzim@gmail.com>
26346Jeff Moyer <jmoyer@redhat.com>
26347Krzysztof Konopko <krzysztof.konopko@gmail.com>
26348Kyle McMartin <kyle@mcmartin.ca>
26349Mark H Weaver <mhw@netris.org>
26350Michael Kerrisk <mtk.manpages@gmail.com>
26351Mike Frysinger <vapier@gentoo.org>
26352Nicolas Hillegeer <nicolas@hillegeer.com>
26353Pavel Emelyanov <xemul@parallels.com>
26354Peter Schiffer <pschiffe@redhat.com>
26355Radek Pazdera <rpazdera@redhat.com>
26356Ralph Loader <suckfish@ihug.co.nz>
26357Simon Paillard <spaillard@debian.org>
26358The Wanderer <wanderer@fastmail.fm>
26359
26360Apologies if I missed anyone!
26361
26362
26363Newly documented interfaces in existing pages
26364---------------------------------------------
26365
26366sched_rr_get_interval.2
26367 Michael Kerrisk
26368 Document /proc/sys/kernel/sched_rr_timeslice_ms
26369
26370proc.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
26382capabilities.7
26383 Michael Kerrisk
26384 Document /proc/sys/kernel/cap_last_cap
26385
26386
26387Global changes
26388--------------
26389
26390Various pages
26391 Michael Kerrisk
26392 Global fix: fix placement of word "only"
26393
26394Various pages
26395 Simon Paillard
26396 License headers: consistent format
26397
26398Various pages
26399 Michael Kerrisk
26400 Global fix: s/since kernel/since Linux/
26401
26402Various 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
26409Changes to individual pages
26410---------------------------
26411
26412access.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
26417alarm.2
26418 Michael Kerrisk
26419 Correct the description of behavior when 'seconds' is 0
26420
26421clone.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
2beeae40 26428 The requirements quietly changed in glibc 2.14
e59de0ae
MK
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
26444getcpu.2
26445 Michael Kerrisk
26446 Recommend that 'tcache' should be specified as NULL nowadays
26447
26448io_cancel.2
26449 Jeff Moyer, Michael Kerrisk [Cyril Hrubis]
26450 Improve description
26451
26452io_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
26460io_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
26467io_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
26480listxattr.2
26481 Michael Kerrisk
26482 Explain use of 'size' argument
26483
26484lseek.2
26485 Michael Kerrisk [Andreas Jaeger]
b22bf81e 26486 _GNU_SOURCE must be defined to get SEEK_DATA and SEEK_HOLE definitions
e59de0ae
MK
26487 See http://sourceware.org/bugzilla/show_bug.cgi?id=15312
26488
26489mmap.2
26490 Michael Kerrisk
26491 Add pointers to relevant /proc files described in proc(5)
26492
26493posix_fadvise.2
26494pread.2
26495readahead.2
26496sync_file_range.2
26497truncate.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
26505readdir.2
26506 Michael Kerrisk
26507 readdir(2) doesn't exist on x86-64
26508
26509semop.2
26510 Michael Kerrisk
26511 Clarify the discussion of 'semadj'
26512
26513shmctl.2
26514 Michael Kerrisk
26515 Refer to proc(5) for description of /proc/sys/kernel/shm_rmid_forced
26516
26517syscall.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
26529syscalls.2
26530 Michael Kerrisk
26531 Update kernel version number at start of list
26532
26533umask.2
26534 Michael Kerrisk
26535 SEE ALSO: add acl(5)
26536
26537unshare.2
26538 Michael Kerrisk
26539 Update feature test macro requirements
2beeae40 26540 The requirements quietly changed in glibc 2.14
e59de0ae
MK
26541
26542 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26543
26544fopencookie.3
26545 Michael Kerrisk [Ralph Loader]
26546 Correct definition of cookie_io_functions_t
26547
26548pthread_setname_np.3
26549 Andrew Clayton
26550 The thread argument is passed in by value
26551
26552readir.3
26553seekdir.3
26554telldir.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
26572scalb.3
26573 Mark H Weaver
26574 Fix prototypes for scalbf() and scalbl()
26575
26576sched_getcpu.3
26577 Michael Kerrisk
26578 Update feature test macro requirements
2beeae40 26579 The requirements quietly changed in glibc 2.14
e59de0ae
MK
26580
26581 See also http://www.sourceware.org/bugzilla/show_bug.cgi?id=4749
26582
26583ualarm.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
26592elf.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
26601proc.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
26627ip.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
26649units.7
26650 Brian M. Carlson
f687d451 26651 units should use an actual µ
e59de0ae
MK
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
f687d451 26655 the actual letter µ instead of an ASCII approximation.
e59de0ae
MK
26656
26657 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787
f741925b
MK
26658
26659
26660==================== Changes in man-pages-3.52 ====================
26661
4358c621 26662Released: 2013-07-04, Christchurch
f741925b
MK
26663
26664
26665Contributors
26666------------
26667
26668The following people contributed patches/fixes or (noted in brackets
26669in the changelog below) reports, notes, and ideas that have been
26670incorporated in changes in this release:
26671
26672Adrian Bunk <bunk@kernel.org>
26673Andrea Remondini <andrea@undeadlinks.com>
26674Anthony Foiani <anthony.foiani@gmail.com>
26675Brian Norris <computersforpeace@gmail.com>
26676Cyril Hrubis <chrubis@suse.cz>
26677Dan Jacobson <jidanni@jidanni.org>
f687d451 26678David Prévot <taffit@debian.org>
f741925b
MK
26679Eric S. Raymond <esr@thyrsus.com>
26680Georg Sauthoff <mail@georg.so>
26681Jeff Moyer <jmoyer@redhat.com>
f687d451 26682Jérémie Galarneau <jeremie.galarneau@efficios.com>
f741925b
MK
26683Jon Grant <jg@jguk.org>
26684Manuel Traut <manut@linutronix.de>
f687d451 26685Марк Коренберг <socketpair@gmail.com>
f741925b
MK
26686Michael Kerrisk <mtk.manpages@gmail.com>
26687Mike Frysinger <vapier@gentoo.org>
26688Pavel Emelyanov <xemul@parallels.com>
26689Peng Haitao <penght@cn.fujitsu.com>
26690Peter LaDow <petela@gocougs.wsu.edu>
26691Petr Gajdos <pgajdos@suse.cz>
26692Regid <regid23@nt1.in>
26693Siddhesh Poyarekar <siddhesh@redhat.com>
26694Simone Piccardi <piccardi@truelite.it>
26695Simon Paillard <spaillard@debian.org>
26696Vince Weaver <vincent.weaver@maine.edu>
26697Yuri Kozlov <yuray@komyakino.ru>
26698
26699Apologies if I missed anyone!
26700
26701
26702Newly documented interfaces in existing pages
26703---------------------------------------------
26704
26705perf_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
26714socket.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
26723Global changes
26724--------------
26725
26726Various pages
26727 Michael Kerrisk
26728 Convert inline formatting (\fX...\fP) to dot-directive formatting
26729
26730readdir.2
26731asprintf.
26732getline.3
26733getlogin.3
26734pthread_setname_np.3
26735readdir.3
26736strerror.3
26737 Michael Kerrisk [Jon Grant]
26738 Clarify that terminating null byte is '\0'
26739
26740
26741Changes to individual pages
26742---------------------------
26743
26744execve.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
26761fallocate.2
26762 Michael Kerrisk
26763 RETURN VALUE: mention that 'errno' is set on error
26764
26765io_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
26777perf_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
26792prctl.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
26799pread.2
f687d451 26800 Michael Kerrisk [Марк Коренберг]
f741925b
MK
26801 pread() and pwrite() are especially useful in multithreaded applications
26802
26803recv.2
26804 Michael Kerrisk
26805 RETURN VALUE: mention that 'errno' is set on error
26806
26807semctl.2
26808 Michael Kerrisk [Simone Piccardi]
26809 'sem_nsems' is 'unsigned long' since Linux 2.4
26810
26811shmget.2
26812 Michael Kerrisk
26813 Rewrite RETURN VALUE and mention that 'errno' is set on error
26814
26815sigaction.2
26816 Michael Kerrisk [Brian Norris]
26817 RETURN VALUE: mention that 'errno' is set on error
26818
26819signal.2
26820 Michael Kerrisk
26821 RETURN VALUE: mention that 'errno' is set on error
26822
26823sigpending.2
26824 Michael Kerrisk
26825 RETURN VALUE: mention that 'errno' is set on error
26826
26827sigprocmask.2
26828 Michael Kerrisk
26829 RETURN VALUE: mention that 'errno' is set on error
26830
26831sigsuspend.2
26832 Michael Kerrisk
26833 RETURN VALUE: mention that 'errno' is set on error
26834
26835syscall.2
26836 Mike Frysinger
26837 Document s390/s390x calling convention
26838
26839a64l.3
26840 Peng Haitao
26841 ATTRIBUTES: Note function that is not thread-safe
26842 The function l64a() is not thread safe.
26843
26844abs.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
26850aio_error.3
26851 Peng Haitao
26852 ATTRIBUTES: Note function that is thread-safe
26853 The function aio_error() is thread safe.
26854
26855aio_return.3
26856 Peng Haitao
26857 ATTRIBUTES: Note function that is thread-safe
26858 The function aio_return() is thread safe.
26859
26860alloca.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
26870bindresvport.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
26877canonicalize_file_name.3
26878 Michael Kerrisk
26879 Put CONFORMING TO section in right location
26880
26881catgets.3
26882 Michael Kerrisk [Jon Grant]
26883 Clarify that null byte is '\0'
26884
26885ceil.3
26886 Peng Haitao
26887 ATTRIBUTES: Note functions that are thread-safe
26888 The functions ceil(), ceilf() and ceill() are thread safe.
26889
26890cimag.3
26891 Peng Haitao
26892 ATTRIBUTES: Note functions that are thread-safe
26893 The functions cimag(), cimagf() and cimagl() are thread safe.
26894
26895clock_getcpuclockid.3
26896 Peng Haitao
26897 ATTRIBUTES: Note function that is thread-safe
26898 The function clock_getcpuclockid() is thread safe.
26899
26900conj.3
26901 Peng Haitao
26902 ATTRIBUTES: Note functions that are thread-safe
26903 The functions conj(), conjf() and conjl() are thread safe.
26904
26905crypt.3
26906 Peng Haitao
26907 ATTRIBUTES: Note function that is not thread-safe
26908 The function crypt() is not thread safe.
26909
26910ctermid.3
26911 Peng Haitao
26912 ATTRIBUTES: Note function that is thread safe with exceptions
26913 The function ctermid() is thread safe with exceptions.
26914
26915dirfd.3
26916 Michael Kerrisk
26917 RETURN VALUE: mention that 'errno' is set on error
26918
26919drand48.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
26926ecvt.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
26933encrypt.3
26934 Peng Haitao
26935 ATTRIBUTES: Note functions that are not thread-safe
26936 The functions encrypt() and setkey() are not thread safe.
26937
26938ether_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
26943fcloseall.3
26944 Peng Haitao
26945 ATTRIBUTES: Note function that is not thread-safe
26946 The function fcloseall() is not thread safe.
26947
26948ferror.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
26954fgetgrent.3
26955 Michael Kerrisk
26956 RETURN VALUE: mention that 'errno' is set on error
26957
26958fgetpwent.3
26959 Michael Kerrisk
26960 RETURN VALUE: mention that 'errno' is set on error
26961
26962fgetwc.3
26963 Michael Kerrisk
26964 RETURN VALUE: mention that 'errno' is set on error
26965
26966fmtmsg.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
26973fputwc.3
26974 Michael Kerrisk
26975 RETURN VALUE: mention that 'errno' is set on error
26976
26977getdate.3
26978 Peng Haitao
26979 ATTRIBUTES: Note functions that are and aren't thread-safe
26980
26981getgrent.3
26982 Peng Haitao
26983 ATTRIBUTES: Note function that is not thread-safe
26984 The function getgrent() is not thread safe.
26985
26986getgrnam.3
26987 Peng Haitao
26988 ATTRIBUTES: Note functions that are and aren't thread-safe
26989
26990getline.3
26991 Michael Kerrisk
26992 RETURN VALUE: mention that 'errno' is set on error
26993
26994getlogin.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
27002getpass.3
27003 Peng Haitao
27004 ATTRIBUTES: Note functions that are not thread-safe
27005
27006getpwent.3
27007 Peng Haitao
27008 ATTRIBUTES: Note function that is not thread-safe
27009 The function getpwent() is not thread safe.
27010
27011getpwnam.3
27012 Peng Haitao
27013 ATTRIBUTES: Note functions that are and aren't thread-safe
27014
27015getspnam.3
27016 Michael Kerrisk
27017 RETURN VALUE: mention that 'errno' is set on error
27018
27019getttyent.3
27020 Peng Haitao
27021 ATTRIBUTES: Note functions that are not thread-safe
27022
27023getusershell.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
27029getutent.3
27030 Michael Kerrisk
27031 RETURN VALUE: mention that 'errno' is set on error
27032
27033hsearch.3
27034 Michael Kerrisk
27035 RETURN VALUE: mention that 'errno' is set on error
27036
27037hsearch.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
27043localeconv.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
27052malloc_info.3
27053 Michael Kerrisk
27054 RETURN VALUE: mention that 'errno' is set on error
27055
27056mblen.3
27057 Peng Haitao
27058 ATTRIBUTES: Note function that is not thread-safe
27059 The function mblen() is not thread safe.
27060
27061mbrlen.3
27062 Peng Haitao
27063 ATTRIBUTES: Note function that is thread safe with exceptions
27064 The function mbrlen() is thread safe with exceptions.
27065
27066mbrtowc.3
27067 Peng Haitao
27068 ATTRIBUTES: Note function that is thread safe with exceptions
27069 The function mbrtowc() is thread safe with exceptions.
27070
27071mktemp.3
27072 Michael Kerrisk
27073 RETURN VALUE: mention that 'errno' is set on error
27074
27075modf.3
27076 Peng Haitao
27077 ATTRIBUTES: Note functions that are thread-safe
27078 The functions modf(), modff() and modfl() are thread safe.
27079
27080popen.3
27081 Michael Kerrisk
27082 RETURN VALUE: mention that 'errno' is set on error
27083
27084pthread_attr_setinheritsched.3
27085 Michael Kerrisk
27086 Note the scheduling attributes affected by this function
27087
27088pthread_attr_setschedparam.3
27089pthread_attr_setschedpolicy.3
27090pthread_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
27098ptsname.3
27099 Peng Haitao
27100 ATTRIBUTES: Note function that is not thread-safe
27101 The function ptsname() is not thread safe.
27102
27103putenv.3
27104 Michael Kerrisk
27105 RETURN VALUE: mention that 'errno' is set on error
27106
27107putpwent.3
27108 Michael Kerrisk
27109 RETURN VALUE: mention that 'errno' is set on error
27110
27111qecvt.3
27112 Peng Haitao
27113 ATTRIBUTES: Note functions that are not thread-safe
27114 The functions qecvt() and qfcvt() are not thread-safe.
27115
27116random.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
e156f5af 27122 BUGS: initstate() does not return NULL on error
f741925b
MK
27123 http://sourceware.org/bugzilla/show_bug.cgi?id=15380
27124
27125random_r.3
27126 Michael Kerrisk
27127 RETURN VALUE: mention that 'errno' is set on error
27128
27129readdir.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
27136re_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
27141rexec.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
27146round.3
27147 Peng Haitao
27148 ATTRIBUTES: Note functions that are thread-safe
27149 The functions round(), roundf() and roundl() are thread safe.
27150
27151scalbln.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
27157scandir.3
27158 Michael Kerrisk
27159 RETURN VALUE: mention that 'errno' is set on error
27160
27161siginterrupt.3
27162 Michael Kerrisk
27163 RETURN VALUE: mention that 'errno' is set on error
27164
27165signbit.3
27166 Peng Haitao
27167 ATTRIBUTES: Note macro that is thread-safe
27168 The macro signbit() is thread safe.
27169
27170sigsetops.3
27171 Michael Kerrisk
27172 RETURN VALUE: mention that 'errno' is set on error
27173
27174stdio_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
27180strdup.3
27181 Michael Kerrisk
27182 RETURN VALUE: mention that 'errno' is set on error
27183
27184strerror.3
27185 Peng Haitao
27186 ATTRIBUTES: Note function that is not thread-safe
27187 The function strerror() is not thread safe.
27188
27189strftime.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
27195strtok.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
27203tempnam.3
27204 Michael Kerrisk
27205 RETURN VALUE: mention that 'errno' is set on error
27206
27207timegm.3
f687d451 27208 Jérémie Galarneau
f741925b
MK
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
27220tmpnam.3
27221 Peng Haitao
27222 ATTRIBUTES: Note function that is thread safe with exceptions
27223 The function tmpnam() is thread safe with exceptions.
27224
27225trunc.3
27226 Peng Haitao
27227 ATTRIBUTES: Note functions that are thread-safe
27228 The functions trunc(), truncf() and truncl() are thread safe.
27229
27230ttyname.3
27231 Michael Kerrisk
27232 ATTRIBUTES: Note functions that are and aren't thread-safe
27233
27234ttyslot.3
27235 Michael Kerrisk
27236 ATTRIBUTES: Note functions that are not thread-safe
27237
27238usleep.3
27239 Michael Kerrisk
27240 RETURN VALUE: mention that 'errno' is set on error
27241
27242wcsdup.3
27243 Michael Kerrisk
27244 RETURN VALUE: mention that 'errno' is set on error
27245
27246core.5
27247 Michael Kerrisk
27248 Implicitly adding the PID to a core filename was dropped in 2.6.27
27249
27250proc.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
27257bootparam.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
27270inotify.7
27271 Michael Kerrisk [Jon Grant]
27272 Clarify that null byte is '\0'
27273
27274iso_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
27280man-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
27286socket.7
27287 Michael Kerrisk
27288 Note that 'optval' for socket options is an 'int' in most cases
27289
27290tcp.7
27291 Michael Kerrisk
27292 Note that 'optval' for socket options is an 'int' in most cases
27293
27294udp.7
27295 Michael Kerrisk
27296 Note that 'optval' for socket options is an 'int' in most cases
0a4861e4
MK
27297
27298
27299==================== Changes in man-pages-3.53 ====================
27300
27301Released: 2013-07-31, Munich
27302
27303
27304Contributors
27305------------
27306
27307The following people contributed patches/fixes or (noted in brackets
27308in the changelog below) reports, notes, and ideas that have been
27309incorporated in changes in this release:
27310
27311Al Viro <viro@ZenIV.linux.org.uk>
27312Andrey Vagin <avagin@openvz.org>
27313Benjamin Poirier <bpoirier@suse.de>
27314Chris Heath <chris@heathens.co.nz>
27315Chuck Coffing <clc@alum.mit.edu>
f687d451 27316David Prévot <taffit@debian.org>
0a4861e4
MK
27317Denys Vlasenko <dvlasenk@redhat.com>
27318Dmitry V. Levin <ldv@altlinux.org>
fd2799f6
MK
27319Felix Schulte <Felix_Schulte@McAfee.com>
27320Graud <graud@gmx.com>
0a4861e4
MK
27321Michael Kerrisk <mtk.manpages@gmail.com>
27322Oleg Nesterov <oleg@redhat.com>
27323Peng Haitao <penght@cn.fujitsu.com>
27324Peter Schiffer <pschiffe@redhat.com>
27325Simon Paillard <spaillard@debian.org>
27326Vince Weaver <vincent.weaver@maine.edu>
27327
27328Apologies if I missed anyone!
27329
27330
27331New and rewritten pages
27332-----------------------
27333
27334restart_syscall.2
27335 Michael Kerrisk
27336 New page for restart_syscall(2) system call
27337
27338
27339Newly documented interfaces in existing pages
27340---------------------------------------------
27341
27342fchownat.2
27343 Michael Kerrisk
27344 Document AT_EMPTY_PATH
27345
27346fstatat.2
27347 Michael Kerrisk
27348 Document AT_EMPTY_PATH
27349
27350linkat.2
27351 Michael Kerrisk
27352 Document AT_EMPTY_PATH
27353
27354open.2
27355 Michael Kerrisk [Al Viro]
27356 Document O_PATH
27357 See also https://bugzilla.redhat.com/show_bug.cgi?id=885740
27358
27359
27360Changes to individual pages
27361---------------------------
27362
27363clock_nanosleep.2
27364futex.2
27365nanosleep.2
27366poll.2
27367sigaction.2
27368sigreturn.2
27369signal.7
27370 Michael Kerrisk
27371 SEE ALSO: add restart_syscall(2)
27372
27373open.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
27378perf_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
27402ptrace.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
27415readlink.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"
eda6a3fc
MK
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.
0a4861e4
MK
27428
27429setpgid.2
fd2799f6 27430 Michael Kerrisk [Graud]
0a4861e4
MK
27431 s/SIGTSTP/SIGTTIN/ when discussing reads from terminal
27432 See https://bugzilla.kernel.org/show_bug.cgi?id=60504
27433
27434clog2.3
27435 Michael Kerrisk
27436 Note that these functions are still not present in glibc 2.17
27437
27438dirfd.3
27439 Peng Haitao
27440 ATTRIBUTES: Note function that is thread-safe
27441 The function dirfd() is thread safe.
27442
27443div.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
27449fabs.3
27450 Peng Haitao
27451 ATTRIBUTES: Note functions that are thread-safe
27452 The functions fabs(), fabsf() and fabsl() are thread safe.
27453
27454fdim.3
27455 Peng Haitao
27456 ATTRIBUTES: Note functions that are thread-safe
27457 The functions fdim(), fdimf() and fdiml() are thread safe.
27458
27459fflush.3
27460 Peng Haitao
27461 ATTRIBUTES: Note function that is thread-safe
27462 The function fflush() is thread safe.
27463
27464finite.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
27470flockfile.3
27471 Peng Haitao
27472 ATTRIBUTES: Note functions that are thread-safe
27473 The functions flockfile(), ftrylockfile() and funlockfile() are
27474 thread safe.
27475
27476floor.3
27477 Peng Haitao
27478 ATTRIBUTES: Note functions that are thread-safe
27479 The functions floor(), floorf() and floorl() are thread safe.
27480
27481resolv.conf.5
27482 Simon Paillard
27483 Explain how to set empty domain
27484 See http://bugs.debian.org/463575
27485
27486capabilities.7
27487 Michael Kerrisk
27488 Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH
27489
27490inotify.7
fd2799f6 27491 Michael Kerrisk [Felix Schulte]
0a4861e4
MK
27492 Clarify description of IN_MOVED_FROM and IN_MOVED_TO
27493
27494man-pages.7
27495 Michael Kerrisk
27496 DESCRIPTION should note versions for new interface features or behavior
27497
27498udp.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
27504ld.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
be427c35
MK
27515
27516
27517==================== Changes in man-pages-3.54 ====================
27518
27519Released: 2013-09-17, Munich
27520
27521
27522Contributors
27523------------
27524
27525The following people contributed patches/fixes or (noted in brackets
27526in the changelog below) reports, notes, and ideas that have been
27527incorporated in changes in this release:
27528
27529A. Costa <agcosta@gis.net>
27530Akihiro MOTOKI <amotoki@gmail.com>
27531Andreas Wiese <aw-lkml@instandbesetzt.net>
27532Andrew Hunter <andrewhhunter@gmail.com>
27533Chen Gang <gang.chen@asianux.com>
27534Christopher Hall <chall0@gmail.com>
27535Christos Tsopokis <christos@tsopokis.gr>
f687d451 27536David Prévot <taffit@debian.org>
be427c35
MK
27537D. Barbier <bouzim@gmail.com>
27538Doug Goldstein <cardoe@cardoe.com>
27539Elie De Brauwer <eliedebrauwer@gmail.com>
27540Eugen Dedu <Eugen.Dedu@pu-pm.univ-fcomte.fr>
27541Felix Janda <felix.janda@posteo.de>
27542G.raud <graud@gmx.com>
27543Hannes Landeholm <hannes@jumpstarter.io>
27544J. Bruce Fields <bfields@fieldses.org>
27545J. Bruce Fields <bfields@redhat.com>
27546Johan Erlandsson <jeoerl@gmail.com>
27547Jon Grant <jg@jguk.org>
27548Magnus Reftel <magnus.reftel@gmail.com>
27549Marko Myllynen <myllynen@redhat.com>
27550Michael Kerrisk <mtk.manpages@gmail.com>
27551Oleg Nesterov <oleg@redhat.com>
27552Peng Haitao <penght@cn.fujitsu.com>
27553Peter Schiffer <pschiffe@redhat.com>
27554Robert Harris <robert.harris@fixnetix.com>
27555Rodrigo Campos <rodrigo@sdfg.com.ar>
27556Simon Paillard <spaillard@debian.org>
27557Stas <stas.grumbler@gmail.com>
27558Vince Weaver <vincent.weaver@maine.edu>
27559Will Newton <will.newton@linaro.org>
27560Zdenek Pavlas <zpavlas@redhat.com>
f687d451 27561Zsbán Ambrus <ambrus@math.bme.hu>
be427c35
MK
27562
27563Apologies if I missed anyone!
27564
27565
27566
27567Newly documented interfaces in existing pages
27568---------------------------------------------
27569
27570ioctl_list.2
f687d451 27571 Zsbán Ambrus
be427c35
MK
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
27582Global changes
27583--------------
27584
27585Various 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
27594Changes to individual pages
27595---------------------------
27596
27597access.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
27606adjtimex.2
27607 Michael Kerrisk
27608 SEE ALSO: Add adjtimex(8)
27609
27610clock_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
27620futex.2
27621 Michael Kerrisk
27622 The 'timeout' can be rounded upwards by clock granularity and also overrun
27623
27624kill.2
27625 Michael Kerrisk
27626 Small improvements to text on historical rules for permissions
27627
27628nfsservctl.2
27629 Michael Kerrisk
27630 Note commands that were only in Linux 2.4.x and earlier
27631
27632open.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
27641perf_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
27657poll.2
27658 Michael Kerrisk
27659 Clarify wording of 'timeout' as a "minimum" interval
27660
27661sched_setaffinity.2
27662 Michael Kerrisk [Christos Tsopokis]
27663 Clarify that these system calls affect a per-thread attribute
27664
27665sched_setparam.2
27666 Michael Kerrisk
27667 Clarify that this system call applies to threads (not processes)
27668
27669sched_setscheduler.2
27670 Michael Kerrisk
27671 Clarify that this system call applies to threads (not processes)
27672
27673select.2
27674 Michael Kerrisk [G.raud]
27675 Clarify wording of 'timeout' as a "minimum" interval
27676
27677setfsgid.2
27678 Michael Kerrisk [Oleg Nesterov]
27679 Clarify description of return value
27680 More clearly describe the weirdness in the return value of this
5990702e 27681 system call, and note the problems it creates in BUGS
be427c35
MK
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
27689setfsuid.2
27690 Michael Kerrisk [Oleg Nesterov]
27691 Clarify description of return value
27692 More clearly describe the weirdness in the return value of this
5990702e 27693 system call, and note the problems it creates in BUGS
be427c35
MK
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
27701sigwaitinfo.2
27702 Michael Kerrisk
27703 Clarify wording of 'timeout' as a "minimum" interval
27704
27705syscall.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
27720wait.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
27725clock.3
27726 Michael Kerrisk
27727 clock() switched from using times(2) to clock_gettime() in glibc 2.18
27728
27729drand48_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
27736fma.3
27737 Peng Haitao
27738 ATTRIBUTES: Note functions that are thread-safe
27739 The functions fma(), fmaf() and fmal() are thread safe.
27740
27741fmax.3
27742 Peng Haitao
27743 ATTRIBUTES: Note functions that are thread-safe
27744 The functions fmax(), fmaxf() and fmaxl() are thread safe.
27745
27746fmin.3
27747 Peng Haitao
27748 ATTRIBUTES: Note functions that are thread-safe
27749 The functions fmin(), fminf() and fminl() are thread safe.
27750
27751fpclassify.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
27757frexp.3
27758 Peng Haitao
27759 ATTRIBUTES: Note functions that are thread-safe
27760 The functions frexp(), frexpf() and frexpl() are thread safe.
27761
27762gethostbyname.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
27770ilogb.3
27771 Peng Haitao
27772 ATTRIBUTES: Note functions that are thread-safe
27773 The functions ilogb(), ilogbf() and ilogbl() are thread safe.
27774
27775ldexp.3
27776 Peng Haitao
27777 ATTRIBUTES: Note functions that are thread-safe
27778 The functions ldexp(), ldexpf() and ldexpl() are thread safe.
27779
27780lrint.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
27786lround.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
27792lseek64.3
27793 Peng Haitao
27794 ATTRIBUTES: Note function that is thread-safe
27795 The function lseek64() is thread safe.
27796
27797mbsinit.3
27798 Peng Haitao
27799 ATTRIBUTES: Note function that is thread-safe
27800 The function mbsinit() is thread safe.
27801
27802nextafter.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
27808posix_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
27814printf.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
27830rewinddir.3
27831 Peng Haitao
27832 ATTRIBUTES: Note function that is thread-safe
27833 The function rewinddir() is thread safe.
27834
27835rint.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
27841seekdir.3
27842 Peng Haitao
27843 ATTRIBUTES: Note function that is thread-safe
27844 The function seekdir() is thread safe.
27845
27846telldir.3
27847 Peng Haitao
27848 ATTRIBUTES: Note function that is thread-safe
27849 The function telldir() is thread safe.
27850
27851wctomb.3
27852 Peng Haitao
27853 ATTRIBUTES: Note function that is not thread-safe
27854 The function wctomb() is not thread safe.
27855
27856wavelan.4
27857 Michael Kerrisk [Elie De Brauwer]
27858 This driver disappeared in 2.56.35
27859
27860dir_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
27869proc.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
27888bootparam.7
27889 Michael Kerrisk [Eugen Dedu]
27890 Remove "lilo" entries from SEE ALSO
27891 See http://bugs.debian.org/604019
27892
27893inotify.7
27894 Michael Kerrisk
27895 SEE ALSO: add inotifywait(1) and inotifywatch(1)
27896
27897ip.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
27904standards.7
27905 Michael Kerrisk
27906 Add mention of SUSv4-TC1 (POSIX.1-2013)
299c26a0
MK
27907
27908
27909==================== Changes in man-pages-3.55 ====================
27910
27911Released: 2013-12-12, Christchurch
27912
27913
27914Contributors
27915------------
27916
27917The following people contributed patches/fixes or (noted in brackets
27918in the changelog below) reports, notes, and ideas that have been
27919incorporated in changes in this release:
27920
27921Alfred Agrell <alfred@agrell.info>
27922Andreas Sandberg <andreas.sandberg@it.uu.se>
27923Christoph Hellwig <hch@infradead.org>
27924David Gibson <david@gibson.dropbear.id.au>
f687d451 27925David Prévot <taffit@debian.org>
299c26a0
MK
27926Fabrice Bauzac <libnoon@gmail.com>
27927Greg Price <price@mit.edu>
27928Jon Grant <jg@jguk.org>
27929KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
27930Liu Jiaming <storypku@gmail.com>
27931Maxin B. John <maxin.john@enea.com>
27932Michael Kerrisk <mtk.manpages@gmail.com>
27933Paolo Bonzini <bonzini@gnu.org>
27934Peng Haitao <penght@cn.fujitsu.com>
27935Robert P. J. Day <rpjday@crashcourse.ca>
27936Rodrigo Campos <rodrigo@sdfg.com.ar>
27937Shawn Landden <shawn@churchofgit.com>
27938Trevor Bramwell <trevor@bramwell.net>
27939Vince Weaver <vincent.weaver@maine.edu>
27940Yang Yang <yangyang.gnu@gmail.com>
27941Yuanhang Zheng <zhengyhn@gmail.com>
27942Yuri Kozlov <yuray@komyakino.ru>
27943janh <a0vhv@t-online.de>
27944
27945Apologies if I missed anyone!
27946
27947
27948Global changes
27949--------------
27950
27951assert.3
27952assert_perror.3
27953rexec.3
27954rpc.3
27955 Michael Kerrisk [Jon Grant]
27956 Reword a sentence to use more gender-neutral language
27957
27958
27959Changes to individual pages
27960---------------------------
27961
27962execve.2
27963 Michael Kerrisk
27964 'arg...' for interpreter scripts starts with argv[1]
27965
27966fallocate.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
27972futex.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
27979getgroups.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
27987ioctl.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
27992perf_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
28028pipe.2
28029 Trevor Bramwell
28030 Fix error in example program
28031
28032poll.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
28041readlink.2
28042 Michael Kerrisk [Yuanhang Zheng]
28043 Fix typo in error message in example program
28044
28045recv.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
28051sched_get_priority_max.2
28052 Michael Kerrisk
28053 Add SCHED_IDLE to discussion
28054
28055send.2
28056 Michael Kerrisk
28057 RETURN VALUE: these calls return number of bytes (not characters) sent
28058
28059setreuid.2
28060 Michael Kerrisk
28061 Small clarification to description of when saved set-user-ID is set
28062
28063sigpending.2
28064 Michael Kerrisk
28065 Note treatment of signals that are blocked *and* ignored
28066
28067stat.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
28083symlink.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
28091adjtime.3
28092 Peng Haitao
28093 ATTRIBUTES: Note function that is thread-safe
28094 The function adjtime() is thread safe.
28095
28096alloca.3
28097 Peng Haitao
28098 ATTRIBUTES: Note function that is thread-safe
28099 The function alloca() is thread safe.
28100
28101asinh.3
28102 Peng Haitao
28103 ATTRIBUTES: Note functions that are thread-safe
28104 The functions asinh(), asinhf() and asinhl() are thread safe.
28105
28106atan.3
28107 Peng Haitao
28108 ATTRIBUTES: Note functions that are thread-safe
28109 The functions atan(), atanf() and atanl() are thread safe.
28110
28111atof.3
28112 Peng Haitao
28113 ATTRIBUTES: Note function that is thread safe with exceptions
28114 The function atof() is thread safe with exceptions.
28115
28116atoi.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
28122bcmp.3
28123 Peng Haitao
28124 ATTRIBUTES: Note function that is thread-safe
28125 The function bcmp() is thread safe.
28126
28127bcopy.3
28128 Peng Haitao
28129 ATTRIBUTES: Note function that is thread-safe
28130 The function bcopy() is thread safe.
28131
28132bsd_signal.3
28133 Peng Haitao
28134 ATTRIBUTES: Note function that is thread-safe
28135 The function bsd_signal() is thread safe.
28136
28137bzero.3
28138 Peng Haitao
28139 ATTRIBUTES: Note function that is thread-safe
28140 The function bzero() is thread safe.
28141
28142cbrt.3
28143 Peng Haitao
28144 ATTRIBUTES: Note functions that are thread-safe
28145 The functions cbrt(), cbrtf() and cbrtl() are thread safe.
28146
28147copysign.3
28148 Peng Haitao
28149 ATTRIBUTES: Note functions that are thread-safe
28150 The functions copysign(), copysignf() and copysignl() are thread
28151 safe.
28152
28153cos.3
28154 Peng Haitao
28155 ATTRIBUTES: Note functions that are thread-safe
28156 The functions cos(), cosf() and cosl() are thread safe.
28157
28158cproj.3
28159 Peng Haitao
28160 ATTRIBUTES: Note functions that are thread-safe
28161 The functions cproj(), cprojf() and cprojl() are thread safe.
28162
28163creal.3
28164 Peng Haitao
28165 ATTRIBUTES: Note functions that are thread-safe
28166 The functions creal(), crealf() and creall() are thread safe.
28167
28168daemon.3
28169 Peng Haitao
28170 ATTRIBUTES: Note function that is thread-safe
28171 The function daemon() is thread safe.
28172
28173des_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
28179difftime.3
28180 Peng Haitao
28181 ATTRIBUTES: Note function that is thread-safe
28182 The function difftime() is thread safe.
28183
28184dysize.3
28185 Peng Haitao
28186 ATTRIBUTES: Note function that is thread-safe
28187 The function dysize() is thread safe.
28188
28189erf.3
28190 Peng Haitao
28191 ATTRIBUTES: Note functions that are thread-safe
28192 The functions erf(), erff() and erfl() are thread safe.
28193
28194erfc.3
28195 Peng Haitao
28196 ATTRIBUTES: Note functions that are thread-safe
28197 The functions erfc(), erfcf() and erfcl() are thread safe.
28198
28199euidaccess.3
28200 Peng Haitao
28201 ATTRIBUTES: Note functions that are thread-safe
28202 The functions euidaccess() and eaccess() are thread safe.
28203
28204expm1.3
28205 Peng Haitao
28206 ATTRIBUTES: Note functions that are thread-safe
28207 The functions expm1(), expm1f() and expm1l() are thread safe.
28208
28209fexecve.3
28210 Michael Kerrisk
28211 POSIX.1-2008 specifies fexecve()
28212 Michael Kerrisk
28213 Explain the use and rationale of fexecve()
28214
28215ftime.3
28216 Peng Haitao
28217 ATTRIBUTES: Note function that is thread-safe
28218 The function ftime() is thread safe.
28219
28220ftok.3
28221 Peng Haitao
28222 ATTRIBUTES: Note function that is thread-safe
28223 The function ftok() is thread safe.
28224
28225ftw.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
28231futimes.3
28232 Peng Haitao
28233 ATTRIBUTES: Note functions that are thread-safe
28234 The functions futimes() and lutimes() are thread safe.
28235
28236getaddrinfo.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
28245kcmp.3
28246 Shawn Landden
28247 Reword slightly awkward section
28248
28249malloc.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
28275mq_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
28280setenv.3
28281 Michael Kerrisk
28282 Clarify that setenv() returns success in the overwrite==0 case
28283
28284sigsetops.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
28290statvfs.3
28291 Peng Haitao
28292 ATTRIBUTES: Note functions that are thread-safe
28293 The functions statvfs() and fstatvfs() are thread safe.
28294
28295stdarg.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
28301termios.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
28309ungetwc.3
28310 Peng Haitao
28311 ATTRIBUTES: Note function that is thread-safe
28312 The function ungetwc() is thread safe.
28313
28314unlockpt.3
28315 Peng Haitao
28316 ATTRIBUTES: Note function that is thread-safe
28317 The function unlockpt() is thread safe.
28318
28319usleep.3
28320 Peng Haitao
28321 ATTRIBUTES: Note function that is thread-safe
28322 The function usleep() is thread safe.
28323
28324wcpcpy.3
28325 Peng Haitao
28326 ATTRIBUTES: Note function that is thread-safe
28327 The function wcpcpy() is thread safe.
28328
28329wcscasecmp.3
28330 Peng Haitao
28331 ATTRIBUTES: Note function that is thread safe with exceptions
28332 The function wcscasecmp() is thread safe with exceptions.
28333
28334wcscat.3
28335 Peng Haitao
28336 ATTRIBUTES: Note function that is thread-safe
28337 The function wcscat() is thread safe.
28338
28339wcschr.3
28340 Peng Haitao
28341 ATTRIBUTES: Note function that is thread-safe
28342 The function wcschr() is thread safe.
28343
28344wcscmp.3
28345 Peng Haitao
28346 ATTRIBUTES: Note function that is thread-safe
28347 The function wcscmp() is thread safe.
28348
28349wcscpy.3
28350 Peng Haitao
28351 ATTRIBUTES: Note function that is thread-safe
28352 The function wcscpy() is thread safe.
28353
28354wcscspn.3
28355 Peng Haitao
28356 ATTRIBUTES: Note function that is thread-safe
28357 The function wcscspn() is thread safe.
28358
28359wcslen.3
28360 Peng Haitao
28361 ATTRIBUTES: Note function that is thread-safe
28362 The function wcslen() is thread safe.
28363
28364wcsncasecmp.3
28365 Peng Haitao
28366 ATTRIBUTES: Note function that is thread safe with exceptions
28367 The function wcsncasecmp() is thread safe with exceptions.
28368
28369wcsncat.3
28370 Peng Haitao
28371 ATTRIBUTES: Note function that is thread-safe
28372 The function wcsncat() is thread safe.
28373
28374wcsncmp.3
28375 Peng Haitao
28376 ATTRIBUTES: Note function that is thread-safe
28377 The function wcsncmp() is thread safe.
28378
28379wcsncpy.3
28380 Peng Haitao
28381 ATTRIBUTES: Note function that is thread-safe
28382 The function wcsncpy() is thread safe.
28383
28384wcsnlen.3
28385 Peng Haitao
28386 ATTRIBUTES: Note function that is thread-safe
28387 The function wcsnlen() is thread safe.
28388
28389wcspbrk.3
28390 Peng Haitao
28391 ATTRIBUTES: Note function that is thread-safe
28392 The function wcspbrk() is thread safe.
28393
28394wcsrchr.3
28395 Peng Haitao
28396 ATTRIBUTES: Note function that is thread-safe
28397 The function wcsrchr() is thread safe.
28398
28399wcsspn.3
28400 Peng Haitao
28401 ATTRIBUTES: Note function that is thread-safe
28402 The function wcsspn() is thread safe.
28403
28404wcsstr.3
28405 Peng Haitao
28406 ATTRIBUTES: Note function that is thread-safe
28407 The function wcsstr() is thread safe.
28408
28409wcstoimax.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
28415wcstok.3
28416 Peng Haitao
28417 ATTRIBUTES: Note function that is thread-safe
28418 The function wcstok() is thread safe.
28419
28420wcswidth.3
28421 Peng Haitao
28422 ATTRIBUTES: Note function that is thread safe with exceptions
28423 The function wcswidth() is thread safe with exceptions.
28424
28425wctrans.3
28426 Peng Haitao
28427 ATTRIBUTES: Note function that is thread safe with exceptions
28428 The function wctrans() is thread safe with exceptions.
28429
28430wctype.3
28431 Peng Haitao
28432 ATTRIBUTES: Note function that is thread safe with exceptions
28433 The function wctype() is thread safe with exceptions.
28434
28435wcwidth.3
28436 Peng Haitao
28437 ATTRIBUTES: Note function that is thread safe with exceptions
28438 The function wcwidth() is thread safe with exceptions.
28439
28440wmemchr.3
28441 Peng Haitao
28442 ATTRIBUTES: Note function that is thread-safe
28443 The function wmemchr() is thread safe.
28444
28445wmemcmp.3
28446 Peng Haitao
28447 ATTRIBUTES: Note function that is thread-safe
28448 The function wmemcmp() is thread safe.
28449
28450wmemcpy.3
28451 Peng Haitao
28452 ATTRIBUTES: Note function that is thread-safe
28453 The function wmemcpy() is thread safe.
28454
28455wmemmove.3
28456 Peng Haitao
28457 ATTRIBUTES: Note function that is thread-safe
28458 The function wmemmove() is thread safe.
28459
28460wmemset.3
28461 Peng Haitao
28462 ATTRIBUTES: Note function that is thread-safe
28463 The function wmemset() is thread safe.
28464
28465tty_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
28471proc.5
28472 Michael Kerrisk
28473 Document /proc/sys/kernel/ngroups_max
28474
28475capabilities.7
28476 Michael Kerrisk
28477 Fix 2 version numbers under "Effect of user ID changes on capabilities"
299c26a0
MK
28478
28479feature_test_macros.7
28480 Michael Kerrisk
28481 Add _ISOC11_SOURCE to example program
28482
28483tcp.7
28484 Michael Kerrisk
28485 Fix (nontrivial) wordo in discussion of MSG_TRUNC
28486 s/MSG_PEEK/MSG_TRUNC/
28487
28488ld.so.8
28489 Michael Kerrisk [Alfred Agrell]
28490 Fix crufty wording in one sentence
d7628532
MK
28491
28492
28493==================== Changes in man-pages-3.56 ====================
28494
28495Released: 2014-01-11, Christchurch
28496
28497In memory of Doris Church (1939-2013)
28498
28499
28500Contributors
28501------------
28502
28503The following people contributed patches/fixes or (noted in brackets
28504in the changelog below) reports, notes, and ideas that have been
28505incorporated in changes in this release:
28506
28507Andre Majorel <aym-xunil@teaser.fr>
28508Arif Zaman <arifz@lums.edu.pk>
28509Bert Wesarg <bert.wesarg@googlemail.com>
28510Daniel Borkmann <dborkman@redhat.com>
28511David Malcolm <dmalcolm@redhat.com>
f687d451 28512David Prévot <taffit@debian.org>
d7628532
MK
28513Dongsheng Song <dongsheng.song@gmail.com>
28514Elie De Brauwer <eliedebrauwer@gmail.com>
28515James Smith <james@theta.pw>
28516Janne Blomqvist <blomqvist.janne@gmail.com>
28517Joseph S. Myers <joseph@codesourcery.com>
28518Luke Hutchison <luke.hutch@mit.edu>
28519Marco Dione <mdione@grulic.org.ar>
28520Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
28521Mathieu Malaterre <malat@debian.org>
28522Matthias Klose <doko@debian.org>
28523Michael Kerrisk <mtk.manpages@gmail.com>
28524Mike Frysinger <vapier@gentoo.org>
f687d451 28525Moritz 'Morty' Strübe <morty@gmx.net>
d7628532 28526Nadav Har'El <nyh@math.technion.ac.il>
f687d451
SP
28527Ondřej Bílka <neleai@seznam.cz>
28528Prádraig Brady <P@draigBrady.com>
d7628532
MK
28529Peng Haitao <penght@cn.fujitsu.com>
28530Raphael Geissert <geissert@debian.org>
28531Shawn Landden <shawn@churchofgit.com>
28532Simon Paillard <spaillard@debian.org>
28533Stephen Kell <srk31@srcf.ucam.org>
28534Sudhanshu Goswami <Sudhanshu.Goswami@emc.com>
28535Sworddragon2 <sworddragon2@aol.com>
28536Vince Weaver <vincent.weaver@maine.edu>
28537Willem de Bruijn <willemb@google.com>
28538Yuri Kozlov <yuray@komyakino.ru>
28539
28540Apologies if I missed anyone!
28541
28542
28543New and rewritten pages
28544-----------------------
28545
28546fgetc.3
28547gets.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
28573vdso.7
28574 Mike Frysinger
28575 New page documenting the vDSO mapped into each process by the kernel
28576
28577
28578Newly documented interfaces in existing pages
28579---------------------------------------------
28580
28581reboot.2
28582 Elie De Brauwer
28583 Document LINUX_REBOOT_SW_SUSPEND
28584
28585
28586New and changed links
28587---------------------
28588
28589fgets.3
28590getc.3
28591getchar.3
28592ungetc.3
28593 Michael Kerrisk
28594 Adjust links to gets(3) to point to fgetc(3)
28595
28596
28597Global changes
28598--------------
28599
28600Various 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
28606Various pages
28607 Michael Kerrisk
28608 Stylistic changes to code example
28609 For ease of reading, don't embed assignments inside if().
28610
28611Various 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
28617Various 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
28623Various pages
28624 Michael Kerrisk
28625 Add "Program source" subheading under EXAMPLE
28626
28627Various pages
28628 Michael Kerrisk
28629 Add "static" to global variables and functions in example program
28630
28631
28632Changes to individual pages
28633---------------------------
28634
28635clock_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
28640close.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
28651execve.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
28656perf_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
28667reboot.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
28683setpgid.2
28684 Michael Kerrisk [Joseph S. Myers]
28685 BSD getpgrp() and setpgrp() go away in glibc 2.19
fca91e76 28686
d7628532
MK
28687socket.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
28692syscall.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
28700syscall.2
28701syscalls.2
28702getauxval.3
28703 Mike Frysinger
28704 Add references to new vdso(7) page
28705
28706utimensat.2
28707 Michael Kerrisk
28708 Small wording improvement for times!=NULL case
28709
28710dlopen.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
28719getline.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
28726mcheck.3
28727 Simon Paillard [Raphael Geissert]
28728 typo in compiler flag
28729 See http://bugs.debian.org/732464
28730
28731mkstemp.3
28732 Michael Kerrisk [Janne Blomqvist]
28733 Better describe 'flags' that can be specified for mkostemp()
28734
28735printf.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
28740pthread_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
28749puts.3
28750 Michael Kerrisk
28751 SEE ALSO: replace reference to gets(3) with fgets(3)
28752
28753scanf.3
f687d451 28754 Michael Kerrisk [Ondřej Bílka]
d7628532
MK
28755 Improve discussion of obsolete 'a' dynamic allocation modifier
28756
28757setjmp.3
28758 Michael Kerrisk [Joseph S. Myers]
28759 BSD setjmp() semantics go away in glibc 2.19
28760
28761sigpause.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
28770sigqueue.3
28771 Peng Haitao
28772 ATTRIBUTES: Note function that is thread-safe
28773 The function sigqueue() is thread safe.
28774
28775sigwait.3
28776 Peng Haitao
28777 ATTRIBUTES: Note function that is thread-safe
28778 The function sigwait() is thread safe.
28779
28780sin.3
28781 Peng Haitao
28782 ATTRIBUTES: Note functions that are thread-safe
28783 The functions sin(), sinf() and sinl() are thread safe.
28784
28785sincos.3
28786 Peng Haitao
28787 ATTRIBUTES: Note functions that are thread-safe
28788 The functions sincos(), sincosf() and sincosl() are thread safe.
28789
28790string.3
f687d451 28791 Moritz 'Morty' Strübe
d7628532
MK
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
f687d451 28796 Fixes and enhancements to Moritz Strübe's patch
d7628532
MK
28797
28798strptime.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
28807strsep.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
28813strspn.3
28814 Michael Kerrisk [Mathieu Malaterre]
28815 Improve description in NAME
28816 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=723659
28817
28818strstr.3
28819 Michael Kerrisk
28820 Clarify RETURN VALUE: s/substring/located substring/
28821
28822sysv_signal.3
28823 Peng Haitao
28824 ATTRIBUTES: Note function that is thread-safe
28825 The function sysv_signal() is thread safe.
28826
28827tan.3
28828 Peng Haitao
28829 ATTRIBUTES: Note functions that are thread-safe
28830 The functions tan(), tanf() and tanl() are thread safe.
28831
28832tanh.3
28833 Peng Haitao
28834 ATTRIBUTES: Note functions that are thread-safe
28835 The functions tanh(), tanhf() and tanhl() are thread safe.
28836
28837toascii.3
28838 Peng Haitao
28839 ATTRIBUTES: Note function that is thread-safe
28840 The function toascii() is thread safe.
28841
28842toupper.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
28848towctrans.3
28849 Peng Haitao
28850 ATTRIBUTES: Note function that is thread-safe
28851 The function towctrans() is thread safe.
28852
28853towlower.3
28854 Peng Haitao
28855 ATTRIBUTES: Note function that is thread safe with exceptions
28856 The function towlower() is thread safe with exceptions.
28857
28858towupper.3
28859 Peng Haitao
28860 ATTRIBUTES: Note function that is thread safe with exceptions
28861 The function towupper() is thread safe with exceptions.
28862
28863ualarm.3
28864 Peng Haitao
28865 ATTRIBUTES: Note function that is thread-safe
28866 The function ualarm() is thread safe.
28867
28868wcpncpy.3
28869 Peng Haitao
28870 ATTRIBUTES: Note function that is thread-safe
28871 The function wcpncpy() is thread safe.
28872
28873proc.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
28878credentials.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
28884feature_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
28892libc.7
28893 Mike Frysinger
28894 SEE ALSO: add various entries
28895
28896man-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
28908packet.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
28919ld.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
95072db4
MK
28924
28925
28926==================== Changes in man-pages-3.57 ====================
28927
28928Released: 2014-01-24, Munich
28929
28930
28931Contributors
28932------------
28933
28934The following people contributed patches/fixes or (noted in brackets
28935in the changelog below) reports, notes, and ideas that have been
28936incorporated in changes in this release:
28937
28938Andi Kleen <andi@firstfloor.org>
28939Andre Majorel <aym-xunil@teaser.fr>
28940Andrey Vagin <avagin@openvz.org>
28941Andy Lutomirski <luto@amacapital.net>
28942Axel Beckert <abe@debian.org>
28943Bernhard Walle <bernhard@bwalle.de>
28944Brandon Edens <bedens@fitbit.com>
28945Eliezer Tamir <eliezer.tamir@linux.intel.com>
28946Gioele Barabucci <gioele@svario.it>
28947Ian Abbott <abbotti@mev.co.uk>
28948Jerry Chu <hkchu@google.com>
28949Jonas Jonsson <jonas@websystem.se>
28950Marc Lehmann <debian-reportbug@plan9.de>
28951Michael Kerrisk <mtk.manpages@gmail.com>
12309d0d 28952Mike Frysinger <vapier@gentoo.org>
95072db4
MK
28953Peng Haitao <penght@cn.fujitsu.com>
28954Reuben Thomas <rrt@sc3d.org>
28955Simone Piccardi <piccardi@truelite.it>
28956Simon Paillard <spaillard@debian.org>
28957Thomas Posch <man-pages@online.posch.name>
28958Tilman Schmidt <tilman@imap.cc>
28959Vince Weaver <vincent.weaver@maine.edu>
28960Yuri Kozlov <yuray@komyakino.ru>
f687d451 28961Марк Коренберг <socketpair@gmail.com>
95072db4
MK
28962
28963Apologies if I missed anyone!
28964
28965
28966Newly documented interfaces in existing pages
28967---------------------------------------------
28968
12309d0d
MK
28969msgop.2
28970 Michael Kerrisk
28971 Document MSG_COPY
28972
95072db4
MK
28973open.2
28974 Michael Kerrisk, Andy Lutomirski
28975 Document O_TMPFILE
28976 O_TMPFILE is new in Linux 3.11
28977
12309d0d
MK
28978perf_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
95072db4
MK
29001ptrace.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
12309d0d
MK
29010socket.7
29011 Eliezer Tamir
29012 Add description for SO_BUSY_POLL
29013 Add description for the SO_BUSY_POLL socket option.
29014
29015tcp.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
95072db4
MK
29023
29024Global changes
29025--------------
29026
29027Various pages
29028 Michael Kerrisk
29029 Reword to avoid use of "etc."
29030
29031Various pages
29032 Peng Haitao [Andre Majorel]
29033 Make wording around thread-safety and setlocale() more precise
29034
29035getdate.3
29036strptime.3
29037locale.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
29045Changes to individual pages
29046---------------------------
29047
29048epoll_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
29053faccessat.2
29054 Michael Kerrisk
29055 Note that the system call takes only three arguments
29056
29057fallocate.2
29058 Michael Kerrisk
29059 Note filesystems that support FALLOC_FL_PUNCH_HOLE operation
29060
29061fcntl.2
29062 Michael Kerrisk
29063 BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL
29064 Michael Kerrisk
80e1913a 29065 Add subsections under BUGS
95072db4
MK
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
29071getrlimit.2
f687d451 29072 Michael Kerrisk [Марк Коренберг]
95072db4
MK
29073 Note that rlim_cur can be set lower than current resource consumption
29074
29075getsockopt.2
29076 Michael Kerrisk
29077 SEE ALSO: add ip(7) and udp(7)
29078
29079keyctl.2
29080 Michael Kerrisk
29081 SEE ALSO: mention Documentation/security/keys.txt
29082
29083linkat.2
29084 Michael Kerrisk
29085 Add ENOENT for O_TMPFILE created with O_EXCL
29086 Michael Kerrisk
29087 ERRORS: Add EINVAL
29088
29089lseek.2
29090 Michael Kerrisk
29091 Note which filesystems support SEEK_HOLE/SEEK_DATA
29092
29093msgop.2
95072db4
MK
29094 Michael Kerrisk
29095 Note that MSG_EXCEPT is Linux-specific
29096
29097open.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
29109ptrace.2
29110 Michael Kerrisk
29111 Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK
29112
29113select.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
29118syscalls.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
29124timer_create.2
29125 Michael Kerrisk
29126 Add pointer to proc(5) for info on /proc/[pid]/timers
29127
29128unlinkat.2
29129 Michael Kerrisk [Mike Frysinger:]
29130 ERRORS: Add EISDIR
29131 See https://bugzilla.kernel.org/show_bug.cgi?id=29702
29132
95072db4
MK
29133ferror.3
29134 Michael Kerrisk
29135 clearerr(), feof(), and ferror() are also POSIX-conformant
29136 Michael Kerrisk [Reuben Thomas]
29137 CONFORMING TO: add fileno()
29138
29139gets.3
29140 Ian Abbott
29141 SEE ALSO: add fgets(3)
29142
29143mq_receive.3
29144mq_send.3
29145 Michael Kerrisk [Simone Piccardi]
29146 SYNOPSIS: s/unsigned/unsigned int/
29147
29148printf.3
29149 Michael Kerrisk
29150 Small reorganization of text in EXAMPLE
29151
29152rand.3
29153 Michael Kerrisk
29154 s/unsigned/unsigned int/ in example
29155
29156stpcpy.3
29157 Peng Haitao
29158 ATTRIBUTES: Note function that is thread-safe
29159 The function stpcpy() is thread safe.
29160
29161stpncpy.3
29162 Peng Haitao
29163 ATTRIBUTES: Note function that is thread-safe
29164 The function stpncpy() is thread safe.
29165
29166strcat.3
29167 Peng Haitao
29168 ATTRIBUTES: Note functions that are thread-safe
29169 The functions strcat() and strncat() are thread safe.
29170
29171strchr.3
29172 Peng Haitao
29173 ATTRIBUTES: Note functions that are thread-safe
29174 The functions strchr(), strrchr() and strchrnul() are thread safe.
29175
29176strcmp.3
29177 Peng Haitao
29178 ATTRIBUTES: Note functions that are thread-safe
29179 The functions strcmp() and strncmp() are thread safe.
29180
29181strftime.3
29182 Brandon Edens
29183 Change "week day" to "day of week"
29184 See https://bugzilla.kernel.org/show_bug.cgi?id=68861
29185
29186strstr.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
29192strtod.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
29198strtoimax.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
29204strtol.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
29210tcgetpgrp.3
29211 Peng Haitao
29212 ATTRIBUTES: Note functions that are thread-safe
29213 The functions tcgetpgrp() and tcsetpgrp() are thread safe.
29214
29215tcgetsid.3
29216 Peng Haitao
29217 ATTRIBUTES: Note function that is thread-safe
29218 The function tcgetsid() is thread safe.
29219
29220core.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
29227filesystems.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
29232locale.5
29233 Michael Kerrisk
29234 SEE ALSO: add locale(7)
29235
29236proc.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
29246environ.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
29260man-pages.7
29261 Michael Kerrisk
29262 Prefer "usable" over "useable"
29263
29264netdevice.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
95072db4
MK
29279standards.7
29280 Michael Kerrisk
29281 Enhance description of V7
29282 Michael Kerrisk
29283 Add C11
29284
29285tcp.7
95072db4
MK
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.
cbf9351c
MK
29290
29291
29292==================== Changes in man-pages-3.58 ====================
29293
29294Released: 2014-02-11, Munich
29295
29296
29297Contributors
29298------------
29299
29300The following people contributed patches/fixes or (noted in brackets
29301in the changelog below) reports, notes, and ideas that have been
29302incorporated in changes in this release:
29303
29304Cyril Hrubis <chrubis@suse.cz>
29305Daniel Borkmann <dborkman@redhat.com>
f687d451 29306David Prévot <taffit@debian.org>
cbf9351c
MK
29307Fabrice Bauzac <libnoon@gmail.com>
29308Michael Kerrisk <mtk.manpages@gmail.com>
29309Mike Frysinger <vapier@gentoo.org>
29310Network Nut <sillystack@gmail.com>
29311Ola Olsson <ola1olsson@gmail.com>
29312Peng Haitao <penght@cn.fujitsu.com>
29313Peter Schiffer <pschiffe@redhat.com>
29314Simone Piccardi <piccardi@truelite.it>
29315Simon Paillard <spaillard@debian.org>
29316Yuri Kozlov <yuray@komyakino.ru>
f687d451
SP
29317Марк Коренберг <socketpair@gmail.com>
29318未卷起的浪 <ayjj_8109@qq.com>
cbf9351c
MK
29319
29320Apologies if I missed anyone!
29321
29322
29323Newly documented interfaces in existing pages
29324---------------------------------------------
29325
29326pipe.2
29327 Michael Kerrisk
29328 Document the pipe2() O_DIRECT flag added in Linux 3.4
29329
29330packet.7
29331 Daniel Borkmann
29332 Document PACKET_QDISC_BYPASS
29333 New in Linux 3.14.
29334
29335
29336Global changes
29337--------------
29338
29339Various 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
29345Various 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
29353Various pages
29354 Michael Kerrisk
29355 Use Oxford comma
29356
29357gettid.2
29358restart_syscall.2
29359passwd.5
29360socket.7
29361 Michael Kerrisk
29362 Fix order of SEE ALSO entries
29363
29364
29365Changes to individual pages
29366---------------------------
29367
29368epoll_wait.2
29369 Michael Kerrisk [Network Nut]
29370 Remove word "minimum" from the description of 'timeout'
29371
29372epoll_wait.2
29373poll.2
29374select.2
29375 Michael Kerrisk
29376 Go into more detail on timeout and when call will cease blocking
29377
29378getxattr.2
29379listxattr.2
29380removexattr.2
29381setxattr.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
29386msgctl.2
29387 Cyril Hrubis
29388 Add note about ignored arg to IPC_RMID
29389
29390prctl.2
f687d451 29391 Michael Kerrisk [Марк Коренберг]
cbf9351c
MK
29392 PR_SET_PDEATHSIG value is preserved across execve(2)
29393
29394recv.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
1966fc7b 29399 separate subheading.
cbf9351c
MK
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()
f687d451 29404 Michael Kerrisk [未卷起的浪]
cbf9351c
MK
29405 Describe the various cases where the return value can be 0
29406
29407shmctl.2
29408 Michael Kerrisk
29409 Note that 'buf' is ignored for IPC_RMID
29410
29411symlinkat.2
29412 Michael Kerrisk
29413 Make argument names consistent with symlink(2) page
29414
29415isalpha.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
29422isatty.3
29423 Peng Haitao
29424 ATTRIBUTES: Note function that is thread-safe
29425 The function isatty() is thread safe.
29426
29427isgreater.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
29433iswalnum.3
29434 Peng Haitao
29435 ATTRIBUTES: Note function that is thread safe with exceptions
29436 The function iswalnum() is thread safe with exceptions.
29437
29438iswalpha.3
29439 Peng Haitao
29440 ATTRIBUTES: Note function that is thread safe with exceptions
29441 The function iswalpha() is thread safe with exceptions.
29442
29443iswblank.3
29444 Peng Haitao
29445 ATTRIBUTES: Note function that is thread safe with exceptions
29446 The function iswblank() is thread safe with exceptions.
29447
29448iswcntrl.3
29449 Peng Haitao
29450 ATTRIBUTES: Note function that is thread safe with exceptions
29451 The function iswcntrl() is thread safe with exceptions.
29452
29453lockf.3
29454 Michael Kerrisk [Simone Piccardi]
29455 Fix incorrect argument mentioned under EINVAL error
29456
29457pthread_kill.3
29458 Michael Kerrisk
29459 Add feature test macro requirements
29460
29461pthread_sigmask.3
29462 Michael Kerrisk
29463 Add feature test macro requirements
29464
29465strtoul.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
29471nscd.conf.5
29472 Peter Schiffer
29473 Add note about default values
29474
29475proc.5
29476 Michael Kerrisk
29477 SEE ALSO: Add some further kernel Documentation/sysctl files
29478
29479man-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
29485vdso.7
29486 Michael Kerrisk
29487 Add words "virtual dynamic shared object" in DESCRIPTION
3bfe7277
MK
29488
29489
29490==================== Changes in man-pages-3.59 ====================
29491
29492Released: 2014-02-16, Munich
29493
29494
29495Contributors
29496------------
29497
29498The following people contributed patches/fixes or (noted in brackets
29499in the changelog below) reports, notes, and ideas that have been
29500incorporated in changes in this release:
29501
29502Michael Kerrisk <mtk.manpages@gmail.com>
29503Peter Schiffer <pschiffe@redhat.com>
29504Weizhou Pan <cs.wzpan@gmail.com>
29505
29506Apologies if I missed anyone!
29507
29508
29509Global changes
29510--------------
29511
29512Various pages
b09ecebd 29513 Peter Schiffer, Michael Kerrisk [Weizhou Pan]
1c753960 29514 Convert pages containing non-ASCII in source code comments to use UTF-8
3bfe7277
MK
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
3bfe7277
MK
29523armscii-8.7
29524cp1251.7
29525iso_8859-1.7
29526iso_8859-10.7
29527iso_8859-11.7
29528iso_8859-13.7
29529iso_8859-14.7
29530iso_8859-15.7
29531iso_8859-16.7
29532iso_8859-2.7
29533iso_8859-3.7
29534iso_8859-4.7
29535iso_8859-5.7
29536iso_8859-6.7
29537iso_8859-7.7
29538iso_8859-8.7
29539iso_8859-9.7
29540koi8-r.7
29541koi8-u.7
b09ecebd 29542 Peter Schiffer, Michael Kerrisk [Weizhou Pan]
1c753960 29543 Convert pages containing non-ASCII to use UTF-8
3bfe7277
MK
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
324197b5
MK
29549
29550
29551==================== Changes in man-pages-3.60 ====================
29552
29553Released: 2014-02-18, Munich
29554
29555
29556Contributors
29557------------
29558
29559The following people contributed patches/fixes or (noted in brackets
29560in the changelog below) reports, notes, and ideas that have been
29561incorporated in changes in this release:
29562
29563David Prévot <taffit@debian.org>
29564D. Barbier <bouzim@gmail.com>
29565Kalle Olavi Niemitalo <kon@iki.fi>
29566Michael Kerrisk <mtk.manpages@gmail.com>
29567Simon Paillard <spaillard@debian.org>
29568
29569Apologies if I missed anyone!
29570
29571
29572Changes to individual pages
29573---------------------------
29574sigvec.3
29575 Michael Kerrisk [Kalle Olavi Niemitalo]
29576 Fix error in code snippet
29577 s/sigpause/sigmask/
29578
29579armscii-8.7
29580cp1251.7
29581iso_8859-1.7
29582iso_8859-10.7
29583iso_8859-11.7
29584iso_8859-13.7
29585iso_8859-14.7
29586iso_8859-15.7
29587iso_8859-16.7
29588iso_8859-2.7
29589iso_8859-3.7
29590iso_8859-4.7
29591iso_8859-5.7
29592iso_8859-6.7
29593iso_8859-7.7
29594iso_8859-8.7
29595iso_8859-9.7
29596koi8-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
29603iso_8859-11.7
29604iso_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
68a543dd
MK
29615
29616
29617==================== Changes in man-pages-3.61 ====================
29618
29619Released: 2014-02-26, Munich
29620
29621
29622Contributors
29623------------
29624
29625The following people contributed patches/fixes or (noted in brackets
29626in the changelog below) reports, notes, and ideas that have been
29627incorporated in changes in this release:
29628
29629Andrew Hunter <ahh@google.com>
29630Carlos O'Donell <carlos@redhat.com>
29631Christoph Hellwig <hch@infradead.org>
29632Daniel Borkmann <dborkman@redhat.com>
29633Duncan de Wet <duncandewet@gmail.com>
29634Kir Kolyshkin <kir@openvz.org>
29635KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
29636Michael Kerrisk <mtk.manpages@gmail.com>
29637Neil Horman <nhorman@tuxdriver.com>
29638Peng Haitao <penght@cn.fujitsu.com>
29639Simon Paillard <spaillard@debian.org>
29640Sulaiman Mustafa <seininn@hush.com>
29641Xiawei Chen <chenxiawei@gmail.com>
29642
29643Apologies if I missed anyone!
29644
29645
29646New and rewritten pages
29647-----------------------
29648
29649A note from Christoph Hellwig prompted me to perform a task that has
29650been queued for a while: merging the text of the man pages for the
29651*at([23]) ("directory file descriptor") APIs into their corresponding
29652traditional pages. When the *at([23]) pages were originally written
29653(mostly in 2006), the APIs were not part of POSIX and (in most cases)
29654were not available on other systems. So, it made some sense to wall
29655them off into their own separate pages. Eight years later, with the
29656APIs now all in POSIX (except scandirat()), it is much more sensible
29657to document the newer APIs alongside their traditional counterparts,
29658so that the newer APIs are not "hidden", and the reader can more
29659easily see the differences between the APIs.
29660
29661Thus, the text of 14 pairs of pages has been merged, and the "merged
29662from" pages have been converted to links to the "merged to" pages.
29663Along the way, a few other fixes were made to the pages, as noted
29664below.
29665
29666One page that did not undergo such a change was utimensat(2), which
29667is different enough from utime(2) that it warrants a separate page.
29668Unlike the other *at() pages, the utimensat(2) page was also already
29669self-contained, rather than defining itself in terms of differences
29670from utime(2) as the other *at() pages did.
29671
29672access.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
29681chmod.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
29690chown.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
29705link.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
29713mkdir.2
29714 Michael Kerrisk
29715 Merge text of mkdirat(2)
29716 Michael Kerrisk
29717 CONFORMING TO: mkdir() is in POSIX.1-2008
29718
29719mknod.2
29720 Michael Kerrisk
29721 Merge text of mknodat(2)
29722 Michael Kerrisk
29723 CONFORMING TO: mknod(2) is in POSIX.1-2008
29724
29725open.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
29733readlink.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
29742rename.2
29743 Michael Kerrisk
29744 Merge text of renameat(2)
29745 Michael Kerrisk
29746 CONFORMING TO: rename(2) is in POSIX.1-2008
29747
29748stat.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
29764symlink.2
29765 Michael Kerrisk
29766 Merge text of symlinkat(2)
29767 Michael Kerrisk
29768 CONFORMING TO: symlink() is in POSIX.1-2008
29769
29770unlink.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
29780mkfifo.3
29781 Michael Kerrisk
29782 Merge text of mkfifoat(3)
29783 Michael Kerrisk
29784 CONFORMING TO: mkfifo() is in POSIX.1-2008
29785
29786scandir.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
29802Newly documented interfaces in existing pages
29803---------------------------------------------
29804
29805prctl.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
29818socket.7
29819 Neil Horman
29820 Document the SO_RXQ_OVFL socket option
29821 Michael Kerrisk
4e84afd6 29822 Add kernel version number for SO_RXQ_OVFL
68a543dd
MK
29823
29824
29825New and changed links
29826---------------------
29827
29828faccessat.2
29829 Michael Kerrisk
29830 Convert to link to access.2
29831
29832fchmodat.2
29833 Michael Kerrisk
29834 Convert to link to chmod.2
29835
29836fchownat.2
29837 Michael Kerrisk
29838 Convert to link to chown.2
29839
29840fstatat.2
29841 Michael Kerrisk
29842 Convert to link to stat.2
29843
29844linkat.2
29845 Michael Kerrisk
29846 Convert to link to link.2
29847
29848mkdirat.2
29849 Michael Kerrisk
29850 Convert to link to mkdir.2
29851
29852mknodat.2
29853 Michael Kerrisk
29854 Convert to link to mknod.2
29855
29856openat.2
29857 Michael Kerrisk
29858 Convert to link to open.2
29859
29860readlinkat.2
29861 Michael Kerrisk
29862 Convert to link to symlink.2
29863
29864renameat.2
29865 Michael Kerrisk
29866 Convert to link rename.2
29867
29868symlinkat.2
29869 Michael Kerrisk
29870 Convert to link to symlink.2
29871
29872unlinkat.2
29873 Michael Kerrisk
29874 Convert to link to unlink.2
29875
29876mkfifoat.3
29877 Michael Kerrisk
29878 Convert to link to mkfifo.3
29879
29880scandirat.3
29881 Michael Kerrisk
29882 Convert to link to scandir.3
29883
29884
29885Changes to individual pages
29886---------------------------
29887
29888alarm.2
29889 Michael Kerrisk
29890 Note semantics of alarm with respect to fork() and execve()
29891
29892fcntl.2
29893 Michael Kerrisk
29894 Warn that F_GETLK info may already be out of date when the call returns
29895
29896intro.2
29897 Michael Kerrisk
29898 Describe policy on documenting differences between syscall and glibc API
29899
29900mmap2.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
29906msgctl.2
29907 Michael Kerrisk
29908 ERRORS: add EPERM for unprivileged attempt to set msg_qbytes > MSGMNB
29909
29910prctl.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
29918ptrace.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
29927sgetmask.2
29928 Michael Kerrisk
29929 Note that these system calls don't exist on x86-64
29930
29931swapon.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
29937syscalls.2
29938 Michael Kerrisk
29939 SEE ALSO: add intro(2)
29940
29941umount.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
29947utime.2
29948 Michael Kerrisk
29949 Add note that modern applications probably want utimensat(2) etc.
29950
29951crypt.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
29956getifaddrs.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
29963iswctype.3
29964 Peng Haitao
29965 ATTRIBUTES: Note function that is thread-safe
29966 The function iswctype() is thread safe.
29967
29968sem_post.3
29969 Peng Haitao
29970 ATTRIBUTES: Note function that is thread-safe
29971 The function sem_post() is thread safe.
29972
29973sem_unlink.3
29974 Peng Haitao
29975 ATTRIBUTES: Note function that is thread-safe
29976 The function sem_unlink() is thread safe.
29977
29978sem_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
29984setbuf.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
29990strlen.3
29991 Peng Haitao
29992 ATTRIBUTES: Note function that is thread-safe
29993 The function strlen() is thread safe.
29994
29995strnlen.3
29996 Peng Haitao
29997 ATTRIBUTES: Note function that is thread-safe
29998 The function strnlen() is thread safe.
29999
30000strpbrk.3
30001 Peng Haitao
30002 ATTRIBUTES: Note function that is thread-safe
30003 The function strpbrk() is thread safe.
30004
30005strsep.3
30006 Peng Haitao
30007 ATTRIBUTES: Note function that is thread-safe
30008 The function strsep() is thread safe.
30009
30010swab.3
30011 Peng Haitao
30012 ATTRIBUTES: Note function that is thread-safe
30013 The function swab() is thread safe.
30014
30015resolv.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
30028ascii.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
30036packet.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
30044socket.7
30045 Michael Kerrisk
30046 Add kernel version number for SO_BUSY_POLL
5229d5de
MK
30047
30048
30049==================== Changes in man-pages-3.62 ====================
30050
30051Released: 2014-03-11, Munich
30052
30053
30054Contributors
30055------------
30056
30057The following people contributed patches/fixes or (noted in brackets
30058in the changelog below) reports, notes, and ideas that have been
30059incorporated in changes in this release:
30060
30061Cyril Hrubis <chrubis@suse.cz>
30062Joseph S. Myers <joseph@codesourcery.com>
30063Marius Gaubas <marius@livejournalinc.com>
30064Michael Kerrisk <mtk.manpages@gmail.com>
30065Mike Frysinger <vapier@gentoo.org>
30066Peng Haitao <penght@cn.fujitsu.com>
30067Rick Stanley <rstanley@rsiny.com>
30068Simon Paillard <spaillard@debian.org>
30069
30070Apologies if I missed anyone!
30071
30072
30073New and rewritten pages
30074-----------------------
30075
30076locale.1
30077 Michael Kerrisk [review from Mike Frysinger]
30078 New page describing locale(1)
30079
30080
30081Newly documented interfaces in existing pages
30082---------------------------------------------
30083
30084locale.5
30085 Michael Kerrisk
c7c46d4f 30086 Document LC_ADDRESS
5229d5de 30087 Michael Kerrisk
c7c46d4f 30088 Document LC_IDENTIFICATION
5229d5de
MK
30089 Michael Kerrisk
30090 Document LC_MEASUREMENT
30091 Michael Kerrisk
c7c46d4f 30092 Document LC_NAME
5229d5de 30093 Michael Kerrisk
c7c46d4f 30094 Document LC_PAPER
5229d5de 30095 Michael Kerrisk
c7c46d4f 30096 Document LC_TELEPHONE
5229d5de
MK
30097
30098
e61ab817
MK
30099Removed Pages
30100-------------
30101
30102sync.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
80e1913a 30112 covers the same command. After discussions on the
fa1d49a6 30113 coreutils list, I've decided to retire this page from
e61ab817
MK
30114 man-pages.
30115
5229d5de
MK
30116Changes to individual pages
30117---------------------------
30118
30119clone.2
30120 Michael Kerrisk
c7c46d4f 30121 Note that CLONE_THREAD also in effect requires CLONE_VM
5229d5de
MK
30122
30123stat.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
30129gethostbyname.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
30140getutmp.3
30141 Michael Kerrisk
30142 SEE ALSO: add utmpdump(1)
30143
30144log1p.3
30145 Peng Haitao
30146 ATTRIBUTES: Note functions that are thread-safe
30147 The functions log1p(), log1pf() and log1pl() are thread safe.
30148
30149logb.3
30150 Peng Haitao
30151 ATTRIBUTES: Note functions that are thread-safe
30152 The functions logb(), logbf() and logbl() are thread safe.
30153
30154memccpy.3
30155 Peng Haitao
30156 ATTRIBUTES: Note function that is thread-safe
30157 The function memccpy() is thread safe.
30158
30159memchr.3
30160 Peng Haitao
30161 ATTRIBUTES: Note functions that are thread-safe
30162 The functions memchr(), memrchr() and rawmemchr() are thread safe.
30163
30164mktemp.3
30165 Michael Kerrisk
30166 Make warning not to use this function more prominent
30167
30168qecvt.3
30169 Michael Kerrisk [Joseph S. Myers]
30170 Recommend snprintf(3) not sprintf(3)
30171
30172raise.3
30173 Peng Haitao
30174 ATTRIBUTES: Note function that is thread-safe
30175 The function raise() is thread safe.
30176
30177remove.3
30178 Peng Haitao
30179 ATTRIBUTES: Note function that is thread-safe
30180 The function remove() is thread safe.
30181
30182sem_destroy.3
30183 Peng Haitao
30184 ATTRIBUTES: Note function that is thread-safe
30185 The function sem_destroy() is thread safe.
30186
30187sem_getvalue.3
30188 Peng Haitao
30189 ATTRIBUTES: Note function that is thread-safe
30190 The function sem_getvalue() is thread safe.
30191
30192sem_init.3
30193 Peng Haitao
30194 ATTRIBUTES: Note function that is thread-safe
30195 The function sem_init() is thread safe.
30196
30197sockatmark.3
30198 Peng Haitao
30199 ATTRIBUTES: Note function that is thread-safe
30200 The function sockatmark() is thread safe.
30201
30202strcpy.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
30209strspn.3
30210 Peng Haitao
30211 ATTRIBUTES: Note functions that are thread-safe
30212 The functions strspn() and strcspn() are thread safe.
30213
30214tempnam.3
30215 Michael Kerrisk
30216 Make warning not to use this function more prominent
30217
30218tmpnam.3
30219 Michael Kerrisk
30220 Recommend use mkstemp(3) or tmpfile(3) instead
30221
30222locale.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
30252feature_test_macros.7
c7c46d4f
MK
30253 Michael Kerrisk
30254 _BSD_SOURCE and _SVID_SOURCE are deprecated in glibc 2.20
5229d5de
MK
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
c7c46d4f 30271 _XOPEN_SOURCE may implicitly define _POSIX_SOURCE and _POSIX_C_SOURCE
5229d5de
MK
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
a0b7a15e
MK
30281
30282
30283==================== Changes in man-pages-3.63 ====================
30284
30285Released: 2014-03-18, Munich
30286
30287
30288Contributors
30289------------
30290
30291The following people contributed patches/fixes or (noted in brackets
30292in the changelog below) reports, notes, and ideas that have been
30293incorporated in changes in this release:
30294
30295Carlos O'Donell <carlos@redhat.com>
30296Christoph Hellwig <hch@infradead.org>
30297Corrado Zoccolo <czoccolo@gmail.com>
30298Gregory P. Smith <gps@google.com>
30299Joseph S. Myers <joseph@codesourcery.com>
30300Michael Kerrisk <mtk.manpages@gmail.com>
30301Mike Frysinger <vapier@gentoo.org>
30302Peng Haitao <penght@cn.fujitsu.com>
30303Phillip Susi <psusi@ubuntu.com>
30304Robert P. J. Day <rpjday@crashcourse.ca>
30305Stefan Puiu <stefan.puiu@gmail.com>
30306Zhu Yanhai <zhu.yanhai@gmail.com>
30307
30308Apologies if I missed anyone!
30309
30310
30311New and rewritten pages
30312-----------------------
30313
30314duplocale.3
30315 Michael Kerrisk
30316 New page documenting duplocale(3)
30317
30318newlocale.3
30319 Michael Kerrisk [Mike Frysinger]
30320 New page documenting newlocale(3) and freelocale(3)
30321
30322towlower.3
30323 Michael Kerrisk
30324 Largely rewrite description of towlower() to be simpler and clearer
30325
30326towupper.3
30327 Michael Kerrisk
30328 Largely rewrite description of towupper() to be simpler and clearer
30329
30330uselocale.3
30331 Michael Kerrisk
30332 New page documenting uselocale(3)
30333
30334
30335Newly documented interfaces in existing pages
30336---------------------------------------------
30337
30338open.2
30339 Michael Kerrisk
30340 Document O_DSYNC and rewrite discussion of O_SYNC
30341
30342isalpha.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
30365strerror.3
30366 Michael Kerrisk
30367 Document strerror_l()
30368
30369toupper.3
30370 Michael Kerrisk
30371 Document toupper_l() and tolower_l()
30372
30373towlower.3
30374 Michael Kerrisk
30375 Document towlower_l()
30376
30377towupper.3
30378 Michael Kerrisk
30379 Document towupper_l()
30380
30381proc.5
30382 Michael Kerrisk
30383 Document /proc/sys/kernel/random/uuid
30384
30385locale.7
30386 Michael Kerrisk
30387 Document LC_ADDRESS
a0b7a15e 30388 Document LC_IDENTIFICATION
a0b7a15e 30389 Document LC_MEASUREMENT
a0b7a15e 30390 Document LC_NAME
a0b7a15e 30391 Document LC_PAPER
a0b7a15e
MK
30392 Document LC_TELEPHONE
30393
30394
30395New and changed links
30396---------------------
30397
30398freelocale.3
30399 Michael Kerrisk
30400 New link to new newlocale.3 page
30401
30402isalnum_l.3
30403isascii_l.3
30404isblank_l.3
30405iscntrl_l.3
30406isdigit_l.3
30407isgraph_l.3
30408islower_l.3
30409isprint_l.3
30410ispunct_l.3
30411isspace_l.3
30412isupper_l.3
30413isxdigit_l.3
30414 Michael Kerrisk
30415 New links to isalpha.3
30416
30417tolower_l.3
30418toupper_l.3
30419 Michael Kerrisk
30420 New links to toupper.3
30421
30422towlower_l.3
30423 Michael Kerrisk
30424 New link to towlower.3
30425
30426towupper_l.3
30427 Michael Kerrisk
30428 New link to towupper.3
30429
30430
30431Global changes
30432--------------
30433
30434Various pages
30435 Michael Kerrisk
30436 Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase"
30437
30438
30439Changes to individual pages
30440---------------------------
30441
30442mount.2
30443 Michael Kerrisk
30444 SEE ALSO: add blkid(1)
30445
30446msgop.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
30454open.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
30467readahead.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
30475stat.2
30476 Michael Kerrisk
30477 SEE ALSO: add ls(1) and stat(1)
30478
30479fts.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
30487mbrtowc.3
30488mbsnrtowcs.3
30489mbsrtowcs.3
30490mbtowc.3
30491 Michael Kerrisk
30492 Add entries in SEE ALSO
30493 Mainly inspired by the POSIX pages.
30494
30495mbsinit.3
30496 Michael Kerrisk
30497 SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3)
30498
30499mbsrtowcs.3
30500wcsrtombs.3
30501 Michael Kerrisk
30502 SEE ALSO: add mbsinit(3)
30503
30504mbstowcs.3
30505 Michael Kerrisk [Stefan Puiu]
30506 Add example program
30507 And add some SEE ALSO entries
30508
30509memcmp.3
30510 Peng Haitao
30511 ATTRIBUTES: Note function that is thread-safe
30512 The function memcmp() is thread safe.
30513
30514memcpy.3
30515 Peng Haitao
30516 ATTRIBUTES: Note function that is thread-safe
30517 The function memcpy() is thread safe.
30518
30519memfrob.3
30520 Peng Haitao
30521 ATTRIBUTES: Note function that is thread-safe
30522 The function memfrob() is thread safe.
30523
30524memmem.3
30525 Peng Haitao
30526 ATTRIBUTES: Note function that is thread-safe
30527 The function memmem() is thread safe.
30528
30529memmove.3
30530 Peng Haitao
30531 ATTRIBUTES: Note function that is thread-safe
30532 The function memmove() is thread safe.
30533
30534mempcpy.3
30535 Peng Haitao
30536 ATTRIBUTES: Note functions that are thread-safe
30537 The functions mempcpy() and wmempcpy() are thread safe.
30538
30539memset.3
30540 Peng Haitao
30541 ATTRIBUTES: Note function that is thread-safe
30542 The function memset() is thread safe.
30543
30544strerror.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
30550toupper.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
30557wcrtomb.3
30558wcsnrtombs.3
30559wcsrtombs.3
30560wcstombs.3
30561wctomb.3
30562 Michael Kerrisk
30563 SEE ALSO: add various entries
30564 Mainly inspired by POSIX
30565
30566core.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
30573locale.5
30574 Michael Kerrisk
30575 SEE ALSO: add newlocale(3) + duplocale(3)
30576
30577feature_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
90ee4a71 30582 the discussion of C95 under the _ISOC99_SOURCE subhead.
a0b7a15e
MK
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
30591locale.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
30603man-pages.7
30604 Michael Kerrisk
30605 Add preferred term "superblock"
30606 Michael Kerrisk
30607 Add preferred terms "uppercase" and "lowercase"
30608
d0d5dfd3
MK
30609
30610
30611==================== Changes in man-pages-3.64 ====================
30612
30613Released: 2014-04-06, Munich
30614
30615
30616Contributors
30617------------
30618
30619The following people contributed patches/fixes or (noted in brackets
30620in the changelog below) reports, notes, and ideas that have been
30621incorporated in changes in this release:
30622
30623Abhay Sachan <sachan.abhay@gmail.com>
30624Alexey Samsonov <samsonov@google.com>
30625Andrey Vagin <avagin@openvz.org>
30626Aneesh Kumar K.V <aneesh.kumar@linux.vnet.ibm.com>
30627Christoph Hellwig <hch@infradead.org>
30628David Prévot <taffit@debian.org>
30629Eric Dumazet <edumazet@google.com>
30630Eric W. Biederman <ebiederm@xmission.com>
30631Jan Kara <jack@suse.cz>
30632Kir Kolyshkin <kir@openvz.org>
30633Michael Kerrisk <mtk.manpages@gmail.com>
30634Mike Frysinger <vapier@gentoo.org>
30635NeilBrown <neilb@suse.de>
30636Peng Haitao <penght@cn.fujitsu.com>
30637Peter Hurley <peter@hurleysoftware.com>
30638Petr Gajdos <pgajdos@suse.cz>
30639Robert P. J. Day <rpjday@crashcourse.ca>
30640Vince Weaver <vincent.weaver@maine.edu>
30641Yuri Kozlov <yuray@komyakino.ru>
30642
30643Apologies if I missed anyone!
30644
30645
30646New and rewritten pages
30647-----------------------
30648
30649open_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
30654inotify.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
30695Newly documented interfaces in existing pages
30696---------------------------------------------
30697
30698perf_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
30704feature_test_macros.7
30705 Michael Kerrisk
30706 Document _LARGEFILE_SOURCE
30707
aae0d23f
MK
30708tcp.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
d0d5dfd3
MK
30713
30714New and changed links
30715---------------------
30716
30717name_to_handle_at.2
30718 Michael Kerrisk
5ecd875e 30719 New link to new open_by_handle_at(2) page
d0d5dfd3
MK
30720
30721
30722Global changes
30723--------------
30724
30725fmemopen.3
30726getaddrinfo.3
30727mq_notify.3
30728offsetof.3
30729aio.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
30737Changes to individual pages
30738---------------------------
30739
30740bdflush.2
30741fsync.2
30742sync.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
30748chown.2
30749 Michael Kerrisk
30750 Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30751
30752getxattr.2
30753 Abhay Sachan
7d0370e4 30754 Fix RETURN VALUE description
d0d5dfd3
MK
30755 A EA can have length zero.
30756
30757inotify_add_watch.2
30758 Michael Kerrisk
30759 ERRORS: add ENAMETOOLONG
30760
30761inotify_init.2
30762 Michael Kerrisk
30763 Add pointer to inotify(7)
30764
30765link.2
30766 Michael Kerrisk
30767 When AT_EMPTY_PATH is specified, 'olddirfd' must not refer to a
30768 directory
30769
30770mmap.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
30775open.2
30776 Michael Kerrisk
30777 SEE ALSO: add open_by_name_at(2)
30778
d0d5dfd3
MK
30779perf_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
30787stat.2
30788 Michael Kerrisk
30789 Note that 'dirfd' can be AT_FDCWD when AT_EMPTY_PATH is used
30790
30791syscalls.2
30792 Michael Kerrisk
30793 Add sched_getattr() and sched_setattr()
30794 And update kernel version to 3.14
30795
30796abort.3
30797 Peng Haitao
30798 ATTRIBUTES: Note function that is thread-safe
30799 The function abort() is thread safe.
30800
30801confstr.3
30802 Michael Kerrisk
30803 SEE ALSO: add getconf(1), fpathconf(3), sysconf(3), pathconf(3)
30804
30805exit.3
30806 Peng Haitao
30807 ATTRIBUTES: Note function that is not thread-safe
30808 The function exit() is not thread safe.
30809
30810fenv.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
30819fpathconf.3
30820 Michael Kerrisk
30821 SEE ALSO: add confstr(3)
30822
30823fseek.3
30824 Michael Kerrisk [Petr Gajdos]
30825 Document EINVAL error for negative file offset
30826
30827fseeko.3
30828 Michael Kerrisk
30829 Add feature test macro requirements
30830
30831fts.3
30832 Michael Kerrisk [Mike Frysinger]
30833 Remove mention of "32-bit systems" in BUGS
30834
30835fwide.3
30836wprintf.3
30837 Michael Kerrisk [Robert P. J. Day]
30838 Remove mention of bogus _ISOC95_SOURCE feature test macro
30839
30840getline.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
30846getloadavg.3
30847 Peng Haitao
30848 ATTRIBUTES: Note function that is thread-safe
30849 The function getloadavg() is thread safe.
30850
30851getpt.3
30852 Peng Haitao
30853 ATTRIBUTES: Note function that is thread-safe
30854 The function getpt() is thread safe.
30855
30856if_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
30861index.3
30862 Peng Haitao
30863 ATTRIBUTES: Note functions that are thread-safe
30864 The functions index() and rindex() are thread safe.
30865
30866mkfifo.3
30867 Peng Haitao
30868 ATTRIBUTES: Note functions that are thread-safe
30869 The functions mkfifo() and mkfifoat() are thread safe.
30870
30871netlink.3
30872 Michael Kerrisk
30873 SEE ALSO: make the reference for libnetlink the libnetlink(3) man page
30874
30875random.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
30881random_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
30887sigvec.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
30895sysconf.3
30896 Michael Kerrisk
30897 SEE ALSO: add confstr(3)
30898
30899termios.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
30920symlink.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
645de70f
MK
30927
30928
30929==================== Changes in man-pages-3.65 ====================
30930
30931Released: 2014-04-20, Munich
30932
30933
30934Contributors
30935------------
30936
30937The following people contributed patches/fixes or (noted in brackets
30938in the changelog below) reports, notes, and ideas that have been
30939incorporated in changes in this release:
30940
30941Alex Thorlton <athorlton@sgi.com>
30942Ashish Sangwan <a.sangwan@samsung.com>
30943Christopher Covington <cov@codeaurora.org>
30944Christoph Hellwig <hch@infradead.org>
30945Craig McQueen <craig.mcqueen@beamcommunications.com>
30946Dave Chinner <david@fromorbit.com>
30947David Prévot <taffit@debian.org>
30948Greg Troxel <gdt@ir.bbn.com>
30949Matthew Dempsky <mdempsky@chromium.org>
30950Michael Kerrisk <mtk.manpages@gmail.com>
30951Mike Frysinger <vapier@gentoo.org>
30952Namjae Jeon <namjae.jeon@samsung.com>
30953Peng Haitao <penght@cn.fujitsu.com>
30954Petr Gajdos <pgajdos@suse.cz>
30955Richard Hansen <rhansen@bbn.com>
30956Simon Paillard <spaillard@debian.org>
30957Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
30958Vince Weaver <vincent.weaver@maine.edu>
30959Yuri Kozlov <yuray@komyakino.ru>
30960
30961Apologies if I missed anyone!
30962
30963
30964New and rewritten pages
30965-----------------------
30966
30967inet_net_pton.3
30968 Michael Kerrisk
30969 New page describing inet_net_pton(3) and inet_net_ntop(3)
30970
30971
30972Newly documented interfaces in existing pages
30973---------------------------------------------
30974
30975fallocate.2
30976 Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
30977 Document FALLOC_FL_COLLAPSE_RANGE
30978
30979prctl.2
30980 Michael Kerrisk [Alex Thorlton]
30981 Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
30982
30983proc.5
30984 Michael Kerrisk
30985 Document /proc/[pid]/stack
30986 Michael Kerrisk
30987 Document /proc/[pid]/clear_refs
30988
30989
30990New and changed links
30991---------------------
30992
30993inet_net_ntop.3
30994 Michael Kerrisk
30995 New link to new inet_net_pton.3
30996
30997
30998Changes to individual pages
30999---------------------------
31000
31001fcntl.2
31002 Michael Kerrisk
31003 Note the race when O_CLOEXEC is used at same time as fork()+execve()
31004
31005madvise.2
31006 Michael Kerrisk
31007 SEE ALSO: see prctl(2)
31008 Because of PR_SET_THP_DISABLE.
31009
31010mlock.2
31011 Michael Kerrisk
31012 Describe treatment of MCL_FUTURE during fork(2) and execve(2)
31013
31014msync.2
31015 Michael Kerrisk [Richard Hansen, Greg Troxel]
31016 Warn that one of MS_SYNC or MS_ASYNC is required
31017
31018open.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
31026perf_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
31035personality.2
31036 Michael Kerrisk
31037 Available execution domains are listed in <sys/personality.h>
31038 Michael Kerrisk
31039 Fix discussion of return value
31040
31041prctl.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
31049shmget.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
31056byteorder.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
31062fexecve.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
31067ffs.3
31068 Peng Haitao
31069 ATTRIBUTES: Note functions that are thread-safe
31070 The functions ffs(), ffsl() and ffsll() are thread safe.
31071
31072getauxval.3
31073 Peng Haitao
31074 ATTRIBUTES: Note function that is thread-safe
31075 The function getauxval() is thread safe.
31076
31077getcontext.3
31078 Peng Haitao
31079 ATTRIBUTES: Note functions that are thread-safe
31080 The functions getcontext() and setcontext() are thread safe.
31081
31082getsubopt.3
31083 Peng Haitao
31084 ATTRIBUTES: Note function that is thread-safe
31085 The function getsubopt() is thread safe.
31086
31087getutmp.3
31088 Peng Haitao
31089 ATTRIBUTES: Note functions that are thread-safe
31090 The functions getutmp() and getutmpx() are thread safe.
31091
31092inet.3
31093 Michael Kerrisk
31094 Note success and error return for inet_aton()
31095
31096inet.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
31102makecontext.3
31103 Peng Haitao
31104 ATTRIBUTES: Note functions that are thread-safe
31105 The functions makecontext() and swapcontext() are thread safe.
31106
31107pthread_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
31113pthread_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
31119sigsetops.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
31126proc.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
31136capabilities.7
31137 Michael Kerrisk
31138 SEE ALSO: add capsh(1)
31139
31140libc.7
31141 Michael Kerrisk
31142 Add musl libc
9c174095
MK
31143
31144
31145==================== Changes in man-pages-3.66 ====================
31146
31147Released: 2014-05-08, Munich
31148
31149
31150Contributors
31151------------
31152
31153The following people contributed patches/fixes or (noted in brackets
31154in the changelog below) reports, notes, and ideas that have been
31155incorporated in changes in this release:
31156
31157Alan Curry <rlwinm@sdf.org>
31158Carsten Andrich <carsten.andrich@tu-ilmenau.de>
31159Daniel Borkmann <dborkman@redhat.com>
31160David Prévot <taffit@debian.org>
31161Eric Siegerman <pub08-knl@davor.org>
31162Heinrich Schuchardt <xypron.glpk@gmx.de>
31163Jan Kara <jack@suse.cz>
31164Jan Moskyto Matejka <mq@suse.cz>
31165John Marshall <jm18@sanger.ac.uk>
31166Lukáš Czerner <lczerner@redhat.com>
31167Manfred Spraul <manfred@colorfullife.com>
31168Michael Kerrisk <mtk.manpages@gmail.com>
31169Miklos Szeredi <miklos@szeredi.hu>
31170Neil Horman <nhorman@tuxdriver.com>
31171Peng Haitao <penght@cn.fujitsu.com>
31172Peter Schiffer <pschiffe@redhat.com>
31173Randy Dunlap <rdunlap@infradead.org>
31174Silvan Jegen <s.jegen@gmail.com>
31175Simon Paillard <spaillard@debian.org>
31176Stefan Puiu <stefan.puiu@gmail.com>
31177Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31178Stijn Hinterding <contact@stijnhinterding.nl>
31179Willem de Bruijn <willemb@google.com>
31180Yuri Kozlov <yuray@komyakino.ru>
31181
31182Apologies if I missed anyone!
31183
31184
31185New and rewritten pages
31186-----------------------
31187
31188fanotify_init.2
31189 Heinrich Schuchardt, Michael Kerrisk
31190 New page documenting fanotify_init(2)
31191
31192fanotify_mark.2
31193 Heinrich Schuchardt, Michael Kerrisk
31194 New page documenting fanotify_mark(2)
31195
31196sched_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
31204fanotify.7
31205 Heinrich Schuchardt, Michael Kerrisk
31206 New page providing overview of the fanotify API
31207
31208sched.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
185de25e 31216
9c174095
MK
31217Newly documented interfaces in existing pages
31218---------------------------------------------
31219
31220fallocate.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
31226rename.2
31227 Miklos Szeredi [Michael Kerrisk]
185de25e 31228 Document renameat2() system call added in Linux 3.15
9c174095
MK
31229
31230shmop.2
31231 Michael Kerrisk
31232 Document SHM_EXEC
31233
31234
31235Changes to individual pages
31236---------------------------
31237
7670a1ec 31238flock.2
9c174095
MK
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
31243getpriority.2
31244 Michael Kerrisk
31245 SEE ALSO: add sched(7)
31246
31247getsockopt.2
31248 Carsten Andrich
31249 SEE ALSO: add packet(7)
31250
31251link.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
31256msgget.2
31257 Michael Kerrisk
31258 Reword EEXIST error
31259
31260msgop.2
31261 Michael Kerrisk
31262 Note capability required to raise MQ size beyond MSGMNB
31263
31264msync.2
31265 Michael Kerrisk [Heinrich Schuchardt]
31266 s/flushes... back to disk/flushes... back to filesystem/
31267
31268nice.2
31269 Michael Kerrisk
31270 SEE ALSO: add sched(7)
31271
31272open.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
31287open_by_handle_at.2
31288 Michael Kerrisk
31289 Mention FreeBSD analogs
31290
31291posix_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
31296process_vm_readv.2
31297 Michael Kerrisk [Stijn Hinterding]
31298 Add feature test macro requirements
31299 The _GNU_SOURCE FTM must be defined.
31300
31301read.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
31308sched_get_priority_max.2
31309 Michael Kerrisk
31310 Small changes consistent with migration of content to sched(7)
31311
31312sched_rr_get_interval.2
31313 Michael Kerrisk
31314 Small changes consistent with migration of content to sched(7)
31315
31316sched_setaffinity.2
31317 Michael Kerrisk
31318 Small changes consistent with migration of content to sched(7)
31319
31320sched_setparam.2
31321 Michael Kerrisk
31322 Small changes consistent with migration of content to sched(7)
31323
31324sched_yield.2
31325 Michael Kerrisk
31326 Small changes consistent with migration of content to sched(7)
31327
31328semget.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
31344shmget.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
31368shmop.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
31378sigaction.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
31384symlink.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
31389syscalls.2
31390 Michael Kerrisk
31391 Add renameat2()
31392 And bump kernel version.
31393
31394write.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
31401pthread_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
31407pthread_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
31413pthread_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
31419pthread_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
31425pthread_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
31431sched_getcpu.3
31432 Michael Kerrisk
31433 SEE ALSO: add sched(7)
31434
31435termios.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
31441proc.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
31447packet.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
c7b2680c
MK
31456
31457
31458==================== Changes in man-pages-3.67 ====================
31459
31460Released: 2014-05-21, Munich
31461
31462
31463Contributors
31464------------
31465
31466The following people contributed patches/fixes or (noted in brackets
31467in the changelog below) reports, notes, and ideas that have been
31468incorporated in changes in this release:
31469
bca47952
MK
31470Andy Lutomirski <luto@amacapital.net>
31471Aurelien Jarno <aurelien@aurel32.net>
31472Bill Allombert <ballombe@debian.org>
31473Christoph Hellwig <hch@infradead.org>
31474Davidlohr Bueso <davidlohr@hp.com>
31475Heinrich Schuchardt <xypron.glpk@gmx.de>
31476Ingo Schwarze <schwarze@usta.de>
31477Jan Kara <jack@suse.cz>
31478Jon Grant <jg@jguk.org>
31479Juri Lelli <juri.lelli@gmail.com>
31480Lucas De Marchi <lucas.demarchi@profusion.mobi>
31481Michael Kerrisk <mtk.manpages@gmail.com>
31482Peng Haitao <penght@cn.fujitsu.com>
31483Peter Zijlstra <peterz@infradead.org>
31484Rasmus Villemoes <rv@rasmusvillemoes.dk>
31485Sam Varshavchik <mrsam@courier-mta.com>
31486Simon Paillard <spaillard@debian.org>
31487Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
31488Török Edwin <edwin@etorok.net>
31489William Morriss <wjmelements@gmail.com>
31490Yuri Kozlov <yuray@komyakino.ru>
c7b2680c
MK
31491
31492Apologies if I missed anyone!
31493
31494
31495New and rewritten pages
31496-----------------------
31497
31498sched_setattr.2
31499 Michael Kerrisk, Peter Zijlstra [Juri Lelli]
31500 New page describing sched_setattr(2) and sched_getattr(2)
31501
31502system.3
31503 Michael Kerrisk
31504 Rewrote large parts of the page and added a number of details
31505
31506
31507Newly documented interfaces in existing pages
31508---------------------------------------------
31509
31510sched.7
31511 Peter Zijlstra, Michael Kerrisk [Juri Lelli]
31512 Document SCHED_DEADLINE
c7b2680c
MK
31513
31514New and changed links
31515---------------------
31516
31517renameat2.2
31518 Michael Kerrisk
31519 New link to rename.2
31520
31521sched_getattr.2
31522 Michael Kerrisk
613a1fb7 31523 New link to new sched_setattr
c7b2680c
MK
31524
31525
31526Changes to individual pages
31527---------------------------
31528
31529bind.2
31530 Michael Kerrisk
31531 ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31532
31533chown.2
31534 Michael Kerrisk
31535 NOTES: Add some subheadings
31536
31537connect.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
c7b2680c
MK
31544
31545create_module.2
31546delete_module.2
31547init_module.2
31548query_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
31557execve.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
31563fanotify_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
31569fcntl.2
31570 Michael Kerrisk
31571 Add "file locking" subheading under NOTES
31572
31573fork.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
31579futex.2
31580 Michael Kerrisk
31581 Note that there is no glibc wrapper
31582
31583getpriority.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
31588get_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
31595getrusage.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
31600link.2
31601open.2
31602 Andy Lutomirski [Michael Kerrisk]
31603 Update AT_EMPTY_PATH and O_PATH documentation
31604
31605listen.2
31606 Michael Kerrisk
31607 ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
31608
31609mbind.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
31617msgop.2
31618 Davidlohr Bueso [Michael Kerrisk]
31619 Enhance description of "full queue" criteria
31620
31621poll.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
31627readlink.2
31628 Rasmus Villemoes
31629 Fix return type of readlinkat()
31630
31631recv.2
31632 Michael Kerrisk
31633 Clarify details of msg_name and msg_namelen fields
31634
31635recvmmsg.2
31636 Michael Kerrisk
31637 Describe timeout bug
f4c61073 31638 See https://bugzilla.kernel.org/show_bug.cgi?id=75371
c7b2680c
MK
31639 and http://thread.gmane.org/gmane.linux.man/5677
31640
31641remap_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
31647sched_get_priority_max.2
31648 Michael Kerrisk
31649 'policy' can also be SCHED_DEADLINE
31650
31651sched_setaffinity.2
31652 Rasmus Villemoes
31653 Fix prototype for sched_setaffinity()
31654 The mask argument is const.
31655
31656sched_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
31664sched_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
31672semget.2
31673 Michael Kerrisk
31674 NOTES: Add subheadings and reorder paragraphs
31675
31676semop.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
31684send.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
31692shmget.2
31693 Michael Kerrisk
31694 NOTES: Add a subheading
31695
31696stat.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
31708stime.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
31714syscall.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
31720getopt.3
31721 Michael Kerrisk
31722 EXAMPLE: Add subheadings to distinguish the two example programs
31723
31724malloc.3
31725 Michael Kerrisk
31726 Reword text referring to mallopt(3)
31727 Linux libc is no longer "recent"; drop mention of it.
31728
31729pthread_attr_setinheritsched.3
31730pthread_attr_setschedparam.3
31731pthread_attr_setschedpolicy.3
31732pthread_setaffinity_np.3
31733pthread_setschedparam.3
31734pthread_setschedprio.3
31735pthread_yield.3
31736pthreads.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
31742pthread_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
31748pthread_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
31754pthread_kill.3
31755 Peng Haitao
31756 ATTRIBUTES: Note function that is thread-safe
31757 The function pthread_kill() is thread safe.
31758
31759pthread_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
31764pthread_self.3
31765 Peng Haitao
31766 ATTRIBUTES: Note function that is thread-safe
31767 The function pthread_self() is thread safe.
31768
31769pthread_setcancelstate.3
31770 Michael Kerrisk
31771 Add paragraph breaks to "Asynchronous cancelability" subsection
31772
31773pthread_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
31781pthread_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
31787pthread_setschedprio.3
31788 Peng Haitao
31789 ATTRIBUTES: Note function that is thread-safe
31790 The function pthread_setschedprio() is thread safe.
31791
31792pthread_sigmask.3
31793 Peng Haitao
31794 ATTRIBUTES: Note function that is thread-safe
31795 The function pthread_sigmask() is thread safe.
31796
31797pthread_sigqueue.3
31798 Peng Haitao
31799 ATTRIBUTES: Note function that is thread-safe
31800 The function pthread_sigqueue() is thread safe.
31801
31802pthread_testcancel.3
31803 Peng Haitao
31804 ATTRIBUTES: Note function that is thread-safe
31805 The function pthread_testcancel() is thread safe.
31806
31807pthread_yield.3
31808 Peng Haitao
31809 ATTRIBUTES: Note function that is thread-safe
31810 The function pthread_yield() is thread safe.
31811
31812remquo.3
31813 Peng Haitao
31814 ATTRIBUTES: Note functions that are thread-safe
31815 The functions remquo(), remquof() and remquol() are thread safe.
31816
31817rtime.3
31818 Peng Haitao
31819 ATTRIBUTES: Note function that is thread-safe
31820 The function rtime() is thread safe.
31821
31822sched_getcpu.3
31823 Peng Haitao
31824 ATTRIBUTES: Note function that is thread-safe
31825 The function sched_getcpu() is thread safe.
31826
31827stpcpy.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
31843strcasecmp.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
31848strcpy.3
31849 Michael Kerrisk
31850 NOTES: Add a subheading
31851
31852fd.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
31861proc.5
31862 Michael Kerrisk
31863 Document /proc/timer_stats
31864 Michael Kerrisk
31865 (Briefly) document /proc/timer_list
c7b2680c
MK
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
31870capabilities.7
31871 Michael Kerrisk
31872 Mention sched_setattr(2) under CAP_SYS_NICE
31873
31874cpuset.7
31875 Michael Kerrisk
31876 SEE ALSO: add sched(7)
31877
31878credentials.7
31879 Michael Kerrisk
31880 Mention sched_getattr() as a place where credentials are checked
31881
31882fanotify.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
31893ip.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
31907sched.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
12e73609
MK
31937
31938
31939==================== Changes in man-pages-3.68 ====================
31940
31941Released: 2014-05-28, Munich
31942
40e47508
MK
31943
31944Contributors
31945------------
31946
31947The following people contributed patches/fixes or (noted in brackets
31948in the changelog below) reports, notes, and ideas that have been
31949incorporated in changes in this release:
31950
12e73609
MK
31951Alastair McKinstry <mckinstry@computer.org>
31952Carsten Grohmann <carstengrohmann@gmx.de>
31953Colin Williams <colinwilliams1968@gmail.com>
31954Heinrich Schuchardt <xypron.glpk@gmx.de>
31955Lars Wirzenius <liw@iki.fi>
31956Marko Myllynen <myllynen@redhat.com>
31957Michael Kerrisk <mtk.manpages@gmail.com>
31958Peng Haitao <penght@cn.fujitsu.com>
31959Rasmus Villemoes <rv@rasmusvillemoes.dk>
31960Richard Braakman <richard.braakman@jollamobile.com>
31961Simon Paillard <spaillard@debian.org>
31962
12e73609
MK
31963Apologies if I missed anyone!
31964
31965
31966New and rewritten pages
31967-----------------------
31968
31969localedef.1
fcea126c 31970 Marko Myllynen, Richard Braakman, Alastair McKinstry, Lars Wirzenius
12e73609
MK
31971 New page for localedef(1)
31972 Add new page based on Debian localedef(1) page.
31973
31974
31975New and changed links
31976---------------------
31977
31978procfs.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
31984Changes to individual pages
31985---------------------------
31986
31987locale.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
31998adjtimex.2
31999 Michael Kerrisk
fcea126c 32000 Add feature test macro requirements
12e73609
MK
32001
32002clone.2
32003 Michael Kerrisk
32004 ERRORS: add cross-reference to fork(2) for explanation of EAGAIN
32005
32006fork.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
32011getrlimit.2
32012 Michael Kerrisk
32013 RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE
32014
32015remap_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
32021set_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
32026swapon.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
32034a64l.3
32035 Rasmus Villemoes
32036 Fix prototype for a64l()
32037 The argument is const, both according to POSIX and the
32038 glibc headers.
32039
32040adjtime.3
32041 Rasmus Villemoes
32042 Add required header
32043 The prototype for adjtime(3) is declared in <sys/time.h>.
32044
32045argz_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
32051bstring.3
32052 Rasmus Villemoes
32053 Fix prototypes
32054 The length parameter n has type size_t in bcmp(), bcopy() and
32055 bzero().
32056
32057envz_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
32063fpathconf.3
32064 Rasmus Villemoes
32065 Fix prototype
32066 The path argument to pathconf() is const.
32067
32068fseek.3
32069 Rasmus Villemoes
32070 Fix prototype
32071 The pos argument to fsetpos() is const.
32072
32073gcvt.3
32074 Rasmus Villemoes
32075 Fix prototype
fcea126c 32076 The ndigit parameter to gcvt() has type int.
12e73609
MK
32077
32078getaddrinfo_a.3
32079 Rasmus Villemoes
32080 Fix prototype
32081 The pointer arguments to gai_suspend() are const.
32082
32083getauxval.3
32084 Rasmus Villemoes
32085 Fix permissions
32086 There doesn't seem to be any reason for getauxval.3 to be
32087 executable...
32088
32089getnameinfo.3
32090 Rasmus Villemoes
32091 Fix prototype
bf1debcc 32092 The hostlen and servlen parameters have type socklen_t.
12e73609
MK
32093 (The types changed in glibc 2.2)
32094 Michael Kerrisk
32095 Note types of 'hostlen'; and 'servlen' in glibc < 2.2
32096
32097getrpcent.3
32098 Rasmus Villemoes
32099 Fix prototype
32100 The argument to getrpcbyname() is const.
32101
32102getrpcport.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
32108getspnam.3
32109 Rasmus Villemoes
32110 Fix prototype
32111 The struct spwd argument to putspent() is const.
32112
32113getutent.3
32114 Rasmus Villemoes
32115 Fix prototypes
32116 The arguments to getutid(), getutline(), and pututline()
32117 are const.
32118
32119inet.3
32120 Rasmus Villemoes
32121 Fix prototype
32122 The parameters to inet_makeaddr have type in_addr_t.
32123
32124inet_net_pton.3
32125 Rasmus Villemoes
32126 srcfix, cfix
32127 Use a consistent style throughout the man-pages.
32128
32129key_setsecret.3
32130 Rasmus Villemoes
32131 Fix prototypes
32132 Remove const qualifiers from arguments to key_decryptsession,
32133 key_encryptsession, and key_setsecret.
32134
32135makecontext.3
32136 Rasmus Villemoes
32137 Fix prototype
32138 The second argument to swapcontext() is const.
32139
32140makedev.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
32147malloc_trim.3
32148 Rasmus Villemoes
32149 Fix prototype
32150 As mentioned further down, malloc_trim returns an integer.
32151
32152mq_getattr.3
32153 Rasmus Villemoes
32154 Fix prototype
32155 The newattr parameter to mq_setattr is const.
32156
32157newlocale.3
32158 Marko Myllynen
32159 List all available category masks
32160 Michael Kerrisk
32161 Add LC_ALL_MASK description
32162
32163nl_langinfo.3
32164 Marko Myllynen
32165 Expand the example code a bit
32166 Better illustrate querying elements from different categories.
32167
32168perror.3
32169 Rasmus Villemoes
32170 Fix declaration
32171 The elements of the array sys_errlist are also const.
32172
32173pthread_attr_setaffinity_np.3
32174pthread_attr_setdetachstate.3
32175pthread_attr_setguardsize.3
32176pthread_attr_setinheritsched.3
32177pthread_attr_setschedparam.3
32178pthread_attr_setschedpolicy.3
32179pthread_attr_setscope.3
32180pthread_attr_setstack.3
32181pthread_attr_setstackaddr.3
32182pthread_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
32190pthread_cleanup_push_defer_np.3
32191 Michael Kerrisk [Rasmus Villemoes]
32192 Add feature test macro requirements
32193
32194pthread_create.3
32195 Michael Kerrisk [Carsten Grohmann]
32196 Add pid_max limit to EAGAIN error cases
32197
32198pthread_equal.3
32199 Peng Haitao
32200 ATTRIBUTES: Note function that is thread-safe
32201 The function pthread_equal() is thread safe.
32202
32203pthread_exit.3
32204 Peng Haitao
32205 ATTRIBUTES: Note function that is thread-safe
32206 The function pthread_exit() is thread safe.
32207
32208pthread_getcpuclockid.3
32209 Peng Haitao
32210 ATTRIBUTES: Note function that is thread-safe
32211 The function pthread_getcpuclockid() is thread safe.
32212
32213pthread_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
32219pthread_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
32225pthread_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
32231pthread_setschedparam.3
32232 Rasmus Villemoes
32233 Fix prototypes
32234 Add return type for pthread_{s,g}etschedparam.
32235
32236pthread_setschedprio.3
32237 Rasmus Villemoes
32238 Fix prototype
32239 Add return type for pthread_setschedprio.
32240
32241pthread_sigqueue.3
32242 Rasmus Villemoes
32243 Add missing #include <signal.h>
32244
32245rcmd.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
32252re_comp.3
32253 Rasmus Villemoes
32254 Fix prototypes
32255 re_comp and re_exec take const char* arguments.
32256
32257resolver.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
32266rexec.3
32267 Rasmus Villemoes
32268 Fix prototypes
32269 The user, passwd and cmd arguments to rexec and rexec_af are all
32270 const.
32271
32272rtime.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
32279scandir.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
32285setlocale.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
32292setnetgrent.3
32293 Rasmus Villemoes
32294 Fix prototype
32295 The buflen argument to getnetgrent_r has type size_t.
32296
32297sigvec.3
32298 Rasmus Villemoes
32299 Fix prototype
32300 The vec argument to sigvec is const.
32301
32302tsearch.3
32303 Rasmus Villemoes
32304 Fix prototype
32305 The rootp argument to tfind is "void * const *",
32306 not "const void **".
32307
32308core.5
32309 Michael Kerrisk
32310 Core dump files are nowadays core.pid by default
32311
32312locale.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
32349proc.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
32356capabilities.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
32362charsets.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
32369fanotify.7
32370 Heinrich Schuchardt
fcea126c 32371 Fix to example program: fanotify read() should use aligned buffer
12e73609
MK
32372
32373inotify.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
32382locale.7
32383 Marko Myllynen [Michael Kerrisk]
32384 Document the LOCPATH environment variable
32385 Michael Kerrisk
32386 Add further details on various categories
32387
76b5648c
MK
32388
32389
32390==================== Changes in man-pages-3.69 ====================
32391
32392Released: 2014-06-14, Munich
32393
32394
32395Contributors
32396------------
32397
32398The following people contributed patches/fixes or (noted in brackets
32399in the changelog below) reports, notes, and ideas that have been
32400incorporated in changes in this release:
32401
32402Cyril Hrubis <chrubis@suse.cz>
32403Jan Chaloupka <jchaloup@redhat.com>
32404Jeff Layton <jlayton@poochiereds.net>
32405Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
32406KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
32407Marko Myllynen <myllynen@redhat.com>
32408Michael Kerrisk <mtk.manpages@gmail.com>
32409NeilBrown <neilb@suse.de>
32410Peng Haitao <penght@cn.fujitsu.com>
32411Petr Gajdos <pgajdos@suse.cz>
32412Qian Lei <qianl.fnst@cn.fujitsu.com>
32413Rasmus Villemoes <rv@rasmusvillemoes.dk>
32414Vasiliy Kulikov <segoon@openwall.com>
32415Walter Harms <wharms@bfs.de>
32416Yuri Kozlov <yuray@komyakino.ru>
32417
32418Apologies if I missed anyone!
32419
32420
32421New and rewritten pages
32422-----------------------
32423
32424iconv.1
32425 Marko Myllynen [Michael Kerrisk]
32426 New page for the iconv(1) command
32427
32428iconvconfig.8
32429 Marko Myllynen
32430 New page for iconvconfig(8)
32431
32432
32433Newly documented interfaces in existing pages
32434---------------------------------------------
32435
32436fcntl.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
32443Changes to individual pages
32444---------------------------
32445
32446locale.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
32452execve.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
32461fcntl.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
76b5648c
MK
32487 Michael Kerrisk [Jeff Layton]
32488 nfsv4leasetime controls the "contact lost" interval for NFSv4
76b5648c
MK
32489
32490flock.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
32501fork.2
32502 Michael Kerrisk
32503 Add notes on inheritance of flock() and OFD locks across fork()
32504
32505lseek.2
32506 Michael Kerrisk
32507 Add reference to open(2) for discussion of file descriptors and OFDs
32508
32509open.2
32510 Michael Kerrisk
32511 Rework and extend the discussion of open file descriptions
32512
32513open_by_handle_at.2
32514 Rasmus Villemoes
32515 Add reference to feature_test_macros(7)
32516
32517recvmmsg.2
32518 Rasmus Villemoes
32519 Add reference to feature_test_macros(7)
32520
32521remap_file_pages.2
32522 Michael Kerrisk [Kirill A. Shutemov]
32523 Note that remap_file_pages() is deprecated
32524
32525sendmmsg.2
32526 Rasmus Villemoes
32527 Add reference to feature_test_macros(7)
32528
32529seteuid.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
32535setresuid.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
32545setreuid.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
32555setuid.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
32565statfs.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
32573syscalls.2
32574 Michael Kerrisk
32575 Note that remap_file_pages() is deprecated
32576
32577basename.3
32578 Peng Haitao
32579 ATTRIBUTES: Note functions that are thread-safe
32580 The functions basename() and dirname() are thread safe.
32581
32582catgets.3
32583 Peng Haitao
32584 ATTRIBUTES: Note function that is thread-safe
32585 The function catgets() is thread safe.
32586
32587getdate.3
32588 Rasmus Villemoes
32589 Use blank definition of _GNU_SOURCE in example program
32590
32591getdirentries.3
32592 Peng Haitao
32593 ATTRIBUTES: Note function that is thread-safe
32594 The function getdirentries() is thread safe.
32595
32596getdtablesize.3
32597 Peng Haitao
32598 ATTRIBUTES: Note function that is thread-safe
32599 The function getdtablesize() is thread safe.
32600
32601iconv.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
32608lockf.3
32609 Qian Lei [Peng Haitao]
32610 ATTRIBUTES: Note function that is thread-safe
32611 The function lockf() is thread safe.
32612
32613malloc_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
32619malloc_usable_size.3
32620 Qian Lei
32621 ATTRIBUTES: Note function that is thread-safe
32622 The function malloc_usable_size() is thread safe.
32623
32624matherr.3
32625 Qian Lei [Peng Haitao]
32626 ATTRIBUTES: Note function that is thread-safe
32627 The function matherr() is thread safe.
32628
32629mkdtemp.3
32630 Peng Haitao
32631 ATTRIBUTES: Note function that is thread-safe
32632 The function mkdtemp() is thread safe.
32633
32634mkstemp.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
32640mq_close.3
32641 Qian Lei
32642 ATTRIBUTES: Note function that is thread-safe
32643 The function mq_close() is thread safe.
32644
32645mq_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
32650mq_open.3
32651 Peng Haitao
32652 ATTRIBUTES: Note function that is thread-safe
32653 The function mq_open() is thread safe.
32654
32655mq_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
32660mq_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
32665mq_unlink.3
32666 Qian Lei
32667 ATTRIBUTES: Note function that is thread-safe
32668 The function mq_unlink() is thread safe.
32669
32670posix_fallocate.3
32671 Peng Haitao
32672 ATTRIBUTES: Note function that is thread-safe
32673 The function posix_fallocate() is thread safe.
32674
32675posix_openpt.3
32676 Peng Haitao
32677 ATTRIBUTES: Note function that is thread-safe
32678 The function posix_openpt() is thread safe.
32679
32680siginterrupt.3
32681 Peng Haitao
32682 ATTRIBUTES: Note function that is not thread-safe
32683 The function siginterrupt() is not thread safe.
32684
32685system.3
32686 Peng Haitao
32687 ATTRIBUTES: Note function that is thread-safe
32688 The function system() is thread safe.
32689
32690charmap.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
32698locale.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
32708proc.5
32709 Michael Kerrisk [Jan Chaloupka, Walter Harms]
32710 Add a brief description of /proc/fs
32711
32712repertoiremap.5
32713 Marko Myllynen
32714 New page for repertoiremap(5)
32715 Rather obsolete feature but localedef(1) refers to repertoiremaps.
32716
32717bootparam.7
32718 Petr Gajdos
32719 Describe 'rootflags' and 'rootdelay' kernel parameters
32720 Patch based on text from Documentation/kernel-parameters.txt
32721
32722charsets.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
32731environ.7
32732 Michael Kerrisk
32733 SEE ALSO: add env(1), printenv(1), ld.so(8)
32734
32735locale.7
32736 Marko Myllynen
32737 Add some SEE ALSO references
32738
32739man-pages.7
32740 Michael Kerrisk
32741 Note that .TH 'date' field is nowadays automatically updated by scripts
32742
32743signal.7
32744 Michael Kerrisk
32745 Describe EINTR semantics for recvmmsg(2)
32746 Michael Kerrisk
32747 Clarify text describing EINTR semantics for socket interfaces
32748
32749unicode.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
32762utf-8.7
32763 Marko Myllynen
32764 Drop an old comment about UTF-8 replacing ISO 8859
32765 And add locale(1) under SEE ALSO.
19b7ee90
MK
32766
32767
32768==================== Changes in man-pages-3.70 ====================
32769
32770Released: 2014-07-08, Munich
32771
32772
32773Contributors
32774------------
32775
32776The following people contributed patches/fixes or (noted in brackets
32777in the changelog below) reports, notes, and ideas that have been
32778incorporated in changes in this release:
32779
32780Carlos O'Donell <carlos@redhat.com>
32781Elie De Brauwer <eliedebrauwer@gmail.com>
32782Florian Weimer <fweimer@redhat.com>
32783Heinrich Schuchardt <xypron.glpk@gmx.de>
32784Marko Myllynen <myllynen@redhat.com>
32785Michael Kerrisk <mtk.manpages@gmail.com>
32786Nadav Har'El <nyh@math.technion.ac.il>
32787NeilBrown <neilb@suse.de>
32788Rich Felker <dalias@libc.org>
32789Robert P. J. Day <rpjday@crashcourse.ca>
32790Simon Paillard <spaillard@debian.org>
32791Tomi Salminen <tlsalmin@gmail.com>
32792Walter Harms <wharms@bfs.de>
32793Yuri Kozlov <yuray@komyakino.ru>
32794Кирилл <kirillnow@gmail.com>
32795
32796Apologies if I missed anyone!
32797
32798
32799New and rewritten pages
32800-----------------------
32801
32802sprof.1
32803 Michael Kerrisk [Marko Myllynen]
32804 New page for the glibc sprof(1) command
32805
32806
32807Newly documented interfaces in existing pages
32808---------------------------------------------
32809
32810epoll_ctl.2
32811 NeilBrown
32812 Document EPOLLWAKEUP
32813
32814epoll.7
32815 NeilBrown
32816 Document EPOLLWAKEUP
32817
32818
32819Changes to individual pages
32820---------------------------
32821
32822iconv.1
32823iconvconfig.8
32824 Marko Myllynen
32825 Clarify gconv file terminology a bit
32826
32827ldd.1
32828 Michael Kerrisk
32829 SEE ALSO: add sprof(1)
32830
32831connect.2
32832 Michael Kerrisk
32833 ERRORS: add EPROTOTYPE
32834 See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394
32835
32836dup.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
32851epoll_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
32857fcntl.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
32867getitimer.2
32868 Michael Kerrisk
32869 Rewrite a few pieces to clarify some details
32870
32871inotify_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
32879open.2
32880 Michael Kerrisk [Кирилл]
32881 O_CLOEXEC is also one the flags not ignored when O_PATH is specified
32882
32883pipe.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
32889poll.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
32894set_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
32900shmop.2
32901 Michael Kerrisk
32902 Explain SHMLBA in much more detail
32903
32904splice.2
32905 Michael Kerrisk
32906 Document EAGAIN error
32907 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32908
32909syscalls.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
19b7ee90
MK
32924syslog.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
32946tee.2
32947 Michael Kerrisk
32948 Document EAGAIN error
32949 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32950
32951vmsplice.2
32952 Michael Kerrisk
32953 Document EAGAIN error
32954 See https://bugzilla.kernel.org/show_bug.cgi?id=48641
32955
32956ether_aton.3
32957 Michael Kerrisk
32958 Make description of ether_line() bug a little more informative
32959
32960mallopt.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
32968printf.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
32987profil.3
32988 Michael Kerrisk
32989 SEE ALSO: add sprof(1)
32990
32991charmap.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
33005proc.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
33013inotify.7
33014 Michael Kerrisk
21040be6 33015 Clarify which events are generated for watched directories
19b7ee90
MK
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().
97eb18a4 33030 When calling inotify_rm_watch() an IN_IGNORED is placed on the
19b7ee90
MK
33031 inotify queue pointing to the ID of the removed watch.
33032
3500165c 33033 inotify_add_watch() should not return a watch descriptor ID for
19b7ee90
MK
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
33064libc.7
33065 Michael Kerrisk
c57f55ec 33066 Clarify man-pages policy on documenting C libraries other than glibc
19b7ee90
MK
33067 Michael Kerrisk
33068 Use absolute dates in discussion of libc vs glibc
33069
33070pipe.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
33080ld.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)
b60a8f50
MK
33089
33090
33091==================== Changes in man-pages-3.71 ====================
33092
33093Released: 2014-08-17, Chicago
33094
33095
33096Contributors
33097------------
33098
33099The following people contributed patches/fixes or (noted in brackets
33100in the changelog below) reports, notes, and ideas that have been
33101incorporated in changes in this release:
33102
33103Adrian Bunk <bunk@kernel.org>
33104Damir Nedzibovic <d.nedzibovic@anoxtech.com>
33105David Prévot <taffit@debian.org>
33106D. Barbier <bouzim@gmail.com>
33107Jakub Wilk <jwilk@debian.org>
33108Jan Chaloupka <jchaloup@redhat.com>
33109Marko Myllynen <myllynen@redhat.com>
33110Michael Kerrisk <mtk.manpages@gmail.com>
33111Mike Frysinger <vapier@gentoo.org>
33112NeilBrown <neilb@suse.de>
33113Paul Jackson <pj@usa.net>
33114Peng Haitao <penght@cn.fujitsu.com>
33115Rahul Bedarkar <rahulbedarkar89@gmail.com>
33116Rob Landley <rob@landley.net>
33117Ryan Hammonds <rhammonds@unicoi.com>
33118Simon Paillard <spaillard@debian.org>
33119Ville Ylenius <ville@ylenius.net>
33120Vince Weaver <vincent.weaver@maine.edu>
33121Yuri Kozlov <yuray@komyakino.ru>
33122
33123Apologies if I missed anyone!
33124
33125
33126New and rewritten pages
33127-----------------------
33128
33129group_member.3
33130 Michael Kerrisk
33131 New page documenting group_member(3)
33132
33133isfdtype.3
33134 Michael Kerrisk
33135 New page documenting isfdtype(3)
33136
33137
33138Newly documented interfaces in existing pages
33139---------------------------------------------
33140
33141perf_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
33160proc.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
33176capabilities.7
33177 Michael Kerrisk
33178 Add CAP_AUDIT_READ
33179 CAP_AUDIT_READ is new in Linux 3.16.
33180
33181
33182Global changes
33183--------------
33184
33185ldd.1
33186clone.2
33187execve.2
33188getpagesize.2
33189ioperm.2
33190msgop.2
33191readv.2
33192recv.2
33193select.2
33194send.2
33195seteuid.2
33196shmop.2
33197signal.2
33198sync.2
33199sysinfo.2
33200utime.2
33201abs.3
33202atoi.3
33203catopen.3
33204clearenv.3
33205ctime.3
33206des_crypt.3
33207ecvt.3
33208flockfile.3
33209fseeko.3
33210ftime.3
33211ftok.3
33212ftw.3
33213getcwd.3
33214getdtablesize.3
33215getline.3
33216getpass.3
33217getpass.3
33218getutent.3
33219glob.3
33220insque.3
33221lseek64.3
33222memmem.3
33223mkstemp.3
33224mktemp.3
33225on_exit.3
33226openpty.3
33227putenv.3
33228putenv.3
33229qecvt.3
33230realpath.3
33231realpath.3
33232remove.3
33233setbuf.3
33234sigpause.3
33235strftime.3
33236strptime.3
33237tzset.3
33238xcrypt.3
33239utmp.5
33240environ.7
33241ipv6.7
33242packet.7
33243 Michael Kerrisk
33244 Remove ancient Linux libc details
33245
33246access.2
33247brk.2
33248chmod.2
33249eventfd.2
33250gethostname.2
33251getpriority.2
33252mmap.2
33253poll.2
33254ptrace.2
33255readv.2
33256sched_setaffinity.2
33257select.2
33258seteuid.2
33259signalfd.2
33260sync_file_range.2
33261timer_create.2
33262uname.2
33263wait.2
33264 Michael Kerrisk
33265 NOTES: add "C library/kernel ABI differences" subheading
33266
33267
33268Changes to individual pages
33269---------------------------
33270
33271access.2
33272 Michael Kerrisk
33273 Glibc falls back to using access() on kernels that lack faccessat()
33274
33275bdflush.2
33276fsync.2
33277sync.2
33278proc.5
33279 Adrian Bunk
33280 Change "sync(1)" to "sync(8)"
33281
33282bind.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
33293chmod.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
33299epoll_wait.2
33300 Michael Kerrisk
33301 NOTES: describe raw epoll_pwait() system call differences
33302
33303getgroups.2
33304 Michael Kerrisk
33305 SEE ALSO: add group_member(3)
33306
33307getpriority.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
33313getrlimit.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
33322kexec_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
33332link.2
33333 Michael Kerrisk
33334 Glibc falls back to link() on kernels that lack linkat()
33335 Unless 'flags' contains AT_SYMLINK_FOLLOW.
33336
33337mkdir.2
33338 Michael Kerrisk
33339 Glibc falls back to mkdir() on kernels that don't support mkdirat()
33340
33341perf_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
33359poll.2
33360 Michael Kerrisk
33361 Describe fifth argument (sigsetsize) of raw ppoll() system call
33362
33363process_vm_readv.2
33364 Michael Kerrisk [Ville Ylenius]
33365 Fix typo in example program
33366
33367readlink.2
33368 Michael Kerrisk
33369 Glibc falls back to readlink() on kernels that lack readlinkat()
33370
33371recv.2
33372 Michael Kerrisk
33373 'addrlen' should be NULL (not 0) if we don't need sender address
33374
33375rename.2
33376 Michael Kerrisk
33377 Glibc falls back to rename() when the kernel doesn't have renameat()
33378
33379sigwaitinfo.2
33380 Michael Kerrisk
33381 The raw sigtimedwait() system call has a fifth argument
33382
33383symlink.2
33384 Michael Kerrisk
33385 Glibc falls back to symlink() on kernels that lack symlinkat()
33386
33387sysinfo.2
33388 Michael Kerrisk
33389 Add VERSIONS section
33390
33391unlink.2
33392 Michael Kerrisk
33393 Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()
33394
33395atoi.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
33401cerf.3
33402cexp2.3
33403clog2.3
33404 Michael Kerrisk
33405 Update version number on "Not yet in glibc" sentence
33406
33407fgetgrent.3
33408getgrent.3
33409getgrent_r.3
33410getgrnam.3
33411 Michael Kerrisk [Rob Landley]
33412 Clarify that 'gr_mem' is a NULL-terminated array of pointers
33413
33414fseeko.3
33415 Michael Kerrisk
33416 Add VERSIONS section
33417
33418ftw.3
33419 Michael Kerrisk
33420 Add VERSIONS section
33421
33422getauxval.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
33428getgrouplist.3
33429 Michael Kerrisk
33430 SEE ALSO: add group_member(3)
33431
33432getline.3
33433 Rahul Bedarkar
33434 Close opened file at end of example program
33435
33436memmem.3
33437 Michael Kerrisk
33438 Rewrite text of glibc 2.0 bug
33439
33440printf.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
33450setbuf.3
33451 Michael Kerrisk
33452 Remove ancient Linux libc and 4.x BSD details
33453
33454strstr.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
33459strtod.3
33460 Michael Kerrisk
33461 Explain NAN(n-char-sequence)
33462
33463strtod.3
33464 Michael Kerrisk
33465 SEE ALSO: add nan(3), nanf(3), NANL(3)
33466
33467updwtmp.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
33472core.5
33473 Rahul Bedarkar
33474 Close opened file in example program
33475
33476proc.5
33477 Michael Kerrisk
33478 Fix kernel version numbers for /proc/PID/stat fields
33479
33480proc.5
bca08408 33481 Jan Chaloupka
b60a8f50
MK
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
33503charsets.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
33509inotify.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
33517man-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
33523vdso.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)
9910e7ee
MK
33528
33529
33530==================== Changes in man-pages-3.72 ====================
33531
33532Released: 2014-09-07, Mountain View
33533
33534
33535Contributors
33536------------
33537
33538The following people contributed patches/fixes or (noted in brackets
33539in the changelog below) reports, notes, and ideas that have been
33540incorporated in changes in this release:
33541
33542Christian von Roques <roques@mti.ag>
33543Holger Hans Peter Freyther <holger@moiji-mobile.com>
33544Michael Haardt <michael@moria.de>
33545Michael Kerrisk <mtk.manpages@gmail.com>
33546Mike Frysinger <vapier@gentoo.org>
33547Peter Schiffer <pschiffe@redhat.com>
33548Rusty Russell <rusty@rustcorp.com.au>
33549Sorin Dumitru <sdumitru@ixiacom.com>
33550
33551Apologies if I missed anyone!
33552
33553
33554New and rewritten pages
33555-----------------------
33556
33557memusage.1
33558 Peter Schiffer, Michael Kerrisk [Jan Chaloupka]
33559 New page for glibc memusage(1) command
33560
33561memusagestat.1
33562 Peter Schiffer [Jan Chaloupka, Michael Kerrisk]
33563 New page for glibc memusagestat(1) command
33564
33565mtrace.1
33566 Peter Schiffer [Jan Chaloupka]
33567 New page describing the glibc mtrace(1) command
33568
33569
33570Changes to individual pages
33571---------------------------
33572
33573connect.2
33574 Michael Haardt
33575 Note that a new socket should be used if connect() fails
33576
33577fcntl.2
33578 Michael Kerrisk
33579 One must define _GNU_SOURCE to get the F_OFD_* definitions
33580
33581poll.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
33618errno.3
33619 Michael Kerrisk
33620 SEE ALSO: add errno(1)
33621
33622rtnetlink.3
33623 Holger Hans Peter Freyther
33624 Fix parameters for the send() call in the example
33625
33626inotify.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
33637packet.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.
95cef60a
MK
33643
33644
33645==================== Changes in man-pages-3.73 ====================
33646
33647Released: 2014-09-21, Munich
33648
33649
33650Contributors
33651------------
33652
33653The following people contributed patches/fixes or (noted in brackets
33654in the changelog below) reports, notes, and ideas that have been
33655incorporated in changes in this release:
33656
33657David Prévot <taffit@debian.org>
33658Eric W. Biederman <ebiederm@xmission.com>
33659J. Bruce Fields <bfields@fieldses.org>
33660Justin Cormack <justin@street-vision.com>
33661Lorenzo Beretta <lory.fulgi@infinito.it>
33662Michael Kerrisk <mtk.manpages@gmail.com>
33663Rob Landley <rob@landley.net>
33664Serge E. Hallyn <serge@hallyn.com>
33665Serge Hallyn <serge.hallyn@ubuntu.com>
33666Vasily Kulikov <segoon@openwall.com>
33667Vincent Lefevre <vincent@vinc17.net>
33668Vitaly Rybnikov <frodox@zoho.com>
33669Yuri Kozlov <yuray@komyakino.ru>
33670
33671Apologies if I missed anyone!
33672
33673
33674New and rewritten pages
33675-----------------------
33676
33677namespaces.7
33678 Michael Kerrisk [Eric W. Biederman]
33679 New page providing overview of Linux namespaces
33680
33681pid_namespaces.7
33682 Michael Kerrisk [Eric W. Biederman, Vasily Kulikov, Rob Landley,
33683 Serge Hallyn]
e0b7e9a2 33684 New page describing PID namespaces
95cef60a
MK
33685
33686user_namespaces.7
33687 Michael Kerrisk [Eric W. Biederman, Andy Lutomirski, Serge Hallyn]
33688 New page describing user namespaces.
33689
33690
33691Newly documented interfaces in existing pages
33692---------------------------------------------
33693
33694clone.2
33695 Eric W. Biederman [Michael Kerrisk]
33696 Document CLONE_NEWUSER for creating a new user namespace
33697
33698setns.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
33703unshare.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
33712Changes to individual pages
33713---------------------------
33714
33715clone.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
33731flock.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
33741getunwind.2
33742 Michael Kerrisk [Yuri Kozlov]
33743 Fix description of return value
33744 s/size of unwind table/size of the unwind data/
33745
33746mount.2
33747 Eric W. Biederman
33748 Clarify use of 'mountflags' and 'data' for MS_REMOUNT
33749
33750reboot.2
33751 Michael Kerrisk [Justin Cormack, Eric W. Biederman]
33752 Document effect of reboot() inside PID namespaces
33753
33754semop.2
33755 Michael Kerrisk
33756 Refer to clone(2) for semantics of CLONE_SYSVSEM and semadj lists
33757
33758seteuid.2
33759setgid.2
33760setresuid.2
33761setreuid.2
33762setuid.2
33763 Michael Kerrisk
33764 EINVAL can occur if UID/GID is not valid in caller's user namespace
33765
33766setns.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
33773unshare.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
33783clock.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
33788drand48.3
33789 Michael Kerrisk [Lorenzo Beretta]
33790 Remove crufty text about SVID 3 marking drand48() obsolete
33791 See http://bugs.debian.org/758293
33792
33793proc.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
33799capabilities.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
33809mq_overview.7
33810 Michael Kerrisk
33811 Refer to namespaces(7) for info on POSIX MQs and IPC namespaces
33812
33813svipc.7
33814 Michael Kerrisk
33815 Refer to namespaces(7) for info on System V IPC and IPC namespaces
de9014b3
MK
33816
33817
33818==================== Changes in man-pages-3.74 ====================
33819
33820Released: 2014-10-03, Munich
33821
33822
33823Contributors
33824------------
33825
33826The following people contributed patches/fixes or (noted in brackets
33827in the changelog below) reports, notes, and ideas that have been
33828incorporated in changes in this release:
33829
33830Arto Bendiken <arto@bendiken.net>
33831Ben Hutchings <ben@decadent.org.uk>
33832Benjamin Herr <ben@0x539.de>
33833C. Alex North-Keys <erlkonig@talisman.org>
33834Carlos O'Donell <carlos@redhat.com>
33835Cyril Hrubis <chrubis@suse.cz>
33836Davidlohr Bueso <dave@stgolabs.net>
33837Doug Ledford <dledford@redhat.com>
33838Elie De Brauwer <eliedebrauwer@gmail.com>
33839Heinrich Schuchardt <xypron.glpk@gmx.de>
33840Jonny Grant <jg@jguk.org>
33841Lanchon <lanchon@gmail.com>
33842Manfred Spraul <manfred@colorfullife.com>
33843Marko Myllynen <myllynen@redhat.com>
33844Michael Kerrisk <mtk.manpages@gmail.com>
33845Shriramana Sharma <samjnaa@gmail.com>
33846Thomas Mack <mack@ifis.cs.tu-bs.de>
33847Wieland Hoffmann <themineo@gmail.com>
33848
33849Apologies if I missed anyone!
33850
33851
33852New and rewritten pages
33853-----------------------
33854
33855pldd.1
33856 Michael Kerrisk
33857 New page for pldd(1) command added to glibc in version 2.15
33858
33859cp1252.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
33869Newly documented interfaces in existing pages
33870---------------------------------------------
33871
33872mq_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
33879Changes to individual pages
33880---------------------------
33881
33882ldd.1
33883 Michael Kerrisk
33884 SEE ALSO: add pldd(1)
33885
33886execve.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
33891fanotify_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
33897fanotify_mark.2
33898 Michael Kerrisk
33899 Note that various bugs were fixed in Linux 3.16
33900
33901getrlimit.2
33902 Michael Kerrisk [Doug Ledford]
33903 Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed
33904
33905open.2
33906 Michael Kerrisk [Shriramana Sharma]
33907 Fix number and formula in description of EOVERFLOW error
33908
33909readlink.2
33910 Michael Kerrisk [Ben Hutchings]
33911 Fix description of readlinkat() with empty 'pathname'
33912 Michael Kerrisk
33913 SEE ALSO: add realpath(3)
33914
33915sched_setattr.2
33916sched_setscheduler.2
33917 Michael Kerrisk
33918 SEE ALSO: add chrt(1)
33919
33920shmget.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
33925syscalls.2
33926 Michael Kerrisk
33927 Add 3 new system calls added in Linux 3.17
33928
33929vmsplice.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
33935dlopen.3
33936 Michael Kerrisk
33937 SEE ALSO: add pldd(1)
33938
33939fseeko.3
33940 Michael Kerrisk [Thomas Mack]
33941 _FILE_OFFSET_BITS must be defined before including any header file
33942
33943getgrent.3
33944 Carlos O'Donell
33945 Add ENOENT and EAGAIN to error list
33946
33947mq_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
33954mq_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
33960realpath.3
33961 Michael Kerrisk
33962 SEE ALSO: add realpath(1)
33963
33964proc.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
33973armscii-8.7
33974 Marko Myllynen
33975 Charset pages unification, minor cleanups
33976
33977ascii.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
33994cp1251.7
33995 Marko Myllynen
33996 Charset pages unification, minor cleanups
33997
33998iso_8859-10.7
33999 Marko Myllynen
34000 Charset pages unification, minor cleanups
34001
34002iso_8859-11.7
34003 Marko Myllynen
34004 Charset pages unification, minor cleanups
34005
34006iso_8859-13.7
34007 Marko Myllynen
34008 Charset pages unification, minor cleanups
34009
34010iso_8859-14.7
34011 Marko Myllynen
34012 Charset pages unification, minor cleanups
34013
34014iso_8859-15.7
34015 Marko Myllynen
34016 Charset pages unification, minor cleanups
34017
34018iso_8859-16.7
34019 Marko Myllynen
34020 Charset pages unification, minor cleanups
34021
34022iso_8859-1.7
34023 Marko Myllynen
34024 Charset pages unification, minor cleanups
34025
34026iso_8859-2.7
34027 Marko Myllynen
34028 Charset pages unification, minor cleanups
34029
34030iso_8859-3.7
34031 Marko Myllynen
34032 Charset pages unification, minor cleanups
34033
34034iso_8859-4.7
34035 Marko Myllynen
34036 Charset pages unification, minor cleanups
34037
34038iso_8859-5.7
34039 Marko Myllynen
34040 Charset pages unification, minor cleanups
34041
34042iso_8859-6.7
34043 Marko Myllynen
34044 Charset pages unification, minor cleanups
34045
34046iso_8859-7.7
34047 Marko Myllynen
34048 Charset pages unification, minor cleanups
34049
34050iso_8859-8.7
34051 Marko Myllynen
34052 Charset pages unification, minor cleanups
34053
34054iso_8859-9.7
34055 Marko Myllynen
34056 Charset pages unification, minor cleanups
34057
34058koi8-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
34066koi8-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
34074mq_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
34092sched.7
34093 Michael Kerrisk
34094 SEE ALSO: add taskset(1)
34095
34096ld.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
5ec812c0
MK
34104
34105
34106==================== Changes in man-pages-3.75 ====================
34107
34108Released: 2014-10-15, Düsseldorf
34109
34110
34111Contributors
34112------------
34113
34114The following people contributed patches/fixes or (noted in brackets
34115in the changelog below) reports, notes, and ideas that have been
34116incorporated in changes in this release:
34117
34118Jonny Grant <jg@jguk.org>
34119Michael Kerrisk <mtk.manpages@gmail.com>
34120Robert Schweikert <rjschwei@suse.com>
34121Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
34122Walter Harms <wharms@bfs.de>
34123
34124Apologies if I missed anyone!
34125
34126
34127New and rewritten pages
34128-----------------------
34129
34130pthread_rwlockattr_setkind_np.3
bb6777d6 34131 Robert Schweikert [Michael Kerrisk]
5ec812c0
MK
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
34137New and changed links
34138---------------------
34139
34140pthread_rwlockattr_getkind_np.3
34141 Robert Schweikert
34142 New link to pthread_rwlockattr_setkind_np(3)
34143
34144
34145Changes to individual pages
34146---------------------------
34147
34148readlink.2
34149 Michael Kerrisk [Jonny Grant]
34150 Add free() call to example program
34151
34152readv.2
34153 Michael Kerrisk
34154 The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments
34155
34156signal.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
34162unix.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).
e1b316da
MK
34171
34172
34173==================== Changes in man-pages-3.76 ====================
34174
34175Released: 2014-12-31, Munich
34176
34177
34178Contributors
34179------------
34180
34181The following people contributed patches/fixes or (noted in brackets
34182in the changelog below) reports, notes, and ideas that have been
34183incorporated in changes in this release:
34184
34185Adam Jiang <jiang.adam@gmail.com>
34186Andrea Balboni <andrea.balboni@unimore.it>
34187Andreas Schwab <schwab@suse.de>
34188Bernhard Walle <bernhard@bwalle.de>
34189Carlos O'Donell <carlos@redhat.com>
34190David Wragg <david@wragg.org>
34191Florian Westphal <fw@strlen.de>
34192Heinrich Schuchardt <xypron.glpk@gmx.de>
34193Huxiaoxiang <huxiaoxiang@huawei.com>
34194Jan Chaloupka <jchaloup@redhat.com>
34195Jonathan Wakely <jwakely@redhat.com>
34196Jonny Grant <jg@jguk.org>
34197Josh Triplett <josh@joshtriplett.org>
34198Kamezawa Hiroyuki <kamezawa.hiroyu@jp.fujitsu.com>
34199Laurent Georget <laurent.georget@supelec.fr>
34200Manuel López-Ibáñez <lopezibanez@gmail.com>
34201Marko Myllynen <myllynen@redhat.com>
34202Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
34203Mel Gorman <mgorman@suse.de>
34204Michael Gehring <mg@ebfe.org>
34205Michael Haardt <michael@moria.de>
34206Michael Kerrisk <mtk.manpages@gmail.com>
34207Mike Frysinger <vapier@gentoo.org>
34208Rasmus Villemoes <rv@rasmusvillemoes.dk>
34209Richard Weinberger <richard@nod.at>
34210Rich Felker <dalias@libc.org>
34211Scott Harvey <scott.harvey@stonybrook.edu>
34212Siddhesh Poyarekar <siddhesh.poyarekar@gmail.com>
34213Simon Newton <nomis52@gmail.com>
34214Simon Paillard <spaillard@debian.org>
34215Sven Hoexter <sven@stormbind.net>
34216Tobias Werth <werth@cs.fau.de>
34217Weijie Yang <weijie.yang.kh@gmail.com>
34218Will Newton <will.newton@linaro.org>
34219Yuri Kozlov <yuray@komyakino.ru>
34220刘湃 <liupai_work@163.com>
34221尹杰 <writalnaie@gmail.com>
34222
34223Apologies if I missed anyone!
34224
34225
34226New and rewritten pages
34227-----------------------
34228
34229adjtimex.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
34276sigreturn.2
34277 Michael Kerrisk
34278 Add (a lot) more detail on the signal trampoline
34279 And rewrite much of the page.
34280
34281
34282Newly documented interfaces in existing pages
34283---------------------------------------------
34284
34285proc.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
34296Changes to individual pages
34297---------------------------
34298
34299localedef.1
34300 Marko Myllynen
34301 Mention default path for compiled files
34302
34303clock_nanosleep.2
34304 Michael Kerrisk
34305 Note that 'clock_id' can also be a CPU clock ID
34306
34307epoll_ctl.2
34308 Michael Kerrisk
34309 Regular files and directories can't be monitored with epoll_ctl()
34310
34311ioctl.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
34317madvise.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
34323open.2
34324 Michael Kerrisk
34325 Enhance rationale discussion for openat() and friends
34326
34327posix_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
34339prctl.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
34348restart_syscall.2
34349 Michael Kerrisk
34350 Add some text explaining why restart_syscall() exists
34351
34352sched_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
34358select.2
34359 Michael Kerrisk
34360 SEE ALSO: add restart_syscall(2)
34361
34362semop.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
34370setsid.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
34376sgetmask.2
34377 Michael Kerrisk
89396224 34378 Since 3.16, support for these system calls is configurable
e1b316da
MK
34379 Support for these calls is now dependent on the setting of the
34380 CONFIG_SGETMASK_SYSCALL option.
34381
34382sigaction.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
34390splice.2
34391 Michael Kerrisk
34392 Reformat description of 'fd_in' and 'off_in' to improve readability
34393
34394syscall.2
34395 Michael Kerrisk
34396 SEE ALSO: add errno(3)
34397
34398syscalls.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
34406tee.2
34407 Michael Kerrisk
34408 Add shell session demonstrating use of the example program
34409
34410tkill.2
34411 Michael Kerrisk [Rich Felker]
34412 Remove bogus text saying tgid==-1 makes tgkill() equivalent to tkill()
34413
34414abort.3
34415 Michael Kerrisk
34416 Note that SIGABRT is raised as though raise(3) is called
c2ba8f3e 34417 Also note that abort() is POSIX.1-2008 compliant.
e1b316da
MK
34418
34419cmsg.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
34433exp10.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
34438ftw.3
34439 Michael Kerrisk
34440 FTW_CHDIR has no effect on the 'fpath' argument passed to fn()
34441
34442getopt.3
34443 Michael Kerrisk [Jonny Grant]
34444 Ensure that 'nsecs' is used
34445
34446ilogb.3
34447 Michael Kerrisk [Will Newton]
34448 Since glibc 2.16, ilogb() does correctly diagnose domain errors
34449
34450memcmp.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
34456mq_open.3
34457 Michael Kerrisk
34458 Document the O_CLOEXEC flag
34459 Michael Kerrisk
34460 Place 'flags' constants in alphabetical order
34461
34462pow.3
34463 Manuel López-Ibáñez
34464 Add note on performance characteristics of pow()
34465
34466pthread_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
34478sigvec.3
34479 Michael Kerrisk
34480 Starting with version 2.21, glibc no longer exports sigvec()
34481
34482sysconf.3
34483 Josh Triplett
34484 Document _SC_NGROUPS_MAX
34485 Already documented in getgroups(2), but not in sysconf(3).
34486
34487termios.3
34488 Michael Kerrisk
34489 SEE ALSO: add tset(1)
34490
34491tgamma.3
34492 Michael Kerrisk
34493 Since glibc 2.18, errno is correctly set to EDOM when (x == -infinity))
34494
34495wordexp.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
34507locale.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
34520resolv.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
34536credentials.7
34537 Josh Triplett
34538 Cross-reference getgroups(2)
34539 Since credentials.7 discusses supplementary GIDs, it should
34540 reference getgroups(2).
34541
34542fanotify.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
34563inotify.7
34564 Heinrich Schuchardt
34565 fallocate(2) does not trigger inotify events
34566 Calling fallocate(2) does not result in inotify events.
34567
34568locale.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
34577man-pages.7
34578 Michael Kerrisk [Laurent Georget]
34579 Clarify that SEE ALSO entries may refer to pages from other projects
34580
34581signal.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
34599unix.7
34600 Michael Kerrisk [Scott Harvey]
34601 Fix buglet in code snippet in BUGS section
34602
34603ld.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
6b13e133
MK
34626
34627
34628==================== Changes in man-pages-3.77 ====================
34629
34630Released: 2015-01-10, Munich
34631
34632
34633Contributors
34634------------
34635
34636The following people contributed patches/fixes or (noted in brackets
34637in the changelog below) reports, notes, and ideas that have been
34638incorporated in changes in this release:
34639
34640Akihiro Motoki <amotoki@gmail.com>
34641Alexandre Bique <bique.alexandre@gmail.com>
34642Andre Majorel <aym-xunil@teaser.fr>
34643Andy Lutomirski <luto@amacapital.net>
34644Daniel Borkmann <dborkman@redhat.com>
34645Dave Hansen <dave.hansen@intel.com>
34646Elie De Brauwer <eliedebrauwer@gmail.com>
34647Heinrich Schuchardt <xypron.glpk@gmx.de>
34648Ignat Loskutov <ignat.loskutov@gmail.com>
34649Jeff Epler <jepler@unpythonic.net>
34650Jérôme Pouiller <jezz@sysmic.org>
34651Kees Cook <keescook@chromium.org>
34652Laurent Georget <laurent.georget@supelec.fr>
34653Masanari Iida <standby24x7@gmail.com>
34654Michael Haardt <michael@moria.de>
34655Michael Kerrisk <mtk.manpages@gmail.com>
34656Mike Frysinger <vapier@gentoo.org>
34657Richard Cochran <richardcochran@gmail.com>
34658Stephan Mueller <stephan.mueller@atsec.com>
34659Troy Davis <troy@yort.com>
34660Vince Weaver <vincent.weaver@maine.edu>
34661Will Drewry <wad@chromium.org>
34662
34663Apologies if I missed anyone!
34664
34665
34666New and rewritten pages
34667-----------------------
34668
34669seccomp.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
34676Newly documented interfaces in existing pages
34677---------------------------------------------
34678
34679netlink.7
34680 Stephan Mueller [Michael Kerrisk]
34681 Add NETLINK_CRYPTO
34682
34683
34684Changes to individual pages
34685---------------------------
34686
34687adjtimex.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
34695perf_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
34706prctl.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
80e1913a 34717 Suggest /proc/PID/status "Seccomp" as alternative to PR_GET_SECCOMP
6b13e133 34718 Michael Kerrisk
80e1913a 34719 SIGKILL can also occur PR_GET_SECCOMP in SECCOMP_MODE_FILTER mode
6b13e133
MK
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
34725setns.2
34726pid_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
34733shmget.2
34734 Michael Kerrisk [Akihiro Motoki]
34735 Make wording of SHMALL description a little clearer
34736
34737sigaction.2
34738 Michael Kerrisk
34739 Add siginfo_t fields for SECCOMP_RET_TRAP
34740
34741memchr.3
34742strstr.3
34743 Alexandre Bique
34744 Reference memmem(3) in SEE ALSO section
34745
34746memcmp.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
34751pthread_tryjoin_np.3
34752 Jérôme Pouiller [Michael Kerrisk]
34753 Document EINVAL error for pthread_timedjoin_np()
34754
34755mem.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
34769random.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
34779proc.5
34780 Michael Kerrisk
34781 Document "Seccomp" field of /proc/PID/status
34782
34783epoll.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
34791tcp.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.
e2395818
MK
34797
34798
34799==================== Changes in man-pages-3.78 ====================
34800
34801Released: 2015-01-22, Munich
34802
34803
34804Contributors
34805------------
34806
34807The following people contributed patches/fixes or (noted in brackets
34808in the changelog below) reports, notes, and ideas that have been
34809incorporated in changes in this release:
34810
34811Akihiro Motoki <amotoki@gmail.com>
34812Alexey Ishchuk <aishchuk@linux.vnet.ibm.com>
34813Carlos O'Donell <carlos@redhat.com>
34814Christian Seiler <christian@iwakd.de>
34815Daniel J Blueman <daniel@quora.org>
34816David Drysdale <drysdale@google.com>
34817David Herrmann <dh.herrmann@gmail.com>
34818Elie De Brauwer <eliedebrauwer@gmail.com>
34819Elliot Hughes <enh@google.com>
34820Jessica McKellar <jessica.mckellar@gmail.com>
34821Kees Cook <keescook@chromium.org>
34822Michael Hayes <mike@aiinc.ca>
34823Michael Kerrisk <mtk.manpages@gmail.com>
34824Rich Felker <dalias@aerifal.cx>
34825Vince Weaver <vincent.weaver@maine.edu>
34826
34827Apologies if I missed anyone!
34828
34829
34830New and rewritten pages
34831-----------------------
34832
34833execveat.2
34834 David Drysdale, Michael Kerrisk [Rich Felker]
34835 New page for execveat(2)
34836
34837memfd_create.2
34838 Michael Kerrisk, David Herrmann
34839 New page for memfd_create() system call
34840 Including notes about file sealing
34841
34842s390_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
34850Newly documented interfaces in existing pages
34851---------------------------------------------
34852
34853fcntl.2
34854 David Herrmann [Michael Kerrisk]
34855 Document F_ADD_SEALS and F_GET_SEALS commands
34856
34857proc.5
34858 Elie De Brauwer
34859 Document /proc/sys/vm/compact_memory
34860 Michael Kerrisk
34861 Document /proc/sys/fs/nr_open
34862
34863
34864New and changed links
34865---------------------
34866
34867s390_pci_mmio_read.2
34868 Michael Kerrisk
34869 New link to new s390_pci_mmio_write(2) page
34870
34871
34872Changes to individual pages
34873---------------------------
34874
34875dup.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
34881execve.2
34882fexecve.3
34883 Michael Kerrisk
34884 SEE ALSO: add execveat(2)
34885
34886fallocate.2
34887mmap.2
34888open.2
34889truncate.2
34890write.2
34891 Michael Kerrisk
34892 ERRORS: add EPERM for operation denied by file seal
34893
34894fcntl.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
34902getrlimit.2
34903 Michael Kerrisk
34904 Update text on RLIMIT_NOFILE ceiling to refer to /proc/sys/fs/file-max
34905
34906mbind.2
34907 Michael Kerrisk [Daniel J Blueman]
34908 Clarify EFAULT text
34909
34910mmap.2
34911shmget.2
34912shm_open.3
34913 Michael Kerrisk
34914 SEE ALSO: add memfd_create(2)
34915
34916open.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
34922perf_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
34941ptrace.2
34942sigaction.2
34943seccomp.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
34950readv.2
34951 Michael Kerrisk
34952 Update details on glibc readv()/writev() wrapper behavior
34953 And add a historical detail about Linux 2.0.
34954
34955select.2
34956 Michael Kerrisk
34957 Mention RLIMIT_NOFILE as a possible cause of EINVAL error
34958
34959syscall.2
34960 Kees Cook
34961 Add arm64 and mips
46e306fd 34962 Add mips and arm64 to tables, along with some further
e2395818
MK
34963 details on these architectures,
34964
34965syscalls.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
34978utimensat.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
34984errno.3
34985 Michael Kerrisk
34986 The RLIMIT_NOFILE resource limit is a common cause of EMFILE
34987
34988exec.3
34989 Michael Kerrisk
34990 SEE ALSO: add execveat(2)
34991
34992fclose.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
35000fexecve.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
35007fmemopen.3
35008 Michael Kerrisk
35009 Consistency fix: use "stream" as name for "FILE *" argument
35010
35011fopencookie.3
35012 Michael Kerrisk
35013 Consistency fix: use "stream" as name for "FILE *" argument
35014
35015getgrent_r.3
35016 Carlos O'Donell
35017 Consistency fix: use "stream" as name for "FILE *" argument
35018
35019getline.3
35020 Michael Kerrisk
35021 Consistency fix: use "stream" as name for "FILE *" argument
35022
35023getmntent.3
35024 Carlos O'Donell
35025 Consistency fix: use "stream" as name for "FILE *" argument
35026
35027getpw.3
35028 Michael Kerrisk [Carlos O'Donell]
35029 Describe return value when 'uid' is not found
35030
35031getpwent_r.3
35032 Carlos O'Donell
35033 Consistency fix: use "stream" as name for "FILE *" argument
35034
35035getspnam.3
35036 Carlos O'Donell
35037 Consistency fix: use "stream" as name for "FILE *" argument
35038
35039malloc_info.3
35040 Carlos O'Donell
35041 Consistency fix: use "stream" as name for "FILE *" argument
35042
35043posix_fallocate.3
35044 Michael Kerrisk
35045 Note that posix_fallocate() is implemented using fallocate(2)
35046
35047putgrent.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
35055locale.5
35056 Akihiro Motoki
35057 Correct variable name
35058
35059proc.5
35060 Michael Kerrisk
35061 Remove bogus statement about NR_OPEN being a ceiling for file-max
6d16d1b8
MK
35062
35063
35064==================== Changes in man-pages-3.79 ====================
35065
35066Released: 2015-02-01, Munich
35067
35068
35069Contributors
35070------------
35071
35072The following people contributed patches/fixes or (noted in brackets
35073in the changelog below) reports, notes, and ideas that have been
35074incorporated in changes in this release:
35075
35076Akihiro Motoki <amotoki@gmail.com>
35077Heinrich Schuchardt <xypron.glpk@gmx.de>
35078J William Piggott <elseifthen@gmx.com>
35079Masanari Iida <standby24x7@gmail.com>
35080Michael Kerrisk <mtk.manpages@gmail.com>
35081Scot Doyle <lkml14@scotdoyle.com>
35082Sergey V. Zubkov <cubbi@cubbi.com>
35083Stephan Mueller <stephan.mueller@atsec.com>
35084Vince Weaver <vincent.weaver@maine.edu>
35085Vivek Goyal <vgoyal@redhat.com>
35086
35087Apologies if I missed anyone!
35088
35089
35090New and rewritten pages
35091-----------------------
35092
35093getrandom.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
35098kexec_load.2
35099 Vivek Goyal, Michael Kerrisk
35100 Add documentation of kexec_file_load(2)
39aad179 35101 Michael Kerrisk, Vivek Goyal
6d16d1b8
MK
35102 Rewrite and extend documentation of kexec_load().
35103
35104
35105New and changed links
35106---------------------
35107
35108kexec_file_load.2
35109 Michael Kerrisk
35110 New link to kexec_load.2
35111
35112Changes to individual pages
35113---------------------------
35114
35115personality.2
35116 Michael Kerrisk
35117 SEE ALSO: add setarch(8)
35118
35119prctl.2
35120 Michael Kerrisk
35121 Unused arguments of PR_MPX_(EN,DIS}ABLE_MANAGEMENT must be zero
35122
35123reboot.2
35124 Michael Kerrisk
35125 SEE ALSO: add kexec_load(2)
35126
35127socket.2
35128 Stephan Mueller
35129 document AF_ALG
35130 Add a reference to the AF_ALG protocol accessible via socket(2).
35131
35132fflush.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
35141getopt.3
35142 Michael Kerrisk
35143 SEE ALSO: add getopt(1)
35144
35145random.3
35146 Heinrich Schuchardt
35147 SEE ALSO: add getrandom(2)
35148
35149termios.3
35150 Michael Kerrisk
35151 SEE ALSO: add reset(1), setterm(1), tput(1)
35152
35153tzset.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
35188random.4
35189 Heinrich Schuchardt
35190 SEE ALSO: add getrandom(2)
35191
35192passwd.5
35193 Michael Kerrisk
35194 SEE ALSO: add chfn(1), chsh(1)
35195
35196capabilities.7
35197 Michael Kerrisk
35198 SEE ALSO: add setpriv(1)
35199
35200signal.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
865e851c
MK
35206
35207
35208==================== Changes in man-pages-3.80 ====================
35209
35210Released: 2015-02-21, Munich
35211
35212
35213Contributors
35214------------
35215
35216The following people contributed patches/fixes or (noted in brackets
35217in the changelog below) reports, notes, and ideas that have been
35218incorporated in changes in this release:
35219
35220Akihiro Motoki <amotoki@gmail.com>
35221Andy Lutomirski <luto@amacapital.net>
35222Bill McConnaughey <mcconnau@biochem.wustl.edu>
35223Chris Mayo <aklhfex@gmail.com>
35224Christophe Blaess <Christophe@blaess.fr>
35225David Wilson <dw@botanicus.net>
35226Denys Vlasenko <dvlasenk@redhat.com>
35227Doug Goldstein <cardoe@gentoo.org>
35228Eric Wong <normalperson@yhbt.net>
35229Heinrich Schuchardt <xypron.glpk@gmx.de>
35230J William Piggott <elseifthen@gmx.com>
35231James Hunt <james.hunt@ubuntu.com>
35232Jan Chaloupka <jchaloup@redhat.com>
35233Jan Stancek <jstancek@redhat.com>
35234Jeff Layton <jlayton@poochiereds.net>
35235Jens Thoms Toerring <jt@toerring.de>
35236Kevin Easton <kevin@guarana.org>
35237Luke Faraone <lfaraone@debian.org>
35238Mark Seaborn <mseaborn@chromium.org>
35239Mathieu Malaterre <malat@debian.org>
35240Michael Kerrisk <mtk.manpages@gmail.com>
35241Michal Hocko <mhocko@suse.cz>
35242Minchan Kim <minchan@kernel.org>
35243Patrick Horgan <phorgan1@gmail.com>
35244Peng Haitao <penght@cn.fujitsu.com>
35245Ralf Baechle <ralf@linux-mips.org>
35246Rob Somers <uberkermit@gmail.com>
35247Simon Paillard <spaillard@debian.org>
35248Stephen Smalley <sds@tycho.nsa.gov>
35249Tao Ma <tao.ma@oracle.com>
35250Tobias Herzke <tobias.linuxpatches.2014@gi2.herzkes.de>
35251Vince Weaver <vincent.weaver@maine.edu>
35252Vlastimil Babka <vbabka@suse.cz>
35253Zbigniew Brzeziński <zbigniew.brzezinski@student.put.poznan.pl>
35254
35255Apologies if I missed anyone!
35256
35257
35258New and rewritten pages
35259-----------------------
35260
35261ioctl_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
35267madvise.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
35336Newly documented interfaces in existing pages
35337---------------------------------------------
35338
35339proc.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
35355socket.7
d4ca1ea1 35356 David Wilson [Michael Kerrisk]
865e851c
MK
35357 Document SO_REUSEPORT socket option
35358
35359
35360New and changed links
35361---------------------
35362
35363get_thread_area.2
35364 Andy Lutomirski
35365 Make get_thread_area.2 a link to rewritten set_thread_area.2 page
35366
35367
35368Changes to individual pages
35369---------------------------
35370
35371time.1
35372 Michael Kerrisk
35373 Make option argument formatting consistent with other pages
35374
35375access.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
35395arch_prctl.2
35396set_thread_area.2
35397get_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
35408cacheflush.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
35414capget.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
35421clone.2
35422 Peng Haitao
35423 Fix description of CLONE_PARENT_SETTID
35424 CLONE_PARENT_SETTID only stores child thread ID in parent memory.
35425
35426clone.2
35427execve.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
35437fcntl.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
35442fork.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
35465getpid.2
35466 Michael Kerrisk
35467 NOTES: add "C library/kernel ABI differences" subheading
35468
35469getxattr.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
35475killpg.2
35476 Michael Kerrisk
35477 NOTES: add "C library/kernel ABI differences" subheading
35478
35479listxattr.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
35490migrate_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
35513modify_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
35521mprotect.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
35528msgget.2
35529 Michael Kerrisk
35530 Add details of MSGMNI default value
35531
35532msgop.2
35533 Michael Kerrisk
35534 Clarify wording of MSGMAX and MSGMNB limits
35535
35536perf_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
35551prctl.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
35565ptrace.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
35587sched_setattr.2
35588 Michael Kerrisk [Christophe Blaess]
35589 SYNOPSIS: remove 'const' from 'attr' sched_getattr() argument
35590
35591semget.2
35592 Michael Kerrisk
35593 Note default value for SEMMNI and SEMMSL
35594
35595semop.2
35596 Michael Kerrisk
35597 Note defaults for SEMOPM and warn against increasing > 1000
35598
35599sendfile.2
35600 Eric Wong
35601 Caution against modifying sent pages
35602
35603setxattr.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
35613stat.2
35614 Michael Kerrisk
35615 NOTES: add "C library/kernel ABI differences" subheading
35616
35617statfs.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
c57f55ec 35622 The number of padding bytes has changed over time, as some
865e851c
MK
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
35635wait.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
35641wait4.2
35642 Michael Kerrisk
35643 NOTES: add "C library/kernel ABI differences" subheading
35644
35645encrypt.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
35653mktemp.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
35659pthread_attr_setschedparam.3
35660 Tobias Herzke
35661 Describe EINVAL in ERRORS
35662
35663resolver.3
35664host.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
35673statvfs.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
35683syslog.3
35684 Michael Kerrisk [Doug Goldstein]
35685 Remove unneeded <stdarg.h>
35686 vsyslog() does not need this.
35687
35688tzset.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
35695random.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
35703core.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
35709intro.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
35715proc.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
35728resolv.conf.5
35729 Michael Kerrisk
35730 SEE ALSO: add nsswitch.conf(5)
35731
35732capabilities.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
35743pthreads.7
35744 Michael Kerrisk
35745 SEE ALSO: add fork(2)
35746
865e851c
MK
35747unix.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
35757ldconfig.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
35775ld.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
fe119330
MK
35784
35785
35786==================== Changes in man-pages-3.81 ====================
35787
35788Released: 2015-03-02, Munich
35789
35790
35791Contributors
35792------------
35793
35794The following people contributed patches/fixes or (noted in brackets
35795in the changelog below) reports, notes, and ideas that have been
35796incorporated in changes in this release:
35797
35798Alexandre Oliva <aoliva@redhat.com>
35799Carlos O'Donell <carlos@redhat.com>
35800Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
35801Michael Kerrisk <mtk.manpages@gmail.com>
35802Peng Haitao <penght@cn.fujitsu.com>
35803
35804Apologies if I missed anyone!
35805
35806
35807New and rewritten pages
35808-----------------------
35809
35810attributes.7
35811 Alexandre Oliva, Michael Kerrisk [Carlos O'Donell]
35812 New page describing POSIX safety concepts
35813
35814
35815Global changes
35816--------------
35817
35818Many pages
35819 Peng Haitao, Michael Kerrisk
35820 Reformat existing thread-safety information to use a
35821 tabular format, rather than plain text.
35822
35823
35824Changes to individual pages
35825---------------------------
35826
35827mmap.2
35828 Ma Shimiao
35829 ATTRIBUTES: Note functions that are thread-safe
35830 The function mmap() and munmap() are thread safe.
35831
35832a64l.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
35838acos.3
35839 Ma Shimiao
35840 ATTRIBUTES: Note functions that are thread-safe
35841 The function acos(), acosf() and acosl() are thread safe.
35842
35843acosh.3
35844 Ma Shimiao
35845 ATTRIBUTES: Note functions that are thread-safe
35846 The function acosh(), acoshf() and acoshl() are thread safe.
35847
35848addseverity.3
35849 Ma Shimiao
35850 ATTRIBUTES: Note function is thread-safe
35851 The function addseverity() is thread safe.
35852
35853aio_cancel.3
35854 Ma Shimiao
35855 ATTRIBUTES: Note function that is thread-safe
35856 The function aio_cancel() is thread safe.
35857
35858aio_fsync.3
35859 Ma Shimiao
35860 ATTRIBUTES: Note function that is thread-safe
35861 The function aio_fsync() is thread safe.
35862
35863aio_read.3
35864 Ma Shimiao
35865 ATTRIBUTES: Note function that is thread-safe
35866 The function aio_read() is thread safe.
35867
35868aio_suspend.3
35869 Ma Shimiao
35870 ATTRIBUTES: Note function that is thread-safe
35871 The function aio_suspend() is thread safe.
35872
35873aio_write.3
35874 Ma Shimiao
35875 ATTRIBUTES: Note function that is thread-safe
35876 The function aio_write() is thread safe.
35877
35878argz_add.3
35879 Ma Shimiao
35880 ATTRIBUTES: Note functions that are thread-safe
35881
35882asin.3
35883 Ma Shimiao
35884 ATTRIBUTES: Note functions that are thread-safe
35885 The function asin(), asinf() and asinl() are thread safe.
35886
35887assert.3
35888 Ma Shimiao
35889 ATTRIBUTES: Note function that is thread-safe
35890 Its marking matches glibc marking.
35891
35892assert_perror.3
35893 Ma Shimiao
35894 ATTRIBUTES: Note function that is thread-safe
35895 Its marking matches glibc marking.
35896
35897atan2.3
35898 Ma Shimiao
35899 ATTRIBUTES: Note functions that are thread-safe
35900 The function atan2(), atan2f() and atan2l() are thread safe.
35901
35902atanh.3
35903 Ma Shimiao
35904 ATTRIBUTES: Note functions that are thread-safe
35905 The function atanh(), atanhf() and atanhl() are thread safe.
35906
35907backtrace.3
35908 Ma Shimiao
35909 ATTRIBUTES: Note function that is thread-safe
35910 The markings match glibc markings.
35911
35912btowc.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
35918cabs.3
35919 Ma Shimiao
35920 ATTRIBUTES: Note functions that are thread-safe
35921 The function cabs(), cabsf() and cabsl() are thread safe.
35922
35923cacos.3
35924 Ma Shimiao
35925 ATTRIBUTES: Note functions that are thread-safe
35926 The function cacos(), cacosf() and cacosl() are thread safe.
35927
35928cacosh.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
35934canonicalize_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
35940carg.3
35941 Ma Shimiao
35942 ATTRIBUTES: Note functions that are thread-safe
35943 The function carg(), cargf() and cargl() are thread safe.
35944
35945casin.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
35951casinh.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
35957catan.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
35963catanh.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
35969catopen.3
35970 Peng Haitao
35971 ATTRIBUTES: Note functions that are thread-safe
35972 The functions catopen() and catclose() are thread safe.
35973
35974cfree.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
35980clog10.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
35986clog.3
35987 Ma Shimiao
35988 ATTRIBUTES: Note functions that are thread-safe
35989 The function clog(), clogf() and clogl() are thread safe.
35990
35991closedir.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
35997confstr.3
35998 Ma Shimiao
35999 ATTRIBUTES: Note function that is thread-safe
36000 The function confstr() is thread safe.
36001
36002cosh.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
36008cpow.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
36014crypt.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
36020ctermid.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
36027drand48.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
36033drand48_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
36039ecvt.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
36045ecvt_r.3
36046 Ma Shimiao
36047 ATTRIBUTES: Note function that is thread-safe
36048 The markings match glibc markings.
36049
36050encrypt.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
36056envz_add.3
36057 Ma Shimiao
36058 ATTRIBUTES: Note functions that are thread-safe
36059 The markings match glibc markings.
36060
36061exec.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
36067exit.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
36073exp10.3
36074 Ma Shimiao
36075 ATTRIBUTES: Note functions that are thread-safe
36076
36077exp2.3
36078 Ma Shimiao
36079 ATTRIBUTES: Note functions that are thread-safe
36080 The function exp2(), exp2f() and exp2l() are thread safe.
36081
36082exp.3
36083 Ma Shimiao
36084 ATTRIBUTES: Note functions that are thread-safe
36085 The function exp(), expf() and expl() are thread safe.
36086
36087fclose.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
36093fcloseall.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
36099fgetc.3
36100 Ma Shimiao
36101 ATTRIBUTES: Note functions that are thread-safe
36102 The markings match glibc markings.
36103
36104fgetwc.3
36105 Ma Shimiao
36106 ATTRIBUTES: Note functions that are thread-safe
36107 The markings match glibc markings.
36108
36109fgetws.3
36110 Ma Shimiao
36111 ATTRIBUTES: Note function that is thread-safe
36112 The marking matches glibc marking.
36113
36114fmod.3
36115 Ma Shimiao
36116 ATTRIBUTES: Note functions that are thread-safe
36117 The function fmod(), fmodf() and fmodl() are thread safe.
36118
36119fnmatch.3
36120 Peng Haitao
36121 ATTRIBUTES: Note function that is thread safe with exceptions
36122 The function fnmatch() is thread safe with exceptions.
36123
36124fopen.3
36125 Ma Shimiao
36126 ATTRIBUTES: Note function that is thread-safe
36127 The markings match glibc markings.
36128
36129fopencookie.3
36130 Ma Shimiao
36131 ATTRIBUTES: Note function that is thread-safe
36132 The marking matches glibc marking.
36133
36134fread.3
36135 Peng Haitao
36136 ATTRIBUTES: Note functions that are thread-safe
36137 The functions fread() and fwrite() are thread safe.
36138
36139gamma.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
36148getcontext.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
36154getcwd.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
36160getdate.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
36166getenv.3
36167 Peng Haitao
36168 ATTRIBUTES: Note functions that are thread-safe
36169 The functions getenv() and secure_getenv() are thread safe.
36170
36171getfsent.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
36181getgrent.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
36190getgrnam.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
36196getgrouplist.3
36197 Peng Haitao
36198 ATTRIBUTES: Note function that is thread safe with exceptions
36199 The function getgrouplist() is thread safe with exceptions.
36200
36201getlogin.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
36207getopt.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
36217getpass.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
36223getpwent.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
36229getpwnam.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
36235gets.3
36236 Ma Shimiao
36237 ATTRIBUTES: Note function that is thread-safe
36238 Its marking matches glibc marking.
36239
36240getw.3
36241 Peng Haitao
36242 ATTRIBUTES: Note functions that are thread-safe
36243 The functions getw() and putw() are thread safe.
36244
36245gnu_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
36251hsearch.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
36257iconv.3
36258 Peng Haitao
36259 Modify thread-safety information
36260
36261inet.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
36273inet_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
36278iswdigit.3
36279 Peng Haitao
36280 ATTRIBUTES: Note function that is thread safe with exceptions
36281 The function iswdigit() is thread safe with exceptions.
36282
36283iswgraph.3
36284 Peng Haitao
36285 ATTRIBUTES: Note function that is thread safe with exceptions
36286 The function iswgraph() is thread safe with exceptions.
36287
36288iswlower.3
36289 Peng Haitao
36290 ATTRIBUTES: Note function that is thread safe with exceptions
36291 The function iswlower() is thread safe with exceptions.
36292
36293iswprint.3
36294 Peng Haitao
36295 ATTRIBUTES: Note function that is thread safe with exceptions
36296 The function iswprint() is thread safe with exceptions.
36297
36298iswpunct.3
36299 Peng Haitao
36300 ATTRIBUTES: Note function that is thread safe with exceptions
36301 The function iswpunct() is thread safe with exceptions.
36302
36303iswspace.3
36304 Peng Haitao
36305 ATTRIBUTES: Note function that is thread safe with exceptions
36306 The function iswspace() is thread safe with exceptions.
36307
36308iswupper.3
36309 Peng Haitao
36310 ATTRIBUTES: Note function that is thread safe with exceptions
36311 The function iswupper() is thread safe with exceptions.
36312
36313iswxdigit.3
36314 Peng Haitao
36315 ATTRIBUTES: Note function that is thread safe with exceptions
36316 The function iswxdigit() is thread safe with exceptions.
36317
36318j0.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
36323lio_listio.3
36324 Ma Shimiao
36325 ATTRIBUTES: Note function that is thread-safe
36326 Its marking matches glibc marking.
36327
36328log10.3
36329 Ma Shimiao
36330 ATTRIBUTES: Note functions that are thread-safe
36331 The function log10(), log10f() and log10l() are thread safe.
36332
36333log2.3
36334 Ma Shimiao
36335 ATTRIBUTES: Note functions that are thread-safe
36336 The function log2(), log2f() and log2l() are thread safe.
36337
36338log.3
36339 Ma Shimiao
36340 ATTRIBUTES: Note functions that are thread-safe
36341 The function log(), logf() and logl() are thread safe.
36342
36343makecontext.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
36349makedev.3
36350 Peng Haitao
36351 ATTRIBUTES: Note macros that are thread-safe
36352 The macros makedev(), major() and minor() are thread safe.
36353
36354malloc.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
36360mblen.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
36366mbstowcs.3
36367 Ma Shimiao
36368 ATTRIBUTES: Note function that is thread-safe
36369 The marking matches glibc marking.
36370
36371mbtowc.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
36380mktemp.3
36381 Peng Haitao
36382 ATTRIBUTES: Note function that is thread-safe
36383 The function mktemp() is thread safe.
36384
36385mtrace.3
36386 Peng Haitao
36387 ATTRIBUTES: Note functions that are not thread-safe
36388 The functions mtrace() and muntrace() are not thread safe.
36389
36390nan.3
36391 Ma Shimiao
36392 ATTRIBUTES: Note functions that are thread-safe
36393 The markings match glibc markings.
36394
36395nl_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
36400opendir.3
36401 Ma Shimiao
36402 ATTRIBUTES: Note function that is thread-safe
36403 The markings match glibc markings.
36404
36405pow10.3
36406 Ma Shimiao
36407 ATTRIBUTES: Note functions that are thread-safe
36408 The function pow10(), pow10f() and pow10l() are thread safe.
36409
36410pow.3
36411 Ma Shimiao
36412 ATTRIBUTES: Note functions that are thread-safe
36413 The function pow(), powf() and powl() are thread safe.
36414
36415pthread_setcancelstate.3
36416 Michael Kerrisk
36417 Add async-signal-safety information
36418
36419ptsname.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
36425putenv.3
36426 Ma Shimiao
36427 ATTRIBUTES: Note function that is thread-unsafe
36428 The function putenv() is thread unsafe.
36429
36430puts.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
36436putwchar.3
36437 Ma Shimiao
36438 ATTRIBUTES: Note function that is thread-safe
36439 The marking matches glibc marking.
36440
36441qecvt.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
36447rand.3
36448 Peng Haitao
36449 ATTRIBUTES: Note macros that are thread-safe
36450 The functions rand(), rand_r() and srand() are thread safe.
36451
36452random_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
36458readdir.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
36464realpath.3
36465 Ma Shimiao
36466 ATTRIBUTES: Note function that is thread-safe
36467 The marking matches glibc marking.
36468
36469regex.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
36476remainder.3
36477 Ma Shimiao
36478 ATTRIBUTES: Note function that is thread-safe
36479 The markings match glibc markings.
36480
36481scalb.3
36482 Ma Shimiao
36483 ATTRIBUTES: Note functions that are thread-safe
36484 The function scalb(), scalbf() and scalbl() are thread safe.
36485
36486setenv.3
36487 Ma Shimiao
36488 ATTRIBUTES: Note functions that are thread-unsafe
36489 The function setenv() and unsetenv() are thread unsafe.
36490
36491siginterrupt.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
36497sigset.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
36503sinh.3
36504 Ma Shimiao
36505 ATTRIBUTES: Note functions that are thread-safe
36506 The function sinh(), sinhf() and sinhl() are thread safe.
36507
36508sqrt.3
36509 Ma Shimiao
36510 ATTRIBUTES: Note functions that are thread-safe
36511 The function sqrt(), sqrtf() and sqrtl() are thread safe.
36512
36513stdarg.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
36519stdio_ext.3
36520 Ma Shimiao
36521 Modify thread-safety information
36522 Change the thread safety information to be the same as glibc.
36523
36524strcasecmp.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
36530strerror.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
36536strfmon.3
36537 Ma Shimiao
36538 ATTRIBUTES: Note function that is thread-safe
36539 Its marking matches glibc marking.
36540
36541strfry.3
36542 Peng Haitao
36543 ATTRIBUTES: Note function that is thread-safe
36544 The function strfry() is thread safe.
36545
36546strftime.3
36547 Peng Haitao
36548 ATTRIBUTES: Note function that is thread safe with exceptions
36549 The function strftime() is thread safe with exceptions.
36550
36551strptime.3
36552 Peng Haitao
36553 ATTRIBUTES: Note function that is thread safe with exceptions
36554 The function strptime() is thread safe with exceptions.
36555
36556strtok.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
36562strverscmp.3
36563 Peng Haitao
36564 ATTRIBUTES: Note function that is thread-safe
36565 The function strverscmp() is thread safe.
36566
36567strxfrm.3
36568 Ma Shimiao
36569 ATTRIBUTES: Note function that is thread-safe
36570 The marking matches glibc marking.
36571
36572syslog.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
36579tempnam.3
36580 Peng Haitao
36581 ATTRIBUTES: Note function that is thread-safe
36582 The function tempnam() is thread safe.
36583
36584termios.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
36594tgamma.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
36600timegm.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
36606tmpfile.3
36607 Ma Shimiao
36608 ATTRIBUTES: Note function that is thread-safe
36609 Its markings match glibc markings.
36610
36611tmpnam.3
36612 Peng Haitao
36613 Modify thread-safety information
36614 When the argument s is NULL, tmpnam() should be MT-Unsafe.
36615
36616toupper.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
36623tsearch.3
36624 Ma Shimiao
36625 ATTRIBUTES: Note functions that are thread-safe
36626 The functions' markings match glibc markings.
36627
36628ttyname.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
36634tzset.3
36635 Peng Haitao
36636 ATTRIBUTES: Note function that is thread safe with exceptions
36637 The function tzset() is thread safe with exceptions.
36638
36639wcsdup.3
36640 Ma Shimiao
36641 ATTRIBUTES: Note function that is thread-safe
36642 Its marking matches glibc marking.
36643
36644wctomb.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
36650y0.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
36655man-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
36661pthreads.7
36662 Michael Kerrisk
36663 SEE ALSO: add attributes(7)
36664
36665standards.7
36666 Michael Kerrisk
36667 SEE ALSO: add attributes(7)
36668
b4ea80b4
MK
36669
36670
36671==================== Changes in man-pages-3.82 ====================
36672
36673Released: 2015-03-29, Paris
36674
b4ea80b4
MK
36675Contributors
36676------------
36677
36678The following people contributed patches/fixes or (noted in brackets
36679in the changelog below) reports, notes, and ideas that have been
36680incorporated in changes in this release:
36681
36682Alban Crequy <alban.crequy@gmail.com>
36683Andy Lutomirski <luto@amacapital.net>
36684Bert Wesarg <bert.wesarg@googlemail.com>
36685Bill Pemberton <wfp5p@worldbroken.com>
36686Chris Delozier <c.s.delozier@gmail.com>
36687David Madore <david.madore@ens.fr>
36688Dmitry Deshevoy <mityada@gmail.com>
36689Eric W. Biederman <ebiederm@xmission.com>
36690Heinrich Schuchardt <xypron.glpk@gmx.de>
968b4034 36691Jakub Wilk <jwilk@debian.org>
b4ea80b4
MK
36692Jann Horn <jann@thejh.net>
36693Jason Vas Dias <jason.vas.dias@gmail.com>
36694Josh Triplett <josh@joshtriplett.org>
36695J William Piggott <elseifthen@gmx.com>
36696Kees Cook <keescook@chromium.org>
36697Konstantin Shemyak <konstantin@shemyak.com>
36698Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
36699Matt Turner <mattst88@gmail.com>
36700Michael Kerrisk <mtk.manpages@gmail.com>
36701Michael Witten <mfwitten@gmail.com>
36702Mikael Pettersson <mikpelinux@gmail.com>
36703Namhyung Kim <namhyung@gmail.com>
36704Nicolas FRANCOIS <nicolas.francois@centraliens.net>
36705Paul E Condon <pecondon@mesanetworks.net>
36706Peter Adkins <peter.adkins@kernelpicnic.net>
36707Scot Doyle <lkml14@scotdoyle.com>
36708Shawn Landden <shawn@churchofgit.com>
36709Stéphane Aulery <saulery@free.fr>
36710Stephen Smalley <sds@tycho.nsa.gov>
36711Taisuke Yamada <tai@rakugaki.org>
36712Torvald Riegel <triegel@redhat.com>
36713Vincent Lefevre <vincent@vinc17.net>
36714<ygrex@ygrex.ru>
36715Yuri Kozlov <yuray@komyakino.ru>
36716
36717Apologies if I missed anyone!
36718
36719
36720New and rewritten pages
36721-----------------------
36722
36723nptl.7
36724 Michael Kerrisk
36725 New page with details of the NPTL POSIX threads implementation
36726
36727
36728Newly documented interfaces in existing pages
36729---------------------------------------------
36730
36731user_namespaces.7
36732 Eric W. Biederman [Michael Kerrisk]
36733 Document /proc/[pid]/setgroups
36734
36735
36736Changes to individual pages
36737---------------------------
36738
36739intro.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
36757clone.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
36770getgroups.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
36788getpid.2
36789 Michael Kerrisk
36790 Note that getppid() returns 0 if parent is in different PID namespace
36791
36792getsockopt.2
36793 Konstantin Shemyak
36794 Note RETURN VALUE details when netfilter is involved
36795
36796ioctl_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
36812msgop.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
36821open.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
36826seccomp.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
36834setgid.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
36846setresuid.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
36856setreuid.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
36868setuid.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
36880sigaction.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
36888sigpending.2
36889 Michael Kerrisk
36890 Add discussion of rt_sigpending(2)
36891
36892sigprocmask.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
36900sigreturn.2
36901 Michael Kerrisk
36902 Add discussion of rt_sigreturn(2)
36903
36904sigsuspend.2
36905 Michael Kerrisk
36906 Add discussion of rt_sigsuspend(2)
36907
36908sigwaitinfo.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
36916socket.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
36922syscall.2
36923 Jann Horn
36924 Add x32 ABI
36925
36926umount.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
36942aio_return.3
36943 Stéphane Aulery
36944 Document the return value on error
36945 Reported by Alexander Holler <holler@ahsoftware.de>
36946
36947clock.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
36954dlopen.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
36983fmemopen.3
36984 Ma Shimiao
36985 ATTRIBUTES: Note functions that are thread-safe
36986 The markings match glibc markings.
36987
36988fpathconf.3
36989 Ma Shimiao
36990 ATTRIBUTES: Note functions that are thread-safe
36991 The marking matches glibc marking.
36992
36993fputwc.3
36994 Ma Shimiao
36995 ATTRIBUTES: Note functions that are thread-safe
36996 The marking matches glibc marking.
36997
36998fputws.3
36999 Ma Shimiao
37000 ATTRIBUTES: Note function that is thread-safe
37001 The marking matches glibc marking.
37002
37003fseek.3
37004 Ma Shimiao
37005 ATTRIBUTES: Note functions that are thread-safe
37006 The markings match glibc markings.
37007
37008fseeko.3
37009 Ma Shimiao
37010 ATTRIBUTES: Note functions that are thread-safe
37011 The markings match glibc markings.
37012
37013gcvt.3
37014 Ma Shimiao
37015 ATTRIBUTES: Note function that is thread-safe
37016 The marking matches glibc marking.
37017
37018getline.3
37019 Ma Shimiao
37020 ATTRIBUTES: Note functions that are thread-safe
37021 The marking matches glibc marking.
37022
37023getwchar.3
37024 Ma Shimiao
37025 ATTRIBUTES: Note function that is thread-safe
37026 The marking matches glibc marking.
37027
37028hypot.3
37029 Ma Shimiao
37030 ATTRIBUTES: Note functions that are thread-safe
37031 The markings match glibc markings.
37032
37033iconv_open.3
37034 Ma Shimiao
37035 ATTRIBUTES: Note function that is thread-safe
37036 The marking matches glibc marking.
37037
37038if_nameindex.3
37039 Ma Shimiao
37040 ATTRIBUTES: Note functions that are thread-safe
37041 The markings match glibc markings.
37042
37043initgroups.3
37044 Ma Shimiao
37045 ATTRIBUTES: Note function that is thread-safe
37046 The markings match glibc markings.
37047
37048mq_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
37055popen.3
37056 Ma Shimiao
37057 ATTRIBUTES: Note functions that are thread-safe
37058 The marking matches glibc marking.
37059
37060pthread_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
37066pthread_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
37072pthread_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
37078resolver.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
37092rint.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
37104sigqueue.3
37105 Michael Kerrisk
37106 NOTES: add "C library/kernel ABI differences" subheading
37107 Michael Kerrisk
37108 Clarify version info (mention rt_sigqueueinfo())
37109
37110sigsetops.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
37116sigwait.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
37122strcoll.3
37123 Ma Shimiao
37124 ATTRIBUTES: Note function that is thread-safe
37125 The markings match glibc markings.
37126
37127strdup.3
37128 Ma Shimiao
37129 ATTRIBUTES: Note functions that are thread-safe
37130 The marking matches glibc marking.
37131
37132tzset.3
37133 J William Piggott
37134 Add 'std' quoting information
37135
37136ulimit.3
37137 Ma Shimiao
37138 ATTRIBUTES: Note function that is thread-safe
37139 The marking matches glibc marking.
37140
37141wcstombs.3
37142 Ma Shimiao
37143 ATTRIBUTES: Note function that is thread-safe
37144 The marking matches glibc marking.
37145
37146wctob.3
37147 Ma Shimiao
37148 ATTRIBUTES: Note function that is thread-safe
37149 The marking matches glibc marking.
37150
37151xdr.3
37152 Taisuke Yamada
37153 Clarified incompatibility and correct usage of XDR API
37154 See http://bugs.debian.org/628099
37155
37156console_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
37166random.4
37167 Michael Kerrisk
37168 Fix permissions shown for the devices
37169 These days, the devices are RW for everyone.
37170
37171filesystems.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
37182host.conf.5
37183hosts.5
37184resolv.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
37189host.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
37200hosts.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
37205proc.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
37224securetty.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
37232boot.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
37241credentials.7
37242 Michael Kerrisk
37243 SEE ALSO: add pthreads(7)
37244 Michael Kerrisk
37245 Add reference to nptl(7)
37246
37247feature_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
37256hier.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
37272ipv6.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
37277man-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
37283packet.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
37301pthreads.7
37302 Michael Kerrisk
37303 Add references to nptl(7)
37304
37305raw.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
37311signal.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
37321tcp.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
37330user_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
37378ldconfig.8
37379 Michael Kerrisk
37380 Note use of /lib64 and /usr/lib64 on some 64-bit architectures
37381
37382ld.so.8
37383 Michael Kerrisk
37384 Note the use of /lib64 and /usr/lib64 on some 64-bit architectures
37385
98ef8044
MK
37386
37387
37388==================== Changes in man-pages-3.83 ====================
37389
37390Released: 2015-04-19, Munich
37391
37392
37393Contributors
37394------------
37395
37396The following people contributed patches/fixes or (noted in brackets
37397in the changelog below) reports, notes, and ideas that have been
37398incorporated in changes in this release:
37399
37400Andreas Baak <andreas.baak@gmail.com>
37401Andreas Dilger <adilger@dilger.ca>
37402cdlscpmv <cdlscpmv@gmail.com>
37403Cyrill Gorcunov <gorcunov@openvz.org>
37404Darrick J. Wong <darrick.wong@oracle.com>
37405David Rientjes <rientjes@google.com>
37406Dima Tisnek <dimaqq@gmail.com>
37407Eric Sandeen <sandeen@redhat.com>
37408Fabien Pichot <fpichot@bouledef.eu>
37409Felix Sedlmeier <sedlmeier@gmx.de>
37410Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
37411Heinrich Schuchardt <xypron.glpk@gmx.de>
37412Jann Horn <jann@thejh.net>
37413Jon Grant <jg@jguk.org>
37414Jonny Grant <jg@jguk.org>
37415Kees Cook <keescook@chromium.org>
37416Masanari Iida <standby24x7@gmail.com>
37417Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>
37418Michael Kerrisk <mtk.manpages@gmail.com>
37419Nikos Mavrogiannopoulos <nmav@gnutls.org>
37420Omar Sandoval <osandov@osandov.com>
37421Pierre Chifflier <pollux@debian.org>
37422Robin H. Johnson <robbat2@gentoo.org>
37423Rob Landley <rob@landley.net>
37424Theodore Ts'o <tytso@mit.edu>
37425Vlastimil Babka <vbabka@suse.cz>
37426Walter Harms <wharms@bfs.de>
37427William Woodruff <william@tuffbizz.com>
37428YOSHIFUJI Hideaki <hideaki.yoshifuji@miraclelinux.com>
37429Zeng Linggang <zenglg.jy@cn.fujitsu.com>
37430
37431Apologies if I missed anyone!
37432
37433
37434New and rewritten pages
37435-----------------------
37436
37437posix_madvise.3
37438 Michael Kerrisk
37439 New page documenting posix_madvise(3)
37440
37441ftw.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
37446Newly documented interfaces in existing pages
37447---------------------------------------------
37448
37449getdents.2
d0792c6a 37450 Michael Kerrisk [Dima Tisnek]
98ef8044 37451 Document getdents64()
d0792c6a 37452 See https://bugzilla.kernel.org/show_bug.cgi?id=14795
98ef8044
MK
37453
37454mount.2
37455 Michael Kerrisk, Theodore Ts'o [Eric Sandeen, Andreas Dilger,
37456 Omar Sandoval, Darrick J. Wong]
37457 Document MS_LAZYTIME
98ef8044
MK
37458
37459proc.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
37470New and changed links
37471---------------------
37472
37473newfstatat.2
37474 Michael Kerrisk
37475 New link to fstatat64.2
37476
37477prlimit64.2
37478 Michael Kerrisk
37479 New link to getrlimit.2
37480
37481
37482Global changes
37483--------------
37484
d0792c6a 37485Various section 3 math pages
98ef8044
MK
37486 Michael Kerrisk
37487 Note that these functions are also in POSIX.1-2001 and POSIX.1-2008
37488
37489
37490Changes to individual pages
37491---------------------------
37492
37493getent.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
37501fallocate.2
37502 Michael Kerrisk
37503 Fix kernel version number for FALLOC_FL_ZERO_RANGE
d0792c6a 37504 FALLOC_FL_ZERO_RANGE was added in 3.15, not 3.14.
98ef8044
MK
37505 Michael Kerrisk
37506 Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17
37507
98ef8044
MK
37508getrlimit.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
37516ioctl_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
37524llseek.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
37530madvise.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
37541poll.2
37542 Michael Kerrisk [Andreas Baak]
37543 SEE ALSO: add epoll(7)
37544
37545posix_fadvise.2
37546 Michael Kerrisk
37547 Add "C library/kernel ABI differences" subsection
37548
37549pread.2
37550 Michael Kerrisk
37551 Add "C library/kernel ABI differences" subsection
37552
37553seccomp.2
37554 Michael Kerrisk [Pierre Chifflier, Kees Cook]
37555 Note that seccomp_data is read-only
37556
37557stat.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.
98ef8044
MK
37564 Michael Kerrisk
37565 Add mention of newfstatat()
37566 The underlying system call for fstatat() is newfstatat()
37567 on some architectures.
37568
37569symlink.2
37570 Michael Kerrisk [Jonny Grant]
37571 ERRORS: add linkpath=="" case for ENOENT
37572
37573syscalls.2
37574 Michael Kerrisk
37575 Remove prlimit()
37576 There really is only the prlimit64() system call.
98ef8044
MK
37577 Michael Kerrisk
37578 Add some details about the "multiple versions of system calls"
d0792c6a 37579 The multiple-system-call-version phenomenon is particularly a
98ef8044
MK
37580 feature of older 32-bit platforms. Hint at that fact in the text.
37581
37582timerfd_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
37588unshare.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
37593asprintf.3
37594 Zeng Linggang
37595 ATTRIBUTES: Note functions that are thread-safe
37596
37597carg.3
37598 Michael Kerrisk
37599 Add introductory sentence explaining what these functions calculate
37600
37601ccos.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
37607ccosh.3
37608 Michael Kerrisk
37609 Add introductory sentence explaining what these functions calculate
37610
37611cexp.3
37612 Ma Shimiao
37613 ATTRIBUTES: Note functions that are thread-safe
37614
37615clock.3
37616 Ma Shimiao
37617 ATTRIBUTES: Note functions that is thread-safe
37618
37619clog.3
37620 Michael Kerrisk
37621 Add introductory sentence explaining what these functions calculate
37622
37623csin.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
37629csinh.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
37635csqrt.3
37636 Ma Shimiao
37637 ATTRIBUTES: Note functions that are thread-safe
37638 Michael Kerrisk
37639 Simplify description of what these functions calculate
37640
37641ctan.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
37647ctanh.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
37653ctime.3
37654 Zeng Linggang
37655 ATTRIBUTES: Note functions that aren't thread-safe
37656
37657exec.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
37664ftw.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
37675getcwd.3
37676 Jann Horn [Michael Kerrisk]
37677 Note behavior for unreachable current working directory
37678 Michael Kerrisk
37679 Add ENOMEM error
37680
37681gethostbyname.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
37690getnetent.3
37691 Zeng Linggang
37692 ATTRIBUTES: Note functions that aren't thread-safe
37693
37694get_nprocs_conf.3
37695 Zeng Linggang
37696 ATTRIBUTES: Note functions that are thread-safe
37697
37698getutent.3
37699 Zeng Linggang
37700 ATTRIBUTES: Note functions that aren't thread-safe
37701
37702glob.3
37703 Zeng Linggang
37704 ATTRIBUTES: Note functions that aren't thread-safe
37705
37706insque.3
37707 Ma Shimiao
37708 ATTRIBUTES: Note functions that are thread-safe
37709
37710login.3
37711 Zeng Linggang
37712 ATTRIBUTES: Note functions that aren't thread-safe
37713
37714lseek64.3
37715 Michael Kerrisk
37716 Clarify details with respect to 32-bit and 64-bit systems
37717
37718malloc.3
37719 Michael Kerrisk
37720 Add ENOMEM error
37721
37722mbsnrtowcs.3
37723 Zeng Linggang
37724 ATTRIBUTES: Note function that isn't thread-safe
37725
37726mbsrtowcs.3
37727 Zeng Linggang
37728 ATTRIBUTES: Note function that isn't thread-safe
37729
37730mq_notify.3
37731 Michael Kerrisk
37732 Add "C library/kernel ABI differences" subsection
37733
37734mq_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
37739openpty.3
37740 Zeng Linggang
37741 ATTRIBUTES: Note functions that aren't thread-safe
37742
37743perror.3
37744 Zeng Linggang
37745 ATTRIBUTES: Note function that is thread-safe
37746
37747posix_memalign.3
37748 Zeng Linggang
37749 ATTRIBUTES: Note functions that aren't thread-safe
37750
37751printf.3
37752 Zeng Linggang
37753 ATTRIBUTES: Note functions that are thread-safe
37754 Walter Harms [Michael Kerrisk]
37755 Simplify the example code
37756
37757qsort.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
37775realpath.3
37776 Michael Kerrisk [Jon Grant]
37777 Add ENOMEM error
37778
37779scandir.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
37785scanf.3
37786 Zeng Linggang
37787 ATTRIBUTES: Note functions that are thread-safe
37788
37789setnetgrent.3
37790 Zeng Linggang
37791 ATTRIBUTES: Note functions that aren't thread-safe
37792
37793significand.3
37794 Ma Shimiao
37795 ATTRIBUTES: Note functions that are thread-safe
37796
37797strcasecmp.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
37803unlocked_stdio.3
37804 Zeng Linggang
37805 ATTRIBUTES: Note functions that aren't thread-safe
37806
37807updwtmp.3
37808 Zeng Linggang
37809 ATTRIBUTES: Note functions that aren't thread-safe
37810
37811wcrtomb.3
37812 Zeng Linggang
37813 ATTRIBUTES: Note function that isn't thread-safe
37814
37815wcsnrtombs.3
37816 Zeng Linggang
37817 ATTRIBUTES: Note function that isn't thread-safe
37818
37819wcsrtombs.3
37820 Zeng Linggang
37821 ATTRIBUTES: Note function that isn't thread-safe
37822
37823wordexp.3
37824 Zeng Linggang
37825 ATTRIBUTES: Note functions that aren't thread-safe
37826
37827wprintf.3
37828 Zeng Linggang
37829 ATTRIBUTES: Note functions that are thread-safe
37830
37831proc.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
98ef8044
MK
37844
37845epoll.7
37846 Michael Kerrisk
37847 SEE ALSO: add poll(2) and select(2)
37848
37849icmp.7
37850 YOSHIFUJI Hideaki/吉藤英明
37851 Document net.ipv4.ping_group_range knob
37852
37853nptl.7
37854 Michael Kerrisk
37855 Add reference to timer_create(2)
e60d5c44
MK
37856
37857
37858==================== Changes in man-pages-4.00 ====================
37859
37860Released: 2015-05-07, Munich
37861
37862
37863Contributors
37864------------
37865
37866The following people contributed patches/fixes or (noted in brackets
37867in the changelog below) reports, notes, and ideas that have been
37868incorporated in changes in this release:
37869
37870Advait Dixi <advaitdixit@hotmail.com>
37871Alain Kalker <a.c.kalker@gmail.com>
37872Andi Kleen <andi@firstfloor.org>
37873Andreas Gruenbacher <agruenba@redhat.com>
37874Andreas Heiduk <asheiduk@googlemail.com>
37875Askar Safin <safinaskar@mail.ru>
37876Brice Goglin <Brice.Goglin@inria.fr>
37877Cameron Norman <camerontnorman@gmail.com>
37878Carlos O'Donell <carlos@redhat.com>
37879Chris Metcalf <cmetcalf@tilera.com>
37880Christophe Lohr <Christophe.Lohr@telecom-bretagne.eu>
37881Christopher Head <chead@chead.ca>
37882Christoph Hellwig <hch@infradead.org>
37883David Wilcox <davidvsthegiant@gmail.com>
37884Denis Du <denisdu@ruggedcom.com>
37885Egmont Koblinger <egmont@gmail.com>
37886Filipe Brandenburger <filbranden@gmail.com>
37887Filipus Klutiero <chealer@gmail.com>
37888Florian Weimer <fweimer@redhat.com>
37889Frédéric Maria <frederic.maria@free.fr>
37890Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
37891Graham Shaw <gdshaw@riscpkg.org>
37892Gregor Jasny <igjasny@googlemail.com>
37893Guillem Jover <guillem@hadrons.org>
37894Guy Harris <guy@alum.mit.edu>
37895Heinrich Schuchardt <xypron.glpk@gmx.de>
37896Ian Pilcher <arequipeno@gmail.com>
37897Jann Horn <jann@thejh.net>
37898Jason Newton <nevion@gmail.com>
37899J. Bruce Fields <bfields@fieldses.org>
37900Jiri Pirko <jpirko@redhat.com>
37901Joachim Wuttke <j.wuttke@fz-juelich.de>
37902Joern Heissler <contact@joern.heissler.de>
37903Jonathan Nieder <jrnieder@gmail.com>
37904Joonas Salo <salo.joonas@gmail.com>
37905Jussi Lehtola <jussilehtola@fedoraproject.org>
37906Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
37907KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
37908Laurence Gonsalves <laurence@xenomachina.com>
37909Magnus REFTEL <magnus.xm.reftel@stericsson.com>
37910Michael Kerrisk <mtk.manpages@gmail.com>
37911NeilBrown <neilb@suse.de>
37912Regid Ichira <regid23@nt1.in>
37913Sam Varshavchik <mrsam@courier-mta.com>
37914Steinar H. Gunderson <sgunderson@bigfoot.com>
37915Stéphane Aulery <saulery@free.fr>
37916Stephane Fillod <fillods@users.sf.net>
37917Tetsuo Handa <from-linux-kernel@i-love.sakura.ne.jp>
37918Thomas Hood <jdthood@gmail.com>
37919Urs Thuermann <urs@isnogud.escape.de>
37920Vasiliy Kulikov <segooon@gmail.com>
37921Vegard Nossum <vegard.nossum@gmail.com>
37922Weijie Yang <weijie.yang@samsung.com>
37923William Woodruff <william@tuffbizz.com>
37924Zeng Linggang <zenglg.jy@cn.fujitsu.com>
37925
37926Apologies if I missed anyone!
37927
37928
37929New and rewritten pages
37930-----------------------
37931
37932get_phys_pages.3
37933 William Woodruff
37934 Document get_phys_pages() and get_avphys_pages()
37935
37936loop.4
37937 Urs Thuermann, Michael Kerrisk
37938 New page documenting the loop device
37939
37940xattr.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
37955Newly documented interfaces in existing pages
37956---------------------------------------------
37957
37958mmap.2
37959 Michael Kerrisk [Andi Kleen]
37960 Document MAP_HUGE_2MB, MAP_HUGE_1GB, and MAP_HUGE_SHIFT
37961
37962shmget.2
37963 Michael Kerrisk [Andi Kleen]
37964 Document SHM_HUGE_2MB, SHM_HUGE_1GB, and SHM_HUGE_SHIFT
37965
37966resolver.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
37972tty_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
37985New and changed links
37986---------------------
37987
37988CMSG_DATA.3
37989 Michael Kerrisk
37990 New link to cmsg(3)
37991
37992CMSG_LEN.3
37993 Michael Kerrisk
37994 New link to cmsg(3)
37995
37996dprintf.3
37997 Michael Kerrisk
37998 Convert to a link to printf.3
37999
38000get_avphys_pages.3
38001 William Woodruff
38002 New link to new get_phys_pages.3 page
38003
38004res_ninit.3
38005res_nmkquery.3
38006res_nquery.3
38007res_nquerydomain.3
38008res_nsearch.3
38009res_nsend.3
38010 Michael Kerrisk
38011 New links to resolver(3) man page
38012
38013loop-control.4
38014 Michael Kerrisk
38015 New link to loop.4
38016
38017attr.5
38018 Michael Kerrisk
38019 New link to xattr(7)
38020
38021
38022Global changes
38023--------------
38024
38025chown.2
38026execve.2
38027prctl.2
38028truncate.2
38029proc.5
38030capabilities.7
38031ld.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
38037Changes to individual pages
38038---------------------------
38039
38040add_key.2
38041keyctl.2
38042request_key.2
38043 Michael Kerrisk
38044 SEE ALSO: add keyrings(7)
38045
38046add_key.2
38047request_key.2
38048 Michael Kerrisk
38049 SEE ALSO: add keyctl(3)
38050
38051epoll_ctl.2
38052 Michael Kerrisk
38053 After EPOLLHUP, EOF will be seen only after all data has been consumed
38054
38055epoll_wait.2
38056 Michael Kerrisk
38057 Clarify that signal mask treatment in epoll_pwait() is per-thread
38058 s/sigprocmask()/pthread_sigmask()/
38059
38060fcntl.2
38061 Michael Kerrisk [Vegard Nossum]
38062 Note an F_SETSIG corner case
38063
38064get_mempolicy.2, set_mempolicy
38065 Brice Goglin
38066 Policy is per thread, not per process
38067
38068getxattr.2
38069listxattr.2
38070removexattr.2
38071setxattr.2
38072capabilities.7
38073 Michael Kerrisk
38074 Adjust "attr(5)" references to "xattr(7)"
38075
38076ioctl.2
38077 Michael Kerrisk
38078 SEE ALSO: add console_ioctl(2) and tty_ioctl(2)
38079
38080listxattr.2
38081xattr.7
38082 Michael Kerrisk
38083 Describe listxattr(2) E2BIG error and document it as a BUG
38084
38085mkdir.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
38091mknod.2
38092 Michael Kerrisk
38093 Rewordings + point reader at stat(2) for details of mode bits
38094
38095mmap.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
38111msync.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
38117nfsservctl.2
38118 Michael Kerrisk [J. Bruce Fields]
38119 Note that nfsservctl() was replaced by files in nfsd filesystem
38120
38121open.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
38129poll.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
38138prctl.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
38143sendfile.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
38154shutdown.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
38160sigaction.2
38161 Michael Kerrisk
38162 Refer the reader to fcntl(2) F_SETSIG for further details on si_fd
38163
38164stat.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'
1966fc7b 38176 According to POSIX, the 9 UGO*RWX bits are permissions, and
e60d5c44
MK
38177 'mode' is used to refer to collectively to those bits plus sticky,
38178 set-UID, and set_GID bits.
38179
38180syslog.2
38181 Michael Kerrisk
38182 SEE ALSO: add dmesg(1)
38183
38184umask.2
38185open.2
38186mknod.2
38187mkdir.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
38194unshare.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
38199atexit.3
38200 Zeng Linggang
38201 ATTRIBUTES: Note function that is thread-safe
38202
38203bsearch.3
38204 Zeng Linggang
38205 ATTRIBUTES: Note function that is thread-safe
38206
38207cmsg.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
38214CPU_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
38230err.3
38231 Zeng Linggang
38232 ATTRIBUTES: Note functions that are thread-safe
38233
38234ftw.3
38235 Zeng Linggang
38236 ATTRIBUTES: Note functions that are thread-safe
38237
38238gethostbyname.3
38239 Carlos O'Donell
38240 NSS plugins searched first
38241 Carlos O'Donell
38242 "order" is obsolete
38243
38244gethostid.3
38245 Zeng Linggang
38246 ATTRIBUTES: Note functions that are/aren't thread-safe
38247
38248getmntent.3
38249 Zeng Linggang
38250 ATTRIBUTES: Note functions that are/aren't thread-safe
38251
38252get_nprocs_conf.3
38253 Michael Kerrisk
38254 Use exit() rather than return in main()
38255
38256getopt.3
38257 Michael Kerrisk [Guy Harris]
38258 Remove crufty BUGS section
38259 See https://bugzilla.kernel.org/show_bug.cgi?id=90261
38260
38261iconv_close.3
38262 Zeng Linggang
38263 ATTRIBUTES: Note function that is thread-safe
38264
38265inet_ntop.3
38266 Zeng Linggang
38267 ATTRIBUTES: Note function that is thread-safe
38268
38269longjmp.3
38270 Zeng Linggang
38271 ATTRIBUTES: Note functions that are thread-safe
38272
38273lsearch.3
38274 Zeng Linggang
38275 ATTRIBUTES: Note functions that are thread-safe
38276
38277mcheck.3
38278 Zeng Linggang
38279 ATTRIBUTES: Note functions that aren't thread-safe
38280
38281on_exit.3
38282 Zeng Linggang
38283 ATTRIBUTES: Note function that is thread-safe
38284
38285printf.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
38293putpwent.3
38294 Zeng Linggang
38295 ATTRIBUTES: Note function that is thread-safe
38296
38297qsort.3
38298 Zeng Linggang
38299 ATTRIBUTES: Note functions that are thread-safe
38300
38301regex.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
38306resolver.3
38307 Stéphane Aulery
38308 Add info about RES_INSECURE1 and RES_INSECURE2 option in debug mode
38309
38310scanf.3
38311 Joern Heissler
38312 Improve description of %n specifier
38313
38314setjmp.3
38315 Zeng Linggang
38316 ATTRIBUTES: Note functions that are thread-safe
38317
38318setlocale.3
38319 Zeng Linggang
38320 ATTRIBUTES: Note function that isn't thread-safe
38321
38322setlogmask.3
38323 Zeng Linggang
38324 ATTRIBUTES: Note function that isn't thread-safe
38325
38326sleep.3
38327 Zeng Linggang
38328 ATTRIBUTES: Note function that isn't thread-safe
38329
38330strsignal.3
38331 Zeng Linggang
38332 ATTRIBUTES: Note function that isn't thread-safe
38333
38334sysconf.3
38335 Zeng Linggang
38336 ATTRIBUTES: Note function that is thread-safe
38337
38338undocumented.3
38339 William Woodruff
38340 Remove documented functions
38341
38342tty_ioctl.4
38343 Michael Kerrisk [Denis Du]
38344 Fix error in code example
38345
38346proc.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
38360resolv.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
38370tzfile.5
38371 Sam Varshavchik
38372 Add various details on version 2 format
38373
38374aio.7
38375 Michael Kerrisk
38376 Add details and update URL for OLS 2003 paper on AIO
38377
e60d5c44
MK
38378bootparam.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
38430fanotify.7
38431 Michael Kerrisk [Heinrich Schuchardt]
38432 Since Linux 3.19, fallocate(2) generates FAN_MODIFY events
38433
38434inotify.7
38435 Michael Kerrisk [Heinrich Schuchardt]
38436 Since Linux 3.19, fallocate(2) generates IN_MODIFY events
38437
38438ip.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]
8da400b0 38444 Remove dubious text that says that SO_PRIORITY sets IP TOS
e60d5c44
MK
38445 See https://bugzilla.kernel.org/show_bug.cgi?id=35852
38446 Michael Kerrisk
38447 Relocate misplaced text describing ENOPROTOOPT error
38448
38449packet.7
38450 Graham Shaw
38451 Add sll_protocol to list of required fields for outbound packets
38452
38453pthreads.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
38458raw.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
38470signal.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
38475unix.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
e60d5c44 38483xattr.7
8da400b0
MK
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
e60d5c44
MK
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
38514nscd.8
38515 Michael Kerrisk
38516 Add mention of 'services' and 'netgroup' databases
38517 This makes the page consistent with nscd.conf(5).
4f73df7c
MK
38518
38519
38520==================== Changes in man-pages-4.01 ====================
38521
38522Released: 2015-07-23, Munich
38523
38524
38525Contributors
38526------------
38527
38528The following people contributed patches/fixes or (noted in brackets
38529in the changelog below) reports, notes, and ideas that have been
38530incorporated in changes in this release:
38531
38532Alexei Starovoitov <ast@plumgrid.com>
38533Andries E. Brouwer <Andries.Brouwer@cwi.nl>
38534Arjun Shankar <arjun@redhat.com>
38535Ashish Sangwan <a.sangwan@samsung.com>
38536Ben Woodard <woodard@redhat.com>
38537Carlos O'Donell <carlos@redhat.com>
38538Christoph Thompson <cjsthompson@gmail.com>
38539Cortland Setlow <cortland.setlow@gmail.com>
38540Daniel Borkmann <daniel@iogearbox.net>
38541David Leppik <dleppik@vocalabs.com>
38542Dilyan Palauzov <dilyan.palauzov@aegee.org>
38543Doug Klima <cardoe@gentoo.org>
38544Eric B Munson <emunson@akamai.com>
38545Florian Weimer <fweimer@redhat.com>
38546Hack NDo <hackndo@gmail.com>
38547Jann Horn <jann@thejh.net>
38548Jens Axboe <axboe@fb.com>
38549Jian Wen <wenjianhn@gmail.com>
38550Joerg Roedel <jroedel@suse.de>
38551Julian Orth <ju.orth@gmail.com>
38552Kees Cook <keescook@chromium.org>
38553Laszlo Ersek <lacos@caesar.elte.hu>
38554Marko Myllynen <myllynen@redhat.com>
38555Mehdi Aqadjani Memar <m.aqadjanimemar@student.vu.nl>
38556Michael Kerrisk <mtk.manpages@gmail.com>
38557Michal Hocko <mhocko@suse.cz>
38558Mike Frysinger <vapier@gentoo.org>
38559Mike Hayward <hayward@loup.net>
38560Miklos Szeredi <miklos@szeredi.hu>
38561Namhyung Kim <namhyung@gmail.com>
38562Namjae Jeon <namjae.jeon@samsung.com>
38563Nathan Lynch <nathan_lynch@mentor.com>
38564NeilBrown <neilb@suse.de>
38565Pádraig Brady <P@draigBrady.com>
38566Pavel Machek <pavel@ucw.cz>
38567Peter Hurley <peter@hurleysoftware.com>
38568Sam Varshavchik <mrsam@courier-mta.com>
38569Scot Doyle <lkml14@scotdoyle.com>
38570Stephan Mueller <stephan.mueller@atsec.com>
38571Tobias Stoeckmann <tobias@stoeckmann.org>
38572Tulio Magno Quites Machado Filho <tuliom@linux.vnet.ibm.com>
38573Uwe Kleine-König <uwe+debian@kleine-koenig.org>
38574Vegard Nossum <vegard.nossum@oracle.com>
38575Ville Skyttä <ville.skytta@iki.fi>
38576Vince Weaver <vincent.weaver@maine.edu>
38577Zeng Linggang <zenglg.jy@cn.fujitsu.com>
38578文剑 <wenjianhn@gmail.com>
38579
38580Apologies if I missed anyone!
38581
38582
38583New and rewritten pages
38584-----------------------
38585
38586bpf.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
38598queue.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
38623Newly documented interfaces in existing pages
38624---------------------------------------------
38625
38626rename.2
38627 Michael Kerrisk [Miklos Szeredi]
38628 Document RENAME_WHITEOUT
38629 Heavily based on text by Miklos Szeredi.
38630
38631
38632New 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
38639LIST_EMPTY.3
38640LIST_FIRST.3
38641LIST_FOREACH.3
38642LIST_HEAD_INITIALIZER.3
38643LIST_INSERT_BEFORE.3
38644LIST_NEXT.3
38645SLIST_EMPTY.3
38646SLIST_ENTRY.3
38647SLIST_FIRST.3
38648SLIST_FOREACH.3
38649SLIST_HEAD.3
38650SLIST_HEAD_INITIALIZER.3
38651SLIST_INIT.3
38652SLIST_INSERT_AFTER.3
38653SLIST_INSERT_HEAD.3
38654SLIST_NEXT.3
38655SLIST_REMOVE.3
38656SLIST_REMOVE_HEAD.3
38657STAILQ_CONCAT.3
38658STAILQ_EMPTY.3
38659STAILQ_ENTRY.3
38660STAILQ_FIRST.3
38661STAILQ_FOREACH.3
38662STAILQ_HEAD.3
38663STAILQ_HEAD_INITIALIZER.3
38664STAILQ_INIT.3
38665STAILQ_INSERT_AFTER.3
38666STAILQ_INSERT_HEAD.3
38667STAILQ_INSERT_TAIL.3
38668STAILQ_NEXT.3
38669STAILQ_REMOVE.3
38670STAILQ_REMOVE_HEAD.3
38671TAILQ_CONCAT.3
38672TAILQ_EMPTY.3
38673TAILQ_FIRST.3
38674TAILQ_FOREACH.3
38675TAILQ_FOREACH_REVERSE.3
38676TAILQ_HEAD_INITIALIZER.3
38677TAILQ_INSERT_BEFORE.3
38678TAILQ_LAST.3
38679TAILQ_NEXT.3
38680TAILQ_PREV.3
38681TAILQ_SWAP.3
38682 Michael Kerrisk
38683 New links to queue.3
38684
38685
38686Global changes
38687--------------
38688
38689Various 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
38697Changes to individual pages
38698---------------------------
38699
38700intro.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
38707locale.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
38720capget.2
38721 Julian Orth
38722 Clarify that hdrp->pid==0 is equivalent gettid() not getpid()
38723
38724chroot.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
38736clock_getres.2
38737 Zeng Linggang
38738 ATTRIBUTES: Note functions that are thread-safe
38739
38740eventfd.2
38741 Zeng Linggang
38742 ATTRIBUTES: Note function that is thread-safe
38743
38744execve.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
38760fallocate.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
38766fcntl.2
38767 Michael Kerrisk
38768 OFD locks are proposed for inclusion in the next POSIX revision
38769
38770getrlimit.2
38771 Zeng Linggang
38772 ATTRIBUTES: Note functions that are thread-safe
38773
38774getrusage.2
38775 Zeng Linggang
38776 ATTRIBUTES: Note function that is thread-safe
38777
38778gettid.2
38779 Michael Kerrisk
38780 Note that for a thread group leader, gettid() == getpid()
38781
38782iopl.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
38787ioprio_set.2
38788 Michael Kerrisk [Jens Axboe]
38789 Document meaning of ioprio==0
38790
38791mlock.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
38797mmap.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
38833mprotect.2
38834 Michael Kerrisk
38835 Note ENOMEM error that can occur when we reach limit on maximum VMAs
38836
38837open.2
38838read.2
38839write.2
38840 Michael Kerrisk [Mike Hayward]
38841 Clarify that O_NONBLOCK is a no-op for regular files and block devices
38842
38843perf_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
38879prctl.2
38880seccomp.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
38889pread.2
38890read.2
38891readv.2
38892sendfile.2
38893write.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
38899pread.2
38900 Michael Kerrisk
38901 Rewrite RETURN VALUE section
38902 (Also drop the text on pwrite() returning zero; that seems bogus.)
38903
38904ptrace.2
38905 Michael Kerrisk [Vegard Nossum]
38906 PTRACE_O_TRACEEXIT clarification
38907
38908readv.2
38909 Michael Kerrisk
38910 Remove BUGS heading
0714d6bf 38911 The text on mixing I/O syscalls and stdio is a general point
4f73df7c
MK
38912 of behavior. It's not a bug as such.
38913
38914recv.2
38915send.2
38916 Michael Kerrisk
38917 Explain some subtleties of MSG_DONTWAIT versus O_NONBLOCK
38918
38919rename.2
38920 Michael Kerrisk
38921 Michael Kerrisk
38922 Note that RENAME_NOREPLACE can't be employed with RENAME_EXCHANGE
38923
38924sched_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
38932sched_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
38939seccomp.2
38940 Michael Kerrisk
38941 SEE ALSO: add bpf(2)
38942
38943send.2
38944 Michael Kerrisk
38945 Expand on subtleties of MSG_NOSIGNAL versus ignoring SIGPIPE
38946
38947sigaltstack.2
38948 Zeng Linggang
38949 ATTRIBUTES: Note function that is thread-safe
38950
38951socket.2
38952 Stephan Mueller
38953 Update documentation reference for AF_ALG
38954
38955truncate.2
38956 Michael Kerrisk
38957 ERRORS: ftruncate() can fail if the file descriptor is not writable
38958
38959utimensat.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
38966clearenv.3
38967 Zeng Linggang
38968 ATTRIBUTES: Note function that is not thread-safe
38969
38970dl_iterate_phdr.3
38971 Zeng Linggang
38972 ATTRIBUTES: Note function that is thread-safe
38973
38974error.3
38975 Zeng Linggang
38976 ATTRIBUTES: Note functions that are/aren't thread-safe
38977
38978fexecve.3
38979 Zeng Linggang
38980 ATTRIBUTES: Note function that is thread-safe
38981
38982fpurge.3
38983 Zeng Linggang
38984 ATTRIBUTES: Note function that is thread-safe
38985
38986fread.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
38994fts.3
38995 Zeng Linggang
38996 ATTRIBUTES: Note functions that are/aren't thread-safe
38997
38998getaddrinfo.3
38999 Zeng Linggang
39000 ATTRIBUTES: Note functions that are thread-safe
39001
39002getaddrinfo_a.3
39003 Zeng Linggang
39004 ATTRIBUTES: Note functions that are thread-safe
39005
39006getauxval.3
39007 Michael Kerrisk
39008 File capabilities also trigger AT_SECURE
39009 Michael Kerrisk
39010 (Briefly) document AT_HWCAP2
39011
39012getgrent_r.3
39013 Zeng Linggang
39014 ATTRIBUTES: Note functions that are/aren't thread-safe
39015
39016gethostbyname.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
39038getifaddrs.3
39039 Zeng Linggang
39040 ATTRIBUTES: Note functions that are thread-safe
39041
39042getnameinfo.3
39043 Zeng Linggang
39044 ATTRIBUTES: Note function that is thread-safe
39045
39046getnetent_r.3
39047 Zeng Linggang
39048 ATTRIBUTES: Note functions that are thread-safe
39049
39050getprotoent.3
39051 Zeng Linggang
39052 ATTRIBUTES: Note functions that aren't thread-safe
39053
39054getprotoent_r.3
39055 Zeng Linggang
39056 ATTRIBUTES: Note functions that are thread-safe
39057
39058getpw.3
39059 Zeng Linggang
39060 ATTRIBUTES: Note function that is thread-safe
39061
39062getpwent_r.3
39063 Zeng Linggang
39064 ATTRIBUTES: Note functions that are/aren't thread-safe
39065
39066getrpcent.3
39067 Zeng Linggang
39068 ATTRIBUTES: Note functions that are/aren't thread-safe
39069
39070getrpcent_r.3
39071 Zeng Linggang
39072 ATTRIBUTES: Note functions that are thread-safe
39073
39074getrpcport.3
39075 Zeng Linggang
39076 ATTRIBUTES: Note function that is thread-safe
39077
39078getservent.3
39079 Zeng Linggang
39080 ATTRIBUTES: Note functions that aren't thread-safe
39081
39082getservent_r.3
39083 Zeng Linggang
39084 ATTRIBUTES: Note functions that are thread-safe
39085
39086gsignal.3
39087 Zeng Linggang
39088 ATTRIBUTES: Note functions that are thread-safe
39089
39090key_setsecret.3
39091 Zeng Linggang
39092 ATTRIBUTES: Note functions that are thread-safe
39093
39094malloc_get_state.3
39095 Zeng Linggang
39096 ATTRIBUTES: Note functions that are thread-safe
39097
39098malloc_info.3
39099 Zeng Linggang
39100 ATTRIBUTES: Note function that is thread-safe
39101
39102malloc_stats.3
39103 Zeng Linggang
39104 ATTRIBUTES: Note function that is thread-safe
39105
39106malloc_trim.3
39107 Zeng Linggang
39108 ATTRIBUTES: Note function that is thread-safe
39109
39110MB_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
39116memcpy.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
39122mq_notify.3
39123 Zeng Linggang
39124 ATTRIBUTES: Note function that is thread-safe
39125
39126perror.3
39127 Michael Kerrisk
39128 Some wording improvements and clarifications
39129
39130profil.3
39131 Zeng Linggang
39132 ATTRIBUTES: Note function that is not thread-safe
39133
39134psignal.3
39135 Zeng Linggang
39136 ATTRIBUTES: Note functions that are thread-safe
39137
39138pthread_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
39144pthread_attr_setaffinity_np.3
39145 Zeng Linggang
39146 ATTRIBUTES: Note functions that are thread-safe
39147
39148pthread_cancel.3
39149 Zeng Linggang
39150 ATTRIBUTES: Note function that is thread-safe
39151
39152pthread_cleanup_push.3
39153 Zeng Linggang
39154 ATTRIBUTES: Note functions that are thread-safe
39155
39156pthread_create.3
39157 Zeng Linggang
39158 ATTRIBUTES: Note function that is thread-safe
39159
39160pthread_detach.3
39161 Zeng Linggang
39162 ATTRIBUTES: Note function that is thread-safe
39163
39164pthread_getattr_np.3
39165 Zeng Linggang
39166 ATTRIBUTES: Note function that is thread-safe
39167
39168pthread_join.3
39169 Zeng Linggang
39170 ATTRIBUTES: Note function that is thread-safe
39171
39172pthread_setname_np.3
39173 Zeng Linggang
39174 ATTRIBUTES: Note functions that are thread-safe
39175
39176pthread_tryjoin_np.3
39177 Zeng Linggang
39178 ATTRIBUTES: Note functions that are thread-safe
39179
39180putgrent.3
39181 Zeng Linggang
39182 ATTRIBUTES: Note function that is thread-safe
39183
39184rcmd.3
39185 Zeng Linggang
39186 ATTRIBUTES: Note functions that are/aren't thread-safe
39187
39188resolver.3
39189 Zeng Linggang
39190 ATTRIBUTES: Note functions that are thread-safe
39191
39192rpc.3
39193 Zeng Linggang
39194 ATTRIBUTES: Note functions that are thread-safe
39195
39196rpmatch.3
39197 Zeng Linggang
39198 ATTRIBUTES: Note function that is thread-safe
39199
39200sem_close.3
39201 Zeng Linggang
39202 ATTRIBUTES: Note function that is thread-safe
39203
39204sem_open.3
39205 Zeng Linggang
39206 ATTRIBUTES: Note function that is thread-safe
39207
39208setaliasent.3
39209 Zeng Linggang
39210 ATTRIBUTES: Note functions that are/aren't thread-safe
39211
39212setlocale.3
39213 Marko Myllynen
39214 Update CONFORMING TO
39215 http://pubs.opengroup.org/onlinepubs/9699919799/functions/setlocale.html
39216
39217setlocale.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
39230shm_open.3
39231 Zeng Linggang
39232 ATTRIBUTES: Note functions that are thread-safe
39233
39234strfmon.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
39251xcrypt.3
39252 Zeng Linggang
39253 ATTRIBUTES: Note functions that are thread-safe
39254
39255xdr.3
39256 Zeng Linggang
39257 ATTRIBUTES: Note functions that are thread-safe
39258
39259console_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
39267null.4
39268 Michael Kerrisk
39269 Note that reads from /dev/zero are interruptible since Linux 2.6.31
39270
39271core.5
39272 Michael Kerrisk
39273 Mention 'coredump_filter' boot option
39274
39275host.conf.5
39276 Michael Kerrisk
39277 Wording fix: s/resolv+/the resolver library/
39278 The term "resolv+" seems to be historical cruft.
39279
39280hosts.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
39318locale.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
39405proc.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
39420repertoiremap.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
39435capabilities.7
39436 Michael Kerrisk
39437 CAP_SYS_ADMIN allows calling bpf(2)
39438
39439locale.7
39440 Marko Myllynen
39441 LC_CTYPE determines transliteration rules on glibc systems
39442
39443packet.7
39444 文剑 [Cortland Setlow]
39445 Fix description of binding a packet socket to an interface
39446
39447pty.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
39464rtld-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
39482sched.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
39487socket.7
39488 Michael Kerrisk
39489 SEE ALSO: add bpf(2)
39490
39491vdso.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
422dc09a
MK
39501
39502
39503==================== Changes in man-pages-4.02 ====================
39504
39505Released: 2015-08-08, Munich
39506
39507
39508Contributors
39509------------
39510
39511The following people contributed patches/fixes or (noted in brackets
39512in the changelog below) reports, notes, and ideas that have been
39513incorporated in changes in this release:
39514
39515Carlos O'Donell <carlos@redhat.com>
39516Daniel Borkmann <daniel@iogearbox.net>
39517David Rientjes <rientjes@google.com>
39518Dilyan Palauzov <dilyan.palauzov@aegee.org>
39519Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
39520Gleb Fotengauer-Malinovskiy <glebfm@altlinux.org>
39521Goswin von Brederlow <goswin-v-b@web.de>
39522Heinrich Schuchardt <xypron.glpk@gmx.de>
39523Jonathan David Amery <jdamery@ysolde.ucam.org>
39524Michael Kerrisk <mtk.manpages@gmail.com>
39525Mike Frysinger <vapier@gentoo.org>
39526Mike Kravetz <mike.kravetz@oracle.com>
39527Nicholas Miell <nmiell@gmail.com>
39528Nikola Forró <nforro@redhat.com>
39529Sam Varshavchik <mrsam@courier-mta.com>
39530Yaarit <yaarit@gmail.com>
39531Zeng Linggang <zenglg.jy@cn.fujitsu.com>
39532
39533Apologies if I missed anyone!
39534
39535
39536New and rewritten pages
39537-----------------------
39538
39539dladdr.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
39548dlerror.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
39558dlinfo.3
39559 Michael Kerrisk
39560 New page describing dlinfo(3)
39561 Zeng Linggang
39562 ATTRIBUTES: Note function that is thread-safe
39563
39564dlopen.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
39594dlsysm.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
39601Newly documented interfaces in existing pages
39602---------------------------------------------
39603
39604dlopen.3
39605 Michael Kerrisk, Carlos O'Donell
39606 Document dlmopen(3)
39607
39608nl_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
39628New and changed links
39629---------------------
39630
39631dladdr1.3
39632 Michael Kerrisk
39633 New link to (new) dladdr(3) page
39634
39635dlmopen.3
39636 Michael Kerrisk
39637 New link to dlopen.3
39638
39639dlvsym.3
39640 Michael Kerrisk
39641 Adjust link to point to new self-contained dlsym(3) page
39642
39643nl_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
39664Global changes
39665--------------
39666
39667Very 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
39673ldd.1
39674sprof.1
39675execve.2
39676dlopen.3
39677ld.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
39685Changes to individual pages
39686---------------------------
39687
39688accept.2
39689 Michael Kerrisk
39690 Add mention of POSIX.1-2008 regarding EAGAIN vs EWOULDBLOCK
39691
39692bpf.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
39704execve.2
39705 Michael Kerrisk
39706 Reword text on POSIX and #!
39707
39708io_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
39716mmap.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
39726seccomp.2
39727 Michael Kerrisk
39728 SEE ALSO: mention libseccomp pages
39729 SEE ALSO: add scmp_sys_resolver(1)
39730
39731sigaction.2
39732 Michael Kerrisk
39733 Correct the list of flags that were added in POSIX.1-2001
39734
39735socketpair.2
39736 Michael Kerrisk [Goswin von Brederlow]
39737 Clarify use of SOCK_* flags in 'type' argument
39738 See http://bugs.debian.org/794217
39739
39740atexit.3
39741 Michael Kerrisk
39742 SEE ALSO: add dlopen(3)
39743
39744clock_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
39750dl_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
39758fseeko.3
39759 Michael Kerrisk
39760 Remove crufty NOTES section
39761 This ancient System V detail is unneeded.
39762
39763getutent.3
39764 Michael Kerrisk
39765 Mention POSIX.1-2008 for the "utmpx" functions
39766
39767iconv_close.3
39768iconv_open.3
39769 Michael Kerrisk
39770 CONFORMING TO: change "UNIX98" to "SUSv2"
39771
39772malloc.3
39773 Michael Kerrisk
98955680 39774 Change "UNIX 98" to "SUSv2"
422dc09a
MK
39775
39776mktemp.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
39783mq_receive.3
39784mq_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
39790nl_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
39800perror.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
39806posix_openpt.3
39807 Michael Kerrisk
39808 Reword text regarding systems that don't have posix_openpt()
39809
39810printf.3
39811 Michael Kerrisk
39812 CONFORMING TO: update details for dprintf() and vdprintf()
39813
39814setlogmask.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
39821shm_open.3
39822 Michael Kerrisk
39823 Add POSIX.1-2008 details regarding group ID of new shared memory object
39824
39825strfmon.3
39826 Michael Kerrisk
39827 Fix erroneous CONFORMING to
39828 strfmon() is in POSIX.1.
39829
39830fanotify.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
39836mq_overview.7
39837 Michael Kerrisk
39838 Remove unneeded CONFORMING TO section
39839
39840nptl.7
39841 Michael Kerrisk [Nicholas Miell]
39842 Note that i386 and x86-64 binaries can't share mutexes
39843
39844sched.7
39845 Nikola Forró
39846 Fix descriptions of sched_get_priority_max() / sched_get_priority_min()
39847
39848sem_overview.7
39849 Michael Kerrisk
39850 Remove unneeded CONFORMING TO section
39851
39852shm_overview.7
39853 Michael Kerrisk
39854 Remove unneeded CONFORMING TO section
39855
39856sigevent.7
39857 Michael Kerrisk
39858 Remove unneeded CONFORMING TO section
39859
39860symlink.7
39861 Michael Kerrisk
39862 Update with POSIX.1-2008 details for link(2)
39863
39864ld.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.
0fa071df
MK
39868
39869
39870==================== Changes in man-pages-4.03 ====================
39871
39872Released: 2015-12-05, Munich
39873
39874
39875Contributors
39876------------
39877
39878The following people contributed patches/fixes or (noted in brackets
39879in the changelog below) reports, notes, and ideas that have been
39880incorporated in changes in this release:
39881
39882Alexander Shishkin <alexander.shishkin@linux.intel.com>
39883Alexei Starovoitov <ast@plumgrid.com>
39884Andy Lutomirski <luto@kernel.org>
39885Arto Bendiken <arto@bendiken.net>
39886Carlos O'Donell <carlos@redhat.com>
39887Casper Ti. Vector <caspervector@gmail.com>
39888Daniel Borkmann <daniel@iogearbox.net>
39889David Drysdale <drysdale@google.com>
39890Eric B Munson <emunson@akamai.com>
39891Florian Weimer <fweimer@redhat.com>
39892Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
39893Heinrich Schuchardt <xypron.glpk@gmx.de>
39894Ingo Molnar <mingo@kernel.org>
39895Jakub Wilk <jwilk@jwilk.net>
39896Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
39897Jonathan Wakely <jwakely@redhat.com>
39898Jonny Grant <jg@jguk.org>
39899Kees Cook <keescook@chromium.org>
39900Maria Guseva <m.guseva@samsung.com>
39901Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
39902Meikun Wang <alikewmk@gmail.com>
39903Michael Kerrisk <mtk.manpages@gmail.com>
39904Michal Hocko <mhocko@suse.com>
39905Mike Frysinger <vapier@gentoo.org>
39906Namhyung Kim <namhyung@gmail.com>
39907Nikola Forró <nforro@redhat.com>
39908Olivier TARTROU <olivier.tartrou@gmail.com>
39909Peter Hurley <peter@hurleysoftware.com>
39910Peter Zijlstra (Intel) <peterz@infradead.org>
39911Ross Zwisler <ross.zwisler@linux.intel.com>
39912Serge Hallyn <serge.hallyn@canonical.com>
39913Silvan Jegen <s.jegen@gmail.com>
39914Stefan Tauner <tauner@technikum-wien.at>
39915Steven Rostedt <rostedt@goodmis.org>
39916Tobias Stoeckmann <tobias@stoeckmann.org>
39917Tycho Andersen <tycho.andersen@canonical.com>
39918Ville Skyttä <ville.skytta@iki.fi>
39919Vince Weaver <vincent.weaver@maine.edu>
39920Zeng Linggang <zenglg.jy@cn.fujitsu.com>
39921
39922Apologies if I missed anyone!
39923
39924
39925Newly documented interfaces in existing pages
39926---------------------------------------------
39927
39928perf_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
39952prctl.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
39969capabilities.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
39976New 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
39988Changes to individual pages
39989---------------------------
39990
39991mremap.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.
39999open.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
40006pipe.2
40007 Michael Kerrisk
40008 SEE ALSO: add splice(2)
40009
40010prctl.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
40018ptrace.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
40028reboot.2
40029 Casper Ti. Vector
40030 1-argument reboot() is also provided by alternative libc
40031
40032seccomp.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
40038signalfd.2
40039 Michael Kerrisk
40040 Describe semantics with respect to SCM_RIGHTS
40041
40042syscalls.2
40043 Michael Kerrisk
40044 Add mlock(2)
40045 Michael Kerrisk
40046 Add userfaultfd()
40047
40048daemon.3
40049 Michael Kerrisk [Johannes Stüttgen]
40050 Note that daemon() is buggy with respect to controlling tty acquisition
40051
40052dirfd.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
40058dlopen.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
40078fgetgrent.3
40079 Zeng Linggang
40080 ATTRIBUTES: Note function that is not thread-safe
40081
40082fgetpwent.3
40083 Zeng Linggang
40084 ATTRIBUTES: Note function that is not thread-safe
40085
40086getauxval.3
40087 Michael Kerrisk
40088 Add some details for AT_SECURE
40089
40090getspnam.3
40091 Zeng Linggang
40092 ATTRIBUTES: Note functions that are/aren't thread-safe
40093
40094mallinfo.3
40095 Zeng Linggang
40096 ATTRIBUTES: Note function that is not thread-safe
40097
40098mallopt.3
40099 Carlos O'Donell
40100 Document M_ARENA_TEST and M_ARENA_MAX
40101
40102posix_fallocate.3
40103 Michael Kerrisk
40104 Clarify text relating to MT-safety
40105 Carlos O'Donell
40106 Mention glibc emulation caveats
40107
40108termios.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
40114tty_ioctl.4
40115 Michael Kerrisk [Peter Hurley]
40116 Note that TIOCTTYGSTRUCT went away in Linux 2.5.67
40117
40118core.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
40128nsswitch.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
40137proc.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
40150aio.7
40151 Michael Kerrisk [Meikun Wang]
40152 Add missing include file, <fcntl.h>, to example program
40153
40154mq_overview.7
40155 Michael Kerrisk [Arto Bendiken]
40156 Document QSIZE bug that appeared in 3.5 and was fixed in 4.2
40157
40158path_resolution.7
40159 Michael Kerrisk
40160 Clarify recursive resolution of symlinks and note limits
40161
40162pipe.7
40163 Michael Kerrisk
40164 SEE ALSO: add splice(2)
40165
40166rtld-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
40176signal.7
40177 Michael Kerrisk [Michael Hocko]
40178 Note async-signal-safe functions added by POSIX.1-2008 TC1
40179
40180tcp.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
40190ld.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
4095230b
MK
40200
40201
40202==================== Changes in man-pages-4.04 ====================
40203
40204Released: 2015-12-29, Munich
40205
40206
40207Contributors
40208------------
40209
40210The following people contributed patches/fixes or (noted in brackets
40211in the changelog below) reports, notes, and ideas that have been
40212incorporated in changes in this release:
40213
40214Alexander Monakov <amonakov@ispras.ru>
40215Andries E. Brouwer <Andries.Brouwer@cwi.nl>
40216Archie Cobbs <archie.cobbs@gmail.com>
40217Carlos O'Donell <carlos@redhat.com>
40218Colin Rice <colin@daedrum.net>
40219Darren Hart <dvhart@infradead.org>
40220Davidlohr Bueso <dave@stgolabs.net>
40221Dmitry V. Levin <ldv@altlinux.org>
40222Eric B Munson <emunson@akamai.com>
40223Heinrich Schuchardt <xypron.glpk@gmx.de>
40224H.J. Lu <hjl.tools@gmail.com>
40225Jakub Wilk <jwilk@jwilk.net>
40226Jonathan Wakely <jwakely@redhat.com>
40227Jonny Grant <jg@jguk.org>
40228Laurent Georget <laurent.georget@supelec.fr>
40229Lennart Poettering <lennart@poettering.net>
40230Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
40231Michael Kerrisk <mtk.manpages@gmail.com>
40232Michal Hocko <mhocko@suse.com>
40233Mike Frysinger <vapier@gentoo.org>
40234Pádraig Brady <P@draigBrady.com>
40235Paul Eggert <eggert@cs.ucla.edu>
40236Pavel Machek <pavel@ucw.cz>
40237Phil Blundell <pb@pbcl.net>
40238Richard Voigt <richardvoigt@gmail.com>
40239Rich Felker <dalias@libc.org>
40240Rusty Russell <rusty@rustcorp.com.au>
40241Thomas Gleixner <tglx@linutronix.de>
40242Tom Gundersen <teg@jklm.no>
40243Torvald Riegel <triegel@redhat.com>
40244Vincent Lefevre <vincent@vinc17.net>
40245Vlastimil Babka <vbabka@suse.cz>
40246Walter Harms <wharms@bfs.de>
40247Zack Weinberg <zackw@panix.com>
40248
40249
40250Apologies if I missed anyone!
40251
40252
40253New and rewritten pages
40254-----------------------
40255
40256futex.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
40260membarrier.2
40261 Mathieu Desnoyers [Michael Kerrisk]
40262 New page documenting membarrier() system call
40263
40264
40265Newly documented interfaces in existing pages
40266---------------------------------------------
40267
40268mlock.2
40269 Eric B Munson [Michal Hocko, Vlastimil Babka, Michael Kerrisk]
40270 Document mlock2(2) and MCL_ONFAULT
40271
40272
40273New and changed links
40274---------------------
40275
40276mlock2.2
40277 Eric B Munson
40278 New link to mlock.2
40279
40280
40281Global changes
40282--------------
40283
40284Various pages
40285 Michael Kerrisk
40286 ERRORS: standardize text for EMFILE error
40287
40288Various pages
40289 Michael Kerrisk
40290 ERRORS: standardize error text for ENOTSOCK error
40291
40292Various pages
40293 Michael Kerrisk
40294 ERRORS: standardize text for ENFILE error
40295
40296
40297Changes to individual pages
40298---------------------------
40299
40300clock_getres.2
40301 Michael Kerrisk
40302 SEE ALSO: add vdso(7)
40303
40304epoll_create.2
40305 Michael Kerrisk
40306 ERRORS: add another EMFILE error case
40307
40308fanotify_init.2
40309 Michael Kerrisk
40310 ERRORS: add an EMFILE error case
40311
40312fork.2
40313 Michael Kerrisk
40314 Child of MT-process is restricted to async-signal-safe functions
40315
40316getcpu.2
40317 Michael Kerrisk
40318 SEE ALSO: add vdso(7)
40319
40320getrlimit.2
40321 Michael Kerrisk [Lennart Poettering]
40322 The init of measurement for RLIMIT_RSS is bytes, not pages
40323
40324get_robust_list.2
40325 Michael Kerrisk
40326 Reword EINVAL error text
40327
40328gettimeofday.2
40329 Carlos O'Donell
40330 Expand on the historical meaning of tz_dsttime
40331 Michael Kerrisk
40332 SEE ALSO: add vdso(7)
40333
40334inotify_init.2
40335 Michael Kerrisk
40336 ERRORS: add an EMFILE error case
40337
40338personality.2
40339 Dmitry V. Levin
40340 Note kernel and glibc versions that introduced this system call
40341
40342poll.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
40351sendfile.2
40352 Laurent Georget
40353 Document more ERRORS
40354
40355sigreturn.2
40356 Michael Kerrisk
40357 SEE ALSO: add vdso(7)
40358
40359socketcall.2
40360 Michael Kerrisk
40361 Since Linux 4.3, x86-32 provides direct system calls for the sockets API
40362
40363time.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
40375dlerror.3
40376 Michael Kerrisk [Jonny Grant]
40377 Clarify that the string returned by dlerror() is null terminated
40378
40379dlopen.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
40385drand48.3
40386 Michael Kerrisk [Vincent Lefevre]
40387 Correct descriptions of ranges returned by these functions
40388 See http://bugs.debian.org/803459
40389
40390errno.3
40391 Michael Kerrisk
40392 Note probable cause of ENFILE error
40393
40394fnmatch.3
40395 Pádraig Brady
40396 Describe the FNM_EXTMATCH flag and pattern syntax
40397
40398iconv.3
40399 Andries E. Brouwer
40400 NOTES: describe correct usage for flushing partially buffered input
40401
40402random_r.3
40403 Michael Kerrisk [Archie Cobbs]
40404 Clarify need to use initstate_r()
40405
40406tzset.3
40407 Carlos O'Donell
40408 Clarify "daylight" and remove erroneous note
40409
40410random.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
40416proc.5
40417 Michael Kerrisk
40418 Reaching /proc/sys/fs/file-max limit normally produces an ENFILE error
40419
40420futex.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
40430vdso.7
40431 Michael Kerrisk
40432 Add note on strace(1) and vDSO
40433
40434ld.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
c02022ee
MK
40445
40446
40447==================== Changes in man-pages-4.05 ====================
40448
40449Released: 2016-03-15, Christchurch
40450
40451
40452Contributors
40453------------
40454
40455The following people contributed patches/fixes or (noted in brackets
40456in the changelog below) reports, notes, and ideas that have been
40457incorporated in changes in this release:
40458
40459Adhemerval Zanella <adhemerval.zanella@linaro.org>
40460Akihiro Suda <suda.kyoto@gmail.com>
40461Alan Aversa <alan.aversa@cox.net>
40462Alan Cox <etchedpixels@gmail.com>
40463Alec Leamas <leamas.alec@gmail.com>
40464Alex Henrie <alexhenrie24@gmail.com>
40465Alexander Miller <alex.miller@gmx.de>
40466Andreas Gruenbacher <agruenba@redhat.com>
40467Andreas Schwab <schwab@suse.de>
40468Anna Schumaker <Anna.Schumaker@Netapp.com>
40469Askar Safin <safinaskar@mail.ru>
40470Bill O. Gallmeister <bgallmeister@gmail.com>
40471Carlos O'Donell <carlos@redhat.com>
40472Chris Pick <kernel@chrispick.com>
40473Christoph Hellwig <hch@infradead.org>
40474Craig Gallek <kraig@google.com>
40475Darrick J. Wong <darrick.wong@oracle.com>
40476Davidlohr Bueso <dave@stgolabs.net>
40477Dmitry V. Levin <ldv@altlinux.org>
40478Dr. Tobias Quathamer <toddy@debian.org>
40479Eric Blake <eblake@redhat.com>
40480Eric Dumazet <edumazet@google.com>
40481Florian Weimer <fweimer@redhat.com>
40482Gabriel Corona <gabriel.corona@enst-bretagne.fr>
40483Heinrich Schuchardt <xypron.glpk@gmx.de>
40484Ivan Shapovalov <intelfx@intelfx.name>
40485Jakub Wilk <jwilk@jwilk.net>
40486Jason Baron <jbaron@akamai.com>
40487Jason Vas Dias <jason.vas.dias@gmail.com>
40488Jérémie Galarneau <jeremie.galarneau@efficios.com>
40489Jeremy Harris <jeharris@redhat.com>
40490Joachim Wuttke <j.wuttke@fz-juelich.de>
40491Joe Stein <joeaarons@gmail.com>
40492John Stultz <john.stultz@linaro.org>
40493Josh Triplett <josh@joshtriplett.org>
40494Kondo, Naoya <kondo-naoya@jp.fujitsu.com>
40495Krzysztof Adamski <k@japko.eu>
40496Manfred Spraul <manfred@colorfullife.com>
40497Marianne CHEVROT <blackmoor@openmailbox.org>
40498Marko Myllynen <myllynen@redhat.com>
40499Mark Post <mpost@suse.com>
40500Martin Gebert <Murphy.Gebert@gmx.de>
40501Mats Wichmann <mats@linuxfoundation.org>
40502Matt Zimmerman <mdz@debian.org>
40503Michael Kerrisk <mtk.manpages@gmail.com>`
40504Mike Frysinger <vapier@gentoo.org>
40505Minchan Kim <minchan@kernel.org>
40506Naoya Kondo <kondo-naoya@jp.fujitsu.com>
40507Naresh Kamboju <naresh.kernel@gmail.com>
40508Nikola Forró <nforro@redhat.com>
40509Nikos Mavrogiannopoulos <nmav@gnutls.org>
40510Orion Poplawski <orion@cora.nwra.com>
40511Pakin Yury <zxwarior@yandex.ru>
40512Patrick Donnelly <batrick@batbytes.com>
40513Paul Eggert <eggert@cs.ucla.edu>
40514Paul Pluzhnikov <ppluzhnikov@google.com>
40515Peter Hurley <peter@hurleysoftware.com>
40516Peter Wu <peter@lekensteyn.nl>
40517Petr Gajdos <pgajdos@suse.cz>
40518Philip Semanchuk <linux_kernel.20.ick@spamgourmet.com>
40519Rasmus Villemoes <Rasmus.Villemoes@decode.is>
40520Rich Felker <dalias@aerifal.cx>
40521Simon Que <sque@chromium.org>
40522Stephan Bergmann <sbergman@redhat.com>
40523Stéphane Aulery <lkppo@free.fr>
40524Stephen Hurd <shurd@sasktel.net>
40525Vincent Bernat <bernat@luffy.cx>
40526William Preston <wpreston@suse.de>
40527Yuri Kozlov <yuray@komyakino.ru>
40528Zefram <zefram@fysh.org>
40529
40530Apologies if I missed anyone!
40531
40532
40533New and rewritten pages
40534-----------------------
40535
40536copy_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
40544personality.2
40545 Michael Kerrisk
40546 This page has been greatly expanded, to add descriptions of
40547 personality domains.
40548
40549fmemopen.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
40559ntp_gettime.3
40560 Michael Kerrisk
40561 New page describing ntp_gettime(3) and ntp_gettimex(3)
40562
40563open_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
40568posix_spawn.3
40569 Bill O. Gallmeister, Michael Kerrisk
40570 New man page documenting posix_spawn(3) and posix_spawnp(3)
40571
40572readdir.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
40586readdir_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
40594lirc.4
40595 Alec Leamas
40596 New page documenting lirc device driver
40597
40598
40599Newly documented interfaces in existing pages
40600---------------------------------------------
40601
40602adjtimex.2
40603 Michael Kerrisk
40604 Document ntp_adjtime(3)
40605
40606epoll_ctl.2
40607 Michael Kerrisk [Jason Baron]
40608 Document EPOLLEXCLUSIVE
40609
40610madvise.2
40611 Minchan Kim [Michael Kerrisk]
40612 Document MADV_FREE
40613 Document the MADV_FREE flag added to madvise() in Linux 4.5.
40614
40615proc.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
40633socket.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
40648New and changed links
40649---------------------
40650
40651isalpha_l.3
40652 Michael Kerrisk
40653 New link to isalpha.3
40654
40655longjmp.3
40656 Michael Kerrisk
40657 Replace page with link to setjmp(3), which now incorporates longjmp()
40658
40659ntp_adjtime.3
40660 Michael Kerrisk
40661 New link to adjtimex(2)
40662
40663ntp_gettimex.3
40664 Michael Kerrisk
40665 New link to ntp_gettime.3
40666
40667open_wmemstream.3
40668 Michael Kerrisk
40669 Update link to point to new open_memstream(2) page
40670
40671posix_spawnp.3
40672 Michael Kerrisk
40673 New link to new posix_spawn.3 page
40674
40675siglongjmp.3
40676 Michael Kerrisk
40677 Rewire link to point to setjmp(3)
40678
40679strerror_l.3
40680 Michael Kerrisk
40681 New link to strerror.3
40682 Fix missing link
40683
40684
40685Global changes
40686--------------
40687
40688Various 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
40696Various 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
40710Various 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
40724Various 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
40730Various 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
40741Various 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
40755Various 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
40778Various 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
40789Various 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
40796Various pages
40797 Michael Kerrisk
40798 Wording fix: "current file offset" ==> "file offset"
40799 "File offset" is the preferred POSIX terminology.
40800
40801Various pages
40802 Michael Kerrisk
40803 Word "descriptor" more precisely
589bae9d 40804 Use either "file descriptor" or "message queue descriptor".
c02022ee
MK
40805
40806Various pages
40807 Michael Kerrisk
40808 ERRORS: add reference to signal(7) in description of EINTR
40809
40810
40811Changes to individual pages
40812---------------------------
40813
40814locale.1
40815 Marko Myllynen
40816 Add "locale -c charmap" as an example
40817 Addresses https://bugzilla.kernel.org/show_bug.cgi?id=104511.
40818
40819localedef.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
40827accept.2
40828 Michael Kerrisk
40829 ERRORS: improve description for EBADF
40830
40831adjtimex.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
40859bdflush.2
40860 Michael Kerrisk
40861 Note that glibc support for this system call went away in version 2.23
40862
40863bind.2
40864 Michael Kerrisk
40865 Improve description of ENOENT error
40866
40867bpf.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
40873chmod.2
40874 Michael Kerrisk
40875 Clarify terminology (file mode versus file permission bits)
40876
40877chown.2
40878 Michael Kerrisk
40879 ERRORS: improve EBADF description
40880
40881clone.2
40882unshare.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
40889connect.2
40890 Michael Kerrisk
40891 ERRORS: improve EBADF description
40892
40893create_module.2
40894 Michael Kerrisk
40895 Glibc 2.23 removed last vestiges of support for this system call
40896
40897delete_module.2
40898 Michael Kerrisk
40899 Glibc 2.23 removed last vestiges of support for this system call
40900
40901epoll_ctl.2
40902 Michael Kerrisk
40903 Document ELOOP error for circular monitoring loops
40904
40905eventfd.2
40906 Michael Kerrisk
40907 Note that eventfd info is available in /proc/PID/fdinfo
40908
40909execve.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
40917fanotify_init.2
40918 Michael Kerrisk
40919 Note kernel version that allowed O_CLOEXEC for event_f_flags
40920
40921fcntl.2
40922flock.2
40923 Michael Kerrisk
40924 SEE ALSO: add lslocks(8)
40925
40926fcntl.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
40937futex.2
40938 Michael Kerrisk
40939 FUTEX_CLOCK_REALTIME can now be used with FUTEX_WAIT
40940
40941get_kernel_syms.2
40942 Michael Kerrisk
b155912e 40943 Note that glibc does not support this system call
c02022ee
MK
40944
40945init_module.2
40946 Michael Kerrisk
40947 Glibc 2.23 removed last vestiges of support for this system call
40948
40949ioctl_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
40964ioperm.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
40969iopl.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
40974lseek.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
40983madvise.2
40984 Michael Kerrisk
40985 Clarify MADV_HWPOISON wording to say that it applies to a page range
40986
40987mknod.2
40988 Michael Kerrisk
40989 SEE ALSO: add mknod(1)
40990
40991mount.2
40992 Michael Kerrisk
40993 SEE ALSO: add findmnt(8)
40994
40995open.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
41001pipe.2
41002 Michael Kerrisk [Eric Blake]
41003 Note treatment of 'pipefd' on error
41004
41005poll.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
41010readlink.2
41011 Michael Kerrisk
41012 Clarify EINVAL error description
41013
41014recv.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
41022recv.2
41023cmsg.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
41034sched_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
41040sched_setattr.2
41041 Michael Kerrisk [Akihiro Suda]
41042 EPERM depends on affinity mask of target thread, not calling thread
41043
41044select.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
41059select_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
b155912e 41065 Simplify 'if' logic in example program
c02022ee
MK
41066 Michael Kerrisk
41067 Use correct type (socklen_t) for addrlen
41068
41069semctl.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
41077semop.2
41078 Michael Kerrisk
41079 Tweak comment describing 'sempid'
41080
41081sendfile.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
41087setpgid.2
41088 Michael Kerrisk
41089 Correct/simplify FTM requirements for BSD setpgrp() and getpgrp()
41090
41091signalfd.2
41092 Michael Kerrisk
41093 Note that signalfd info is available in /proc/PID/fdinfo
41094
41095sigprocmask.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
41102socketpair.2
41103 Michael Kerrisk [Eric Blake]
41104 Note treatment of 'sv' on error
41105
41106splice.2
41107 Askar Safin
41108 Improve description of 0 return value.
41109 See https://bugzilla.kernel.org/show_bug.cgi?id=90911
41110
41111statfs.2
41112 Michael Kerrisk [Jakub Wilk]
41113 Use consistent case for hex constants
41114
41115sync.2
41116 Christoph Hellwig
41117 Clarify description and document the Linux data integrity guarantees
41118
41119syscall.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
41130syscalls.2
41131 Michael Kerrisk
41132 Add copy_file_range(2)
41133
41134times.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
41142truncate.2
41143 Michael Kerrisk
41144 SEE ALSO: add truncate(1)
41145
41146uselib.2
41147 Michael Kerrisk
41148 Mention CONFIG_USELIB
41149 Michael Kerrisk
41150 Note that glibc does not support this (obsolete) system call
41151
41152wait.2
41153wait4.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
41164backtrace.3
41165 Michael Kerrisk [Martin Gebert]
41166 Small fixes to example program
41167
41168clearenv.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
41175clog10.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
41182dl_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
41190errno.3
41191 Michael Kerrisk
41192 Add some explanation of ENOENT error
41193
41194exec.3
41195 Michael Kerrisk
41196 SEE ALSO: add system(3)
41197
41198exp.3
41199 Michael Kerrisk [Joachim Wuttke]
41200 SEE ALSO: add expm1(3)
41201
41202fopen.3
41203 Michael Kerrisk
41204 SEE ALSO: add open_memstream(3)
41205
41206fts.3
41207 Michael Kerrisk
41208 BUGS: glibc-2.23 now has LFS support for the fts functions
41209
41210gamma.3
41211 Michael Kerrisk [Alan Cox]
41212 gamma() was documented in SVID 2
41213
41214getaddrinfo.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
41220getcwd.3
41221 Michael Kerrisk
41222 SEE ALSO: add pwd(1)
41223
41224opendir.3
41225 Michael Kerrisk
41226 Help the reader by explicitly mentioning the use of readdir(3)
41227
41228perror.3
41229 Michael Kerrisk
41230 Suggest use of strerror(3) in place of deprecated 'sys_errlist'
41231
41232posix_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
41240posix_memalign.3
41241 Michael Kerrisk [Eric Blake]
41242 Note posix_memalign()'s treatment of 'memptr' on error
41243
41244pthread_setaffinity_np.3
41245 Michael Kerrisk
41246 SEE ALSO: add CPU_SET(3)
41247
41248queue.3
41249 Dr. Tobias Quathamer
41250 Remove double CONFORMING TO section
41251
41252rcmd.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
41260setbuf.3
41261 Michael Kerrisk
41262 SEE ALSO: add stdbuf(1)
41263
41264setjmp.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
41282sleep.3
41283 Michael Kerrisk
41284 SEE ALSO: add sleep(1)
41285
41286strftime.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
41291strlen.3
41292 Michael Kerrisk [Alan Aversa]
41293 CONFORMING TO: add C11
41294
41295system.3
41296 Michael Kerrisk
41297 SEE ALSO: add execve(2)
41298
41299termios.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
41309timegm.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
41320st4.4
41321 Dr. Tobias Quathamer
41322 Remove spurious copyright section
41323
41324tty_ioctl.4
41325 Michael Kerrisk
41326 SEE ALSO: add ldattach(1)
41327
41328elf.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
41340gai.conf.5
41341 Michael Kerrisk
41342 Add VERSIONS section
41343
41344group.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
41352locale.5
41353 Marko Myllynen [Mike Frysinger]
41354 tel + fax are deprecated
41355
41356nsswitch.conf.5
41357 Nikola Forró
41358 Update NSS compatibility mode description
41359
41360utmp.5
41361 Michael Kerrisk
41362 SEE ALSO: add lslogins(1)
41363
41364aio.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
41372capabilities.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
41379credentials.7
41380 Michael Kerrisk
41381 SEE ALSO: add groups(2)
41382
41383environ.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
41393epoll.7
41394 Michael Kerrisk
41395 Mention that epoll info is available via /proc/PID/fdinfo
41396
41397fanotify.7
41398 Michael Kerrisk
41399 Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
41400
41401
41402feature_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
41424inotify.7
41425 Michael Kerrisk
41426 Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
41427
41428ip.7
41429 Eric Dumazet
41430 Document IP_BIND_ADDRESS_NO_PORT socket option
41431
41432mq_overview.7
41433 Michael Kerrisk
41434 Note that the close-on-exec flag is automatically set on MQ descriptors
41435
41436namespaces.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
41442pipe.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
41448signal.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
41453socket.7
41454 Michael Kerrisk
41455 SEE ALSO: add pcap(3)
41456 SEE ALSO: add wireshark(1) and tcpdump(8)
41457
41458standards.7
41459 Michael Kerrisk
41460 Add POSIX.1-2008 TC2 (POSIX.1-2016)
41461
41462svipc.7
41463 Michael Kerrisk
41464 Tweak description of 'sempid'
41465 Michael Kerrisk
41466 SEE ALSO: add lsipc(1)
41467
41468symlink.7
41469 Michael Kerrisk [Zefram]
41470 Some "magic" symlinks have permissions other than 0777
41471 See https://bugs.debian.org/743525
41472
41473time.7
41474 Michael Kerrisk
41475 SEE ALSO: add timeout(1)
41476 SEE ALSO: add ntp_adjtime(3) and ntp_gettime(3)
41477
41478unicode.7
41479 Dr. Tobias Quathamer
41480 Document private use areas
41481 See https://bugs.debian.org/285444
41482
41483unix.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
5290e865
MK
41492
41493
41494==================== Changes in man-pages-4.06 ====================
41495
41496Released: 2016-05-09, Oslo
41497
41498
41499Contributors
41500------------
41501
41502The following people contributed patches/fixes or (noted in brackets
41503in the changelog below) reports, notes, and ideas that have been
41504incorporated in changes in this release:
41505
41506Alexander Miller <alex.miller@gmx.de>
41507Alon Bar-Lev <alon.barlev@gmail.com>
41508Benjamin Poirier <bpoirier@suse.com>
41509Christoph Hellwig <hch@lst.de>
41510Colin Ian King <colin.king@canonical.com>
41511Dr. Tobias Quathamer <toddy@debian.org>
41512Ed Avis <eda@waniasset.com>
41513Georg Sauthoff <gsauthof@techfak.uni-bielefeld.de>
41514Heinrich Schuchardt <xypron.glpk@gmx.de>
41515Jakub Wilk <jwilk@jwilk.net>
41516Jordan Birks <birkses@hotmail.com>
41517Marko Myllynen <myllynen@redhat.com>
41518Michael Kerrisk <mtk.manpages@gmail.com>
41519Mike Frysinger <vapier@gentoo.org>
41520Nikola Forró <nforro@redhat.com>
41521Rasmus Villemoes <linux@rasmusvillemoes.dk>
41522Serge E. Hallyn <serge@hallyn.com>
41523Serge Hallyn <serge.hallyn@ubuntu.com>
41524Valery Reznic <valery_reznic@yahoo.com>
41525Zubair Lutfullah Kakakhel <Zubair.Kakakhel@imgtec.com>
41526
41527Apologies if I missed anyone!
41528
41529
41530New and rewritten pages
41531-----------------------
41532
41533cgroups.7
00efa082 41534 Serge Hallyn, Michael Kerrisk
5290e865
MK
41535 New page documenting cgroups
41536
41537cgroup_namespaces.7
41538 Michael Kerrisk [Serge Hallyn]
41539 New page describing cgroup namespaces
41540
41541
41542Newly documented interfaces in existing pages
41543---------------------------------------------
41544
41545clone.2
41546 Michael Kerrisk
41547 Document CLONE_NEWCGROUP
41548
28a69f90
MK
41549readv.2
41550 Christoph Hellwig
41551 Document preadv2() and pwritev2()
5290e865
MK
41552setns.2
41553 Michael Kerrisk
41554 Document CLONE_NEWCGROUP
41555
41556unshare.2
41557 Michael Kerrisk
41558 Document CLONE_NEWCGROUP
41559
41560
41561Changes to individual pages
41562---------------------------
41563
41564clock_getres.2
41565 Michael Kerrisk [Rasmus Villemoes]
41566 Note that coarse clocks need architecture and VDSO support
41567
41568clone.2
41569fork.2
41570 Nikola Forró
41571 Document ERESTARTNOINTR error code
41572
41573clone.2
41574 Michael Kerrisk [Colin Ian King]
41575 ERRORS: add EINVAL for improperly aligned 'child_stack' value
41576
41577execve.2
41578 Michael Kerrisk [Valery Reznic]
41579 Since Linux 2.6.28, recursive script interpretation is supported
41580
41581fcntl.2
41582 Michael Kerrisk
41583 Note that mandatory locking is now governed by a configuration option
41584
41585fsync.2
41586 Michael Kerrisk [Georg Sauthoff]
41587 Give some examples of files where sync can fail with EINVAL
41588
41589getrlimit.2
41590 Michael Kerrisk
41591 SEE ALSO: add cgroups(7)
41592
41593ioctl_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
41598ioprio_set.2
41599 Michael Kerrisk
41600 SEE ALSO: add cgroups(7)
41601
41602lseek.2
41603 Michael Kerrisk
41604 Note that 'off_t' is an integer data type defined by POSIX
41605
41606memfd_create.2
41607 Michael Kerrisk
41608 Note that memfd_create() does not have a glibc wrapper
41609
41610mount.2
41611 Michael Kerrisk
41612 MS_MANDLOCK requires CAP_SYS_ADMIN (since Linux 4.5)
41613
41614quotactl.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
41625readv.2
5290e865
MK
41626 Michael Kerrisk
41627 Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
41628
41629semctl.2
41630 Michael Kerrisk
41631 From kernel 4.6, Linux now updates 'sempid' on SETALL operations
41632
41633sigaction.2
41634 Michael Kerrisk
41635 Document SEGV_BNDERR
41636 Michael Kerrisk
41637 Document SEGV_PKUERR
41638
41639syscalls.2
41640 Michael Kerrisk
41641 Add preadv2() and pwritev2()
41642
41643write.2
41644 Michael Kerrisk
41645 Clarify that 'size_t' and 'ssize_t' are integer types specified in POSIX
41646
41647makedev.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
41662popen.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
41669strtod.3
41670 Michael Kerrisk [Ed Avis]
41671 Improve a detail in RETURN VALUE
41672
41673core.5
41674 Michael Kerrisk
41675 Document /proc/sys/kernel/core_pipe_limit
41676
41677locale.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
41696nsswitch.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
41703proc.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
41715cpuset.7
41716 Michael Kerrisk
41717 SEE ALSO: add cgroups(7)
41718
41719ip.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
5290e865 41730namespaces.7
5290e865
MK
41731 Michael Kerrisk
41732 SEE ALSO: add cgroups(7), cgroup_namespaces(7)
41733
41734vdso.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
41744ld.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.
e4e23158
MK
41748
41749
41750==================== Changes in man-pages-4.07 ====================
41751
41752Released: 2016-07-17, Ulm
41753
41754
41755Contributors
41756------------
41757
41758The following people contributed patches/fixes or (noted in brackets
41759in the changelog below) reports, notes, and ideas that have been
41760incorporated in changes in this release:
41761
41762Alec Leamas <leamas.alec@gmail.com>
41763Andrey Vagin <avagin@openvz.org>
41764Andy Lutomirski <luto@amacapital.net>
41765Carsten Grohmann <carstengrohmann@gmx.de>
41766Chris Gassib <position0x45@hotmail.com>
41767Christoph Hellwig <hch@lst.de>
41768Darren Hart <dvhart@infradead.org>
41769Darrick J. Wong <darrick.wong@oracle.com>
41770Élie Bouttier <elie@bouttier.eu>
41771Eric Biggers <ebiggers3@gmail.com>
41772Eric W. Biederman <ebiederm@xmission.com>
41773Florian Weimer <fweimer@redhat.com>
41774Håkon Sandsmark <hsandsma@cisco.com>
41775Iustin Pop <iustin@k1024.org>
41776Jacob Willoughby <jacob@spacemonkey.com>
41777Jakub Wilk <jwilk@jwilk.net>
41778James H Cownie <james.h.cownie@intel.com>
41779Jann Horn <jann@thejh.net>
41780John Wiersba <jrw32982@yahoo.com>
41781Jörn Engel <joern@purestorage.com>
41782Josh Triplett <josh@kernel.org>
41783Kai Mäkisara <kai.makisara@kolumbus.fi>
41784Kees Cook <keescook@chromium.org>
41785Keno Fischer <keno@juliacomputing.com>
41786Li Peng <lip@dtdream.com>
41787Marko Kevac <marko@kevac.org>
41788Marko Myllynen <myllynen@redhat.com>
41789Michael Kerrisk <mtk.manpages@gmail.com>
41790Michał Zegan <webczat_200@poczta.onet.pl>
41791Miklos Szeredi <mszeredi@redhat.com>
41792Mitch Walker <mitch@gearnine.com>
41793Neven Sajko <nsajko@gmail.com>
41794Nikos Mavrogiannopoulos <nmav@redhat.com>
41795Omar Sandoval <osandov@fb.com>
41796Ori Avtalion <ori@avtalion.name>
41797Rahul Bedarkar <rahulbedarkar89@gmail.com>
41798Robin Kuzmin <kuzmin.robin@gmail.com>
41799Rob Landley <rob@landley.net>
41800Shawn Landden <shawn@churchofgit.com>
41801Stefan Puiu <stefan.puiu@gmail.com>
41802Stephen Smalley <sds@tycho.nsa.gov>
41803Szabolcs Nagy <szabolcs.nagy@arm.com>
41804Thomas Gleixner <tglx@linutronix.de>
41805Tobias Stoeckmann <tobias@stoeckmann.org>
41806Tom Callaway <tcallawa@redhat.com>
41807Tom Gundersen <teg@jklm.no>
41808Vince Weaver <vincent.weaver@maine.edu>
41809W. Trevor King <wking@tremily.us>
41810"Yuming Ma(马玉明)" <mayuming@le.com>
41811
41812Apologies if I missed anyone!
41813
41814
41815New and rewritten pages
41816-----------------------
41817
41818ioctl_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
41824ioctl_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
41830nextup.3
41831 Michael Kerrisk
41832 New page documenting nextup(), nextdown(), and related functions
41833
41834mount_namespaces.7
41835 Michael Kerrisk [Michael Kerrisk]
41836 New page describing mount namespaces
41837
41838
41839Newly documented interfaces in existing pages
41840---------------------------------------------
41841
41842mount.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
41849ptrace.2
41850 Michael Kerrisk [Kees Cook, Jann Horn, Eric W. Biederman, Stephen Smalley]
41851 Document ptrace access modes
41852
41853proc.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
41864New and changed links
41865---------------------
41866
23838225
MK
41867preadv2.2
41868pwritev2.2
41869 Michael Kerrisk
41870 New links to readv(2)
41871
e4e23158
MK
41872nextdown.3
41873nextdownf.3
41874nextdownl.3
41875nextupf.3
41876nextupl.3
41877 Michael Kerrisk
41878 New links to nextup(3)
41879
41880
41881Changes to individual pages
41882---------------------------
41883
41884ldd.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
41890localedef.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
41898add_key.2
41899 Mitch Walker
41900 Empty payloads are not allowed in user-defined keys
41901
41902chroot.2
41903 Michael Kerrisk
41904 SEE ALSO: add pivot_root(2)
41905
41906clone.2
41907 Michael Kerrisk
41908 Add reference to mount_namespaces(7) under CLONE_NEWNS description
41909
41910fork.2
41911 Michael Kerrisk
41912 Add ENOMEM error for PID namespace where "init" has died
41913
41914futex.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
41937getitimer.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
41957get_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
41964getpriority.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
41975get_robust_list.2
41976 Michael Kerrisk
41977 get_robust_list() is governed by PTRACE_MODE_READ_REALCREDS
41978
41979ioctl.2
41980 Michael Kerrisk
41981 SEE ALSO: add ioctl_fideduperange(2) and ioctl_ficlonerange(2)
41982
41983kcmp.2
41984 Michael Kerrisk
41985 kcmp() is governed by PTRACE_MODE_READ_REALCREDS
41986 Shawn Landden
41987 Note about SECURITY_YAMA
41988kill.2
41989 Michael Kerrisk [John Wiersba]
41990 Clarify the meaning if sig==0
41991
41992lookup_dcookie.2
41993 Michael Kerrisk
41994 SEE ALSO: add oprofile(1)
41995
41996mmap.2
41997 Michael Kerrisk [Rahul Bedarkar]
41998 EXAMPLE: for completeness, add munmap() and close() calls
41999
42000mount.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
42052open.2
42053 Eric Biggers
42054 Refer to correct functions in description of O_TMPFILE
42055
42056pciconfig_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
42064perf_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
42077prctl.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
e4e23158
MK
42085process_vm_readv.2
42086 Michael Kerrisk
42087 Rephrase permission rules in terms of a ptrace access mode check
42088
42089ptrace.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
e4e23158
MK
42101quotactl.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
42109recv.2
42110 Michael Kerrisk [Tom Gundersen]
42111 With pending 0-length datagram read() and recv() with flags == 0 differ
42112
42113setfsgid.2
42114setfsuid.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
42122sysinfo.2
42123 Michael Kerrisk
42124 Rewrite and update various pieces
42125
42126umask.2
42127 Michael Kerrisk
42128 NOTES: Mention /proc/PID/status 'Umask' field
42129
42130umount.2
42131 Michael Kerrisk
42132 SEE ALSO: add mount_namespaces(7)
42133
42134unshare.2
42135 Michael Kerrisk
42136 Add reference to mount_namespaces(7) under CLONE_NEWNS description
42137
42138utimensat.2
42139 Michael Kerrisk [Rob Landley]
42140 Note that the glibc wrapper disallows pathname==NULL
42141
42142wait.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
42148assert.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
42159fmax.3
42160fmin.3
42161 Michael Kerrisk
42162 SEE ALSO: add fdim(3)
42163
42164getauxval.3
42165 Cownie, James H
42166 Correct AT_HWCAP result description
42167
42168inet_pton.3
42169 Stefan Puiu
42170 Mention byte order
e4e23158
MK
42171
42172malloc_hook.3
42173 Michael Kerrisk
42174 glibc 2.24 removes __malloc_initialize_hook
42175
42176memmem.3
42177 Michael Kerrisk [Shawn Landden]
42178 Note that memmem() is present on some other systems
42179
42180mkdtemp.3
42181mktemp.3
42182 Michael Kerrisk
42183 SEE ALSO: add mktemp(1)
42184
42185printf.3
42186 Michael Kerrisk [Shawn Landden]
42187 Note support in other C libraries for %m and %n
42188
42189strcasecmp.3
42190 Michael Kerrisk [Ori Avtalion]
42191 Make details of strncasecmp() comparison clearer
42192
42193strcat.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
42199strtoul.3
42200 Michael Kerrisk
42201 SEE ALSO: add a64l(3)
42202
42203strxfrm.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
42211console_codes.4
42212console_ioctl.4
42213tty.4
42214vcs.4
42215charsets.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
b59f2b57 42220 to console_ioctl(4) where appropriate.
e4e23158
MK
42221
42222console_ioctl.4
42223 Michael Kerrisk [Chris Gassib]
42224 The argument to KDGETMODE is an 'int'
42225
42226lirc.4
42227 Alec Leamas
42228 Update after upstreamed lirc.h, bugfixes.
42229
42230st.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
42238charmap.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
42244elf.5
42245 Michael Kerrisk
42246 SEE ALSO: add readelf(1)
42247
42248locale.5
42249 Marko Myllynen
42250 Document missing keywords, minor updates
42251 Marko Myllynen
42252 Clarify keyword syntax
42253 Marko Myllynen
42254 Adjust conformance
42255
42256proc.5
42257namespaces.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
42263proc.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
42306repertoiremap.5
42307 Marko Myllynen
42308 Clarify keyword syntax
42309
42310utmp.5
42311 Michael Kerrisk
42312 SEE ALSO: add logname(1)
42313
42314capabilities.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
42320cgroup_namespaces.7
42321 Michael Kerrisk
42322 SEE ALSO: add namespaces(7)
42323
42324cgroups.7
42325 Michael Kerrisk
42326 ERRORS: add mount(2) EBUSY error
42327
42328cp1251.7
42329cp1252.7
42330iso_8859-1.7
42331iso_8859-15.7
42332iso_8859-5.7
42333koi8-r.7
42334koi8-u.7
42335 Marko Myllynen
42336 Add some charset references
42337 Add some references to related charsets here and there.
42338
42339credentials.7
42340 Michael Kerrisk
42341 SEE ALSO: add runuser(1)
42342 SEE ALSO: add newgrp(1)
42343 SEE ALSO: add sudo(8)
42344
42345feature_test_macros.7
42346 Michael Kerrisk
42347 Emphasize that applications should not directly include <features.h>
42348
42349man-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
42358namespaces.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
42372netlink.7
42373 Andrey Vagin
42374 Describe netlink socket options
42375 Michael Kerrisk
42376 Rework version information
42377 (No changes in technical details.)
42378
42379pid_namespaces.7
42380 Michael Kerrisk
42381 SEE ALSO: add namespaces(7)
42382
42383unix.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
b59f2b57 42389 Fix statement about permissions needed to connect to a UNIX domain socket
e4e23158
MK
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
42408user_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
42449utf-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.
60431332
MK
42454
42455
42456==================== Changes in man-pages-4.08 ====================
42457
42458Released: 2016-10-08, Munich
42459
42460
42461Contributors
42462------------
42463
42464The following people contributed patches/fixes or (noted in brackets
42465in the changelog below) reports, notes, and ideas that have been
42466incorporated in changes in this release:
42467
42468Arnaud Gaillard <arnaud.mgaillard@gmail.com>
42469Bill Pemberton <wfp5p@worldbroken.com>
42470Carlos O'Donell <carlos@redhat.com>
42471Christoph Hellwig <hch@lst.de>
42472David Turner <novalis@novalis.org>
42473Dr. Tobias Quathamer <toddy@debian.org>
42474Elliott Hughes <enh@google.com>
42475Eugene Syromyatnikov <evgsyr@gmail.com>
42476Heinrich Schuchardt <xypron.glpk@gmx.de>
42477Hu Keping <hukeping@huawei.com>
42478Igor Liferenko <igor.liferenko@gmail.com>
42479Ivan Kharpalev <ivan.kharpalev@gmail.com>
42480Jakub Wilk <jwilk@jwilk.net>
42481Jann Horn <jann@thejh.net>
42482Josh Triplett <josh@joshtriplett.org>
42483Keno Fischer <keno@juliacomputing.com>
42484Laurent Georget <laurent.georget@supelec.fr>
42485Local Lembke <logan@blackhillsinfosec.com>
42486Mats Wichmann <mats@wichmann.us>
42487Michael Kerrisk <mtk.manpages@gmail.com>
42488Mike Crowe <mac@mcrowe.com>
42489Mike Frysinger <vapier@gentoo.org>
42490Namhyung Kim <namhyung@gmail.com>
42491Nikola Forró <nforro@redhat.com>
42492Patrick McLean <patrickm@gaikai.com>
42493Peter Wu <peter@lekensteyn.nl>
42494Petr Cermak <petrcermak@chromium.org>
42495Quentin Rameau <quinq@fifth.space>
42496Ray Bellis <ray@isc.org>
42497Rich Felker <dalias@libc.org>
42498Ruben Kerkhof <ruben@rubenkerkhof.com>
42499Sam Varshavchik <mrsam@courier-mta.com>
42500Sebastian Andrzej Siewior <bigeasy@linutronix.de>
42501Siward de Groot <siward@wanadoo.nl>
42502Sloane Bernstein <sloane@cpanel.net>
42503Stefan Tauner <tauner@technikum-wien.at>
42504Tim Savannah <kata198@gmail.com>
42505Ursache Vladimir <f35f22fan@gmail.com>
42506Zefram <zefram@fysh.org>
42507王守堰 <wangshouyan@gmail.com>
42508
42509Apologies if I missed anyone!
42510
42511
42512New and rewritten pages
42513-----------------------
42514
42515quotactl.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
42531bswap.3
42532 Michael Kerrisk
42533 New page documenting bswap_16(), bswap_32(), and bswap_64()
42534
42535cgroups.7
42536 Michael Kerrisk
42537 Substantial rewrites, additions, and corrections.
42538
42539
42540Newly documented interfaces in existing pages
42541---------------------------------------------
42542
42543readv.2
42544 Michael Kerrisk
a8c5e65f 42545 Document the pwritev2() RWF_SYNC and RWF_DSYNC flags
60431332
MK
42546
42547proc.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
42557New and changed links
42558---------------------
42559
42560bswap_16.3
42561bswap_32.3
42562bswap_64.3
42563 New link to new bswap.3
42564
42565
42566Global changes
42567--------------
42568
42569Various 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
42575Various pages
42576 Michael Kerrisk [Mike Frysinger]
42577 Consistently use /proc/[pid] (not /proc/PID)
42578
42579Various 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
42585Various pages
42586 Michael Kerrisk
42587 Order ERRORS alphabetically
42588
42589Various 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
42597A few pages
42598 Michael Kerrisk
42599 Eliminate groff "cannot adjust line" warnings
42600
42601
42602Changes to individual pages
42603---------------------------
42604
42605pldd.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
42613accept.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
42620adjtimex.2
42621 Nikola Forró
42622 Fix kernel version references
42623
42624chroot.2
42625 Michael Kerrisk
42626 Note user namespace requirements for CAP_SYS_CHROOT
42627
42628clone.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
42648close.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
42654epoll_wait.2
42655 Mike Crowe
42656 Clarify that the timeout is measured against CLOCK_MONOTONIC
42657
42658execve.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
42664fanotify_init.2
42665 Heinrich Schuchardt
42666 Update BUGS information
42667
42668fcntl.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
42679fork.2
42680 Michael Kerrisk
42681 PID of new process also does not match any existing session ID
42682
42683fsync.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
42689getdomainname.2
42690 Michael Kerrisk
42691 Note user namespace requirements for CAP_SYS_ADMIN
42692
42693getgroups.2
42694 Michael Kerrisk
42695 Note user namespace requirements for CAP_SETGID
42696
42697gethostname.2
42698 Michael Kerrisk
42699 Note user namespace requirements for CAP_SYS_ADMIN
42700
42701getrlimit.2
42702 Michael Kerrisk
42703 Note user namespace semantics for CAP_SYS_RESOURCE
42704
42705getsid.2
42706 Michael Kerrisk
42707 Rework description to be somewhat clearer
42708 Michael Kerrisk
42709 Correct the definition of "session ID"
42710
42711getunwind.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
42717kcmp.2
42718 Michael Kerrisk
42719 Add an example program
42720
42721kill.2
42722 Michael Kerrisk
42723 Note the user namespace requirement for CAP_KILL
42724
42725killpg.2
42726 Michael Kerrisk
42727 Refer reader to kill(2) for signal permission rules
42728
42729mlock.2
42730 Sebastian Andrzej Siewior
42731 Document that fork() after mlock() may be a bad idea in a RT process
42732
42733mmap.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
42740msgctl.2
42741msgget.2
42742msgop.2
42743semctl.2
42744semget.2
42745semop.2
42746shmctl.2
42747shmget.2
42748shmop.2
42749 Michael Kerrisk
42750 Note the user namespace requirements for CAP_IPC_OWNER
42751
42752open.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
42762prctl.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
42772readlink.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
42781readv.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
42787reboot.2
42788 Michael Kerrisk
42789 Note user namespace requirements around CAP_SYS_BOOT
42790
42791rename.2
42792 Michael Kerrisk [Tim Savannah]
42793 Clarify that ERRORS may cause rename to fail (not to be nonatomic)
42794
42795sched_setaffinity.2
42796 Michael Kerrisk
42797 Note user namespace requirements for CAP_SYS_NICE
42798
42799seccomp.2
42800 Michael Kerrisk
42801 CAP_SYS_ADMIN is required only in caller's user namespace
42802
42803select_tut.2
42804 Peter Wu
42805 Fix various issues in example program
42806
42807seteuid.2
42808 Michael Kerrisk
42809 Note user namespace requirements for CAP_SETUID and CAP_SETGID
42810
42811setgid.2
42812 Michael Kerrisk
42813 Note user namespace requirements for CAP_SETGID
42814
42815setpgid.2
42816 Michael Kerrisk
42817 Add a reference to credentials(7)
42818
42819setpgid.2
42820setsid.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
42825setresuid.2
42826 Michael Kerrisk
42827 Note user namespace requirements for CAP_SETUID
42828
42829setreuid.2
42830 Michael Kerrisk
42831 Note user namespace requirements for CAP_SETUID and CAP_SETGID
42832
42833setsid.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
42839set_thread_area.2
42840 Michael Kerrisk
42841 Add get_thread_area() to NAME
42842
42843setuid.2
42844 Michael Kerrisk
42845 Note user namespace requirements for CAP_SETUID
42846
42847sigprocmask.2
42848 Keno Fischer
42849 Expand/clarify libc/kernel sigset_t difference
42850
42851stat.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
42857umask.2
42858 Michael Kerrisk
42859 Provide a rationale for the existence of /proc/PID/status 'Umask' field
42860
42861wait.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
42867bindresvport.3
42868rcmd.3
42869ip.7
42870 Michael Kerrisk
42871 Note user namespace requirements for CAP_NET_BIND_SERVICE
42872
42873byteorder.3
42874 Michael Kerrisk
42875 SEE ALSO: add bswap(3)
42876
42877dlopen.3
42878 Michael Kerrisk
42879 dlmopen() is still broken in glibc 2.24
42880
42881endian.3
42882 Michael Kerrisk
42883 SEE ALSO: add bswap(3)
42884
42885ffs.3
42886 Michael Kerrisk [Stefan Tauner]
42887 Correct feature test macro requirements
42888
42889fmemopen.3
42890 Michael Kerrisk [Rich Felker]
42891 Remove bogus suggestion to use setbuffer()
42892
42893getlogin.3
42894 Michael Kerrisk
42895 Update feature test macro requirements for cuserid()
42896
42897getumask.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
42903mkstemp.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
42909pthread_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
42915resolver.3
42916 Ray Bellis
42917 Correct arguments to res_ninit(res_state statep)
42918
42919strverscmp.3
42920 Michael Kerrisk
42921 Add an example program
42922
42923wcstombs.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
42928core.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
42934proc.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
42979capabilities.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
42987glob.7
42988 Michael Kerrisk [Arnaud Gaillard]
42989 Clarify that syntactically incorrect patterns are left unchanged
42990
42991packet.7
42992 Michael Kerrisk
42993 Clarify user namespace requirements for CAP_NET_RAW
42994
42995pipe.7
42996 Michael Kerrisk [Patrick McLean]
42997 Document FIONREAD
42998
42999raw.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
43006socket.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
43013unix.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
43018ld.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