Improve documentation on bridgeif_fdb

This commit is contained in:
Dirk Ziegelmeier 2017-10-18 18:31:38 +02:00
parent b3a379c239
commit 4f2dc05c7c

View File

@ -35,6 +35,12 @@
*
*/
/**
* @defgroup bridgeif_fdb FDB example code
* @ingroup bridgeif
* This file implements an example for an FDB (Forwarding DataBase)
*/
#include "netif/bridgeif.h"
#include "lwip/sys.h"
#include "lwip/timeouts.h"
@ -56,7 +62,9 @@ typedef struct bridgeif_dfdb_s {
bridgeif_dfdb_entry_t *fdb;
} bridgeif_dfdb_t;
/** A real simple and slow implementation of an auto-learning forwarding database that
/**
* @ingroup bridgeif_fdb
* A real simple and slow implementation of an auto-learning forwarding database that
* remembers known src mac addresses to know which port to send frames destined for that
* mac address.
*
@ -111,7 +119,10 @@ bridgeif_fdb_update_src(void *fdb_ptr, struct eth_addr *src_addr, u8_t port_idx)
/* not found, no free entry -> flood */
}
/** Walk our list of auto-learnt fdb entries and return a port to forward or BR_FLOOD if unknown */
/**
* @ingroup bridgeif_fdb
* Walk our list of auto-learnt fdb entries and return a port to forward or BR_FLOOD if unknown
*/
bridgeif_portmask_t
bridgeif_fdb_get_dst_ports(void *fdb_ptr, struct eth_addr *dst_addr)
{
@ -133,7 +144,10 @@ bridgeif_fdb_get_dst_ports(void *fdb_ptr, struct eth_addr *dst_addr)
return BR_FLOOD;
}
/** Aging implementation of our simple fdb */
/**
* @ingroup bridgeif_fdb
* Aging implementation of our simple fdb
*/
static void
bridgeif_fdb_age_one_second(void *fdb_ptr)
{
@ -172,7 +186,10 @@ bridgeif_age_tmr(void *arg)
sys_timeout(BRIDGEIF_AGE_TIMER_MS, bridgeif_age_tmr, arg);
}
/** Init our simple fdb list */
/**
* @ingroup bridgeif_fdb
* Init our simple fdb list
*/
void *
bridgeif_fdb_init(u16_t max_fdb_entries)
{