4 * lwIP network interface abstraction
8 * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
11 * Redistribution and use in source and binary forms, with or without modification,
12 * are permitted provided that the following conditions are met:
14 * 1. Redistributions of source code must retain the above copyright notice,
15 * this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright notice,
17 * this list of conditions and the following disclaimer in the documentation
18 * and/or other materials provided with the distribution.
19 * 3. The name of the author may not be used to endorse or promote products
20 * derived from this software without specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
23 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
24 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
25 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
27 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
28 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
29 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
30 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
33 * This file is part of the lwIP TCP/IP stack.
35 * Author: Adam Dunkels <adam@sics.se>
42 #include "lwip/ip_addr.h"
43 #include "lwip/netif.h"
45 #include "lwip/snmp.h"
47 struct netif
*netif_list
= NULL
;
48 struct netif
*netif_default
= NULL
;
51 * Add a network interface to the list of lwIP netifs.
53 * @param netif a pre-allocated netif structure
54 * @param ipaddr IP address for the new netif
55 * @param netmask network mask for the new netif
56 * @param gw default gateway IP address for the new netif
57 * @param state opaque data passed to the new netif
58 * @param init callback function that initializes the interface
59 * @param input callback function that is called to pass
60 * ingress packets up in the protocol layer stack.
62 * @return netif, or NULL if failed.
65 netif_add(struct netif
*netif
, struct ip_addr
*ipaddr
, struct ip_addr
*netmask
,
68 err_t (* init
)(struct netif
*netif
),
69 err_t (* input
)(struct pbuf
*p
, struct netif
*netif
))
71 static s16_t netifnum
= 0;
73 /* reset new interface configuration state */
74 netif
->ip_addr
.addr
= 0;
75 netif
->netmask
.addr
= 0;
79 /* netif not under DHCP control by default */
82 /* remember netif specific state information data */
84 netif
->num
= netifnum
++;
87 netif_set_addr(netif
, ipaddr
, netmask
, gw
);
89 /* call user specified initialization function for netif */
90 if (init(netif
) != ERR_OK
) {
94 /* add this netif to the list */
95 netif
->next
= netif_list
;
99 LWIP_DEBUGF(NETIF_DEBUG
, ("netif: added interface %c%c IP addr ",
100 netif
->name
[0], netif
->name
[1]));
101 ip_addr_debug_print(NETIF_DEBUG
, ipaddr
);
102 LWIP_DEBUGF(NETIF_DEBUG
, (" netmask "));
103 ip_addr_debug_print(NETIF_DEBUG
, netmask
);
104 LWIP_DEBUGF(NETIF_DEBUG
, (" gw "));
105 ip_addr_debug_print(NETIF_DEBUG
, gw
);
106 LWIP_DEBUGF(NETIF_DEBUG
, ("\n"));
111 netif_set_addr(struct netif
*netif
,struct ip_addr
*ipaddr
, struct ip_addr
*netmask
,
114 netif_set_ipaddr(netif
, ipaddr
);
115 netif_set_netmask(netif
, netmask
);
116 netif_set_gw(netif
, gw
);
119 void netif_remove(struct netif
* netif
)
121 if ( netif
== NULL
) return;
123 snmp_delete_ipaddridx_tree(netif
);
125 /* is it the first netif? */
126 if (netif_list
== netif
) {
127 netif_list
= netif
->next
;
131 /* look for netif further down the list */
132 struct netif
* tmpNetif
;
133 for (tmpNetif
= netif_list
; tmpNetif
!= NULL
; tmpNetif
= tmpNetif
->next
) {
134 if (tmpNetif
->next
== netif
) {
135 tmpNetif
->next
= netif
->next
;
140 if (tmpNetif
== NULL
)
141 return; /* we didn't find any netif today */
143 /* this netif is default? */
144 if (netif_default
== netif
)
145 /* reset default netif */
146 netif_default
= NULL
;
147 LWIP_DEBUGF( NETIF_DEBUG
, ("netif_remove: removed netif\n") );
151 netif_find(char *name
)
162 for(netif
= netif_list
; netif
!= NULL
; netif
= netif
->next
) {
163 if (num
== netif
->num
&&
164 name
[0] == netif
->name
[0] &&
165 name
[1] == netif
->name
[1]) {
166 LWIP_DEBUGF(NETIF_DEBUG
, ("netif_find: found %c%c\n", name
[0], name
[1]));
170 LWIP_DEBUGF(NETIF_DEBUG
, ("netif_find: didn't find %c%c\n", name
[0], name
[1]));
175 netif_set_ipaddr(struct netif
*netif
, struct ip_addr
*ipaddr
)
177 /* TODO: Handling of obsolete pcbs */
178 /* See: http://mail.gnu.org/archive/html/lwip-users/2003-03/msg00118.html */
181 struct tcp_pcb_listen
*lpcb
;
183 /* address is actually being changed? */
184 if ((ip_addr_cmp(ipaddr
, &(netif
->ip_addr
))) == 0)
186 /* extern struct tcp_pcb *tcp_active_pcbs; defined by tcp.h */
187 LWIP_DEBUGF(NETIF_DEBUG
| 1, ("netif_set_ipaddr: netif address being changed\n"));
188 pcb
= tcp_active_pcbs
;
189 while (pcb
!= NULL
) {
190 /* PCB bound to current local interface address? */
191 if (ip_addr_cmp(&(pcb
->local_ip
), &(netif
->ip_addr
))) {
192 /* this connection must be aborted */
193 struct tcp_pcb
*next
= pcb
->next
;
194 LWIP_DEBUGF(NETIF_DEBUG
| 1, ("netif_set_ipaddr: aborting TCP pcb %p\n", (void *)pcb
));
201 for (lpcb
= tcp_listen_pcbs
.listen_pcbs
; lpcb
!= NULL
; lpcb
= lpcb
->next
) {
202 /* PCB bound to current local interface address? */
203 if (ip_addr_cmp(&(lpcb
->local_ip
), &(netif
->ip_addr
))) {
204 /* The PCB is listening to the old ipaddr and
205 * is set to listen to the new one instead */
206 ip_addr_set(&(lpcb
->local_ip
), ipaddr
);
211 snmp_delete_ipaddridx_tree(netif
);
212 snmp_delete_iprteidx_tree(0,netif
);
213 /* set new IP address to netif */
214 ip_addr_set(&(netif
->ip_addr
), ipaddr
);
215 snmp_insert_ipaddridx_tree(netif
);
216 snmp_insert_iprteidx_tree(0,netif
);
218 #if 0 /* only allowed for Ethernet interfaces TODO: how can we check? */
219 /** For Ethernet network interfaces, we would like to send a
220 * "gratuitous ARP"; this is an ARP packet sent by a node in order
221 * to spontaneously cause other nodes to update an entry in their
222 * ARP cache. From RFC 3220 "IP Mobility Support for IPv4" section 4.6.
224 etharp_query(netif
, ipaddr
, NULL
);
226 LWIP_DEBUGF(NETIF_DEBUG
| DBG_TRACE
| DBG_STATE
| 3, ("netif: IP address of interface %c%c set to %"U16_F
".%"U16_F
".%"U16_F
".%"U16_F
"\n",
227 netif
->name
[0], netif
->name
[1],
228 ip4_addr1(&netif
->ip_addr
),
229 ip4_addr2(&netif
->ip_addr
),
230 ip4_addr3(&netif
->ip_addr
),
231 ip4_addr4(&netif
->ip_addr
)));
235 netif_set_gw(struct netif
*netif
, struct ip_addr
*gw
)
237 ip_addr_set(&(netif
->gw
), gw
);
238 LWIP_DEBUGF(NETIF_DEBUG
| DBG_TRACE
| DBG_STATE
| 3, ("netif: GW address of interface %c%c set to %"U16_F
".%"U16_F
".%"U16_F
".%"U16_F
"\n",
239 netif
->name
[0], netif
->name
[1],
240 ip4_addr1(&netif
->gw
),
241 ip4_addr2(&netif
->gw
),
242 ip4_addr3(&netif
->gw
),
243 ip4_addr4(&netif
->gw
)));
247 netif_set_netmask(struct netif
*netif
, struct ip_addr
*netmask
)
249 snmp_delete_iprteidx_tree(0, netif
);
250 /* set new netmask to netif */
251 ip_addr_set(&(netif
->netmask
), netmask
);
252 snmp_insert_iprteidx_tree(0, netif
);
253 LWIP_DEBUGF(NETIF_DEBUG
| DBG_TRACE
| DBG_STATE
| 3, ("netif: netmask of interface %c%c set to %"U16_F
".%"U16_F
".%"U16_F
".%"U16_F
"\n",
254 netif
->name
[0], netif
->name
[1],
255 ip4_addr1(&netif
->netmask
),
256 ip4_addr2(&netif
->netmask
),
257 ip4_addr3(&netif
->netmask
),
258 ip4_addr4(&netif
->netmask
)));
262 netif_set_default(struct netif
*netif
)
266 /* remove default route */
267 snmp_delete_iprteidx_tree(1, netif
);
271 /* install default route */
272 snmp_insert_iprteidx_tree(1, netif
);
274 netif_default
= netif
;
275 LWIP_DEBUGF(NETIF_DEBUG
, ("netif: setting default interface %c%c\n",
276 netif
? netif
->name
[0] : '\'', netif
? netif
->name
[1] : '\''));
280 * Bring an interface up, available for processing
283 * @note: Enabling DHCP on a down interface will make it come
284 * up once configured.
288 void netif_set_up(struct netif
*netif
)
290 netif
->flags
|= NETIF_FLAG_UP
;
292 snmp_get_sysuptime(&netif
->ts
);
297 * Ask if an interface is up
299 u8_t
netif_is_up(struct netif
*netif
)
301 return (netif
->flags
& NETIF_FLAG_UP
)?1:0;
305 * Bring an interface down, disabling any traffic processing.
307 * @note: Enabling DHCP on a down interface will make it come
308 * up once configured.
312 void netif_set_down(struct netif
*netif
)
314 netif
->flags
&= ~NETIF_FLAG_UP
;
316 snmp_get_sysuptime(&netif
->ts
);
323 netif_list
= netif_default
= NULL
;