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.