-==================== Changes in man-pages-3.67 ====================
+==================== Changes in man-pages-4.09 ====================
Released: ????-??-??, Munich
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 <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