tipc: add neighbor monitoring framework
[cascardo/linux.git] / net / tipc / monitor.h
1 /*
2  * net/tipc/monitor.h
3  *
4  * Copyright (c) 2015, Ericsson AB
5  * All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions are met:
9  *
10  * 1. Redistributions of source code must retain the above copyright
11  *    notice, this list of conditions and the following disclaimer.
12  * 2. Redistributions in binary form must reproduce the above copyright
13  *    notice, this list of conditions and the following disclaimer in the
14  *    documentation and/or other materials provided with the distribution.
15  * 3. Neither the names of the copyright holders nor the names of its
16  *    contributors may be used to endorse or promote products derived from
17  *    this software without specific prior written permission.
18  *
19  * Alternatively, this software may be distributed under the terms of the
20  * GNU General Public License ("GPL") version 2 as published by the Free
21  * Software Foundation.
22  *
23  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
24  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
25  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
26  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
27  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
28  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
29  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
30  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
31  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33  * POSSIBILITY OF SUCH DAMAGE.
34  */
35
36 #ifndef _TIPC_MONITOR_H
37 #define _TIPC_MONITOR_H
38
39 /* struct tipc_mon_state: link instance's cache of monitor list and domain state
40  * @list_gen: current generation of this node's monitor list
41  * @gen: current generation of this node's local domain
42  * @peer_gen: most recent domain generation received from peer
43  * @acked_gen: most recent generation of self's domain acked by peer
44  * @monitoring: this peer endpoint should continuously monitored
45  * @probing: peer endpoint should be temporarily probed for potential loss
46  * @synched: domain record's generation has been synched with peer after reset
47  */
48 struct tipc_mon_state {
49         u16 list_gen;
50         u16 peer_gen;
51         u16 acked_gen;
52         bool monitoring :1;
53         bool probing    :1;
54         bool reset      :1;
55         bool synched    :1;
56 };
57
58 int tipc_mon_create(struct net *net, int bearer_id);
59 void tipc_mon_delete(struct net *net, int bearer_id);
60
61 void tipc_mon_peer_up(struct net *net, u32 addr, int bearer_id);
62 void tipc_mon_peer_down(struct net *net, u32 addr, int bearer_id);
63 void tipc_mon_prep(struct net *net, void *data, int *dlen,
64                    struct tipc_mon_state *state, int bearer_id);
65 void tipc_mon_rcv(struct net *net, void *data, u16 dlen, u32 addr,
66                   struct tipc_mon_state *state, int bearer_id);
67 void tipc_mon_get_state(struct net *net, u32 addr,
68                         struct tipc_mon_state *state,
69                         int bearer_id);
70 void tipc_mon_remove_peer(struct net *net, u32 addr, int bearer_id);
71
72 extern const int tipc_max_domain_size;
73 #endif