.\" Copyright (c) 1998, David Greenman .\" All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice unmodified, this list of conditions, and the following .\" disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" 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 .\" SUCH DAMAGE. .\" .\" %FreeBSD: src/lib/libc/sys/sendfile. 2, v 1.6. 2.6 2001/12/14 18:34:01 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/sendfile. 2, v 1.9 2002/04/14 18:07:01 horikawa Exp $ .Dd November 5, 1998 .Dt SENDFILE 2 .Os .Sh 명칭 .Nm sendfile .Nd 파일을 소켓에 송신 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/socket.h .In sys/uio.h .Ft int .Fn sendfile "int fd" "int s" "off_t offset" "size_t nbytes" "struct sf_hdtr *hdtr" "off_t *sbytes" "int flags" .Sh 해설 .Fn sendfile (은)는, 기술자 .Fa fd 에 의해 지정된 통상의 파일을, 기술자 .Fa s 에 의해 지정된 스트림 소켓으로부터 송신합니다. .Pp .Fa offset 인수는 파일의 어디에서 개시해야할 것인가를 지정합니다. .Fa nbytes 인수는, 파일의 몇 바이트를 송신할 필요가 있는지를 지정합니다. 0 은, 파일의 마지막까지 송신한다고 하는 특수한 의미를 가집니다. .Pp 옵션의 헤더 또는 부속차, 또는 그 양쪽 모두는, 구조체 sf_hdtr 를 가리키는 포인터를 지정하는 것에 의해 파일의 전과 다음에 송신할 수 있습니다. 구조체 sf_hdtr 의 구조는 다음과 같습니다. .Pp .Bd -literal -offset indent -compact struct sf_hdtr { struct iovec *headers; /* 헤더 iovecs 를 가리키는 포인터 */ int hdr_cnt; /* 헤더 iovecs 의 수 */ struct iovec *trailers; /* 부속차 iovecs 를 가리키는 포인터 */ int trl_cnt; /* 부속차 iovecs 의 수 */ }; .Ed .Pp .Fa headers 포인터와 .Fa trailers 포인터는, NULL 가 아닌 경우에 구조체 iovec 구조의 배열을 가리킵니다. iovec 구조체의 상세한 것에 대하여는, .Fn writev 시스템 콜을 참조해 주세요. 이러한 배열내의 iovecs 의 수는, .Fa hdr_cnt (와)과 .Fa trl_cnt 에 의해 지정됩니다. .Pp NULL 가 아닌 경우에, 시스템은, 소켓상에 송신된 합계 바이트수를, .Fa sbytes 에 의해 가리켜진 변수에 기록. .Pp .Fa flags 인수는 현시점에서는 미정도리이며, 0 으로 지정할 필요가 있습니다. .Pp 비블로킹 입출력용으로 지정된 소켓을 사용할 경우에, .Fn sendfile (은)는 요구되었던 것보다도 적은 바이트를 송신하는 일이 있습니다. 이 경우, 정상적으로 쓰기바이트수가 .Fa *sbytes (지정되어 있는 경우)에 돌려주어져 에러 .Er EAGAIN 하지만 돌려주어집니다. .Sh 실장에 관한 주 .Fn sendfile 의 .Fx 에서의 실장은 「0 카피」입니다. 즉, 파일 데이터의 카피 하지만 회피되도록(듯이) 최적화되고 있습니다. .Sh 반환값 .Rv -std sendfile .Sh 에러 .Bl -tag -width Er .It Bq Er EBADF .Fa fd 하지만 유효한 파일 기술자가 아닙니다. .It Bq Er EBADF .Fa s 하지만 유효한 소켓 기술자가 아닙니다. .It Bq Er ENOTSOCK .Fa s 하지만 소켓이 아닙니다. .It Bq Er EINVAL .Fa fd 하지만 통상의 파일이 아닙니다. .It Bq Er EINVAL .Fa s 하지만 SOCK_STREAM 형의 소켓이 아닙니다. .It Bq Er EINVAL .Fa offset 하지만 부인지, 또는 범위외입니다. .It Bq Er ENOTCONN .Fa s (은)는, 미접속의 소켓을 가리키고 있습니다. .It Bq Er EPIPE 통신 상대가 접속을 닫아 버렸습니다. .It Bq Er EIO .Fa fd (으)로부터 읽기중에 입출력 에러가 발생했습니다. .It Bq Er EFAULT 파라미터에 대해 무효인 주소가 지정되었습니다. .It Bq Er EAGAIN 소켓은 비블로킹 입출력과 지정되어 있어 소켓 버퍼가 만배이기 위해서(때문에) 모든 데이터가 송신되지 않았습니다. sbytes 가 지정되었을 경우, 송신이 정상적으로 완료한 바이트수가 .Fa *sbytes 안에 돌려주어집니다. .El .Sh 관련 항목 .Xr open 2 , .Xr send 2 , .Xr socket 2 , .Xr writev 2 .Sh 역사 .Fn sendfile (은)는, .Fx 3.0 그리고 처음 등장했습니다. 이 메뉴얼 페이지는 .Fx 3.1 그리고 처음 등장했습니다. .Sh 저자 .Fn sendfile 곳의 메뉴얼 페이지는 .An David Greenman Aq dg@root.com 하지만 작성했습니다.