Commit Graph

2031 Commits

Author SHA1 Message Date
Michael Kerrisk 47f442b232 wait.2: Added FIXME 2009-01-14 10:41:54 +13:00
Michael Kerrisk 98895092a0 signalfd.2: Fix description of fork() semantics
The page text described the semantics of the initial
implementation of signalfd().  These were changed early on,
but the man page wasn't updated.

Reported-by: Vegard Nossum <vegard.nossum@gmail.com>
Reviewed-by: Davide Libenzi <davidel@xmailserver.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:53 +13:00
Michael Kerrisk 59190704db signalfd.2: ffix 2009-01-14 10:41:53 +13:00
Michael Kerrisk 8f998fb470 getdents.2: Before kernel < 2.6.4, 'd_type' was effectively always DT_UNKNOWN
Reported-by: Bastien ROUCARIES <roucaries.bastien@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:52 +13:00
Michael Kerrisk ade8a1f9f6 getdents.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-14 10:41:44 +13:00
Michael Kerrisk de9ed3a3ab syscalls.2, feature_test_macros.7, standards.7: SEE ALSO: add libc(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 08:37:49 +13:00
Michael Kerrisk 8a2d6d4bd3 gethostid.2: New link to new page location in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:03:45 +13:00
Michael Kerrisk 2d1806c94d sethostid.2: Change link to point to new page location in Section 3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:02:55 +13:00
Michael Kerrisk 1f4f66a924 gethostid.2: Move to Section 3
The interfaces documented in this page are purely glibc.

Reported-by: Colin Watson <cjwatson@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-01-13 07:00:44 +13:00
Michael Kerrisk 53e819d017 syscalls.2: Kerenl 2.6.28 adds accept4()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-06 12:32:56 -05:00
Michael Kerrisk 8ccde1f0a5 Removed trailing white space at end of lines 2008-12-05 22:53:52 -05:00
Michael Kerrisk d308da3058 pread.2: tfix 2008-12-05 22:47:26 -05:00
Michael Kerrisk 6eb334b2cf bind.2, rcmd.3, capabilities.7, ip.7: Global fix: s/reserved port/privileged port/
Some pages used one term, some pages the other term;
make some consistency.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:26 -05:00
Michael Kerrisk dcaec854fe syslog.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:25 -05:00
Michael Kerrisk 03d5ef0d71 signal.2: grfix 2008-12-05 22:47:24 -05:00
Michael Kerrisk a3680fde95 setfsgid.2, setfsuid.2: Simplify version information and move to a VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 8b98e6fc31 select.2: Rewrote text describing feature test macro requirements for pselect()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 21c39e5919 select_tut.2: Fix SHUT_FD* macros in example program
Add "do {} while (0)"

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:24 -05:00
Michael Kerrisk 54781a2395 select_tut.2: wsfix in example program 2008-12-05 22:47:24 -05:00
Michael Kerrisk 5af0d2f5d3 pread.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk d95f2e31bd mq_getsetattr.2: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk 12bbec1b16 getsid.2: Simplified version information and moved to a new VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:23 -05:00
Michael Kerrisk 5e4dc2691b open.2, stat.2: tfix s/_FILE_OFF_SET_BITS/_FILE_OFFSET_BITS/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Chris Heath <chris@heathens.co.nz>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 9dcc46058a stat.2: Document EOVERFLOW error
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Andre Majorel <aym-xunil@teaser.fr>
2008-12-05 22:47:18 -05:00
Michael Kerrisk 7c7fb55221 open.2: EFBIG error is now EOVERFLOW (since Linux 2.6.24)
When a 32-bit app opens a file whose size is too big to be
represented in 31-bits, POSIX.1 specifies the error EOVERFLOW.
Linux used to give EFBIG for this case, but 2.6.24 fixed this.

Also, add some text to describe the error scenario in
more detail.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:18 -05:00
Michael Kerrisk fecaa19a28 accept.2: Reorder ERRORS list
Some errors were listed under a separate "may" heading.
There's probably no real need to do this; integrate
those errors into the main list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:47:17 -05:00
Michael Kerrisk 9baab2ae47 accept4.2: New link to accept.2
accept.2 now documents the new accept4() system call.
2008-12-05 22:47:17 -05:00
Michael Kerrisk 6f74cfbb4b accept.2: Document accept4() system call, new in Linux 2.6.28 2008-12-05 22:47:17 -05:00
Michael Kerrisk cc883662a3 uname.2: DESCRIPTION: Point reader at NOTES for further info on field lengths
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Rob Landley <rob@landley.net>
2008-12-05 22:29:01 -05:00
Michael Kerrisk 3e4088f4a4 getpeername.2, getsockname.2, getsockopt.2, recv.2, send.2, shutdown.2: minor s/s/sockfd/ for cases not caught in previous changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 75c5960113 shutdown.2: wfix 2008-12-05 22:28:59 -05:00
Michael Kerrisk 710631e8bf setup.2: Relocate some CONFORMING TO text to VERSIONS and NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 97fce6cd66 setsid.2: Rework RETURN VALUE section; add an ERRORS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk b56905c62b send.2: wfix (s/s/sockfd/ for a case missed earlier) 2008-12-05 22:28:59 -05:00
Michael Kerrisk 167441ee0b send.2: Minor layout fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:59 -05:00
Michael Kerrisk 6926dbf541 recv.2, send.2: Make names of "address" and "address length" args more consistent
Make the names of these arguments more consistent with other
sockets man pages.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk a2b8b6d657 connect.2, getpeername.2, getsockname.2: Use consistent argument names
Most other sockets pages are using the names 'addr'
and 'addrlen'; make these pages do the same.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk f7c494fb23 getsockname.2: Note that returned address is truncated if buffer is too small
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:58 -05:00
Michael Kerrisk cb15903860 getpeername.2: Note that returned address may be truncated if buffer is too small
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk 59682186ca recv.2: Clarify details when returned address is truncated
If the recvfrom() returned address is truncated, the 'fromlen'
argument indicates the actual size of the address, rather than
a count of the number of bytes in the truncated buffer.

Also clarify that the 'from' argument can be NULL, in which
case 'fromlen' should is unused, and should also be NULL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk b98353f035 accept.2: Clarify details when returned address is truncated
If the returned address is truncated, the 'addrlen' argument
indicates the actual size of the address, rather than a count
of the number of bytes in the truncated buffer.

Also clarify that if 'addr' argument is NULL, then 'addrlen'
should is unused, and should also be NULL.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk 3fdfdab83c getsockopt.2: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk f145728e61 pread.2: Note that glibc emulation for these calls uses lseek(2)
(This makes it clearer that the emulated calls are not atomic.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk 3c19f5edd6 getsockname.2: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:57 -05:00
Michael Kerrisk c4e7b71426 getpeername.2, getsockname.2, getsockopt.2, recv.2, send.2, shutdown.2, sockatmark.3, socket.7, udplite.7: SYNOPSIS: Rename socket file descriptor argument to 'sockfd'
Many sockets man pages use the name 'sockfd' already.
For consistency, changes the others to do so as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Michael Kerrisk 0b11419eb4 getpeername.2: Minor rewordings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Michael Kerrisk 293283613f mmap.2: srcfix: spfix 2008-12-05 22:28:55 -05:00
Michael Kerrisk 6aa7db0a8f mmap.2: Loosen language around how 'addr' hint is interpreted
Mel Gorman reported that in Linux 2.6.27, 'addr' is rounded
down to a page boundary.

Before kernel 2.6.26, if 'addr' was taken as a hint, it was
rounded up to the next page boundary.  Since Linux 2.6.24,
it is rounded down.  Therefore, loosen the description of
this point to say that the address is rounded to "a nearby
page boundary".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Mel Gorman <mel@csn.ul.ie>
2008-12-05 22:28:55 -05:00
Michael Kerrisk e9ef777f73 stat.2: Refer reader to major() and minor() to decompose a device ID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
Michael Kerrisk 6437f56b55 mknod.2: Refer reader to makedev(3) to build a device ID
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00