diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2014-05-21 13:10:38 +0200 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2014-05-21 13:10:38 +0200 |
commit | 06e9936b492012ba2e83fe50fdfe4e57979e189b (patch) | |
tree | 63a88268bf0686a2a224c9e6a4381ec16c2ad36e /Changes | |
parent | 1aa556aba3ef704e0c905f5df8325209ff41360f (diff) |
Changes: Ready for 3.67
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'Changes')
-rw-r--r-- | Changes | 434 |
1 files changed, 432 insertions, 2 deletions
@@ -17,19 +17,449 @@ Apologies if I missed anyone! New and rewritten pages ----------------------- +sched_setattr.2 + Michael Kerrisk, Peter Zijlstra [Juri Lelli] + New page describing sched_setattr(2) and sched_getattr(2) + +system.3 + Michael Kerrisk + Rewrote large parts of the page and added a number of details + Newly documented interfaces in existing pages --------------------------------------------- +sched.7 + Peter Zijlstra, Michael Kerrisk [Juri Lelli] + Document SCHED_DEADLINE + Raw text from Peter Zijlstra New and changed links --------------------- +renameat2.2 + Michael Kerrisk + New link to rename.2 -Global changes --------------- +sched_getattr.2 + Michael Kerrisk + New link to new sched_setattr. Changes to individual pages --------------------------- +bind.2 + Michael Kerrisk + ERRORS: Add EADDRINUSE for ephemeral port range exhaustion + +chown.2 + Michael Kerrisk + NOTES: Add some subheadings + +connect.2 + Michael Kerrisk [William Morriss] + ERRORS: Add EADDRNOTAVAIL for ephemeral port range exhaustion + Verified from testing and the kernel source. + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=745775 + Michael Kerrisk + Remove mention of ip_local_port_range under EAGAIN error + Man-pages commit ac7477eb7a8 added EADDRNOTAVAIL as the correct + error for ephemeral port range exhaustion. However, that error + was also incorrectly described under the EAGAIN entry. So, + remove that text under EAGAIN. + +create_module.2 +delete_module.2 +init_module.2 +query_module.2 + Michael Kerrisk [Lucas De Marchi] + Clarify glibc header file declaration/ABI wrapper details + create_module(), delete_module(), init_module(), and + query_module() are not declared in header files, but + through an accident of history glibc provides an ABI + for them that it continues to maintain, for + compatibility reasons. + +execve.2 + Michael Kerrisk [Steven Stewart-Gallus] + Note SIGKILL case when execve() fails beyond the point of no return + Michael Kerrisk + NOTES: Add a subheading and reorder paragraphs + +fanotify_init.2 + Heinrich Schuchardt [Michael Kerrisk] + Document range of permitted flags for event_f_flags + With a new patch included in the mm tree, event_f_flags is + checked for allowable values. + +fcntl.2 + Michael Kerrisk + Add "file locking" subheading under NOTES + +fork.2 + Michael Kerrisk + ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN + SCHED_DEADLINE tasks can fail with EAGAIN unless the + reset-on-fork flag is set. + +futex.2 + Michael Kerrisk + Note that there is no glibc wrapper + +getpriority.2 + Rasmus Villemoes + Fix prototypes for getpriority() and setpriority() + The who argument has type id_t (which happens to be u32 on linux). + +get_robust_list.2 + Rasmus Villemoes + Add <sys/types.h> to synopsis of get_robust_list() + If one were to implement wrappers for [gs]et_robust_list() using the + given prototypes, one would also have to include sys/types.h to get + a definition of size_t. + +getrusage.2 + Michael Kerrisk [Bill Allombert] + _GNU_SOURCE must be defined to obtain RUSAGE_THREAD definition + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=746569 + +link.2 +open.2 + Andy Lutomirski [Michael Kerrisk] + Update AT_EMPTY_PATH and O_PATH documentation + +listen.2 + Michael Kerrisk + ERRORS: Add EADDRINUSE for ephemeral port range exhaustion + +mbind.2 + Rasmus Villemoes + Fix prototype for mbind(2) + The nmask argument is const. The return type in numaif.h is long. + (Well, at least <numaif.h> says nmask is const. The current kernel + does not define it as a const argument, but sys_mbind() only + passes it to get_nodes(), which does treat it as const.) + +msgop.2 + Davidlohr Bueso [Michael Kerrisk] + Enhance description of "full queue" criteria + +poll.2 + Rasmus Villemoes + Add <signal.h> to synopsis for ppoll() + One needs to #include <signal.h> to get the definition of the + type (sigset_t) of the mask argument to ppoll(). + +readlink.2 + Rasmus Villemoes + Fix return type of readlinkat() + +recv.2 + Michael Kerrisk + Clarify details of msg_name and msg_namelen fields + +recvmmsg.2 + Michael Kerrisk + Describe timeout bug + See FIXME https://bugzilla.kernel.org/show_bug.cgi?id=75371 + and http://thread.gmane.org/gmane.linux.man/5677 + +remap_file_pages.2 + Andy Lutomirski [Christoph Hellwig, Andy Lutomirski] + remap_file_pages() has no benefit for real files + Linux commit 3ee6dafc677a68e461a7ddafc94a580ebab80735 caused + remap_file_pages to be emulated when used on real file. + +sched_get_priority_max.2 + Michael Kerrisk + 'policy' can also be SCHED_DEADLINE + +sched_setaffinity.2 + Rasmus Villemoes + Fix prototype for sched_setaffinity() + The mask argument is const. + +sched_setparam.2 + Michael Kerrisk + ERRORS: mark errors that apply just for sched_setparam() + Michael Kerrisk + ERRORS: Add EINVAL for invalid arguments + Michael Kerrisk + SEE ALSO: add sched_setattr(2) + +sched_setscheduler.2 + Michael Kerrisk + ERRORS: mark errors that apply just to sched_setscheduler() + Michael Kerrisk + ERRORS: add EINVAL case for pid < 0 + Michael Kerrisk + ERRORS: separate out EINVAL cases + +semget.2 + Michael Kerrisk + NOTES: Add subheadings and reorder paragraphs + +semop.2 + Rasmus Villemoes + Fix prototypes for semop() and semtimedop() + The nsops arguments have type size_t, not unsigned, and the + timeout argument of semtimedop() is const. + Michael Kerrisk + NOTES: Add a subheading + +send.2 + Michael Kerrisk + Add details on various 'msghdr' fields + Michael Kerrisk + ERRORS: Add EAGAIN for ephemeral port range exhaustion + Michael Kerrisk + Add some subheadings under DESCRIPTION + +shmget.2 + Michael Kerrisk + NOTES: Add a subheading + +stat.2 + Michael Kerrisk [Aurelien Jarno] + Describe feature test macro requirements for file type test macros + See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=728240 + Michael Kerrisk + Update FTM requirements for lstat() + Michael Kerrisk + Split discussion of 'st_mode' fields into type and permissions + Michael Kerrisk + Move text on S_I*() macros to follow text on S_I* macros + That ordering is more logical + +stime.2 + Rasmus Villemoes + Fix prototype for stime() + The argument is const, both according to the actual header files and + according to <http://www.sco.com/developers/devspecs/vol1a.pdf>. + +syscall.2 + Rasmus Villemoes + Fix prototype for syscall() + The first argument and the return value of syscall() has type long, + not int. + +getopt.3 + Michael Kerrisk + EXAMPLE: Add subheadings to distinguish the two example programs + +malloc.3 + Michael Kerrisk + Reword text referring to mallopt(3) + Linux libc is no longer "recent"; drop mention of it. + +pthread_attr_setinheritsched.3 +pthread_attr_setschedparam.3 +pthread_attr_setschedpolicy.3 +pthread_setaffinity_np.3 +pthread_setschedparam.3 +pthread_setschedprio.3 +pthread_yield.3 +pthreads.7 + Michael Kerrisk + Change references to "sched_setscheduler(2)" to "sched(7)" + Change consistent with the fact that the scheduling overview + page is now sched(7) not sched_setscheduler(2). + +pthread_attr_setstackaddr.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setstackaddr() and + pthread_attr_getstackaddr() are thread safe. + +pthread_attr_setstacksize.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_attr_setstacksize() and + pthread_attr_getstacksize() are thread safe. + +pthread_kill.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_kill() is thread safe. + +pthread_kill_other_threads_np.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_kill_other_threads_np() is thread safe. + +pthread_self.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_self() is thread safe. + +pthread_setcancelstate.3 + Michael Kerrisk + Add paragraph breaks to "Asynchronous cancelability" subsection + +pthread_setcancelstate.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_setcancelstate() and + pthread_setcanceltype() are thread safe. + Michael Kerrisk + NOTES: Add some subheadings + +pthread_setschedparam.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions pthread_setschedparam() and pthread_getschedparam() + are thread safe. + +pthread_setschedprio.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_setschedprio() is thread safe. + +pthread_sigmask.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_sigmask() is thread safe. + +pthread_sigqueue.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_sigqueue() is thread safe. + +pthread_testcancel.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_testcancel() is thread safe. + +pthread_yield.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function pthread_yield() is thread safe. + +remquo.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions remquo(), remquof() and remquol() are thread safe. + +rtime.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function rtime() is thread safe. + +sched_getcpu.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function sched_getcpu() is thread safe. + +stpcpy.3 + Ingo Schwarze + Note some history of stpcpy() + Quoting Ingo: + I just noticed that the stpcpy(3) manual contains a speculation + that appears to be untrue on closer investigation: That function + did not originate in MS DOS, but in Lattice C on AmigaDOS. + + Here is a patch against the git master HEAD to fix that, and add + some more historical information. To provide some background and + allow you to more easily verify the correctness of the patch, i'm + appending my mail to <misc@openbsd.org>, where i'm giving some + more details about the history and pointing to some primary + sources. That mail also contains the (similar, but shorter) + patch i just committed to the OpenBSD manual page. + +strcasecmp.3 + Michael Kerrisk [Aurelien Jarno, Török Edwin] + Explain why strcasecmp()+strncasecmp() are also declared in <string.h> + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=729436 + +strcpy.3 + Michael Kerrisk + NOTES: Add a subheading + +fd.4 + Michael Kerrisk [Sam Varshavchik] + Fix floppy disk device names + The naming convention shown in the page was ancient. + Now, the page is consistent with Documentation/devices.txt + (where it is noted that "The use of the capital letters + D, H and E for the 3.5" models have been deprecated, since + the drive type is insignificant for these devices" + +proc.5 + Michael Kerrisk + Document /proc/timer_stats + Michael Kerrisk + (Briefly) document /proc/timer_list + Text taken from kernel commit + 289f480af87e45f7a6de6ba9b4c061c2e259fe98. + Michael Kerrisk + Add /proc/sys/kernel/{sched_rt_period_us,sched_rt_runtime_us} + Reference sched(7) for an explanation of these two files + +capabilities.7 + Michael Kerrisk + Mention sched_setattr(2) under CAP_SYS_NICE + +cpuset.7 + Michael Kerrisk + SEE ALSO: add sched(7) + +credentials.7 + Michael Kerrisk + Mention sched_getattr() as a place where credentials are checked + +fanotify.7 + Heinrich Schuchardt [Jan Kara] + BUGS: error events can be lost when reading from fanotify FD + Michael Kerrisk [Heinrich Schuchardt] + Fix description of FAN_EVENT_NEXT() + FAN_EVENT_NEXT() does not update 'meta'; rather, it returns a + pointer to the next metadata structure. In addition, generally + rework the description to be a bit clearer and more detailed. + Heinrich Schuchardt + Document FAN_EVENT_METADATA_LEN + +ip.7 + Michael Kerrisk + Note cases where an ephemeral port is used + Michael Kerrisk + Remove BUGS text on glibc failing to declare in_pktinfo + Michael Kerrisk + Clarify 'ip_local_port_range' and mention the term "ephemeral ports" + Michael Kerrisk + Note some more details about assignment of ephemeral ports + Michael Kerrisk + BUGS: ephemeral port range exhaustion is diagnosed inconsistently + Different system calls use different 'errno' values to diagnose + exhaustion of the ephemeral port range. + +sched.7 + Michael Kerrisk + Document sched_rt_period_us and sched_rt_runtime_us /proc files + And rework and relocate the text on dealing with runaway + real-time processes. + Michael Kerrisk + Mention sched_setattr(2) in list of APIs that can change policies + Michael Kerrisk + sched_setattr(2) can also be used to set 'nice' value + Michael Kerrisk + Remove mention of sched_setscheduler() when talking about sched_priority + There are nowadays multiple ways to set sched_priority (and + in fact there always were, since we also had sched_setparam(2)). + Michael Kerrisk + SEE ALSO: Add Documentation/scheduler/sched-design-CFS.txt + Michael Kerrisk + Don't mention sched_setscheduler(2) in discussions of setting policies + In a couple of places, sched_setscheduler(2) is mentioned as the + way of setting policies. But now there is sched_setattr(2) as + well, rewrite the text in a more generic way. + Michael Kerrisk + Rework summary text describing sched_setattr(2) and sched_getattr(2) + Note that these APIs are a superset of sched_setscheduler(2) + and sched_getscheduler(2). + Michael Kerrisk + Remove crufty text relating to sched_setscheduler() + All of the removed text is in sched_setscheduler(2) and + should have been trimmed from this page. + Michael Kerrisk + SEE ALSO: Mention more files in Documentation/scheduler/ directory |