25c25
< .\" $FreeBSD: head/share/man/man9/mbuf.9 152586 2005-11-18 17:04:49Z andre $
---
> .\" $FreeBSD: head/share/man/man9/mbuf.9 156756 2006-03-15 21:11:11Z sam $
27c27
< .Dd November 18, 2005
---
> .Dd March 15, 2006
134a135,136
> .Ft struct mbuf *
> .Fn m_unshare "struct mbuf *m0" "int how"
888a891,910
> .It Fn m_unshare m0 how
> Create a version of the specified mbuf chain whose
> contents can be safely modified without affecting other users.
> If allocation fails and this operation can not be completed,
> .Dv NULL
> will be returned.
> The original mbuf chain is always reclaimed and the reference
> count of any shared mbuf clusters is decremented.
> .Fa how
> should be either
> .Dv M_TRYWAIT
> or
> .Dv M_DONTWAIT ,
> depending on the caller's preference.
> As a side-effect of this process the returned
> mbuf chain may be compacted.
> .Pp
> This function is especially useful in the transmit path of
> network code, when data must be encrypted or otherwise
> altered prior to transmission.
< .\" $FreeBSD: head/share/man/man9/mbuf.9 152586 2005-11-18 17:04:49Z andre $
---
> .\" $FreeBSD: head/share/man/man9/mbuf.9 156756 2006-03-15 21:11:11Z sam $
27c27
< .Dd November 18, 2005
---
> .Dd March 15, 2006
134a135,136
> .Ft struct mbuf *
> .Fn m_unshare "struct mbuf *m0" "int how"
888a891,910
> .It Fn m_unshare m0 how
> Create a version of the specified mbuf chain whose
> contents can be safely modified without affecting other users.
> If allocation fails and this operation can not be completed,
> .Dv NULL
> will be returned.
> The original mbuf chain is always reclaimed and the reference
> count of any shared mbuf clusters is decremented.
> .Fa how
> should be either
> .Dv M_TRYWAIT
> or
> .Dv M_DONTWAIT ,
> depending on the caller's preference.
> As a side-effect of this process the returned
> mbuf chain may be compacted.
> .Pp
> This function is especially useful in the transmit path of
> network code, when data must be encrypted or otherwise
> altered prior to transmission.