-==================== Changes in man-pages-3.65 ====================
+==================== Changes in man-pages-3.67 ====================
-Released: 2014-04-20, Munich
+Released: 2014-05-21, Munich
Contributors
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:
-Alex Thorlton <athorlton@sgi.com>
-Ashish Sangwan <a.sangwan@samsung.com>
-Christopher Covington <cov@codeaurora.org>
-Christoph Hellwig <hch@infradead.org>
-Craig McQueen <craig.mcqueen@beamcommunications.com>
-Dave Chinner <david@fromorbit.com>
-David Prévot <taffit@debian.org>
-Greg Troxel <gdt@ir.bbn.com>
-Matthew Dempsky <mdempsky@chromium.org>
-Michael Kerrisk <mtk.manpages@gmail.com>
-Mike Frysinger <vapier@gentoo.org>
-Namjae Jeon <namjae.jeon@samsung.com>
-Peng Haitao <penght@cn.fujitsu.com>
-Petr Gajdos <pgajdos@suse.cz>
-Richard Hansen <rhansen@bbn.com>
-Simon Paillard <spaillard@debian.org>
-Steven Stewart-Gallus <sstewartgallus00@mylangara.bc.ca>
-Vince Weaver <vincent.weaver@maine.edu>
-Yuri Kozlov <yuray@komyakino.ru>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
-inet_net_pton.3
+sched_setattr.2
+ Michael Kerrisk, Peter Zijlstra [Juri Lelli]
+ New page describing sched_setattr(2) and sched_getattr(2)
+
+system.3
Michael Kerrisk
- New page describing inet_net_pton(3) and inet_net_ntop(3)
+ Rewrote large parts of the page and added a number of details
Newly documented interfaces in existing pages
---------------------------------------------
-fallocate.2
- Michael Kerrisk, Namjae Jeon [Christoph Hellwig, Dave Chinner]
- Document FALLOC_FL_COLLAPSE_RANGE
+sched.7
+ Peter Zijlstra, Michael Kerrisk [Juri Lelli]
+ Document SCHED_DEADLINE
+ Raw text from Peter Zijlstra
-prctl.2
- Michael Kerrisk [Alex Thorlton]
- Document PR_SET_THP_DISABLE and PR_GET_THP_DISABLE
+New and changed links
+---------------------
-proc.5
+renameat2.2
Michael Kerrisk
- Document /proc/[pid]/stack
+ New link to rename.2
+
+sched_getattr.2
Michael Kerrisk
- Document /proc/[pid]/clear_refs
+ New link to new sched_setattr.
-New and changed links
----------------------
+Changes to individual pages
+---------------------------
-inet_net_ntop.3
+bind.2
Michael Kerrisk
- New link to new inet_net_pton.3
+ ERRORS: Add EADDRINUSE for ephemeral port range exhaustion
+chown.2
+ Michael Kerrisk
+ NOTES: Add some subheadings
-Changes to individual pages
----------------------------
+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
- Note the race when O_CLOEXEC is used at same time as fork()+execve()
+ Add "file locking" subheading under NOTES
-madvise.2
+fork.2
Michael Kerrisk
- SEE ALSO: see prctl(2)
- Because of PR_SET_THP_DISABLE.
+ ERRORS: SCHED_DEADLINE tasks can fail with EAGAIN
+ SCHED_DEADLINE tasks can fail with EAGAIN unless the
+ reset-on-fork flag is set.
-mlock.2
+futex.2
Michael Kerrisk
- Describe treatment of MCL_FUTURE during fork(2) and execve(2)
+ 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
-msync.2
- Michael Kerrisk [Richard Hansen, Greg Troxel]
- Warn that one of MS_SYNC or MS_ASYNC is required
+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
-open.2
+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
- Add more detail on the race that O_CLOEXEC is designed to avoid
- Michael Kerrisk [Matthew Dempsky]
- Remove crufty text stating that O_DIRECTORY is Linux-specific
+ ERRORS: Add EINVAL for invalid arguments
Michael Kerrisk
- Note which filesystems support O_TMPFILE
+ SEE ALSO: add sched_setattr(2)
-perf_event_open.2
- Vince Weaver [Michael Kerrisk]
- Clarify EACCES and EPERM errors
- Clarify the reasons for EACCES and EPERM errors.
- Vince Weaver [Michael Kerrisk]
- Make the ERRORS section more comprehensive.
- Determined both by code inspection and by writing a large
- number of test programs.
+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
-personality.2
+semget.2
Michael Kerrisk
- Available execution domains are listed in <sys/personality.h>
+ 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
- Fix discussion of return value
+ NOTES: Add a subheading
-prctl.2
+send.2
+ Michael Kerrisk
+ Add details on various 'msghdr' fields
+ Michael Kerrisk
+ ERRORS: Add EAGAIN for ephemeral port range exhaustion
Michael Kerrisk
- ERRORS: document EINVAL for PR_GET_NO_NEW_PRIVS
- ERRORS: document EINVAL for PR_SET_PDEATHSIG
- ERRORS: document EINVAL for PR_SET_TIMING
- ERRORS: document EINVAL for PR_SET_DUMPABLE
- ERRORS: document EINVAL for PR_SET_NO_NEW_PRIVS
+ Add some subheadings under DESCRIPTION
shmget.2
Michael Kerrisk
- Rewrite description of SHMMNI default value
+ 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
- Note default value of SHMMAX
- Note default value for SHMALL
+ 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
-byteorder.3
+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 htonl(), htons(), ntohl() and ntohs() are thread
- safe.
-
-fexecve.3
- Michael Kerrisk [Steven Stewart-Gallus]
- If 'fd' is a close-on-exec file descriptor for a script, fexecve() fails
- See https://bugzilla.kernel.org/show_bug.cgi?id=74481
+ The functions pthread_attr_setstackaddr() and
+ pthread_attr_getstackaddr() are thread safe.
-ffs.3
+pthread_attr_setstacksize.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions ffs(), ffsl() and ffsll() are thread safe.
+ The functions pthread_attr_setstacksize() and
+ pthread_attr_getstacksize() are thread safe.
-getauxval.3
+pthread_kill.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
- The function getauxval() is thread safe.
+ The function pthread_kill() is thread safe.
-getcontext.3
- Peng Haitao
- ATTRIBUTES: Note functions that are thread-safe
- The functions getcontext() and setcontext() are thread safe.
-
-getsubopt.3
+pthread_kill_other_threads_np.3
Peng Haitao
ATTRIBUTES: Note function that is thread-safe
- The function getsubopt() is thread safe.
+ The function pthread_kill_other_threads_np() is thread safe.
-getutmp.3
+pthread_self.3
Peng Haitao
- ATTRIBUTES: Note functions that are thread-safe
- The functions getutmp() and getutmpx() are thread safe.
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_self() is thread safe.
-inet.3
+pthread_setcancelstate.3
Michael Kerrisk
- Note success and error return for inet_aton()
+ Add paragraph breaks to "Asynchronous cancelability" subsection
-inet.3
- Michael Kerrisk [Craig McQueen]
- The form 'a.b' if is suitable for Class A addresses (not class C)
+pthread_setcancelstate.3
+ Peng Haitao
+ ATTRIBUTES: Note functions that are thread-safe
+ The functions pthread_setcancelstate() and
+ pthread_setcanceltype() are thread safe.
Michael Kerrisk
- SEE ALSO: add inet_net_pton(3)
+ NOTES: Add some subheadings
-makecontext.3
+pthread_setschedparam.3
Peng Haitao
ATTRIBUTES: Note functions that are thread-safe
- The functions makecontext() and swapcontext() are thread safe.
+ The functions pthread_setschedparam() and pthread_getschedparam()
+ are thread safe.
-pthread_attr_setdetachstate.3
+pthread_setschedprio.3
Peng Haitao
- ATTRIBUTES: Note functions that are thread-safe
- The functions pthread_attr_setdetachstate() and
- pthread_attr_getdetachstate() are thread safe.
+ ATTRIBUTES: Note function that is thread-safe
+ The function pthread_setschedprio() is thread safe.
-pthread_attr_setguardsize.3
+pthread_sigmask.3
Peng Haitao
- ATTRIBUTES: Note functions that are thread-safe
- The functions pthread_attr_setguardsize() and
- pthread_attr_getguardsize() are thread safe.
+ 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.
-sigsetops.3
+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 sigemptyset(), sigfillset(), sigaddset(),
- sigdelset(), sigismember(), sigisemptyset(), sigorset() and
- sigandset() 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
- Petr Gajdos
- Improve /proc/[pid]/smaps entries description
Michael Kerrisk
- /proc/PID/smaps is present only if CONFIG_PROC_PAGE_MONITOR
+ Document /proc/timer_stats
Michael Kerrisk
- Note kernel version for /proc/sys/kernel/{shmall,shmmax}
+ (Briefly) document /proc/timer_list
+ Text taken from kernel commit
+ 289f480af87e45f7a6de6ba9b4c061c2e259fe98.
Michael Kerrisk
- Note kernel version for /proc/sys/kernel/{msgmax,msgmnb}
+ 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
- SEE ALSO: add capsh(1)
+ Mention sched_setattr(2) under CAP_SYS_NICE
+
+cpuset.7
+ Michael Kerrisk
+ SEE ALSO: add sched(7)
-libc.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
- Add musl libc
+ SEE ALSO: Mention more files in Documentation/scheduler/ directory
OSDN Git Service
