1 This file states changes as of version 0.2.4:
2 $Id: CHANGELOG,v 1.108 2007/11/03 22:56:07 bernd67 Exp $
4 0.5.5 ---------------------------------------------------------------------
6 BUGFIX by Hannes Gredler <hannes@gredler.at> fixing not deleted tc entry.
8 PATCHES and CLEANUPS by Bernd Petrovitsch <bernd@firmix.at>
9 - Jens Nachtigall <nachtigall@web.de> suggested (and reminded) to use
10 olsrd.conf.default.lq as the default installed one.
11 It makes much more sense as - to the best of my(bernd's) knowledge - all
12 larger networks uses the LQ extensions. And new customers should better
13 be pushed in that direction.
14 - with the help of Patrick McCarty <mccartyp@gmail.com>, we got olsr to build
16 * OpenBSD'd `sed` is pretty conservative and doesn't understand 's|re|sub|'.
17 So we fall back to the old 's/re/sub/' and quote all '/' and '.' correctly
18 (which was the main reason to use '|').
19 And while I'm at it: Remove the useless $(CCACHE) from the $(CC) for
20 dependency generation and beautify (read: "$(strip)") $(CPPFLAGS).
21 * OpenBSD needs an explicit "#include <sys/types.h>" before
22 "#include <netinet/in.h>".
23 - fixed lib/secure/src/md5.h: This was broken as it had
24 "typedef unsigned long int UINT4;". "unsigned long int" is 8 bytes on x86_64.
25 We are using now the standardized types from <inttypes.h>.
26 - fixed warnings and improved lib/secure/src/md5.c:
27 * we are using memcpy() and memset() instead of the open-coded loops as
30 * added function prototypes for static functions
31 * moved static functions to the top so that their declaration is before
32 their use to allow gcc to inline if only used once.
33 It remains ugly - God knows why there are that so many useless
35 - Some minor and trivial cleanup: Added two functions to calculate the ETX
36 value from a struct tc_edge_entry and a struct link_entry, respectively.
37 And use them everywhere.
38 - added http://meshcube.org/nylon/utils/olsr-topology-view.pl into
39 lib/httpinfo/misc as suggested by Jens Nachtigall <nachtigall@web.de>
41 0.5.4 ---------------------------------------------------------------------
43 QUAGGA by Immo 'FaUl' Wehrenberg <immo.olsr@do.bundessicherheitsministerium.de>
44 - updated to svn version 33
46 BMF PLUGIN by Erik Tromp <erik_tromp@hotmail.com>
48 - updated to latest plugin interfaces changes and killed warnings (by Bernd
49 Petrovitsch <bernd@firmix.at>)
51 PATCH by Hannes Gredler <hannes@gredler.at> which rewrites the route handling.
55 - get rid of separate routing tables for HNA and per-node routes, everything is
56 now unified in an AVL routing tree (&routingtree)
58 - introduce walking macros (OLSR_FOR_ALL_RT_ENTRIES()) that hide the internal
59 structure of the RIB for making life of the plugin authors easier.
61 - get rid of different SPF implementations for LQ and non-LQ code paths. a
62 non-LQ edge is simply substituted with a cost of 1.0
64 - get rid of host masks - a new data type olsr_prefix is introduced which is
65 basically an ip address plus a prefix length.
67 do not install the metric in the kernel FIB - for the kernel its pointless
68 if the route gets installed with a metric of N or M.
70 we do not need to update the kernel FIB if we have hop count only changes
71 (for example if there is a reroute action further downstream)
73 the only things which triggers a kernel FIB route update is a next hop
74 change (a next hop is neighboring gateway router plus an interface).
76 all OLSR routes are installed with a metric of 2
78 - separate between rt_entry and rt_path - the former is a route installed in the
79 kernel with an next hop. the latter is a candidate for best path selection
80 after SPF calculation has been done. in the rt_entry we keep a pointer to the
81 best_path and also to the next hop that was installed in the kernel FIB.
83 we always keep all originator of a route, if a route originator goes away we
84 can easy recompute the best path for the route.
86 the next hop in the rt_entry gets only updated upon a successful route_add
87 call - that way we always remember what next hop to delete.
89 stray routes should be history now.
91 - tweak the linked list toolkit to operate on circular lists.
93 - get rid of malloc calls for building the kernel update list. the list node is
94 now embedded in the rt_entry.
96 - introduce three queues (add/chg/del) for kernel updates.
98 - for neighbor route dependency tracking the neighbor routes are queued first or
99 last (depending on which queue you work on)
101 - rework all the plugins which directly manipulate rt entries.
103 - rework the plugins that read from the routing table (most notably nameserver,
104 httpinfo and quagga plugin)
106 - lots of comments that explains the intentions and purpose of this code-piece.
108 non RT related stuff:
109 - use a list rather than a tree for storing the post-SPF results, which further
110 improves the raw-SPF runtime.
112 - add display of SPF runtime (masked behind #ifdef SPF_PROFILING)
114 - http://gredler.at/download/olsrd/neighbor_routes3.diff: This updates the own
115 IP address (read: the main address) after changes (e.g. on
116 `ifup wlan0; sleep 1; ifdown wlan0`) and kills the
117 olsr_fill_routing_table_with_neighbors() function.
119 And Sven-Ola Tuecke <mail2news@commando.de> fixed an instability issue on interface
120 up/down operations (see 102-olsrd-rt-refactoring-fixes.patch below) and a missing
123 PATCH by Hannes Gredler <hannes@gredler.at> which "consolidates
124 the link-state database and the spf-calculation in order
125 to calculate routes more efficiently".
128 - use the link-state (tc) database for SPF calculations rather than
129 replicating the notion of vertices and edges for a SPF run.
130 this heavily reduces malloc() calls and shrinks the total CPU
131 load of the route calculation path between 60%-80%.
134 PATCHES by Sven-Ola Tuecke <mail2news@commando.de> to be found on from
135 http://download-master.berlin.freifunk.net/sven-ola/nylon/packages/olsrd/files/
136 - 102-olsrd-rt-refactoring-fixes.patch
137 Because you changed a lot of basics: It's time to handle a general
138 flaw in the routing system. Plase take a look at chk_if_changed(). This
139 will free() any "struct interface" pointer without warning at any time.
140 This is why it's possile to SEGV olsrd with a simple "ifdown xxx".
141 The patch replaces the (maybe) invalid pointer with an index reference
142 "iif_index". You can always ask the OS for a name. Please note, that I do
143 not have a working BSD toolchain, so I've placed an #error in the IPv6
144 BSD-part where the author/porter has started to hack something funny.
146 - 110-olsrd-double-wlancard-neigh-hack.patch:
147 This is a hack for Nodes having to wifi cards with the same channel,
148 bssid, IP-Range etc. If two nodes can see each other by means of two
149 possible links (here: two wifi cards with equal config), a bug is triggered
150 with the Neigh-is-SYM detections. This small little hack prevents this.
152 - 112-olsrd-nameservice-fixemptyname.patch:
153 This is an addon to my lat/lon stuff which will prevent olsrd from
154 running (oops?) if no hostname is given and the nameservice plugin
157 - 113-olsrd-dyngwplain-pluginvers5.patch:
158 This updates the dyngwplain plugin to the new Plugin Iface
160 - 140-olsrd-arprefreshed.patch:
161 This is a new one. Opens a packet socket and listen to UDP(698), extract
162 the sender MAC and refreshes the ARP cache whith that. Should speedup
163 especially in cases, if you initially try to use a longer routing path which
164 normally triggers a "ARP-Lookup-Chain".
165 - 106-olsrd-nameserviceparams.patch:
166 This patch converts more plugins to the new interface version.
167 - 104-olsrd-policy-routing.patch
168 Reworked this one to discard GPL helper functions. Also checked IPv6 and
169 re-included the IPC hookup. The patch adds a "RtTable [number]" for
170 /etc/olsrd.conf which is simply the Linux
171 policy routing table to use. Defaults to 254 (== main).
172 This patch was modified/clenaed up by <bernd@firmix.at> to use "#if"
173 instead of "#ifdef" as it's more robust against typos.
174 - 110-olsrd-fixpacketprint.patch, 112-olsrd-nameservice-fixemptyname.patch,
175 113-olsrd-txtinfo-fixhttpget.patch, 114-olsrd-timeoutlimit.patch,
176 115-olsrd-nameserviceparamfix.patch and
177 116-olsrd-fix-pluginparam-addons.patch fixing the compilation warning
178 on 64bit and lots of other improvements.
179 - "Save the fish" patch: Avoid forwarding of packets with too low TTL. This
180 kills lots of packet forwarding storms.
181 NB: The oneliner was applied by hand by BP and formatted to look (in BPs O)
184 PATCH by Arnd Hannemann <hannemann@i4.informatik.rwth-aachen.de>
185 olsr_makefile_make_use_of_exename.patch
186 - This patch makes sure that the EXENAME variable of Makefile.inc is used
189 PATCHES by John Hay <jhay@meraka.org.za>
190 - update to new FreeBSD WLAN API
191 - do not require /bin/bash, use /bin/sh
192 - Fixed alignment so that olsrd runs on FreeBSD/arm
193 - allow more interface in an IPv6 subnet on FreeBSD
194 - use PREFIX and DESTDIR as all the other Makefile.$OS also for FreeBSD
195 - make txtinfo plugin work with IPv6
197 PATCH by Andreas Jacobs <jacobs@i4.informatik.rwth-aachen.de>
198 - fix the loss link quality calculation for "windows size % 4 != 0"
200 PATCH by Acinonyx <acinonyxs@yahoo.gr>
201 - Bug fix: include $(TOPDIR)/Makefile.inc at the begin in the Quagga plugin
203 PATCH by David Cornejo <dcornejo@gmail.com>
204 - fixed an "+=" of an uninitialized variable (detected with/by the
207 BUG reported by Aaron Kaplan <aaron@lo-res.org>
208 - BSD-xargs doesn't know "-r".
210 PATCHES and CLEANUPS by Bernd Petrovitsch <bernd@firmix.at>
211 - Made a function from the ME_TO_DOUBLE() macro (in src/mantissa.h).
212 This saves code throughout the code even on i386 and will even more
213 on architectures without floating point units and "-msoft-float".
214 - And the mathemathics in src/mantissa.h is reformulated to minimize
215 floating point operations to save CPU power - especially on embedded
217 - I rewrote the half of src/lq_packet.[ch] which deals with incoming
218 packets. This was triggered with performance output of gcc produced
219 by Sven-Ola Tuecke at CCCamp07.
220 This kills *lots* of (more than) superflous malloc()s and the same
221 number of (free()s). And it also kills some code and copying around of
223 - Make it compile without warning with flex-2.5.33 (to be found on Fedora 7
224 and Gentoo in Sep-2007) again.
226 - converted the dyn_gw plugin to plugin interface version 5 (which leaves
227 the quagga plugion as the last with the old one).
228 - paving the way to activate -Wshadow, much more to do
229 - const-ify parameters here and there
230 - use NULL for pointers (and not "0")
231 - Killed "extern" declarations in (not generated) .c files
233 - Based on a patch by Gianni Costanzi <gianni.costanzi@gmail.com> (so credits
234 and thanks have to go there):
235 added OS_CFLAG_PTHREAD Makefile variable since gcc (on Linux) requests this
238 - I added definitions to all OS-specific Makefile.$OS with the value similar
239 to the value in OS_LIB_PTHREAD (either empty or "-pthread").
240 - The variable is added to CPPFLAGS (and not CFLAGS) since CPPFLAGS is used
241 for all cpp and gcc calls (and gcc's man page indicates that it sets
242 variables for both of them).
244 0.5.3 ---------------------------------------------------------------------
247 Ignacio GarcÃa Pérez <iggarpe@terra.es> found a serious bug in the dot-draw
248 plugin and identified it's source.
251 The bmf plugin wanted to kill a not-started thread and this causes a segmentation
252 violation. This happens if the old plugin interface support is not compiled in
253 and one uses - or more asccurate: wants to use - the bmf plugin which uses that
254 ATM. Thanks to Cedric Krier <ced@ced.homedns.org> for reporting this.
257 The dependencies (*.d files) are now properly generated and used. And they also
258 dependen on the Makefile in the current directory and the Makefile.inc so that
259 changes there also lead to new compilation.
260 Remember: We support "ccache" so install it to save lot of meaningless recompiles
261 if nothing (as seen by the real C compiler, i.e. after the C preprocessor) has
265 Linux/IA64 and Linux/HPPA also need "-fPIC".
268 - olsr_switch does no longer generate warnings
269 - olsr_switch is also built with "build_all" and cleaned with "uberclean"
270 - More "const" all over the place.
271 - More "static" for local functions and variables.
272 - Killed an unnecessary "static" variable.
274 0.5.2 ---------------------------------------------------------------------
277 Sven-Ola Tuecke found a serious bug of the class "show stopper" and sent a patch.
280 Plugins handle parameters quite individually (case-sensitive vs case-insensitive,
281 different parsing functions for the same values, etc.). Plugin Interface version 5
282 now exports a table of { parameter-name, parsing-function, addr-of-storage } and
283 it's size. Common functions should be shared.
285 0.5.1 ---------------------------------------------------------------------
288 Upgrade to olsr-bmf 1.5 from Erik Tromp <erik_tromp@hotmail.com>
290 latitude/longitude support is now in the nameservice plugin done by
291 Sven-Ola Tuecke <mail2news@commando.de>
293 added the spf refactoring patch from Hannes Gredler <hannes@gredler.at> which
294 saves a noteworthy amount of CPU time. To quote him:
296 1. use of an AVL tree as a min-heap implementation
298 as a means for efficient sorting.
299 (the etx metric is used as the key in the candidate tree)
301 2. next-hop propagation
303 rather than tracking the previous node in olsr_relax()
304 i have changed that model and pre-populate all one-hop neighbors
305 with their own IP adress as 'next-hop' and pull that
306 pointer up once new paths are explored.
308 as a result no walker for counting hops and extracting next-hops
309 is required - it turns out at this is slighly more efficient
310 than the existing behaviour (even with the cache applied).
314 * moved a only locally needed hack from "union olsr_ip_addr" into the only place
315 where it is needed in hashing.c
317 0.5.0 ---------------------------------------------------------------------
319 APPLIED PATCHES FROM FREIFUNK-FIRMWARE
320 libsmake, dyngwplain, nameservices+services, tzxtinfo, quagga, quagga-routehandler,
321 optimize, fixes from Eric Tromp and Sven-Ola Tuecke, CPU-optimize, secure key, HNA-IP
324 removed hardcoded limit on the number of interfaces (at least in the Unix part)
325 made Makefile targets much more consistent
328 put Bmf-1.3 plugin into it
332 Patch from John Hay applied.
336 0.4.10 --------------------------------------------------------------------
338 OLSR NETWORK SIMULATOR
340 An application called olsr_switch(sorry for the nameclash with the win32
341 GUI) has been added. If olsrd is ran using the -hint option it can now
342 connect to olsr_switch and be part of a virtual network. This means
343 that multiple instances can be ran at the same host! The olsr_switch
344 application allows the user to define link variables on all viritual
345 links in the network, creating all possible topologies. Read more in
348 EXPERIMENTAL FISH EYE ALGORITHM
350 An experimental algorithm for TTL settings on TC messages has
351 been added. Read more in the corresponding README file.
355 olsrd now also compiles on OpenBSD systems. Thanks a lot to Holger
356 Mauermann for the patches!
360 Bruno has rewritten the make system. OS detection is now done
361 automagically and the general design is much improved.
363 IP ADDRESS VALIDATION
365 Olsrd now maintains a set of IP addresses that is considered
366 invalid. Checks against this set is done on all received
367 OLSR packets announced originator addresses. The dataset can
368 be updated dynamically.
372 Updated interface version to 3 and added more noticeable warning
373 for version missmatch.
377 The dependency on the math lib came from the use of pow(3) in the
378 mantissa/exponent calculation. The calls to pow in this long forgotten
379 code, was very unnessecarry. The pow calls are replaced with bitwise
380 shifts and -lm is no longer needed.
382 ICMP REDIRECTS ON LINUX
384 On Linux systems "0" is now also written to the all/send_redirects
385 procfile and not only the pr. interface ones. Hopefully this resolves
386 problems reported with systems still sending ICMP redirects.
390 - Fixed init of IPv6 addrtype variable. It used to be uninitialized,
391 causing it to default to site-local and have some weird side-effects.
392 - Fixed crash when changing IPv6 address at run-time
393 - Fixed a bug that prevented setting willingness 0 in the configfile
394 - Fixed bad handling of missing command line arguments
395 - Did various updates to prevent assertion when a neighbor
396 has changed IP and sends HELLO before its olsrd precess has detected
398 - Fixed return value check on times(2) calls in the scheduler
399 - Fixed bug(s) that could cause crash when an interface was brought
400 down while olsrd was running.
401 - Removed the silent (read: unchecked) hard limit of 16 interfaces.
402 - Compiles now cleanly on 64bit (e.g. x86_64).
404 0.4.9 ---------------------------------------------------------------------
408 The MID database is now also indexed by alias addresses. this makes
409 look-ups of main addresses based on alias addresses _much_ faster.
410 The mid_lookup_main_addr function alone has gone from >30% of the
411 total CPU time used by olsrd to <1%.
412 PLUGIN DEVELOPERS: datatypes for MID entries has been changed.
414 Routing table calculation in the LQ case now uses balanced binary
415 trees instead of linked lists, which makes look-ups much faster.
417 The debug output function olsr_printf() is not used by olsrd
418 internals any more. Instead the macro OLSR_PRINTF is to be used.
419 This macro does debug level testing _before_ doing any function
420 calls(both printf itself and parameters to printf). This is a much
421 more optimized way of doing debug output. In addition olsrd can
422 be built without any debug output code if doing 'make NODEBUG=1'.
426 Validity times for dataset entries are now set using the clock_t type
427 (used to be struct timeval). This data is now fetched from the times(2)
428 function instead of gettimeofday(2). This prevents possible problems
429 if the system time is changed.
430 PLUGIN DEVELOPERS: Note that datatypes for close to all dataset entries
431 (link, neighbor, mid, hna, tc etc.) has been changed!!
435 Multiple interfaces can now use the same interface configuration block.
437 Interface "if0" "if1" "if2"
442 Interface configurations now also support the "Weight" directive. When
443 olsrd finds multiple links to a neighbor it will choose the link
444 going via the interface with the lowest weight. Olsrd normally
445 sets this weight dynamically based on interface characteristics,
446 but if the user wishes to set a fixed weight in a interface(or
447 a group of interfaces), this directive is now available.
449 Moreover, interface configurations now support the "LinkQualityMult"
450 directive. It takes an IP address and a multiplier as arguments.
458 LinkQualityMult 192.168.0.1 0.7
459 LinkQualityMult default 0.5
464 The idea is to make certain links via the configured interface
465 artificially worse or better than they really are. The first parameter
466 specifies the IP address of a neighbour interface. The second
467 parameter is the multiplier to be applied to the link to the specified
470 After we have derived the link quality from the packet loss among the
471 packets received from the specified neighbour interface, we multiply
472 the link quality by the given multiplier. So, the multiplier changes
473 the LQ value that we use when determining the ETX, which is 1 / (LQ *
476 If "default" is given as the IP address then the multiplier applies to
477 all links via the configured interface. Note, however, that olsrd only
478 assigns one multiplier to each link. It does so in the following way.
480 * If there is a "LinkQualityMult" line that matches the IP address of
481 the link's neighbour interface, then use the multiplier in this
484 * If there isn't any matching line, then look for a "default" line. If
485 there is a "default" line, then use the multiplier in this "default"
488 * Otherwise use 1.0, i.e. do not modify the LQ value at all.
490 Hence, a line with an IP address has priority over a "default" line.
492 In the above example, the LQ value of the link between the local
493 interface if0 and the neighbour interface 192.168.0.1 would be
494 multiplied by 0.7. All other links between the local interface if0 and
495 a neighbour interface would be multiplied by 0.5.
499 The socket option IPV6_V6ONLY is now set on IPv6 sockets in linux.
500 This means that olsrd will no longer receive IPv4 traffic when
501 running in IPv6 mode.
502 This should enable users to actually run one olsrd instance using
503 IPv6 and one using IPv4 at the same time :)
507 The httpinfo, dyn_gw and dot_draw plugins now all include olsrd
508 headerfiles directly. A plugin should define OLSR_PLUGIN before
509 including olsrd headers. Doing things this way removed the
510 redundant datatype definitions that has so often caused trouble
511 when things has been updated in olsrd.
515 olsrd now also compiles on NetBSD systems. Use 'make OS=nbsd' to
516 build. This port is not very well tested and feedback is greatly
519 EXPERIMENTAL MULTI-INTERFACE CODE FOR FREEBSD
521 Experimental code using libnet can be compiled in allowing multiple
522 interfaces to be used in FreeBSD. You enable this by compiling using
523 OS=fbsd-ll. You must have libnet-devel installed for this to work
524 (/usr/ports/net/libnet-devel).
528 - WLAN devices are now detected in FreeBSD
529 - First specified interfaces IP is used as main address.
530 - Broadcastflag is not checked on interface if fixed broadcast is
532 - Removed Linux link layer code as this was not really in use.
533 - Added -nofork command line option
537 - Link sensing now works according to announced vtime from
538 neighbors. Previously links going symmetric->asymmetric
539 were not necessarily detected until the holding time expired.
540 - A bug in route addition/removal that could lead to routes
541 using GWs being added before the actual route to the GW
542 was set up, has been fixed.
543 - A bug in the interface selection in route calculation has been
544 fixed. New routes are no longer added prior to deleting old ones,
545 since this caused trouble.
546 - A bug in the IPv6 multicast address configuration has been fixed.
547 This caused olsrd not to work with global IPv6 addresses.
548 - A bug in the IPv6 prefix-from IPaddr function has been fixed. This
549 bug caused HNA prefixes to always be calculated to 0.
550 - If a 2-hop neighbor is also a 1-hop neighbor, a bug made olsrd
551 prefer a bad direct link to a better link via an MPR.
552 - If a link or interface lookup failed, olsrd crashed.
553 - Fixed a crash in the LQ packet generation code based on a
554 signed/unsigned integer comparison.
557 0.4.8 ---------------------------------------------------------------------
561 Olsrd is now distributed under a BSD style license. We believe olsrd will
562 be better off using this license as it opens up for commercial players
563 to use olsrd freely in their products. In the end this will lead to
564 this kind of users doing serious testing and bug fixing of olsrd.
566 ETX-LIKE LINK QUALITY DETECTION
568 We can now determine the packet loss on a link by looking at the serial
569 numbers of the OLSR messages received from a neighbor. This tells us how
570 many packets get through from our neighbor to us. We use a new extended
571 kind of HELLO messages (LQ_HELLO messages, LQ = link quality) to broadcast
572 the link quality that we have determined on our end of the link to our
573 neighbors. So do our neighbors, and we as well as they end up with an
574 idea of how good the link is in both directions. From the LQ_HELLOs we
575 also learn the link quality between our neighbors and our two-hop neigh-
576 bors. In this way we can select those neighbors as MPRs that have the
577 best links to our two-hop neighbors. To distribute the link quality
578 throughout the network, we use a new extended version of TC messages
579 (LQ_TC messages). They contain the qualities at both ends of each of our
580 links. Nodes can then run Dijkstra's algorithm to find a path between
581 themselves and other nodes that minimizes the packet loss.
583 If the newly introduced "LinkQualityLevel" is set to zero in the
584 configuration file, link quality is not used and the daemon behaves as
585 before, i.e. as specified by the OLSR RFC. If this parameter is set
586 to 1, LQ_HELLOs and LQ_TCs are used instead of HELLOs and TCs, link
587 quality is measured and MPRs are selected based on the link qualities.
588 If this parameter is set to 2, the routing table is additionally
589 calculated based on the link qualities.
591 Setting "LinkQualityLevel" to a non-zero value BREAKS COMPATIBILITY. You
592 will then not be able to participate in RFC-conformant OLSR networks
593 any longer. This is because we use LQ_HELLOs and LQ_TCs instead of HELLOs
594 and TCs in this case.
596 It's best practice to set "LinkQualityLevel" to the same value on all
599 When determining the quality of a link olsrd only considers a given
600 number of most recent OLSR packets received from its neighbors. By
601 default, olsrd looks at the 10 most recent OLSR packets. This can be
602 changed via the "LinkQualityWinSize" configuration option. Values
603 between 3 and 128 are legal.
605 NEW CONFIGFILE PARSER/FORMAT/SCHEME
607 A whole new config file syntax and parser is introduced with this
608 release. The parser is generated using flex and bison and it is
609 designed to be very modular. The parser can be compiled as either
610 a standalone binary, a shared library or as part of olsrd. This way
611 other applications can parse and generate olsrd configuration files
612 only by linking to the dynamic library.
613 In the new configfile options can be set pr. interface, plugin
614 parameters can be set, more IPC options can be set...and more.
615 The syntax is documented in the olsrd.conf(5) manual page found
616 in the files/ directory.
617 Olsrd internals now uses a single struct, as returned by the config
618 parser, for all configuration in runtime. this means that updating
619 values in this struct will dynamically update olsrd operation. It
620 also means that all configuration is now kept in one place instead
621 of spread all across the place.
623 FREEBSD AND MAC OSX PORT
625 This version offers an initial port of olsrd to FreeBSD and Mac OS
626 X. Like the Windows port it currently does not support IPv6. As this
627 is a very first try at supporting FreeBSD and Mac OS X, this port is
628 probably not as reliable as the Linux version. We'd greatly appreciate
629 feedback and bug reports. To compile you need GNU make. Then simply
630 run "gmake OS=fbsd" to build the executable.
634 The makefiles used to build olsrd have been rewritten and now includes
635 dependency file generation using makedep.
639 Tables are now only printed if changes occur, so there are no longer
640 any periodical output when using a debuglevel >0. A "heartbeat" is
641 now printed to STDOUT(if it is a terminal) in the form of a rotating
642 line to show that olsrd is actually operating.
643 Adding "ClearScreen yes" to the configuration file clears the screen
644 each time before the debug output shows updated information. This
645 makes the debug output easier to read in many cases. "ClearScreen no"
646 is the default, if no "ClearScreen" directive is given in the
651 There are some changes in the plugin interface. It is now at
652 version 2. Plugin specific parameters from the configfile
653 using the PlParam option, will now be passed on to plugins.
654 To receive such parameters a plugin must implement a function:
656 register_olsr_param(char *key, char *value)
657 to which parameter pairs will be passed.
661 Olsrd no longer uses any thread library on its operation. Everything
662 now happens in the main thread allowing for use of olsrd on platforms
663 with no thread library.
665 ACPI SUPPORT IN WILLINGNESS CALCULATION(LINUX)
667 The willingness calculation for Linux, now also supports the more
668 modern ACPI proc interface in addition to APM. This is not well
669 tested and feedback is appreciated!
673 Various options regarding IPC connections can now be set in the
674 configfile. The options are max connections, allowed unicast
675 hosts and allowed net-ranges.
679 Much of the message generation and net output code is rewritten.
680 Sending of partial messages should now work 100%. Also TC, MID
681 and HNA messages are now cached for a random amount of time
682 before transmitted - this often leads to the situation where these
683 messages are sent together with an HELLO message, which is highly
684 desirable since it saves network resources.
685 PLUGIN DEVELOPERS must note that the buffers and size variables
686 used in net output is no longer directly accessible!
688 NET OUTPUT CODE REWRITTEN
690 Every interface now has one outputbuffer registered. This allows
691 messages to be "cached" as explained above, so that multiple
692 messages are stacked together.
693 Also the outputbuffer and size are no longer accessible directly,
694 an API is available to plugins(and olsr code).
696 OS DEPENDENT NETWORK INTERFACE
698 The OS dependent network functions are now defined in net_os.h
699 instead of being mixed up with internal network functions
704 A bug that caused the announced ANSN sequence number to never stop
705 being increased when a change in the MPR selector set was detected
706 has been fixed. Another TC related bug that caused timed out TC
707 entries not to be deleted from the routing table in certain cases
708 has also been fixed. These bugs could cause unstable routes.
709 A bug that in many cases caused the wrong routes to be deleted
710 when using IPv6 has been fixed.
713 0.4.7 ---------------------------------------------------------------------
715 NATIVE WINDOWS GUI AND INSTALLER
717 We now have a native Windows GUI. The GTK+ version is no longer
718 supported on Windows. The new native GUI is pretty compact as it does
719 not require the GTK+ runtime DLLs. In addition to monitoring olsrds
720 state the GUI offers an easy way for novice users to configure
721 olsrd. It's pretty self-explanatory. Have a look at README-WIN32.txt
722 for details. The Windows version now also comes with an installer
723 based on the freely available Nullsoft Scriptable Install System
724 (NSIS). Looks like the Windows port is becoming more and more
727 WIRELESS INTERFACE DETECTION ON WINDOWS
729 Like the Linux version the Windows port is now able to tell WLAN
730 interfaces from wired interfaces. We can now, for example, set
731 different HELLO intervals for WLAN interfaces and wired interfaces,
736 The order of updates of calculated routes is swapped. Now new routes
737 are added prior to deleting old ones. This could fix issues where
738 in some very very few cases one could experiment loss of routes.
742 There were quite some bugs in IPv6 operation in 0.4.6. These are
743 the bugs that were fixed:
744 - HNA message parsing did not work.
745 - Some IPv6 addresses were printed as IPv4 addresses in the
747 - The '-dispin' option now works again.
748 - A filedescriptor leak in the IPv6 interface detection caused
752 0.4.6 ---------------------------------------------------------------------
756 Read the README-WIN32.txt file!
758 DYNAMIC NETWORK INTERFACE UPDATES
760 Network interfaces can now be updated and removed/added at
761 runtime. Olsrd will check all interfaces specified in the config
762 file or on the command-line, every 5 seconds. If updates
763 occur, olsrd will register this and update the necessary data.
764 If interfaces are removed or added, olsrd will detect this
765 and configure the interfaces. If an interface is removed
766 olsrd will continue to check the interface, so if say, a PCMCIA
767 card is removed and later on reinserted(and given the same name),
768 olsrd will detect this and start running on it again.
770 Note that olsrd will now run even if no interfaces are detected.
772 ROUTE CALCULATION UPDATE
774 All 1 hop neighbor addresses that are not directly reachable trough
775 a symmetric link in the link set will now be added with a GW in the
776 routing table. this GW will be an interface address from a registered
777 symmetric link to the neighbor.
781 Alias addresses are now registered in the link set processing
782 if available. This is not to pretty(since the vtime has to
783 be a mere guess) but it gives faster initial route updates.
784 If a HELLO is received(at initial registration) from an IP
785 that is not the same as the one set as main address in the
786 received HELLO header, then the IP from which the HELLO was
787 received will be registered as an alias of the main address
788 set in the HELLO header. The default vtime is set to 15 secs.
792 All OS dependent interface configuration code is now located in
793 OS/ifnet.c(that would be linux/ifnet.c if using GNU/Linux).
794 The functions are available trough the headerfile src/ifnet.h
798 - Some timer issues fixed
799 - Got rid of the global socket descriptors
800 - Updated indexing of network interfaces
801 - Introduced a global socket to use for ioctl calls(ioctl_s)
802 - Removed upper limit for interfaces to use
803 - Point-to-point interfaces are now allowed
804 - The main select(2) loop now uses a timeout
805 - A small bugfix in the select fd-set update code
806 - Some bugfixes in the configuration file parsing
807 - stdout/stderr are now set to not be buffered
808 - A bugfix in the MID generation regarding seq. numbering
812 A new set of functions that are called whenever a change in the
813 interface configuration(update, addition, removal) is made is
815 These functions are added and removed very much like the ptf
816 functions. Available trough the functions add_ifchgf and del_ifchgf.
818 OBS OBS OBS!!! PLUGIN DEVELOPERS READ THIS!!!!
820 The interface struct(declared in interfaces.h) has changed.
821 Plugin developers must update plugins that uses the interface
824 The headerfile olsr_plugin_io.h which contains the plugin interface
825 commands now contains a revision list where all changes are
829 0.4.5 ---------------------------------------------------------------------
833 A plugin that generates and checks message signatures is added.
836 PLUGIN: TOPOLOGY GRAPH
838 A plugin that generates output of the topology in the dot format
839 is added. See lib/dot_draw
843 Some optimizations done that should cause fewer route recalculations.
847 Some bugs reported by Takafumi Tanaka fixed.
849 RESTORATION OF NETWORK SETTINGS
851 Network settings like disabling of ICMP redirects and spoof filter, are
852 now restored at exit by olsrd.
856 Nodes would in certain scenarios retransmit messages originating for
857 themselves. This was a RFC incompliance. Reported by Ingmar Baumgart.
861 No longer setting the HELLO interval of non-wlan interfaces as a multiplier
862 of the wlan interval. The interval is set seperatly now.
863 Due to this there are some updates in the configfile imperatives.
867 Some new macros introduced for table insertion and removal and IP
868 copying and comparison.
872 IPv6 bugfixes in the GUI.
875 0.4.4 ---------------------------------------------------------------------
879 Routes are no longer added via neighbors declaring a willingness
882 LINK SENSING AND ROUTE CALCULATION
884 Link sensing and route calculation has been updated to handle
885 multiple links between hosts in a sane way.
889 IP spoof filtering is disabled on the interfaces which olsrd runs.
890 These settings are not restored!
894 ICMP redirect message generation is disabled on the interfaces
896 These settings are not restored!
898 CONFIGFILE OPTIONS FOR MID AND HNA ADDED
900 Options to set the MID and HNA emission intervals and
901 validity time in the configfile added.
905 Option to set what IPv6 address type(scope) to use in the
906 configfile added. It can be set to either global or site-local.
910 Options to set site-local and global multicast addresses
911 in the configfile added.
913 EMISSION INTERVAL FUNCTION
915 Functions to set emission intervals at runtime added.
917 LINK LAYER NOTIFICATIONS
919 If started with the -llinfo switch olsrd will collect and display
920 link-layer information on neighbors. This is no longer limited to
921 one interface. But no action is taken based on this info - and
922 there is a upper limit of 8 neighbors from which this info can
923 be collected pr. interface. This limitation is inherited from the
924 WLAN drivers and is not something imposed by the olsrd code!
926 IPv6 HNA MESSAGE FORMAT
928 IPv6 HNA messages now contains 128-bit netmask instead of prefix.
932 Added "packet transform functions" which allow plugins to alter all
933 outgoing OLSR traffic.
937 Moved most headers out of OS dependent directories. The tunneling
938 and link-layer notification interface is not yet separated from
939 the /linux directory.
943 A manpage(olsrd(8)) describing olsrd has been created. It is installed
944 when using 'make install'.
947 0.4.3 ---------------------------------------------------------------------
951 Olsrd now supports runtime-loadable plugins! A couple of example plugins
952 are located in the lib/ directory. Read the README files in the various
953 plugin directories for more info. A directive to load plugins have been
954 added to the configfile as well.
955 Documentation of the plugin interface can be fount at http://www.olsr.org.
957 The plugin interface is designed to be extendable. But it should _always_
958 be backwards compatible with the interface used in this release!
960 LINK-LAYER NOTIFICATION
962 Some preliminary link-layer notification code has been added. Link quality
963 can be written to stdout if olsrd is started with the -llinfo switch.
964 No action is currently taken based on this info. And info will only
965 be retrieved from the interface named "eth1".
966 This code is not usable for users as of yet!
970 Neighbors with willingness set to WILL_ALWAYS is now always added. The
971 MPR selection is optimized as described in RFC3626 section 8.3.1
976 There was a couple of bugs in the MPR selection code. All fixed.
980 Users could not run olsrd on multiple interfaces using the Linux 2.6 kernel
981 series. This is now fixed.
985 One small bug in link hysteresis initialization and one in HNA route
988 MESSAGE-SEQUENCENUMBER INCOMPLIANCE
990 Message-seqnos was implemented on a pr. messagetype and pr. interface
991 basis. This is not RFC3626 compliant and has been updates. All messages
992 and interfaces now uses a global seuencenumber.
994 RANDOM SEQUENCENUMBERS
996 Sequencenumbers are now initialized using a random value.
1000 Fixes for running olsrd in daemon mode(debug 0).
1004 Optimizations based on profiling implemented.
1008 Message size is checked for every message before passing it to the
1009 appropriate message parsing function. If the size is bigger than the
1010 remaining size of the olsr packet then the message is discarded.
1014 Some minor modifications done to the gui.
1018 Lots of changes in handling of registration and unregistration of
1019 scheduler, socketparser, parser and local hna set.
1020 Some restructuring and movement of functions.
1023 0.4.2 ---------------------------------------------------------------------
1027 0.4.1 ---------------------------------------------------------------------
1031 0.4.0 ---------------------------------------------------------------------
1035 Link hysteresis as described in the RFC added.
1039 TC redundancy as described in the RFC added
1043 MPR redundancy as described in the RFC added
1047 The scheduler has been rewritten to register scheduled
1048 events(function pointers) dynamically.
1052 The parser has been rewritten to register parse functions
1053 on a pr. messagetype dynamically
1057 A wrapper for the malloc(3) syscal has been introduced.
1058 olsr_malloc(size_t, const char *) should ALWAYS be used.
1062 Lots of restructuring in headerfiles.
1063 Linux spesific code moved to subdirectory linux/
1064 FreeBSD code to be put in freebsd/
1065 LOTS of code restructured due to the rexrite of the scheduler
1070 Optimizing the MPR set as suggested in the RFC section
1071 8.3.1 point 5 added.
1075 Some bugs in MPR selection fixed.
1078 0.3.8 ---------------------------------------------------------------------
1082 HNA code completely rewritten!
1083 The old code was really bad! Now it is much cleaner implemented and
1085 One- and two-hop neighbor list structures rewritten. They now use
1086 the same hashed double-linked lists as the rest of the information
1091 Some code restructuring which resulted in the new files: timer.h,
1092 mantissa.c, mantissa.h, hashing.c, hashing.h, linux/net.c
1093 linux/net.h, linux/kernel_routes.c, linux/kernel_routes.h and some
1098 The bug causing errormessages on exit is fixed.
1099 The bug that caused initial HNA routes in the GUI to display a hopcount
1101 IPv6 HNA netmasks were all added as /128. It's fixed now.
1105 Turns out sitelocal address had to be preferred to avoid IPv6 header
1106 messing up link-sensing. Bug fixed
1109 0.3.7 ---------------------------------------------------------------------
1113 The entire TC set and MPR selector set code rewritten. Hashing and
1114 double linked lists added to the MID code.
1115 Lots of HNA code has been rewritten as well.
1119 When a node lost connectivity to a HNA GW all HNA entries to that gw
1120 was deleted. This has been fixed - and HNA entries only gets deleted
1122 Other HNA bugs have been fixed as well. But the whole HNA implementation
1127 There was a bug that caused holdingtime not to be properly recalculated
1128 when using non-default emission intervals.
1130 Forwarding and symmetric neighbors
1132 Seems I had misread the RFC on what a 1-hop symmetric neighbor is.
1133 Now the link-set is checked when a check for a symmetric neighbor
1134 is done. Not the 1 hop neighbor set as it used to be. This way
1135 the hack when receiving MID messages could be removed.
1139 Global addresses are now preferred. Sitelocal addresses are only used
1140 if no global addresses are found. There have been problems where
1141 the address set in the IP header of IPv6 packets do not match the
1142 address chosen by OLSR.
1146 The GUI is finally updated! It can now handle piggybacked messages
1147 and link sensing HELLO message format.
1150 0.3.6 ---------------------------------------------------------------------
1152 HNA support using IPv6
1154 HNA now works using IPv6 as well! Just add the network address and
1155 prefix in the HNA6 section in the configfile. The IPv6 HNA packets differ
1156 some from the IPv4 as they don't send the netmask but the prefix.
1159 NEW FILENAME FOR THE BINARY AND CONFIG FILE
1161 They are now called olsrd and olsrd.conf. I figured I'd use the olsrd
1162 name before somebody else started using it ;-)
1167 New options: DEBUG, HNA6 and IPC-CONNECT added to config file.
1172 A printf-wrapper has been introduced - debug level output handling
1173 is much more uniform now.
1174 The daemon should run fine in detached mode now(DEBUG 0)
1178 The GUI front-end can now connect and disconnect at any time while the
1179 daemon is running, if started using the -ipc switch or with IPC set to
1180 'yes' in the configfile.
1185 A small HNA bug fixed.
1188 0.3.5 ---------------------------------------------------------------------
1192 Forwarding jitter added. Messages are piggybacked if they arrive(and are to
1193 be forwarded) while there is data to be forwarded buffered.
1194 Added some bugfixes to support parsing of piggybacked messages as well.
1198 Fixed route calculation so that 2 hop neighbors are added. This smooths
1199 changes from 1 hop to 2 hop neighbor out. The old way one had to wait for
1200 a TC before the 2 hop neighbors were added.
1204 All neighbors received in HELLO messages are added to the two hop
1205 neighborhood. This helps smoothing out the 1-to-2 hop transition as well.
1209 MID calculation had to be updated due to the registering of two hop neighbors
1210 that are already one hop neighbors. They should not be considered when calculating
1215 Deletion of possible one hop neighbors registered on non main-addresses when
1216 first registering MID info from a node removed. This can not occur due
1217 to the fact that registering of neighbor nodes are done on main addresses
1219 Option to not forward messages on wired links on which they arrived removed.
1220 This is no longer usable to any degree when adding support for piggybacking
1221 of forwarded messages is to be implemented.
1225 Some unused parameters and commandline options were removed.
1229 0.3.3 ---------------------------------------------------------------------
1233 Added sending of empty TC messages if all MPR selectors are removed. Empty
1234 TC messages are sent for a TC_HOLD_TIME period as described in section
1239 Fixed HNA route calculations for IPv6. I forgot to upgrade this in 0.3.2
1243 -hnaint and -midint command line optionas added to set the interval
1244 of HNA and MID generation.
1248 As an optimization messages have not been forwarded on the received interface
1249 if this is registered as a non-WLAN interface. This causes problems for
1250 people using Ethernet-to-WLAN adapters. This optimization is now turned
1251 off by default. It can be activated using the -nofwlan option.
1255 THERE ARE SOME NASTY BUGS IN 0.3.2!
1256 Fixed a bug that caused 2 hop neighbors not to time out.
1257 Fixed a bug that caused a 1 hop neighbor timeout not to recalculate
1259 Fixed a small memleak in the MID set
1260 Fixed some smaller bugs.
1262 IPv6 functioning is not well tested in this release.
1264 0.3.2 ---------------------------------------------------------------------
1268 Updated HNA to be RFC compliant. This means that all received HNA tuples
1269 are registered and only the subset of unique entries(net/netmask) with
1270 the smallest hopcount is inserted into the routing table.
1274 User can specify configfile name using the -f switch.
1278 Fixed a link-sensing bug that caused problems when using MID nodes.
1280 0.3.1 ---------------------------------------------------------------------
1284 MPR calculation is now based on the willingness announced by nodes.
1288 The neighbor set does not have timeouts on entries any more. Creation
1289 and deletion of neighbor entries is done from the link-set as suggested
1294 Gotten rid of a lot of code that became more or less obsolete due to
1295 all the changes introduced in 0.3.0.
1299 Fixed a nasty bug concerning the sequence numbering of TC packets.
1300 Fixed some bugs regarding MPR calculation - and probably introduced
1301 a whole new species when implementing the willingness-based calculation ;-)
1304 0.3.0 ---------------------------------------------------------------------
1306 Due to the extensive amount of updates this release is versioned 0.3.0
1308 Duplicate table and forwarding
1310 The duplicate table functionality is totally rewritten in 100% RFC
1311 compliance. The forward algorithm specified in the RFC is implemented
1312 this meant rewriting much of the packet processing code. The daemon
1313 also forwards unknown packettypes now.
1315 Link sensing and neighbor processing
1317 Link sensing and neighbor processing was done in the same operation in the
1318 old code. Link sensing is now a mechanism of its own which is 100% RFC
1319 compliant. Neighbor processing and HELLO generation has been partly
1320 rewritten to be RFC compliant. Neighbors are now registered as either
1321 SYN or NOT_SYM. The NOT_NEIGH, SYM_NEIGH and MPR_NEIGH values are only
1322 used when building HELLO messages. Links are in one of the following states:
1323 UNSPEC_LINK, ASYM_LINK or SYM_LINK.
1324 HELLO messages now advertise link status of neighbors on the interface
1325 the message is transmitted.
1329 A node now dynamically calculates willingness based on powersource and
1330 possibly battery power. If the node is AC powered it announces a willingness
1331 of 6. If batterypowered the willingness is calculated as:
1333 Where P is percentage of power left.
1337 The daemon now tries to read its configuration from the file /etc/uolsrd.conf
1338 A "standard" configuration file is installed when doing 'make install'.
1339 This file should be edited to fit your needs.
1340 Command-line options can still be used to override the configuration form
1341 the file(ore if no config file is present).
1342 The -f switch can also be used to specify a configuration file.
1346 If AdvancedPowerManagemant(APM) is supported on your system the willingness
1347 of the node is dynamically calculated based upon the powerstatus of the node.
1348 MPR calculation based upon willingness is not done as of yet.
1352 A bugs in the TC processing fixed.
1356 Some serious HNA bugs fixed. These bugs caused a node to always choos the
1357 gateway with the larges hopcout :) More seriously - a bug caused looping
1358 of HNA messages in certain scenarios.
1360 Package sequence numbers
1362 These were added. Not much use as of now - but they're there(as specified
1367 Users can now specify the broadcast address to use. Useful if one wishes to
1368 use the 255.255.255.255 broadcast.
1372 0.2.5 ---------------------------------------------------------------------
1376 Htime and Vtime processing and handling added. Holding times used to be
1377 a static value for all nodes. Now every node can signal its vlidity time
1379 To achieve this mantissa/exponent calculation functionality was added.
1380 Messages now include Vtime(and Htime in HELLO) values in mantissa/exponent
1381 format instead of just zero. These values are as stated above, used as holding
1383 the GUI should be upgraded as well...
1387 The use of jitter in message generation intervals vere fixed.
1390 0.2.4 ---------------------------------------------------------------------
1394 Some bugs concerning sequence numbers in HELLO and MID message handling
1395 was fixed. Newly registered nodes in the neighbor and MID sets were
1396 initialized with a seqno of 0. When using a "wraparound" sequencenumber
1397 check(as defined in olsr_protocol.h) this can produce errors if a new
1398 node joins a network where existing nodes has seqnos >0x00FF.
1402 Some checks and copying of node addresses where done using sizeof(u_olsr32_t)
1403 which is 32 bits. This caused only the 32 firs bits of IPv6 addresses to
1404 be copied and checked.