Michael Kerrisk
f9fb3ffcb5
recv.2: Add 'iovec' defn to defn of 'msghdr' structure
...
The 'msghdr' structure includes a field of type 'iovec',
so show the definition of that structure in this page.
Reported-by: Johannes Stezenbach <js@sig21.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-03-10 11:02:58 +13:00
Michael Kerrisk
86426e0be4
accept.2, read.2, recv.2, send.2, write.2: Fix discussion of EAGAIN/EWOULDBLOCK errors
...
For a non-blocking socket, POSIX.1-2001/2008 allow either
EAGAIN or EWOULDBLOCK to be returned in cases where a call
would have blocked. Although these constants are defined
with the same value on most Linux architectures (PA-RISC
is the exception), POSIX.1 does not require them to have
the same value. Therefore, a portable application using
the sockets API should test for both errors when checking
this case.
(NB POSIX.1 only mentions EWOULDBLOCK in the context of
the sockets interfaces.)
Change made after a note cross-posted on linux-arch@vger,
http://thread.gmane.org/gmane.linux.debian.ports.hppa/5615
and a suggestion for write(2) from Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@systemhalted.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-02-23 20:31:52 +13: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
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
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
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
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
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
Nicolas François
5f3fb725ab
recv.2: Move kernel version number to first mention to MSG_ERRQUEUE.
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-09-29 11:46:01 +02:00
Michael Kerrisk
6eb4bccc16
Noted which flags appered in Linux 2.2.
2008-07-14 05:26:06 +00:00
Michael Kerrisk
c4bb193f3c
s/parameter/argument/ when talking about the things given
...
to a function call, for consistency with majority usage.
2008-07-10 20:53:08 +00:00
Michael Kerrisk
01538d0d51
ERRORS: Added reference to signal(7) in dicussion of EINTR.
2008-07-04 15:50:36 +00:00
Michael Kerrisk
ddc676f488
Add comment to 'ee_pad' field in structure definition.
2008-06-18 12:57:21 +00:00
Michael Kerrisk
23b98a4c61
Update timestamp
2008-05-29 08:02:43 +00:00
Michael Kerrisk
090ed1ef8e
Improve wording for EAGAIN error in discussion of MSG_DONTWAIT.
2008-04-18 16:17:12 +00:00
Michael Kerrisk
c382a36592
hyphenation fixes
2007-12-25 22:02:19 +00:00
Michael Kerrisk
d19a206dbb
grfix
2007-12-25 21:30:22 +00:00
Michael Kerrisk
aeb4b1fc8b
s/u_long/unsigned long/
...
s/ulong/unsigned long/
s/u_char/unsigned char/
s/u_short/unsigned short/
s/ushort/unsigned short/
s/u_int8_t/uint8_t
s/u_int16_t/uint16_t
s/u_int32_t/uint16_t
s/u_int/unsigned int/
2007-12-23 17:26:26 +00:00
Michael Kerrisk
a08ea57c20
Make the standard indent for code samples, shell session
...
logs, etc. to be ".in +4n".
2007-12-19 05:53:30 +00:00
Michael Kerrisk
0daa9e92d0
Fix redundant formatting macros
2007-09-20 16:26:31 +00:00
Michael Kerrisk
499f416724
Added description of MSG_CMSG_CLOEXEC (new in 2.6.23).
2007-09-10 04:35:02 +00:00
Michael Kerrisk
66ee0c7e89
ffix
2007-06-23 07:19:07 +00:00
Michael Kerrisk
09b235db2a
Format errno.
2007-06-22 06:05:43 +00:00
Michael Kerrisk
2b0fa18232
replace form `....' with \fI...\fP where the enclosed string is a pathname,
...
type name, or argument name.
2007-06-12 21:19:16 +00:00
Michael Kerrisk
28442c8f31
grfix
2007-06-02 05:49:27 +00:00
Michael Kerrisk
1c27853f55
Added new EXAMPLE section referring to example in getaddrinfo.3
2007-05-28 10:53:03 +00:00
Michael Kerrisk
6996254443
Fix inconsistencies in .TH lines
2007-05-18 09:55:10 +00:00
Michael Kerrisk
c13182efa3
Wrapped long lines, wrapped at sentence boundaries; stripped trailing
...
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk
97c1eac86f
Updated CONFORMING TO section
2006-08-03 13:57:17 +00:00
Michael Kerrisk
84564be219
Added SEE ALSO for new sockatmark.3.
2006-04-22 03:18:05 +00:00
Michael Kerrisk
1c511da218
Updated FIXME.
2006-04-03 01:35:31 +00:00
Michael Kerrisk
7080c286cd
Removed a misleading cross-ref to socket.2.
2006-03-31 22:58:00 +00:00
Michael Kerrisk
16c892d319
Documented EINVAL error for 'len' < 0.
2006-03-31 22:12:10 +00:00
Michael Kerrisk
ea4adf4ba9
Added text to note that although POSIX says msg_controllen
...
should be socklen_t, glibc actually uses size_t.
Various formatting fixes.
2006-03-12 19:09:15 +00:00
Michael Kerrisk
62d4f1bd38
Relocate misplaced discussion of MSG_DONTWAIT.
2006-01-13 07:56:23 +00:00
Michael Kerrisk
512c311c5e
Put 'flags' list in alphabetical order.
2005-12-14 16:44:39 +00:00
Michael Kerrisk
1e32103455
Formatting fixes
2005-10-20 15:11:10 +00:00
Michael Kerrisk
e511ffb6bc
Automated addition of parentheses by add_parens_for_own_funcs.sh
2005-10-19 06:54:38 +00:00
Michael Kerrisk
b14d4aa5b8
Classical BSD versions are now always named x.yBSD (formerly
...
there was a mix of x.yBSD and BSD x.y).
2005-07-18 15:05:56 +00:00
Michael Kerrisk
85a3dc20db
Added SEE ALSO for shutdown(2)
2005-06-30 09:40:35 +00:00
Michael Kerrisk
fea681dafb
Import of man-pages 1.70
2004-11-03 13:51:07 +00:00