api_msg.c, igmp.c, igmp.h: Fix C++ style comments

This commit is contained in:
fbernon 2007-03-21 14:47:52 +00:00
parent a880469d7d
commit bb34d8cfd1
4 changed files with 47 additions and 44 deletions

View File

@ -70,6 +70,9 @@ HISTORY
* api_lib.c: Use memcpy in netbuf_copy_partial.
++ Bug fixes:
2007-03-21 Frédéric Bernon
* api_msg.c, igmp.c, igmp.h: Fix C++ style comments
2007-03-21 Kieran Mansley
* opt.h Change default PBUF_POOL_BUFSIZE to accomodate default MSS +
IP and TCP headers

View File

@ -77,7 +77,7 @@ recv_udp(void *arg, struct udp_pcb *pcb, struct pbuf *p,
struct netbuf *buf;
struct netconn *conn;
pcb = pcb; // Remove warning
pcb = pcb; /* Remove warning */
conn = arg;
@ -113,7 +113,7 @@ recv_tcp(void *arg, struct tcp_pcb *pcb, struct pbuf *p, err_t err)
struct netconn *conn;
u16_t len;
pcb = pcb; // Remove warning
pcb = pcb; /* Remove warning */
conn = arg;
@ -145,7 +145,7 @@ poll_tcp(void *arg, struct tcp_pcb *pcb)
{
struct netconn *conn;
pcb = pcb; // Remove warning
pcb = pcb; /* Remove warning */
conn = arg;
@ -162,7 +162,7 @@ sent_tcp(void *arg, struct tcp_pcb *pcb, u16_t len)
{
struct netconn *conn;
pcb = pcb; // Remove warning
pcb = pcb; /* Remove warning */
conn = arg;
@ -466,7 +466,7 @@ do_connected(void *arg, struct tcp_pcb *pcb, err_t err)
{
struct netconn *conn;
pcb = pcb; // Remove warning
pcb = pcb; /* Remove warning */
conn = arg;

View File

@ -114,7 +114,7 @@ void igmp_init(void)
if (group)
{ group->group_state = IDLE_MEMBER;
// Allow the igmp messages at the MAC level
/* Allow the igmp messages at the MAC level */
if (netif->igmp_mac_filter!=NULL)
{ netif->igmp_mac_filter( netif, &allsystems, IGMP_ADD_MAC_FILTER);
netif->igmp_mac_filter( netif, &allrouters, IGMP_ADD_MAC_FILTER);
@ -122,8 +122,8 @@ void igmp_init(void)
}
}
// Start the 10 millisecond tick
// we can optimise this to only run when timers are active later on
/* Start the 10 millisecond tick */
/* we can optimise this to only run when timers are active later on */
sys_timeout( IGMP_TICK, igmp_tick, NULL);
}
@ -161,7 +161,7 @@ struct igmp_group * lookup_group( struct netif *ifp, struct ip_addr *addr)
if (group)
{ group->interface = ifp;
ip_addr_set (&(group->group_address), addr);
group->timer = 0; // Not running
group->timer = 0; /* Not running */
group->group_state = NON_MEMBER;
group->last_reporter_flag = 0;
group->next = GroupList;
@ -192,14 +192,14 @@ void igmp_input( struct pbuf *p, struct netif *inp, struct ip_addr *dest)
LWIP_DEBUGF(IGMP_DEBUG, ("igmp message to address %l \n", (long) dest->addr));
if (p->len < IGMP_MINLEN)
{ // Nore that the length CAN be greater than 8 but only 8 are used - All are included in the checksum
{ /* Note that the length CAN be greater than 8 but only 8 are used - All are included in the checksum */
pbuf_free (p);
igmpstats.igmp_length_err++;
LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c,Line %x igmp length error\n", __LINE__));
return;
}
// Now calculate and check the checksum
/* Now calculate and check the checksum */
if (inet_chksum (igmp, IGMP_MINLEN /*p->len*/))
{ pbuf_free (p);
igmpstats.igmp_checksum_err++;
@ -207,22 +207,22 @@ void igmp_input( struct pbuf *p, struct netif *inp, struct ip_addr *dest)
return;
}
// Packet is ok so find the group (or create a new one)
group = lookup_group (inp, dest); // use the incoming IP address!
/* Packet is ok so find the group (or create a new one) */
group = lookup_group (inp, dest); /* use the incoming IP address! */
// If group can be found or create...
/* If group can be found or create... */
if (!group)
{ pbuf_free (p);
LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c,Line %d igmp allocation error\n", __LINE__));
return;
}
// NOW ACT ON THE INCOMING MESSAGE TYPE...
/* NOW ACT ON THE INCOMING MESSAGE TYPE... */
// The membership query message goes to the all groups address
// and it control block does not have state
/* The membership query message goes to the all groups address */
/* and it control block does not have state */
if ((IGMP_MEMB_QUERY == igmp->igmp_msgtype) && (ip_addr_cmp (dest, &allsystems)) && (igmp->igmp_group_address.addr == 0))
{ // THIS IS THE GENERAL QUERY
{ /* THIS IS THE GENERAL QUERY */
LWIP_DEBUGF(IGMP_DEBUG, ("General IGMP_MEMB_QUERY on ALL SYSTEMS ADDRESS 224.0.0.1\n"));
if (0 ==igmp->igmp_maxresp )
@ -235,7 +235,7 @@ void igmp_input( struct pbuf *p, struct netif *inp, struct ip_addr *dest)
groupref = GroupList;
while (groupref)
{ if ((groupref->interface == inp) && (!(ip_addr_cmp (&(groupref->group_address), &allsystems))))
{ // Do not send messages on the all systems group address!
{ /* Do not send messages on the all systems group address! */
if ((groupref->group_state == IDLE_MEMBER) || ((groupref->group_state == DELAYING_MEMBER) && (igmp->igmp_maxresp > groupref->timer)))
{ igmp_start_timer (groupref, (igmp->igmp_maxresp)/2);
groupref->group_state = DELAYING_MEMBER;
@ -248,8 +248,8 @@ void igmp_input( struct pbuf *p, struct netif *inp, struct ip_addr *dest)
if ((IGMP_MEMB_QUERY == igmp->igmp_msgtype) && ip_addr_cmp (dest, &allsystems) && (group->group_address.addr != 0))
{ LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c,Line %x got a query to a specific group using the allsystems address \n", __LINE__));
// we first need to re-lookup the group since we used dest last time
group = lookup_group (inp, &igmp->igmp_group_address); // use the incoming IP address!
/* we first need to re-lookup the group since we used dest last time */
group = lookup_group (inp, &igmp->igmp_group_address); /* use the incoming IP address! */
igmpstats.igmp_unicast_query++;
if ((IDLE_MEMBER == group->group_state ) || ((DELAYING_MEMBER == group->group_state ) && (igmp->igmp_maxresp > group->timer)))
@ -273,8 +273,8 @@ void igmp_input( struct pbuf *p, struct netif *inp, struct ip_addr *dest)
igmpstats.report_rxed++;
if (DELAYING_MEMBER == group->group_state )
{ // This is on a specific group we have already looked up
group->timer = 0; //stopped
{ /* This is on a specific group we have already looked up */
group->timer = 0; /* stopped */
group->group_state = IDLE_MEMBER;
group->last_reporter_flag = 0;
}
@ -296,13 +296,13 @@ err_t igmp_joingroup( struct netif *ifp, struct ip_addr *groupaddr)
group = lookup_group (ifp, groupaddr);
if (group)
{ // This should create a new group, check the state to make sure
{ /* This should create a new group, check the state to make sure */
if (group->group_state != NON_MEMBER)
{ LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c Line %x join to group not in state NON_MEMBER\n", __LINE__));
return ERR_OK;
}
// OK - it was new group
/* OK - it was new group */
igmpstats.igmp_joins++;
LWIP_DEBUGF(IGMP_DEBUG, ("igmp join to new group\n"));
@ -315,7 +315,7 @@ err_t igmp_joingroup( struct netif *ifp, struct ip_addr *groupaddr)
igmp_start_timer( group, 5);
// Need to work out where this timer comes from
/* Need to work out where this timer comes from */
group->group_state = DELAYING_MEMBER;
return ERR_OK;
@ -333,14 +333,14 @@ err_t igmp_leavegroup( struct netif *ifp, struct ip_addr *groupaddr)
group = lookup_group (ifp, groupaddr);
if (group)
{ // Only send a leave if the flag is set according to the state diagram
{ /* Only send a leave if the flag is set according to the state diagram */
if (group->last_reporter_flag)
{ LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c Line %x Leaving group\n", __LINE__));
igmpstats.igmp_leave_sent++;
igmp_send( group, IGMP_LEAVE_GROUP);
}
// The block is not deleted since the group still exists and we may rejoin
/* The block is not deleted since the group still exists and we may rejoin */
group->last_reporter_flag = 0;
group->group_state = NON_MEMBER;
group->timer = 0;
@ -373,8 +373,8 @@ void igmp_tick(void *arg)
group = group->next;
}
// 100 millisecond tick handler
// go down the list of all groups here and check for timeouts
/* 100 millisecond tick handler */
/* go down the list of all groups here and check for timeouts */
sys_timeout (IGMP_TICK, igmp_tick, NULL);
}
@ -382,7 +382,7 @@ void igmp_tick(void *arg)
* igmp_timeout
*----------------------------------------------------------------------------*/
void igmp_timeout( struct igmp_group *group)
{ // If the state is DELAYING_MEMBER then we send a report for this group
{ /* If the state is DELAYING_MEMBER then we send a report for this group */
LWIP_DEBUGF(IGMP_DEBUG, ("igmp.c, got a timeout\n"));
if (DELAYING_MEMBER == group->group_state)
@ -394,8 +394,8 @@ void igmp_timeout( struct igmp_group *group)
* igmp_start_timer
*----------------------------------------------------------------------------*/
void igmp_start_timer( struct igmp_group *group, u8_t max_time)
{ // Important !! this should be random 0 -> max_time
// find out how to do this
{ /* Important !! this should be random 0 -> max_time */
/* find out how to do this */
group->timer = max_time;
}
@ -417,18 +417,18 @@ err_t igmp_ip_output_if( struct pbuf *p, struct ip_addr *src, struct ip_addr *de
static u16_t ip_id = 0;
u16_t * ra = NULL;
// First write in the "router alert"
/* First write in the "router alert" */
if (pbuf_header (p, ROUTER_ALERTLEN))
{ LWIP_DEBUGF(IGMP_DEBUG, ("igmp_ip_output_if: not enough room for IP header in pbuf\n"));
return ERR_BUF;
}
// This is the "router alert" option
/* This is the "router alert" option */
ra = p->payload;
ra[0] = htons (0x9404);
ra[1] = 0x0000;
// now the normal ip header
/* now the normal ip header */
if (pbuf_header (p, IP_HLEN))
{ LWIP_DEBUGF(IGMP_DEBUG, ("igmp_ip_output_if: not enough room for IP header in pbuf\n"));
return ERR_BUF;
@ -496,7 +496,7 @@ void igmp_send( struct igmp_group *group, u8_t type)
{ dest = &(group->group_address);
igmpstats.report_sent++;
ip_addr_set (&(igmp->igmp_group_address), &(group->group_address));
group->last_reporter_flag = 1; // Remember we were the last to report
group->last_reporter_flag = 1; /* Remember we were the last to report */
}
else
if (IGMP_LEAVE_GROUP == type)

View File

@ -64,19 +64,19 @@ struct igmpmsg {
#define IGMP_V2_MEMB_REPORT 0x16 /* Ver. 2 membership report */
#define IGMP_LEAVE_GROUP 0x17 /* Leave-group message */
// Timer
#define IGMP_TICK 100 // Milliseconds
/* Timer */
#define IGMP_TICK 100 /* Milliseconds */
// MAC Filter Actions
/* MAC Filter Actions */
#define IGMP_DEL_MAC_FILTER 0
#define IGMP_ADD_MAC_FILTER 1
// Group membership states
/* Group membership states */
#define NON_MEMBER 0
#define DELAYING_MEMBER 1
#define IDLE_MEMBER 2
// Put this is another place when integrated
/* Put this is another place when integrated */
#define IP_PROTO_IGMP 2
#define IGMP_TTL 1
#define ROUTER_ALERTLEN 4
@ -97,7 +97,7 @@ struct igmp_group {
struct igmp_group *next;
struct netif *interface;
struct ip_addr group_address;
u8_t last_reporter_flag; // signifies we were the last person to report
u8_t last_reporter_flag; /* signifies we were the last person to report */
u8_t group_state;
u16_t timer;
};
@ -118,7 +118,7 @@ struct igmp_stats{
};
// Prototypes
/* Prototypes */
void igmp_init(void);
struct igmp_group *lookfor_group(struct netif *ifp, struct ip_addr *addr);