Mistake on this page?
Report an issue in GitHub or email us
igmp.h
Go to the documentation of this file.
1 /**
2  * @file
3  * IGMP API
4  */
5 
6 /*
7  * Copyright (c) 2002 CITEL Technologies Ltd.
8  * All rights reserved.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  * notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  * notice, this list of conditions and the following disclaimer in the
17  * documentation and/or other materials provided with the distribution.
18  * 3. Neither the name of CITEL Technologies Ltd nor the names of its contributors
19  * may be used to endorse or promote products derived from this software
20  * without specific prior written permission.
21  *
22  * THIS SOFTWARE IS PROVIDED BY CITEL TECHNOLOGIES AND CONTRIBUTORS ``AS IS''
23  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25  * ARE DISCLAIMED. IN NO EVENT SHALL CITEL TECHNOLOGIES OR CONTRIBUTORS BE LIABLE
26  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32  * SUCH DAMAGE.
33  *
34  * This file is a contribution to the lwIP TCP/IP stack.
35  * The Swedish Institute of Computer Science and Adam Dunkels
36  * are specifically granted permission to redistribute this
37  * source code.
38 */
39 
40 #ifndef LWIP_HDR_IGMP_H
41 #define LWIP_HDR_IGMP_H
42 
43 #include "lwip/opt.h"
44 #include "lwip/ip_addr.h"
45 #include "lwip/netif.h"
46 #include "lwip/pbuf.h"
47 
48 #if LWIP_IPV4 && LWIP_IGMP /* don't build if not configured for use in lwipopts.h */
49 
50 #ifdef __cplusplus
51 extern "C" {
52 #endif
53 
54 /* IGMP timer */
55 #define IGMP_TMR_INTERVAL 100 /* Milliseconds */
56 #define IGMP_V1_DELAYING_MEMBER_TMR (1000/IGMP_TMR_INTERVAL)
57 #define IGMP_JOIN_DELAYING_MEMBER_TMR (500 /IGMP_TMR_INTERVAL)
58 
59 /* Compatibility defines (don't use for new code) */
60 #define IGMP_DEL_MAC_FILTER NETIF_DEL_MAC_FILTER
61 #define IGMP_ADD_MAC_FILTER NETIF_ADD_MAC_FILTER
62 
63 /**
64  * igmp group structure - there is
65  * a list of groups for each interface
66  * these should really be linked from the interface, but
67  * if we keep them separate we will not affect the lwip original code
68  * too much
69  *
70  * There will be a group for the all systems group address but this
71  * will not run the state machine as it is used to kick off reports
72  * from all the other groups
73  */
74 struct igmp_group {
75  /** next link */
76  struct igmp_group *next;
77  /** multicast address */
78  ip4_addr_t group_address;
79  /** signifies we were the last person to report */
80  u8_t last_reporter_flag;
81  /** current state of the group */
82  u8_t group_state;
83  /** timer for reporting, negative is OFF */
84  u16_t timer;
85  /** counter of simultaneous uses */
86  u8_t use;
87 };
88 
89 /* Prototypes */
90 void igmp_init(void);
91 err_t igmp_start(struct netif *netif);
92 err_t igmp_stop(struct netif *netif);
93 void igmp_report_groups(struct netif *netif);
94 struct igmp_group *igmp_lookfor_group(struct netif *ifp, const ip4_addr_t *addr);
95 void igmp_input(struct pbuf *p, struct netif *inp, const ip4_addr_t *dest);
96 err_t igmp_joingroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr);
97 err_t igmp_joingroup_netif(struct netif *netif, const ip4_addr_t *groupaddr);
98 err_t igmp_leavegroup(const ip4_addr_t *ifaddr, const ip4_addr_t *groupaddr);
99 err_t igmp_leavegroup_netif(struct netif *netif, const ip4_addr_t *groupaddr);
100 void igmp_tmr(void);
101 
102 /** @ingroup igmp
103  * Get list head of IGMP groups for netif.
104  * Note: The allsystems group IP is contained in the list as first entry.
105  * @see @ref netif_set_igmp_mac_filter()
106  */
107 #define netif_igmp_data(netif) ((struct igmp_group *)netif_get_client_data(netif, LWIP_NETIF_CLIENT_DATA_INDEX_IGMP))
108 
109 #ifdef __cplusplus
110 }
111 #endif
112 
113 #endif /* LWIP_IPV4 && LWIP_IGMP */
114 
115 #endif /* LWIP_HDR_IGMP_H */
lwIP Options Configuration
netif API (to be used from TCPIP thread)
Main packet buffer struct.
Generic data structure used for all lwIP network interfaces.
pbuf API
IP address structure for passing IP addresses by value.
Definition: nsapi_types.h:237
IP address API (common IPv4 and IPv6)
Important Information for this Arm website

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies. If you are not happy with the use of these cookies, please review our Cookie Policy to learn how they can be disabled. By disabling cookies, some features of the site will not work.