]> git.ipfire.org Git - thirdparty/man-pages.git/blame - Changes.old
Document unshare(2), new in 2.6.16.
[thirdparty/man-pages.git] / Changes.old
CommitLineData
0680aa5b
MK
1The following are changes in previous 2.xx man page releases.
2
3==================== Changes in man-pages-2.00 ====================
4
5Released: 2004-12-16 (why wait for the kernel?)
6
7Contributors
8------------
9
10The following people contributed notes, ideas, or patches that have
11been incorporated in changes in this release:
12
13Alberto Bertogli <albertogli@telpin.com.ar>
14Anand Kumria <wildfire@progsoc.org>
15Andrey Kiselev <dron@ak4719.spb.edu>
16Andries Brouwer <Andries.Brouwer@cwi.nl>
17Chris Green <cmg@dok.org>
18Branden Robinson <branden@debian.org>
19Emmanuel Colbus <emmanuel.colbus@ensimag.imag.fr>
20Enrico Zini <enrico@debian.org>
21Eric Estievenart <eric.estievenart@free.fr>
22Fabian Kreutz <kreutz@dbs.uni-hannover.de>
23Florian Weimer <fw@deneb.enyo.de>
24Jan Kuznik <kuznik@gepro.cz>
25Joey (Martin) Schulze <joey@infodrom.org>
26Johannes Berg <johannes@sipsolutions.de>
27John V. Belmonte <jbelmonte@debian.org>
28Karel Kulhavy <clock@twibright.com>
29Luis Javier Merino MorĂ¡n <ljmerino@pandasoftware.es>
30Martin Pool <mbp@sourcefrog.net>
31Richard Kreckel <Richard.Kreckel@ginac.de>
32Vasya Pupkin <ptushnik@gmail.com>
33
34Apologies if I missed anyone!
35
36Global changes
37--------------
38
39Many math pages had their synopses compressed, as per suggestion
40from Fabian Kreutz.
41
42Many minor content and formatting bug fixes were made to the math
43pages, following suggestions from Fabian Kreutz (who recently
44translated many of the 1.70 math pages into German) and
45Andries Brouwer.
46
47For consistency, all instances "super-user" were changed to the more
48common "superuser".
49
50After a note from Vasya Pupkin, I added <errno.h> to the SYNOPSIS
51of several Section 2 pages using the _syscallN() macros.
52
53 In addition:
54 -- erroneous semicolons at the end of _syscallN() were removed
55 on various pages.
56
26785b48 57 -- types such as "uint" in syscallN() declarations were changed
0680aa5b
MK
58 to "unsigned int", etc.
59
60 -- various other minor breakages in the synopses were fixed.
61
62 The affected pages are:
63
64 getdents.2
65 gettid.2
66 llseek.2
67 mmap2.2
68 modify_ldt.2
69 pivot_root.2
70 quotactl.2
71 readdir.2
72 sysctl.2
73 syslog.2
74 tkill.2
75
76Typographical or grammatical errors have been corrected in several
77other places.
78
79Individual pages
80----------------
81
82bind.2
83 Florian Weimer
84 Added 'const' to declaration of 'my_addr' in prototype.
85 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239762
86
87fcntl.2
88 Martin Pool
89 Added O_NOATIME to list of flags that can be changed via F_SETFL.
90 mtk/aeb
91 Noted F_GETOWN bug after suggestion from aeb.
92 See also:
93 http://marc.theaimsgroup.com/?l=linux-kernel&m=108380640603164&w=2
94
95getrlimit.2
96 mtk
97 Material on getrusage.2 has been separated out into its own page.
98 Rewrote discussion on RLIMIT_MEMLOCK to incorporate kernel
99 2.6.9 changes.
100 Added note on RLIMIT_CPU error in older kernels.
101 Added RLIMIT_SIGPENDING
102 Also made a few other minor changes.
103
104getrusage.2
105 mtk
106 This page is new(ish) -- it was created by splitting
107 getrlimit.2.
108
109 Repaired note on SIGCHLD behaviour to note that the
110 POSIX non-conformance has been fixed in 2.6.9.
111
112kill.2
113 Modified after suggestion from Emmanuel Colbus
114 Changed wording of sentence under NOTES describing
115 when signals can be sent to init.
116
117mlock.2, munlock.2, mlockall.2, munlockall.2
118 These have been consolidated into a single mlock.2 page.
119 In the process, much duplication was eliminated
120 and new information was added about RLIMIT_MEMLOCK
121 and the changes in memory locking in kernel 2.6.9,
122
123mmap.2
124 mtk
125 Added cross-ref to setrlimit(2) concerning memory locking limits.
126 Eric Estievenart
127 Note that MAP_FIXED replaces existing mappings
128
129msgctl.2
130 mtk
131 Substantial language and formatting clean-ups.
132 Added msqid_ds and ipc_perm structure definitions.
133
134msgget.2
135 mtk
136 Substantial language and formatting clean-ups.
137 Added notes on /proc files.
138
139msgop.2
140 mtk
141 Substantial language and formatting clean-ups.
142 Added notes on /proc files.
143
144open.2
145 Martin Pool
146 Added O_NOATIME (new in Linux 2.6.8)
147 mtk
148 Reordered list of 'flags' description alphabetically
149
150personality.2
151 2004-11-03 applied patch from Martin Schulze
152
153semctl.2
154 mtk
155 Substantial language and formatting clean-ups.
156 Rewrote semun text.
157 Added semid_ds and ipc_perm structure definitions.
158
159semget.2
160 mtk
161 Substantial language and formatting clean-ups.
162 Added notes on /proc files.
163 Rewrote BUGS note about semget()'s failure to initialise
164 semaphore values.
165
166semop.2
167 mtk
168 Substantial language and formatting clean-ups.
169 Added notes on /proc files.
170
171shmctl.2
172 mtk
173 Substantial language and formatting clean-ups.
174 Updated shmid_ds structure definitions.
175 Added information on SHM_DEST and SHM_LOCKED flags.
176 Noted that CAP_IPC_LOCK is not required for SHM_UNLOCK
177 since kernel 2.6.9.
178 Added notes on 2.6.9 RLIMIT_MEMLOCK changes.
179 Added RLIMIT_SIGPENDING (new in Linux 2.6.8)
180
181shmget.2
182 mtk
183 Substantial language and formatting clean-ups.
184 Added notes on /proc files.
185
186shmop.2
187 mtk
188 Substantial language and formatting clean-ups.
189 Changed wording and placement of sentence regarding attachment
190 of segments marked for destruction.
191
192sigaction.2
193 mtk
194 Added mention of SIGCONT under SA_NOCLDSTOP.
195 Added SA_NOCLDWAIT.
196 Updated discussion for POSIX.1-2001 and SIGCHLD and sa_flags.
197 Noted that CLD_CONTINUED is supported since Linux 2.6.9.
198 Added SI_TKILL (new in Linux 2.4.19).
199 Other minor changes.
200
201signal.2
202 mtk
203 Removed text on ignoring SIGCHLD; replaced with pointer
204 to sigaction.2.
205
206sigwaitinfo.2
207 After bug report from Andrey Kiselev
208 Fixed prototype: "timeout" --> "*timeout"
209 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=222145
210
2ed34e11 211stat.2
0680aa5b
MK
212 Enrico Zini
213 Added text to clarify that S_IS*() macros should be applied to
214 st_mode field.
215 as per: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=249698
216
217swapon.2
218 After bug report from Anand Kumria
219 Added "no swap space signature" to EINVAL error
220 as per http://bugs.debian.org/cgi-bin/bugreport.cgi
221 mtk
222 Added EINVAL error for swapoff() ("not currently a swap area").
223 Added EBUSY error for swapon().
224 A few formatting fixes.
225
226times.2
227 mtk
228 In Linux 2.6, the return value of times changed; it is no
229 longer time since boot, but rather:
230
231 boot_time + 2^32 / HZ - 300
232
233 Repaired note on SIGCHLD behaviour to note that the
234 POSIX non-conformance has been fixed in 2.6.9.
235 Some formatting fixes.
236
237undocumented.2
238 After bug report from Johannes Berg
239 Changed
240 .TH UNIMPLEMENTED
241 to:
242 .TH UNDOCUMENTED
243 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=220741
244
245wait.2
246 mtk
247 Added waitid(2).
248 Added WCONTINUED and WIFCONTINUED (new in 2.6.10).
249 Added text on SA_NOCLDSTOP.
250 Updated discussion of SA_NOCLDWAIT to reflect 2.6 behaviour.
251 Much other text rewritten.
252
253wait4.2
254 mtk
255 Rewrote this page, removing much duplicated information,
256 and replacing with pointers to wait.2.
257 Luis Javier Merino MorĂ¡n / mtk
258 CONFORMING TO said "SVr4, POSIX". Changed to "4.3BSD"
259
260waitid.2
261 mtk
262 New link to wait.2
263
264assert.3
265 After bug report from Branden Robinson
266 The assert() failure message goes to stderr not stdout.
267 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=284814
268
269ctime.3
270 mtk
271 Noted that 0 in tm_mday is interpreted to mean the last day
272 of the preceding month.
273
274getnameinfo.3
275 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=229618
276 getnameinfo() does not set errno, it returns a non-zero
277 value indicating the error.
278 mtk
279 added EAI_OVERFLOW error
280
281killpg.3
282 mtk
283 Minor changes to SEE ALSO and CONFORMING TO.
284
285lseek64.3
286 aeb
287 New page by Andries Brouwer
288
289tzset.3
290 Richard Kreckel
291 Change "NULL" to "empty" when talking about the value of TZ.
292 http://sources.redhat.com/bugzilla/show_bug.cgi?id=601
293
294printf.3
295 After bug report from Jan Kuznik
296 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=205736
297 Fixed bad realloc() use in snprintf() example
298
2ed34e11
MK
299realpath.3
300 mtk
301 Added discussion of resolved_path == NULL.
302
0680aa5b
MK
303random.4
304 After bug report from John V. Belmonte
305 Updated init and quit scripts to reflect kernel 2.4/2.6 reality
306 (Scripts taken from drivers/char/random.c)
307 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=247779
308
309proc.5
310 mtk
311 Updated description of /proc/loadavg to include
312 nr_running(), nr_threads, last_pid.
313
314 rtsig-max and rtsig-nr went away in 2.6.8
315
316 updated statm, and fixed error in order of list
317
0680aa5b
MK
318boot.7
319 applied patch from Martin Schulze
320
321capabilities.7
322 mtk
323 Added O_NOATIME for CAP_FOWNER
324
325netdevice.7
326 Karel Kulhavy and AEB
327 formatting fix after note from Karel Kulhavy and AEB, plus a
328 few wording fixes.
329
330signal.7
331 mtk
26785b48 332 /proc/sys/kernel/rtsig-* were superseded by RLIMIT_SIGPENDING
0680aa5b
MK
333 in kernel 2.6.8.
334
335tcp.7
336 mtk/aeb
337 Updated details of interaction of TCP_CORK and TCP_NODELAY.
9651df75
MK
338
339==================== Changes in man-pages-2.01 ====================
340
341Released: 2004-12-20 (a quick one before Christmas)
342
343Contributors
344------------
345
346The following people contributed notes, ideas, or patches that have
347been incorporated in changes in this release:
348
349Carsten Hey <c.hey@web.de>
350Johannes Berg <johannes@sipsolutions.de>
351Joshua Kwan <joshk@triplehelix.org>
352Marek Habersack <grendel@debian.org>
353Martin Schulze <joey@infodrom.org>
354Matthew Dempsky <jivera@flame.org>
355Matthew Gregan <kinetik@orcon.net.nz>
356Pedro Zorzenon Neto <pzn@terra.com.br>
357Tony Crawford <tony@klosterdorf.de>
358
359Apologies if I missed anyone!
360
361Global changes
362--------------
363
364Matthew Dempsky, mtk
365 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
366 The wording describing how errno is set was fixed up in the
367 following pages:
368
369 accept.2
370 close.2
371 send.2
372 setsid.2
373 socket.2
374 closedir.3
375 initgroups.3
376 mkstemp.3
377 opendir.3
378 readdir.3
379 telldir.3
380
381Typographical or grammatical errors have been corrected in several
382other places.
383
384Individual pages
385----------------
386
387sendfile.2
388 mtk
389 Adjusted descriptions of argument file types to be closer to
390 2.6 reality.
391 Wording and formatting changes
392
393ctan.3
394ctanh.3
395 Tony Crawford
396 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=270817
397 Formulae on the pages should be T = S / C not T = C / S.
398
399errno.3
400 Martin Schulze, mtk
401 Removed errno declaration from prototype, added notes
402 on historical need for this declaration.
403 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=174175
404
405aio_return.3
406 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=224953
407 Changed erroneous "aio_return(2)" to "aio_return(3)"
408
409posix_openpt.3
410 mtk
411 New by mtk
412
413ptsname.3
414 mtk
415 Added description of ptsname_r().
416 Added ERRORS.
417
418ptsname_r.3
419 mtk
e8a09504 420 New link to ptsname.3.
9651df75
MK
421
422shm_open.3
423 Matthew Gregan
424 add <fcntl.h> to synopsis
425 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=271243
426
427strcasecmp.3
428 Marek Habersack <grendel@debian.org>
429 .SH "CONFORMING TO"
430 -BSD 4.4
431 +BSD 4.4, SUSv3
432 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=234443
433
434strfry.3
435 Joshua Kwan
436 Added _GNU_SOURCE to prototype
437 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=213538
438
439strftime.3
440 Cartsen Hey
441 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=276248
442
e8a09504 443 Changed range for "%S" from 0..61 to 0..0.
9651df75
MK
444
445 SUSv3 says 0..60. I think the manual page probably says
446 0..61, because that's what SUSv2 said.
447 (Some other implementations' man pages also say 0..61 --
448 e.g., Solaris 8 & 9, Tru64 5.1B; FreeBSD 5.1 says 0..60.)
449
450 The glibc manual currently says 0..60.
451
e8a09504 452 Given that SUSv3 says 0..60, I've changed the
9651df75
MK
453 manual page to also say this:
454
455 -The second as a decimal number (range 00 to 61).
456 +The second as a decimal number (range 00 to 60).
457 +(The range is up to 60 to allow for occasional leap seconds.)
458
459sysconf.3
460 Johannes Berg / http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=226974
461 -.BR POSIX2_FORT_RUN " - " _SC_2_FORT_DEV
462 +.BR POSIX2_FORT_DEV " - " _SC_2_FORT_DEV
463
464system.3
465 Pedro Zorzenon
466 as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=242638
467 Noted use of _XOPEN_SOURCE to get macros <sytdlib.h>
468 as for wait(2).
469
470 mtk
471 Changed name of argument from 'string' to 'command' (like POSIX).
472
473 Noted that glibc does nowadays explicitly check for the existence
474 of the shell if 'command' is NULL, rather than the older behaviour
475 of assuming the shell exists and always returning 1 if
476 'command' is NULL.
477
478 Other wording and formatting clean-ups.
479
480undocumented.3
481 Remove some functions names that *are* documented.
4667b1b5
MK
482
483
484==================== Changes in man-pages-2.02 ====================
485
486Released: 2005-04-14
487
488Contributors
489------------
490
491The following people contributed notes, ideas, or patches that have
492been incorporated in changes in this release:
493
494Andries Brouwer <Andries.Brouwer@cwi.nl>
495Branden Robinson <branden@debian.org>
496Colin Watson <cjwatson@debian.org>
497David Lloyd <dmlloyd@tds.net>
498Gordon Jin <gordon.jin@intel.com>
499Heikki Orsila <shd@modeemi.cs.tut.fi>
500Jamie Lokier <jamie@shareable.org>
501Johan Walles
502Kai Makisara <Kai.Makisara@kolumbus.fi>
503Marko Kohtala <marko.kohtala@gmail.com>
504Martin Pool <mbp@sourcefrog.net>
505Martin (Joey) Schulze <joey@infodrom.org>
506Matthias Lang <matthias@corelatus.se>
507Michael Haardt <michael@moria.de>
508Michael MĂ¼hlebach <michael@anduin.ch>
509Mike Frysinger <vapier@gentoo.org>
510Sasa Stevanovic <mg94c18@alas.matf.bg.ac.yu>
511Serguei Leontiev <leo@sai.msu.ru>
512
513Apologies if I missed anyone!
514
515Global changes
516--------------
517
518Martin (Joey) Schulze
519 Removed SEE ALSO reference to non-existent newctime(3) from:
520
521 ctime.3
522 tzselect.8
523 zdump.8
524 zic.8
525
526 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=236884
527
528Typographical or grammatical errors have been corrected in several
529other places.
530
531Individual pages
532----------------
533
534clone.2
535 mtk
536 Noted the PID caching behaviour of NPTL's getpid()
537 wrapper under BUGS.
538
539 Added futex(2), set_thread_area(2), set_tid_address(2),
540 tkill(2) under SEE ALSO.
541
542epoll_ctl.2
543epoll_create.2
544 Marko Kohtala / mtk
545 Improved various error descriptions.
546
547epoll_wait.2
548 David Lloyd / Mike Frysinger, Marko Kohtala
549 Added EINTR to errors.
550
551fcntl.2
552 Jamie Lokier / mtk
553 Improved discussion of F_SETOWN and F_SETSIG with respect to
554 multi-threaded programs.
555 Generally cleaned up the discussion of F_SETOWN.
556
557 Updated CONFORMING TO to note that F_GETOWN and F_SETOWN are
558 now in POSIX.
559
560link.2
561 mtk
562 Noted discrepancy between Linux and POSIX.1 when oldpath
563 is a symbolic link.
564 See: http://bugs.linuxbase.org/show_bug.cgi?id=367
565 and: http://www.opengroup.org/austin/mailarchives/ag/msg08152.html
566
567 Michael Haardt / mtk
568 Clarified EXDEV error description: it isn't possible to link
569 across mount points, even if the mount points refer to the same
570 file system.
571
572mincore.2
573 mtk, after note from Gordon Jin
574 Updated ERRORS
575
576pipe.2
577 As per message from Serguei Leontiev
578 Removed SVr2, AT&T, and BSD from CONFORMING TO, since
579 a pipe on those systems is actually bidirectional.
580 (Pipes are implemented as STREAMS on the former, and
581 sockets on the latter.)
582
583posix_fadvise.2
584 mtk
585 Noted kernel version where posix_fadvise() appeared and
586 noted bug in handling of 'len' in kernels < 2.6.6.
587
588rename.2
589 Michael Haardt
590 Clarified EXDEV error description: it isn't possible to rename
591 a file across mount points, even if the mount points refer to
592 the same file system.
593
594semop.2
595 mtk
596 Noted kernel version numbers for semtimedop().
597
598setitimer.2
599 Matthias Lang, mtk
600 Noted MAX_SEC_IN_JIFFIES ceiling.
601 Added note about treatment of out-of-range tv_usec values.
602
603sigqueue.2
604 Johan Walles, Martin (Joey) Schulze
605 Added sigqueue.2 to SEE ALSO
606
607times.2
608 mtk
609 Added notes on non-standard behaviour: Linux allows 'buf' to
610 be NULL, but POSIX.1 doesn't specify this and it's non-portable.
611
612uselib.2
613 Andries Brouwer
614 Improved DESCRIPTION; clarified distinction between
615 EACCES and ENOEXEC.
616
617bcopy.3
618 Heikki Orsila
90369a2c 619 bcopy() handles overlapping case, but memcpy() does not,
4667b1b5
MK
620 so for consistency memmove() should be also mentioned.
621
622getmntent_r.3
623 Martin (Joey) Schulze
624 New link to man3/getmntent.3.
625
626memcpy.3
627 Small wording change after suggestion from Sasa Stevanovic.
628
629strcasestr.3
630 mtk
631 Created as link to strstr.3.
632
633strftime.3
634 mtk
635 Noted that SUSv2 allowed a range of 00 to 61 for %S specifier.
636
637strstr.3
638 mtk
639 Added description of strcasestr().
640
641random.4
642 aeb
643 Improved description of read from /dev/urandom.
644
645st.4
646 Kai Makisara
647 Substantial updates.
648
649man.7
650 Martin Schulze <joey@infodrom.org>
651 Branden Robinson <branden@debian.org>
652 Colin Watson <cjwatson@debian.org>
653 Mention the .URL macro more verbosely.
654
4e6bd42c 655
9a7957be
MK
656==================== Changes in man-pages-2.03 ====================
657
658Released: 2005-06-02
659
660Contributors
661------------
662
663The following people contributed notes, ideas, or patches that have
664been incorporated in changes in this release:
665
666Andries Brouwer <Andries.Brouwer@cwi.nl>
667Joey (Martin) Schulze <joey@infodrom.org>
668Johannes Nicolai <johannes.nicolai@hpi.uni-potsdam.de>
669Justin Pryzby <justinpryzby@users.sourceforge.net>
670Klaus Ethgen <Klaus@Ethgen.de>
671Pavel Heimlich <tropikhajma@seznam.cz>
672Ross Boylan <RossBoylan@stanfordalumni.org>
673Vincent Fourmond <vincent.fourmond@9online.fr>
674
675Apologies if I missed anyone!
676
677Global changes
678--------------
679
680Pavel Heimlich
681 Change `ttys(4)' to `ttyS(4)' in:
682 tty.4 mouse.4 vcs.4 console_ioctl.4 console.4
683
684Typographical or grammatical errors have been corrected in several
685places.
686
687Individual pages
688----------------
689
690clone.2
691 mtk
692 Substantially enhanced discussion of CLONE_THREAD.
693
694 Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED.
695
696 Other minor fixes.
697
698execve.2
699 aeb
4e6bd42c 700 Noted effect of ptracing when execing a set-UID program.
9a7957be
MK
701
702fcntl.2
703 Johannes Nicolai / mtk
704 Noted F_SETOWN bug for socket file descriptor in Linux 2.4
705 and earlier.
706
707 Added text on permissions required to send signal to owner.
708
709flock.2
710 mtk
711 Noted that lock conversions are not atomic.
712
713getrusage.2
714 mtk
715 ru_nswap has never contained useful information.
716 Kernel 2.6.6 clarified that with a patch
717 ("[PATCH] eliminate nswap and cnswap"). See also:
718 http://www.ussg.iu.edu/hypermail/linux/kernel/0404.1/0720.html
719
720kill.2
721 mtk
722 Clarified wording of the 'pid == -1' case.
723
724mount.2
725 mtk
726 Added MNT_EXPIRE, plus a few other tidy-ups.
727
728sched_setaffinity.2
729 mtk
730 Added text to note that sched_setaffinity() will migrate the
731 affected process to one of the specified CPUs if necessary.
732
733 Added a NOTE to point out that the affinity mask is actually a
734 per-thread attribute that can be adjusted independently for
735 each thread in a thread group.
736
737shmctl.2
738 mtk
739 Noted aberrant Linux behaviour with respect to new attaches to a
740 segment that has already been marked for deletion.
741
742 Noted changes in permissions required for SHM_LOCK/SHM_UNLOCK.
743
744wait.2
745 mtk
746 Noted that the __W* flags can't be used with waitid().
747
748getconf.3
749 mtk
fe209df6 750 Added _CS_GNU_LIBC_VERSION and _CS_GNU_LIBPTHREAD_VERSION.
9a7957be
MK
751
752hosts.5
753 Ross Boylan / Martin Schulze
754 various changes as per
755 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304242
756
757proc.5
758 mtk
759 Minor changes to discussion of /proc/PID/stat signal fields.
760 Added 'rt_priority' and 'policy' to /proc/PID/stat.
761
762capabilities.7
763 mtk
764 1,$s/inherited/inheritable/g
765
766regex.7
767 Vincent Fourmond / Joey (Martin) Schulze
768 Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
769 not seem to be in the glibc implementation.
770 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666
771
772tzselect.8
773 Joey (Martin) Schulze / Klaus Ethgen
deea4228 774 The default zoneinfo directory is now /usr/share/zoneinfo.
9a7957be
MK
775 (was: /usr/local/etc/zoneinfo)
776 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=267471
777
4e6bd42c
MK
778
779==================== Changes in man-pages-2.04 ====================
780
781Released: 2005-06-21
782
783Contributors
784------------
785
786The following people contributed notes, ideas, or patches that have
787been incorporated in changes in this release:
788
789Andries Brouwer <Andries.Brouwer@cwi.nl>
790Baurjan Ismagulov <ibr@ata.cs.hun.edu.tr>
791Dave Love <d.love@dl.ac.uk>
792Dieter Brueggemann <dieter.brueggemann@entitec.de>
793Geoff Clare <gclare@gclare.org.uk>
794Guido Trotter <ultrotter@debian.org>
9fdfa163 795kabloom <kabloom@ucdavis.edu>
4e6bd42c
MK
796Kevin Ryde <user42@zip.com.au>
797Justin Pryzby <justinpryzby@users.sourceforge.net>
798Mike Furr <mfurr@debian.org>
799Olivier Croquette <ocroquette@free.fr>
800Olivier Guilyardi <ylf@xung.org>
801Peter Cordes <peter@llama.nslug.ns.ca>
802Philipp Spitzer <philipp@toastfreeware.priv.at>
803Tanaka Akira <akr@m17n.org>
804Thierry Excoffier <exco@bat710.univ-lyon1.fr>
805Thomas Hood <jdthood@yahoo.co.uk>
806Vincent Lefevre <vincent@vinc17.org>
807Walter Harms <walter.harms@informatik.uni-oldenburg.de>
808
809Apologies if I missed anyone!
810
811Global changes
812--------------
813
814For consistency across pages:
815
816 1,$s/nonzero/non-zero/g
817
818Typographical or grammatical errors have been corrected in several
819places.
820
821
822New pages
823---------
824
825pthreads.7
826 mtk
827 An overview of the Linux implementations of POSIX threads.
828
829
830Changes to individual pages
831---------------------------
832
833_exit.2
834 mtk
835 Various minor changes
836
837epoll_ctl.2
838 Mike Furr <mfurr@debian.org>
839 BUGS: In kernels < 2.6.9, EPOLL_CTL_DEL required a non-NULL
840 'event', even though this argument is ignored.
841 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=306517.
842
843flock.2
844 mtk / Kevin Ryde
845 Clarified semantics of relationship between flock() locks
846 and open file entries and file descriptors.
847 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=291121
848
849getitimer.2
850 Olivier Croquette, Thierry Excoffier
851 Noted the existence of the short sleep bug (up to 1 jiffy).
852
853getrlimit.2
854 mtk
855 RLIMIT_RSS only has affect "in 2.4.x", not "in 2.4 and later".
856
857getrusage.2
858 Geoff Clare
859 Since Linux 2.6, the ru_nvcsw and ru_nivcsw fields are used.
860
861nice.2
862 mtk / Guido Trotter
863 Rewrote description of return value.
864 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=296183
865
866open.2
867 Walter Harms
868 O_DIRECT needs _GNU_SOURCE.
869 mtk
870 O_ASYNC works for pipes and FIFOs in Linux 2.6
871 Various minor fixes
872
873atexit.3
874 mtk
875 Various minor changes
876
877exit.3
878 mtk
879 Various minor changes
880
881getopt.3
882 mtk / Philipp Spitzer
883 Fix description of return value.
884 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=308359
885
886hsearch.3
887 mtk
888 Changed (char *) to (void *) in example.
889 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=313607
890
891log1p.3
892 Justin Pryzby
893 make log(3) SEE ALSO log1p(3)
894 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=309578
895
896makecontext.3
897 Tanaka Akira
26785b48 898 Fix description of RETURN VALUE for makecontext()
4e6bd42c
MK
899 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311800
900
901on_exit.3
902 mtk
903 Various minor changes
904
905rand.3
906 kabloom@ucdavis.edu
907 Small fix to a code example
908 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=194842.
909
910realpath.3
911 mtk / Thomas Hood
912 When specifying resolved_path as NULL, realpath()
913 will (still) only allocate up to PATH_MAX bytes.
914 Plus other minor changes.
915 See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=239424
916
917rcmd.3
918 Dave Love
fe209df6 919 The required header file for these functions on Linux is <netdb.h>
4e6bd42c
MK
920 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311680
921
922scanf.3
923 Olivier Guilyardi
924 Arg for %p is a pointer to _a pointer to_ void.
925 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=263109
926
927stdin.3
928 Vincent Lefevre
929 freopen() can change the descriptors associated with
930 stdin/stdout/stderr.
931 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295859.
932
933strerror.3
934 Baurjan Ismagulov
935 strerror_r(3) requires #define _XOPEN_SOURCE 600
936 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=290880
937
938sysconf.3
939 Peter Cordes / mtk
940 Fix typo: "_SC_2_DEV" should be "_SC_2_C_DEV"
941
942proc.5
943 mtk
944 Added pointers under /proc/sys/net to tcp.7 and ip.7
945
946ip.7
947 mtk
948 Various wording and formatting fixes.
949 Reordered /proc/sys/net/ipv4/ip_* file descriptions alphabetically.
950
951tcp.7
952 Dieter Brueggemann / mtk
953 Fixes to the discussion of SIOCATMARK and tcp_stdurg
954 mtk
955 Various wording and formatting fixes.
956 Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
957 from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
eb9a3e3c
MK
958
959
960==================== Changes in man-pages-2.05 ====================
961
962Released: 2005-06-27
963
964Contributors
965------------
966
967The following people contributed notes, ideas, or patches that have
968been incorporated in changes in this release:
969
970A Costa <agcosta@gis.net>
971Andries Brouwer <Andries.Brouwer@cwi.nl>
972Bas Zoetekouw <bas@debian.org>
973Dan Jacobson <jidanni@jidanni.org>
974Delian Krustev <krustev@krustev.net>
975Dora Anna Volgyesi <volgyesi@elte.hu>
976Martin (Joey) Schulze <joey@infodrom.org>
977Ove Kaaven <ovek@arcticnet.no>
978
979Apologies if I missed anyone!
980
981Global changes
982--------------
983
984Typographical or grammatical errors have been corrected in several
985places. (Special thanks to A Costa.)
986
987
eb9a3e3c
MK
988Changes to individual pages
989---------------------------
990
991_exit.2
992 mtk / aeb
993 Reversed 2.04 introduction of the term "process termination
994 function".
995
996close.2
997 mtk
998 Clarified what type of lock close() affects.
999 Minor formatting changes.
1000
1001dup.2
1002 mtk
1003 Consistent use of terms "open file description",
26785b48 1004 "file status flags", and "file descriptor flags"
eb9a3e3c
MK
1005 Removed mention of lock sharing -- it was not
1006 accurate.
1007 Minor formatting fixes
1008
1009fcntl.2
1010 mtk
1011 Consistent use of terms "open file description",
26785b48 1012 "file status flags", and "file descriptor flags"
eb9a3e3c
MK
1013 Some rewriting of discussion of file descriptor flags
1014 Under F_DUPFD, replaced some text duplicated in dup.2
1015 with a cross ref to dup.2
1016 Minor wording and formatting fixes
1017
1018fpclassify.3
1019 mtk / Martin (Joey) Schulze / Bas Zoetekouw
1020 The return value of isinf() changed in glibc 2.02
26785b48 1021 to differentiate positive and negative infinity.
eb9a3e3c
MK
1022 See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285765
1023
1024getgid.2
1025getuid.2
1026 Delian Krustev
1027 Remove confusing text describing real and effective IDs.
1028 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=285852
1029
1030getitimer.2
1031 mtk
1032 The short sleep bug (up to 1 jiffy) that was newly noted in
1033 man-pages-2.04 has just been fixed in 2.6.12.
1034
1035getpriority.2
1036 mtk
1037 Changed range documented in main text from -20..20 to -20..19.
1038 Noted that the range is -20..20 on some systems.
1039
1040open.2
1041 mtk / aeb
1042 Clarification of term "open file description" along with
1043 explanation of what information it maintains.
1044 Other wording improvements
1045 Various minor wording changes
1046
1047atexit.3
1048 mtk / aeb
1049 Reversed 2.04 introduction of the term "process termination
1050 function".
1051 mtk
1052 Noted use of atexit() for establishing function to be invoked on
1053 shared library unload.
1054 Noted that atexit()-registered functions are not invoked on
1055 abnormal termination.
1056 Formatting fixes.
1057
1058exit.3
1059 mtk / aeb
1060 Reversed 2.04 introduction of the term "process termination
1061 function".
1062 mtk
1063 Minor rewording and formatting changes.
1064
1065getloadavg.3
1066 mtk
1067 Added #define _BSD_SOURCE to prototype
1068
1069log2.3
1070 Martin (Joey) Schulze
1071 Add ERANGE error.
1072
1073readdir.3
1074 mtk
1075 Added definition of Linux dirent structure.
1076 Some formatting cleanups.
1077
1078strtod.3
1079 Dora Anna Volgyesi/ mtk
1080 strtold() and strtof() need _ISOC99_SOURCE or _XOPEN_SOURCE=600
1081 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=246668
1082
1083tdestroy.3
1084 mtk
1085 New link to tsearch.3
1086
1087tsearch.3
1088 mtk
1089 Added tdestroy to .TH line
1090
1091mem.4
1092 mtk
1093 Change "chown root:mem /dev/mem" to "chown root:kmem /dev/mem"
1094
1095null.4
1096 mtk
1097 Change "chown root:mem /dev/null /dev/zero" to
1098 "chown root:root /dev/null /dev/zero"
1099
1100vcs.4
1101 Dan Jacobson / Martin (Joey) Schulze
1102 Replaced "selection(1)" by "gpm(8)" under SEE ALSO
1103 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=253515
1104
1105signal.7
1106 Ove Kaaven
1107 SA_SIGACTION should be SA_SIGINFO
1108 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=305369
1109
1110urn.7
1111 mtk
1112 New link to uri.7
c6e136d5
MK
1113
1114
1115==================== Changes in man-pages-2.06 ====================
1116
1117Released: 2005-07-15
1118
1119Contributors
1120------------
1121
1122The following people contributed notes, ideas, or patches that have
1123been incorporated in changes in this release:
1124
1125Alain Portal <aportal@univ-montp2.fr>
1126Andries Brouwer <Andries.Brouwer@cwi.nl>
1127Bhavesh P Davda <bhavesh@avaya.com>
1128Clau Weber <claus@jambit.com>
1129Dov Murik <dov@dv-networks.com>
1130David Lloyd <dlloyd@microbits.com.au>
1131Frederik Deweerdt <frederik.deweerdt@gmail.com>
1132Justin Pryzby <justinpryzby@users.sourceforge.net>
1133Lars Wirzenius <liw@iki.fi>
1134Martin Pool <mbp@sourcefrog.net>
1135Mike Frysinger <vapier@gentoo.org>
1136Petter Reinholdtsen <pere@hungry.com>
1137Steven Murdoch <Steven.Murdoch@cl.cam.ac.uk>
1138Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1139
1140Apologies if I missed anyone!
1141
1142Global changes
1143--------------
1144
1145Typographical or grammatical errors have been corrected in several
1146places.
1147
1148Many uses of hyphens and dashes were corrected.
1149
1150
1151New pages
1152---------
1153
1154canonicalize_file_name.3
1155 Walter Harms / mtk
1156
1157Removed Pages
1158-------------
1159
1160sstk.2
1161 mtk
26785b48 1162 AFAIK, this system call has never actually done anything (other
c6e136d5
MK
1163 than be a stub) on any Unix.
1164
1165Changes to individual pages
1166---------------------------
1167
1168accept.2
1169 mtk
1170 Various wording and formatting fixes.
1171
1172bind.2
1173 mtk
1174 Minor formatting changes
1175
1176clone.2
1177 mtk
1178 Various minor wording improvements; some formatting fixes
1179
1180connect.2
1181 mtk
1182 Various wording and formatting fixes.
1183
1184epoll_create.2
1185 Bhavesh P Davda
1186 s/positive/non-negative/ [for file descriptor]
1187
1188getrlimit.2
1189 mtk
1190 Documented RLIMIT_MSGQUEUE limit.
1191 RLIMIT_RSS ceased to have any effect in 2.4 in kernel 2.4.30.
1192 (It already didn't have any effect in 2.2.x and 2.6.x.)
1193 s/MADVISE_WILLNEED/MADV_WILLNEED/
1194
1195listen.2
1196 mtk
1197 Removed historic comment on BSD backlog ceiling.
1198 Minor wording and formatting changes.
1199
1200semop.2
1201 mtk
1202 Added BUG: in some circumstances, a process that is
1203 waiting for a semaphore to become zero is not not woken
1204 up when the value does actually reach zero.
1205 http://marc.theaimsgroup.com/?l=linux-kernel&m=110260821123863&w=2
1206 http://marc.theaimsgroup.com/?l=linux-kernel&m=110261701025794&w=2
1207
1208socket.2
1209 mtk
1210 Various minor wording improvements
1211
1212umask.2
1213 mtk
1214 Added mkdir(2) to discussion, made term "file mode creation
1215 mask" clearer.
1216 Various, mostly small, wording changes
1217
1218errno.3
1219 Martin Pool
1220 Change description for ESTALE
1221 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=237344
1222
1223fgetgrent.3
1224getgrent.3
1225getgrent_r.3
1226 David Lloyd
1227 Added SEE ALSO putgrent(3)
1228 See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=211336
1229
1230getgrent.3
1231getgrnam.3
1232getpwent.3
1233getpwnam.3
1234 Lars Wirzenius / mtk
fe209df6 1235 Replace mention of /etc/{passwd,group} by references to
c6e136d5
MK
1236 "passwd/group database", and LDAP and NIS.
1237 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1238 mtk
1239 Miscellaneous wording improvements
1240 Consistent DESCRIPTION and ERRORS wording across these pages.
1241
1242getnameinfo.3
1243 mtk
1244 Relocate misplaced text describing gai_strerror().
1245
1246getnetent.3
1247 Petter Reinholdtsen
1248 s/endservent/endnetent/
1249 As per Debian Bug#316517
1250
1251getspnam.3
1252 Lars Wirzenius / mtk
fe209df6 1253 Replace mention of /etc/shadow by references to
c6e136d5
MK
1254 "shadow password database", and LDAP and NIS.
1255 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=316117
1256 mtk, Claus Weber
1257 Miscellaneous wording improvements
1258 Consistent DESCRIPTION wording vis-a-vis getpwnam.3 etc.
1259
1260hsearch.3
1261 Frederik Deweerdt
1262 Fix hsearch_r() prototype
1263
1264scanf.3
1265 Justin Pryzby / mtk
1266 Fix description of RETURN VALUE
1267 As per Debian Bug#317037
1268 mtk
1269 various parts substantially rewritten; added description of
1270 %n$ form; various text incorporated from the GNU C library
1271 documentation ((C) The Free Software Foundation).
1272
1273shm_open.3
1274 mtk
1275 Modified details of how user and group ownership of a new
1276 object are set.
1277 Various minor wording and formatting cleanups.
1278
1279elf.5
1280 Mike Frysinger
1281 tweaked the short description to include definition of 'ELF'
1282 add ELFOSABI_NONE to the ELFOSABI_ list
1283 tweak/add more machines to EM_ list for ehdr->e_machine
1284 fix indenting to be consistent
1285 tweak the display of the ELF_ST_* macros
1286 document the Elf_Dyn structure
1287
1288proc.5
1289 mtk
1290 Updated discussion of /proc/stat.
1291 Added text on the /proc/sys/fs/mqueue/* files.
1292
1293ip.7
1294 Steven Murdoch
1295 Change protocol in UDP prototype.
1296 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=182635
1297
1298tcp.7
1299 Dov Murik
1300 The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
1301 makes no grammatical sense (and possibly also no technical sense).
1302 It has been removed.
3fa70acd
MK
1303
1304
1305==================== Changes in man-pages-2.07 ====================
1306
1307Released: 2005-07-19
1308
1309Contributors
1310------------
1311
1312The following people contributed notes, ideas, or patches that have
1313been incorporated in changes in this release:
1314
1315Andries Brouwer <Andries.Brouwer@cwi.nl>
1316Mike Frysinger <vapier@gentoo.org>
1317
1318Apologies if I missed anyone!
1319
1320Global changes
1321--------------
1322
1323The terms "set-user-ID" and "set-group-ID" are now used consistently
1324(no abbreviations) across all manual pages.
1325
1326Consistent use of "saved set-user-ID" and "saved set-group-ID"
dba4b377 1327(no more "saved user ID", "saved effective UID", saved group ID", etc.)
3fa70acd
MK
1328
1329Global fixes in textual descriptions:
1330
1331 uid --> UID
1332 gid --> GID
1333 pid --> PID
1334 id --> ID
1335
1336Consistent use of st_atime, st_ctime, st_mtime, with explanatory text,
1337instead of atime/ctime/mtime.
1338
1339Classical BSD versions are now always named x.yBSD (formerly
1340there was a mix of x.yBSD and BSD x.y).
1341
1342Typographical or grammatical errors have been corrected in several
1343places.
1344
1345
1346Changes to individual pages
1347---------------------------
1348
1349setresuid.2
1350 mtk
1351 Some rewording.
1352
1353stat.2
1354 Mike Frysinger
1355 Improve description of st_dev and st_rdev.
1356 mtk
1357 Various wording and formatting improvements.
1358
1359truncate.2
1360 mtk
1361 Some formatting fixes
6859d357
MK
1362
1363
1364==================== Changes in man-pages-2.08 ====================
1365
1366Released: 2005-09-21
1367
1368Contributors
1369------------
1370
1371The following people contributed notes, ideas, or patches that have
1372been incorporated in changes in this release:
1373
1374Adrian Bunk <bunk@stusta.de>
1375Alain PORTAL <aportal@univ-montp2.fr>
1376Andrew Pimlott <andrew@pimlott.net>
1377Andries Brouwer <Andries.Brouwer@cwi.nl>
1378Baurzhan Ismagulov <ibr@radix50.net>
1379Bernhard R. Link <brlink@debian.org>
dba4b377 1380Bodo Stroesser <bstroesser@fujitsu-siemens.com>
6859d357
MK
1381David N. Welton <davidw@eidetix.com>
1382Dov Murik <dov@dv-networks.com>
1383Heikki Orsila <shd@modeemi.cs.tut.fi>
1384Hasso Tepper <hasso@estpak.ee>
1385Hrvoje Niksic <hniksic@xemacs.org>
1386Justin Pryzby <justinpryzby@users.sourceforge.net>
1387Ludovic Courtes <ludovic.courtes@laas.fr>
1388Mike Frysinger <vapier@gentoo.org>
1389Nicolas Francois <nicolas.francois@centraliens.net>
1390Norbert Buchmuller <norbi.spam@nix.hu>
1391Paul Brook <paul@nowt.org>
1392Ramiro Aceves <ea1abz@gmail.com>
1393Tommy Pettersson <ptp@lysator.liu.se>
1394Walter Harms <walter.harms@informatik.uni-oldenburg.de>
1395
1396Apologies if I missed anyone!
1397
1398Global changes
1399--------------
1400
1401RFC references are now always written as "RFC\ nnn" (not "RFC nnn" or
1402"RFCnnn").
1403
1404Typographical or grammatical errors have been corrected in several
1405places.
1406
1407
1408Changes to individual pages
1409---------------------------
1410
1411du.1
1412 Mike Frysinger
1413 To get an effect like "-h", BLOCKSIZE must start with "human",
1414 not "HUMAN".
1415
1416time.1
1417 Mike Frysinger
1418 s/standard output/standard error/
1419
1420clone.2
1421 Paul Brook / mtk
1422 Fix small error in description of CLONE_PARENT_SETTID
1423
1424connect.2
1425 Heikki Orsila
1426 Add EINTR error
1427 See http://lkml.org/lkml/2005/7/12/254
1428
1429getpriority.2
1430 mtk
1431 Expanded discussion of relationship between user and kernel
1432 representations of the nice value.
1433
1434 Added discussion of RLIMIT_NICE and a cross reference to
1435 getrlimit.2 under the description of the EACCES error.
1436
1437 Noted 2.6.12 change in credentials checking for setpriority().
1438
1439getrlimit.2
1440 mtk
1441 Added description of RLIMIT_RTPRIO
1442
1443 Added description of RLIMIT_NICE
1444
1445mmap.2
1446 mtk
1447 Noted bug in MAP_POPULATE for kernels before 2.6.7.
1448
1449mremap.2
1450 mtk
1451 Added _GNU_SOURCE to prototype.
1452 Rewrote description of MREMAP_MAYMOVE.
1453 Rewrote description of EAGAIN error.
1454 Added discussion of resizing of memory locks.
1455 Added entries to SEE ALSO.
1456 Some formatting fixes.
1457
1458msgctl.2
1459 mtk
1460 Added IPC_INFO, MSG_INFO, MSG_STAT descriptions.
1461
1462nanosleep.2
1463 Baurzhan Ismagulov
1464 Add to prototype: define _POSIX_C_SOURCE 199309
1465 As per Debian bug 314435
1466
1467nice.2
1468 mtk
1469 Added sentence noting that range of the nice value is described
1470 in getpriority.2.
1471 Added cross-reference to setrlimit(2) for discussion on
1472 RLIMIT_NICE.
1473
1474outb.2
1475 David N. Welton / Justin Pryzby / mtk
1476 Clarified the order of value and port arguments;
1477 As per Debian bug 263756
1478
1479pause.2
1480 mtk
1481 Added SEE ALSO for sigsuspend.2
1482 Some formatting fixes.
1483
1484poll.2
1485 Tommy Pettersson
1486 nfds should be prototyped as nfds_t
1487 As per Debian bug 322934
1488
1489 mtk
1490 Some wording and formatting improvements.
1491
1492prctl.2
1493 mtk
1494 Since kernel 2.6.13 PR_SET_DUMPABLE can also have the value 2.
1495
1496rand.3
1497 Hrvoje Niksic / mtk
1498 Remove misleading text describing FreeBSD's sranddev() function.
1499 As per debian bug 328629
1500
1501readv.2
1502 mtk / Walter harms
1503 Added LINUX NOTES on trickery performed by glibc when
1504 vector size exceeds IOV_MAX.
1505
1506 Formatting clean-ups.
1507
1508remap_file_pages.2
1509 mtk
1510 Added text to note that start and size are both rounded downwards.
1511
1512sched_setparam.2
1513 mtk
1514 Modified discussion of privileges; added pointer to
1515 sched_setscheduler.2 for a discussion of privileges and
1516 resource limits.
1517
1518sched_setscheduler.2
1519 mtk
1520 Modified discussion of privileges; added discussion of RLIMIT_RTPRIO.
1521
1522semctl.2
1523 mtk
1524 Added IPC_INFO, SEM_INFO, SEM_STAT descriptions.
1525
1526shmctl.2
1527 mtk
1528 Added IPC_INFO, SHM_INFO, SHM_STAT descriptions.
1529
1530sigaction.2
1531 mtk
1532 Split sigpending(), sigprocmask(), and sigsuspend() out
1533 into separate new pages.
1534
1535 Other minor changes
1536
1537 mtk
dba4b377 1538 NOTES: described SA_NODEFER / sa_mask bug which was present in
6859d357
MK
1539 all kernels up to and including 2.6.13.
1540 See http://marc.theaimsgroup.com/?l=linux-kernel&m=112360948603171&w=2
1541 and http://marc.theaimsgroup.com/?l=linux-kernel&m=112362164911432&w=2
1542 List: linux-kernel
1543 Subject: Signal handling possibly wrong
1544 From: Bodo Stroesser
1545 Date: 2005-08-09 17:44:06
1546
1547signal.2
1548 mtk
1549 Updated SEE ALSO to reflect splitting of sigaction.2 into
1550 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1551
1552sigpending.2
1553 mtk
1554 New page created by splitting out from sigaction.2
1555 Changed CONFORMING TO.
1556
1557sigprocmask.2
1558 mtk
1559 New page created by splitting out from sigaction.2
1560 Added text on effect of NULL for 'set' argument.
1561 Added text noting effect of ignoring SIGBUS, SIGFPE, SIGILL,
1562 and SIGSEGV.
1563 Noted that sigprocmask() can't be used in multithreaded process.
1564 Fixed EINVAL error diagnostic.
1565 Changed CONFORMING TO.
1566
1567sigsuspend.2
1568 mtk
1569 New page created by splitting out from sigaction.2
1570 Added NOTES on usage.
1571 Added new text to DESCRIPTION.
1572 Changed CONFORMING TO.
1573
1574stat.2
1575 Mike Frysinger
1576 Improve st_blocks description.
1577
1578carg.3
1579 Ramiro Aceves / aeb
1580 Change:
1581 One has carg(z) = atan(creal(z) / cimag(z))
1582 to:
1583 One has tan(carg(z)) = cimag(z) / creal(z)
1584
1585 As per Debian bug 326720
1586
1587cmsg.3
1588 mtk
1589 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1590
1591dlopen.3
1592 Alain Portal
1593 s/-nostartupfiles/-nostartfiles/
1594
1595getaddrinfo.3
1596 mtk
1597 Nowadays (since 2.3.4) glibc only sets the first ai_canonname
1598 field if AI_CANONNAME was specified (the current behavior
1599 is all that SUSv3 requires).
1600
1601 1,$s/PF_/AF_/g
1602
1603 Added descriptions of AI_ALL, AI_ADDRCONFIG, AI_V4MAPPED,
1604 and AI_NUMERICSERV.
1605
1606 Some wording and formatting fixes.
1607
1608getpwnam.3
1609 Bernhard R. Link / mtk
1610 Add NOTES text describing relationship of pw_dir and HOME and
1611 pointing out that applications should preferentially
1612 inspect HOME
1613
1614inet.3
1615 Mike Frysinger
1616 Mention "little endian" and "big endian".
1617 Added note about octal and hex interpretation of
1618 numbers-and-dots notation.
1619
1620rpc.3
1621 mtk / Ludovic Courtes
1622 Commented out references to rpc_secure(3) -- we don't currently
1623 have such a page in the man-pages set.
1624 In response to Debian bug report 325115
1625
1626setenv.3
1627 mtk
1628 glibc 2.3.4 fixed the "name contains '='" bug
1629
1630strnlen.3
1631 Mike Frysinger
1632 Added "#define _GNU_SOURCE" to prototype.
1633
1634initrd.4
1635 Norbert Buchmuller / mtk
1636 Added text noting that the use or real-root-dev for changing
1637 the root device is obsolete, in favour of pivot root.
1638 (However, the page still needs to be rewritten to actually
1639 describe the pivot_root method...)
1640 As per Debian bug 323621.
1641
1642proc.5
1643 mtk
1644 Improve text describing /proc/sys/fs/mqueue/* files
1645
1646 Describe /proc/sys/fs/suid_dumpable (new in 2.6.13)
1647
1648 Added placeholder mention of /proc/zoneinfo (new in 2.6.13)
1649 More needs to be said about this file
1650
1651 Repaired earlier cut and paste mistake which resulted
1652 in part of the text of this page being duplicated.
1653
1654utmp.5
1655 Mike Frysinger
1656 Added text on biarch details for ut_session and ut_tv.
1657
1658capabilities.7
1659 mtk
1660 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE.
1661
1662ip.7
1663 mtk / Andrew Pimlott
1664 Add a couple of words to make it clear that port is a 16-bit number.
1665 Reformat long source lines (no text changed).
1666
1667 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1668
1669 Hasso Tepper
1670 Fix discussion of IPC_RECVTTL / IP_TTL
1671
1672signal.7
1673 mtk
1674 Updated SEE ALSO to reflect splitting of sigaction.2 into
1675 sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
1676
1677socket.7
1678 mtk
1679 Clarified details of use of SO_PEERCRED.
1680
1681tcp.7
1682 mtk
1683 s/SOL_TCP/IPPROTO_TCP/ (POSIX standard name)
1684 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
1685
1686udp.7
1687 mtk
1688 Added description of UDP_CORK socket option
1689
1690 s/SOL_UDP/IPPROTO_UDP/ (POSIX standard name)
1691 s/SOL_IP/IPPROTO_IP/ (POSIX standard name)
cffe816e
MK
1692
1693
1694==================== Changes in man-pages-2.09 ====================
1695
1696Released: 2005-10-13
1697
1698Contributors
1699------------
1700
1701The following people contributed notes, ideas, or patches that have
1702been incorporated in changes in this release:
1703
1704Justin Pryzby <pryzbyj@justinpryzby.com>
1705Peter Chubb <peterc@gelato.unsw.edu.au>
1706Samuel Thibault <samuel.thibault@ens-lyon.org>
1707Tomas Pospisek <tpo_deb@sourcepole.ch>
1708Trond Myklebust <trond.myklebust@fys.uio.no>
1709
1710Apologies if I missed anyone!
1711
1712Global changes
1713--------------
1714
1715ptsname.3
1716getpt.3
1717unlockpt.3
1718openpty.3
1719posix_openpt.3
1720grantpt.3
1721pts.4
1722tty_ioctl.4
1723 mtk
1724 Added SEE ALSO for new pty.7 page
1725
1726Typographical or grammatical errors have been corrected in several
1727places.
1728
1729
1730New pages
1731---------
1732
1733pty.7
1734 mtk
1735 Overview of Unix 98 and BSD pseudo-terminals.
1736
1737
1738Changes to individual pages
1739---------------------------
1740
1741ldd.1
1742 mtk
1743 Remove "-V" option (fix from Fedora man-pages-2.07-7).
1744
1745fcntl.2
1746 Peter Chubb / Trond Myklebust / mtk
1747 Since kernel 2.6.10, a read lease can only be placed on a
1748 file descriptor that is opened read-only.
1749 See the following LKML thread of Aug 2005
1750 ("fcntl(F GETLEASE) semantics??"):
1751 http://marc.theaimsgroup.com/?l=linux-kernel&m=112371777712197&w=2
1752 http://marc.theaimsgroup.com/?l=linux-kernel&m=112374818213000&w=2
1753 http://marc.theaimsgroup.com/?l=linux-kernel&m=112376335305284&w=2
1754 http://marc.theaimsgroup.com/?l=linux-kernel&m=112377294030092&w=2
1755
1756mprotect.2
1757 mtk
1758 Add new text to ENOMEM error
1759
1760mremap.2
1761 mtk
1762 Added description of MREMAP_FIXED and 'new_address' argument
1763 under NOTES.
1764 Revised text of EINVAL error.
1765
1766read.2
1767 Samuel Thibault / mtk
1768 read() can fail with EINVAL when using O_DIRECT
1769 mtk
1770 Added open(2) to SEE ALSO
1771
1772shmget.2
1773 mtk
1774 s/int/size_t/ for type of 'size' argument (fix from
1775 Fedora man-pages-2.07-7).
1776
1777write.2
1778 Samuel Thibault / mtk
1779 write() can fail with EINVAL when using O_DIRECT
1780
1781atanh.3
1782 mtk
1783 Fix: s/acosh/atanh/ (fix from Fedora man-pages-2.07-7)
1784
1785fopen.3
1786 mtk
1787 Improved "a+" description (fix from Fedora man-pages-2.07-7).
1788
1789getrpcent.3
1790 mtk
1791 s/getrpcent/setrpcent/ (fix from Fedora man-pages-2.07-7).
1792
1793stdio.3
1794 mtk / Justin Pryzby
1795 Removed references to fropen() and fwopen(), which are
1796 BSDisms that don't appear in glibc.
1797 As per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=331174
1798
1799strftime.3
1800 mtk
1801 Typo fix: %Ry ==> %Ey [SUSv3 mentions...] (fix from
1802 Fedora man-pages-2.07-7).
1803
1804nsswitch.conf.5
1805 mtk
1806 s/network/networks/ (fix from Fedora man-pages-2.07-7).
1807
1808proc.5
1809 mtk
1810 Added description of /proc/sys/vm/legacy_va_layout.
1811
1812socket.7
1813 mtk
1814 Update description of SO_RCVLOWAT and SO_SNDLOWAT.
1815 (fix derived from Fedora man-pages-2.07-7).
d85bdf28
MK
1816
1817
1818==================== Changes in man-pages-2.10 ====================
1819
1820Released: 2005-10-19
1821
1822Global changes
1823--------------
1824
1825The changes in this release consist *solely* of formatting fixes, with
1826the aim bringing greater consistency to the manual pages according to
1827the following rules:
1828
1829-- Function name references should *always* be followed by
1830 parentheses, "()" (possibly containing a manual page section
1831 number).
1832
1833-- The parentheses following a function name should *not* be
1834 formatted. Thus, for example, instead of:
1835
1836 .B name()
1837
1838 one should write:
1839
1840 .BR name ()
1841
1842Much of the change was automated using two scripts:
1843add_parens_for_own_funcs.sh and unformat_parens.sh.
1844For the (possible) benefit of downstream manual page maintainers and
1845translators, I have placed these scripts in a new subdirectory 'scripts'.
1846
1847NOTE THE FOLLOWING POINTS WELL:
1848
1849-- These scripts provide a computer-assisted solution to the above
1850 two goals. However, they are not perfect, and their output should
1851 be scanned by a human. (To see what changes the two scripts
1852 *would* make, without making them, use the "-n" command line option.)
1853
1854-- The scripts do not fix all instances that violate the above rules:
1855 some manual fixes are required. Two further scripts are provided
1856 to help find remaining instances of function names without
1857 following "()": find_dots_no_parens.sh and find_slashes_no_parens.sh.
1858
1859The following changes were made:
1860
1861-- add_parens_for_own_funcs.sh was applied to the pages in Sections
1862 2 and 3.
1863
1864-- unformat_parens.sh was applied to pages in Sections 2, 3, 4, and 7
1865 (the only sections where such changes were required).
1866
1867-- further changes (not so very many) were performed by hand.
1868 (found places to fix with the assistance of find_dots_no_parens.sh
1869 and find_slashes_no_parens.sh).
773df4c9
MK
1870
1871
1872==================== Changes in man-pages-2.11 ====================
1873
1874Released: 2005-10-24
1875
1876Contributors
1877------------
1878
1879The following people contributed notes, ideas, or patches that have
1880been incorporated in changes in this release:
1881
1882Alain PORTAL <aportal@univ-montp2.fr>
1883
1884Apologies if I missed anyone!
1885
1886Global changes
1887--------------
1888
1889Most instances of the constant "NULL" are not formatted (bolded) in
1890man pages, but a few are. For consistency, formatting on "NULL" has
1891been removed where it occurred.
1892
1893Many minor formatting fixes were made.
1894
1895Typographical or grammatical errors have been corrected in several
1896places.
1897
1898
1899Changes to individual pages
1900---------------------------
1901
1902getrlimit.2
1903 mtk
1904 Added EINVAL error for rlim_cur > rlim_max when calling setrlimit().
1905
1906path_resolution.2
1907 mtk
8ce5e7ac
MK
1908 Repaired discussion of capabilities and file system UID, which
1909 mistakenly had involved exec() in the discussion.
773df4c9
MK
1910
1911prctl.2
1912 mtk
1913 Removed text saying there is no library interface. There
8ce5e7ac 1914 is nowadays.
773df4c9
MK
1915
1916mkfifo.3
1917 mtk
1918 Minor change to RETURN VALUE text.
1919
1920sk98lin.4
1921 Alain Portal
8ce5e7ac 1922 Formatting fixes
773df4c9
MK
1923
1924capabilities.7
1925 mtk
1926 Minor changes
202a8610
MK
1927
1928
1929==================== Changes in man-pages-2.12 ====================
1930
1931Released: 2005-10-31
1932
1933Contributors
1934------------
1935
1936The following people contributed notes, ideas, or patches that have
1937been incorporated in changes in this release:
1938
1939Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
1940Andries Brouwer <Andries.Brouwer@cwi.nl>
1941Brian M. Carlson <sandals@crustytoothpaste.ath.cx>
1942herbert@gondor.apana.org.au
1943Martin Landers <martin.landers@treibgut.net>
1944Michael Benedict <benedict@starbak.net>
1945
1946Apologies if I missed anyone!
1947
1948Global changes
1949--------------
1950
1951Typographical or grammatical errors have been corrected in several
1952places.
1953
1954
1955Changes to individual pages
1956---------------------------
1957
1958mlock.2
1959 mtk
1960 Reworded text around PAGESIZE, noting also that
1961 sysconf(_SC_PAGESIZE) can be used.
1962
1963path_resolution.2
1964 mtk / aeb
1965 Removed words "as well" (added in 2.11) from the phrase
1966 "and it gets these last five capabilities if its fsuid is 0 as well"
1967 since there are (unusual) situations in which fsuid can be 0 while
1968 the effective UID is not.
1969
1970 Reworked (cut down) discussion of capabilities, moving part of
1971 it into capabilities.7
1972
1973setresuid.2
1974 mtk
1975 Add text to note that setresuid() always modifies the file
1976 system UID, and setresgid() likewise always modifies the file
1977 system GID.
1978
1979shmget.2
1980 mtk
1981 Added (brief) description of SHM_HUGETLB.
1982
1983sigaltstack.2
1984 mtk / Martin Landers
1985 Noted that ss_sp is automatically aligned by the kernel.
1986
1987byteorder.3
1988 Brian M. Carlson / herbert@gondor.apana.org.au
1989 Change <netinet/in.h> to <arpa/inet.h> in prototype; add text
1990 explaining that some systems need the former header.
1991 As per Debian bug 265244
1992
1993capabilities.7
1994 mtk
1995 Reworked part of the discussion of exec() and capabilities.
1996 Added sub-section "Effect of User ID Changes on Capabilities".
1997 Reworked discussion of CAP_SYS_ADMIN and file-max.
2d4596fc
MK
1998
1999
2000==================== Changes in man-pages-2.13 ====================
2001
2002Released: 2005-11-03
2003
2004This release consists entirely of formatting and typographical fixes.
2005
2006Global changes
2007--------------
2008
2009Typographical or grammatical errors have been corrected in several
2010places.
2011
2012Function and page cross references that were italicised were made bold
2013(which is how the majority of function and page cross references
2014were already done).
2015
2016Instances of things like "NULL-terminated string" were changed to
2017"null-terminated string".
2018
2019Pathnames, structures, arguments, and <header-files> that were bold
2020were changed to italics.
2021
2022Instances of the constant "NULL" that were bold-faced were made
2023unformatted (which is how most instances of "NULL" were already
2024formatted.)
565ecc02
MK
2025
2026
2027==================== Changes in man-pages-2.14 ====================
2028
2029Released: 2005-11-17
2030
2031Contributors
2032------------
2033
2034The following people contributed notes, ideas, or patches that have
2035been incorporated in changes in this release:
2036
2037Angelo <ang3l0@katamail.com>
2038Avery Pennarun <apenwarr@nit.ca>
2039Justin Pryzby <justinpryzby@users.sourceforge.net>
2040Martin (Joey) Schulze <joey@infodrom.org>
2041Stefan BrĂ¼ns <stefan.bruens@rwth-aachen.de>
2042Volker Reichelt <reichelt@igpm.rwth-aachen.de>
2043
2044Apologies if I missed anyone!
2045
2046Global changes
2047--------------
2048
2049Typographical or grammatical errors have been corrected in several
2050places.
2051
2052New pages
2053---------
2054
2055rexec.3
2056 mtk / Justin Pryzby
2057 This page is taken as is from the FreeBSD 5.4 distribution.
2058 (Not checked against Linux reality, but likely things are
2059 the same.)
2060 See also Debian bug 336875.
2061
2062Changes to individual pages
2063---------------------------
2064
2065arch_prctl.2
2066 mtk
2067 Updated discussion about lack of prototype in glibc.
2068
2069execve.2
2070 mtk
2071 Improved description of E2BIG error: it relates to the sum
2072 of the bytes in both environment and argument list.
2073
2074fcntl.2
2075 mtk
2076 Clarified parts of the discussion of file leases,
2077 noting effect of open(O_NONBLOCK), interruption
2078 by signal handler, or termination by signal in
2079 lease breaker.
2080 In response to Debian bug 339037.
2081
2082stat.2
2083 mtk / Stefan BrĂ¼ns
2084 Added LINUX NOTES describing nanosecond timestamps.
2085
2086frexp.3
2087 Volker Reichelt / mtk
2088 Fixed to point out that that frexp() returns a number whose
2089 *absolute* value is >= 0.5 and < 1. Amended the example
2090 program to demonstrate this.
2091
2092open.2
2093 mtk / Avery Pennarun
2094 Add EWOULDBLOCK error for file leases.
2095 In response to Debian bug 339037.
2096
2097putenv.3
2098 mtk
2099 Although the glibc implementation returns -1 on error (and some
2100 other man pages (e.g., the BSDs) also document that value for
2101 error returns), SUSv3 merely says "non-zero" (and this is
2102 what manual pages on many implementations also say).
2103
2104posix_memalign.3
2105 mtk
af83a637 2106 Formerly, the page said that all systems declare memalign() in
565ecc02
MK
2107 <malloc.h>. In fact, many declare it in <stdlib.h>.
2108
2109strtok.3
2110 mtk
af83a637 2111 Almost a complete rewrite after Angelo pointed out
565ecc02
MK
2112 that the existing page was deficient.
2113
2114sd.4
2115 Martin Schulze
2116 Remove SEE ALSO for non-existent scsi.4.
2117
2118proc.5
2119 mtk
2120 Updated discussion of /proc/sys/kernel/pid_max.
2121
2122signal.7
2123 mtk
2124 Added pthreads.7 to SEE ALSO.
2125
2126ld.so.8
2127 mtk
2128 Fix typo: s/LD_DEBUG_OUTPUT/LD_PROFILE_OUTPUT/
2129
ce9cd1fa
MK
2130
2131==================== Changes in man-pages-2.15 ====================
2132
2133Released: 2005-11-30
2134
2135Contributors
2136------------
2137
2138The following people contributed notes, ideas, or patches that have
2139been incorporated in changes in this release:
2140
2141Andries Brouwer <Andries.Brouwer@cwi.nl>
2142James Vega <jamessan@debian.org>
2143Malcolm Scott <mas90@io.malc.org.uk>
2144Senthil Kumar <senthilkumar_sen@hotpop.com>
2145
2146Apologies if I missed anyone!
2147
2148Global changes
2149--------------
2150
2151Typographical or grammatical errors have been corrected in several
2152places.
2153
2154New pages
2155---------
2156
2157sigvec.3 -- for details, see below.
2158
2159sigset.3 -- for details, see below.
2160
2161Changes to individual pages
2162---------------------------
2163
2164kill.2
2165 mtk
2166 Added text describing the 2.6.[0-7] EPERM bug that occurred
2167 when sending signals to a process group.
2168
2169sigaction.2
2170 mtk
2171 Noted that si_signo is unused on Linux.
2172
2173sigpending.2
2174 mtk
2175 Added BUGS noting wrapper function problem that existed
2176 in glibc versions <= 2.2.1.
2177
2178sigpause.2
2179 mtk
2180 Moved to section 3; see also sigpause.3 below.
2181
2182sigsetops.3
2183 mtk
2184 Added a GLIBC NOTES section describing sigisemptyset(),
2185 sigandset(), and sigorset().
2186
2187sigvec.2
2188sigblock.2
2189 mtk
2190 These pages have been deleted, and replaced by a new sigvec.3
2191 man page that more fully describes the BSD signal API.
2192
2193siggetmask.2
2194sigmask.2
2195sigsetmask.2
2196 mtk
2197 These links to the now-deleted sigblock.2 have been also been
2198 deleted. They are replaced by corresponding links in Section 3:
2199 sigmask.3, sigsetmask.3, siggetmask.3.
2200
2201sigvec.3
2202 mtk
2203 This new page is provides a fuller description of the
2204 BSD signal API than was provided in the now-deleted sigvec.2
2205 and sigblock.2.
2206
2207sigblock.3
2208siggetmask.3
2209sigmask.3
2210sigsetmask.3
2211 mtk
2212 Created as links to sigvec.3.
2213
2214sigpause.3
2215 mtk
2216 Moved here from Section 2.
2217
2218 Some minor wording fixes; clarified System V origins of
2219 X/Open flavour of this function.
2220
2221sigset.3
2222 mtk
2223 New page describing the System V signal API: sigset(), sighold(),
2224 sigrelse(), sigignore().
2225
2226strftime.3
2227 James Vega
2228 Add further text clarifying that %+ specifier is not supported in
2229 glibc2.
2230 mtk
2231 Added GLIBC NOTES section describing optional 'flag' and 'width'
2232 components of conversion specifiers.
2233 Some wording changes to bring terminology closer to SUSv3.
2234 Added an example program.
2235
2236vm86old.2
2237 mtk / aeb
2238 Add as new linik to vm86.2.
2239
2240intro.7
2241 mtk
2242 Added a few words to reflect the fact that several of the section
2243 7 pages provide overviews of various topics.
2244
2245signal.7
2246 mtk
2247 Added some SEE ALSO entries.
2248
2249socket.7
2250 Senthil Kumar / mtk
2251 Added text noting that select()/poll() do not respect SO_RCVLOWAT.
2252
2253udp.7
2254 Malcolm Scott
2255 s/tcp_socket/udp_socket/ in example
2256 Fixes Debian bug 340927
67497d82
MK
2257
2258
2259==================== Changes in man-pages-2.16 ====================
2260
2261Released: 2005-12-02
2262
2263Contributors
2264------------
2265
2266The following people contributed notes, ideas, or patches that have
2267been incorporated in changes in this release:
2268
2269Alan Stern <stern@rowland.harvard.edu>
2270Andries Brouwer <Andries.Brouwer@cwi.nl>
2271Urs Thuermann <urs@isnogud.escape.de>
2272
2273Apologies if I missed anyone!
2274
2275Global changes
2276--------------
2277
2278Typographical or grammatical errors have been corrected in several
2279places.
2280
2281
2282Changes to individual pages
2283---------------------------
2284
2285HOWTOHELP
2286 Urs Thuermann
2287 Added instructions for finding maintainer in Debian package.
2288
2289poll.2
2290 mtk
26785b48 2291 Added NOTES about INFTIM constant provided on some other
67497d82
MK
2292 implementations.
2293
2294shmop.2
2295 Alan Stern
2296 The -1 error return of shmat() should be cast "(void *)".
2297
2298strftime.r
2299 aeb
2300 Remove junk text (actually intended as source code comment
2301 in page).
2302
2303ip.7
2304 Urs Thuermann
2305 Fix a typo: s/SOCK_RAW/SOCK_PACKET/
2306
2307packet.7
2308 Urs Thuermann
2309 Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%
2310
9c7e8803
MK
2311
2312==================== Changes in man-pages-2.17 ====================
2313
2314Released: 2005-12-13
2315
2316Contributors
2317------------
2318
2319The following people contributed notes, ideas, or patches that have
2320been incorporated in changes in this release:
2321
2322Justin Pryzby <justinpryzby@users.sourceforge.net>
2323Michael Haardt <michael@moria.de>
2324Urs Thuermann <urs@isnogud.escape.de>
2325Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2326
2327Apologies if I missed anyone!
2328
2329
2330Global changes
2331--------------
2332
2333Typographical or grammatical errors have been corrected in several
2334places.
2335
2336
2337New pages
2338---------
2339
2340fmemopen.3
2341 Walter Harms / mtk
2342 New documentation for the glibc-specific fmemopen() and
2343 open_memstream(). Based on glibc info page.
2344
2345open_memstream.3
2346 mtk
2347 New link to new fmemopen.3
2348
2349pipe.7
2350 mtk (with prompting and suggestions for improvements by
2351 Michael Haardt)
2352 New page providing overview of pipes and FIFOs.
2353
2354
2355Changes to individual pages
2356---------------------------
2357
2358HOWTOHELP
2359 mtk
2360 Added notes on how to write example programs for manual pages.
2361
2362fork.2
2363 mtk
2364 Added pointers to examples of fork() in wait.2 and pipe.2.
2365
2366pipe.2
2367 mtk
2368 Added an example program.
2369 Added SEE ALSO for new pipe.7 page.
2370
2371wait.2
2372 mtk
2373 Added example program demonstrating use of fork() and waitpid().
2374
2375carg.3
2376 Justin Pryzby
2377 Delete line that should have been deleted when applying
2378 2.08 fix for this page.
2379
2380getaddrinfo.3
2381 mtk
2382 Rearranged EAI_* list alphabetically.
2383
2384inet.3
2385 mtk
2386 Added GLIBC NOTES describing feature test macros required
2387 to expose declaration of inet_aton().
2388
2389fifo.4
2390 mtk
2391 Added SEE ALSO for new pipe.7 page.
2392
2393environ.5
2394 mtk
2395 Removed BROWSER, since it seems not in fact to be common.
2396
2397socket.7
2398 Urs Thuermann
2399 Added documentation of SO_TIMESTAMP.
2400
2401tcp.7
2402 mtk
2403 Noted 200 millisecond ceiling imposed on TCP_CORK.
2404
2405udp.7
2406 mtk
2407 Rearranged options into something approximating alphabetical order.
2408
a88415fa
MK
2409
2410==================== Changes in man-pages-2.18 ====================
2411
2412Released: 2005-12-15
2413
2414Contributors
2415------------
2416
2417The following people contributed notes, ideas, or patches that have
2418been incorporated in changes in this release:
2419
2420Justin Pryzby <justinpryzby@users.sf.net>
2421Karsten Sperling <karsten.sperling@stud.uni-karlsruhe.de>
2422Martin (Joey) Schulze <joey@infodrom.org>
2423Mike Frysinger <vapier@gentoo.org>
2424Stefan Puiu <stefanpuiuro@yahoo.com>
2425
2426Apologies if I missed anyone!
2427
2428
2429Global changes
2430--------------
2431
2432Typographical or grammatical errors have been corrected in several
2433places.
2434
2435
2436Changes to individual pages
2437---------------------------
2438
2439bind.2
2440 mtk
2441 Added mention of AF_INET6 address family.
2442 Added discussion of sockaddr structure and an example in the
2443 Unix domain.
2444
2445recv.2
2446 mtk
2447 Put 'flags' list in alphabetical order.
2448
2449send.2
2450 mtk
2451 Added cross-reference from discussion of MSG_MORE to UDP_CORK
2452 in udp(7).
2453
2454 Put 'flags' list in alphabetical order.
2455
2456err.3
2457 mtk
2458 Added CONFORMING TO section noting that these are
2459 non-standard BSDisms.
2460
2461errno.3
2462 Justin Pryzby
2463 Added SEE ALSO for err.3 (Debian bug 306867)
2464
2465gethostbyname.3
2466 Martin (Joey) Schulze / mtk
2467 Added references to nsswitch.conf(5); remove cross references
2468 to resolv+(8). (See also Debian Bug#308397.)
2469
2470perror.3
2471 Justin Pryzby
2472 Added SEE ALSO for err.3 (Debian bug 306867)
2473
2474resolver.3
2475 mtk / Martin (Joey) Schulze
2476 Remove cross references to resolv+(8); add cross references to
2477 resolv.conf(5). (See also Debian Bug#214892)
2478
2479 Added SEE ALSO entry for resolver(5) (See Debian Bug#251122.)
2480
2481strerror.3
2482 mtk / Stefan Puiu
2483 Rewrote and extended the discussion of the two flavours of
2484 strerror_r(), and added some additional information on
2485 strerror().
2486 Justin Pryzby
2487 Added SEE ALSO for err.3 (Debian bug 306867)
2488
2489
2490elf.5
2491 Mike Frysinger
2492 Fix three typos in identifier names.
2493
2494operator.7
2495 Karsten Sperling
2496 The + operator should be in the list of unary operators.
2497
2498raw.7
2499 mtk
2500 Small wording changes around discussion of SO_BSDCOMPAT.
2501 Fixed a couple of wording errors elsewhere.
2502 Reformatted some long lines.
2503
2504socket.7
2505 mtk, after a note by Stefan Puiu
2506 Updated discussion of SO_BSDCOMPAT.
2507
2508 Reformatted some long lines.
2509
2510 Noted the Linux-specific feature whereby setsockopt() doubles
2511 the value given for SO_SNDBUF and SO_RCVBUF.
2512
aa651b39 2513 Noted kernel-imposed minimum values for SO_SNDBUF and SO_RCVBUF.
a88415fa
MK
2514
2515udp.7
2516 mtk, after a note by Stefan Puiu
2517 Updated discussion of SO_BSDCOMPAT.
aa651b39 2518 Added unix.7 and ipv6.7 to SEE ALSO.
a88415fa
MK
2519
2520unix.7
2521 mtk
2522 Added new (UN)SUPPORTED FEATURES section in which it is noted
2523 that Unix domain sockets do not support MSG_OOB or MSG_MORE.
2524
2525 Noted details of SO_SNBUF and SO_RCVBUF support for
2526 Unix domain sockets.
12f932b2
MK
2527
2528
2529==================== Changes in man-pages-2.19 ====================
2530
2531Released: 2005-12-23
2532
2533Contributors
2534------------
2535
2536The following people contributed notes, ideas, or patches that have
2537been incorporated in changes in this release:
2538
2539Andries Brouwer <Andries.Brouwer@cwi.nl>
2540Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2541Stefan Puiu <stefanpuiuro@yahoo.com>
2542
2543Apologies if I missed anyone!
2544
2545
2546Global changes
2547--------------
2548
2549Typographical or grammatical errors have been corrected in several
2550places.
2551
2552
2553Changes to individual pages
2554---------------------------
2555
2556HOWTOHELP
2557 mtk
2558 Minor changes.
2559
2560bind.2
2561 Stefan Puiu / mtk
2562 Remove text under EINVAL error: "This may change in the future:
2563 see linux/unix/sock.c for details." This behaviour has been
2564 unchanged for a long time, and seems unlikely to change.
2565
2566 Add EADDRINUSE to errors.
2567
2568send.2
2569 aeb
2570 Add cmsg(3) to SEE ALSO.
2571
2572fopen.3
2573 Walter Harms / mtk
2574 Added description of 'x' mode character (exclusive open).
2575
2576pipe.7
2577 mtk / aeb
2578 Some wording changes to description of pipes.
2579
2548fb7d
MK
2580
2581==================== Changes in man-pages-2.20 ====================
2582
2583Released: 2006-01-03
2584
2585Global changes
2586--------------
2587
2588Typographical or grammatical errors have been corrected in several
2589places.
2590
2591
2592Changes to individual pages
2593---------------------------
2594
2595sigaltstack.2
2596 mtk
2597 Added some text to explain the usual scenario in which
2598 sigaltstack() is employed.
2599
2600getloadavg.3
2601 mtk
2602 Noted that this function is available since glibc 2.2.
2603
2604strcpy.3
2605 mtk
2606 s/nulls/null bytes/
2607
2608capabilities.7
2609 mtk
2610 Noted that capability bounding set appeared with kernel 2.2.11.
2611
2612arp.7
2613icmp.7
2614ip.7
2615ipv6.7
2616netdevice.7
2617packet.7
2618raw.7
2619rtnetlink.7
2620socket.7
2621tcp.7
2622unix.7
2623udp.7
2624 mtk
2625 The only changes to these pages have been for formatting:
2626 -- Structure definitions were changed to K&R style
2627 -- Some long source lines were broken to fit into ~70
2628 character lines.
2629 No changes were made to the content of these pages (yet...).
2630
93e6d731
MK
2631
2632==================== Changes in man-pages-2.21 ====================
2633
2634Released: 2006-01-16
2635
2636Contributors
2637------------
2638
2639The following people contributed notes, ideas, or patches that have
2640been incorporated in changes in this release:
2641
2642Andries Brouwer <Andries.Brouwer@cwi.nl>
2643Falk Hueffner <falk@debian.org>
2644Mike Frysinger <vapier@gentoo.org>
2645Senthil Kumar <senthilkumar_sen@hotpop.com>
2646Stefan Puiu <stefanpuiuro@yahoo.com>
2647
2648Apologies if I missed anyone!
2649
2650
2651Global changes
2652--------------
2653
2654dd.1 cp.1
2655truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2
2656sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2
2657argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3
2658gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3
2659perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3
2660strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3
2661dsp56k.4 tty_ioctl.4
2662elf.5 proc.5 termcap.5
2663charsets.7 unix.7
2664 mtk
2665 Various pages use inconsistent terms for 'null byte' (which
2666 is the C99/SUSv3 term for the '\0' character).
2667
2668 To rectify this the following changes were made in the above
2669 pages:
2670
2671 Replace 'zero byte' with 'null byte'.
2672 Replace 'null character' with 'null byte'.
2673 Replace 'nulls' with 'null bytes'.
2674 Replace 'NUL-terminated' by 'null-terminated'.
2675 Replace 'NUL' by 'null byte'.
2676 Replace 'terminating NUL' by 'terminating null byte'.
2677 Replace 'final NUL' by 'terminating null byte'.
2678 Replace 'NUL character' by 'null byte'.
2679
2680Various pages
2681 mtk
2682 Replace "SysV"/"SYSV" by "System V".
2683
2684Typographical or grammatical errors have been corrected in several
2685places.
2686
2687
2688New pages
2689---------
2690
2691mmap64.3
2692 Mike Frysinger
2693 New link to mmap.2
2694
2695
2696Changes to individual pages
2697---------------------------
2698
2699capget.2
2700 mtk
2701 Noted bug that could wrongly cause EPERM in unprivileged
2702 capset() with 'pid' field == getpid().
2703
2704epoll_ctl.2
2705 mtk
2706 Noted that EPOLLONESHOT was added in 2.6.2.
2707
2708gethostname.2
2709 mtk
2710 Added GLIBC NOTES describing operation of glibc's
2711 gethostname() wrapper function.
2712
2713mmap.2
2714 mtk / Mike Frysinger
2715 Clarify relationship between mmap2(2) and mmap64(3)
2716 mtk
2717 A few other small rewordings.
2718
2719open.2
2720 mtk
2721 Added BUG noting that O_ASYNC can't be enabled via
2722 open(): fcntl() must be used for this purpose.
2723
2724recv.2
2725 Stefan Puiu
2726 Relocate misplaced discussion of MSG_DONTWAIT.
2727
2728dlopen.3
2729 mtk
2730 Rewrote discussion of dlopen() 'flag' argument;
2731 added descriptions of RTLD_NOLOAD, RTLD_DELETE,
2732 and RTLD_DEEPBIND.
2733
2734 Noted use of atexit() to register a function that is
2735 automatically called when a library is unloaded.
2736
2737fmemopen.3
2738 mtk
2739 Rewrote substantial parts of the page, and relicensed under GPL.
2740
2741fseeko.3
2742 Mike Frysinger
2743 Add RETURN VALUE section.
2744
2745getopt.3
2746 mtk
2747 Noted historical use of <stdio.h> to declare getopt().
2748
2749qsort.3
2750 mtk / Falk Hueffner
2751 Clarify how strcmp() should be used as the 'compar'
2752 function by providing an example.
2753 As per Debian bug 348072.
2754
2755proc.5
2756 mtk
2757 Noted that /proc/mounts is pollable since kernel 2.6.15.
2758
2759 Documented /proc/PID/task.
2760
2761 Noted that the contents of /proc/PID/{cwd,exe,fd,root,task}
2762 are not available if the main thread has terminated.
2763
2764 Senthil Kumar
2765 Add pointer to random(4) for description of files under
2766 /proc/sys/kernel/random.
2767
2768udp.7
2769 Stefan Puiu / mtk
2770 Small rewording of discussion of SO_BSDCOMPAT
2771 (add cross-ref to socket(7)).
04a57fff
MK
2772
2773
2774==================== Changes in man-pages-2.22 ====================
2775
2776Released: 2006-02-02
2777
2778Contributors
2779------------
2780
2781The following people contributed notes, ideas, or patches that have
2782been incorporated in changes in this release:
2783
2784Alain Portal <aportal@univ-montp2.fr>
2785Andre Noll <maan@systemlinux.org>
2786Andries Brouwer <Andries.Brouwer@cwi.nl>
2787Colin Tuckley <colin@tuckley.org>
2788Stefan Puiu <stefanpuiuro@yahoo.com>
2789Thomas Hood <jdthood@yahoo.co.uk>
2790Thorsten Kukuk <kukuk@suse.de>
2791Walter Harms <walter.harms@informatik.uni-oldenburg.de>
2792
2793
2794Global changes
2795--------------
2796
2797Typographical or grammatical errors have been corrected in several
2798places.
2799
2800
2801New pages
2802---------
2803
2804rt_sigreturn.2
2805 Thorsten Kukuk
2806 New link to sigreturn.2
2807
2808rt_sigsuspend.2
2809 mtk
2810 New link to sigsuspend.2
2811
2812Changes to individual pages
2813---------------------------
2814
2815mmap.2
2816 aeb/mtk
2817 Noted that portable applications should specify fd as -1
2818 when using MAP_ANONYMOUS.
2819 Some rewriting of description of MAP_ANONYMOUS.
2820
2821waitid.2
2822 mtk
2823 Noted that waitid() does not set infop->si_uid field on
2824 most other implementations.
2825
2826getopt.3
2827 Walter harms / mtk
2828 Make clear that when calling getopt_long() and there are no
2829 short options, then 'optstring' should be "", not NULL.
2830
2831openpty.3
2832 Thomas Hood / mtk
2833 In glibc 2.0.92, openpty() was modified to preferably open
2834 Unix 98 ptys instead of BSD ptys.
2835
2836qsort.3
2837 mtk
2838 Small rewording under EXAMPLES
2839
2840strtol.3
2841strtoul.3
2842 Stefan Puiu
2843 s/string must begin/string may begin/
2844
2845proc.5
2846 mtk
2847 Documented inotify files under /proc/sys/fs/inotify:
2848 max_queued_events, max_user_instances, and max_user_watches.
2849
c9c0d377
MK
2850
2851==================== Changes in man-pages-2.23 ====================
2852
2853Released: 2006-02-10
2854
2855Contributors
2856------------
2857
2858The following people contributed notes, ideas, or patches that have
2859been incorporated in changes in this release:
2860
2861Andi Kleen <ak@muc.de>
2862Britton Leo Kerin <bkerin_rb@letterboxes.org>
2863Dan Jacobson <jidanni@jidanni.org>
2864Justin Pryzby <justinpryzby@users.sourceforge.net>
2865Luc Van Oostenryck <lkml@looxix.net>
2866Kurt Wall <kwall@kurtwerks.com>
2867Martin (Joey) Schulze <joey@infodrom.org>
2868Matthias Andree <matthias.andree@gmx.de>
2869Robert Love <rlove@rlove.org>
2870Samuel Thibault <samuel.thibault@ens-lyon.org>
2871Urs Thuermann <urs@isnogud.escape.de>
2872
2873Apologies if I missed anyone!
2874
2875Global changes
2876--------------
2877
2878Typographical or grammatical errors have been corrected in several
2879places.
2880
2881
2882New pages
2883---------
2884
2885inotify_init.2
2886inotify_add_watch.2
2887inotify_rm_watch.2
2888 Robert Love, with some additions by mtk.
2889 New pages describing the inotify API.
2890
2891mbind.2
2892get_mempolicy.2
2893set_mempolicy.2
2894 Andi Kleen, with additional work by mtk
2895 New pages describing the NUMA memory allocation policy API.
2896
2897rtc.4
c533af9d 2898 Urs Thuermann, with additional work by mtk
c9c0d377
MK
2899 New page describing the real-time clock driver.
2900
2901inotify.7
2902 mtk
2903 Overview of the inotify API.
2904
2905Changes to individual pages
2906---------------------------
2907
2908clone.2
2909 Andi Kleen
2910 On x86, clone() should not be called through vsyscall,
2911 but directly through "int $0x80".
2912
2913fcntl.2
2914 mtk
2915 Small wording changes.
2916
2917 Added cross-ref to inotify.7 under the description of dnotify.
2918
2919kill.2
2920 mtk / Britton Leo Kerin
2921 Small wording change under NOTES to clarify
2922 what happens when a process sends a signal to itself.
2923 See Debian bug 350236.
2924
2925mlock.2
2926 mtk / Matthias Andree
2927 Added BUGS txt on interaction between MCL_FUTURE and
2928 RLIMIT_MEMLOCK.
2929 See the following LKML thread:
2930 http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2
2931 "Rationale for RLIMIT_MEMLOCK"
2932
2933msgop.2
2934 mtk / Samuel Thibault
2935 Rewrote declaration of 'msgp' to be "void *" in response
2936 to Debian bug report 350884.
2937 Various other wording fixes.
2938
2939open.2
2940 mtk
2941 Clarify distinction between "file creation flags" and
2942 "file status flags".
2943
2944read.2
2945 Justin Pryzby
2946 Add SEE ALSO for pread(2).
2947 As per Debian bug 351873.
2948
2949sched_setaffinity.2
2950 mtk
2951 Major rewrite.
2952
2953select.2
2954 mtk
2955 Added return types to prototypes for FD_SET(), FD_CLR(),
2956 FD_ZERO, and FD_ISSET().
2957 Other minor wording changes.
2958
2959read.2
2960 mtk
2961 Add SEE ALSO for pwrite(2).
2962 (Analogous with read.2 change above.)
2963
2964errno.3
2965 Kurt Wall / mtk
2966 Add Linux specific errors to this page.
2967
2968localeconv.3
2969 mtk
2970 Added cross-ref to locale.7 for 'struct lconv' defn.
2971 Other minor wording changes.
2972 Martin (Joey) Schulze
2973 Added SEE ALSO refs for nl_langinfo.3
2974 As per Debian bug 351831.
2975
2976scanf.3
2977 mtk / Justin Pryzby
2978 Minor formatting & wording fixes.
2979
2980setlocale.3
2981 Martin (Joey) Schulze
2982 Added SEE ALSO refs for nl_langinfo.3
2983 As per Debian bug 351831.
2984
2985proc.5
2986 mtk
2987 Migrated description of inotify files to the new inotify.7 page.
2988
2989ascii.7
2990 Dan Jacobson / mtk
2991 Add text describing characters 001 to 037.
2992 See Debian bug 342173.
2993
2994locale.7
2995 mtk
2996 Minor wording and formatting changes.
2997
2998
b8798cc4
MK
2999==================== Changes in man-pages-2.24 ====================
3000
3001Released: 2006-02-17
3002
3003Contributors
3004------------
3005
3006The following people contributed notes, ideas, or patches that have
3007been incorporated in changes in this release:
3008
3009Joerg Habenicht <habenich@planetserver.com>
3010Luc Van Oostenryck <lkml@looxix.net>
3011Mike Frysinger <vapier@gentoo.org>
3012Samuel Thibault <samuel.thibault@ens-lyon.org>
3013
3014Apologies if I missed anyone!
3015
3016
3017New pages
3018---------
3019
3020get_kernel_syms.2
3021create_module.2
3022delete_module.2
3023init_module.2
3024query_module.2
3025 FSF / mtk (with assistance of Luc Van Oostenryck)
3026 man-pages finally gets pages for these system calls, several
3027 of which are obsolete in Linux 2.6.
3028 Took the old GPLed pages dated 1996 and made a number of
3029 clean-ups and minor additions.
3030
3031
3032Global changes
3033--------------
3034
3035various pages
3036 mtk
3037 Change "file name" to "filename"
3038 Change "path name" to "pathname"
3039
3040stpncpy.3
3041strstr.3
3042strcmp.3
3043toupper.3
3044strlen.3
3045stpcpy.3
3046puts.3
3047strdup.3
3048strtok.3
3049isalpha.3
3050strspn.3
3051gets.3
3052strpbrk.3
3053 mtk after a suggestion from Samuel Thibault
3054 Added SEE ALSO pointers to wide character equivalent functions
3055 See Debian bug 351996.
3056
3057Typographical or grammatical errors have been corrected in several
3058places.
3059
3060
3061Changes to individual pages
3062---------------------------
3063
3064clone.2
3065 mtk
3066 Remove duplicate CLONE_STOPPED text.
3067 Commented out crufty text describing EINVAL error
3068 for the now obsolete CLONE_DETACHED flag.
3069 Under CLONE_SIGHAND, noted that 'flags' must also include
3070 CLONE_VM if CLONE_SIGHAND is specified.
3071
3072fcntl.2
3073 mtk
3074 Under ERRORS: Separate out EAGAIN error for locking mmaped files.
3075
3076inotify_add_watch.2
3077 mtk
3078 Minor wording fix.
3079
3080msgop.2
3081 mtk
3082 Documented the EAGAIN error for msgrcv().
3083
3084fnmatch.3
3085 Mike Frysinger / mtk
3086 Expand explanation of FNM_PATHNAME.
3087
3088lockf.3
3089 Joerg Habenicht / mtk
3090 Fix up discussion of EAGAIN/EACCESS errors.
c9c0d377 3091
6ca981dc
MK
3092
3093==================== Changes in man-pages-2.25 ====================
3094
3095Released: 2006-03-02
3096
3097Contributors
3098------------
3099
3100The following people contributed notes, ideas, or patches that have
3101been incorporated in changes in this release:
3102
3103James Peach <jpeach@samba.org>
3104Krzysztof Benedyczak <golbi@mat.uni.torun.pl>
3105Marten von Gagern <Martin.vGagern@gmx.net>
3106Michael Haardt <michael@moria.de>
3107Michael Wronksi <michal.wronski@gmail.com>
3108
3109Apologies if I missed anyone!
3110
3111
3112New pages
3113---------
3114
3115mq_close.3
3116mq_getattr.3
3117mq_notify.3
3118mq_open.3
3119mq_receive.3
3120mq_send.3
3121mq_unlink.3
3122 mtk
3123 New pages describing POSIX message queue API.
3124
3125posix_fallocate.3
3126 mtk, after a suggestion by James Peach
3127 New page describing posix_fallocate().
3128
3129mq_overview.7
3130 mtk
3131 New page giving overview of the POSIX message queue API.
3132
3133
3134Changes to individual pages
3135---------------------------
3136
3137lseek.2
3138 Michael Haardt
3139 Add a case to the EINVAL error text.
3140 mtk
3141 Various minor wording fixes
3142 Added SEE ALSO referring to new posix_fallocate.3.
3143
3144posix_fadvise.2
3145 mtk
3146 Added "#define _XOPEN_SOURCE 600" to prototype.
3147 Added SEE ALSO referring to new posix_fallocate.3.
3148
3149proc.5
3150 mtk
3151 Migrated information on POSIX message queues to new mqueue.7 page.
3152
3153inotify.7
3154 Marten von Gagern
3155 Fix thinko: s/assuming a non-blocking/assuming a blocking/