Module Name: src
Committed By: uwe
Date: Sun Aug 4 01:22:49 UTC 2019
Modified Files:
src/lib/libc/sys: recv.2
Log Message:
Minor markup tweaks.
To generate a diff of this commit:
cvs rdiff -u -r1.38 -r1.39 src/lib/libc/sys/recv.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/recv.2
diff -u src/lib/libc/sys/recv.2:1.38 src/lib/libc/sys/recv.2:1.39
--- src/lib/libc/sys/recv.2:1.38 Mon Mar 19 16:26:26 2018
+++ src/lib/libc/sys/recv.2 Sun Aug 4 01:22:49 2019
@@ -1,4 +1,4 @@
-.\" $NetBSD: recv.2,v 1.38 2018/03/19 16:26:26 roy Exp $
+.\" $NetBSD: recv.2,v 1.39 2019/08/04 01:22:49 uwe Exp $
.\"
.\" Copyright (c) 1983, 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -75,7 +75,7 @@ The
call can be used to receive multiple messages in the same call using an array of
.Fa mmsghdr
elements with the following form, as defined in
-.Ao Pa sys/socket.h Ac :
+.In sys/socket.h :
.Bd -literal
struct mmsghdr {
struct msghdr msg_hdr; /* the message to be sent */
@@ -173,12 +173,13 @@ The
argument to a recv call is formed by
.Em or Ap ing
one or more of the values:
-.Bl -column MSG_CMSG_CLOEXEC -offset indent
+.Bl -column ".Dv MSG_CMSG_CLOEXEC" -offset indent
.It Dv MSG_CMSG_CLOEXEC Ta set the close on exec property for passed file descriptors
.It Dv MSG_OOB Ta process out-of-band data
.It Dv MSG_PEEK Ta peek at incoming message
.It Dv MSG_WAITALL Ta wait for full request or error
.El
+.Pp
The
.Dv MSG_OOB
flag requests receipt of out-of-band data
@@ -205,7 +206,7 @@ call uses a
.Fa msghdr
structure to minimize the number of directly supplied parameters.
This structure has the following form, as defined in
-.Ao Pa sys/socket.h Ac :
+.In sys/socket.h :
.Bd -literal
struct msghdr {
void *msg_name; /* optional address */
@@ -253,7 +254,7 @@ struct cmsghdr {
As an example, one could use this to learn of changes in the data-stream
in XNS/SPP, or in ISO, to obtain user-connection-request data by requesting
a recvmsg with no data buffer provided immediately after an
-.Fn accept
+.Xr accept 2
call.
.Pp
Open file descriptors are now passed as ancillary data for
@@ -317,7 +318,8 @@ address space.
The receive was interrupted by delivery of a signal before
any data were available.
.It Bq Er EINVAL
-The total length of the I/O is more than can be expressed by the ssize_t
+The total length of the I/O is more than can be expressed by the
+.Vt ssize_t
return value.
.It Bq Er ENOBUFS
A message was not delivered because it would have overflowed the buffer.