mirror/lwip
1
0
Fork 0
mirror of https://github.com/lwip-tcpip/lwip.git synced 2024-07-16 17:57:25 +00:00
Code Issues Packages Projects Releases Wiki Activity

Improve altcp allocator documentation

Browse Source
This commit is contained in:
Dirk Ziegelmeier 2018-02-20 13:25:50 +01:00
parent 3a41f4fe8a
commit fc3c186289
1 changed files with 18 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
src/core/altcp.c
View File

@ -57,7 +57,9 @@
extern const struct altcp_functions altcp_tcp_functions;
/** For altcp layer implementations only: allocate a new struct altcp_pcb from the pool
/**
* @ingroup altcp
* For altcp layer implementations only: allocate a new struct altcp_pcb from the pool
* and zero the memory
*/
struct altcp_pcb *
@ -70,7 +72,9 @@ altcp_alloc(void)
return ret;
}
/** For altcp layer implementations only: return a struct altcp_pcb to the pool
/**
* @ingroup altcp
* For altcp layer implementations only: return a struct altcp_pcb to the pool
*/
void
altcp_free(struct altcp_pcb *conn)
@ -83,25 +87,33 @@ altcp_free(struct altcp_pcb *conn)
}
}
/** altcp_new_ip6: @ref altcp_new for IPv6 */
/**
* @ingroup altcp
* altcp_new_ip6: @ref altcp_new for IPv6
*/
struct altcp_pcb *
altcp_new_ip6(altcp_allocator_t *allocator)
{
return altcp_new_ip_type(allocator, IPADDR_TYPE_V6);
}
/** altcp_new: @ref altcp_new for IPv4 */
/**
* @ingroup altcp
* altcp_new: @ref altcp_new for IPv4
*/
struct altcp_pcb *
altcp_new(altcp_allocator_t *allocator)
{
return altcp_new_ip_type(allocator, IPADDR_TYPE_V4);
}
/** altcp_new_ip_type: called by applications to allocate a new pcb with the help of an
/**
* @ingroup altcp
* altcp_new_ip_type: called by applications to allocate a new pcb with the help of an
* allocator function.
*
* @param allocator allocator function and argument
* @param ip_type IP version of the pcb (IPADDR_TYPE_V4/IPADDR_TYPE_V6)
* @param ip_type IP version of the pcb (@ref lwip_ip_addr_type)
* @return a new altcp_pcb or NULL on error
*/
struct altcp_pcb *