Return to pipe CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 3

Annotation of lucent/sys/man/3/pipe, revision 1.1.1.1

1.1       root        1: .TH PIPE 3 
                      2: .SH NAME
                      3: pipe \- two-way interprocess communication
                      4: .SH SYNOPSIS
                      5: .B bind #|
                      6: .I dir
                      7: .nf
                      8: 
                      9: .IB dir /data
                     10: .IB dir /ctl
                     11: .IB dir /data1
                     12: .IB dir /ctl1
                     13: .fi
                     14: .SH DESCRIPTION
                     15: .PP
                     16: An
                     17: .IR attach (5)
                     18: of this device allocates two new streams joined at the
                     19: device end.
                     20: .B X/data
                     21: and
                     22: .B x/ctl
                     23: are the data and control channels of one stream and
                     24: .B x/data1
                     25: and
                     26: .B x/ctl1
                     27: are the data and control channels of the other stream.
                     28: .PP
                     29: Data written to one channel becomes available for reading at
                     30: the other.
                     31: Write boundaries are preserved: each read terminates
                     32: when the read buffer is full or after reading the last byte
                     33: of a write, whichever comes first.
                     34: .PP
                     35: Written data is buffered in kernel stream blocks.
                     36: The writer will block once the stream is full, typically after
                     37: 32768 bytes or 16 writes.
                     38: The writer will resume once the stream is less than
                     39: half full.
                     40: .PP
                     41: If there are multiple writers, each
                     42: .I write
                     43: is guaranteed to be available in a contiguous piece at the other
                     44: end of the pipe.
                     45: If there are multiple readers, each read will return data from only
                     46: one write.
                     47: .PP
                     48: The
                     49: .IR pipe (2)
                     50: system call performs an
                     51: .I attach
                     52: of this device and returns file descriptors to the new pipe's
                     53: .B data
                     54: and
                     55: .B data1
                     56: files.
                     57: The files are open with mode
                     58: .BR ORDWR .
                     59: .SH "SEE ALSO"
                     60: .IR pipe (2)
                     61: .SH SOURCE
                     62: .B /sys/src/9/port/devpipe.c

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.