Commit Graph

11481 Commits

Author SHA1 Message Date
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
Michael Kerrisk 425ad621fc inotify.7: Make comment on 'mask' field more accurate
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-27 15:59:23 +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 492d9973f4 unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:09:28 +02:00
Michael Kerrisk 57e792311a utf-8.7: Minor formatting fixes
There's no need really to boldface names of standards and
character sets.

Reported-by: Marko Myllynen <myllynen@redhat.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:08:09 +02:00
Michael Kerrisk f2cf1fbfe5 unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:01:18 +02:00
Michael Kerrisk beecf99ef7 unicode.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 12:00:03 +02:00
Michael Kerrisk 183520673b unicode.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 11:59:35 +02:00
Michael Kerrisk 9423e95b07 unicode.7: Minor formatting fixes
There's no need really to boldface names of standards and
character sets.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 11:58:39 +02:00
Marko Myllynen 66676c9124 charmap.5: Various minor updates and improvements
- more precise title
- extend description a bit
- document previously omitted WIDTH_DEFAULT

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 11:41:20 +02:00
Marko Myllynen fb787570dc iconv.1, localedef.1, iconvconfig.8: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2014-06-24 10:48:24 +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 31987bef1b proc.5: Replace /proc/sys/kernel/printk discussion with reference to syslog(2)
It makes more sense to have the /proc/sys/kernel/printk with
the related material in syslog(2).

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