mirror of
https://git.savannah.nongnu.org/git/lwip.git
synced 2026-08-12 10:33:37 +08:00
doxygen updates - include IPv6 in documentation. Exclude include/netif/ppp/polarssl.
Convert TODO -> @todo
This commit is contained in:
@@ -88,7 +88,7 @@ ethip6_send(struct netif *netif, struct pbuf *p, struct eth_addr *src, struct et
|
||||
*
|
||||
* For unicast addresses, ...
|
||||
*
|
||||
* @TODO anycast addresses
|
||||
* @todo anycast addresses
|
||||
*
|
||||
* @param netif The lwIP network interface which the IP packet will be sent on.
|
||||
* @param q The pbuf(s) containing the IP packet to be sent.
|
||||
@@ -127,7 +127,7 @@ ethip6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr)
|
||||
}
|
||||
|
||||
/* We have a unicast destination IP address */
|
||||
/* TODO anycast? */
|
||||
/* @todo anycast? */
|
||||
/* Get next hop record. */
|
||||
i = nd6_get_next_hop_entry(ip6addr, netif);
|
||||
if (i < 0) {
|
||||
@@ -141,7 +141,7 @@ ethip6_output(struct netif *netif, struct pbuf *q, const ip6_addr_t *ip6addr)
|
||||
neighbor_cache[i].state = ND6_DELAY;
|
||||
neighbor_cache[i].counter.delay_time = LWIP_ND6_DELAY_FIRST_PROBE_TIME;
|
||||
}
|
||||
/* TODO should we send or queue if PROBE? send for now, to let unicast NS pass. */
|
||||
/* @todo should we send or queue if PROBE? send for now, to let unicast NS pass. */
|
||||
if ((neighbor_cache[i].state == ND6_REACHABLE) ||
|
||||
(neighbor_cache[i].state == ND6_DELAY) ||
|
||||
(neighbor_cache[i].state == ND6_PROBE)) {
|
||||
|
||||
@@ -120,7 +120,7 @@ icmp6_input(struct pbuf *p, struct netif *inp)
|
||||
break;
|
||||
case ICMP6_TYPE_RS:
|
||||
#if LWIP_IPV6_FORWARD
|
||||
/* TODO implement router functionality */
|
||||
/* @todo implement router functionality */
|
||||
#endif
|
||||
break;
|
||||
#if LWIP_IPV6_MLD
|
||||
|
||||
@@ -249,7 +249,7 @@ ip6_select_source_address(struct netif *netif, const ip6_addr_t * dest)
|
||||
}
|
||||
else {
|
||||
/* Replace src only if we find a prefix match. */
|
||||
/* TODO find longest matching prefix. */
|
||||
/* @todo find longest matching prefix. */
|
||||
if ((!(ip6_addr_netcmp(ip_2_ip6(src), dest))) &&
|
||||
ip6_addr_netcmp(netif_ip6_addr(netif, i), dest)) {
|
||||
src = netif_ip_addr6(netif, i);
|
||||
|
||||
@@ -252,7 +252,6 @@ ip6_reass_remove_oldest_datagram(struct ip6_reassdata *ipr, int pbufs_needed)
|
||||
* Reassembles incoming IPv6 fragments into an IPv6 datagram.
|
||||
*
|
||||
* @param p points to the IPv6 Fragment Header
|
||||
* @param len the length of the payload (after Fragment Header)
|
||||
* @return NULL if reassembly is incomplete, pbuf pointing to
|
||||
* IPv6 Header if reassembly is complete
|
||||
*/
|
||||
@@ -675,7 +674,7 @@ ip6_frag(struct pbuf *p, struct netif *netif, const ip6_addr_t *dest)
|
||||
|
||||
mtu = nd6_get_destination_mtu(dest, netif);
|
||||
|
||||
/* TODO we assume there are no options in the unfragmentable part (IPv6 header). */
|
||||
/* @todo we assume there are no options in the unfragmentable part (IPv6 header). */
|
||||
left = p->tot_len - IP6_HLEN;
|
||||
|
||||
nfb = (mtu - (IP6_HLEN + IP6_FRAG_HLEN)) & IP6_FRAG_OFFSET_MASK;
|
||||
|
||||
@@ -245,7 +245,7 @@ mld6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that mld header fits in packet. */
|
||||
if (p->len < sizeof(struct mld_header)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
MLD6_STATS_INC(mld6.lenerr);
|
||||
MLD6_STATS_INC(mld6.drop);
|
||||
|
||||
@@ -69,7 +69,7 @@ struct nd6_router_list_entry default_router_list[LWIP_ND6_NUM_ROUTERS];
|
||||
|
||||
/* Default values, can be updated by a RA message. */
|
||||
u32_t reachable_time = LWIP_ND6_REACHABLE_TIME;
|
||||
u32_t retrans_timer = LWIP_ND6_RETRANS_TIMER; /* TODO implement this value in timer */
|
||||
u32_t retrans_timer = LWIP_ND6_RETRANS_TIMER; /* @todo implement this value in timer */
|
||||
|
||||
/* Index for cache entries. */
|
||||
static u8_t nd6_cached_neighbor_index;
|
||||
@@ -132,7 +132,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that na header fits in packet. */
|
||||
if (p->len < (sizeof(struct na_header))) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -149,7 +149,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that link-layer address option also fits in packet. */
|
||||
if (p->len < (sizeof(struct na_header) + 2)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -159,7 +159,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct na_header));
|
||||
|
||||
if (p->len < (sizeof(struct na_header) + (lladdr_opt->length << 3))) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -231,7 +231,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
(neighbor_cache[i].state == ND6_INCOMPLETE)) {
|
||||
/* Check that link-layer address option also fits in packet. */
|
||||
if (p->len < (sizeof(struct na_header) + 2)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -241,7 +241,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
lladdr_opt = (struct lladdr_option *)((u8_t*)p->payload + sizeof(struct na_header));
|
||||
|
||||
if (p->len < (sizeof(struct na_header) + (lladdr_opt->length << 3))) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -268,7 +268,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that ns header fits in packet. */
|
||||
if (p->len < sizeof(struct ns_header)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -380,7 +380,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that RA header fits in packet. */
|
||||
if (p->len < sizeof(struct ra_header)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -425,7 +425,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
}
|
||||
#endif /* LWIP_ND6_ALLOW_RA_UPDATES */
|
||||
|
||||
/* TODO set default hop limit... */
|
||||
/* @todo set default hop limit... */
|
||||
/* ra_hdr->current_hop_limit;*/
|
||||
|
||||
/* Update flags in local entry (incl. preference). */
|
||||
@@ -508,7 +508,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
break;
|
||||
}
|
||||
case ND6_OPTION_TYPE_ROUTE_INFO:
|
||||
/* TODO implement preferred routes.
|
||||
/* @todo implement preferred routes.
|
||||
struct route_option * route_opt;
|
||||
route_opt = (struct route_option *)buffer;*/
|
||||
|
||||
@@ -531,7 +531,7 @@ nd6_input(struct pbuf *p, struct netif *inp)
|
||||
|
||||
/* Check that Redir header fits in packet. */
|
||||
if (p->len < sizeof(struct redirect_header)) {
|
||||
/* TODO debug message */
|
||||
/* @todo debug message */
|
||||
pbuf_free(p);
|
||||
ND6_STATS_INC(nd6.lenerr);
|
||||
ND6_STATS_INC(nd6.drop);
|
||||
@@ -806,7 +806,7 @@ nd6_tmr(void)
|
||||
if ((netif->ip6_addr_state[i] & 0x07) >= LWIP_IPV6_DUP_DETECT_ATTEMPTS) {
|
||||
/* No NA received in response. Mark address as valid. */
|
||||
netif->ip6_addr_state[i] = IP6_ADDR_PREFERRED;
|
||||
/* TODO implement preferred and valid lifetimes. */
|
||||
/* @todo implement preferred and valid lifetimes. */
|
||||
} else if (netif->flags & NETIF_FLAG_UP) {
|
||||
#if LWIP_IPV6_MLD
|
||||
if ((netif->ip6_addr_state[i] & 0x07) == 0) {
|
||||
@@ -818,7 +818,7 @@ nd6_tmr(void)
|
||||
/* Send a NS for this address. */
|
||||
nd6_send_ns(netif, netif_ip6_addr(netif, i), ND6_SEND_FLAG_MULTICAST_DEST);
|
||||
netif->ip6_addr_state[i]++;
|
||||
/* TODO send max 1 NS per tmr call? enable return*/
|
||||
/* @todo send max 1 NS per tmr call? enable return*/
|
||||
/*return;*/
|
||||
}
|
||||
}
|
||||
@@ -1303,9 +1303,9 @@ nd6_select_router(const ip6_addr_t * ip6addr, struct netif * netif)
|
||||
* in RFC). This is more robust in case one router is not reachable,
|
||||
* we are not stuck trying to resolve it. */
|
||||
static s8_t last_router;
|
||||
(void)ip6addr; /* TODO match preferred routes!! (must implement ND6_OPTION_TYPE_ROUTE_INFO) */
|
||||
(void)ip6addr; /* @todo match preferred routes!! (must implement ND6_OPTION_TYPE_ROUTE_INFO) */
|
||||
|
||||
/* TODO: implement default router preference */
|
||||
/* @todo: implement default router preference */
|
||||
|
||||
/* Look for reachable routers. */
|
||||
for (i = 0; i < LWIP_ND6_NUM_ROUTERS; i++) {
|
||||
|
||||
Reference in New Issue
Block a user