src/lldpd-structs.h

   1 /* -*- mode: c; c-file-style: "openbsd" -*- */
   2 /*
   3  * Copyright (c) 2008 Vincent Bernat <bernat@luffy.cx>
   4  *
   5  * Permission to use, copy, modify, and/or distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  10  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  11  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  12  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  15  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  */
  17
  18 #ifndef _LLDPD_STRUCTS_H
  19 #define _LLDPD_STRUCTS_H
  20
  21 #if HAVE_CONFIG_H
  22 #  include <config.h>
  23 #endif
  24
  25 #include <sys/types.h>
  26 #include <sys/socket.h>
  27 #ifndef INCLUDE_LINUX_IF_H
  28 #  include <net/if.h>
  29 #else
  30 #  include <arpa/inet.h>
  31 #  include <linux/if.h>
  32 #endif
  33 #include <net/ethernet.h>
  34 #include <netinet/in.h>
  35 #include <sys/queue.h>
  36
  37 #include "compat/compat.h"
  38 #include "marshal.h"
  39 #include "lldp-const.h"
  40
  41 #ifdef ENABLE_DOT1
  42 struct lldpd_ppvid {
  43         TAILQ_ENTRY(lldpd_ppvid) p_entries;
  44         u_int8_t                p_cap_status;
  45         u_int16_t               p_ppvid;
  46 };
  47 MARSHAL_BEGIN(lldpd_ppvid)
  48 MARSHAL_TQE(lldpd_ppvid, p_entries)
  49 MARSHAL_END;
  50
  51 struct lldpd_vlan {
  52         TAILQ_ENTRY(lldpd_vlan)  v_entries;
  53         char                    *v_name;
  54         u_int16_t                v_vid;
  55 };
  56 MARSHAL_BEGIN(lldpd_vlan)
  57 MARSHAL_TQE(lldpd_vlan, v_entries)
  58 MARSHAL_STR(lldpd_vlan, v_name)
  59 MARSHAL_END;
  60
  61 struct lldpd_pi {
  62         TAILQ_ENTRY(lldpd_pi)  p_entries;
  63         char                    *p_pi;
  64         int                      p_pi_len;
  65 };
  66 MARSHAL_BEGIN(lldpd_pi)
  67 MARSHAL_TQE(lldpd_pi, p_entries)
  68 MARSHAL_FSTR(lldpd_pi, p_pi, p_pi_len)
  69 MARSHAL_END;
  70 #endif
  71
  72 #ifdef ENABLE_LLDPMED
  73 struct lldpd_med_policy {
  74         u_int8_t                 index; /* Not used. */
  75         u_int8_t                 type;
  76         u_int8_t                 unknown;
  77         u_int8_t                 tagged;
  78         u_int16_t                vid;
  79         u_int8_t                 priority;
  80         u_int8_t                 dscp;
  81 };
  82 MARSHAL(lldpd_med_policy);
  83
  84 struct lldpd_med_loc {
  85         u_int8_t                 index; /* Not used. */
  86         u_int8_t                 format;
  87         char                    *data;
  88         int                      data_len;
  89 };
  90 MARSHAL_BEGIN(lldpd_med_loc)
  91 MARSHAL_FSTR(lldpd_med_loc, data, data_len)
  92 MARSHAL_END;
  93
  94 struct lldpd_med_power {
  95         u_int8_t                 devicetype; /* PD or PSE */
  96         u_int8_t                 source;
  97         u_int8_t                 priority;
  98         u_int16_t                val;
  99 };
 100 MARSHAL(lldpd_med_power);
 101 #endif
 102
 103 #ifdef ENABLE_DOT3
 104 struct lldpd_dot3_macphy {
 105         u_int8_t                 autoneg_support;
 106         u_int8_t                 autoneg_enabled;
 107         u_int16_t                autoneg_advertised;
 108         u_int16_t                mau_type;
 109 };
 110
 111 struct lldpd_dot3_power {
 112         u_int8_t                devicetype;
 113         u_int8_t                supported;
 114         u_int8_t                enabled;
 115         u_int8_t                paircontrol;
 116         u_int8_t                pairs;
 117         u_int8_t                class;
 118         u_int8_t                powertype; /* If set to LLDP_DOT3_POWER_8023AT_OFF,
 119                                               following fields have no meaning */
 120         u_int8_t                source;
 121         u_int8_t                priority;
 122         u_int16_t               requested;
 123         u_int16_t               allocated;
 124 };
 125 MARSHAL(lldpd_dot3_power);
 126 #endif
 127
 128 enum {
 129         LLDPD_AF_UNSPEC = 0,
 130         LLDPD_AF_IPV4,
 131         LLDPD_AF_IPV6,
 132         LLDPD_AF_LAST
 133 };
 134
 135 inline static int
 136 lldpd_af(int af)
 137 {
 138         switch (af) {
 139         case LLDPD_AF_IPV4: return AF_INET;
 140         case LLDPD_AF_IPV6: return AF_INET6;
 141         case LLDPD_AF_LAST: return AF_MAX;
 142         default: return AF_UNSPEC;
 143         }
 144 }
 145
 146 #define LLDPD_MGMT_MAXADDRSIZE  16 /* sizeof(struct in6_addr) */
 147 struct lldpd_mgmt {
 148         TAILQ_ENTRY(lldpd_mgmt) m_entries;
 149         int                             m_family;
 150         union {
 151                 struct in_addr          inet;
 152                 struct in6_addr         inet6;
 153                 u_int8_t                        octets[LLDPD_MGMT_MAXADDRSIZE];
 154         } m_addr;
 155         size_t                  m_addrsize;
 156         u_int32_t               m_iface;
 157 };
 158 MARSHAL_BEGIN(lldpd_mgmt)
 159 MARSHAL_TQE(lldpd_mgmt, m_entries)
 160 MARSHAL_END;
 161
 162 struct lldpd_chassis {
 163         TAILQ_ENTRY(lldpd_chassis) c_entries;
 164         u_int16_t                c_refcount; /* Reference count by ports */
 165         u_int16_t                c_index;    /* Monotonic index */
 166         u_int8_t                 c_protocol; /* Protocol used to get this chassis */
 167         u_int8_t                 c_id_subtype;
 168         char                    *c_id;
 169         int                      c_id_len;
 170         char                    *c_name;
 171         char                    *c_descr;
 172
 173         u_int16_t                c_cap_available;
 174         u_int16_t                c_cap_enabled;
 175
 176         u_int16_t                c_ttl;
 177
 178         TAILQ_HEAD(, lldpd_mgmt) c_mgmt;
 179
 180 #ifdef ENABLE_LLDPMED
 181         u_int16_t                c_med_cap_available;
 182         u_int8_t                 c_med_type;
 183         char                    *c_med_hw;
 184         char                    *c_med_fw;
 185         char                    *c_med_sw;
 186         char                    *c_med_sn;
 187         char                    *c_med_manuf;
 188         char                    *c_med_model;
 189         char                    *c_med_asset;
 190 #endif
 191
 192 };
 193 /* WARNING: any change to this structure should also be reflected into
 194    `lldpd_copy_chassis()` which is not using marshaling. */
 195 MARSHAL_BEGIN(lldpd_chassis)
 196 MARSHAL_TQE(lldpd_chassis, c_entries)
 197 MARSHAL_FSTR(lldpd_chassis, c_id, c_id_len)
 198 MARSHAL_STR(lldpd_chassis, c_name)
 199 MARSHAL_STR(lldpd_chassis, c_descr)
 200 MARSHAL_SUBTQ(lldpd_chassis, lldpd_mgmt, c_mgmt)
 201 #ifdef ENABLE_LLDPMED
 202 MARSHAL_STR(lldpd_chassis, c_med_hw)
 203 MARSHAL_STR(lldpd_chassis, c_med_fw)
 204 MARSHAL_STR(lldpd_chassis, c_med_sw)
 205 MARSHAL_STR(lldpd_chassis, c_med_sn)
 206 MARSHAL_STR(lldpd_chassis, c_med_manuf)
 207 MARSHAL_STR(lldpd_chassis, c_med_model)
 208 MARSHAL_STR(lldpd_chassis, c_med_asset)
 209 #endif
 210 MARSHAL_END;
 211
 212
 213 struct lldpd_port {
 214         TAILQ_ENTRY(lldpd_port)  p_entries;
 215         struct lldpd_chassis    *p_chassis;    /* Attached chassis */
 216         time_t                   p_lastchange; /* Time of last change of values */
 217         time_t                   p_lastupdate; /* Time of last update received */
 218         struct lldpd_frame      *p_lastframe;  /* Frame received during last update */
 219         u_int8_t                 p_protocol;   /* Protocol used to get this port */
 220         u_int8_t                 p_id_subtype;
 221         char                    *p_id;
 222         int                      p_id_len;
 223         char                    *p_descr;
 224         u_int16_t                p_mfs;
 225         u_int8_t                 p_hidden_in:1; /* Considered as hidden for reception */
 226         u_int8_t                 p_hidden_out:2; /* Considered as hidden for emission */
 227
 228 #ifdef ENABLE_DOT3
 229         /* Dot3 stuff */
 230         u_int32_t                p_aggregid;
 231         struct lldpd_dot3_macphy p_macphy;
 232         struct lldpd_dot3_power  p_power;
 233 #endif
 234
 235 #ifdef ENABLE_LLDPMED
 236         u_int16_t                p_med_cap_enabled;
 237         struct lldpd_med_policy  p_med_policy[LLDP_MED_APPTYPE_LAST];
 238         struct lldpd_med_loc     p_med_location[LLDP_MED_LOCFORMAT_LAST];
 239         struct lldpd_med_power   p_med_power;
 240 #endif
 241
 242 #ifdef ENABLE_DOT1
 243         u_int16_t                p_pvid;
 244         TAILQ_HEAD(, lldpd_vlan) p_vlans;
 245         TAILQ_HEAD(, lldpd_ppvid) p_ppvids;
 246         TAILQ_HEAD(, lldpd_pi)    p_pids;
 247 #endif
 248 };
 249 MARSHAL_BEGIN(lldpd_port)
 250 MARSHAL_TQE(lldpd_port, p_entries)
 251 MARSHAL_POINTER(lldpd_port, lldpd_chassis, p_chassis)
 252 MARSHAL_IGNORE(lldpd_port, p_lastframe)
 253 MARSHAL_FSTR(lldpd_port, p_id, p_id_len)
 254 MARSHAL_STR(lldpd_port, p_descr)
 255 #ifdef ENABLE_LLDPMED
 256 MARSHAL_SUBSTRUCT(lldpd_port, lldpd_med_loc, p_med_location[0])
 257 MARSHAL_SUBSTRUCT(lldpd_port, lldpd_med_loc, p_med_location[1])
 258 MARSHAL_SUBSTRUCT(lldpd_port, lldpd_med_loc, p_med_location[2])
 259 #endif
 260 #ifdef ENABLE_DOT1
 261 MARSHAL_SUBTQ(lldpd_port, lldpd_vlan, p_vlans)
 262 MARSHAL_SUBTQ(lldpd_port, lldpd_ppvid, p_ppvids)
 263 MARSHAL_SUBTQ(lldpd_port, lldpd_pi, p_pids)
 264 #endif
 265 MARSHAL_END;
 266
 267 /* Used to modify some port related settings */
 268 struct lldpd_port_set {
 269         char *ifname;
 270 #ifdef ENABLE_LLDPMED
 271         struct lldpd_med_policy *med_policy;
 272         struct lldpd_med_loc    *med_location;
 273         struct lldpd_med_power  *med_power;
 274 #endif
 275 #ifdef ENABLE_DOT3
 276         struct lldpd_dot3_power *dot3_power;
 277 #endif
 278 };
 279 MARSHAL_BEGIN(lldpd_port_set)
 280 MARSHAL_STR(lldpd_port_set, ifname)
 281 #ifdef ENABLE_LLDPMED
 282 MARSHAL_POINTER(lldpd_port_set, lldpd_med_policy, med_policy)
 283 MARSHAL_POINTER(lldpd_port_set, lldpd_med_loc,    med_location)
 284 MARSHAL_POINTER(lldpd_port_set, lldpd_med_power,  med_power)
 285 #endif
 286 #ifdef ENABLE_DOT3
 287 MARSHAL_POINTER(lldpd_port_set, lldpd_dot3_power, dot3_power)
 288 #endif
 289 MARSHAL_END;
 290
 291 struct lldpd_frame {
 292         int size;
 293         unsigned char frame[1];
 294 };
 295
 296 struct lldpd_hardware;
 297 struct lldpd;
 298 struct lldpd_ops {
 299         int(*send)(struct lldpd *,
 300                    struct lldpd_hardware*,
 301                    char *, size_t); /* Function to send a frame */
 302         int(*recv)(struct lldpd *,
 303                    struct lldpd_hardware*,
 304                    int, char *, size_t); /* Function to receive a frame */
 305         int(*cleanup)(struct lldpd *, struct lldpd_hardware *); /* Cleanup function. */
 306 };
 307
 308 /* An interface is uniquely identified by h_ifindex, h_ifname and h_ops. This
 309  * means if an interface becomes enslaved, it will be considered as a new
 310  * interface. The same applies for renaming and we include the index in case of
 311  * renaming to an existing interface. */
 312 struct lldpd_hardware {
 313         TAILQ_ENTRY(lldpd_hardware)      h_entries;
 314
 315         struct lldpd            *h_cfg;     /* Pointer to main configuration */
 316         void                    *h_recv;    /* FD for reception */
 317         int                      h_sendfd;  /* FD for sending, only used by h_ops */
 318         struct lldpd_ops        *h_ops;     /* Hardware-dependent functions */
 319         void                    *h_data;    /* Hardware-dependent data */
 320
 321         int                      h_mtu;
 322         int                      h_flags; /* Packets will be sent only
 323                                              if IFF_RUNNING. Will be
 324                                              removed if this is left
 325                                              to 0. */
 326         int                      h_ifindex; /* Interface index, used by SNMP */
 327         char                     h_ifname[IFNAMSIZ]; /* Should be unique */
 328         u_int8_t                 h_lladdr[ETHER_ADDR_LEN];
 329
 330         u_int64_t                h_tx_cnt;
 331         u_int64_t                h_rx_cnt;
 332         u_int64_t                h_rx_discarded_cnt;
 333         u_int64_t                h_rx_ageout_cnt;
 334         u_int64_t                h_rx_unrecognized_cnt;
 335
 336         struct lldpd_port        h_lport;  /* Port attached to this hardware port */
 337         TAILQ_HEAD(, lldpd_port) h_rports; /* Remote ports */
 338 };
 339 MARSHAL_BEGIN(lldpd_hardware)
 340 MARSHAL_IGNORE(lldpd_hardware, h_entries.tqe_next)
 341 MARSHAL_IGNORE(lldpd_hardware, h_entries.tqe_prev)
 342 MARSHAL_IGNORE(lldpd_hardware, h_ops)
 343 MARSHAL_IGNORE(lldpd_hardware, h_data)
 344 MARSHAL_IGNORE(lldpd_hardware, h_cfg)
 345 MARSHAL_SUBSTRUCT(lldpd_hardware, lldpd_port, h_lport)
 346 MARSHAL_SUBTQ(lldpd_hardware, lldpd_port, h_rports)
 347 MARSHAL_END;
 348
 349 struct lldpd_interface {
 350         TAILQ_ENTRY(lldpd_interface) next;
 351         char                    *name;
 352 };
 353 MARSHAL_BEGIN(lldpd_interface)
 354 MARSHAL_TQE(lldpd_interface, next)
 355 MARSHAL_STR(lldpd_interface, name)
 356 MARSHAL_END;
 357 TAILQ_HEAD(lldpd_interface_list, lldpd_interface);
 358 MARSHAL_TQ(lldpd_interface_list, lldpd_interface);
 359
 360 /* Cleanup functions */
 361 void     lldpd_chassis_mgmt_cleanup(struct lldpd_chassis *);
 362 void     lldpd_chassis_cleanup(struct lldpd_chassis *, int);
 363 void     lldpd_remote_cleanup(struct lldpd_hardware *, int);
 364 void     lldpd_port_cleanup(struct lldpd_port *, int);
 365 #ifdef ENABLE_DOT1
 366 void     lldpd_ppvid_cleanup(struct lldpd_port *);
 367 void     lldpd_vlan_cleanup(struct lldpd_port *);
 368 void     lldpd_pi_cleanup(struct lldpd_port *);
 369 #endif
 370
 371 #endif