Configuration file for ramond(8)
This manual page documents briefly the ramond.conf configuration file.
ramond.conf is an XML file containing the rules for Router Advertisement processing by ramond(8).
The rules are processed in the order they are defined in the file.
One may refer to the DTD given in /usr/share/doc/ramond/examples/ramond.conf.dtd.
The root element, <ramond>, contains one optional attribute, logfile, giving the path to the logfile for the daemon.
This element may contain one or more <mac-list>s, and one or more <rule>s.
The <mac-list> must have a name attribute, and contains one or more <entry>elements.
The <rule> may contain a few attributes :
An IPv6 prefix used for matching RA packets
A <mac-list> name used for matching source MAC addresses of the RA packets
This attribute, when having a “0” value, is used for matching routes that are being cleared
The interface which the RA packet came from
The <rule> may contain :
• one or more <execute> elements containing the path of the scripts to run when a packet is matched
• a <clear/> element, so that the matched route will be cleared by ramond(8)
• or no element, indicating an “ignore” rule.
The environment variables the configured scripts are run with are listed in the ramond(8) manpage.
Set the logfile to be /var/log/ramond.log.
Define a router mac-list.
Define a rule checking if the router routes are being cleared.
<rule mac="router" lifetime="0">
Define a rule ignoring our router announcing routes for prefix 2001:dead:cafe:babe::/52.
<rule mac="router" prefix="2001:dead:cafe:babe::/52">
<!-- do nothing -->
Clear the 6to4 routes coming on interface eth0.
<rule prefix="2002::/16" interface="eth0">
Match on all advertised prefixes
Match on all RA packets (even those not advertising a prefix)
ramond(8), /usr/share/doc/ramond/examples for a sample ramond.conf and a sample processing script
Copyright © 2010 Nicolas Dandrimont
This manual page was written for the Debian system (and may be used by others).
Permission is granted to copy, distribute and/or modify this document under the terms of the usual 3-clause BSD license.
On Debian systems, the complete text of the 3-clause BSD license License can be found in /usr/share/doc/ramond/copyright.