From owner-man-jp-reviewer@jp.FreeBSD.org Sat May  7 02:50:29 2005
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id j46HoT573631;
	Sat, 7 May 2005 02:50:29 +0900 (JST)
	(envelope-from owner-man-jp-reviewer@jp.FreeBSD.org)
Received: from t-mta1.odn.ne.jp (mfep1.odn.ne.jp [143.90.131.179])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id j46HoTX73626
	for <man-jp-reviewer@jp.FreeBSD.org>; Sat, 7 May 2005 02:50:29 +0900 (JST)
	(envelope-from n-kogane@syd.odn.ne.jp)
Received: from kces6.koganemaru.co.jp ([220.212.168.108])
          by t-mta1.odn.ne.jp with ESMTP
          id <20050506175028630.ITNA.8089.t-mta1.odn.ne.jp@mta1.odn.ne.jp>
          for <man-jp-reviewer@jp.FreeBSD.org>;
          Sat, 7 May 2005 02:50:28 +0900
Received: by kces6.koganemaru.co.jp (Postfix, from userid 100)
	id 7149FFCD8; Sat,  7 May 2005 02:50:56 +0900 (JST)
To: man-jp-reviewer@jp.FreeBSD.org
MIME-Version: 1.0 (generated by MimeKit/1.8)
Content-Type: text/plain; charset=ISO-2022-JP
Message-Id: <20050506175056.7149FFCD8@kces6.koganemaru.co.jp>
From: n-kogane@syd.odn.ne.jp (Nobuyuki Koganemaru)
Reply-To: man-jp-reviewer@jp.FreeBSD.org
Precedence: list
Date: Sat, 7 May 2005 02:50:56 +0900
X-Sequence: man-jp-reviewer 4779
Subject: [man-jp-reviewer 4779] recv.2 Update to 5.4RC4
Sender: owner-man-jp-reviewer@jp.FreeBSD.org
X-Originator: n-kogane@syd.odn.ne.jp
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+050320

$B>.6b4]$G$9!#(B

rights (file descriptors) that were in flight $B$NLu$ONI$/$o$+$j$^$;$s!#(B

$B8e$m$K1QJ8$N:9J,$bIU$1$^$9!#(B

diff -u /dskg/JMAN4/doc/ja_JP.eucJP/man/man2/recv.2 recv.2
--- /dskg/JMAN4/doc/ja_JP.eucJP/man/man2/recv.2	Wed Sep 22 05:33:15 2004
+++ recv.2	Sat May  7 02:46:54 2005
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)recv.2	8.3 (Berkeley) 2/21/94
-.\" %FreeBSD: src/lib/libc/sys/recv.2,v 1.21 2004/07/16 17:15:37 harti Exp %
+.\" %FreeBSD: src/lib/libc/sys/recv.2,v 1.21.2.2 2005/02/28 03:32:34 brueffer Exp %
 .\"
 .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/recv.2,v 1.14 2004/09/21 20:33:15 metal Exp $
 .Dd February 21, 1994
@@ -61,7 +61,7 @@
 $B<u?.$9$k$N$K;HMQ$G$-$^$9!#(B
 .Pp
 .Fa from
-$B$,(B nil $B$G$J$/!"%=%1%C%H$,@\B3;X8~$G$J$$>l9g!"(B
+$B$,(B NULL $B%]%$%s%?$G$J$/!"%=%1%C%H$,@\B3;X8~$G$J$$>l9g!"(B
 $B$3$3$K$O%a%C%;!<%8$N%=!<%9%"%I%l%9$,J]B8$5$l$^$9!#(B
 .Fa fromlen
 $B0z?t$OCM$H7k2L$N0z?t$G$"$j!"(B
@@ -76,7 +76,7 @@
 .Pf ( Xr connect 2
 $B$r;2>H(B)$B!"(B
 .Fa from
-$B0z?t$K(B nil $B$r;XDj$7$?(B
+$B0z?t$K(B NULL $B%]%$%s%?$r;XDj$7$?(B
 .Fn recvfrom
 $B$HF10l$G$9!#(B
 $B$3$l$O>iD9$J$N$G!">-Mh$N%j%j!<%9$G$O%5%]!<%H$5$l$J$$2DG=@-$,$"$j$^$9!#(B
@@ -110,13 +110,14 @@
 .Xr select 2
 $B%7%9%F%`%3!<%k$r;H$&$3$H$,$G$-$^$9!#(B
 .Pp
-recv $B4X?t$X$N(B
+.Fn recv
+$B4X?t$X$N(B
 .Fa flags
 $B0z?t$O!"<!$NCM$N(B 1 $B$D$^$?$OJ#?t$NO@M}OB(B
 .\".Em or Ap ing
 .Em ( or )
 $B$+$i@.$j$^$9(B:
-.Bl -column MSG_DONTWAIT -offset indent
+.Bl -column ".Dv MSG_DONTWAIT" -offset indent
 .It Dv MSG_OOB Ta $B%W%m%;%9BS0h30%G!<%?(B
 .It Dv MSG_PEEK Ta $BCe?.%a%C%;!<%8$NGA$-8+(B (peek)
 .It Dv MSG_WAITALL Ta $BMW5a$N40A4$J<B9T!"$^$?$O%(%i!<$rBT$D(B
@@ -128,21 +129,26 @@
 $BDL>o$N%G!<%?%9%H%j!<%`$+$i$O<u?.$7$^$;$s!#(B
 $B5^Aw%G!<%?$rDL>o$N%G!<%?BT$A9TNs$N@hF,$KG[CV$9$k%W%m%H%3%k$b$"$j$^$9$,!"(B
 $B$3$N%U%i%0$O$=$N$h$&$J%W%m%H%3%k$G$O;HMQ$G$-$^$;$s!#(B
-MSG_PEEK $B%U%i%0$O<u?.BT$A9TNs$N@hF,$+$i%G!<%?$r=|5n$9$k$3$H$J$/!"(B
+.Dv MSG_PEEK
+$B%U%i%0$O<u?.BT$A9TNs$N@hF,$+$i%G!<%?$r=|5n$9$k$3$H$J$/!"(B
 $B$=$N%G!<%?$rJV$7$^$9!#(B
 $B$7$?$,$C$F!"8eB3$N<u?.8F$S=P$7$OF1$8%G!<%?$rJV$7$^$9!#(B
-MSG_WAITALL $B%U%i%0$OMW5a$,40A4$KK~$?$5$l$k$^$G%V%m%C%/$9$k$h$&$KMW5a$7$^$9!#(B
+.Dv MSG_WAITALL
+$B%U%i%0$OMW5a$,40A4$KK~$?$5$l$k$^$G%V%m%C%/$9$k$h$&$KMW5a$7$^$9!#(B
 $B$7$+$7!"%7%0%J%k$,JaB*$5$l$?>l9g!"%(%i!<$^$?$O@ZCG$,H/@8$7$?>l9g!"(B
 $B$^$?$O<u?.$9$k<!$N%G!<%?$,JV$5$l$?%?%$%W$H0[$J$k(B
 $B>l9g!"8F$S=P$7$OMW5a$5$l$?$h$j>/$J$$%G!<%?$rJV$92DG=@-$,$"$j$^$9!#(B
-MSG_DONTWAIT $B%U%i%0$O!"%U%i%0$,;XDj$5$l$F$J$+$C$?$i%V%m%C%/$9$k$h$&$J;~$K!"(B
+.Dv MSG_DONTWAIT
+$B%U%i%0$O!"%U%i%0$,;XDj$5$l$F$J$+$C$?$i%V%m%C%/$9$k$h$&$J;~$K!"(B
 $BLa$k$3$H$rMW5a$7$^$9!#(B
 $BMxMQ2DG=$J%G!<%?$,L5$$>l9g$K$O!"(B
 .Va errno
 $B$,(B
 .Er EAGAIN
 $B$K@_Dj$5$l$^$9!#(B
-$B$3$N%U%i%0$O!"873J$J(B ANSI $B$^$?$O(B C99 $B$N%3%s%Q%$%k%b!<%I$G$OMxMQ$G$-$^$;$s!#(B
+$B$3$N%U%i%0$O!"873J$J(B
+.Tn ANSI
+$B$^$?$O(B C99 $B$N%3%s%Q%$%k%b!<%I$G$OMxMQ$G$-$^$;$s!#(B
 .Pp
 .Fn recvmsg
 $B%7%9%F%`%3!<%k$O!"D>@\$K;XDj$5$l$k0z?t$N?t$r:G>.$K$9$k$?$a$K(B
@@ -154,7 +160,7 @@
 .Pp
 .Bd -literal
 struct msghdr {
-	caddr_t	msg_name;	/* $B%"%I%l%9(B($B%*%W%7%g%s(B) */
+	caddr_t	msg_name;	/* $B%"%I%l%9(B ($B%*%W%7%g%s(B) */
 	u_int	msg_namelen;	/* $B%"%I%l%9$N%5%$%:(B */
 	struct	iovec *msg_iov;	/* $B%9%-%c%C%?(B / $B%.%c%6!<G[Ns(B */
 	u_int	msg_iovlen;	/* msg_iov $B$NMWAG?t(B */
@@ -197,7 +203,9 @@
 $B%G!<%?%9%H%j!<%`$NJQ2=$rCN$k$3$H$,$G$-$^$9!#(B
 $B$^$?!"(BISO $B$K$*$$$F(B
 .Fn accept
-$B%7%9%F%`%3!<%k$ND>8e$K!"%G!<%?%P%C%U%!$rH<$o$:$K(B recvmsg $B$rMW5a$7$F!"(B
+$B%7%9%F%`%3!<%k$ND>8e$K!"%G!<%?%P%C%U%!$rH<$o$:$K(B
+.Fn recvmsg
+$B$rMW5a$7$F!"(B
 $B%f!<%6@\B3MW5a%G!<%?$rF@$k$3$H$,$G$-$k$G$7$g$&!#(B
 .Pp
 $B%*!<%W%s%U%!%$%k5-=R;R$O$3$l$G(B
@@ -275,6 +283,17 @@
 $B0z?t(B
 .Fa s
 $B$O%=%1%C%H$r;2>H$7$F$$$^$;$s!#(B
+.It Bq Er EMSGSIZE
+.Fn recvmsg
+$B%7%9%F%`%3!<%k$O!"@\B3;~$K%G!<%?$r$d$j$H$j$9$k8"Mx(B ($B%U%!%$%k5-=R;R(B)
+$B$r<u?.$9$k$?$a$K;HMQ$5$l$^$7$?!#(B
+.\" rights (file descriptors) that were in flight $B$NLu$ONI$/$o$+$i$J$$!#(B
+$B$7$+$7$J$,$i!"<u?.%W%m%0%i%`$K$O<u$1IU$1$k$?$a$N(B
+$B6u$-%U%!%$%k5-=R;R%9%m%C%H$,$"$j$^$;$s$G$7$?!#(B
+$B$3$N>l9g!"5-=R;R$,%/%m!<%:$5$l!"(B
+.Fn recvmsg
+$B$X$NJL$N8F$S=P$7$K$h$C$F!"(B
+$B$I$s$J%Z%s%G%#%s%0(B ($BL$2r7h(B) $B$N%G!<%?$bJV$9$3$H$,$G$-$^$9!#(B
 .It Bq Er EAGAIN
 $B%=%1%C%H$,Hs%V%m%C%-%s%0$H%^!<%/$5$l$F$$$k$H$-!"(B
 $B<u?.A`:n$G%V%m%C%/$7$^$7$?!#(B
diff -u /dskg/JMAN4/5.3-RELEASE/man2/recv.2 /dskg/JMAN4/5.4-RC4/man2/recv.2
--- /dskg/JMAN4/5.3-RELEASE/man2/recv.2	Fri Nov  5 10:24:23 2004
+++ /dskg/JMAN4/5.4-RC4/man2/recv.2	Mon May  2 05:53:48 2005
@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)recv.2	8.3 (Berkeley) 2/21/94
-.\" $FreeBSD: src/lib/libc/sys/recv.2,v 1.21 2004/07/16 17:15:37 harti Exp $
+.\" $FreeBSD: src/lib/libc/sys/recv.2,v 1.21.2.2 2005/02/28 03:32:34 brueffer Exp $
 .\"
 .Dd February 21, 1994
 .Dt RECV 2
@@ -63,7 +63,8 @@
 .Pp
 If
 .Fa from
-is non-nil, and the socket is not connection-oriented,
+is not a null pointer
+and the socket is not connection-oriented,
 the source address of the message is filled in.
 The
 .Fa fromlen
@@ -82,7 +83,8 @@
 .Xr connect 2 )
 and is identical to
 .Fn recvfrom
-with a nil
+with a
+null pointer passed as its
 .Fa from
 argument.
 As it is redundant, it may not be supported in future releases.
@@ -124,11 +126,11 @@
 function is formed by
 .Em or Ap ing
 one or more of the values:
-.Bl -column MSG_DONTWAIT -offset indent
+.Bl -column ".Dv MSG_DONTWAIT" -offset indent
 .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
-.It Dv MSG_DONTWAIT Ta don't block
+.It Dv MSG_DONTWAIT Ta do not block
 .El
 .Pp
 The
@@ -137,21 +139,29 @@
 that would not be received in the normal data stream.
 Some protocols place expedited data at the head of the normal
 data queue, and thus this flag cannot be used with such protocols.
-The MSG_PEEK flag causes the receive operation to return data
+The
+.Dv MSG_PEEK
+flag causes the receive operation to return data
 from the beginning of the receive queue without removing that
 data from the queue.
 Thus, a subsequent receive call will return the same data.
-The MSG_WAITALL flag requests that the operation block until
+The
+.Dv MSG_WAITALL
+flag requests that the operation block until
 the full request is satisfied.
 However, the call may still return less data than requested
 if a signal is caught, an error or disconnect occurs,
 or the next data to be received is of a different type than that returned.
-The MSG_DONTWAIT flag requests the call to return when it would block otherwise.
-If no data is available
+The
+.Dv MSG_DONTWAIT
+flag requests the call to return when it would block otherwise.
+If no data is available,
 .Va errno
 is set to
 .Er EAGAIN .
-This flag is not available in strict ANSI or C99 compilation mode.
+This flag is not available in strict
+.Tn ANSI
+or C99 compilation mode.
 .Pp
 The
 .Fn recvmsg
@@ -207,7 +217,9 @@
 .Ed
 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
+a
+.Fn recvmsg
+with no data buffer provided immediately after an
 .Fn accept
 system call.
 .Pp
@@ -287,6 +299,17 @@
 The argument
 .Fa s
 does not refer to a socket.
+.It Bq Er EMSGSIZE
+The
+.Fn recvmsg
+system call
+was used to receive rights (file descriptors) that were in flight on the
+connection.
+However, the receiving program did not have enough free file
+descriptor slots to accept the them.
+In this case the descriptors are
+closed, any pending data can be returned by another call to
+.Fn recvmsg .
 .It Bq Er EAGAIN
 The socket is marked non-blocking, and the receive operation
 would block, or

--
($BM-(B)$B>.6b4]%3%s%T%e!<%?%(%s%8%K%"%j%s%0%5!<%S%9(B ($BJ!2,8)BgLn>k;T(B)
	$B>.6b4](B $B?.9,(B (Nobuyuki Koganemaru)
E-Mail: n-kogane@syd.odn.ne.jp
E-Mail: kogane@jp.FreeBSD.org
E-Mail: kogane@koganemaru.co.jp
URL: http://www.koganemaru.co.jp
