3 * Network Interface Sequential API module
8 * Redistribution and use in source and binary forms, with or without modification,
9 * are permitted provided that the following conditions are met:
11 * 1. Redistributions of source code must retain the above copyright notice,
12 * this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright notice,
14 * this list of conditions and the following disclaimer in the documentation
15 * and/or other materials provided with the distribution.
16 * 3. The name of the author may not be used to endorse or promote products
17 * derived from this software without specific prior written permission.
19 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED
20 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
21 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
22 * SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
24 * OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
27 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
30 * This file is part of the lwIP TCP/IP stack.
36 #if LWIP_NETIF_API /* don't build if not configured for use in lwipopts.h */
38 #include "lwip/netifapi.h"
39 #include "lwip/tcpip.h"
42 * Call netif_add() inside the tcpip_thread context.
45 do_netifapi_netif_add( struct netifapi_msg_msg *msg)
47 if (!netif_add( msg->netif,
53 msg->msg.add.input)) {
58 TCPIP_NETIFAPI_ACK(msg);
62 * Call netif_set_addr() inside the tcpip_thread context.
65 do_netifapi_netif_set_addr( struct netifapi_msg_msg *msg)
67 netif_set_addr( msg->netif,
72 TCPIP_NETIFAPI_ACK(msg);
76 * Call the "errtfunc" (or the "voidfunc" if "errtfunc" is NULL) inside the
77 * tcpip_thread context.
80 do_netifapi_netif_common( struct netifapi_msg_msg *msg)
82 if (msg->msg.common.errtfunc!=NULL) {
84 msg->msg.common.errtfunc(msg->netif);
87 msg->msg.common.voidfunc(msg->netif);
89 TCPIP_NETIFAPI_ACK(msg);
93 * Call netif_add() in a thread-safe way by running that function inside the
94 * tcpip_thread context.
96 * @note for params @see netif_add()
99 netifapi_netif_add(struct netif *netif,
100 struct ip_addr *ipaddr,
101 struct ip_addr *netmask,
104 err_t (* init)(struct netif *netif),
105 err_t (* input)(struct pbuf *p, struct netif *netif))
107 struct netifapi_msg msg;
108 msg.function = do_netifapi_netif_add;
109 msg.msg.netif = netif;
110 msg.msg.msg.add.ipaddr = ipaddr;
111 msg.msg.msg.add.netmask = netmask;
112 msg.msg.msg.add.gw = gw;
113 msg.msg.msg.add.state = state;
114 msg.msg.msg.add.init = init;
115 msg.msg.msg.add.input = input;
116 TCPIP_NETIFAPI(&msg);
121 * Call netif_set_addr() in a thread-safe way by running that function inside the
122 * tcpip_thread context.
124 * @note for params @see netif_set_addr()
127 netifapi_netif_set_addr(struct netif *netif,
128 struct ip_addr *ipaddr,
129 struct ip_addr *netmask,
132 struct netifapi_msg msg;
133 msg.function = do_netifapi_netif_set_addr;
134 msg.msg.netif = netif;
135 msg.msg.msg.add.ipaddr = ipaddr;
136 msg.msg.msg.add.netmask = netmask;
137 msg.msg.msg.add.gw = gw;
138 TCPIP_NETIFAPI(&msg);
143 * call the "errtfunc" (or the "voidfunc" if "errtfunc" is NULL) in a thread-safe
144 * way by running that function inside the tcpip_thread context.
146 * @note use only for functions where there is only "netif" parameter.
149 netifapi_netif_common( struct netif *netif,
150 void (* voidfunc)(struct netif *netif),
151 err_t (* errtfunc)(struct netif *netif) )
153 struct netifapi_msg msg;
154 msg.function = do_netifapi_netif_common;
155 msg.msg.netif = netif;
156 msg.msg.msg.common.voidfunc = voidfunc;
157 msg.msg.msg.common.errtfunc = errtfunc;
158 TCPIP_NETIFAPI(&msg);
162 #endif /* LWIP_NETIF_API */