.\" Copyright (c) 1980, 1991, 1993 .\" The Regents of the University of California. 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, 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. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS 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 REGENTS 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. .\" .\" @(#) pipe. 2 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/sys/pipe. 2, v 1.13. 2.5 2001/12/14 18:34:01 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/pipe. 2, v 1.9 2001/12/23 00:03:42 horikawa Exp $ .Dd June 4, 1993 .Dt PIPE 2 .Os .Sh 명칭 .Nm pipe .Nd 프로세스간 통신을 위한 기술자의 페어를 작성한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Ft int .Fn pipe "int *fildes" .Sh 해설 .Fn pipe 함수는 쌍방향의 데이터 플로우(flow)를 가능으로 하는 오브젝트이다 .Em pipe (을)를 작성해, 페어의 파일 기술자를 할당합니다. .Pp 관습에 의해, 통상은 1 번째의 기술자가 파이프의 .Em 읽기측 (으)로서 사용되어 2 번째의 기술자가 .Em 기록측 (으)로서 사용됩니다. 그러므로, .Fa fildes[1] 에 쓰기데이터가 .Fa fildes[0] 에 나타납니다 (즉, .Fa fildes[0] (으)로부터 독해). 이것을 사용하면 1 개의 프로그램의 출력을 다른 프로그램에 송신할 수 있습니다. 송신측의 표준 출력을 파이프의 기록측으로서 셋업 해, 수신측의 표준 입력을 파이프의 읽기측으로서 셋업 해 주세요. 파이프 자체는, 모든 대응하는 기술자가 클로우즈 될 때까지 지속합니다. .Pp 일단이 닫고 있는 파이프는 .Em widowed (상대를 잃었다)(이)라고 보여집니다. 이러한 파이프에 기록을 하면(자), 기록 프로세스는 .Dv SIGPIPE 시그널을 수신합니다. 읽기 측에 파일의 종료를 전하는 방법은, 기록측의 파이프를 클로우즈 할 수 밖에 없습니다. 읽기측이 버퍼에 들어가 있는 데이터를 다 사용한 후, 상대를 잃은 파이프를 독해와 0 카운트가 돌려주어집니다. .Pp 이 파이프의 실장에 있어서의 쌍방향이라고 하는 성질은, 낡은 시스템과 호환성이 없습니다. 그러므로, 파이프를 한방향 밖에 사용하지 않을 때에는, 종래의 방법으로 단 점을 사용하는 이 관습에 따르는 것을 추천합니다. .Sh 반환값 .Rv -std pipe .Sh 에러 .Fn pipe 호출은 다음의 경우에 실패합니다. .Bl -tag -width Er .It Bq Er EMFILE 액티브한 기술자가 너무 많습니다. .It Bq Er ENFILE 시스템 파일 테이블이 만배입니다. .It Bq Er EFAULT .Fa fildes 버퍼가 프로세스의 address 공간의 부정한 area에 있습니다. .El .Sh 관련 항목 .Xr sh 1 , .Xr fork 2 , .Xr read 2 , .Xr socketpair 2 , .Xr write 2 .Sh 역사 .Fn pipe 함수는 .At v3 그리고 등장했습니다. .Pp 쌍방향 파이프는 처음 .At V. 4 그리고 사용되었습니다.