mirror/guile
mirror/guile
1
Fork 0
mirror of https://git.savannah.gnu.org/git/guile.git synced 2025-06-30 15:00:21 +02:00
Code Activity

(Ports and File Descriptors): In pipe PIPE_BUF, use

Browse source 
@defvar, reword a bit for clarity, cross reference glibc.
This commit is contained in:
Kevin Ryde 2003-08-29 23:16:19 +00:00
parent 3dba2dd97b
commit c6ba64cd3e
1 changed files with 10 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

16
doc/ref/posix.texi
View file

@ -304,12 +304,16 @@ Pipes are commonly used for communication with a newly forked
child process. The need to flush the output port can be
avoided by making it unbuffered using @code{setvbuf}.
@vindex PIPE_BUF
Writes occur atomically provided the size of the data in bytes
is not greater than the value of @code{PIPE_BUF}. Note that
the output port is likely to block if too much data (typically
equal to @code{PIPE_BUF}) has been written but not yet read
from the input port.
@defvar PIPE_BUF
A write of up to @code{PIPE_BUF} many bytes to a pipe is atomic,
meaning when done it goes into the pipe instantaneously and as a
contiguous block (@pxref{Pipe Atomicity,, Atomicity of Pipe I/O, libc,
The GNU C Library Reference Manual}).
@end defvar
Note that the output port is likely to block if too much data has been
written but not yet read from the input port. Typically the capacity
is @code{PIPE_BUF} bytes.
@end deffn
The next group of procedures perform a @code{dup2}