svn commit: r195480 - projects/mesh11s/sbin/ifconfig

[Sam Leffler]

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: