diff --git a/Changes b/Changes index 16ca38aa9..a0e4460d3 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.66 ==================== +==================== Changes in man-pages-3.67 ==================== -Released: 2014-05-08, Munich +Released: ????-??-??, Munich Contributors @@ -10,30 +10,6 @@ The following people contributed patches/fixes or (noted in brackets in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release: -Alan Curry -Carsten Andrich -Daniel Borkmann -David Prévot -Eric Siegerman -Heinrich Schuchardt -Jan Kara -Jan Moskyto Matejka -John Marshall -Lukáš Czerner -Manfred Spraul -Michael Kerrisk -Miklos Szeredi -Neil Horman -Peng Haitao -Peter Schiffer -Randy Dunlap -Silvan Jegen -Simon Paillard -Stefan Puiu -Steven Stewart-Gallus -Stijn Hinterding -Willem de Bruijn -Yuri Kozlov Apologies if I missed anyone! @@ -41,271 +17,19 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- -fanotify_init.2 - Heinrich Schuchardt, Michael Kerrisk - New page documenting fanotify_init(2) - -fanotify_mark.2 - Heinrich Schuchardt, Michael Kerrisk - New page documenting fanotify_mark(2) - -sched_setscheduler.2 - Michael Kerrisk - Page rewritten - Stripped out the general scheduling material, which - moved to sched(7), and rewrote much of the remainder. - Changed copyright and license since pretty much all - of the content was or is written by mtk. - -fanotify.7 - Heinrich Schuchardt, Michael Kerrisk - New page providing overview of the fanotify API - -sched.7 - Michael Kerrisk - New page providing an overview of the scheduling APIs - Most of this content derives from sched_setscheduler(2). In - preparation for adding a sched_setattr(2) page, it makes - sense to isolate out this general content to a separate - page that is referred to by the other scheduling pages. Newly documented interfaces in existing pages --------------------------------------------- -fallocate.2 - Lukas Czerner [Michael Kerrisk] - Document FALLOC_FL_ZERO_RANGE - FALLOC_FL_ZERO_RANGE was added in Linux 3.14, - for zeroing ranges in the allocated space in a file. -rename.2 - Miklos Szeredi [Michael Kerrisk] - Document renameat2() - Some light edits to this patch by mtk. +New and changed links +--------------------- -shmop.2 - Michael Kerrisk - Document SHM_EXEC + +Global changes +-------------- Changes to individual pages --------------------------- -fallocate.2 - Michael Kerrisk - Employ term "open file description" in DESCRIPTION - And include reference to open(2) for an explanation of the term. - -getpriority.2 - Michael Kerrisk - SEE ALSO: add sched(7) - -getsockopt.2 - Carsten Andrich - SEE ALSO: add packet(7) - -link.2 - Michael Kerrisk [Steven Stewart-Gallus] - Document ENOENT error for linkat() - See https://bugzilla.kernel.org/show_bug.cgi?id=73301 - -msgget.2 - Michael Kerrisk - Reword EEXIST error - -msgop.2 - Michael Kerrisk - Note capability required to raise MQ size beyond MSGMNB - -msync.2 - Michael Kerrisk [Heinrich Schuchardt] - s/flushes... back to disk/flushes... back to filesystem/ - -nice.2 - Michael Kerrisk - SEE ALSO: add sched(7) - -open.2 - Peter Schiffer - Update note on alignment of user buffer and file offset for O_DIRECT - The sentence in open(2) man page in notes for O_DIRECT flag: - - "Under Linux 2.6, alignment to 512-byte boundaries suffices." - - is not universally correct. The alignment is a property of the - storage, for example, 4k-sector drives with no 512 byte sector - emulation will be unable to perform 512-byte direct I/O. - Michael Kerrisk - Note some of the various synonyms for "open file description" - Michael Kerrisk - Remove repetitious text on use of fcntl() to change file status flags - -open_by_handle_at.2 - Michael Kerrisk - Mention FreeBSD analogs - -posix_fadvise.2 - Michael Kerrisk [Eric Siegerman] - Fix wording error under "Architecture-specific variants" - See https://bugzilla.kernel.org/show_bug.cgi?id=75431 - -process_vm_readv.2 - Michael Kerrisk [Stijn Hinterding] - Add feature test macro requirements - The _GNU_SOURCE FTM must be defined. - -read.2 - Michael Kerrisk - BUGS: detail nonatomicity bug with respect to file offset updates - This bug was fixed in Linux 3.14, with commit - 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4 - See also http://thread.gmane.org/gmane.linux.kernel/1649458 - -sched_get_priority_max.2 - Michael Kerrisk - Small changes consistent with migration of content to sched(7) - -sched_rr_get_interval.2 - Michael Kerrisk - Small changes consistent with migration of content to sched(7) - -sched_setaffinity.2 - Michael Kerrisk - Small changes consistent with migration of content to sched(7) - -sched_setparam.2 - Michael Kerrisk - Small changes consistent with migration of content to sched(7) - -sched_yield.2 - Michael Kerrisk - Small changes consistent with migration of content to sched(7) - -semget.2 - Michael Kerrisk - Consolidate discussion on noninitialization of semaphores - The fact that semget() does not initialize the semaphores - in a new set was covered in two places (in DESCRIPTION - and BUGS). Consolidate these into one place (in NOTES) - and also point out that POSIX.1-2008 says that a future - version of the standard may require an implementation to - initialize the semaphores to 0. - Michael Kerrisk - Clarify SEMMNS versus SEMMSL*SEMMNI - Michael Kerrisk - Rework EINVAL text a little - Michael Kerrisk - Clarify wording for EEXIST error - -shmget.2 - Manfred Spraul - Clarify SHMALL - The default for SHMALL is a limit of 8 GB, regardless of - PAGE_SIZE. The current documentation does not mention that - and is therefore more difficult to understand than necessary. - Manfred Spraul - Correct math error - 2097152 is 2^21, not 2^20. - Michael Kerrisk - Reword EEXIST error - Michael Kerrisk - Clarify one of the EINVAL cases - Michael Kerrisk - Note that SHM_NORESERVE is a Linux extension - Michael Kerrisk [Simon Paillard] - Fix kernel version numbers in discussion of SHMALL - Michael Kerrisk - Rework EINVAL text - Michael Kerrisk - Move and rework discussion of mode bits - Michael Kerrisk - Reword description of O_EXCL - -shmop.2 - Michael Kerrisk - Move fork(2), execve(2), _exit(2) discussion to NOTES - Michael Kerrisk - Add subheads for shmat() and shmdt() - Michael Kerrisk - Rework discussion of SHM_RDONLY and SHM_REMAP into list format - Michael Kerrisk - Structure the attach cases as a list - -sigaction.2 - Alan Curry - Fix bad cross reference (times(2) not time(2)) - The system call that reports child CPU usage is times(2), - not time(2). - -symlink.2 - Michael Kerrisk [Steven Stewart-Gallus] - Document ENOENT error for symlinkat() - See https://bugzilla.kernel.org/show_bug.cgi?id=73301 - -syscalls.2 - Michael Kerrisk - Add renameat2() - And bump kernel version. - -write.2 - Michael Kerrisk - BUGS: detail nonatomicity bug with respect to file offset updates - This bug was fixed in Linux 3.14, with commit - 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4 - See also http://thread.gmane.org/gmane.linux.kernel/1649458 - -pthread_attr_setinheritsched.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions pthread_attr_setinheritsched() and - pthread_attr_getinheritsched() are thread safe. - -pthread_attr_setschedparam.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions pthread_attr_setschedparam() and - pthread_attr_getschedparam() are thread safe. - -pthread_attr_setschedpolicy.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions pthread_attr_setschedpolicy() and - pthread_attr_getschedpolicy() are thread safe. - -pthread_attr_setscope.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions pthread_attr_setscope() and pthread_attr_getscope() - are thread safe. - -pthread_attr_setstack.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions pthread_attr_setstack() and pthread_attr_getstack() - are thread safe. - -sched_getcpu.3 - Michael Kerrisk - SEE ALSO: add sched(7) - -termios.3 - Michael Kerrisk [Yuri Kozlov] - Rework intro text for 'c_oflag' - Michael Kerrisk - OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text - -proc.5 - Jan Moskyto Matejka [Randy Dunlap] - Improve description of /proc/stat 'intr' field - The sum at the beginning of line "intr" includes also - unnumbered interrupts. - -packet.7 - Carsten Andrich [Neil Horman] - Improve sockopt documentation for packet sockets - Carsten Andrich [Willem de Bruijn] - PACKET_LOSS has inverse meaning - Stefan Puiu [Daniel Borkmann, Carsten Andrich] - Status in PACKET_RX_RING is actually a bit mask - Michael Kerrisk [Carsten Andrich] - SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c diff --git a/Changes.old b/Changes.old index f15a38f30..78c57fb14 100644 --- a/Changes.old +++ b/Changes.old @@ -31141,3 +31141,316 @@ capabilities.7 libc.7 Michael Kerrisk Add musl libc + + +==================== Changes in man-pages-3.66 ==================== + +Released: 2014-05-08, Munich + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Alan Curry +Carsten Andrich +Daniel Borkmann +David Prévot +Eric Siegerman +Heinrich Schuchardt +Jan Kara +Jan Moskyto Matejka +John Marshall +Lukáš Czerner +Manfred Spraul +Michael Kerrisk +Miklos Szeredi +Neil Horman +Peng Haitao +Peter Schiffer +Randy Dunlap +Silvan Jegen +Simon Paillard +Stefan Puiu +Steven Stewart-Gallus +Stijn Hinterding +Willem de Bruijn +Yuri Kozlov + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +fanotify_init.2 + Heinrich Schuchardt, Michael Kerrisk + New page documenting fanotify_init(2) + +fanotify_mark.2 + Heinrich Schuchardt, Michael Kerrisk + New page documenting fanotify_mark(2) + +sched_setscheduler.2 + Michael Kerrisk + Page rewritten + Stripped out the general scheduling material, which + moved to sched(7), and rewrote much of the remainder. + Changed copyright and license since pretty much all + of the content was or is written by mtk. + +fanotify.7 + Heinrich Schuchardt, Michael Kerrisk + New page providing overview of the fanotify API + +sched.7 + Michael Kerrisk + New page providing an overview of the scheduling APIs + Most of this content derives from sched_setscheduler(2). In + preparation for adding a sched_setattr(2) page, it makes + sense to isolate out this general content to a separate + page that is referred to by the other scheduling pages. + +Newly documented interfaces in existing pages +--------------------------------------------- + +fallocate.2 + Lukas Czerner [Michael Kerrisk] + Document FALLOC_FL_ZERO_RANGE + FALLOC_FL_ZERO_RANGE was added in Linux 3.14, + for zeroing ranges in the allocated space in a file. + +rename.2 + Miklos Szeredi [Michael Kerrisk] + Document renameat2() + Some light edits to this patch by mtk. + +shmop.2 + Michael Kerrisk + Document SHM_EXEC + + +Changes to individual pages +--------------------------- + +fallocate.2 + Michael Kerrisk + Employ term "open file description" in DESCRIPTION + And include reference to open(2) for an explanation of the term. + +getpriority.2 + Michael Kerrisk + SEE ALSO: add sched(7) + +getsockopt.2 + Carsten Andrich + SEE ALSO: add packet(7) + +link.2 + Michael Kerrisk [Steven Stewart-Gallus] + Document ENOENT error for linkat() + See https://bugzilla.kernel.org/show_bug.cgi?id=73301 + +msgget.2 + Michael Kerrisk + Reword EEXIST error + +msgop.2 + Michael Kerrisk + Note capability required to raise MQ size beyond MSGMNB + +msync.2 + Michael Kerrisk [Heinrich Schuchardt] + s/flushes... back to disk/flushes... back to filesystem/ + +nice.2 + Michael Kerrisk + SEE ALSO: add sched(7) + +open.2 + Peter Schiffer + Update note on alignment of user buffer and file offset for O_DIRECT + The sentence in open(2) man page in notes for O_DIRECT flag: + + "Under Linux 2.6, alignment to 512-byte boundaries suffices." + + is not universally correct. The alignment is a property of the + storage, for example, 4k-sector drives with no 512 byte sector + emulation will be unable to perform 512-byte direct I/O. + Michael Kerrisk + Note some of the various synonyms for "open file description" + Michael Kerrisk + Remove repetitious text on use of fcntl() to change file status flags + +open_by_handle_at.2 + Michael Kerrisk + Mention FreeBSD analogs + +posix_fadvise.2 + Michael Kerrisk [Eric Siegerman] + Fix wording error under "Architecture-specific variants" + See https://bugzilla.kernel.org/show_bug.cgi?id=75431 + +process_vm_readv.2 + Michael Kerrisk [Stijn Hinterding] + Add feature test macro requirements + The _GNU_SOURCE FTM must be defined. + +read.2 + Michael Kerrisk + BUGS: detail nonatomicity bug with respect to file offset updates + This bug was fixed in Linux 3.14, with commit + 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4 + See also http://thread.gmane.org/gmane.linux.kernel/1649458 + +sched_get_priority_max.2 + Michael Kerrisk + Small changes consistent with migration of content to sched(7) + +sched_rr_get_interval.2 + Michael Kerrisk + Small changes consistent with migration of content to sched(7) + +sched_setaffinity.2 + Michael Kerrisk + Small changes consistent with migration of content to sched(7) + +sched_setparam.2 + Michael Kerrisk + Small changes consistent with migration of content to sched(7) + +sched_yield.2 + Michael Kerrisk + Small changes consistent with migration of content to sched(7) + +semget.2 + Michael Kerrisk + Consolidate discussion on noninitialization of semaphores + The fact that semget() does not initialize the semaphores + in a new set was covered in two places (in DESCRIPTION + and BUGS). Consolidate these into one place (in NOTES) + and also point out that POSIX.1-2008 says that a future + version of the standard may require an implementation to + initialize the semaphores to 0. + Michael Kerrisk + Clarify SEMMNS versus SEMMSL*SEMMNI + Michael Kerrisk + Rework EINVAL text a little + Michael Kerrisk + Clarify wording for EEXIST error + +shmget.2 + Manfred Spraul + Clarify SHMALL + The default for SHMALL is a limit of 8 GB, regardless of + PAGE_SIZE. The current documentation does not mention that + and is therefore more difficult to understand than necessary. + Manfred Spraul + Correct math error + 2097152 is 2^21, not 2^20. + Michael Kerrisk + Reword EEXIST error + Michael Kerrisk + Clarify one of the EINVAL cases + Michael Kerrisk + Note that SHM_NORESERVE is a Linux extension + Michael Kerrisk [Simon Paillard] + Fix kernel version numbers in discussion of SHMALL + Michael Kerrisk + Rework EINVAL text + Michael Kerrisk + Move and rework discussion of mode bits + Michael Kerrisk + Reword description of O_EXCL + +shmop.2 + Michael Kerrisk + Move fork(2), execve(2), _exit(2) discussion to NOTES + Michael Kerrisk + Add subheads for shmat() and shmdt() + Michael Kerrisk + Rework discussion of SHM_RDONLY and SHM_REMAP into list format + Michael Kerrisk + Structure the attach cases as a list + +sigaction.2 + Alan Curry + Fix bad cross reference (times(2) not time(2)) + The system call that reports child CPU usage is times(2), + not time(2). + +symlink.2 + Michael Kerrisk [Steven Stewart-Gallus] + Document ENOENT error for symlinkat() + See https://bugzilla.kernel.org/show_bug.cgi?id=73301 + +syscalls.2 + Michael Kerrisk + Add renameat2() + And bump kernel version. + +write.2 + Michael Kerrisk + BUGS: detail nonatomicity bug with respect to file offset updates + This bug was fixed in Linux 3.14, with commit + 9c225f2655e36a470c4f58dbbc99244c5fc7f2d4 + See also http://thread.gmane.org/gmane.linux.kernel/1649458 + +pthread_attr_setinheritsched.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setinheritsched() and + pthread_attr_getinheritsched() are thread safe. + +pthread_attr_setschedparam.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setschedparam() and + pthread_attr_getschedparam() are thread safe. + +pthread_attr_setschedpolicy.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setschedpolicy() and + pthread_attr_getschedpolicy() are thread safe. + +pthread_attr_setscope.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setscope() and pthread_attr_getscope() + are thread safe. + +pthread_attr_setstack.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setstack() and pthread_attr_getstack() + are thread safe. + +sched_getcpu.3 + Michael Kerrisk + SEE ALSO: add sched(7) + +termios.3 + Michael Kerrisk [Yuri Kozlov] + Rework intro text for 'c_oflag' + Michael Kerrisk + OFDEL is in POSIX.1-2001, so remove "(Not in POSIX)" text + +proc.5 + Jan Moskyto Matejka [Randy Dunlap] + Improve description of /proc/stat 'intr' field + The sum at the beginning of line "intr" includes also + unnumbered interrupts. + +packet.7 + Carsten Andrich [Neil Horman] + Improve sockopt documentation for packet sockets + Carsten Andrich [Willem de Bruijn] + PACKET_LOSS has inverse meaning + Stefan Puiu [Daniel Borkmann, Carsten Andrich] + Status in PACKET_RX_RING is actually a bit mask + Michael Kerrisk [Carsten Andrich] + SEE ALSO: add /tools/testing/selftests/net/psock_tpacket.c