mmborder(8)
NAME
mmborder - Mobile Mesh Border Discovery
SYNOPSIS
mmborder -a addr [-d file] [-f file] [-h] -i ifname [-vz]
DESCRIPTION
- mmborder speaks the Mobile Mesh Border Discovery Protocol.
- The goal of a border router is to take advantage of "collateral
- flow" that occurs "external" to a Mobile Mesh Routing Protocol
- cloud. This is accomplished by border routers tunneling packets
- between peer border routers. A tunnel is needed between each pair
- of members. The IP addresses on the ends of the tunnels do not
- need to be globally unique across the Internet, they only need to
- be unique within the Mobile Mesh Routing Protocol cloud. This en
- ables us to use the private IP addresses of 10.X.X.X and
- 192.168.X.X for the tunnels.
- Tunnels are set up automatically by mmborder when it dis
- covers a peer border router. The discovery process requires each
- border router to periodically send a BorderAdvertisement message
- to a multicast group address. When a border hears from a new
- peer, it sets up a point to point tunnel with it. When a border
- has not heard from a peer within a deadInterval , it assumes the
- peer has departed and tears down the tunnel.
- Under Linux, each tunnel results in a unique IP interface.
- When a tunnel is created, mmborder dynamically adds the corre
- sponding IP interface to the mobile mesh router mmrp. Similary,
- when the tunnel is destroyed, mmborder dynamically removes the IP
- interface from the mobile mesh router.
OPTIONS
mmborder recognizes the following command line switches:
- -a addr
- The dotted decimal unique private IP address for
- tunnel interfaces. A separate point to point tunnel interface is
- set up to each discovered peer border router. Each of these tun
- nels shares this address.
- -d file
- Use flags 'file' to enable debug output.
- -f file
- Use config 'file' instead of
- /etc/mobilemesh/mmborder.conf. See below for a description of
- the config file format.
- -g file
- When launching mmdiscover on a newly created tunnel
- interface, use config 'file' instead of default
- /etc/mobilemesh/mmdiscover-border.conf. See manpage for
- mmdiscover for a description of the config file format.
- -h Display a help message.
- -i ifname
- The name of the fixed network interface that dis
- covery of other border routers will take place on.
- -v Display version information.
- -z Run in the foreground instead of running as a dae
- mon.
Config File Format
- By default, mmborder reads the file
- /etc/mobilemesh/mmborder.conf for configuration parameters. The
- format of the config file requires each configuration parameter
- to be on its own line. Comments may be placed in the file by be
- ginning a line with a #. The following configuration parameters
- are recognized:
- groupAddr <Multicast Group Address>
- the IP multicast group address which all border
- routers use to send and receive BorderAdvertisement messages.
- port <Udp Port Number>
- the UDP port number to which all BorderAdvertisment
- messages are sent.
- mmrpPort <Udp Port Number>
- the UDP port number used by mmrp. This allows mul
- tiple copies of mmrp to execute simultaneously and mmborder to
- connect to the appropriate one.
- adPeriod <unsigned int value>
- the number of seconds between sending our BorderAd
- vertisement message.
- deadInterval <unsigned int value>
- the number of seconds after hearing the last Bor
- derAdvertisement from a peer to declare the peer down and tear
- down any tunnels that went to it.
SEE ALSO
mmdiscover(8), mmrp(8), mmrpviz(8)
AUTHOR
- This program and documentation was written by Kevin H.
- Grace of The MITRE Corporation <kgrace@mitre.org>. Credit is also
- given to Mike Butler who developed some of the support classes
- and lent his keen insight.
July 19, 2000