Commit Graph

51 Commits

Author SHA1 Message Date
Michael Kerrisk 3701130ad7 send.2: wfix
Signed-off-by: Michael Kerrisk <mtk@konstanz.(none)>
2010-08-29 08:33:07 +02:00
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 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
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 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 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 5a2ff571fb connect.2, listen.2, send.2, uname.2, cmsg.3, proc.5, arp.7, ddp.7, icmp.7, ip.7, raw.7, socket.7, tcp.7, udp.7: Global fix: eliminate mention of the obsolete sysctl(2) interface
Many pages still mention use of the obsolete sysctl(2) system
call, or used the term "sysctls"; rewrite these mentions to
instead be in terms of /proc interfaces.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:11 -05:00
Michael Kerrisk 7f546896f5 tstamp 2008-10-06 16:26:23 +02:00
Michael Kerrisk 2dd5352dae send.2: make kernel version for MSG_CONFIRM more precise
s/2.3+ only/Since Linux 2.3.15/

Reported-by: Nicolas François <nicolas.francois@centraliens.net>
2008-09-29 12:35:13 +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 ca92ce95a3 Remove/replace extraneous .sp macros. 2008-01-01 14:13:55 +00:00
Michael Kerrisk 5895e7eb8d wspace in SYNOPSIS 2007-12-23 13:45:24 +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 66ee0c7e89 ffix 2007-06-23 07:19:07 +00:00
Michael Kerrisk 097585edcb ffix 2007-06-22 20:40:07 +00:00
Michael Kerrisk 2f0af33ba6 ffix 2007-06-22 19:42:52 +00:00
Michael Kerrisk 1274071a69 ffix 2007-06-22 18:25:23 +00:00
Michael Kerrisk 0e1ad98ccf Updated FIXMEs 2007-06-13 21:48:16 +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 75b94dc35c Change "e.g. " to "e.g., ", or in some cases, "for example, ".
Change "i.e. " to i.e.., ", or in some cases, "that is, ".
2007-06-08 11:56:22 +00:00
Michael Kerrisk d9bfdb9c21 Convert to American spelling conventions 2007-06-08 09:56:56 +00:00
Michael Kerrisk d9343c5c13 Removed version number from .TH line 2007-05-30 05:36:26 +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 ad7cc990f2 Change reference to path_resolution.2 to path_resolutiion.7 2007-05-26 12:41:39 +00:00
Michael Kerrisk 0bfa087b03 Add section numbers to references to other pages 2007-05-11 23:07:02 +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 521bf58405 ffix 2007-04-03 14:04:54 +00:00
Michael Kerrisk 97c1eac86f Updated CONFORMING TO section 2006-08-03 13:57:17 +00:00
Michael Kerrisk 211ec15cf1 Fix missing arguments in statement about equivalent send() and sendto() calls. 2006-06-05 04:51:40 +00:00
Michael Kerrisk 7145b9a93c spfix 2006-06-03 01:26:30 +00:00
Michael Kerrisk 1c511da218 Updated FIXME. 2006-04-03 01:35:31 +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 92057f4dbc Updated FIXMEs 2006-02-08 09:44:13 +00:00
Michael Kerrisk 1df419f2b7 Add cmsg.3 to SEE ALSO. 2005-12-19 09:16:57 +00:00
Michael Kerrisk 69c4c18902 updated FIXME 2005-12-14 16:46:05 +00:00
Michael Kerrisk a28ed21cec Put flags list in alphabetcal order 2005-12-14 16:41:14 +00:00
Michael Kerrisk 145ff0249e Added cross-reference from discussion of MSG_MORE to UDP_CORK in udp(7). 2005-12-14 16:30:49 +00:00
Michael Kerrisk a749f870a8 s/XXX/FIXME/ 2005-10-26 11:27:52 +00:00
Michael Kerrisk e1d6264d9f Manual fixes for parentheses formatting 2005-10-19 07:29:28 +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 cca657e227 triggered by http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=283179
The wording describing how errno is set was tidied up in a number of
pages.
2004-12-20 12:24:06 +00:00
Michael Kerrisk d3018c3c5e "from a socket" --> "on a socket" 2004-12-20 10:53:41 +00:00