Commit Graph

46 Commits

Author SHA1 Message Date
Michael Kerrisk b637ad73b1 recv.2, send.2: Remove obsolete reference to glibc version in NOTES
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 08:32:22 +02:00
Nicholas Hunt f07435fbcc recv.2, send.2: Adjust type shown for msg_controllen to glibc reality
This patch fixes the type of msg_controllen in the struct msghdr
definition given in send.2 and recv.2 to match the definition in
glibc and the kernel.

Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 08:29:04 +02:00
Michael Kerrisk 13a36929ad recv.2: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-06-12 14:42:50 +02:00
Michael Kerrisk ff40dbb354 accept.2, connect.2, eventfd.2, flock.2, open.2, posix_fadvise.2, read.2, recv.2, sched_setscheduler.2, select_tut.2, send.2, signalfd.2, splice.2, timerfd_create.2, write.2, flockfile.3, mkfifo.3, mq_notify.3, mq_open.3, pthread_tryjoin_np.3, scanf.3, random.4, ddp.7, epoll.7, fifo.7, ip.7, pipe.7, socket.7, spufs.7: Global fix: s/non-blocking/nonblocking/
The tendency in English, as prescribed in style guides like
Chicago MoS, is towards removing hyphens after prefixes
like "non-" etc.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2010-01-16 17:43:10 +01:00
Nicolas François 22e7039097 recv.2: Minor fixes
Fix some formatting typos
 * the period should be in Roman font
 * .RP does not exist, it should be .RB

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:24 +02:00
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