From owner-man-jp@jp.FreeBSD.org Fri Nov  5 22:03:50 2004
Received: (from daemon@localhost)
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) id iA5D3oL83661;
	Fri, 5 Nov 2004 22:03:50 +0900 (JST)
	(envelope-from owner-man-jp@jp.FreeBSD.org)
Received: from t-mta7.odn.ne.jp (mfep7.odn.ne.jp [143.90.131.185])
	by castle.jp.FreeBSD.org (8.11.6p2+3.4W/8.11.3) with ESMTP/inet id iA5D3n883656
	for <man-jp@jp.FreeBSD.org>; Fri, 5 Nov 2004 22:03:50 +0900 (JST)
	(envelope-from n-kogane@syd.odn.ne.jp)
Received: from kces1.koganemaru.co.jp ([61.201.151.106])
          by t-mta7.odn.ne.jp with ESMTP
          id <20041105130349419.GHKK.217332.t-mta7.odn.ne.jp@mta7.odn.ne.jp>
          for <man-jp@jp.FreeBSD.org>; Fri, 5 Nov 2004 22:03:49 +0900
Received: (from kogane@localhost)
	by kces1.koganemaru.co.jp (8.8.8/3.6W) id WAA00935;
	Fri, 5 Nov 2004 22:04:19 +0900 (JST)
From: Nobuyuki Koganemaru <n-kogane@syd.odn.ne.jp>
Message-Id: <200411051304.WAA00935@kces1.koganemaru.co.jp>
X-Authentication-Warning: kces1.koganemaru.co.jp: kogane set sender to n-kogane using -f
To: man-jp@jp.FreeBSD.org
Reply-To: man-jp@jp.FreeBSD.org
Precedence: list
Date: Fri, 5 Nov 2004 22:04:19 +0900
X-Sequence: man-jp 5566
Subject: [man-jp 5566] rtalloc.9
Sender: owner-man-jp@jp.FreeBSD.org
X-Originator: n-kogane@syd.odn.ne.jp
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+041021

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

4.10-RELEASE $B$N(B rtalloc.9 $B$rK]Lu$7$?$N$G$9$,!"(B5.3-RC2 $B$H$N:9$,>/$7$"$j$^$9!#(B
4.10-RELEASE $B$N(B rtalloc.9 $B$rAw$j$^$9$N$G!"C/$+(B 5.3-RC2 $B2=$7$F$/$@$5$$!#(B
$B<!$O(B 4.10-RELEASE $B$H(B 5.3-RC2 $B$N:9J,$G$9!#(B
4.10-RELEASE $B$N(B rtalloc.9 $B$O8e$m$KIU$1$^$9!#(B

man4, perl $B4X78(B man1 $B$r=|$$$F(B 4.10-RELEASE $B$NK]Lu$O;D$j(B 5 $B8D$H$J$j$^$7$?!#(B:-)

---- $B$3$3$+$i(B ----
diff -u /dskg/JMAN4/4.10-RELEASE/man9/rtalloc.9 /dskg/JMAN4/5.3-RC2/man9/rtalloc.9
--- /dskg/JMAN4/4.10-RELEASE/man9/rtalloc.9	Wed May 26 06:28:20 2004
+++ /dskg/JMAN4/5.3-RC2/man9/rtalloc.9	Sun Oct 31 14:31:46 2004
@@ -26,7 +26,7 @@
 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $FreeBSD: src/share/man/man9/rtalloc.9,v 1.8.2.4 2001/12/17 11:30:18 ru Exp $
+.\" $FreeBSD: src/share/man/man9/rtalloc.9,v 1.15 2003/10/23 02:15:46 hmp Exp $
 .Dd October 8, 1996
 .Os
 .Dt RTALLOC 9
@@ -47,7 +47,8 @@
 .Fn rtalloc1 "struct sockaddr *sa" "int report" "u_long flags"
 .Sh DESCRIPTION
 The kernel uses a radix tree structure to manage routes for the
-networking subsystem.  The
+networking subsystem.
+The
 .Fn rtalloc
 family of routines is used by protocols to query this structure for a
 route corresponding to a particular end-node address, and to cause
@@ -85,7 +86,7 @@
 The default interface is
 .Fn rtalloc .
 Its only argument is
-.Ar ro ,
+.Fa ro ,
 a pointer to a
 .Dq Li "struct route" ,
 which is defined as follows:
@@ -101,10 +102,11 @@
 Before calling
 .Fn rtalloc
 for the first time, callers should ensure that unused bits of the
-structure are set to zero.  On subsequent calls,
+structure are set to zero.
+On subsequent calls,
 .Fn rtalloc
 returns without performing a lookup if
-.Ar ro->ro_rt
+.Fa ro->ro_rt
 is non-null and the
 .Dv RTF_UP
 flag is set in the route's
@@ -119,12 +121,13 @@
 .Dv RTF_CLONING
 and
 .Dv RTF_PRCLONING
-flags are undesired.  The
-.Ar ro
+flags are undesired.
+The
+.Fa ro
 argument is the same as
 .Fn rtalloc ,
 but there is additionally a
-.Ar flags
+.Fa flags
 argument, which lists the flags in the route which are to be
 .Em ignored
 (ordinarily, one or both of
@@ -145,20 +148,22 @@
 Instead, it takes a
 .Dq Li "struct sockaddr *"
 directly as the
-.Ar sa
-argument.  The second argument,
-.Ar report ,
+.Fa sa
+argument.
+The second argument,
+.Fa report ,
 controls whether
 .Dv RTM_RESOLVE
 requests are sent to the lower layers when an
 .Dv RTF_CLONING
 or
 .Dv RTF_PRCLONING
-route is cloned.  Ordinarily a value of one should be passed, except
+route is cloned.
+Ordinarily a value of one should be passed, except
 in the processing of those lower layers which use the cloning
 facility.
 The third argument,
-.Ar flags ,
+.Fa flags ,
 is a set of flags to ignore, as in
 .Fn rtalloc_ign .
 .Sh RETURN VALUES
@@ -166,10 +171,12 @@
 .Fn rtalloc
 and
 .Fn rtalloc_ign
-functions do not return a value.  The
+functions do not return a value.
+The
 .Fn rtalloc1
 function returns a pointer to a routing-table entry if it succeeds,
-otherwise a null pointer.  Lack of a route should in most cases be
+otherwise a null pointer.
+Lack of a route should in most cases be
 translated to the
 .Xr errno 2
 value
@@ -182,10 +189,11 @@
 .Nm
 facility first appeared in
 .Bx 4.2 ,
-although with much different internals.  The
+although with much different internals.
+The
 .Fn rtalloc_ign
 function and the
-.Ar flags
+.Fa flags
 argument to
 .Fn rtalloc1
 first appeared in
@@ -198,6 +206,6 @@
 and the
 .Fn rtalloc_ign
 function and the
-.Ar flags
+.Fa flags
 argument to
 .Fn rtalloc1 .
---- $B$3$3$^$G(B ----

begin 644 rtalloc.9.gz
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
60CX[HV_Q!Q3A@6?M_P!'5CF7=!8``#X`
`
end

--
($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
