Commit Graph

5632 Commits

Author SHA1 Message Date
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
Mats Wichmann 4510cb9d07 bindresvport.3: SYNOPSIS: s/\*\*/*/ in prototype
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Mats Wichmann 56b2037871 bindresvport.3: wfix tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Michael Kerrisk 42e2d16019 Changes.old: minor: Fix mislocated text in 3.01 changelog
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:56 -05:00
Andries E. Brouwer be4c136ad5 atan.3: Fix return value description
The correct range for the return value is [-pi/2,pi/2].
(mtk's fix in the last change to the return value text was
a botch-up of a (correct) suggestion by Nicolas Francois.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:55 -05:00
Michael Kerrisk 636297e97b proc.5: /proc/stat: s/minor/disk_idx/ in description of /proc/stat
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=225619

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Mike Fedyk <mfedyk@mikefedyk.com>
2008-12-05 22:28:55 -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 2bada9cfe0 makedev.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
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
Michael Kerrisk 0382510bc1 makedev.3: srcfix: remove FIXMEs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
Michael Kerrisk 4770bc9118 gnu_dev_major.3, gnu_dev_makedev.3, gnu_dev_minor.3, major.3, minor.3: New links to new makedev(3) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:54 -05:00
Michael Kerrisk 47a0131ab7 makedev.3: New page for makedev(), major(), and minor() macros
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Phil Endecott <phil_vonar_endecott@chezphil.org>
2008-12-05 22:28:54 -05:00
Michael Kerrisk 857842b0cb recv.2: Internet datagram and netlink sockets support MSG_TRUNC for recv(2)
Internet datagram (since Linux 2.4.27/2.6.8),
and netlink (since Linux 2.6.22) sockets support
the MSG_TRUNC flag for recv(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:53 -05:00
Michael Kerrisk 77e75b9077 unix.7: Unix domain sockets don't support the recv() MSG_TRUNC flag
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:28:44 -05:00
Michael Kerrisk 238534b031 tcp.7: Document MSG_TRUNC flag for TCP sockets
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:09 -05:00
Michael Kerrisk 5dfedcae40 accept.2, listen.2, recv.2, getpeername.2, getsockname.2, shutdown.2, socketpair.2: Global fix: SEE ALSO: add socket(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:09 -05:00
Michael Kerrisk c24995b98f socket.7: SEE ALSO: add tcp(7) and udp(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:09 -05:00
Michael Kerrisk 89c9c9537b udp.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 19e19f5f8a unix.7: Retitled subsection "(Un)supported features" to "Sockets API"
This is consistent with the recent change in tcp(7).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk de092003b7 tcp.7: Note that MSG_PEEK can be used on out-of-band data
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk d888f6a3a6 tcp.7: Relocate out-of-band data discussion
Move to a new subsection entitled "Sockets API".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 1bc510f506 unix.7: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:08 -05:00
Michael Kerrisk 2d08404c52 getdomainname.2: Substantial rewrite
Expand description of setdomainname() and getdomainname().
Note that getdomainname() is implemented as a library function
in glibc.
Note limits on size of domain name.
Reorganize ERRORS list.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:07 -05:00
Michael Kerrisk 47c983310b uname.2: srcfix: Added some source comments 2008-12-05 22:18:07 -05:00
Michael Kerrisk 01334a2e21 uname.2: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:07 -05:00
Michael Kerrisk e8d2d05f40 gethostname.2: Note that HOST_NAME_MAX is 64 on Linux
Also note that in pre-1.0 days, the limit on hostnames
was 8 bytes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-12-05 22:18:03 -05:00
Michael Kerrisk 1f9fdf425b gethostname.2: Various parts rewritten
Write a paragraph describing sethostname().

Clarify differences between glibc's gethostbyname() and
the kernel gethostbyname() system calls.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 15:48:46 -05:00
Michael Kerrisk 6a69a198b6 exit_group.2: Note that since glibc 2.3, exit(2) invokes exit_group() 2008-11-28 12:13:02 -05:00
Michael Kerrisk 9abeddb24c _exit.2: Since glibc 2.3, the exit() wrapper function invokes exit_group(2)
This information is useful to users of strace(1).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 12:04:51 -05:00
Michael Kerrisk 3ab40aecac set_thread_area.2: Note that glibc provides no wrapper for this system call
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:40:28 -05:00
Michael Kerrisk 6977c3c1b4 get_thread_area.2: Note that glibc provides no wrapper for this system call
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:39:55 -05:00
Michael Kerrisk fcdad7d6ff futex.2: Mention that glibc provides no wrapper function for futex()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:31:35 -05:00
Michael Kerrisk 30fa088c1b syscalls.2: Fix version numbers for a few system calls
Some 2.6 system calls were wrongly mentioned as also being
backported into a 2.4.x kernel.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:25:14 -05:00
Sam Varshavchik 314c72c381 CPU_SET.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-28 11:18:52 -05:00