Commit Graph

4221 Commits

Author SHA1 Message Date
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