ramond.conf(5)

🌸 ramond.conf — the config file glow-up 💖

okay bestie, welcome to ramond.conf(5), aka the File Formats Manual girlie of section 5. this is the page that explains the config file for ramond(8), and honestly? it's giving structured. it's giving XML. let's get into it 🎀

---

✨ NAME ✨

ramond.conf — the configuration file for ramond(8) 🫶

---

💫 DESCRIPTION 💫

so this page is the lil brief on the ramond.conf config file. no cap.

ramond.conf is an XML file holding the rules for Router Advertisement processing by ramond(8). 🌈

and here's the thing you gotta internalize: the rules are processed in the order they are defined in the file. order matters, periodt. 💅

---

🦋 SYNTAX 🦋

you can refer to the DTD given in /usr/share/doc/ramond/examples/ramond.conf.dtd. it's right there, bestie, go look 👀

the root element, <ramond>, contains one optional attribute, logfile, which gives 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. (yes, must. the attribute is not optional, don't try it 🙈)

the <rule> may contain a few attributes:

• prefix — an IPv6 prefix used for matching RA packets 🌸
• mac — a <mac-list> name used for matching source MAC addresses of the RA packets 💜
• lifetime — this attribute, when having a "0" value, is used for matching routes that are being cleared 🧹
• interface — the interface which the RA packet came from 🔥

and 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 at all, indicating an “ignore” rule. 💀

---

🌿 ENVIRONMENT 🌿

the environment variables the configured scripts are run with are listed in the ramond(8) manpage. go check her, she's got the deets 💖

---

👑 EXAMPLE CONFIGURATION FILE 👑

okay this is the part where we actually do it. main character energy only ✨

set the logfile to be /var/log/ramond.log.

<ramond logfile="/var/log/ramond.log">

define a router mac-list.

<mac-list name="router">
  <entry>00:11:22:33:44:55</entry>
  <entry>00:22:44:66:88:00</entry>
</mac-list>

define a rule checking if the router routes are being cleared.

<rule mac="router" lifetime="0">
  <execute>/usr/local/sbin/routenotify route-cleared</execute>
</rule>

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 -->
</rule>

clear the 6to4 routes coming on interface eth0.

<rule prefix="2002::/16" interface="eth0">
  <execute>/usr/local/sbin/routenotify 6to4-advertised</execute>
  <clear/>
</rule>

match on all advertised prefixes

<rule prefix="::/0">
  <execute>/usr/local/sbin/routenotify route-advertised</execute>
</rule>

match on all RA packets (even those not advertising a prefix)

<rule>
  <execute>/usr/local/sbin/routenotify route-advertised</execute>
</rule>
</ramond>

slay. that's a whole config file and you understood it 💅

---

🌈 SEE ALSO 🌈

• ramond(8)
• /usr/share/doc/ramond/examples — for a sample ramond.conf and a sample processing script 📂

---

💖 AUTHORS 💖

• James Morse <morse_@users.sourceforge.net> — wrote the ramond software 👑
• Nicolas Dandrimont <nicolas.dandrimont@crans.org> — wrote this manpage for the Debian system 🫶

---

🎀 COPYRIGHT 🎀

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. 📄

---

okay that's the whole page bestie, no skips, no skims, every last detail intact. iykyk 💅✨

and that's a wrap on ramond.conf(5) from the File Formats Manual, section 5 🦋 thanks for reading, ily, go configure something 🌸💖🎀