2 olsr.org OLSR daemon 0.4.8
4 Andreas Tonnesen(andreto@olsr.org)
5 Thomas Lopatic (thomas@lopatic.de)
12 1. OLSR RFC COMPLIANCE
14 Olsrd is RFC3626 compliant. Most RFC realted definitions can be found
15 in the olsr_protocol header file.
20 This version also has some extentions which are part of other projects:
24 - Dynamic Internet gateway. A plugin that dynamically adds and removes Internet
25 HNA transmissions based on if there exists a default gateway to Internet
26 with hopcount = 0(non OLSR gateway).
28 - Dot draw. A plugin that produces output in the dot format representing
31 - Secure OLSR plugin. This plugin adds a signature to all messages
32 to ensure data integrity. This way only nodes with access to the
33 shared key can participate in the routing.
34 You need to have the OpenSSL libs installed to use this plugin.
36 - Powerplugin. A plugin that uses OLSRs MPR flooding to spread information
37 about the powerstatus of nodes. Ment as an example plugin to get coders
42 - IPC to GUI front-end. A gui front-end can connect to the daemon
43 if started with the -ipc switch or set in the configfile.
46 3. COMPILING & INSTALLING
48 The makefile is updated in this version.
49 To install to a directoy different from / use INSTALL_PREFIX=targetdir
50 To use other compilers set CC=yourcompiler
51 All this can be done on the command line(or in scripts), so there should
52 not be any need to update the Makefile for different environments.
56 Just type 'make' to see a list of available targets.
58 To install(you must be root):
61 This also installs the standard configuration file((PREFIXDIR)/etc/olsrd.conf)
62 YOU MUST EDIT THIS FILE!
64 To clean up object files run
68 To compile and install the power plugin:
72 To compile and install the dynamic GW plugin:
76 4. CONFIGURING & RUNNING:
79 Edit the configuration file to fit your needs.
81 Options in the config file can also be overridden by command line
82 options. See the manual pages olsrd(8) and olsrd.conf(5) for details.
84 To run the daemon you MUST specify which interface(s) to use either in
85 the config file or by using the -i option.
87 The binary is named 'olsrd' and is installed in (PREFIX)/usr/sbin.
88 You must have root privelegies to run olsrd!
90 To run the daemon in the background you can either start olsrd
91 with the '-d 0' switch or set DEBUG to 0 in the config file.
93 To use plugins add them to the configfile as explained in the file.
95 4.1 SOME COMMAND-LINE OPTIONS:
98 See the manpage for command line options.
102 Problems have been reported when running in daemon mode(DEBUG 0). If this
103 causes problems and you need to run olsrd in the background you could
104 just redirect output to /dev/null( > /dev/null)
109 These are instructions to build the Linux GTK-based GUI.
116 The binary is put in the current directory
124 REMEMBER olsrd must be started using the -ipc switch or the
125 IPC option must be set to yes to be able to use the GUI front-end