Module Name: src Committed By: wiz Date: Fri Jun 22 22:49:03 UTC 2012
Modified Files: src/lib/libc/sys: send.2 Log Message: Remove trailing whitespace. Sort errors. Bump date for previous. To generate a diff of this commit: cvs rdiff -u -r1.28 -r1.29 src/lib/libc/sys/send.2 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.
Modified files: Index: src/lib/libc/sys/send.2 diff -u src/lib/libc/sys/send.2:1.28 src/lib/libc/sys/send.2:1.29 --- src/lib/libc/sys/send.2:1.28 Fri Jun 22 18:28:38 2012 +++ src/lib/libc/sys/send.2 Fri Jun 22 22:49:03 2012 @@ -1,4 +1,4 @@ -.\" $NetBSD: send.2,v 1.28 2012/06/22 18:28:38 christos Exp $ +.\" $NetBSD: send.2,v 1.29 2012/06/22 22:49:03 wiz Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -29,7 +29,7 @@ .\" .\" @(#)send.2 8.2 (Berkeley) 2/21/94 .\" -.Dd June 7, 2012 +.Dd June 22, 2012 .Dt SEND 2 .Os .Sh NAME @@ -73,7 +73,7 @@ call be used to send multiple messages i .Fa mmsghdr elements with the following form, as defined in .Ao Pa sys/socket.h Ac : -.Pp +.Pp .Bd -literal struct mmsghdr { struct msghdr msg_hdr; /* the message to be sent */ @@ -81,7 +81,7 @@ struct mmsghdr { }; .Ed .Pp -The +The .Fa msg_len member contains the number of bytes sent for each .Fa msg_hdr @@ -177,7 +177,7 @@ is used to prevent generation when writing a socket that may be closed. .Sh RETURN VALUES -The +The .Fn send , .Fn sendto , and @@ -196,44 +196,44 @@ and .Fn sendmmsg fail if: .Bl -tag -width Er +.It Bq Er EACCES +The SO_BROADCAST option is not set on the socket, and a broadcast address +was given as the destination. +.It Bq Er EAFNOSUPPORT +Addresses in the specified address family cannot be used with this socket. +.It Bq Er EAGAIN|EWOULDBLOCK +The socket is marked non-blocking and the requested operation +would block. .It Bq Er EBADF An invalid descriptor was specified. -.It Bq Er ENOTSOCK -The argument -.Fa s -is not a socket. +.It Bq Er EDSTADDRREQ +In a non-connected socket a destination address has not been specified. .It Bq Er EFAULT An invalid user space address was specified for a parameter. +.It Bq Er EHOSTDOWN +The destination is a host on the local subnet and does not respond to +.Xr arp 4 . +.It Bq Er EHOSTUNREACH +The destination for the message is unreachable. +.It Bq Er EINVAL +The total length of the I/O is more than can be expressed by the ssize_t +return value. .It Bq Er EMSGSIZE The socket requires that message be sent atomically, and the size of the message to be sent made this impossible. -.It Bq Er EPIPE -In a connected socket the connection has been broken. -.It Bq Er EDSTADDRREQ -In a non-connected socket a destination address has not been specified. -.It Bq Er EAGAIN|EWOULDBLOCK -The socket is marked non-blocking and the requested operation -would block. .It Bq Er ENOBUFS The system was unable to allocate an internal buffer. The operation may succeed when buffers become available. -.It Bq Er ENOBUFS -The output queue for a network interface was full. +.Pp +An alternative reason: the output queue for a network interface was full. This generally indicates that the interface has stopped sending, but may be caused by transient congestion. -.It Bq Er EACCES -The SO_BROADCAST option is not set on the socket, and a broadcast address -was given as the destination. -.It Bq Er EHOSTUNREACH -The destination for the message is unreachable. -.It Bq Er EHOSTDOWN -The destination is a host on the local subnet and does not respond to -.Xr arp 4 . -.It Bq Er EINVAL -The total length of the I/O is more than can be expressed by the ssize_t -return value. -.It Bq Er EAFNOSUPPORT -Addresses in the specified address family cannot be used with this socket. +.It Bq Er ENOTSOCK +The argument +.Fa s +is not a socket. +.It Bq Er EPIPE +In a connected socket the connection has been broken. .El .Pp .Fn sendto