Differential D21015 Diff 60552 head/share/man/man9/sbuf.9

Changeset View

Standalone View

head/share/man/man9/sbuf.9

	Show All 19 Lines
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.\" $FreeBSD$			.\" $FreeBSD$
	.\"			.\"
	.Dd May 7, 2019			.Dd August 7, 2019
	.Dt SBUF 9			.Dt SBUF 9
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm sbuf ,			.Nm sbuf ,
	.Nm sbuf_new ,			.Nm sbuf_new ,
	.Nm sbuf_new_auto ,			.Nm sbuf_new_auto ,
	.Nm sbuf_new_for_sysctl ,			.Nm sbuf_new_for_sysctl ,
	.Nm sbuf_clear ,			.Nm sbuf_clear ,
	▲ Show 20 Lines • Show All 246 Lines • ▼ Show 20 Lines
	.Fn sbuf_start_section			.Fn sbuf_start_section
	as a record boundary marker that will be used during drain operations to avoid			as a record boundary marker that will be used during drain operations to avoid
	records being split.			records being split.
	If a record grows sufficiently large such that it fills the			If a record grows sufficiently large such that it fills the
	.Fa sbuf			.Fa sbuf
	and therefore cannot be drained without being split, an error of			and therefore cannot be drained without being split, an error of
	.Er EDEADLK			.Er EDEADLK
	is set.			is set.
				.It Dv SBUF_NOWAIT
				Indicates that attempts to extend the storage buffer should fail in low memory
				conditions, like
				.Xr malloc 9
				.Dv M_NOWAIT .
	.El			.El
	.Pp			.Pp
	Note that if			Note that if
	.Fa buf			.Fa buf
	is not			is not
	.Dv NULL ,			.Dv NULL ,
	it must point to an array of at least			it must point to an array of at least
	.Fa length			.Fa length
	▲ Show 20 Lines • Show All 450 Lines • Show Last 20 Lines