LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

Changes: Ready for 3.67 

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2014-05-21 13:10:38 +02:00
parent 1aa556aba3
commit 06e9936b49
1 changed files with 432 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

434
Changes
View File

@ -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