Differential D19151 Diff 53821 stable/12/lib/libc/sys/sendfile.2

Changeset View

Standalone View

stable/12/lib/libc/sys/sendfile.2

	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 October 12, 2018			.Dd January 25, 2019
	.Dt SENDFILE 2			.Dt SENDFILE 2
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm sendfile			.Nm sendfile
	.Nd send a file to a socket			.Nd send a file to a socket
	.Sh LIBRARY			.Sh LIBRARY
	.Lb libc			.Lb libc
	.Sh SYNOPSIS			.Sh SYNOPSIS
	▲ Show 20 Lines • Show All 62 Lines • ▼ Show 20 Lines
	.Pf non- Dv NULL ,			.Pf non- Dv NULL ,
	the system will write the total number of bytes sent on the socket to the			the system will write the total number of bytes sent on the socket to the
	variable pointed to by			variable pointed to by
	.Fa sbytes .			.Fa sbytes .
	.Pp			.Pp
	The least significant 16 bits of			The least significant 16 bits of
	.Fa flags			.Fa flags
	argument is a bitmap of these values:			argument is a bitmap of these values:
	.Bl -tag -offset indent			.Bl -tag -offset indent -width "SF_USER_READAHEAD"
	.It Dv SF_NODISKIO			.It Dv SF_NODISKIO
	This flag causes			This flag causes
	.Nm			.Nm
	to return			to return
	.Er EBUSY			.Er EBUSY
	instead of blocking when a busy page is encountered.			instead of blocking when a busy page is encountered.
	This rare situation can happen if some other process is now working			This rare situation can happen if some other process is now working
	with the same region of the file.			with the same region of the file.
	▲ Show 20 Lines • Show All 282 Lines • ▼ Show 20 Lines
	.Fn sendfile			.Fn sendfile
	system call			system call
	and this manual page were written by			and this manual page were written by
	.An David G. Lawrence Aq Mt dg@dglawrence.com .			.An David G. Lawrence Aq Mt dg@dglawrence.com .
	The			The
	.Fx 11			.Fx 11
	implementation was written by			implementation was written by
	.An Gleb Smirnoff Aq Mt glebius@FreeBSD.org .			.An Gleb Smirnoff Aq Mt glebius@FreeBSD.org .
				.Sh BUGS
				The
				.Fn sendfile
				system call will not fail, i.e., return
				.Dv -1
				and set
				.Va errno
				to
				.Er EFAULT ,
				if provided an invalid address for
				.Fa sbytes .