X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=Changes;h=49e5a3603a3751bddc23b39e0ad286647f78e228;hb=049c89bdc0b87404dbc76423f1768fac639a5d0a;hp=707af74915947bbe454e930a182fdeaff9494d64;hpb=917d6b6d675b15d78fc6dc8a266d21bd71f5a5c4;p=thirdparty%2Fman-pages.git diff --git a/Changes b/Changes index 707af74915..49e5a3603a 100644 --- a/Changes +++ b/Changes @@ -1,4 +1,4 @@ -==================== Changes in man-pages-3.67 ==================== +==================== Changes in man-pages-4.09 ==================== Released: ????-??-??, Munich @@ -17,449 +17,19 @@ 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 -sched_getattr.2 - Michael Kerrisk - New link to new sched_setattr. +Global changes +-------------- 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 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 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 to synopsis for ppoll() - One needs to #include 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 . - -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 , 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 - 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