ref: 31dab1e53536da6188e6620c93d3d3a0a22a409e
dir: /sys/man/3/pipe/
.TH PIPE 3 .SH NAME pipe \- two-way interprocess communication .SH SYNOPSIS .B bind #| .I dir .nf .IB dir /data .IB dir /data1 .fi .SH DESCRIPTION .PP An .IR attach (5) of this device allocates two new cross-connected I/O streams, .IB dir /data and .IB dir /data1\f1. .PP Data written to one channel becomes available for reading at the other. Write boundaries are preserved: each read terminates when the read buffer is full or after reading the last byte of a write, whichever comes first. .PP Writes are atomic up to a certain size, typically 32768 bytes, that is, each write will be delivered in a single read by the recipient, provided the receiving buffer is large enough. .PP If there are multiple writers, each .I write is guaranteed to be available in a contiguous piece at the other end of the pipe. If there are multiple readers, each read will return data from only one write. .PP The .IR pipe (2) system call performs an .I attach of this device and returns file descriptors to the new pipe's .B data and .B data1 files. The files are open with mode .BR ORDWR . .SH "SEE ALSO" .IR pipe (2) .SH SOURCE .B /sys/src/9/port/devpipe.c