LWIP_SUPPORT_CUSTOM_PBUF pbuf_alloc pbuf_cat pbuf_chain pbuf_clen pbuf_coalesce pbuf_copy pbuf_copy_partial pbuf_dechain PBUF_FLAG_IS_CUSTOM PBUF_FLAG_MCASTLOOP PBUF_FLAG_PUSH pbuf_free pbuf_get_at pbuf_header pbuf_init PBUF_IP PBUF_IP_HLEN pbuf_layer PBUF_LINK pbuf_memcmp pbuf_memfind PBUF_POOL PBUF_RAM PBUF_RAW pbuf_realloc PBUF_REF pbuf_ref PBUF_ROM pbuf_strstr pbuf_take PBUF_TRANSPORT PBUF_TRANSPORT_HLEN pbuf_type

void pbuf_cat ( struct pbuf *  h, struct pbuf *  t  ) Concatenate two pbufs (each may be a pbuf chain) and take over the caller's reference of the tail pbuf. Note: The caller MAY NOT reference the tail pbuf afterwards. Use pbuf_chain() for that purpose. See also: pbuf_chain() Definition at line 722 of file pbuf.c. Referenced by pbuf_chain(). { struct pbuf *p; LWIP_ERROR("(h != NULL) && (t != NULL) (programmer violates API)", ((h != NULL) && (t != NULL)), return;); /* proceed to last pbuf of chain */ for (p = h; p->next != NULL; p = p->next) { /* add total length of second chain to all totals of first chain */ p->tot_len += t->tot_len; } /* { p is last pbuf of first h chain, p->next == NULL } */ LWIP_ASSERT("p->tot_len == p->len (of last pbuf in chain)", p->tot_len == p->len); LWIP_ASSERT("p->next == NULL", p->next == NULL); /* add total length of second chain to last pbuf total of first chain */ p->tot_len += t->tot_len; /* chain last pbuf of head (p) with first of tail (t) */ p->next = t; /* p->next now references t, but the caller will drop its reference to t, * so netto there is no change to the reference count of t. */ }