pimd/pim_igmp.h

   1 /*
   2   PIM for Quagga
   3   Copyright (C) 2008  Everton da Silva Marques
   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 as published by
   7   the Free Software Foundation; either version 2 of the License, or
   8   (at your option) any later version.
   9
  10   This program is distributed in the hope that it will be useful, but
  11   WITHOUT ANY WARRANTY; without even the implied warranty of
  12   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13   General Public License for more details.
  14
  15   You should have received a copy of the GNU General Public License
  16   along with this program; see the file COPYING; if not, write to the
  17   Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,
  18   MA 02110-1301 USA
  19 */
  20
  21 #ifndef PIM_IGMP_H
  22 #define PIM_IGMP_H
  23
  24 #include <netinet/in.h>
  25
  26 #include <zebra.h>
  27 #include "vty.h"
  28 #include "linklist.h"
  29
  30 /*
  31   The following sizes are likely to support
  32   any message sent within local MTU.
  33 */
  34 #define PIM_IGMP_BUFSIZE_READ         (20000)
  35 #define PIM_IGMP_BUFSIZE_WRITE        (20000)
  36
  37 #define PIM_IGMP_MEMBERSHIP_QUERY     (0x11)
  38 #define PIM_IGMP_V1_MEMBERSHIP_REPORT (0x12)
  39 #define PIM_IGMP_V2_MEMBERSHIP_REPORT (0x16)
  40 #define PIM_IGMP_V2_LEAVE_GROUP       (0x17)
  41 #define PIM_IGMP_V3_MEMBERSHIP_REPORT (0x22)
  42
  43 #define IGMP_V3_REPORT_HEADER_SIZE    (8)
  44 #define IGMP_V3_GROUP_RECORD_MIN_SIZE (8)
  45 #define IGMP_V3_MSG_MIN_SIZE          (IGMP_V3_REPORT_HEADER_SIZE + \
  46                                        IGMP_V3_GROUP_RECORD_MIN_SIZE)
  47 #define IGMP_V12_MSG_SIZE             (8)
  48
  49 #define IGMP_V3_GROUP_RECORD_TYPE_OFFSET       (0)
  50 #define IGMP_V3_GROUP_RECORD_AUXDATALEN_OFFSET (1)
  51 #define IGMP_V3_GROUP_RECORD_NUMSOURCES_OFFSET (2)
  52 #define IGMP_V3_GROUP_RECORD_GROUP_OFFSET      (4)
  53 #define IGMP_V3_GROUP_RECORD_SOURCE_OFFSET     (8)
  54
  55 /* RFC 3376: 8.1. Robustness Variable - Default: 2 */
  56 #define IGMP_DEFAULT_ROBUSTNESS_VARIABLE           (2)
  57
  58 /* RFC 3376: 8.2. Query Interval - Default: 125 seconds */
  59 #define IGMP_GENERAL_QUERY_INTERVAL                (125)
  60
  61 /* RFC 3376: 8.3. Query Response Interval - Default: 100 deciseconds */
  62 #define IGMP_QUERY_MAX_RESPONSE_TIME_DSEC          (100)
  63
  64 /* RFC 3376: 8.8. Last Member Query Interval - Default: 10 deciseconds */
  65 #define IGMP_SPECIFIC_QUERY_MAX_RESPONSE_TIME_DSEC (10)
  66
  67 struct igmp_join {
  68   struct in_addr group_addr;
  69   struct in_addr source_addr;
  70   int            sock_fd;
  71   time_t         sock_creation;
  72 };
  73
  74 struct igmp_sock {
  75   int               fd;
  76   struct interface *interface;
  77   struct in_addr    ifaddr;
  78   time_t            sock_creation;
  79
  80   struct thread    *t_igmp_read;                 /* read: IGMP sockets */
  81   struct thread    *t_igmp_query_timer; /* timer: issue IGMP general queries */
  82   struct thread    *t_other_querier_timer;   /* timer: other querier present */
  83
  84   int               querier_query_interval;      /* QQI */
  85   int               querier_robustness_variable; /* QRV */
  86   int               startup_query_count;
  87
  88   struct list      *igmp_group_list; /* list of struct igmp_group */
  89 };
  90
  91 struct igmp_sock *pim_igmp_sock_lookup_ifaddr(struct list *igmp_sock_list,
  92                                               struct in_addr ifaddr);
  93 struct igmp_sock *igmp_sock_lookup_by_fd(struct list *igmp_sock_list,
  94                                          int fd);
  95 struct igmp_sock *pim_igmp_sock_add(struct list *igmp_sock_list,
  96                                     struct in_addr ifaddr,
  97                                     struct interface *ifp);
  98 void igmp_sock_delete(struct igmp_sock *igmp);
  99 void igmp_sock_free(struct igmp_sock *igmp);
 100
 101 int pim_igmp_packet(struct igmp_sock *igmp, char *buf, size_t len);
 102
 103 void pim_igmp_general_query_on(struct igmp_sock *igmp);
 104 void pim_igmp_general_query_off(struct igmp_sock *igmp);
 105 void pim_igmp_other_querier_timer_on(struct igmp_sock *igmp);
 106 void pim_igmp_other_querier_timer_off(struct igmp_sock *igmp);
 107
 108 #define IGMP_SOURCE_MASK_FORWARDING        (1 << 0)
 109 #define IGMP_SOURCE_MASK_DELETE            (1 << 1)
 110 #define IGMP_SOURCE_MASK_SEND              (1 << 2)
 111 #define IGMP_SOURCE_TEST_FORWARDING(flags) ((flags) & IGMP_SOURCE_MASK_FORWARDING)
 112 #define IGMP_SOURCE_TEST_DELETE(flags)     ((flags) & IGMP_SOURCE_MASK_DELETE)
 113 #define IGMP_SOURCE_TEST_SEND(flags)       ((flags) & IGMP_SOURCE_MASK_SEND)
 114 #define IGMP_SOURCE_DO_FORWARDING(flags)   ((flags) |= IGMP_SOURCE_MASK_FORWARDING)
 115 #define IGMP_SOURCE_DO_DELETE(flags)       ((flags) |= IGMP_SOURCE_MASK_DELETE)
 116 #define IGMP_SOURCE_DO_SEND(flags)         ((flags) |= IGMP_SOURCE_MASK_SEND)
 117 #define IGMP_SOURCE_DONT_FORWARDING(flags) ((flags) &= ~IGMP_SOURCE_MASK_FORWARDING)
 118 #define IGMP_SOURCE_DONT_DELETE(flags)     ((flags) &= ~IGMP_SOURCE_MASK_DELETE)
 119 #define IGMP_SOURCE_DONT_SEND(flags)       ((flags) &= ~IGMP_SOURCE_MASK_SEND)
 120
 121 struct igmp_source {
 122   struct in_addr      source_addr;
 123   struct thread      *t_source_timer;
 124   struct igmp_group  *source_group;    /* back pointer */
 125   time_t              source_creation;
 126   uint32_t            source_flags;
 127   struct channel_oil *source_channel_oil;
 128
 129   /*
 130     RFC 3376: 6.6.3.2. Building and Sending Group and Source Specific Queries
 131   */
 132   int                source_query_retransmit_count;
 133 };
 134
 135 struct igmp_group {
 136   /*
 137     RFC 3376: 6.2.2. Definition of Group Timers
 138
 139     The group timer is only used when a group is in EXCLUDE mode and it
 140     represents the time for the *filter-mode* of the group to expire and
 141     switch to INCLUDE mode.
 142   */
 143   struct thread    *t_group_timer;
 144
 145   /* Shared between group-specific and
 146      group-and-source-specific retransmissions */
 147   struct thread    *t_group_query_retransmit_timer;
 148
 149   /* Counter exclusive for group-specific retransmissions
 150      (not used by group-and-source-specific retransmissions,
 151      since sources have their counters) */
 152   int               group_specific_query_retransmit_count;
 153
 154   struct in_addr    group_addr;
 155   int               group_filtermode_isexcl;  /* 0=INCLUDE, 1=EXCLUDE */
 156   struct list      *group_source_list;        /* list of struct igmp_source */
 157   time_t            group_creation;
 158   struct igmp_sock *group_igmp_sock;          /* back pointer */
 159   int64_t           last_igmp_v1_report_dsec;
 160   int64_t           last_igmp_v2_report_dsec;
 161 };
 162
 163 struct igmp_group *find_group_by_addr (struct igmp_sock *igmp,
 164                                        struct in_addr group_addr);
 165 struct igmp_group *igmp_add_group_by_addr(struct igmp_sock *igmp,
 166                                           struct in_addr group_addr);
 167
 168 void igmp_group_delete_empty_include(struct igmp_group *group);
 169
 170 void igmp_startup_mode_on(struct igmp_sock *igmp);
 171
 172 void igmp_group_timer_on(struct igmp_group *group,
 173                          long interval_msec, const char *ifname);
 174
 175 struct igmp_source *
 176 source_new (struct igmp_group *group,
 177             struct in_addr src_addr);
 178 #endif /* PIM_IGMP_H */