interface: let interface_set_down() return void
[oweals/netifd.git] / interface.h
1 /*
2  * netifd - network interface daemon
3  * Copyright (C) 2012 Felix Fietkau <nbd@openwrt.org>
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License version 2
7  * as published by the Free Software Foundation
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  */
14 #ifndef __NETIFD_INTERFACE_H
15 #define __NETIFD_INTERFACE_H
16
17 #include "device.h"
18 #include "config.h"
19
20 struct interface;
21 struct interface_proto_state;
22
23 enum interface_event {
24         IFEV_DOWN,
25         IFEV_UP,
26         IFEV_UP_FAILED,
27         IFEV_UPDATE,
28         IFEV_FREE,
29         IFEV_RELOAD,
30         IFEV_LINK_UP,
31         /* send when a new interface created. This is before proto handlers has been attached. */
32         IFEV_CREATE,
33 };
34
35 enum interface_state {
36         IFS_SETUP,
37         IFS_UP,
38         IFS_TEARDOWN,
39         IFS_DOWN,
40 };
41
42 enum interface_config_state {
43         IFC_NORMAL,
44         IFC_RELOAD,
45         IFC_REMOVE
46 };
47
48 enum interface_id_selection_type {
49         IFID_FIXED,
50         IFID_RANDOM,
51         IFID_EUI64
52 };
53
54 enum interface_update_flags {
55         IUF_ADDRESS     = (1 << 0),
56         IUF_ROUTE       = (1 << 1),
57         IUF_PREFIX      = (1 << 2),
58         IUF_DATA        = (1 << 3),
59 };
60
61 struct interface_error {
62         struct list_head list;
63
64         const char *subsystem;
65         const char *code;
66         const char *data[];
67 };
68
69 struct interface_user {
70         struct list_head list;
71         struct interface *iface;
72         void (*cb)(struct interface_user *dep, struct interface *iface, enum interface_event ev);
73 };
74
75 struct interface_ip_settings {
76         struct interface *iface;
77         bool enabled;
78         bool no_defaultroute;
79         bool no_dns;
80         bool no_delegation;
81
82         struct vlist_tree addr;
83         struct vlist_tree route;
84         struct vlist_tree prefix;
85
86         struct vlist_simple_tree dns_servers;
87         struct vlist_simple_tree dns_search;
88 };
89
90 struct interface_data {
91         struct avl_node node;
92         struct blob_attr data[];
93 };
94
95 struct interface_assignment_class {
96         struct list_head head;
97         char name[];
98 };
99
100 /*
101  * interface configuration
102  */
103 struct interface {
104         struct vlist_node node;
105         struct list_head hotplug_list;
106         enum interface_event hotplug_ev;
107
108         const char *name;
109         const char *ifname;
110
111         bool available;
112         bool autostart;
113         bool config_autostart;
114         bool device_config;
115         bool enabled;
116         bool link_state;
117         bool force_link;
118         bool dynamic;
119         bool policy_rules_set;
120         bool link_up_event;
121
122         time_t start_time;
123         enum interface_state state;
124         enum interface_config_state config_state;
125         enum interface_update_flags updated;
126
127         struct list_head users;
128
129         /* for alias interface */
130         const char *parent_ifname;
131         struct interface_user parent_iface;
132
133         /* main interface that the interface is bound to */
134         struct device_user main_dev;
135         struct device_user ext_dev;
136
137         /* interface that layer 3 communication will go through */
138         struct device_user l3_dev;
139
140         struct blob_attr *config;
141
142         /* primary protocol state */
143         const struct proto_handler *proto_handler;
144         struct interface_proto_state *proto;
145
146         struct interface_ip_settings proto_ip;
147         struct interface_ip_settings config_ip;
148         struct vlist_tree host_routes;
149
150         int metric;
151         int dns_metric;
152         unsigned int ip4table;
153         unsigned int ip6table;
154
155         /* IPv6 assignment parameters */
156         enum interface_id_selection_type assignment_iface_id_selection;
157         struct in6_addr assignment_fixed_iface_id;
158         uint8_t assignment_length;
159         int32_t assignment_hint;
160         struct list_head assignment_classes;
161         int assignment_weight;
162
163         /* errors/warnings while trying to bring up the interface */
164         struct list_head errors;
165
166         /* extra data provided by protocol handlers or modules */
167         struct avl_tree data;
168
169         struct uloop_timeout remove_timer;
170         struct ubus_object ubus;
171 };
172
173
174 extern struct vlist_tree interfaces;
175 extern const struct uci_blob_param_list interface_attr_list;
176
177 struct interface *interface_alloc(const char *name, struct blob_attr *config);
178
179 void interface_set_dynamic(struct interface *iface);
180
181 void interface_add(struct interface *iface, struct blob_attr *config);
182 bool interface_add_alias(struct interface *iface, struct blob_attr *config);
183
184 void interface_set_proto_state(struct interface *iface, struct interface_proto_state *state);
185
186 void interface_set_available(struct interface *iface, bool new_state);
187 void interface_set_up(struct interface *iface);
188 void interface_set_down(struct interface *iface);
189 int interface_renew(struct interface *iface);
190
191 void interface_set_main_dev(struct interface *iface, struct device *dev);
192 void interface_set_l3_dev(struct interface *iface, struct device *dev);
193
194 void interface_add_user(struct interface_user *dep, struct interface *iface);
195 void interface_remove_user(struct interface_user *dep);
196
197 int interface_remove_link(struct interface *iface, struct device *dev);
198 int interface_handle_link(struct interface *iface, const char *name, bool add, bool link_ext);
199
200 void interface_add_error(struct interface *iface, const char *subsystem,
201                          const char *code, const char **data, int n_data);
202
203 int interface_add_data(struct interface *iface, const struct blob_attr *data);
204 int interface_parse_data(struct interface *iface, const struct blob_attr *attr);
205
206 void interface_update_start(struct interface *iface, const bool keep_old);
207 void interface_update_complete(struct interface *iface);
208
209 void interface_start_pending(void);
210
211 #endif