Commit Graph

11197 Commits

Author SHA1 Message Date
Michael Kerrisk b212fd5cc3 Ready for 3.70 2014-07-08 16:36:43 +02:00
Michael Kerrisk cbe0e64447 Removed trailing white space at end of lines 2014-07-08 16:36:37 +02:00
Michael Kerrisk b73bd26850 Changes: Expanded tabs 2014-07-08 16:36:37 +02:00
Michael Kerrisk 65266f17a0 Changes: Ready for 3.70
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:29:59 +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 ab98e0fbaa ldd.1: SEE ALSO: add sprof(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk 5f97eb3b5b profil.3: SEE ALSO: add sprof(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk cf28f98af0 ld.so.8: SEE ALSO: add sprof(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk 9237566298 sprof.1: Reviewed by Marko Myllynen
Reviewed-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk 2adccceb6c sprof.1: New page for the glibc sprof(1) command
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk 7c7a7df356 ld.so.8: Clarify that LD_PROFILE can specify just a single shared object
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk c64ea262fa ld.so.8: Clarify that LD_PROFILE output is appended to target file
The LD_PROFILE output is appended to any existing
contents of the target file.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 16:07:48 +02:00
Michael Kerrisk e95b1911c4 inotify.7: Clarify with events are generated for watched directories
Really, with respect to watched directories, events fall into
three classes (not two, as was shown):

* Events that can be generated only for the watched directory.
* Events that can be generated only for objects that are inside
  the watched directory.
* Events that can be generated both for the watched directory
  and for objects inside the directory.

So, mark these three classes more clearly in the list of inotify
events.
dd

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-08 14:27:44 +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
Michael Kerrisk 640a438d9b pipe.7: Clarify that since 2.6.35, 65535 bytes is the default pipe capacity
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 14:33:38 +02:00
Elie De Brauwer 91d4de6683 pipe.7: Add reference that the pipe capacity can be changed.
In fcntl(2) F_SETPIPE_SZ, F_GETPIPE_SZ and /proc/sys/fs/pipe-max-size are
defined, however pipe(7) still defines the pipe capacity as being a static
entity. Adding a reference to fcntl(2).

Signed-off-by: Elie De Brauwer <eliedebrauwer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:31 +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 d3695ae2c7 epoll.7: Minor tweaks to Neil Brown's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:15 +02:00
NeilBrown 6db5acce0e epoll.7: Document EPOLLWAKEUP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-07 09:07:12 +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 f070e9543a inotify.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 08:16:49 +02:00
Michael Kerrisk 2460ac0e19 mallopt.3: MALLOC_MMAP_THRESHOLD_ and MALLOC_MMAP_MAX_ *do* work in setgid programs
My testing on this point was bogus, overlooking details of
strace(1)'s behavior with setuid programs.

See https://sourceware.org/bugzilla/show_bug.cgi?id=12155

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-07-01 08:16:37 +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 812040568c printf.3: Update references to standards for C and S conversion specifiers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 5afad698ec printf.3: Remove some old text about glibc 2.0 changes
We probably don't now need such ancient info.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk f835f2c4d9 printf.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk fb307ec732 getpass.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk c2b5a65ea5 cmsg.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 7905872b28 printf.3: Remove libc4 and libc5 details
Rich Felker noted that "scare text" in the man page warned about
the use of snprintf() on libc, and that some people had cited
this as a reason not to use snprintf().  Linux libc is now
ancient history, so there is no real need to keep that text.
But, while we're at it, we may as well clear out all of the
other ancient libc4 and libc5 pieces in the page. They are
nowadays more clutter than help.

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 57598eb158 printf.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 2eaa5bec3c libc.7: Clarify man-pages policy on documenting C libraries other tahn glibc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 738dea653b libc.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk a59ac1b5a5 libc.7: Use absolute dates in discussion of libc vs glibc
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:08 +02:00
Michael Kerrisk 588d27ea86 printf.3: SUSv3 and later agree with C99 for the snprintf() return value
Determined by inspection of the SUSv3 and SUSv4 specifications.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:49:02 +02:00
Michael Kerrisk dcaff23c32 inotify.7: Clarify IN_ONESHOT explanation
Make it clearer that the target of monitoring is an i-node,
not a pathname.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-29 09:48:45 +02:00
Michael Kerrisk 7747b84b82 inotify.7: Clarify description of IN_EXCL_UNLINK
Clarify the text a little, in particular making it clearer
that the target of a watch is an i-node (not a pathname).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:52:48 +02:00
Michael Kerrisk 264545c62e inotify.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-28 07:49:06 +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