pub unsafe extern "C" fn gnrc_pktbuf_start_write(
pkt: *mut gnrc_pktsnip_t,
) -> *mut gnrc_pktsnip_t
Expand description
@brief Must be called once before there is a write operation on a [packet snip](@ref gnrc_pktsnip_t) in a thread.
@details This function duplicates a packet snip in the packet buffer (both the instance of the gnrc_pktsnip_t and its data) if gnrc_pktsnip_t::users of @p pkt > 1.
@param[in] pkt The packet snip you want to write into.
@return The (new) pointer to the packet snip. @return NULL, if gnrc_pktsnip_t::users of @p pkt > 1 and if there is not enough space in the packet buffer.