]> rtime.felk.cvut.cz Git - pes-rpp/rpp-lwip.git/commitdiff
Comments Fix for Doxygen documentation
authorfbernon <fbernon>
Thu, 9 Aug 2007 22:21:44 +0000 (22:21 +0000)
committerfbernon <fbernon>
Thu, 9 Aug 2007 22:21:44 +0000 (22:21 +0000)
30 files changed:
src/api/api_lib.c
src/api/api_msg.c
src/api/err.c
src/api/netifapi.c
src/api/sockets.c
src/api/tcpip.c
src/core/dhcp.c
src/core/inet.c
src/core/inet6.c
src/core/ipv4/autoip.c
src/core/ipv4/icmp.c
src/core/ipv4/igmp.c
src/core/ipv4/ip.c
src/core/ipv4/ip_addr.c
src/core/ipv4/ip_frag.c
src/core/mem.c
src/core/memp.c
src/core/netif.c
src/core/raw.c
src/core/snmp/mib2.c
src/core/snmp/mib_structs.c
src/core/stats.c
src/core/sys.c
src/core/tcp.c
src/core/tcp_in.c
src/core/tcp_out.c
src/core/udp.c
src/netif/ethernetif.c
src/netif/loopif.c
src/netif/slipif.c

index 33f4cb29ea298413b47d269bfbfa4ed141bf613d..263bbdaf47b141cbae4f7b933a38c1422bad21be 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Sequential API External module
+ *
+ */
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
@@ -671,7 +677,7 @@ netconn_recv(struct netconn *conn)
  * @param conn the netconn over which to send data
  * @param buf a netbuf containing the data to send
  * @param addr the remote IP address to which to send the data
- * @param addr the remote port to which to send the data
+ * @param port the remote port to which to send the data
  * @return ERR_OK if data was sent, any other err_t on error
  */
 err_t
index 6b7eb44e8a35be267c034a279f2e701aad2fe8b5..e11a0f435f1659e08c30a003eab84e0d2d9bb441 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Sequential API Internal module
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index bac1739944fe47dcf05b39f1babe0c0e3651f15b..5410dede924f11fb9a4ae12e91f52ff5a1426bba 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Error Management module
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index e1ff8d483dc54775ee1ca46edf024ba24a5b1f71..530ceeb32d1177a6d5ad5e6ad0d43aac4f65389c 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Network Interface Sequential API module
+ *
+ */
+
 /*
  * Redistribution and use in source and binary forms, with or without modification, 
  * are permitted provided that the following conditions are met:
index d96d83d86440d7884b877165f3fda461776ad402..ec14427fb2cff9994b3b81e6be74584b12065676 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Sockets BSD-Like API module
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
index 338fcd6cb3f80cbb197978284120ef1001859ae9..e625da456213f343be61b3b5a0c59ef8bc676b65 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Sequential API Main thread module
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
index 94e3fe302b4223695e845a67dadc1071f6cfcf36..40b119926b0379aad642bbcbcc340478046202fb 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * @file
- *
  * Dynamic Host Configuration Protocol client
+ *
  */
 
 /*
@@ -90,7 +90,7 @@
  *  with this value (easy to match with a packet analyzer) */
 static u32_t xid = 0xABCD0000;
 
-/** DHCP client state machine functions */
+/* DHCP client state machine functions */
 static void dhcp_handle_ack(struct netif *netif);
 static void dhcp_handle_nak(struct netif *netif);
 static void dhcp_handle_offer(struct netif *netif);
@@ -103,7 +103,7 @@ static err_t dhcp_decline(struct netif *netif);
 static err_t dhcp_rebind(struct netif *netif);
 static void dhcp_set_state(struct dhcp *dhcp, u8_t new_state);
 
-/** receive, unfold, parse and free incoming messages */
+/* receive, unfold, parse and free incoming messages */
 static void dhcp_recv(void *arg, struct udp_pcb *pcb, struct pbuf *p, struct ip_addr *addr, u16_t port);
 static err_t dhcp_unfold_reply(struct dhcp *dhcp);
 static u8_t *dhcp_get_option_ptr(struct dhcp *dhcp, u8_t option_type);
@@ -114,23 +114,23 @@ static u16_t dhcp_get_option_short(u8_t *ptr);
 static u32_t dhcp_get_option_long(u8_t *ptr);
 static void dhcp_free_reply(struct dhcp *dhcp);
 
-/** set the DHCP timers */
+/* set the DHCP timers */
 static void dhcp_timeout(struct netif *netif);
 static void dhcp_t1_timeout(struct netif *netif);
 static void dhcp_t2_timeout(struct netif *netif);
 
-/** build outgoing messages */
-/** create a DHCP request, fill in common headers */
+/* build outgoing messages */
+/* create a DHCP request, fill in common headers */
 static err_t dhcp_create_request(struct netif *netif);
-/** free a DHCP request */
+/* free a DHCP request */
 static void dhcp_delete_request(struct netif *netif);
-/** add a DHCP option (type, then length in bytes) */
+/* add a DHCP option (type, then length in bytes) */
 static void dhcp_option(struct dhcp *dhcp, u8_t option_type, u8_t option_len);
-/** add option values */
+/* add option values */
 static void dhcp_option_byte(struct dhcp *dhcp, u8_t value);
 static void dhcp_option_short(struct dhcp *dhcp, u16_t value);
 static void dhcp_option_long(struct dhcp *dhcp, u32_t value);
-/** always add the DHCP options trailer to end and pad */
+/* always add the DHCP options trailer to end and pad */
 static void dhcp_option_trailer(struct dhcp *dhcp);
 
 /**
index 761defa8bf9e27e10c47e92512fa03da0310ff6a..c1b97940c1934910acce966225bed2baa7536ab1 100644 (file)
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * Functions common to all TCP/IPv4 modules, such as the Internet checksum and the
+ * byte order functions.
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
  *
  */
 
-
-/* inet.c
- *
- * Functions common to all TCP/IP modules, such as the Internet checksum and the
- * byte order functions.
- *
- */
-
-
 #include "lwip/opt.h"
 
 #include "lwip/arch.h"
@@ -489,7 +487,7 @@ inet_aton(const char *cp, struct in_addr *addr)
  * Convert numeric IP address into decimal dotted ASCII representation.
  * returns ptr to static buffer; not reentrant!
  *
- * @paran addr ip address in network order to convert
+ * @param addr ip address in network order to convert
  * @return pointer to a global static (!) buffer that holds the ASCII
  *         represenation of addr
  */
index c04915b73d009a6e9be6050231fb60b2b984e5d3..9f52f56ae0492f7fd032f35581cb14d05a6273b7 100644 (file)
@@ -1,3 +1,10 @@
+/**
+ * @file
+ * Functions common to all TCP/IPv6 modules, such as the Internet checksum and the
+ * byte order functions.
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
  *
  */
 
-
-/* inet6.c
- *
- * Functions common to all TCP/IP modules, such as the Internet checksum and the
- * byte order functions.
- *
- */
-
-
 #include "lwip/opt.h"
 
 #include "lwip/def.h"
 #include "lwip/inet.h"
 
-
-
 /* chksum:
  *
  * Sums up all 16 bit words in a memory portion. Also includes any odd byte.
index eeaf1267417c5f56572ef296de9cb139a4f668f7..53f8649e88544999f8951aceb799feebc13832d7 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * @file
- *
  * AutoIP Automatic LinkLocal IP Configuration
+ *
  */
 
 /*
index b4ee8b89da4779be255f081104085b1cbd6c69f4..49273ae171c4c23932e547071d0e7cdc102e05b4 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * ICMP - Internet Control Message Protocol
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
index bc1b440711f5256c96391432806414eac9bffbbe..c0dcb231924e47129eeb902dad8c35986414a7e9 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * @file
- *
  * IGMP - Internet Group Management Protocol
+ *
  */
 
 /*
@@ -577,7 +577,7 @@ igmp_ip_output_if(struct pbuf *p, struct ip_addr *src, struct ip_addr *dest,
 /**
  * Send an igmp packet to a specific group.
  *
- * @param the group to which to send the packet
+ * @param group the group to which to send the packet
  * @param type the type of igmp packet to send
  */
 void
index 6c886ada199228c63985f595945b1a69a225f5ad..9a065380b14979c94b3fb32805da1a5ba597e059 100644 (file)
@@ -1,10 +1,11 @@
-/* @file
- *
- * This is the IP layer implementation for incoming and outgoing IP traffic.
+/**
+ * @file
+ * This is the IPv4 layer implementation for incoming and outgoing IP traffic.
  * 
  * @see ip_frag.c
  *
  */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
index 00e593b41283205dcc2b34cdc48b5e54381b3e1c..dafcd761388a1bb96316bdae13dc5473d27386e2 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * This is the IPv4 address tools implementation.
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index 428e06971a7b2a89f97e4d48e246ec672034a45d..ff23ac43beedc5c92d560bd8d62a322c50be7670 100644 (file)
@@ -1,6 +1,6 @@
-/* @file
- * 
- * This is the IP packet segmentation and reassembly implementation.
+/**
+ * @file
+ * This is the IPv4 packet segmentation and reassembly implementation.
  *
  */
 
index 5779f4f7a06274c290fd1ff1c641edfc6301dc20..8c1c2b52b46ed31d27f7622831d3aeff9d07de24 100644 (file)
@@ -1,5 +1,5 @@
-/** @file
- *
+/**
+ * @file
  * Dynamic memory manager
  *
  */
index 60d5dd19a5563e137b469604fd56ac352b97dd09..81f7bdcba0547240b184d84a7ac737f0b10b15f5 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Dynamic pool memory manager
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
@@ -317,6 +323,8 @@ memp_init(void)
  * Get an element from a specific pool.
  *
  * @param type the pool to get an element from
+ * @param file file name calling this function
+ * @param line number of line where this function is called
  */
 void *
 #if MEMP_OVERFLOW_CHECK
index 9245af283b5f1eed713a51324e3535037e330728..6415fe693265ddab517b3f1c90a611f0a24c30ce 100644 (file)
@@ -1,7 +1,7 @@
 /**
  * @file
- *
  * lwIP network interface abstraction
+ *
  */
 
 /*
index c61bdb47a95f36963060ec1c417e5921bf45e3ec..fb3f97b87db4e733ffca42cc1daf50f933abb7b7 100644 (file)
@@ -1,11 +1,11 @@
 /**
  * @file
- * 
  * Implementation of raw protocol PCBs for low-level handling of
  * different types of protocols besides (or overriding) those
  * already available in lwIP.
  *
  */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
@@ -76,9 +76,9 @@ raw_init(void)
  * finds a corresponding RAW PCB and calls the corresponding receive
  * callback function.
  *
- * @param pbuf pbuf to be demultiplexed to a RAW PCB.
- * @param netif network interface on which the datagram was received.
- * @Return - 1 if the packet has been eaten by a RAW PCB receive
+ * @param p pbuf to be demultiplexed to a RAW PCB.
+ * @param inp network interface on which the datagram was received.
+ * @return - 1 if the packet has been eaten by a RAW PCB receive
  *           callback function. The caller MAY NOT not reference the
  *           packet any longer, and MAY NOT call pbuf_free().
  * @return - 0 if packet is not eaten (pbuf is still referenced by the
@@ -269,7 +269,6 @@ raw_sendto(struct raw_pcb *pcb, struct pbuf *p, struct ip_addr *ipaddr)
  *
  * @param pcb the raw pcb which to send
  * @param p the IP payload to send
- * @param ipaddr the destination address of the IP packet
  *
  */
 err_t
index 9c8c40a050b53ee9715eefc86b50c98eb5d3b88d..6f704c5b93e5ee09536083f639e382af668d7f61 100644 (file)
@@ -914,7 +914,7 @@ void objectidncpy(s32_t *dst, s32_t *src, u8_t n)
  * Initializes sysDescr pointers.
  *
  * @param str if non-NULL then copy str pointer
- * @param strlen points to string length, excluding zero terminator
+ * @param len points to string length, excluding zero terminator
  */
 void snmp_set_sysdesr(u8_t *str, u8_t *len)
 {
@@ -958,8 +958,8 @@ void snmp_get_sysuptime(u32_t *value)
  * Initializes sysContact pointers,
  * e.g. ptrs to non-volatile memory external to lwIP.
  *
- * @param str if non-NULL then copy str pointer
- * @param strlen points to string length, excluding zero terminator
+ * @param ocstr if non-NULL then copy str pointer
+ * @param ocstrlen points to string length, excluding zero terminator
  */
 void snmp_set_syscontact(u8_t *ocstr, u8_t *ocstrlen)
 {
@@ -974,8 +974,8 @@ void snmp_set_syscontact(u8_t *ocstr, u8_t *ocstrlen)
  * Initializes sysName pointers,
  * e.g. ptrs to non-volatile memory external to lwIP.
  *
- * @param str if non-NULL then copy str pointer
- * @param strlen points to string length, excluding zero terminator
+ * @param ocstr if non-NULL then copy str pointer
+ * @param ocstrlen points to string length, excluding zero terminator
  */
 void snmp_set_sysname(u8_t *ocstr, u8_t *ocstrlen)
 {
@@ -990,8 +990,8 @@ void snmp_set_sysname(u8_t *ocstr, u8_t *ocstrlen)
  * Initializes sysLocation pointers,
  * e.g. ptrs to non-volatile memory external to lwIP.
  *
- * @param str if non-NULL then copy str pointer
- * @param strlen points to string length, excluding zero terminator
+ * @param ocstr if non-NULL then copy str pointer
+ * @param ocstrlen points to string length, excluding zero terminator
  */
 void snmp_set_syslocation(u8_t *ocstr, u8_t *ocstrlen)
 {
@@ -1416,7 +1416,7 @@ void snmp_delete_ipaddridx_tree(struct netif *ni)
  * into index tree.
  *
  * @param dflt non-zero for the default rte, zero for network rte
- * @param netif points to network interface for this rte
+ * @param ni points to network interface for this rte
  *
  * @todo record sysuptime for _this_ route when it is installed
  *   (needed for ipRouteAge) in the netif.
@@ -1493,7 +1493,7 @@ void snmp_insert_iprteidx_tree(u8_t dflt, struct netif *ni)
  * from index tree.
  *
  * @param dflt non-zero for the default rte, zero for network rte
- * @param netif points to network interface for this rte or NULL
+ * @param ni points to network interface for this rte or NULL
  *   for default route to be removed.
  */
 void snmp_delete_iprteidx_tree(u8_t dflt, struct netif *ni)
index 0f202d4444820a6ace0d95916c5e040fb4a6af79..939e220e0ea24a1c9ca4e901cf78f609c67514ba 100644 (file)
@@ -110,7 +110,7 @@ snmp_ifindextonetif(s32_t ifindex, struct netif **netif)
 /**
  * Conversion from lwIP netif to ifIndex
  * @param netif points to a netif struct
- * @param ifindex points to s32_t object sub-identifier
+ * @param ifidx points to s32_t object sub-identifier
  */
 void
 snmp_netiftoifindex(struct netif *netif, s32_t *ifidx)
index 262c6b45ecf3f0153e255ac3c14c39e8358acc6d..9392302be6fc10a94cd57d6160fa07035b9cb37e 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Statistics module
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index 98ea7c05d4456fd98a09f41c7f06d6ec9b99a70e..2c4f32c2029ee6a508a791d7aa9f245697d02648 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * lwIP Operating System abstraction
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
@@ -289,6 +295,7 @@ sswt_handler(void *arg)
 /**
  * Wait for a semaphore with timeout (specified in ms)
  *
+ * @param sem semaphore to wait
  * @param timeout timeout in ms (0: wait forever)
  * @return 0 on timeout, 1 otherwise
  */
index bbdff97511106cd2a864cb6160b161b1c0c072db..afdc0f6c5a7a5ee1b741127e3182e02b42ec8d5f 100644 (file)
@@ -1,6 +1,5 @@
 /**
  * @file
- *
  * Transmission Control Protocol for IP
  *
  * This file contains common functions for the TCP implementation, such as functinos
@@ -1122,6 +1121,7 @@ tcp_pcb_purge(struct tcp_pcb *pcb)
 /**
  * Purges the PCB and removes it from a PCB list. Any delayed ACKs are sent first.
  *
+ * @param pcblist PCB list to purge.
  * @param pcb tcp_pcb to purge. The pcb itself is also deallocated!
  */
 void
index aef72f9dbc66bd08aad43043b11f32a0bf258787..ad727b1ad5eaf9a0ea9e28e87c2f4d15ccfbafb3 100644 (file)
@@ -1,6 +1,5 @@
 /**
  * @file
- *
  * Transmission Control Protocol, incoming traffic
  *
  * The input processing functions of the TCP layer.
index 266f895037a442266ba895f7d8398c5e94160bc1..8aee39cb3e544503a355effa2add846d967e0da9 100644 (file)
@@ -1,6 +1,5 @@
 /**
  * @file
- *
  * Transmission Control Protocol, outgoing traffic
  *
  * The output functions of TCP.
index 8b33ec7c9fcc7f69f82c645ff0b76b3e4907a6bf..7e23881d4d44574f56bda98b70ba7c0954f278d0 100644 (file)
@@ -3,6 +3,7 @@
  * User Datagram Protocol module
  *
  */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved.
@@ -684,7 +685,7 @@ udp_disconnect(struct udp_pcb *pcb)
  *
  * @param pcb the pcb for wich to set the recv callback
  * @param recv function pointer of the callback function
- * @param arg additional argument to pass to the callback function
+ * @param recv_arg additional argument to pass to the callback function
  */
 void
 udp_recv(struct udp_pcb *pcb,
index 190be536ed9028f42facbee70d1163fa8fa6e4c7..8ad0da19ffa3458a6fa55dc0780fc950c548e5c6 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Ethernet Interface Skeleton
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index 32037aac46810c1e849929f47082bb3dbeefd1d9..f9bf6a35002993421d7895e862009f0cbc109703 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * Loop Interface
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
index 28c3e4f343660eb751427762282751260ddae297..a1d96100f24edd2e77588ce08ca0df4231e49879 100644 (file)
@@ -1,3 +1,9 @@
+/**
+ * @file
+ * SLIP Interface
+ *
+ */
+
 /*
  * Copyright (c) 2001-2004 Swedish Institute of Computer Science.
  * All rights reserved. 
@@ -227,7 +233,7 @@ slipif_loop(void *nf)
  * Call the arch specific sio_open and remember
  * the opened device in the state field of the netif.
  *
- * @param nf the lwip network interface structure for this slipif
+ * @param netif the lwip network interface structure for this slipif
  * @return ERR_OK if serial line could be opened,
  *         ERR_IF is serial line couldn't be opened
  *