From owner-svn-src-projects@FreeBSD.ORG Wed Jul 8 23:41:11 2009 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 6711C106566B; Wed, 8 Jul 2009 23:41:11 +0000 (UTC) (envelope-from sam@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 551498FC16; Wed, 8 Jul 2009 23:41:11 +0000 (UTC) (envelope-from sam@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 n68NfB7p065579; Wed, 8 Jul 2009 23:41:11 GMT (envelope-from sam@svn.freebsd.org) Received: (from sam@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id n68NfBYR065577; Wed, 8 Jul 2009 23:41:11 GMT (envelope-from sam@svn.freebsd.org) Message-Id: <200907082341.n68NfBYR065577@svn.freebsd.org> From: Sam Leffler Date: Wed, 8 Jul 2009 23:41:11 +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: r195480 - projects/mesh11s/sbin/ifconfig 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: Wed, 08 Jul 2009 23:41:11 -0000 Author: sam Date: Wed Jul 8 23:41:11 2009 New Revision: 195480 URL: http://svn.freebsd.org/changeset/base/195480 Log: minor re-wording and consistency Modified: projects/mesh11s/sbin/ifconfig/ifconfig.8 Modified: projects/mesh11s/sbin/ifconfig/ifconfig.8 ============================================================================== --- projects/mesh11s/sbin/ifconfig/ifconfig.8 Wed Jul 8 23:09:04 2009 (r195479) +++ projects/mesh11s/sbin/ifconfig/ifconfig.8 Wed Jul 8 23:41:11 2009 (r195480) @@ -1282,7 +1282,8 @@ When operating as an access point displa currently associated. When operating in ad-hoc mode display stations identified as neighbors in the IBSS. -When operating in mesh mode display the neighbor mesh stations. +When operating in mesh mode display stations identified as +neighbors in the MBSS. When operating in station mode display the access point. Capabilities advertised by the stations are described under the @@ -1824,12 +1825,26 @@ mode: .It Cm meshid Ar meshid Set the desired Mesh Identifier. The Mesh ID is a string up to 32 characters in length. +A mesh interface must have a Mesh Identifier specified +to reach an operational state. .It Cm meshttl Ar ttl -Set the desired time to live for mesh forwarded packets. +Set the desired ``time to live'' for mesh forwarded packets; +this is the number of hops a packet may be forwarded before +it is discarded. +The default setting for +.Cm meshttl +is 31. .It Cm meshpeering Enable or disable peering with neighbor mesh stations. +Stations must peer before any data packets can be exchanged. +By default +.Cm meshpeering +is enabled. .It Cm meshforward Enable or disable forwarding packets by a mesh interface. +By default +.Cm meshforward +is enabled. .It Cm meshmetric Ar protocol Set the specified .Ar protocol @@ -1841,39 +1856,46 @@ The mesh interface will restart after ch Set the specified .Ar protocol as the path selection protocol used on a mesh network. -The default protocol is called +The only available protocol at the moment is called .Ar HWMP (Hybrid Wireless Mesh Protocol). The mesh interface will restart after changing this setting. .It Cm hwmprootmode Ar mode -Stations on a mesh network can operate as root nodes. +Stations on a mesh network can operate as ``root nodes.'' Root nodes try to find paths to all mesh nodes and advertise themselves regularly. When there is a root mesh node on a network, other mesh nodes can setup -paths between themselves faster because they will use the root node -to reach the destination. This path may not be the best, but on-demand +paths between themselves faster because they can use the root node +to find the destination. +This path may not be the best, but on-demand routing will eventually find the best path. The following modes are recognized: .Pp .Bl -tag -width ".Cm PROACTIVE" -compact .It Cm DISABLED -root mode disabled. +Disable root mode. .It Cm NORMAL -sends broadcast path requests every two seconds. +Send broadcast path requests every two seconds. Nodes on the mesh without a path to this root mesh station with try to discover a path to us. .It Cm PROACTIVE -sends broadcast path requests every two seconds and every node must reply with +Send broadcast path requests every two seconds and every node must reply with with a path reply even if it already has a path to this root mesh station, .It Cm RANN -sends broadcast root annoucement (RANN) frames. +Send broadcast root annoucement (RANN) frames. Nodes on the mesh without a path to this root mesh station with try to discover a path to us. .El +By default +.Cm hwmprootmode +is set to +.Ar DISABLED . .It Cm hwmpmaxhops Ar cnt -Use the specified -.Ar cnt -as the maximum number of hops allowed in an HWMP path. +Set the maximum number of hops allowed in an HMWP path to +.Ar cnt . +The default setting for +.Cm hwmpmaxhops +is 31. .El .Pp The following parameters are for compatibility with other systems: