lib/lldp/lldpd.h

   1 /* -*- mode: c; c-file-style: "openbsd" -*- */
   2 /*
   3  * Copyright (c) 2015 Nicira, Inc.
   4  * Copyright (c) 2008 Vincent Bernat <bernat@luffy.cx>
   5  *
   6  * Permission to use, copy, modify, and/or distribute this software for any
   7  * purpose with or without fee is hereby granted, provided that the above
   8  * copyright notice and this permission notice appear in all copies.
   9  *
  10  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
  11  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  12  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
  13  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  14  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  15  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  16  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  17  */
  18
  19 #ifndef _LLDPD_H
  20 #define _LLDPD_H
  21
  22 #ifndef _WIN32
  23 #include <netinet/in.h>
  24 #endif
  25 #include <stdlib.h>
  26 #include <stddef.h>
  27 #include <string.h>
  28 #include <sys/types.h>
  29 #include "dp-packet.h"
  30 #include "list.h"
  31 #include "lldpd-structs.h"
  32 #include "lldp-tlv.h"
  33 #include "packets.h"
  34 #include "openvswitch/vlog.h"
  35
  36 #define ETHERTYPE_LLDP 0x88cc
  37
  38 #define LLDPD_TX_INTERVAL      5
  39 #define LLDPD_TX_HOLD          4
  40 #define LLDPD_TTL              (LLDPD_TX_INTERVAL * LLDPD_TX_HOLD)
  41
  42 #define PROTO_SEND_SIG struct lldpd *, struct lldpd_hardware *,struct dp_packet *
  43 #define PROTO_DECODE_SIG struct lldpd *, char *, int, struct lldpd_hardware *,\
  44     struct lldpd_chassis **, struct lldpd_port **
  45 #define PROTO_GUESS_SIG char *, int
  46
  47 struct protocol {
  48     int  mode;       /* > 0 mode identifier (unique per protocol) */
  49     int  enabled;    /* Is this protocol enabled? */
  50     char *name;      /* Name of protocol */
  51     char arg;        /* Argument to enable this protocol */
  52     int(*send)(PROTO_SEND_SIG);    /* How to send a frame */
  53     int(*decode)(PROTO_DECODE_SIG); /* How to decode a frame */
  54     int(*guess)(PROTO_GUESS_SIG);   /* Can be NULL, use MAC address in this
  55                                      * case
  56                                      */
  57     u_int8_t mac[ETH_ADDR_LEN];  /* Destination MAC address used by this
  58                                   * protocol
  59                                   */
  60 };
  61
  62 #define SMART_HIDDEN(port) (port->p_hidden_in)
  63
  64 struct lldpd {
  65     struct lldpd_config g_config;
  66     struct protocol     *g_protocols;
  67     int                 g_lastrid;
  68
  69     struct ovs_list     g_chassis; /* Contains "struct lldp_chassis". */
  70     struct ovs_list     g_hardware; /* Contains "struct lldpd_hardware". */
  71 };
  72
  73 static inline struct lldpd_hardware *
  74 lldpd_first_hardware(struct lldpd *lldpd)
  75 {
  76     return CONTAINER_OF(list_front(&lldpd->g_hardware),
  77                         struct lldpd_hardware, h_entries);
  78 }
  79
  80 /* lldpd.c */
  81 struct lldpd_hardware *lldpd_get_hardware(struct lldpd *,
  82     char *, int, struct lldpd_ops *);
  83 struct lldpd_hardware *lldpd_alloc_hardware(struct lldpd *, char *, int);
  84 void lldpd_hardware_cleanup(struct lldpd*, struct lldpd_hardware *);
  85 struct lldpd_mgmt *lldpd_alloc_mgmt(int family, void *addr, size_t addrsize,
  86     u_int32_t iface);
  87 void lldpd_recv(struct lldpd *, struct lldpd_hardware *, char *, size_t);
  88 uint32_t lldpd_send(struct lldpd_hardware *, struct dp_packet *);
  89 void lldpd_loop(struct lldpd *);
  90
  91 int lldpd_main(int, char **);
  92 void lldpd_update_localports(struct lldpd *);
  93 void lldpd_cleanup(struct lldpd *);
  94
  95 void lldpd_assign_cfg_to_protocols(struct lldpd *);
  96
  97 /* lldp.c */
  98 int lldp_send(PROTO_SEND_SIG);
  99 int lldp_decode(PROTO_DECODE_SIG);
 100
 101 #endif /* _LLDPD_H */