Commit Graph

7916 Commits

Author SHA1 Message Date
Michael Kerrisk b8b850053f select.2: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk a16eec1e9c select.2: Add further details on pselect6() system call that underlies pselect()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 736552001d semop.2: Clarify that 'timeout' of semtimedop() is a *minimum* interval
Make it clear that 'timeout' interval will be rounded up to the
system clock granularity, and may overrun because of kernel
scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 3a1876bd71 recvmmsg.2: Clarify that 'timeout' is a *minimum* interval
Make it clear that 'timeout' interval will be rounded up to the
system clock granularity, and may overrun because of kernel
scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 95b803548b sigwaitinfo.2: Clarify that 'timeout' of sigtimedwait() is a *minimum* interval
Make it clear that 'timeout' is a minimum interval; the actual
interval will be rounded up to the system clock granularity,
and may overrun because of kernel scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 77e74cf141 poll.2: Make the meaning of a zero timeout explicit
Clarify that timeout==0 causes an immediate return, even if
no file descriptors are ready.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 19257d8fe6 poll.2: Clarify that 'timeout' is a *minimum* interval
Make it clear that 'timeout' is a minimum interval; the actual
interval will be rounded up to the system clock granularity,
and may overrun because of kernel scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk f07cd91a9e epoll_wait.2: Clarify that 'timeout' is a *minimum* interval
Make it clear that 'timeout' is a minimum interval; the actual
interval will be rounded up to the system clock granularity,
and may overrun because of kernel scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 8c121f4004 select.2: Clarify that 'timeout' is a *minimum* interval
Make it clear that 'timeout' is a minimum interval; the actual
interval will be rounded up to the system clock granularity,
and may overrun because of kernel scheduling delays.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Mike Frysinger aed1f3b9fb fork.2: ERRORS: add ENOSYS
Can occur on, for example, non-MMU hardware.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Jan Kara 04cd7f643d open.2: Describe race of direct read and fork() for unaligned buffers
This is a long standing problem (or a surprising feature) in our
implementation of get_user_pages() (used by direct IO). Since
several attempts to fix it failed (e.g.,
http://linux.derkeiler.com/Mailing-Lists/Kernel/2009-04/msg06542.html,
or http://lkml.indiana.edu/hypermail/linux/kernel/0903.1/01498.html
refused in http://comments.gmane.org/gmane.linux.kernel.mm/31569)
and it's not completely clear whether we really want to fix
it given the costs. Let's at least document it.

Signed-off-by: Jan Kara <jack@suse.cz>
Acked-by: Jeff Moyer <jmoyer@redhat.com>
Acked-by: Mel Gorman <mgorman@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Yuri Kozlov 9a830e6211 prctl.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Yuri Kozlov ad803da5ce nsswitch.conf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk df2b6326f6 signal.7: Update architectures for tables of signal numbers
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk ae5a2d432d signal.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 6cf29aced9 signal.7: Clarify that SIGLOST is unused
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk d396c17729 signal.7: Comment out crufty BUGS text on SIGLOST
It must be a very long time since the statement there
about SIGLOST was true. (The text seems to date back to
1996.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 6cfe62252d fopencookie.3: Correct description of return for user-supplied 'write' function
See http://sourceware.org/bugzilla/show_bug.cgi?id=2074

Reported-by: Petr Baudis <pasky@ucw.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk d865ce2de1 syslog.3: Update CONFORMING TO for POSIX.1-2008
POSIX.1-2008 doesn't change any details, but make
that more explicit.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk e0fba797ae syslog.3: Document behavior when 'ident' argument to openlog() is NULL
See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/382096

Reported-by: Ralph Corderoy <ralph@inputplus.co.uk >
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk 8d8eb2f0c8 epoll_wait.2: Minor wording clarification to EINTR error
Try to avoid the type of misreading reported in
https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/480566

Reported-by: Angelo Borsotti <angelo.borsotti@gmail.com >
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:14 +12:00
Michael Kerrisk a1d10f19c3 sk98lin.4: Note that this driver was removed in 2.6.28
See https://bugs.launchpad.net/ubuntu/+source/manpages/+bug/528020

Reported-by: Stephen Hemminger <shemminger@vyatta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 2540aee7c2 makedev.3: SYNOPSIS: Correct return types of major() and minor()
See https://bugzilla.redhat.com/show_bug.cgi?id=754188

Reported-by; Zdenek Kabelac <zkabelac@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 22594a3cb6 clock_getres.2: Expand description of CLOCK_REALTIME
Make it clear that this clock may be discontinuous, and is
affected my incremental NTP and clock-adjtime(2) adjustments.

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=540872

Reported-by: Josh Triplett <josh@joshtriplett.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Brian M. Carlson 4550bf19cf utf-8.7: Two clarifications
This patch clarifies that 0xc0 and 0xc1 are not valid in any UTF-8
encoding[0], and it also references RFC 3629 instead of RFC 2279.

[0] In order to have 0xc0, you'd have to have a two-byte encoding
with all the data bits zero in the first byte (and thus only six
bits of data), which would be an ASCII character encoded in the
non-shortest form.  Similarly with 0xc1.

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=538641

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk c3ee1c5d6a pread.2: BUGS: Note O_APPEND + pwrite() does the wrong thing
See https://bugzilla.kernel.org/show_bug.cgi?id=43178

Reported-by: Kasper Dupont <kasperd@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 927ad1fb59 mallopt.3: Fix example program
The example code was a version that was not consistent with
the shell output shown on the page.

Reported-bY: Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 9f0977ffbc mallopt.3: Restore accidentally omitted line in shell session
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Jean-Michel Vourgère 712b0341f5 getaddrinfo.3: Note that AI_ADDRCONFIG is not affected by loopback addresses
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=660479

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Yuri Kozlov a74fcea680 wcsncmp.3: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Jason Baron c639b31479 madvise.2: Document MADV_DONTDUMP and MADV_DODUMP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Stefan Puiu 85ab5d7ad6 ipv6.7: Add ENODEV error for bind() to link-local IPv6 address
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk e70cfff8b5 fmemopen.3: BUGS: Note inconsistent treatment of 'b' in 'mode'
fopen() permits, for example, both "w+b" and "wb+",
but only the latter is meaningful to fmemopen().

See http://sourceware.org/bugzilla/show_bug.cgi?id=12836

Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 005e6bb888 fmemopen.3: BUGS: fmemopen() doesn't correctly set file position in some cases
If 'mode' is append, but 'size' does not cover a null byte
in 'buf', then fmemopen() incorrectly sets the initial file
position to -1, rather than the next byte after the end of
the buffer.

See http://sourceware.org/bugzilla/show_bug.cgi?id=13151

Reported-by: Rich Felker <bugdal@aerifal.cx>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 8f60b371e7 fmemopen.3: BUGS: Append mode does not force writes to append
Append mode correctly sets the initial offset but does
not force subsequent writes to append at end of stream.

See http://sourceware.org/bugzilla/show_bug.cgi?id=13152

Reported-by: Rich Felker <bugdal@aerifal.cx>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 8154f292d8 fmemopen.3: BUGS: fmemopen() incorrectly handles size==0 case
If size is zero, fmemopen() fails, This is surprising behavior,
and not specified in POSIX.1-2008.

See http://sourceware.org/bugzilla/show_bug.cgi?id=11216

Reported-by; Alex Shinn <alexshinn@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 84133057b7 fmemopen.3: BUGS: Note silent ABI change for fmemopen() in glibc 2.9
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 360e0be298 fmemopen.3: Note details of POSIX.1-2008 specification of 'b' in 'mode'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk d8eca5853d fmemopen.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 9f6ec7b1e8 mallopt.3: SEE ALSO: Add malloc_stats(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 5ff479a45e malloc.3, mallopt.3: SEE ALSO: Add malloc_info(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 1da7358ef9 malloc_stats.3: Remove text referring to mmap(2)
Reviewed-by: KOSAKI Motohiro <kosaki.motohiro@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:13 +12:00
Michael Kerrisk 067568db96 malloc_stats.3: New man page for malloc_stats(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:07 +12:00
Michael Kerrisk a5cbea5f2b malloc_info.3: Point out use of open_memstream()
Note the use of open_memstream() to store XML output
directly into a buffer.

Reported-by: Jakub Jelinek <jakub@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-06 10:25:33 +12:00
Michael Kerrisk 47c3118377 malloc_info.3: New page for malloc_info(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-06 10:25:33 +12:00
Michael Kerrisk 35af1345a1 mallinfo.3: Add xref from 'hblks' explanation to M_MMAP_THRESHOLD in mallopt(3)
Reported-by: KOSAKI Motohiro <kosaki.motohiro@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-06 10:25:24 +12:00
Michael Kerrisk e478c637ba mallinfo.3: srcfix: Add FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-27 11:17:10 +12:00
Michael Kerrisk 669aadbba1 mallinfo.3: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-27 11:17:10 +12:00
Michael Kerrisk 3c81c5a456 mallinfo.3: Minor improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-27 11:17:09 +12:00
Michael Kerrisk f704bc68d2 mallinfo.3: Note mallinfo() bug for multiple arenas
Reported-by: Paul Pluzhnikov <ppluzhnikov@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-27 11:17:09 +12:00