From owner-svn-src-projects@FreeBSD.ORG Thu Dec 11 23:01:58 2008 Return-Path: Delivered-To: svn-src-projects@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 95CF2106564A; Thu, 11 Dec 2008 23:01:58 +0000 (UTC) (envelope-from kmacy@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 84FA78FC0C; Thu, 11 Dec 2008 23:01:58 +0000 (UTC) (envelope-from kmacy@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id mBBN1wV9079071; Thu, 11 Dec 2008 23:01:58 GMT (envelope-from kmacy@svn.freebsd.org) Received: (from kmacy@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id mBBN1w9R079070; Thu, 11 Dec 2008 23:01:58 GMT (envelope-from kmacy@svn.freebsd.org) Message-Id: <200812112301.mBBN1w9R079070@svn.freebsd.org> From: Kip Macy Date: Thu, 11 Dec 2008 23:01:58 +0000 (UTC) To: src-committers@freebsd.org, svn-src-projects@freebsd.org X-SVN-Group: projects MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r185946 - projects/arpv2_merge_1/share/man/man9 X-BeenThere: svn-src-projects@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the src " projects" tree" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Dec 2008 23:01:58 -0000 Author: kmacy Date: Thu Dec 11 23:01:58 2008 New Revision: 185946 URL: http://svn.freebsd.org/changeset/base/185946 Log: update to reflect absence of RTF_CLONING Modified: projects/arpv2_merge_1/share/man/man9/rtalloc.9 Modified: projects/arpv2_merge_1/share/man/man9/rtalloc.9 ============================================================================== --- projects/arpv2_merge_1/share/man/man9/rtalloc.9 Thu Dec 11 22:51:11 2008 (r185945) +++ projects/arpv2_merge_1/share/man/man9/rtalloc.9 Thu Dec 11 23:01:58 2008 (r185946) @@ -64,21 +64,6 @@ certain protocol\- and interface-specifi .\" XXX - -mdoc should contain a standard request for getting em and .\" en dashes. .Pp -When a route with the flag -.Dv RTF_CLONING -is retrieved, and the action of this flag is not masked, the -.Nm -facility automatically generates a new route using information in the -old route as a template, and -sends an -.Dv RTM_RESOLVE -message to the appropriate interface-address route-management routine -.Pq Fn ifa->ifa_rtrequest . -This generated route is called -.Em cloned , -and has -.Dv RTF_WASCLONED -flag set. .Dv RTF_PRCLONING flag is obsolete and thus ignored by facility. If the @@ -123,22 +108,19 @@ field. .Pp The .Fn rtalloc_ign -interface can be used when the default actions of -.Fn rtalloc -in the presence of the -.Dv RTF_CLONING -flag is undesired. +interface can be used when the caller does not want to receive +the returned +.Fa rtentry +locked. The .Fa ro argument is the same as .Fn rtalloc , but there is additionally a .Fa flags -argument, which lists the flags in the route which are to be -.Em ignored -(in most cases this is -.Dv RTF_CLONING -flag). +argument, which is now only used to pass +.Dv RTF_RNH_LOCKED +indicating that the radix tree lock is already held. Both .Fn rtalloc and @@ -163,16 +145,7 @@ directly as the 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 -in the processing of those lower layers which use the cloning -facility. +controls whether the lower layers are notifed when a lookup fails. The third argument, .Fa flags , is a set of flags to ignore, as in