jsoninfo: use the function to initialise the config
[olsrd.git] / lib / txtinfo / README_TXTINFO
1
2    PLUGIN USAGE
3 ==================
4
5 installation:
6 make
7 make install
8
9 echo /all | nc 127.0.0.1 2006
10  or
11 telnet 127.0.0.1 2006 (and type /all then enter)
12  or
13 wget http://localhost:2006/all -qO -
14  or
15 curl http://localhost:2006/all
16
17 Or in a web browser: http://localhost:2006/all
18
19 The output shows the links of the node, its neighbors, the topology
20 table, HNA (Host and Network Association) and MID (Multiple Interface
21 Declaration) tables and the actual routing table.
22
23 So what commands does the txtinfo plugin accept?
24
25     * Config: "/config" -> send_what=SIW_CONFIG
26     * Gateways: "/gateway" -> send_what=SIW_GATEWAY
27     * HNA: "/hna" -> send_what=SIW_HNA
28     * Interfaces: "/interface" -> send_what=SIW_INTERFACE
29     * Links: "/link" -> send_what=SIW_LINK
30     * MID: "/mid" -> send_what=SIW_MID
31     * Neighbors: "/neigh" -> send_what=SIW_NEIGH
32     * Routes: "/route" -> send_what=SIW_ROUTE
33     * Topology: "/topo" -> send_what=SIW_TOPO
34     * 2-hop neighbors: "/2hop" -> send_what=SIW_2HOP
35     * Version: "/ver" -> send_what=version of olsrd
36     * (Smart) Gateway Information: "/sgw" -> send_what=information on all active (smart) gateways
37
38 This is the same as the "/neigh" and "/link" commands combined:
39
40     * "/neighbours" -> send_what = SIW_NEIGHLINK -> neighbours and links
41
42 Then there is "/all" which returns all of the most commonly used
43 commands above (but not every command above). "/all" is the same as
44 "/links/neigh/topo/hna/mid/routes".
45
46 http://www.olsr.org/?q=node/26
47
48
49    PLUGIN CONFIGURATION
50 ==========================
51
52 The plugin accepts two parameters: "port" and "accept". There are no
53 futher parameters.  Here's an example configuration for UNIX systems
54 (for Windows, change the plugin to end in .dll):
55
56 LoadPlugin "olsrd_txtinfo.so.0.1"
57 {
58     # The port number on which the plugin will be listening
59     # PlParam     "port"               "2006"
60
61     # You can set an "accept" IP address that is allowed to connect to
62     # the plugin. If no address is specified, then localhost (127.0.0.1)
63     # is allowed by default.  Only the last parameter specified will be used,
64     # others will be ignored.
65     # Use 0.0.0.0 to accept all connections
66     # PlParam     "accept"             "127.0.0.1"
67
68     # You can set a "listen" IP address that is used to determine the interface
69     # on which the plugin will be listening. If no address is specified, then
70     # the plugin will listen on all interfaes. Only the last parameter specified
71     # will be used, others will be ignored.
72     # PlParam     "listen"             "0.0.0.0"
73
74     # Set to true to prepend HTTP headers before the reply
75     # PlParam     "httpheaders"        "true"
76
77     # Set to true to always allow connections from 127.0.0.1
78     # PlParam     "allowlocalhost"     "false"
79
80     # Set to true to only listen on IPv6 addresses when running in IPv6 mode.
81     # PlParam     "ipv6only"           "false"
82
83     # Set to true to include VTime values into Link/Topology commands
84     # PlParam     "vtime"             "false"
85 }