Differential D25697 Diff 74550 share/man/man9/accf_http.9

Changeset View

Standalone View

share/man/man9/accf_http.9

	Show All 26 Lines
	.\" "			.\" "
	.Dd November 15, 2000			.Dd November 15, 2000
	.Dt ACCF_HTTP 9			.Dt ACCF_HTTP 9
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm accf_http			.Nm accf_http
	.Nd "buffer incoming connections until a certain complete HTTP requests arrive"			.Nd "buffer incoming connections until a certain complete HTTP requests arrive"
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm options INET			.Cd options INET
	.Nm options ACCEPT_FILTER_HTTP			.Cd options ACCEPT_FILTER_HTTP
	.Nm kldload accf_http			.Pp
				.Ic kldload Cm accf_http
	.Sh DESCRIPTION			.Sh DESCRIPTION
	This is a filter to be placed on a socket that will be using			This is a filter to be placed on a socket that will be using
	.Fn accept			.Fn accept
	to receive incoming HTTP connections.			to receive incoming HTTP connections.
	.Pp			.Pp
	It prevents the application from receiving the connected descriptor via			It prevents the application from receiving the connected descriptor via
	.Fn accept			.Fn accept
	until either a full HTTP/1.0 or HTTP/1.1 HEAD or GET request has			until either a full HTTP/1.0 or HTTP/1.1 HEAD or GET request has
	Show All 9 Lines
	.Nm			.Nm
	is such that a server will not have to context switch several times			is such that a server will not have to context switch several times
	before performing the initial parsing of the request.			before performing the initial parsing of the request.
	This effectively reduces the amount of required CPU utilization			This effectively reduces the amount of required CPU utilization
	to handle incoming requests by keeping active			to handle incoming requests by keeping active
	processes in preforking servers such as Apache low			processes in preforking servers such as Apache low
	and reducing the size of the file descriptor set that needs			and reducing the size of the file descriptor set that needs
	to be managed by interfaces such as			to be managed by interfaces such as
	.Fn select ,			.Xr select 2 ,
	.Fn poll			.Xr poll 2
	or			or
	.Fn kevent			.Xr kevent 2
	based servers.			based servers.
	.Pp			.Pp
	The			The
	.Nm			.Nm
	kernel option is also a module that can be enabled at runtime via			kernel option is also a module that can be enabled at runtime via
	.Xr kldload 8			.Xr kldload 8
	if the INET option has been compiled into the kernel.			if the INET option has been compiled into the kernel.
	.Sh EXAMPLES			.Sh EXAMPLES
	Show All 24 Lines