LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
11,491 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

4331 Commits

Author SHA1 Message Date
Adrian Bunk c023a7f875 bdflush.2, fsync.2, sync.2, proc.5: Change "sync(1)" to "sync(8)" 
This seems to be a remnant from the times when man-pages
shipped a sync(8).

Signed-off-by: Adrian Bunk <bunk@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-01 22:02:15 +02:00
Michael Kerrisk a83923cafb open.2: wfix 
Reported-by: Rahul Bedarkar <rahulbedarkar89@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-08-01 21:57:51 +02:00
D. Barbier c435eb91ad sigaltstack.2: tfix 
Fix typo introduced in 0c892e5.

Denis

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-30 08:40:36 +02:00
Michael Kerrisk e77c5c7431 recv.2: 'addrlen' should be NULL (not 0) if we don't need sender address 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-28 13:40:10 +02:00
Michael Kerrisk b18ea63300 bind.2: Correct EINVAL error description 
As pointed out by Ryan:

    My application is trying to bind an IPV4 UDP socket to an
    address. I've found that passing an invalid address length
    to bind() causes bind to return EINVAL. According to the
    bind(2) manpage, this should only occur when using unix
    domain sockets (which I am not).

Reported-by: Ryan Hammonds <rhammonds@unicoi.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-22 07:40:22 +02:00
David Prévot cc2b44ebed stat.2: nfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-22 07:17:07 +02:00
Vince Weaver bc9d90b589 perf_event_open.2: Clarify PERF_SAMPLE_DATA_SRC usage 
When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
you need to shift the masks before doing the compare.

Although the value you are checking (perf_mem_data_src) is
specified as a bitfield so this might all fall apart if trying
to access the field in a cross-endian way.  The Power people
were working on this issue, not sure if they resolved it.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-20 09:22:47 +02:00
Vince Weaver 02ca78a0c7 perf_event_open.2: Clarify PERF_SAMPLE_STACK_USER usage 
This clarifies the PERF_SAMPLE_STACK_USER section.
I found these issue while implementing some code that uses
the option.  The important change is fixing the name of the
sample_stack_user parameter, the rest is just some wording
fixes and minor clarifications.

Signed-off-by: Vince Weaver <vincent.weaver@maine.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-20 09:22:47 +02:00
David Prévot 9fdb563ecd fanotify_mark.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-13 10:29:57 +02:00
NeilBrown c835f12b9b epoll_ctl.2: minor clarification concerning when a WAKEUP event is "processed" 
I guess it should be obvious, but it never hurts to be explicit.
When the epoll file descriptor is closed all events are assumed
to be "processed".
Also if the event is removed with EPOLL_CTL_DEL or the EPOLLWAKEUP
flag is removed with EPOLL_CTL_MOD the event will be "processed".

Signed-off-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-09 10:25:09 +02:00
Michael Kerrisk cbe0e64447 Removed trailing white space at end of lines 2014-07-08 16:36:37 +02:00
Michael Kerrisk c77eace5b1 iconv.1, ldd.1, connect.2, dup.2, epoll_ctl.2, eventfd.2, fallocate.2, fcntl.2, getitimer.2, inotify_add_watch.2, open.2, pipe.2, poll.2, sendmmsg.2, set_tid_address.2, shmop.2, signalfd.2, splice.2, syscalls.2, syslog.2, tee.2, vmsplice.2, ether_aton.3, mallopt.3, printf.3, profil.3, charmap.5, proc.5, epoll.7, inotify.7, libc.7, pipe.7, sched.7, socket.7, udplite.7, iconvconfig.8, ld.so.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 16:14:48 +02:00
Michael Kerrisk d2b6be9a2d fcntl.2: Suggest the use of real-time signals with F_NOTIFY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 12:22:25 +02:00
Michael Kerrisk 1ce579fc39 fcntl.2: ERRORS: Document ENOTDIR error for F_NOTIFY 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-08 12:07:15 +02:00
Elie De Brauwer 4fe82a332b pipe.2: PIPE_BUF is defined in limits.h 
To make use of PIPE_BUF in an application one should include limits.h.
Adding a reference to this inclusion.

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-07 09:07:26 +02:00
Michael Kerrisk 8ab32b4785 epoll_ctl.2: BUGS: EPOLLWAKEUP is silently ignored without CAP_BLOCK_SUSPEND 
If the caller does not have CAP_BLOCK_SUSPEND, then EPOLLWAKEUP
is silently ignored.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-07 09:07:18 +02:00
Michael Kerrisk 1bc86e8a0d epoll_ctl.2: Minor tweaks to Neil Brown's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-07 09:07:11 +02:00
NeilBrown 573f05ef42 epoll_ctl.2: Document EPOLLWAKEUP 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-07 09:07:10 +02:00
Michael Kerrisk 6351139b47 set_tid_address.2: SEE ALSO: add gettid(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-06 09:15:06 +02:00
Michael Kerrisk b5693a3854 set_tid_address.2: Use "thread" rather than "process" in DESCRIPTION 
Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-06 09:13:40 +02:00
Michael Kerrisk b701f72de4 syscalls.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-06 09:11:03 +02:00
Michael Kerrisk 8be6f4e1cd fcntl.2: Use proper page cross-references in F_NOTIFY discussion 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-05 08:54:58 +02:00
Michael Kerrisk e2cfd90e5b poll.2: The negate-fd-to-ignore technique does not work for file descriptor 0 
See https://bugzilla.kernel.org/show_bug.cgi?id=79411

Reported-by: Nadav Har'El <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-03 08:17:14 +02:00
Michael Kerrisk 5c4d5f9715 fcntl.2: The return value for F_SETPIPE_SZ is the pipe capacity 
Reported-by: Tomi Salminen <tlsalmin@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-01 11:40:36 +02:00
Michael Kerrisk 417e4f5c50 getitimer.2: Rewrite a few pieces to clarify some details 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-07-01 09:36:28 +02:00
Michael Kerrisk 422bb2b4ec dup.2: Fix erroneous discussion regarding closing 'newfd' before calling dup2() 
And propose a workaround if the caller cares about catching
close() time errors.

See http://stackoverflow.com/questions/23440216/race-condition-when-using-dup2#comment36888604_23444465
and http://austingroupbugs.net/view.php?id=411

Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-29 09:49:08 +02:00
Michael Kerrisk 44505a6fdc dup.2: Rework and enhance discussion of dup2() 
In particular, note that dup2() performs the steps of closing
and reusing 'newfd' atomically.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-29 09:49:08 +02:00
Michael Kerrisk 7ecb725e10 dup.2: Add subhead for dup3() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-29 09:49:08 +02:00
Michael Kerrisk 7499e6bc8e inotify_add_watch.2: Clarify that the target of a watch is an i-node 
The target of a watch is an i-node, not a pathname. Clarify
the text to prevent the reader possibly misunderstanding
that establishing watches by two different links to the same
file might create different watch descriptors.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-28 07:38:40 +02:00
Michael Kerrisk 65558bedaa connect.2: ERRORS: add EPROTOTYPE 
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=708394

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-27 08:57:08 +02:00
Michael Kerrisk 2d2c6782ae shmop.2: Explain SHMLBA in much more detail 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 11:40:54 +02:00
Michael Kerrisk e530d422dc syslog.2: Rewrite parts of the page, and import /proc/sys/kernel/printk 
* Move /proc/sys/kernel/printk from proc(5) to this page,
  and correct various details in the discussion of that file.
* Rewrite and correct various other details on the page.
* Clean out some crufty text.
* Miscellaneous minor fixes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:21 +02:00
Michael Kerrisk 51c9e67e6b syslog.2: Update SYSLOG_ACTION_CONSOLE_OFF + SYSLOG_ACTION_CONSOLE_ON description 
Details changed in Linux 2.6.32

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:21 +02:00
Michael Kerrisk ce26c69b15 syslog.2: srcfix: Update copyright 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:21 +02:00
Michael Kerrisk f4775e5db1 syslog.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:21 +02:00
Michael Kerrisk 0e0901c18c syslog.2: Minor wording/grammar fixes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:20 +02:00
Michael Kerrisk e32652ca9f syslog.2: Rework text describing loglevels 
The kernel header file mentioned in the discussion of the KERN_*
constants has morphed and is no longer exported inside glibc.
And the definitions of the constants themselves changed subtly
with kernel commit 04d2c8c83d0e3ac5f78aeede51babb3236200112.
So, rewrite the description of the constants to be a bit more
abstract.

Reported-by: Robert P. J. Day <rpjday@crashcourse.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:20 +02:00
Michael Kerrisk 7fdbbd1ed4 syslog.2: Rework introductory paragraph 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-23 10:35:20 +02:00
Michael Kerrisk 56cb065052 vmsplice.2: Document EAGAIN error 
See https://bugzilla.kernel.org/show_bug.cgi?id=48641

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-18 16:03:09 +02:00
Michael Kerrisk b7224af900 tee.2: Document EAGAIN error 
See https://bugzilla.kernel.org/show_bug.cgi?id=48641

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-18 16:02:55 +02:00
Michael Kerrisk 0655aa15d2 splice.2: Document EAGAIN error 
See https://bugzilla.kernel.org/show_bug.cgi?id=48641

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-18 16:01:55 +02:00
Michael Kerrisk eb9a0b2f75 intro.1, gettimeofday.2, mkdir.2, nice.2, setresuid.2, stime.2, adjtime.3, getttyent.3, proc.5: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-18 15:38:13 +02:00
Michael Kerrisk 6807fc6f8a open.2: O_CLOEXEC is also one the flags not ignored when O_PATH is specified 
Reported-by: Кирилл <kirillnow@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-18 12:12:56 +02:00
Carlos O'Donell 7b08c45b7d syscalls.2: Add prlimit64(2) 
While trying to reconcile the new features in glibc with the
documented entries in the linux kernel man pages I noticed that
glibc exports prlimit64 for use by 32-bit applications (as does
the linux kernel), but that prlimit64 was not defined in the
syscalls list or in the prlimit-related page.

This is not the complete fix for this, but I don't have the time
to explain why and when prlimit64 should be used (or how it should
be used safely). Therefore I'm just patching the syscalls.2 list
to show that prlimit64 exists and was added in 2.6.36 (verified
with git by checking out the tags before and after).

Unless you've purposely excluded prlimit64 to avoid telling users
about it because it's complicated, please apply.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-17 20:17:28 +02:00
Simon Paillard d65250f528 shmget.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-17 07:32:00 +02:00
Simon Paillard a1fa36afd2 :eventfd.2, fallocate.2, open.2, sendmmsg.2, signalfd.2, proc.5, sched.7, socket.7, udplite.7: spfix: "behaviour": use American spelling "behavior" instead 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-17 07:27:20 +02:00
Michael Kerrisk 91085d8525 Removed trailing white space at end of lines 2014-06-14 08:03:45 +02:00
Michael Kerrisk ad5b45abe5 localedef.1, execve.2, fcntl.2, flock.2, lseek.2, open.2, open_by_handle_at.2, recvmmsg.2, sendmmsg.2, seteuid.2, setresuid.2, setreuid.2, setuid.2, statfs.2, syscalls.2, basename.3, catgets.3, getdate.3, getdirentries.3, getdtablesize.3, iconv.3, lockf.3, malloc_get_state.3, malloc_usable_size.3, matherr.3, mkdtemp.3, mkstemp.3, mq_close.3, mq_unlink.3, siginterrupt.3, system.3, locale.5, bootparam.7, environ.7, man-pages.7, signal.7, unicode.7, utf-8.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-13 17:15:44 +02:00
Michael Kerrisk 864eb97814 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-12 15:29:19 +02:00
NeilBrown 24c1b109f8 times.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-12 14:18:48 +02:00
Michael Kerrisk 85c984a114 remap_file_pages.2: Note that remap_file_pages() is deprecated 
Reviewed-by: Kirill A. Shutemov <kirill.shutemov@linux.intel.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-12 11:43:10 +02:00
Michael Kerrisk b665034d43 syscalls.2: Note that remap_file_pages() is deprecated 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-12 07:14:21 +02:00
Michael Kerrisk 795d8ab168 statfs.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-11 10:01:19 +02:00
Michael Kerrisk cefc036246 statfs.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-11 10:00:53 +02:00
Michael Kerrisk f0b613ec52 statfs.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-11 10:00:25 +02:00
Michael Kerrisk 2e35bf6ddd statfs.2: Correct kernel version for "statfs() broken for pipe FDs" bug 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-10 22:26:45 +02:00
Michael Kerrisk f28710c6a0 statfs.2: Move Cyril Hrubis's "statfs() broken for pipe FDs" patch to BUGS 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-10 22:21:42 +02:00
Michael Kerrisk ac6f74b9b4 statfs.2: Minor tweaks to Cyril Hrubis's "statfs() broken for pipe FDs" patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-10 22:17:06 +02:00
Cyril Hrubis 8519cf245f statfs.2: fstatfs(2) was broken on file descriptors from pipe(2) 
Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-10 22:14:11 +02:00
Cyril Hrubis 3c794803b4 statfs.2: Update MAGIC constants 
Most of the updates are taken from /usr/include/linux/magic.h,
some were found by grepping the Linux source code.

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-10 22:12:29 +02:00
Michael Kerrisk 29d3bdc482 seteuid.2, setresuid.2, setreuid.2, setuid.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:41:32 +02:00
Michael Kerrisk 76868835e7 fcntl.2: Add notes on F_SETLKW deadlock detection and its limitations 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 241e02302d fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk d2e429c1a8 fcntl.2: The kernel does not perform deadlock detection for OFD locks 
See kernel commit 57b65325fe34ec4c917bc4e555144b4a94d9e1f7
And this mail thread:

    http://thread.gmane.org/gmane.linux.file-systems/81318/focus=81327
    From: Jeff Layton <jlayton <at> redhat.com>
    Subject: [PATCH v5 13/14] locks: skip deadlock detection on FL_FILE_PVT locks
    Date: 2014-01-09 14:19:46 GMT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk d20d9d33ab open.2: Rework and extend the discussion of open file descriptions 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 22603b1d5c lseek.2: Add reference to open(2) for discussion of file descriptors and OFDs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 6451570257 fcntl.2: Under OFD locks add a reference to open(2) for explanation of OFDs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk 5879ccc0d3 fork.2: Add notes on inheritance of flock() and OFD locks across fork() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:49 +02:00
Michael Kerrisk d068eb3b73 fcntl.2: Explain POSIX background to EACCES/EAGAIN error for F_GETLK 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9c26bc8c20 fcntl.2: F_OFD_GETLK fails with EAGAIN when there is a lock conflict 
For F_GETLK, POSIX allows EACCES or EAGAIN because different
implementations of traditional record locks returned one of
these errors, and portable applications had to handle either
possibility. However, that argument doesn't apply for OFD
locks, since Linux is the only implementation and it returns
EAGAIN.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6024e7332f fcntl.2: Describe how to check whether the kernel supports a particular command 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 102b34d811 fcntl.2: ERRORS: add EINVAL for invalid 'cmd' 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk d9312ec7c0 fcntl.2: Minor wording improvement 
Reported-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9044058e60 fcntl.2: Add an explicit note that mandatory locking is not in POSIX 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk f5cdb4b0fc fcntl.2: Make the warning that mandatory locks are unreliable more prominent 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6799ba26c9 fcntl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9acee57885 fcntl.2: Rewrite introductory paragraphs on mandatory locking 
Make the structure more logical, and also explicitly mention
OFD locks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 4b5c506a2c fcntl.2: Add EINVAL error for OFD locks where 'l_pid' is not 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk c11b47b3b1 fcntl.2: CONFORMING TO: note that OFD locks are Linux-specific 
But they make their way into the next POSIX release

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 97e03523e5 fcntl.2: Describe semantics for compatible and conflicting OFD locks 
And describe how threads can use OFD locks to ensure
exclusive access to a file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 1a93af040c fcntl.2: Detail the limitations of traditional (process-associated) locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk bfb147160f fcntl.2: Minor fixes to introductory par on OFD locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 38702b6ccc fcntl.2: OFD locks are Linux-specific and available since Linux 3.15 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 99b5ab7933 fcntl.2: Tweaks and rewrites of pieces of Jeff Layton's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Jeff Layton 2d3e4b83a3 fcntl.2: Document open file description locks 
As provided by the fcntl() operations F_OFD_SETLK,
F_OFD_SETLKW, and F_OFD_GETLK

Signed-off-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 7562b10e23 fcntl.2: Add para introducing advisory locks and noting existence of OFD locks 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 86fbd8d849 fcntl.2: Minor change: move some NOTES text on record locking 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 15b4459067 fcntl.2: wfix + ffix: fine-tuning on NFSv4 client locking text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 70fd304581 fcntl.2: Add NOTES subhead for record locking and NFS 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk da0d60febb fcntl.2: nfsv4leasetime controls the "contact lost" interval for NFSv4 
Jeff Layton:
   The difference here is subtle. The gracetime is how long after a reboot
   should knfsd allow clients to reclaim state (and deny the creation of
   new locks and opens). The leasetime is how long the NFSv4 lease period
   is. There is a relationship between the two that's illustrated in the
   comments above write_gracetime:

     /**
      * write_gracetime - Set or report current NFSv4 grace period time
      *
      * As above, but sets the time of the NFSv4 grace period.
      *
      * Note this should never be set to less than the *previous*
      * lease-period time, but we don't try to enforce this.  (In the common
      * case (a new boot), we don't know what the previous lease time was
      * anyway.)
      */

   The value you're interested in here is the nfsv4leasetime. If the
   client doesn't renew its lease within that period, then it's subject to
   the server giving up on it and dropping any state that it holds on that
   clients' behalf.

   Note that this is not a firm timeout. The server runs a job
   periodically to clean out expired stateful objects, and it's likely
   that there is some time (maybe even up to another whole lease period)
   between when the timeout expires and the job actually runs. If the
   client gets a RENEW in there within that window, its lease will be
   renewed and its state preserved.

Reported-by: Jeff Layton <jlayton@poochiereds.net>
Cowritten-by: Jeff Layton <jlayton@poochiereds.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk af8713605a fcntl.2: Refine discussion of locks when NFSv4 client loses contact with server 
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 6ca357f965 fcntl.2: Note treatment of locks when an NFS client loses contact with the server 
Based on text sent by Neil Brown.

Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk 9584daf7f3 fcntl.2: Minor rewording 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:48 +02:00
Michael Kerrisk cf118c620f fcntl.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:47 +02:00
Michael Kerrisk 91ac17b2c7 fcntl.2: Reword discussion of mandatory lock bug a litte 
Jeff Layton confirmed that the bug remains even in modern kernels.

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:47 +02:00
Michael Kerrisk 05a0fb665a flock.2: In some modern BSDs, fcntl() and flock() locks do interact 
So, reword and extend the discussion of this topic in NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:33:38 +02:00
Michael Kerrisk b1b70920af flock.2: Move NOTES text describing implementation of flock() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:30:37 +02:00
Michael Kerrisk e449654fdb flock.2: Add more details on NFS, including Linux 2.6.37 changes 
Also: move NOTES text describing interaction of fcntl()
and flock() locks.

Reviewed-by: NeilBrown <neilb@suse.de>
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-09 21:30:37 +02:00
Yuri Kozlov f2f50fed25 fanotify_mark.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-08 21:16:39 +02:00
Yuri Kozlov d1c05d0b78 send.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-08 21:16:06 +02:00
Rasmus Villemoes f41d7fb3de sendmmsg.2: Add reference to feature_test_macros(7) 
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-04 20:45:30 +02:00
Rasmus Villemoes 9c57aa4847 recvmmsg.2: Add reference to feature_test_macros(7) 
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-04 20:45:11 +02:00
Rasmus Villemoes cdcdcf71c3 open_by_handle_at.2: Add reference to feature_test_macros(7) 
Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-06-04 20:44:39 +02:00
Michael Kerrisk adab861a92 execve.2: RLIMIT_NPROC is checked only if preceded by set*uid() 
Reported-by: Vasiliy Kulikov <segoon@openwall.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 8349023145 execve.2: Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid() 
Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk ebd381ba7b execve.2: Document EAGAIN error 
See also https://bugzilla.kernel.org/show_bug.cgi?id=42704

Reviewed-by: Vasiliy Kulikov <segoon@openwall.com>
Reviewed-by: NeilBrown <neilb@suse.de>
Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 27cbe70472 setreuid.2: Error checking should always be performed, even when caller is UID 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk f673b78321 setresuid.2: Error checking should always be performed, even when caller is UID 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk b57db62bf0 seteuid.2: Error checking should always be performed, even when caller is UID 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 7d8d165a4b setuid.2: Error checking should always be performed, even when caller is UID 0 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk c4fe0edf5c setuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk c2cb87b649 setreuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 19d889b39a setresuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 25b2ea5fd6 setuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:56 +02:00
Michael Kerrisk 27bb77b0c7 setreuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:51 +02:00
Michael Kerrisk 199f1e1572 setresuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:10:41 +02:00
Michael Kerrisk 4b3beb4932 setreuid.2: Add EAGAIN error for hitting RLIMIT_NPROC limit 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:05:43 +02:00
Michael Kerrisk 7a42bf02f7 setuid.2: Correct the description of the EAGAIN error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:05:43 +02:00
Michael Kerrisk c5e8af4dc2 setresuid.2: Correct the description of the EAGAIN error 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:05:43 +02:00
Michael Kerrisk a36b2bb0ec seteuid.2: seteuid() and setegid() are implemented as library functions 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 17:05:43 +02:00
Michael Kerrisk 8660ef9f1d locale.1, adjtimex.2, clone.2, fork.2, getrlimit.2, remap_file_pages.2, set_mempolicy.2, swapon.2, a64l.3, adjtime.3, argz_add.3, bstring.3, envz_add.3, fpathconf.3, fseek.3, gcvt.3, getaddrinfo_a.3, getauxval.3, getnameinfo.3, getrpcent.3, getrpcport.3, getspnam.3, getutent.3, inet.3, inet_net_pton.3, key_setsecret.3, makecontext.3, makedev.3, malloc_trim.3, mq_getattr.3, newlocale.3, nl_langinfo.3, perror.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigqueue.3, rcmd.3, re_comp.3, resolver.3, rexec.3, rtime.3, scandir.3, setlocale.3, setnetgrent.3, sigvec.3, tsearch.3, core.5, proc.5, charsets.7, locale.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-28 15:42:25 +02:00
Simon Paillard 11bae399cf shmget.2: wfix 
The section is about failures, no need to recall this for that
specific error code.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-23 15:50:53 +02:00
Rasmus Villemoes 236899f0ab swapon.2: Remove header from synopsis 
The <asm/page.h> header is not readily available, and the comment
seems to indicate that it is for getting PAGE_SIZE. But it is
never mentioned why one would need to know that, and it is in any
case better obtained using sysconf(), provided by <unistd.h>.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:27 +02:00
Michael Kerrisk 5918743bc8 adjtimex.2: Add featute test macro requirements 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:27 +02:00
Rasmus Villemoes aff9c3077a remap_file_pages.2: Fix prototype 
The pgoff argument has type size_t, not ssize_t (and in the kernel it
is unsigned long).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:26 +02:00
Rasmus Villemoes 2cbf26f13e set_mempolicy.2: Fix prototype for set_mempolicy(2) 
The nodemask argument is const. The return type in numaif.h is long.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:26 +02:00
Michael Kerrisk 41dfc98f96 fork.2: ERRORS: add pid_max and threads-max to EAGAIN 
And rewrite text to be the same as pthread_create(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:26 +02:00
Michael Kerrisk e1b6e18657 clone.2: ERRORS: add cross-reference to fork(2) for explanation of EAGAIN 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:26 +02:00
Michael Kerrisk f703b9e10b getrlimit.2: RLIMIT_NPROC is not enforced if CAP_SYS_ADMIN or CAP_SYS_RESOURCE 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-22 08:23:26 +02:00
Michael Kerrisk 0da5e58ad2 Removed trailing white space at end of lines 2014-05-21 13:16:14 +02:00
Michael Kerrisk 3d15531307 chown.2, fcntl.2, futex.2, recvmmsg.2, sched_setscheduler.2, semget.2, shmget.2, malloc.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_setaffinity_np.3, strcpy.3, capabilities.7, cpuset.7, credentials.7, pthreads.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-21 13:15:30 +02:00
Michael Kerrisk 0acc5c6d66 renameat2.2: New link to rename.2 
When documentation of the renameat2() system calls was added to
rename(2), I overlooked to create the corresponding link file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-21 08:58:38 +02:00
Michael Kerrisk c73dc4fe14 connect.2: Remove mention of ip_local_port_range under EAGAIN error 
Man-pages commit ac7477eb7a 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.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 13:34:53 +02:00
Michael Kerrisk a568e16408 dup.2: grfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 11:30:07 +02:00
Michael Kerrisk 103ea4f6b3 open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 11:25:57 +02:00
Michael Kerrisk 2feae60283 open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 11:23:13 +02:00
Michael Kerrisk d6a74b9559 open.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 11:06:18 +02:00
Michael Kerrisk caf2083a46 socket.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 10:51:31 +02:00
Michael Kerrisk 9af6b11576 open.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 10:39:47 +02:00
Michael Kerrisk 177660fae0 ptrace.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 10:10:03 +02:00
Michael Kerrisk cb8a928f3a perf_event_open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 09:37:03 +02:00
Michael Kerrisk 0c892e5b60 sigaltstack.2: spfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 09:21:30 +02:00
Simon Paillard 18c9919b48 fallocate.2: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-19 08:16:04 +02:00
Michael Kerrisk be5c465e9f fanotify_init.2: Tweak's to Heinrich Schuchardt's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-18 09:47:39 +02:00
Heinrich Schuchardt 1caffed4af fanotify_init.2: 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.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-18 09:47:08 +02:00
Simon Paillard 3fcc7a7afd semget.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-18 08:49:06 +02:00
Michael Kerrisk db122bbd33 ioctl.2: tfix 
Reported-by: Jon Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-16 20:10:58 +02:00
Michael Kerrisk 0e1c72e995 msgop.2: Drop some details from Davidlohr Bueso's patch 
MSGTQL on other systems is a system-wide limit, not a
per-queue limit.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-16 14:45:24 +02:00
Michael Kerrisk ab1b15aa37 msgop.2: Rewordings of Davidlohr Bueso's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-16 14:45:24 +02:00
Davidlohr Bueso 64190fa613 msgop.2: Enhance description of "full queue" criteria 
Signed-off-by: Davidlohr Bueso <davidlohr@hp.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-05-16 14:45:18 +02:00