diff --git a/Changes b/Changes index 71acc3be9..8e57c2a65 100644 --- a/Changes +++ b/Changes @@ -10,26 +10,356 @@ 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: +Andi Kleen +Andre Majorel +Andrey Vagin +Andy Lutomirski +Axel Beckert +Bernhard Walle +Brandon Edens +Eliezer Tamir +Gioele Barabucci +Ian Abbott +Jerry Chu +Jonas Jonsson +Marc Lehmann +Michael Kerrisk +Mike Frysinger: +Peng Haitao +Reuben Thomas +Simone Piccardi +Simon Paillard +Thomas Posch +Tilman Schmidt +Vince Weaver +Yuri Kozlov +Марк Коренберг Apologies if I missed anyone! -New and rewritten pages ------------------------ - - Newly documented interfaces in existing pages --------------------------------------------- +open.2 + Michael Kerrisk, Andy Lutomirski + Document O_TMPFILE + O_TMPFILE is new in Linux 3.11 -New and changed links ---------------------- +ptrace.2 + Andrey Vagin + Add description for PTRACE_PEEKSIGINFO + Retrieve signals without removing them from a queue. + Andrey Vagin + Add description for PTRACE_GETSIGMASK and PTRACE_SETSIGMASK + These two commands allow to examine and change mask of blocked + signals. Global changes -------------- +Various pages + Michael Kerrisk + Reword to avoid use of "etc." + +Various pages + Peng Haitao [Andre Majorel] + Make wording around thread-safety and setlocale() more precise + +getdate.3 +strptime.3 +locale.5 + Michael Kerrisk + Replace "weekday" with less ambiguous language + Notwithstanding POSIX's use of the term "weekday", in everyday + English, "weekday" is commonly understood to mean a day in the + set [Monday..Friday] (vs one of the "weekend" days). + Changes to individual pages --------------------------- +epoll_wait.2 + Michael Kerrisk [Jonas Jonsson] + Clarify wording of EINTR error + See https://bugzilla.kernel.org/show_bug.cgi?id=66571 + +faccessat.2 + Michael Kerrisk + Note that the system call takes only three arguments + +fallocate.2 + Michael Kerrisk + Note filesystems that support FALLOC_FL_PUNCH_HOLE operation + +fcntl.2 + Michael Kerrisk + BUGS: The O_SYNC and O_DSYNC flags are not modifiable using F_SETFL + Michael Kerrisk + Add susbsections under BUGS + There's several bugs listed. It's helpful to mark + them separately. + Michael Kerrisk + POSIX.1 specifies F_SETOWN and F_GETOWN for sockets/SIGURG + +getrlimit.2 + Michael Kerrisk [Марк Коренберг] + Note that rlim_cur can be set lower than current resource consumption + +getsockopt.2 + Michael Kerrisk + SEE ALSO: add ip(7) and udp(7) + +keyctl.2 + Michael Kerrisk + SEE ALSO: mention Documentation/security/keys.txt + +linkat.2 + Michael Kerrisk + Add ENOENT for O_TMPFILE created with O_EXCL + Michael Kerrisk + ERRORS: Add EINVAL + +lseek.2 + Michael Kerrisk + Note which filesystems support SEEK_HOLE/SEEK_DATA + +msgop.2 + Michael Kerrisk + Document MSG_COPY + Michael Kerrisk + Note that MSG_EXCEPT is Linux-specific + +open.2 + Michael Kerrisk + Update CONFORMING TO + Add POSIX.1-2008. Add mention of O_TMPFILE. + Update text on various flags that were added in POSIX.1-2008, and + whose definitions can, since glibc 2.12, be obtained by suitably + defining _POSIX_C_SOURCE or _XOPEN_SOURCE + Michael Kerrisk + Add pointer in description to BUGS, for O_ASYNC limitation + Michael Kerrisk + Remove crufty duplicate text on modifying file status flags + +ptrace.2 + Michael Kerrisk + Add details to descriptions of PTRACE_GETSIGMASK and PTRACE_SETSIGMASK + +select.2 + Michael Kerrisk [Marc Lehmann] + RETURN VALUE: Fix discussion of treatment of file descriptor sets + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=574370 + +syscalls.2 + Michael Kerrisk + Remove madvise1() from main list + madvise1() is one of the system calls that was never + implemented, and listed toward the bottom of the page. + +timer_create.2 + Michael Kerrisk + Add pointer to proc(5) for info on /proc/[pid]/timers + +unlinkat.2 + Michael Kerrisk [Mike Frysinger:] + ERRORS: Add EISDIR + See https://bugzilla.kernel.org/show_bug.cgi?id=29702 + +perf_event_open.2 + Vince Weaver [Andi Kleen] +1e043959034888ce1b1a25346316d06f7d64f0fe perf_event_open.2 : PERF_SAMPLE_TRANSACTION support in Linux 3.13 (fwd) + The following patch adds descriptions of the new perf_event_open.2 + PERF_SAMPLE_TRANSACTION sample type as added in Linux 3.13. + + The descriptions are based on information provided by Andi Kleen, + both in the e-mail + + [PATCH 1/6] perf, core: Add generic transaction flags v5 + + sent to the linux-kernel list as well as an e-mail + + [PATCH] Document transaction flags in perf_event_open manpage + + sent to the linux-man list. + + The implementation is based heavily on the Intel Haswell + processor. Documentation can be found at this page: + http://software.intel.com/en-us/blogs/2013/05/03/intelr-transactional-synchronization-extensions-intelr-tsx-profiling-with-linux-0 + as well as in section 18.11.5.1 of volume 3 of the + Intel 64 and IA-32 Architecture Software Developer's Manual. + + Also, someone with better manpage formatting skills than I have + should probably investigate why I can't get the last line of + the change to properly tab-align with the .I transaction + heading. + +ferror.3 + Michael Kerrisk + clearerr(), feof(), and ferror() are also POSIX-conformant + Michael Kerrisk [Reuben Thomas] + CONFORMING TO: add fileno() + +gets.3 + Ian Abbott + SEE ALSO: add fgets(3) + +mq_receive.3 +mq_send.3 + Michael Kerrisk [Simone Piccardi] + SYNOPSIS: s/unsigned/unsigned int/ + +printf.3 + Michael Kerrisk + Small reorganization of text in EXAMPLE + +rand.3 + Michael Kerrisk + s/unsigned/unsigned int/ in example + +stpcpy.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function stpcpy() is thread safe. + +stpncpy.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function stpncpy() is thread safe. + +strcat.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions strcat() and strncat() are thread safe. + +strchr.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions strchr(), strrchr() and strchrnul() are thread safe. + +strcmp.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions strcmp() and strncmp() are thread safe. + +strftime.3 + Brandon Edens + Change "week day" to "day of week" + See https://bugzilla.kernel.org/show_bug.cgi?id=68861 + +strstr.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function strstr() is thread safe. + The function strcasestr() is thread safe with exceptions. + +strtod.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread safe with exceptions + The functions strtod(), strtof() and strtold() are thread safe + with exceptions. + +strtoimax.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread safe with exceptions + The functions strtoimax() and strtoumax() are thread safe with + exceptions. + +strtol.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread safe with exceptions + The functions strtol(), strtoll() and strtoq() are thread safe + with exceptions. + +tcgetpgrp.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions tcgetpgrp() and tcsetpgrp() are thread safe. + +tcgetsid.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function tcgetsid() is thread safe. + +core.5 + Bernhard Walle + Mention that %E exists since Linux 3.0 + '%E' in the 'core_pattern' has been introduced in kernel commit + 57cc083ad9e1bfeeb4a0ee831e7bb008c8865bf0 which was included in + version 3.0. Add that information to the manual page. + +filesystems.5 + Michael Kerrisk [Axel Beckert] + Add reference to proc(5) for more details on /proc/filesystems + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=735590 + +locale.5 + Michael Kerrisk + SEE ALSO: add locale(7) + +proc.5 + Michael Kerrisk + Document /proc/[pid]/timers + Michael Kerrisk + Update discussion of wchan + Remove crufty reference to /etc/psdatabase in /proc/PID/stat. + Add /proc/PID/wchan. + + See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/737452 + +environ.7 + Michael Kerrisk [Gioele Barabucci] + Correct reference to locale(7) (not locale(5)) + locale(7) is the right place for details of the LC_* + environment variables. + + See http://bugs.debian.org/638186 + Michael Kerrisk + Improve references for discussion of locale environment variables + Michael Kerrisk + SEE ALSO: add catopen(3) + Michael Kerrisk + SEE ALSO: add locale(5) + +man-pages.7 + Michael Kerrisk + Prefer "usable" over "useable" + +netdevice.7 + Tilman Schmidt + Document SIOCGIFCONF case ifc_req==NULL + Add the missing description of the possibility to call SIOCGIFCONF + with ifc_req==NULL to determine the needed buffer size, as + described in + http://lkml.indiana.edu/hypermail/linux/kernel/0110.1/0506.html + and verified against source files net/core/dev_ioctl.c and + net/ipv4/devinet.c in the current kernel git tree. + This functionality has been present since the beginning of the 2.6 + series. It's about time it gets documented. + + While I'm at it, also generally clarify the section on + SIOCGIFCONF. + +socket.7 + Eliezer Tamir + Add description for SO_BUSY_POLL + Add description for the SO_BUSY_POLL socket option. + +standards.7 + Michael Kerrisk + Enhance description of V7 + Michael Kerrisk + Add C11 + +tcp.7 + Michael Kerrisk [Jerry Chu] + Document TCP_USER_TIMEOUT + Text slightly adapted from Jerry Chu's (excellent) commit + message (commit dca43c75e7e545694a9dd6288553f55c53e2a3a3). + Michael Kerrisk + Describe format of tcp_*_congestion_control /proc files + Describe format of tcp_allowed_congestion_control and + tcp_available_congestion_control. + Michael Kerrisk + Document TCP_CONGESTION