diff --git a/Changes b/Changes index 9fc24fa7f..80aa1febf 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.14 ==================== +==================== Changes in man-pages-3.15 ==================== -Released: 2008-11-25, Bucaramanga +Released: ????-??-??, Bucaramanga Contributors @@ -9,24 +9,6 @@ Contributors The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: -Andreas Henriksson -Bert Wesarg -Cedric Le Goater -Chris Heath -Eric Biederman -Eugen Dedu -Ivana Varekova -Jen Axboe -Jens Axboe -Loïc Domaigne -Masanari Iida -Paul Evans -Pavel Emelyanov -Pierre-Paul Paquin -Serge E. Hallyn -Stefano Teso -Stew Benedict -Vegard Nossum Apologies if I missed anyone! @@ -34,566 +16,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -CPU_SET.3 - Michael Kerrisk - New page documenting CPU_* macros - This page contains material moved out of sched_setscheduler(2). - It overwrites a previously existing link file with the same name. - Michael Kerrisk - Add description of macros for dynamically allocated CPU sets - Add descriptions of CPU_ALLOC(), CPU_ALLOC_SIZE(), CPU_FREE(), - CPU_SET_S(), CPU_CLR_S(), CPU_ISSET_S(), CPU_ZERO_S(), - CPU_COUNT_S(), CPU_AND_S(), CPU_OR_S(), CPU_XOR_S(), and - CPU_EQUAL_S(). - Michael Kerrisk - Add documentation of CPU_COUNT() - Michael Kerrisk - Add description of CPU_AND(), CPU_OR, CPU_XOR(), and CPU_EQUAL() - Plus a few other small clean-ups of the text - Michael Kerrisk - Various improvements in DESCRIPTION - After review comments by Bert Wesarg: - * Explain that cpu_set_t is a bitset, but should be considered - opaque. - * A CPU set can be duplicated with memset(). - * Size of a CPU set is rounded up to size of long. - * CPU_SETSIZE is in bits, but the setsize argument is in bytes. - Michael Kerrisk - Document CPU_ALLOC()/CPU_ALLOC_SIZE() bug - These macros return twice what they should because of thinko - in glibc 2.8 and earlier. The bug is fixed for glibc 2.9. - http://sourceware.org/bugzilla/show_bug.cgi?id=7029 - Michael Kerrisk - NOTES: Discuss use of types in "prototypes" for these macros - The SYNOPSIS shows types for arguments and return values, but - these are really just suggestions: since the interfaces are - macros, the compiler won't catch all violations of - the "type rules". Warn the reader of this. - -pthread_attr_setinheritsched.3 - Michael Kerrisk - New page for pthread_attr_setinheritsched(3) and - pthread_attr_getinheritsched(3) - -pthread_cancel.3 - Michael Kerrisk - New page for pthread_cancel(3) - -pthread_cleanup_push.3 - Michael Kerrisk - New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3) - -pthread_setcancelstate.3 - Michael Kerrisk - New page for pthread_setcancelstate(3) and pthread_setcanceltype(3) - -pthread_testcancel.3 - Michael Kerrisk - New page for pthread_testcancel(3) - Newly documented interfaces in existing pages --------------------------------------------- -clone.2 - Jens Axboe - Document CLONE_IO (new in Linux 2.6.25) - Some text also by mtk. - Michael Kerrisk - Document CLONE_NEWNET - Michael Kerrisk - Document CLONE_NEWUTS (new in Linux 2.6.19) - Michael Kerrisk - Document CLONE_NEWIPC flag (new in Linux 2.6.19) - Michael Kerrisk - Document CLONE_NEWPID flag (new in Linux 2.6.24) - -mmap.2 - Michael Kerrisk - Document MAP_STACK flag (new in Linux 2.6.27) - -arp.7 - Michael Kerrisk - Document /proc file retrans_time_ms (new in Linux 2.6.12) - Michael Kerrisk - Document /proc file base_reachable_time_ms (new in Linux 2.6.12) - -icmp.7 - Michael Kerrisk - Document icmp_ignore_bogus_error_responses (new in Linux 2.2) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document icmp_ratelimit and icmp_ratemask (new in Linux 2.4.10) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document icmp_echo_ignore_broadcasts (new in Linux 2.6.12) - Text taken from Documentation/networking/ip-sysctl.txt - -tcp.7 - Michael Kerrisk - Document /proc file tcp_slow_start_after_idle (new in Linux 2.6.18) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_base_mss (new in Linux 2.6.17) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_frto_response (new in Linux 2.6.22) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_moderate_rcvbuf (new in Linux 2.4.17/2.6.7) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_congestion_control (new in Linux 2.4.13) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_no_metrics_save (new in Linux 2.6.6) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_mtu_probing (new in Linux 2.6.17) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_dma_copybreak (new in Linux 2.6.24) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_tso_win_divisor (new in Linux 2.6.9) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_allowed_congestion_control (new in Linux 2.4.20) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_workaround_signed_windows (new in Linux 2.6.26) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_available_congestion_control (new in Linux 2.4.20) - Text taken from Documentation/networking/ip-sysctl.txt - Michael Kerrisk - Document /proc file tcp_abc (new in Linux 2.6.15) - Text taken from Documentation/networking/ip-sysctl.txt - -udp.7 - Michael Kerrisk - Document /proc files udp_mem, udp_rmem_min, and udp_wmem_min - All of these are new in Linux 2.6.25 - New and changed links --------------------- -CPU_ALLOC.3 -CPU_ALLOC_SIZE.3 -CPU_AND.3 -CPU_AND_S.3 -CPU_CLR_S.3 -CPU_COUNT.3 -CPU_COUNT_S.3 -CPU_EQUAL.3 -CPU_EQUAL_S.3 -CPU_FREE.3 -CPU_ISSET_S.3 -CPU_OR.3 -CPU_OR_S.3 -CPU_SET_S.3 -CPU_XOR.3 -CPU_XOR_S.3 -CPU_ZERO_S.3 - Michael Kerrisk - New link to new CPU_SET.3 - -CPU_CLR.3 -CPU_ISSET.3 -CPU_ZERO.3 - Michael Kerrisk - Update links to point to CPU_SET.3 - The documentation of the CPU_* macros migrated to a new - location: CPU_SET.3. - -pthread_attr_getinheritsched.3 - Michael Kerrisk - New link to new pthread_attr_setinheritsched.3 - -pthread_cleanup_pop.3 - Michael Kerrisk - New link to new pthread_cleanup_push.3 - -pthread_setcanceltype.3 - Michael Kerrisk - New link to new pthread_setcancelstate.3 - Global changes -------------- -clone.2 -mount.2 -unshare.2 -proc.5 -path_resolution.7 - Michael Kerrisk - Global fix: s/namespace/mount-point namespace/, as appropriate - In recent times, a number of other namespace flags have been - added to clone(2). As such, it is no longer clear to use - the generic term "namespace" to refer to the particular - namespace controlled by CLONE_NEWNS; instead, use the - term "mount-point namespace". - Michael Kerrisk - Global fix: s/mount-point namespace/mount namespace/ - This is more consistent with the term "mounts namespace" - used in the 2008 ACM SIGOPS paper, "Virtual servers - and and checkpoint/restart in mainstream Linux". - (I avoided the "s", because using the plural strikes me - as klunky English, and anyway we don't talk about - the "PIDs namespace" or the "networks namespace", etc..) - -connect.2 -listen.2 -send.2 -uname.2 -cmsg.3 -proc.5 -arp.7 -ddp.7 -icmp.7 -ip.7 -raw.7 -socket.7 -tcp.7 -udp.7 - Michael Kerrisk - Global fix: eliminate mention of the obsolete sysctl(2) interface - Many pages still mention use of the obsolete sysctl(2) system - call, or used the term "sysctls"; rewrite these mentions to - instead be in terms of /proc interfaces. - -fcntl.2 -signal.2 -mbsnrtowcs.3 -mbsrtowcs.3 -mbtowc.3 -wcrtomb.3 -wcsnrtombs.3 -wcsrtombs.3 -wctomb.3 - Michael Kerrisk - Global fix: s/multi-thread/multithread/ - -getdents.2 -pthread_attr_init.3 -pthread_create.3 -pthread_getattr_np.3 -pthread_setaffinity_np.3 -pthread_setschedparam.3 -pthread_tryjoin_np.3 - Michael Kerrisk - Use consistent error-handling function names - Many older pages use a handle_error() macro to do simple - error handling from system and library function calls. - Switch these pages to do similar. - Changes to individual pages --------------------------- -time.1 - Michael Kerrisk - Note that some shells have a 'time' built-in command - Therefore, to access the functionality described on this page, - it may be necessary to specify the full pathname. - -clone.2 - Michael Kerrisk - Place list of CLONE_* flags in alphabetical order - (No content changes.) -fsync.2 - Michael Kerrisk - Update feature test macro requirements for fsync() - Since glibc 2.8, the fsync() declaration is also exposed if - _POSIX_C_SOURCE >= 200112L - -sched_setaffinity.2 - Michael Kerrisk - Add note on system-imposed restrictions on CPUs actually used - After Loic Domaigne's suggestion for pthread_setaffinity_np(3), add - similar text to this page noting that the system silently - limits the set of CPUs on which the process actually runs to - the set of CPUs physically present and the limits imposed by - cpuset(7). - -sched_setaffinity.2 - Michael Kerrisk - Removed discussion of CPU_* macros() - These macros are now moving to a separate page. - Michael Kerrisk - Refer reader to pthread_setaffinity_np(3) - pthread_setaffinity_np() is preferable for setting - thread CPU affinity if using the POSIX threads API. - -sysctl.2 - Michael Kerrisk - Add prominent warning against using this system call - This was already stated under NOTES, but make it even more - prominent by adding a sentence at the start of the DESCRIPTION. - -uname.2 - Michael Kerrisk - Add C comments describing fields in utsname structure - -atan2.3 - Stefano Teso - Fix description of range of function value return - The range is not [-pi/2, pi/2], but [-pi, pi]. - - (mtk: This error was reported by Nicolas Francois, and - should have been fixed in 3.11, but somewhere along the way, - the fix got lost.) - - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=506299 - -bindresvport.3 - Michael Kerrisk - Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT - Glibc switched to using a POSIX-specified error code for - this error case. - - http://bugs.linuxbase.org/show_bug.cgi?id=2375 - -clock_getres.3 - Michael Kerrisk - CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable - According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and - CLOCK_THREAD_CPUTIME_ID clocks should be settable, but - currently they are not. - -getgrnam.3 - Michael Kerrisk - Clarify and add more detail in RETURN VALUE description - The page was a bit fuzzy in describing the return values for - various cases. In particular, it needed to be more explicit - in describing what happens for the "not found" case. - - This is an analogous change to the change for - getpwnam.3, made after Andreas Henriksson's report. - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787 - Michael Kerrisk - Rename arguments to getgrnam_r() and getgrgid_r() - s/gbuf/grp/ and s/gbufp/result/, for consistency - with POSIX.1 argument names. - Michael Kerrisk - Clarify RETURN VALUE description - The page was a bit fuzzy in describing the return values for - various cases. In particular, it needed to be more explicit - in describing what happens for the "not found" case. - - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708 - -getpwnam.3 - Michael Kerrisk - Rename arguments to getpwnam_r() and getpwuid_r() - s/pwbuf/pwd/ and s/pwbufp/result/, for consistency - with POSIX.1 argument names. - Michael Kerrisk - Clarify and add more detail in RETURN VALUE description - The page was a bit fuzzy in describing the return values for - various cases. In particular, it needed to be more explicit - in describing what happens for the "not found" case. - - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787 - Michael Kerrisk - Add an EXAMPLE program for getpwnam_r() - -inet_ntop.3 - Michael Kerrisk - Rename 'cnt' argument to 'size' - This is consistent with POSIX.1, and also a more sensible name. - Michael Kerrisk - Rework text describing 'size' argument - (After a suggestion by Vegard Nossum.) - Also made a few other small rewordings to in the initial - paragraph. - -makecontext.3 - Michael Kerrisk - Add text on use of pointer arguments to makecontext() - Passing pointer arguments to makecontext() is possible, - but only on some architectures, and with no guarantees - of portability. - - http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504699 - -pthread_attr_setaffinity_np.3 - Michael Kerrisk - Various fixes after review by Loic Domaigne - Reviewed-by: Loic Domaigne - -pthread_attr_setaffinity_np.3 -pthread_setaffinity_np.3 - Michael Kerrisk - Update to reflect new location of CPU_*() documentation - The CPU_*() macros are now documented in CPU_SET.3; - update to reflect that fact. - Michael Kerrisk - Remove redundant text relating to CPU sets - Information about CPU_SETSIZE can be found in CPU_SET.3, so - remove discussion of it here. - -pthread_attr_setschedparam.3 -pthread_setschedparam.3 - Michael Kerrisk - Remove text saying that only sched_priority is required by POSIX.1 - Loic Domaigne points out that if a system implements - SCHED_SPORADIC (which Linux does not), then other - fields are also specified in sched_param. The simple - solution is just to remove that phrase from the man - page. - -pthread_cancel.3 -pthread_detach.3 -pthread_join.3 -pthread_setaffinity_np.3 - Michael Kerrisk - Make text of ESRCH error consistent - -pthread_setaffinity_np.3 - Michael Kerrisk - Add text to EINVAL error mentioning cpuset(7) - Michael Kerrisk - Various improvements after review by Loïc Domaigne - Various fix-ups after Loïc's review. - - Reviewed-by: Loïc Domaigne - -pthread_setschedparam.3 - Michael Kerrisk - PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute - In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for - the inherit scheduler attribute attribute. - -syslog.3 - Masanari Iida - LOG_KERN messages can't be generated from user processes - Masanari notes that this is an FAQ for logger(1) and that - Solaris and FreeBSD document this point in syslog(3). - The glibc info page also hides this comment in its source: - - Internally, there is also LOG_KERN, but LOG_KERN == 0, - which means if you try to use it here, just selects default. - -proc.5 - Ivana Varekova - Fix reference to kernel source file - Use relative reference to Documentation/mtrr.txt. - -arp.7 - Michael Kerrisk - Add kernel version numbers for /proc interfaces - -cpuset.7 - Michael Kerrisk - SEE ALSO: add CPU_SET(3) - -epoll.7 - Michael Kerrisk - Note glibc version that added epoll support - -icmp.7 - Michael Kerrisk - Add kernel version numbers to /proc file descriptions - -inotify.7 - Vegard Nossum - Fix description of max_user_watches - It seems that inotify(7) is wrong here: - - "/proc/sys/fs/inotify/max_user_watches - This specifies a limit on the number of watches that can be - associated with each inotify instance." - - On my system, the default value for this variable is 8192. But I - cannot create more than 8192 watches in total for the same UID - even when they are on different inotify instances. So I suggest - to rephrase this as: "This specifies an upper limit on the - number of watches that can be created per real user ID." - -ip.7 - Michael Kerrisk - Reorder socket options alphabetically - Michael Kerrisk - Added kernel version numbers for IP_* socket options - Michael Kerrisk - Relocate kernel version information for IP_PMTUDISC_PROBE - Michael Kerrisk - Add kernel version numbers for /proc/sys/net/ipv4/ip_* files - Michael Kerrisk - Remove mention of kernel header from description of IP_RECVERR - Looks like glibc has had this definition since about version 2.1. - Michael Kerrisk - Relocate kernel version information for ip_mreqn structure - Michael Kerrisk - Relocate info about Linux-specific sockopts to NOTES - Also add some source comments about non-standard Linux-specific - options that are not yet documented. - -netlink.7 - Vegard Nossum - Fix incorrect variable names in example code - s/snl/sa/ * 2 - -pthreads.7 - Michael Kerrisk - Add section on cancellation points - This section includes a list of the functions that must and - may be cancellation points. - Michael Kerrisk - Rework, and fix small error in, thread-safe function list - Integrate the changes that occurred in POSIX.1-2008 into the - main list (to be consistent with the list, elsewhere on this - page, of functions that are cancellation points). - - Also, fix an error that said that strerror() was added to - the list in POSIX.1-2008. It was strsignal() that was - added. (strerror() was already in the list in POSIX.1-2001.) - Michael Kerrisk - Tweak text on sigpause() cancellation point - In POSIX.1-2009, this function moves from the "must be" - to the "may be" list. - Michael Kerrisk - Add ref to signal(7) for further info on use of real-time signals - signal(7) provides some further details on the use of real-time - signals by the two Linux threading implementations. - Michael Kerrisk - SEE ALSO: add pthread_attr_init() and pthread_cancel() - -tcp.7 - Michael Kerrisk - Update description of tcp_rmem defaults for Linux 2.6 - Michael Kerrisk - Add kernel version numbers for TCP_* socket options - Note kernel version were each socket option first appeared. - Michael Kerrisk - The tcp_bic* proc files disappeared in Linux 2.6.13 - Michael Kerrisk - tcp_vegas_cong_avoid disappeared in Linux 2.6.13 - Michael Kerrisk - Add mention of RFC 4138 for 'tcp_frto' /proc file - Michael Kerrisk - Remove mention of /proc in VERSIONS - This information is not indicated for each /proc interface - Michael Kerrisk - Clarify that tcp_mem measures in units of the system page size - Michael Kerrisk - Update tcp_frto description for 2.6.22 changes - Linux 2.6.22 added a mode value 2 ("Enable SACK-enhanced - F-RTO if flow uses SACK"). - Michael Kerrisk - Fix alphabetical order in /proc file list - A few entries were slightly out of order. - Michael Kerrisk - Remove obsolete statement about /proc from VERSIONS - Much of the text has been updated to 2.6.27 or so, - so this statement no longer applies. - Michael Kerrisk - Add kernel version numbers for each /proc interface - Note kernel version where each /proc interface first appeared - Michael Kerrisk - tcp_westwood /proc file disappeared in Linux 2.6.13 - Michael Kerrisk - Update description of tcp_wmem defaults for Linux 2.6 diff --git a/Changes.old b/Changes.old index 5d250c9a2..da37ce59e 100644 --- a/Changes.old +++ b/Changes.old @@ -16086,3 +16086,604 @@ pthreads.7 In particular, note that in each pthreads function that takes a thread ID argument, that ID by definition refers to a thread in the same process as the caller. + + +==================== Changes in man-pages-3.14 ==================== + +Released: 2008-11-25, Bucaramanga + + +Contributors +------------ + +The following people contributed notes, ideas, or patches that have +been incorporated in changes in this release: + +Andreas Henriksson +Bert Wesarg +Cedric Le Goater +Chris Heath +Eric Biederman +Eugen Dedu +Ivana Varekova +Jen Axboe +Jens Axboe +Loïc Domaigne +Masanari Iida +Paul Evans +Pavel Emelyanov +Pierre-Paul Paquin +Serge E. Hallyn +Stefano Teso +Stew Benedict +Vegard Nossum + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +CPU_SET.3 + Michael Kerrisk + New page documenting CPU_* macros + This page contains material moved out of sched_setscheduler(2). + It overwrites a previously existing link file with the same name. + Michael Kerrisk + Add description of macros for dynamically allocated CPU sets + Add descriptions of CPU_ALLOC(), CPU_ALLOC_SIZE(), CPU_FREE(), + CPU_SET_S(), CPU_CLR_S(), CPU_ISSET_S(), CPU_ZERO_S(), + CPU_COUNT_S(), CPU_AND_S(), CPU_OR_S(), CPU_XOR_S(), and + CPU_EQUAL_S(). + Michael Kerrisk + Add documentation of CPU_COUNT() + Michael Kerrisk + Add description of CPU_AND(), CPU_OR, CPU_XOR(), and CPU_EQUAL() + Plus a few other small clean-ups of the text + Michael Kerrisk + Various improvements in DESCRIPTION + After review comments by Bert Wesarg: + * Explain that cpu_set_t is a bitset, but should be considered + opaque. + * A CPU set can be duplicated with memset(). + * Size of a CPU set is rounded up to size of long. + * CPU_SETSIZE is in bits, but the setsize argument is in bytes. + Michael Kerrisk + Document CPU_ALLOC()/CPU_ALLOC_SIZE() bug + These macros return twice what they should because of thinko + in glibc 2.8 and earlier. The bug is fixed for glibc 2.9. + http://sourceware.org/bugzilla/show_bug.cgi?id=7029 + Michael Kerrisk + NOTES: Discuss use of types in "prototypes" for these macros + The SYNOPSIS shows types for arguments and return values, but + these are really just suggestions: since the interfaces are + macros, the compiler won't catch all violations of + the "type rules". Warn the reader of this. + +pthread_attr_setinheritsched.3 + Michael Kerrisk + New page for pthread_attr_setinheritsched(3) and + pthread_attr_getinheritsched(3) + +pthread_cancel.3 + Michael Kerrisk + New page for pthread_cancel(3) + +pthread_cleanup_push.3 + Michael Kerrisk + New page for pthread_cleanup_push(3) and pthread_cleanup_pop(3) + +pthread_setcancelstate.3 + Michael Kerrisk + New page for pthread_setcancelstate(3) and pthread_setcanceltype(3) + +pthread_testcancel.3 + Michael Kerrisk + New page for pthread_testcancel(3) + + +Newly documented interfaces in existing pages +--------------------------------------------- + +clone.2 + Jens Axboe + Document CLONE_IO (new in Linux 2.6.25) + Some text also by mtk. + Michael Kerrisk + Document CLONE_NEWNET + Michael Kerrisk + Document CLONE_NEWUTS (new in Linux 2.6.19) + Michael Kerrisk + Document CLONE_NEWIPC flag (new in Linux 2.6.19) + Michael Kerrisk + Document CLONE_NEWPID flag (new in Linux 2.6.24) + +mmap.2 + Michael Kerrisk + Document MAP_STACK flag (new in Linux 2.6.27) + +arp.7 + Michael Kerrisk + Document /proc file retrans_time_ms (new in Linux 2.6.12) + Michael Kerrisk + Document /proc file base_reachable_time_ms (new in Linux 2.6.12) + +icmp.7 + Michael Kerrisk + Document icmp_ignore_bogus_error_responses (new in Linux 2.2) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document icmp_ratelimit and icmp_ratemask (new in Linux 2.4.10) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document icmp_echo_ignore_broadcasts (new in Linux 2.6.12) + Text taken from Documentation/networking/ip-sysctl.txt + +tcp.7 + Michael Kerrisk + Document /proc file tcp_slow_start_after_idle (new in Linux 2.6.18) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_base_mss (new in Linux 2.6.17) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_frto_response (new in Linux 2.6.22) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_moderate_rcvbuf (new in Linux 2.4.17/2.6.7) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_congestion_control (new in Linux 2.4.13) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_no_metrics_save (new in Linux 2.6.6) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_mtu_probing (new in Linux 2.6.17) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_dma_copybreak (new in Linux 2.6.24) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_tso_win_divisor (new in Linux 2.6.9) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_allowed_congestion_control (new in Linux 2.4.20) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_workaround_signed_windows (new in Linux 2.6.26) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_available_congestion_control (new in Linux 2.4.20) + Text taken from Documentation/networking/ip-sysctl.txt + Michael Kerrisk + Document /proc file tcp_abc (new in Linux 2.6.15) + Text taken from Documentation/networking/ip-sysctl.txt + +udp.7 + Michael Kerrisk + Document /proc files udp_mem, udp_rmem_min, and udp_wmem_min + All of these are new in Linux 2.6.25 + + +New and changed links +--------------------- + +CPU_ALLOC.3 +CPU_ALLOC_SIZE.3 +CPU_AND.3 +CPU_AND_S.3 +CPU_CLR_S.3 +CPU_COUNT.3 +CPU_COUNT_S.3 +CPU_EQUAL.3 +CPU_EQUAL_S.3 +CPU_FREE.3 +CPU_ISSET_S.3 +CPU_OR.3 +CPU_OR_S.3 +CPU_SET_S.3 +CPU_XOR.3 +CPU_XOR_S.3 +CPU_ZERO_S.3 + Michael Kerrisk + New link to new CPU_SET.3 + +CPU_CLR.3 +CPU_ISSET.3 +CPU_ZERO.3 + Michael Kerrisk + Update links to point to CPU_SET.3 + The documentation of the CPU_* macros migrated to a new + location: CPU_SET.3. + +pthread_attr_getinheritsched.3 + Michael Kerrisk + New link to new pthread_attr_setinheritsched.3 + +pthread_cleanup_pop.3 + Michael Kerrisk + New link to new pthread_cleanup_push.3 + +pthread_setcanceltype.3 + Michael Kerrisk + New link to new pthread_setcancelstate.3 + + +Global changes +-------------- + +clone.2 +mount.2 +unshare.2 +proc.5 +path_resolution.7 + Michael Kerrisk + Global fix: s/namespace/mount-point namespace/, as appropriate + In recent times, a number of other namespace flags have been + added to clone(2). As such, it is no longer clear to use + the generic term "namespace" to refer to the particular + namespace controlled by CLONE_NEWNS; instead, use the + term "mount-point namespace". + Michael Kerrisk + Global fix: s/mount-point namespace/mount namespace/ + This is more consistent with the term "mounts namespace" + used in the 2008 ACM SIGOPS paper, "Virtual servers + and and checkpoint/restart in mainstream Linux". + (I avoided the "s", because using the plural strikes me + as klunky English, and anyway we don't talk about + the "PIDs namespace" or the "networks namespace", etc..) + +connect.2 +listen.2 +send.2 +uname.2 +cmsg.3 +proc.5 +arp.7 +ddp.7 +icmp.7 +ip.7 +raw.7 +socket.7 +tcp.7 +udp.7 + Michael Kerrisk + Global fix: eliminate mention of the obsolete sysctl(2) interface + Many pages still mention use of the obsolete sysctl(2) system + call, or used the term "sysctls"; rewrite these mentions to + instead be in terms of /proc interfaces. + +fcntl.2 +signal.2 +mbsnrtowcs.3 +mbsrtowcs.3 +mbtowc.3 +wcrtomb.3 +wcsnrtombs.3 +wcsrtombs.3 +wctomb.3 + Michael Kerrisk + Global fix: s/multi-thread/multithread/ + +getdents.2 +pthread_attr_init.3 +pthread_create.3 +pthread_getattr_np.3 +pthread_setaffinity_np.3 +pthread_setschedparam.3 +pthread_tryjoin_np.3 + Michael Kerrisk + Use consistent error-handling function names + Many older pages use a handle_error() macro to do simple + error handling from system and library function calls. + Switch these pages to do similar. + + +Changes to individual pages +--------------------------- + +time.1 + Michael Kerrisk + Note that some shells have a 'time' built-in command + Therefore, to access the functionality described on this page, + it may be necessary to specify the full pathname. + +clone.2 + Michael Kerrisk + Place list of CLONE_* flags in alphabetical order + (No content changes.) +fsync.2 + Michael Kerrisk + Update feature test macro requirements for fsync() + Since glibc 2.8, the fsync() declaration is also exposed if + _POSIX_C_SOURCE >= 200112L + +sched_setaffinity.2 + Michael Kerrisk + Add note on system-imposed restrictions on CPUs actually used + After Loic Domaigne's suggestion for pthread_setaffinity_np(3), add + similar text to this page noting that the system silently + limits the set of CPUs on which the process actually runs to + the set of CPUs physically present and the limits imposed by + cpuset(7). + +sched_setaffinity.2 + Michael Kerrisk + Removed discussion of CPU_* macros() + These macros are now moving to a separate page. + Michael Kerrisk + Refer reader to pthread_setaffinity_np(3) + pthread_setaffinity_np() is preferable for setting + thread CPU affinity if using the POSIX threads API. + +sysctl.2 + Michael Kerrisk + Add prominent warning against using this system call + This was already stated under NOTES, but make it even more + prominent by adding a sentence at the start of the DESCRIPTION. + +uname.2 + Michael Kerrisk + Add C comments describing fields in utsname structure + +atan2.3 + Stefano Teso + Fix description of range of function value return + The range is not [-pi/2, pi/2], but [-pi, pi]. + + (mtk: This error was reported by Nicolas Francois, and + should have been fixed in 3.11, but somewhere along the way, + the fix got lost.) + + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=506299 + +bindresvport.3 + Michael Kerrisk + Since glibc 2.8, EPFNOSUPPORT error is now EAFNOSUPPORT + Glibc switched to using a POSIX-specified error code for + this error case. + + http://bugs.linuxbase.org/show_bug.cgi?id=2375 + +clock_getres.3 + Michael Kerrisk + CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID not settable + According to POSIX.1-2001, the CLOCK_PROCESS_CPUTIME_ID and + CLOCK_THREAD_CPUTIME_ID clocks should be settable, but + currently they are not. + +getgrnam.3 + Michael Kerrisk + Clarify and add more detail in RETURN VALUE description + The page was a bit fuzzy in describing the return values for + various cases. In particular, it needed to be more explicit + in describing what happens for the "not found" case. + + This is an analogous change to the change for + getpwnam.3, made after Andreas Henriksson's report. + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787 + Michael Kerrisk + Rename arguments to getgrnam_r() and getgrgid_r() + s/gbuf/grp/ and s/gbufp/result/, for consistency + with POSIX.1 argument names. + Michael Kerrisk + Clarify RETURN VALUE description + The page was a bit fuzzy in describing the return values for + various cases. In particular, it needed to be more explicit + in describing what happens for the "not found" case. + + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504708 + +getpwnam.3 + Michael Kerrisk + Rename arguments to getpwnam_r() and getpwuid_r() + s/pwbuf/pwd/ and s/pwbufp/result/, for consistency + with POSIX.1 argument names. + Michael Kerrisk + Clarify and add more detail in RETURN VALUE description + The page was a bit fuzzy in describing the return values for + various cases. In particular, it needed to be more explicit + in describing what happens for the "not found" case. + + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504787 + Michael Kerrisk + Add an EXAMPLE program for getpwnam_r() + +inet_ntop.3 + Michael Kerrisk + Rename 'cnt' argument to 'size' + This is consistent with POSIX.1, and also a more sensible name. + Michael Kerrisk + Rework text describing 'size' argument + (After a suggestion by Vegard Nossum.) + Also made a few other small rewordings to in the initial + paragraph. + +makecontext.3 + Michael Kerrisk + Add text on use of pointer arguments to makecontext() + Passing pointer arguments to makecontext() is possible, + but only on some architectures, and with no guarantees + of portability. + + http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=504699 + +pthread_attr_setaffinity_np.3 + Michael Kerrisk + Various fixes after review by Loic Domaigne + Reviewed-by: Loic Domaigne + +pthread_attr_setaffinity_np.3 +pthread_setaffinity_np.3 + Michael Kerrisk + Update to reflect new location of CPU_*() documentation + The CPU_*() macros are now documented in CPU_SET.3; + update to reflect that fact. + Michael Kerrisk + Remove redundant text relating to CPU sets + Information about CPU_SETSIZE can be found in CPU_SET.3, so + remove discussion of it here. + +pthread_attr_setschedparam.3 +pthread_setschedparam.3 + Michael Kerrisk + Remove text saying that only sched_priority is required by POSIX.1 + Loic Domaigne points out that if a system implements + SCHED_SPORADIC (which Linux does not), then other + fields are also specified in sched_param. The simple + solution is just to remove that phrase from the man + page. + +pthread_cancel.3 +pthread_detach.3 +pthread_join.3 +pthread_setaffinity_np.3 + Michael Kerrisk + Make text of ESRCH error consistent + +pthread_setaffinity_np.3 + Michael Kerrisk + Add text to EINVAL error mentioning cpuset(7) + Michael Kerrisk + Various improvements after review by Loïc Domaigne + Various fix-ups after Loïc's review. + + Reviewed-by: Loïc Domaigne + +pthread_setschedparam.3 + Michael Kerrisk + PTHREAD_INHERIT_SCHED is default for inherit scheduler attribute + In EXAMPLE, note that PTHREAD_INHERIT_SCHED is the default for + the inherit scheduler attribute attribute. + +syslog.3 + Masanari Iida + LOG_KERN messages can't be generated from user processes + Masanari notes that this is an FAQ for logger(1) and that + Solaris and FreeBSD document this point in syslog(3). + The glibc info page also hides this comment in its source: + + Internally, there is also LOG_KERN, but LOG_KERN == 0, + which means if you try to use it here, just selects default. + +proc.5 + Ivana Varekova + Fix reference to kernel source file + Use relative reference to Documentation/mtrr.txt. + +arp.7 + Michael Kerrisk + Add kernel version numbers for /proc interfaces + +cpuset.7 + Michael Kerrisk + SEE ALSO: add CPU_SET(3) + +epoll.7 + Michael Kerrisk + Note glibc version that added epoll support + +icmp.7 + Michael Kerrisk + Add kernel version numbers to /proc file descriptions + +inotify.7 + Vegard Nossum + Fix description of max_user_watches + It seems that inotify(7) is wrong here: + + "/proc/sys/fs/inotify/max_user_watches + This specifies a limit on the number of watches that can be + associated with each inotify instance." + + On my system, the default value for this variable is 8192. But I + cannot create more than 8192 watches in total for the same UID + even when they are on different inotify instances. So I suggest + to rephrase this as: "This specifies an upper limit on the + number of watches that can be created per real user ID." + +ip.7 + Michael Kerrisk + Reorder socket options alphabetically + Michael Kerrisk + Added kernel version numbers for IP_* socket options + Michael Kerrisk + Relocate kernel version information for IP_PMTUDISC_PROBE + Michael Kerrisk + Add kernel version numbers for /proc/sys/net/ipv4/ip_* files + Michael Kerrisk + Remove mention of kernel header from description of IP_RECVERR + Looks like glibc has had this definition since about version 2.1. + Michael Kerrisk + Relocate kernel version information for ip_mreqn structure + Michael Kerrisk + Relocate info about Linux-specific sockopts to NOTES + Also add some source comments about non-standard Linux-specific + options that are not yet documented. + +netlink.7 + Vegard Nossum + Fix incorrect variable names in example code + s/snl/sa/ * 2 + +pthreads.7 + Michael Kerrisk + Add section on cancellation points + This section includes a list of the functions that must and + may be cancellation points. + Michael Kerrisk + Rework, and fix small error in, thread-safe function list + Integrate the changes that occurred in POSIX.1-2008 into the + main list (to be consistent with the list, elsewhere on this + page, of functions that are cancellation points). + + Also, fix an error that said that strerror() was added to + the list in POSIX.1-2008. It was strsignal() that was + added. (strerror() was already in the list in POSIX.1-2001.) + Michael Kerrisk + Tweak text on sigpause() cancellation point + In POSIX.1-2009, this function moves from the "must be" + to the "may be" list. + Michael Kerrisk + Add ref to signal(7) for further info on use of real-time signals + signal(7) provides some further details on the use of real-time + signals by the two Linux threading implementations. + Michael Kerrisk + SEE ALSO: add pthread_attr_init() and pthread_cancel() + +tcp.7 + Michael Kerrisk + Update description of tcp_rmem defaults for Linux 2.6 + Michael Kerrisk + Add kernel version numbers for TCP_* socket options + Note kernel version were each socket option first appeared. + Michael Kerrisk + The tcp_bic* proc files disappeared in Linux 2.6.13 + Michael Kerrisk + tcp_vegas_cong_avoid disappeared in Linux 2.6.13 + Michael Kerrisk + Add mention of RFC 4138 for 'tcp_frto' /proc file + Michael Kerrisk + Remove mention of /proc in VERSIONS + This information is not indicated for each /proc interface + Michael Kerrisk + Clarify that tcp_mem measures in units of the system page size + Michael Kerrisk + Update tcp_frto description for 2.6.22 changes + Linux 2.6.22 added a mode value 2 ("Enable SACK-enhanced + F-RTO if flow uses SACK"). + Michael Kerrisk + Fix alphabetical order in /proc file list + A few entries were slightly out of order. + Michael Kerrisk + Remove obsolete statement about /proc from VERSIONS + Much of the text has been updated to 2.6.27 or so, + so this statement no longer applies. + Michael Kerrisk + Add kernel version numbers for each /proc interface + Note kernel version where each /proc interface first appeared + Michael Kerrisk + tcp_westwood /proc file disappeared in Linux 2.6.13 + Michael Kerrisk + Update description of tcp_wmem defaults for Linux 2.6