PUD: cfg: simplify isMulticast function
[olsrd.git] / lib / secure / README_SECURE
1
2
3 Secure OLSR 0.4 implementation notes
4 (c)Andreas Tonnesen 2004
5
6 This document contains information on how to
7 use the secure OLSR plugin with the UniK olsr daemon.
8 It does _not_ cover secure OLSR protocol issues.
9
10 Lines starting with '# ' indicates shell commands.
11
12 NOTES
13
14   The plugin interface and olsrd output buffering was
15   heavily rewritten for the 0.4.8 release. The plugin
16   should work with this release - but has not been
17   tested much.
18
19 COMPILING
20
21   To compile simply do:
22   # make
23   This compiles the local MD5 function and the plugin has
24   no external dependencies.
25   If you want the plugin to use SHA-1 using the openssl libs
26   do:
27   # make USE_OPENSSL=1
28
29 INSTALLING
30
31   To install:
32   # make install
33
34   This will run ldconfig to update the dynamic linker.
35   It might take a while.
36
37 USAGE
38
39   To make olsrd load the secure OLSR plugin add the
40   following in the olsrd configuration file:
41
42 LoadPlugin "olsrd_secure.so.0.6"
43 {
44     PlParam     "Keyfile"   "FILENAME"
45 }
46
47   replacing FILENAME with the full path of the file
48   containing the shared key.
49
50   The plugin uses this shared secret key for signature
51   generation and verification. For nodes to participate 
52   in the OLSR routing domain they need to use the key 
53   used by the other nodes.
54   The key is 128-bits of size and is read from the
55   specified file from the config file or by default from:
56   /etc/olsrd.d/olsrd_secure_key
57
58   Copy the key to this file an all nodes. The plugin
59   will terminate olsrd if this file cannot be found.
60
61   Now start olsrd and the let the plugin do its
62   thing :)
63
64 - Andreas