46fa862d711ccdb5fa07d4553feadbdc479786b5
[olsrd.git] / src / lq_plugin.h
1 /*
2  * The olsr.org Optimized Link-State Routing daemon(olsrd)
3  * Copyright (c) 2008 Henning Rogge <rogge@fgan.de>
4  * All rights reserved.
5  *
6  * Redistribution and use in source and binary forms, with or without 
7  * modification, are permitted provided that the following conditions 
8  * are met:
9  *
10  * * Redistributions of source code must retain the above copyright 
11  *   notice, this list of conditions and the following disclaimer.
12  * * Redistributions in binary form must reproduce the above copyright 
13  *   notice, this list of conditions and the following disclaimer in 
14  *   the documentation and/or other materials provided with the 
15  *   distribution.
16  * * Neither the name of olsr.org, olsrd nor the names of its 
17  *   contributors may be used to endorse or promote products derived 
18  *   from this software without specific prior written permission.
19  *
20  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
21  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
24  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 
27  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
28  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 
30  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
31  * POSSIBILITY OF SUCH DAMAGE.
32  *
33  * Visit http://www.olsr.org for more information.
34  *
35  * If you find this software useful feel free to make a donation
36  * to the project. For more information see the website or contact
37  * the copyright holders.
38  *
39  */
40
41 #ifndef LQPLUGIN_H_
42 #define LQPLUGIN_H_
43
44 #include "tc_set.h"
45 #include "link_set.h"
46 #include "lq_route.h"
47 #include "lq_packet.h"
48 #include "packet.h"
49
50 #define LINK_COST_BROKEN (1<<22)
51 #define ROUTE_COST_BROKEN (0xffffffff)
52 #define ZERO_ROUTE_COST 0
53
54 struct lqtextbuffer {
55   char buf[16];
56 };
57
58 struct lq_handler {
59   olsr_linkcost (*calc_hello_cost)(const void *lq);
60   olsr_linkcost (*calc_tc_cost)(const void *lq);
61   
62   olsr_bool (*is_relevant_costchange)(olsr_linkcost c1, olsr_linkcost c2);
63   
64   olsr_linkcost (*packet_loss_handler)(struct link_entry *entry, void *lq, olsr_bool lost);
65   
66   void (*memorize_foreign_hello)(void *local, void *foreign);
67   void (*copy_link_lq_into_tc)(void *target, void *source);
68   void (*clear_hello)(void *target);
69   void (*clear_tc)(void *target);
70   
71   int (*serialize_hello_lq)(unsigned char *buff, void *lq);
72   int (*serialize_tc_lq)(unsigned char *buff, void *lq);
73   void (*deserialize_hello_lq)(const olsr_u8_t **curr, void *lq);
74   void (*deserialize_tc_lq)(const olsr_u8_t **curr, void *lq);
75   
76   const char *(*print_hello_lq)(void *ptr, struct lqtextbuffer *buffer);
77   const char *(*print_tc_lq)(void *ptr, struct lqtextbuffer *buffer);
78   const char *(*print_cost)(olsr_linkcost cost, struct lqtextbuffer *buffer);
79   
80   size_t hello_lq_size;
81   size_t tc_lq_size;
82 };
83
84 void set_lq_handler(struct lq_handler *handler, const char *name);
85
86 olsr_linkcost olsr_calc_tc_cost(const struct tc_edge_entry *);
87 olsr_bool olsr_is_relevant_costchange(olsr_linkcost c1, olsr_linkcost c2);
88
89 int olsr_serialize_hello_lq_pair(unsigned char *buff, struct lq_hello_neighbor *neigh);
90 void olsr_deserialize_hello_lq_pair(const olsr_u8_t **curr, struct hello_neighbor *neigh);
91 int olsr_serialize_tc_lq_pair(unsigned char *buff, struct tc_mpr_addr *neigh);
92 void olsr_deserialize_tc_lq_pair(const olsr_u8_t **curr, struct tc_edge_entry *edge);
93
94 void olsr_update_packet_loss_worker(struct link_entry *entry, olsr_bool lost);
95 void olsr_memorize_foreign_hello_lq(struct link_entry *local, struct hello_neighbor *foreign);
96
97 const char *get_link_entry_text(struct link_entry *entry, struct lqtextbuffer *buffer);
98 const char *get_tc_edge_entry_text(struct tc_edge_entry *entry, struct lqtextbuffer *buffer);
99 const char *get_linkcost_text(olsr_linkcost cost, olsr_bool route, struct lqtextbuffer *buffer);
100
101 void olsr_copy_hello_lq(struct lq_hello_neighbor *target, struct link_entry *source);
102 void olsr_copylq_link_entry_2_tc_mpr_addr(struct tc_mpr_addr *target, struct link_entry *source);
103 void olsr_copylq_link_entry_2_tc_edge_entry(struct tc_edge_entry *target, struct link_entry *source);
104 void olsr_clear_tc_lq(struct tc_mpr_addr *target);
105
106 struct hello_neighbor *olsr_malloc_hello_neighbor(const char *id);
107 struct tc_mpr_addr *olsr_malloc_tc_mpr_addr(const char *id);
108 struct lq_hello_neighbor *olsr_malloc_lq_hello_neighbor(const char *id);
109 struct link_entry *olsr_malloc_link_entry(const char *id);
110 struct tc_edge_entry *olsr_malloc_tc_edge_entry(const char *id);
111
112 /* Externals. */
113 extern struct lq_handler *active_lq_handler;
114
115 #endif /*LQPLUGIN_H_*/
116
117 /*
118  * Local Variables:
119  * c-basic-offset: 2
120  * End:
121  */